Silinx · Guia do utilizadorExperimentar o Silinx

Começar a usar o Silinx (passo a passo)

Guia do utilizador · English · Português

Novo Projeto: começar a partir do exemplo traffic

Não precisa de ferramentas de programação nem de git. A Forma 1, no browser, faz tudo: a Forma 2 é outra maneira de correr o mesmo Silinx, no seu computador.

Quero…Use
escrever VHDL/Verilog, desenhar esquemáticos e máquinas de estados, ligar circuitos digitais numa breadboard (CIs 74xx e 4000, experimentados ao vivo), simular, sintetizar e programar uma placa Basys2 / Nexys2Forma 1: no browser, nada a instalar
trabalhar sem Internet, guardar os projetos em pastas com qualquer browser, programar com as ferramentas instaladas (Adept, openFPGALoader…), ou usar o Xilinx ISE 14.7 ou o AMD Vivado para outras placasForma 2: correr o Silinx localmente (instala o Node.js uma vez)

Forma 1: no browser (a mais simples)

O mais rápido: abra https://pmnmalo.github.io/Silinx/ no browser (a última versão lançada; os seus projetos ficam nesse browser. A versão em desenvolvimento, com as alterações ainda não lançadas, está em https://pmnmalo.github.io/Silinx/dev/, com os projetos à parte) e passe ao passo 4. Ou descarregue-o, para trabalhar sem Internet:

  1. Abra a última versão.
  2. Em Assets, clique em Silinx.html para o descarregar.
  3. Faça duplo clique no ficheiro descarregado. Abre no browser (Chrome, Edge, Firefox ou Safari).
  4. Na página inicial clique em Novo Projeto… (New Project…): a primeira página pergunta o tipo de projeto, Lógica Digital (Digital Logic: esquemáticos, tabelas de verdade, máquinas de estados e circuitos numa breadboard, desenhados e simulados: sem HDL, placa nem fluxo da FPGA à vista), FPGA (por omissão, uma placa e um dispositivo: o que se segue) ou Co-design (nós de FPGA e de microcontrolador: ainda não disponível). Depois escolha em Começar a partir de (Start from) Exemplo: gates (portas lógicas desenhadas num esquemático: um bom primeiro exemplo), Exemplo: breadboard (chips 74LS ligados numa breadboard, a contar as vezes que se carrega num botão: um circuito digital, ver circuits.md), Exemplo: traffic (uma passadeira para peões: um diagrama de estados e uma álgebra booleana), Exemplo: blinky (ou pong, um jogo para dois, stopwatch, clock, vga, uma imagem num monitor VGA, isqrt, uma função em C feita em hardware, uart, um eco pela porta série para um terminal, ou micro80, um microprocessador compatível com o 8080 a correr um programa) ou Projeto vazio (Empty project). Depois dos exemplos vêm os Projeto de teste: … (Test design: …): projetos com que o próprio Silinx é testado (esquemáticos, diagramas de estados, programas em C para o Silinx HLS), cada um com o seu teste (uma bancada de teste, ou o main() do programa em C), para ver o que o Silinx faz com cada tipo de fonte. Um projeto vazio pergunta mais uma coisa, na página seguinte: o seu Tipo de Fonte de Topo (Top-Level Source Type: HDL, Esquemático, uma máquina de estados (FSM ou ASM), Álgebra Booleana, Rede de Petri, Circuito, ou uma função C ou C++ para o Silinx HLS): o projeto começa com esse topo. O tipo e o topo podem mudar-se depois nas Propriedades do Projeto (Design Properties: o seu Tipo de Projeto).

É tudo. A saber:

Programar a placa a partir do browser no Windows

