Skip to content
PedroVMota edited this page Nov 13, 2026 · 3 revisions

bitwerk

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.

O que já faz

Á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.

Prioridades do projeto

  1. Desempenho — a interface nunca pode engasgar ao fazer zoom, pan ou ao manipular muitos objetos, e a simulação nunca bloqueia a interface.
  2. 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.

Por onde começar

Para quem desenvolve

Histórico

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).

Clone this wiki locally