Repository navigation
Home
bitwerk é um simulador de circuitos lógicos digitais para macOS, escrito em Rust, com renderização na GPU (wgpu sobre Metal). É inspirado nas ferramentas educativas clássicas de lógica digital — em particular no Digital Works 3.0.5 (Win32) —, mas o código, os símbolos e o formato de ficheiro são próprios. Consegue ainda importar circuitos, macros e mapas de memória do Digital Works e exportar para esses formatos.
Estado: em desenvolvimento (versão
0.1.0). Ainda não há desfazer/refazer nem copiar/colar, e os ficheiros exportados para o Digital Works ainda não foram abertos no Digital Works real. Ver Limitações e roadmap.
| Área | Resumo |
|---|---|
| Componentes | Portas AND/OR/NAND/NOR/XOR/XNOR (2 a 8 entradas), NOT, buffer tri-state, flip-flops D/RS/JK (4 modos de disparo, PRE/CLR assíncronos), RAM/ROM, interruptores, botões de pressão, entradas de impulsos, relógios, geradores de sequências, VCC/massa, LEDs, mostradores de 7 segmentos, saídas numéricas e anotações de texto. Ver Componentes. |
| Fios | Grafo de segmentos ortogonais com junções automáticas, rubber-banding e barramentos tri-state. Ver Fios e junções. |
| Simulação | Orientada a eventos, lógica de quatro estados (0, 1, Z, X), dois modos de avaliação (atraso unitário e sequencial compatível com o Digital Works), deteção de race conditions e de bus contention. Ver Simulação. |
| Memória | RAM/ROM até 16 384 palavras de 16 bits, janela de conteúdo com edição ao vivo, ficheiros .map. Ver Memória. |
| Macros | Sub-circuitos hierárquicos referenciados (não copiados), navegação para dentro de uma instância com o estado ao vivo, modelos em caixa ou DIL, datasheets. Ver Macros e hierarquia e Parts Centre. |
| Importação | Ficheiros .dwm, .dwt e .map do Digital Works, com relatório detalhado. Os 495 .dwm do pacote oficial importam sem erros. Ver Importação do Digital Works. |
| Exportação |
Save As… / Export as Digital Works 3.0.5 (.dwm)…, macros e .map binário, com relatório do que foi aproximado ou perdido. Os 495 .dwm do pacote fazem a ida e volta com a mesma estrutura (ainda não testado no Digital Works real). Ver Exportação para o Digital Works. |
| Desempenho | Testado com 100 mil componentes (≈778 mil instâncias na GPU) e com 37 500 instâncias de macros, sem engasgos. Ver Desempenho. |
| Segurança | Sem unsafe, sem rede, todos os ficheiros tratados como entrada hostil, cinco alvos de fuzzing. Ver Segurança. |
- Desempenho — a interface nunca pode engasgar ao fazer zoom, pan ou ao manipular muitos objetos, e a simulação nunca bloqueia a interface.
-
Segurança do código — não há
unsafe, todos os ficheiros são tratados como entrada hostil, não há rede e nada de um ficheiro é executado.
-
Instalação e compilação — requisitos,
make, bundle.app. - Guia rápido — o primeiro circuito em poucos minutos.
- Interface — ferramentas, paleta, propriedades, menus e atalhos.
-
Linha de comandos — opções do executável
bitwerk.
- Arquitetura — crates, threads, fluxo de dados UI ↔ simulador, pipeline de renderização.
-
Formato de ficheiros —
.bitwerk(RON v5),.bwmacro,.map,.dwm(importação e exportação). - Exportação para o Digital Works — o que se perde e como é verificado.
- Testes e qualidade e Contribuir.
| Commit | Conteúdo |
|---|---|
a511e1e |
Versão inicial: portas, interruptores, relógios, LEDs, renderizador wgpu e motor de simulação. |
96807bc |
Flip-flops, tri-state, memória, sinais de quatro estados e junções de fios. |
c1feae5 |
Macros, navegação na hierarquia e Parts Centre. |
0640044 |
Importação de circuitos, macros e mapas de memória do Digital Works (.dwm). |
ef7b00a |
Seta ASCII no relatório de importação (a fonte da UI não tem U+2192). |
2c8fac2 |
Ficheiros de licença LICENSE-MIT e LICENSE-APACHE. |
2e3dc19 |
Escritor do stream de objetos do Digital Works, com os mesmos programas de campos do leitor. |
ee07237 |
Testes de comportamento da exportação e alvo de fuzzing roundtrip_dwm. |
32a0c0c |
Exportação na interface: Save As…, Export as Digital Works, macros, janela de memória e linha de comandos. |
038873f |
Merge do PR #1 (Save As com exportação para o Digital Works). |
bitwerk — 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