O Chrome e o Edge só chegam a uma placa USB através do controlador WinUSB do Windows. O Digilent Adept (instalado com o Adept, o Xilinx ISE ou o Vivado, como na maioria dos computadores dos laboratórios) dá à Basys2 / Nexys2 o seu próprio controlador, e o controlador da FTDI fica com as placas FTDI (Basys 3, Nexys A7, iCEBreaker, ULX3S, Tang Nano 9K): o browser mostra então a placa na lista, mas não a consegue abrir. A consola diz isso: the board cannot be opened (Access denied.)….

  1. Feche o Digilent Adept, o iMPACT, o Hardware Manager do Vivado e a aplicação Silinx: só um programa de cada vez pode usar a placa.
  2. Descarregue o Zadig e execute-o, com a placa ligada ao computador e ligada.
  3. Options ▸ List All Devices, escolha a placa (Digilent USB Device, Basys2, Nexys2, ou Dual RS232-HS (Interface 0) numa placa FTDI), escolha WinUSB como controlador e clique em Replace Driver (ou Install Driver).
  4. Desligue o cabo da placa e volte a ligá-lo, e depois clique em Program FPGA: o browser mostra a sua lista de dispositivos USB; escolha a placa (só na primeira vez).

O Adept, o iMPACT e o Vivado deixam de ver a placa enquanto ela tiver o WinUSB: para os voltar a usar, reponha o controlador da Digilent (ou da FTDI) no Gestor de Dispositivos do Windows (a placa ▸ Atualizar controlador ▸ Escolher).

O browser só mostra a sua lista logo a seguir a um clique: se a consola disser the browser did not show its list of USB devices, clique de novo no botão. Se disser no board chosen, a lista foi fechada sem placa: verifique o cabo e se a placa está ligada (uma placa que não aparece na lista no Windows: o seu controlador, como acima).


Forma 2: correr o Silinx localmente (Node.js)

O mesmo Silinx, a correr no seu computador em vez do site: os projetos como pastas em Silinx-projects com qualquer browser, a síntese sem Internet, a placa programada também com as ferramentas instaladas (Digilent Adept, openFPGALoader, xc3sprog, adepttool) ou a partir do Firefox e do Safari, e o Xilinx ISE 14.7 ou o AMD Vivado para as placas que a cadeia de ferramentas Silinx ainda não suporta.

Passo 1: instalar o Node.js (uma vez)

O Silinx corre no Node.js, um programa gratuito.

  1. Vá a https://nodejs.org e descarregue a versão marcada LTS.
  2. Execute o instalador e aceite as opções por omissão (Next, Next, Install). - Windows: mantenha a opção Add to PATH selecionada (já vem assim). Não precisa das "Tools for native modules". - macOS: abra o .pkg descarregado e siga os passos. - Linux: use o gestor de pacotes (Ubuntu/Debian: sudo apt install nodejs npm) ou o instalador do nodejs.org. É preciso a versão 18 ou mais recente.

Passo 2: descarregar o Silinx

  1. Abra a última versão.
  2. Em Assets, descarregue silinx-<versão>.zip (por exemplo silinx-15.22.1.zip). - Não use o botão verde Code ▸ Download ZIP nem o "Source code": essa versão não traz tudo o que o Silinx precisa (funciona na mesma, mas o primeiro arranque precisa de Internet para descarregar o que falta).
  3. Descompacte-o (extraia-o) para uma pasta que volte a encontrar, por exemplo Documentos: - Windows: botão direito no zip ▸ Extrair Tudo… ▸ Extrair. Não o execute de dentro do zip. - macOS: duplo clique no zip. - Fica com uma pasta chamada silinx.

Opcional, para confirmar que o ficheiro é o da versão (por exemplo um que veio da página de uma cadeira): a versão lista o checksum SHA-256 de cada ficheiro nas suas notas e no ficheiro SHA256SUMS. Descarregue o SHA256SUMS para a mesma pasta e, num terminal aí, corra sha256sum -c SHA256SUMS --ignore-missing (Linux) ou shasum -a 256 -c SHA256SUMS --ignore-missing (macOS): o ficheiro tem de dizer OK. No Windows, Get-FileHash silinx-<versão>.zip no PowerShell mostra o checksum, a comparar com o das notas. Cada ficheiro tem também a atestação de proveniência do GitHub (foi construído pelo workflow Release do repositório a partir da tag da versão): com o GitHub CLI, gh attestation verify silinx-<versão>.zip --repo pmnmalo/Silinx.

Passo 3: arrancar o Silinx

Abra a pasta silinx e faça duplo clique no ficheiro do seu sistema:

SistemaDuplo clique em
WindowsStart Silinx.bat
macOSStart Silinx.command
Linuxstart-silinx.sh (ou ./start-silinx.sh num terminal)

