Orquestrador do desenvolvimento em Verilog e de processadores SAPHO, o processador soft-core do NIPS-CERN (UFJF). Cria projetos, compila C± e C com o YANC, verifica e simula com Icarus Verilog e Verilator, sintetiza com Yosys, desenha o esquemático com Graphviz e abre as ondas no surfer-aurora.

Duas interfaces sobre o mesmo núcleo (lace-core): a linha de comando lace e o Lace Studio, o ambiente gráfico (editor, compilação, simulação e ondas numa janela), em studio/. O instalador traz os dois. Para quem prefere o VS Code, a extensão do Lace usa a linha de comando e se instala à parte (abaixo).

O Lace só executa as ferramentas do bundle instalado com ele, nas versões exatas do bundle (ver docs/BUNDLE.md). No Linux e no macOS o bundle acompanha o OSS CAD Suite, e a exceção é o Verilator, que compila com o compilador C++, o make e o Perl do sistema. No Windows o Icarus e o Verilator, com o compilador, vêm do bloco MSYS2 do lace-toolchain.

Plataformas: Linux x64 (glibc 2.35: Ubuntu 22.04, Debian 12, Fedora 36, Arch ou mais novos), macOS 13 ou mais novo em Apple Silicon, Windows 10 e 11 x64.

Instalar

No Linux, o Lace Studio usa o webkit2gtk 4.1 do sistema, que o instalador não traz. O GNOME costuma já tê-lo; o KDE Plasma, o Arch e os ambientes leves, em geral, não. Sem ele, o Studio não abre. Instale antes, ou deixe o instalador oferecer no fim:

sudo apt install libwebkit2gtk-4.1-0     # Debian, Ubuntu, Mint
sudo dnf install webkit2gtk4.1           # Fedora
sudo pacman -S webkit2gtk-4.1            # Arch, Manjaro

Linux x64 e macOS Apple Silicon, em qualquer shell (bash, zsh, fish):

curl -fsSL https://raw.githubusercontent.com/ART3121/lace/main/install.sh | sh

Windows 10 e 11, no PowerShell:

irm https://raw.githubusercontent.com/ART3121/lace/main/install.ps1 | iex

O script baixa o instalador da última release, confere o SHA-256 com o SHA256SUMS da release e o abre: a instalação guiada no terminal no Linux e no macOS, o assistente no Windows. Nos dois, primeiro se escolhe um perfil (abaixo): o SAPHO é o recomendado, e o Custom, para uso avançado, deixa marcar os componentes. O assistente do Windows pergunta antes o idioma, inglês ou português. No Linux e no macOS, instala em ~/.local/share/lace, com o atalho ~/.local/bin/lace. O Lace Studio entra no menu de aplicativos.

Sem perguntas (scripts, laboratórios, CI):

curl -fsSL https://raw.githubusercontent.com/ART3121/lace/main/install.sh | sh -s -- --yes
curl -fsSL https://raw.githubusercontent.com/ART3121/lace/main/install.sh | sh -s -- --yes --profile verilog
curl -fsSL https://raw.githubusercontent.com/ART3121/lace/main/install.sh | sh -s -- --yes --components yanc,icarus,verilator

$env:LACE_SETUP_ARGS = "/VERYSILENT /SUPPRESSMSGBOXES /CURRENTUSER /TYPE=sapho /TASKS=path"
irm https://raw.githubusercontent.com/ART3121/lace/main/install.ps1 | iex

Sem o script, direto da página da release:

curl -fLO https://github.com/ART3121/lace/releases/download/v0.9.0/lace-0.9.0-linux-x64.tar.gz
tar xzf lace-0.9.0-linux-x64.tar.gz && ./lace-0.9.0-linux-x64/install

No macOS, troque linux-x64 por darwin-arm64. Baixe pelo curl, não pelo navegador: o instalador não é assinado, e o macOS recusa abrir um arquivo baixado pelo navegador (ver docs/INSTALL.md).

Para remover o Lace com o bundle inteiro: lace uninstall.

Perfis e componentes

A instalação começa por um perfil, que marca os aplicativos de um tipo de trabalho; a lista inteira aparece, com os do perfil marcados e travados. O Lace (CLI & Core) vem sempre.

Perfil	Para quem	Deixa de fora
SAPHO (recomendado)	quem constrói processadores SAPHO e os programa em C±	nada
Verilog	quem projeta em Verilog sem processadores SAPHO	YANC
Custom (avançada)	uso avançado, para quem sabe de quais componentes precisa	o que não for marcado

