Skip to content

Linha de Comandos

PedroVMota edited this page Nov 13, 2026 · 2 revisions

Linha de comandos

O executável chama-se bitwerk (crate bw-app). As opções são lidas no arranque (crates/bw-app/src/main.rs e BitwerkApp::new em app.rs).

bitwerk [FICHEIRO.bitwerk | FICHEIRO.dwm] [OPÇÕES]
bitwerk FICHEIRO --export-dwm SAÍDA.dwm

Com cargo: cargo run --release -p bw-app -- <argumentos>.

Abrir ficheiros

Argumento Efeito
ficheiro.bitwerk Abre o projeto no arranque.
ficheiro.dwm Importa um circuito do Digital Works (de forma síncrona, para as outras opções atuarem sobre o resultado) e mostra o relatório.
--report Mostra o relatório de importação (comportamento por omissão; prevalece sobre --no-report).
--no-report Não abre a janela do relatório de importação.
--import-dw-folder PASTA Importa uma pasta de macros do Digital Works para a biblioteca do utilizador (abre o Parts Centre com o progresso).

Exportar para o Digital Works

Opção Efeito
FICHEIRO --export-dwm SAÍDA.dwm Exporta um .bitwerk (ou um .dwm importado) para o Digital Works sem abrir janela e escreve o relatório no terminal. Código de saída 0 se correu bem, 1 se a leitura ou a exportação falhou, 2 sem ficheiro de entrada. A extensão .dwm é acrescentada à saída se faltar. As outras opções são ignoradas.
--save-as-dwm SAÍDA.dwm Faz o mesmo dentro da app, sobre o ficheiro aberto no arranque, e mostra a janela do relatório (automação, capturas).

Ver Exportação para o Digital Works.

Aspeto e navegação

Opção Efeito
--style iec|ansi Estilo dos símbolos (qualquer valor diferente de iec dá ANSI).
--view X,Y,ZOOM Posição e zoom da câmara quando a cena fica pronta (capturas reprodutíveis).
--enter ID/ID/… Abre esse caminho de instâncias de macros quando o projeto estiver carregado (por exemplo --enter 3).
--select ID Seleciona um componente.
--parts [CHAVE] Abre o Parts Centre e, opcionalmente, seleciona a peça (por exemplo builtin/dual-dff).
--memory-window ID Abre a janela Memory Contents do componente com esse id.

Simulação

Opção Efeito
--run Começa a simular logo no arranque.

Janela

Opção Efeito
--window-pos X,Y Posição da janela (para medir sempre no mesmo monitor).
--on-top Janela sempre por cima (uma janela tapada não é desenhada; útil para capturas automáticas).
--frame-latency N Frames em fila para apresentação (experimental; o valor por omissão do eframe é 2).

Depuração e medição

Opção Efeito
--stress Carrega o teste de carga de 100k componentes e regista estatísticas de frame.
--stress-macros Carrega o teste de carga com macros: 2 500 células "contador de 4 bits → somador de 4 bits", quatro níveis, 37 500 instâncias, 70 150 primitivas.
--continuous Redesenha todos os frames (por omissão só se redesenha quando algo muda).
--sweep Com --stress ou --stress-macros: medição automática de ≈20 s que termina sozinha e imprime um resumo. Ativa também o redesenho contínuo e a janela por cima.
--sweep-csv FICHEIRO Com --sweep: grava os tempos de cada frame num CSV.

A descrição do guião do --sweep e os resultados estão em Desempenho.

Variáveis de ambiente

Variável Efeito
RUST_LOG Filtro do tracing (por omissão info,wgpu_core=warn,wgpu_hal=warn).
BITWERK_DWM_CORPUS Só nos testes: pasta com os .dwm para o teste dwm_corpus.
BITWERK_REGEN_LIBRARY Só nos testes: =1 regenera a biblioteca incluída e examples/macros-demo.bitwerk.

Exemplos

# Contador a correr com a memória aberta
bitwerk examples/flipflops-memory.bitwerk --run --memory-window 18

# Demonstração de macros, dentro do contador de décadas
bitwerk examples/macros-demo.bitwerk --run --enter 3

# Estilo IEC
bitwerk examples/all-components.bitwerk --style iec

# Importar um circuito do Digital Works sem relatório e pô-lo a correr
bitwerk circuito.dwm --no-report --run

# Exportar um projeto para o Digital Works, sem janela
bitwerk examples/half-adder.bitwerk --export-dwm half-adder.dwm

# Medição reprodutível
bitwerk --stress --sweep --sweep-csv frames.csv --window-pos 1260,560
bitwerk --stress-macros --sweep

Clone this wiki locally