Abre-se uma janela preta (o servidor do Silinx) e depois o browser mostra o Silinx em http://127.0.0.1:8642.

Só da primeira vez pode aparecer:

Passo 4: usar

Atualizar o Silinx

Descarregue o novo silinx-<versão>.zip, descompacte-o e use a nova pasta (pode apagar a antiga). Os seus projetos não estão dentro dessa pasta, por isso mantêm-se.


Síntese e programação de uma placa com o Silinx a correr localmente (opcional)

No browser (Forma 1) não é preciso mais nada para as Basys2 e Nexys2. Com o Silinx a correr localmente (Forma 2), precisam de até mais duas coisas. O seu professor pode já as ter preparadas.

  1. Para as placas Basys2 e Nexys2, nada: a toolchain Silinx, o modo por omissão, sintetiza e gera o bitstream sem nenhuma ferramenta Xilinx. As placas Spartan-6, a Nexys3 e a Atlys, também, no browser e com o Silinx a correr localmente; a Atlys não tem display de sete segmentos nem VGA próprios, e o Silinx põe-nos no seu conector VHDCI (como os liga uma Digilent VmodBB). Para as outras placas (ou os processos que precisam do ISE), o Xilinx ISE 14.7 (licença WebPACK gratuita); em qualquer computador corre dentro do Docker, e depois escolha um modo ISE em Definições (⚙) ▸ Definições da Toolchain (ISE / Programadores)… (Estilo ISE: Tools ▸ …): - instale o Docker Desktop (nos Mac com Apple Silicon, o OrbStack é uma alternativa mais rápida); - descarregue silinx-docker-kit-<versão>.zip da mesma página e siga o seu ise/README.md: descarrega o instalador do ISE e a licença com a sua conta AMD gratuita e corre um script (demora 20–60 minutos, uma vez). O ISE não pode ser partilhado, por isso cada pessoa cria a sua cópia.
    As placas da série 7, a Basys 3 e a Nexys A7 (Artix-7), a Arty S7 (Spartan-7) e a Zybo Z7 (Zynq-7000), são construídas pelo AMD Vivado ML Standard (gratuito para estes dispositivos) com o Silinx a correr localmente, com o Vivado como ferramenta de síntese (Synthesis Tool); a Basys 3 e a Nexys A7 também pela cadeia de ferramentas Silinx, também no browser (ver o README, The Artix-7 boards with AMD Vivado).
  2. O controlador USB da placa para a programar: - Windows: instale o Digilent Adept 2 (Runtime + Utilities) a partir de digilent.com. - macOS (Basys2): num Terminal, dentro da pasta silinx, execute brew install libusb python e ./scripts/install-adepttool.sh (precisa do Homebrew). - Linux: Digilent Adept, ou o openFPGALoader do gestor de pacotes.

No Silinx, Definições (⚙) ▸ Definições da Toolchain (ISE / Programadores)… (Estilo ISE: Tools ▸ …) mostra o que foi encontrado.


Problemas?

O que apareceO que fazer
O arranque diz Node.js is not installedInstale-o (Passo 1). Feche a janela e faça duplo clique outra vez.
Browser: "Não é possível aceder a este site"A janela do Silinx foi fechada: faça duplo clique outra vez no ficheiro de arranque.
"Port 8642 is used by another program"Outro programa usa essa porta. Abra um terminal na pasta silinx e execute node bin/silinx.js serve --port 8643 --open.
Consola: "the Silinx server is not running"O mesmo: volte a arrancar o Silinx. As alterações por guardar são guardadas assim que ele voltar.
macOS: o ficheiro .command abre num editor de textoBotão direito ▸ Abrir com ▸ Terminal.
A janela abre e fecha logoAbra um terminal na pasta silinx e execute node bin/silinx.js serve --open para ler a mensagem.

Abrir um terminal numa pasta: Windows: abra a pasta, clique na barra de endereço, escreva cmd e carregue em Enter. macOS: botão direito na pasta ▸ Novo Terminal na Pasta (ou abra o Terminal, escreva cd , arraste a pasta para a janela e carregue em Enter).


Para quem usa git

git clone https://github.com/pmnmalo/Silinx.git
cd Silinx
npm install
npm start            # mostra o endereço a abrir: http://127.0.0.1:8642/#token=…