Componente	O que é
Lace Studio	o ambiente gráfico; no Linux precisa do webkit2gtk 4.1 do sistema
YANC	compiladores C± e C do SAPHO e a biblioteca SAPHO
Icarus Verilog	simulador Verilog, o padrão do lace sim, e a verificação do lace check
Verilator	simulador compilado e o lace check --lint; no Linux e no macOS precisa de g++ ou clang++, make e Perl do sistema, no Windows vem com eles
cocotb	testbenches em Python, com o Python que os roda; precisa do Icarus. O Lace roda os testes no Icarus (lace sim test_x.py, ou Wave e Rápida no Studio) e, com o componente Verilator, no Verilator (lace sim --verilator)
Yosys	síntese; lê as portas para o testbench-modelo do lace add
Graphviz (dot)	desenho do esquemático; precisa do Yosys
surfer-aurora	visualizador de formas de onda
openFPGALoader	gravador de placas FPGA pelo cabo USB; o Lace ainda não o chama (as placas Intel são gravadas pelo quartus_pgm do Quartus)
Lace Learn	exercícios de Verilog corrigidos a cada gravação, no estilo do rustlings (lace learn, e a vista Exercícios do Studio); precisa do Icarus
RTL viewer	o esquemático interativo do netlist da síntese, no navegador (lace synth --open); precisa do Yosys

Para instalar um aplicativo do bundle depois, sem reinstalar o Lace: lace install, que abre a lista no terminal, ou lace install verilator. Para ver se há versão nova do Lace e das ferramentas: lace update --check.

Detalhes, remoção e problemas conhecidos: docs/INSTALL.md. Quem tem o Solar 0.1.0 (o nome anterior do Lace) desinstala o Solar antes: docs/INSTALL.md, Quem tem o Solar 0.1.0.

Extensão do VS Code

A extensão ainda não está no Marketplace: o arquivo dela, lace-vscode-<versão>.vsix, vai anexado à release do Lace. Ela precisa do Lace instalado (acima) e do VS Code 1.90 ou mais novo.

curl -fLO https://github.com/ART3121/lace/releases/download/v0.9.0/lace-vscode-0.1.0.vsix
code --install-extension lace-vscode-0.1.0.vsix

No Windows, os mesmos dois comandos no PowerShell, com curl.exe no lugar de curl. Sem o terminal: baixe o .vsix da página da release e, no VS Code, abra Extensões, o menu ... e Install from VSIX.... Para atualizar, instale o .vsix novo do mesmo jeito; para remover, desinstale pela aba Extensões.

A extensão ativa numa pasta com .spf e procura o lace no PATH. Se o VS Code não o achar (no Linux e no macOS, aberto pelo menu do sistema, ele pode não ver o ~/.local/bin), ponha o caminho do executável na configuração lace.path. O que ela faz, e o que cada versão do Lace habilita: editors/vscode/README.md.

Depois de instalar

lace tools --verify        # o bundle, as versões e a conferência dos hashes

Um projeto do Lace é Verilog; processadores SAPHO são uma etapa a mais, que o YANC compila antes de verificar, simular ou sintetizar. Verilog:

lace new contador
cd contador
lace add contador.v        # cria o módulo e o registra como topo
lace add contador_tb.v     # cria o testbench, que já instancia contador
lace check                 # Icarus: o design e cada testbench
lace hierarchy             # a árvore de instâncias do design e do testbench
lace sim                   # simula e mostra o que o testbench escreve, enquanto roda
lace wave                  # abre a onda no surfer-aurora

Um testbench sem $finish não termina sozinho: o Ctrl+C encerra a simulação, e lace sim --timeout 30 a encerra depois de 30 s.

Processador SAPHO:

lace new demo
cd demo
lace proc add filtro       # cria filtro/filtro.cmm
lace build                 # C± -> Verilog, memórias e testbench, pelo YANC
lace sim -p filtro         # simula e mostra as saídas
lace wave -p filtro

Cada build, check, sim e synth grava um relatório no projeto (.lace/reports/): a máquina, as ferramentas e versões, o tempo de cada passo e, na síntese, as estatísticas do Yosys:

