Repository navigation
Linha de Comandos
PedroVMota edited this page Nov 13, 2026
·
2 revisions
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.dwmCom cargo: cargo run --release -p bw-app -- <argumentos>.
| 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). |
| 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.
| 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. |
| Opção | Efeito |
|---|---|
--run |
Começa a simular logo no arranque. |
| 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). |
| 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á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. |
# 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 --sweepbitwerk — simulador de circuitos lógicos digitais para macOS · Licença MIT OR Apache-2.0 (LICENSE-MIT e LICENSE-APACHE no repositório) · A fonte de verdade é o código e o README.md do repositório; esta wiki descreve a versão 0.1.0.
Começar
Utilização
- Componentes
- Fios e junções
- Simulação
- Memória
- Macros e hierarquia
- Parts Centre
- Importação do Digital Works
- Exportação para o Digital Works
Referência técnica
Projeto