lace synth                 # sintetiza e grava o relatório
lace report                # o relatório mais novo
lace report list           # todos, do mais novo para o mais antigo
lace report compare        # o mais novo contra o anterior comparável

Os projetos seguem a estrutura do YANC 7.1: o fonte e os valores de entrada ficam na pasta do processador (filtro/filtro.cmm, filtro/input_0.txt, um valor por linha), e tudo o que o YANC gera, com as saídas da simulação, em filtro/filtro/. Um projeto da estrutura antiga (Software/, Hardware/, Simulation/) é convertido com lace convert, ou pelo Studio ao abri-lo. Para mover ou renomear um arquivo do projeto sem tirá-lo do .spf, use lace move (lace move contador.v rtl/). Caminhos na linha de comando são relativos ao diretório atual do shell. A referência da linha de comando, com as regras de cada fluxo, está em docs/CLI.md.

Para outro programa (uma extensão de editor, um script), todo comando aceita --json, um objeto no fim, e --events, um objeto JSON por linha enquanto as ferramentas rodam. O formato de cada um está em docs/schema/, gerado do código.

Como as partes se ligam

A linha de comando lace linka as bibliotecas e chama as funções do lace-core. Os outros programas falam com um processo filho, o servidor do Lace (lace serve), por JSON-RPC: o Lace Studio, que o abre sozinho, a extensão do VS Code e scripts. Os pedidos e as respostas são os do crate lace-protocol (docs/PROTOCOL.md). Um agente de IA fala com o mesmo servidor em MCP: o lace serve reconhece o idioma pelo primeiro pedido, e o lace mcp é o mesmo servidor, sempre em MCP (docs/CLI.md). O lace chat e a vista Assistente do Studio usam o lace-agent, que abre o Claude Code com o lace mcp. O lace mcp, o lace chat e a vista Assistente são experimentais: só funcionam depois de lace experimental enable assistant.

Documentação

Documento	Para quê
docs/INSTALL.md	instalar, mudar componentes, remover
studio/README.md	o Lace Studio: usar, compilar, a documentação dele (studio/docs/)
editors/vscode/README.md	a extensão do VS Code: o que faz, configurações, compilar e testar
docs/CLI.md	a linha de comando lace
docs/LEARN.md	os exercícios do lace learn: fazer e escrever
docs/FPGA.md	as placas FPGA pelo Quartus Prime, um componente experimental (lace experimental enable fpga)
docs/API.md	a API do lace-core, que a CLI e o lace serve usam
docs/PROTOCOL.md	cada método do lace serve e do lace mcp, com os parâmetros, o resultado, as notificações, os erros e os tipos; gerado dos tipos
docs/BUNDLE.md	o que vem no bundle, como montá-lo e o que vem do sistema
docs/schema/	o JSON Schema do --json e do --events de cada comando e o do protocolo do lace serve (protocol-request.json, protocol-response.json)
docs/RELEASE.md	as releases: que número cada uma recebe, quando lançar e o passo a passo
CONTRIBUTING.md	como contribuir: preparar a máquina, onde mudar o quê, o que conferir
docs/METODOLOGIA.md	como o código se organiza e como a API muda sem quebrar quem a usa
CHANGELOG.md	mudanças por versão

Compilar do fonte

cargo build --release
python3 scripts/bundle.py --out dist/toolchain     # o bundle de ferramentas, com o Studio
target/release/lace tools --toolchain dist/toolchain --verify

O Studio sozinho, para desenvolver: cd studio && npm install && npm run tauri dev (studio/docs/DEVELOPMENT.md).

No Linux, antes de rodar o Studio do código-fonte, instale as dependências do Tauri:

# Ubuntu / Debian
sudo apt update
sudo apt install build-essential curl wget file libwebkit2gtk-4.1-dev libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

# Fedora
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libappindicator-gtk3-devel librsvg2-devel
sudo dnf group install c-development

O que montar o bundle exige está em docs/BUNDLE.md.

Licença

O Lace e o Lace Studio estão sob a licença MIT (LICENSE). As ferramentas do bundle (YANC, Icarus Verilog, Verilator, cocotb, Yosys, Graphviz, surfer-aurora, openFPGALoader) seguem as licenças delas. O Quartus Prime não vem com o Lace: cada um instala o seu, sob a licença da Intel.

NIPS-CERN, Núcleo de Instrumentação e Processamento de Sinais, Faculdade de Engenharia da UFJF. https://nipscern.com