Repository navigation
Simulacao
O motor (crates/bw-sim) é orientado a eventos, com ciclos delta e lógica de quatro estados. Corre numa thread própria e nunca bloqueia a interface. A arquitetura interna está em Arquitetura.
| Valor | Significado | Cor do fio | LED |
|---|---|---|---|
| 0 | nível baixo | verde escuro | apagado |
| 1 | nível alto | verde claro | aceso (cor do LED) |
| Z | flutuante / alta impedância: ninguém conduz a rede (tri-state inativo) ou a entrada não está ligada | cinzento-azulado | cinzento |
| X | desconhecido ou em conflito (RS = 11, dois condutores, entrada desconhecida) | laranja | laranja |
Cada rede guarda o valor em 2 bits. As regras de cada componente estão em Componentes.
| Comando | Tecla | Efeito |
|---|---|---|
| Run | F9 | Corre ao ritmo de ticks/s. Se estava Halted por um erro, repõe primeiro. |
| Stop | F10 | Para e repõe: todas as redes recomeçam, flip-flops com Q = 0, memórias com o conteúdo de projeto (as escritas da RAM perdem-se). |
| Pause | F11 | Pausa / retoma (só a partir de Running ou Paused). |
| Step | F12 | Com a simulação parada ou em pausa: ½ ciclo avança até ao próximo flanco de relógio; ciclo completo até ao segundo. Sem relógios no circuito, avança um tick. |
Estados possíveis: Stopped, Running, Paused, Halted.
Com a simulação parada, o circuito combinacional continua a ser avaliado depois de cada edição (feedback imediato). O tempo — relógios, geradores, impulsos — só avança com Run ou Step.
- O ritmo define-se na barra (ticks/s): 0,1 a 1 000 000, por omissão 20.
- Um relógio troca a cada
half_periodticks (por omissão 10 → 1 Hz a 20 ticks/s). As entradas de impulsos usam o mesmo valor. Os geradores de sequências avançam um passo a cadahalf_period. - O motor corre os ticks em lotes de no máximo 10 000 por iteração, para responder sempre a comandos. Se não consegue acompanhar o ritmo, descarta o atraso acumulado em vez de entrar em espiral.
- Publica snapshots para a UI no máximo a cada 8 ms.
Depois de um reset o circuito é avaliado de uma vez. Nesse instante não há flancos de relógio, e um relógio/preset/clear ainda indefinido não estraga o estado guardado. Os flip-flops arrancam com Q = 0 e as memórias com o conteúdo de projeto.
Cada projeto escolhe como as alterações se propagam (menu Circuit ou lista na barra). O modo é gravado no ficheiro como eval: Sequential (omitido para o atraso unitário).
Atraso unitário (UnitDelay, por omissão) |
Sequencial (Sequential, compatível com o Digital Works) |
|
|---|---|---|
| Propagação | Cada porta demora um ciclo delta; todas as mudanças de um delta aplicam-se ao mesmo tempo (Jacobi). | Os nós pendentes são avaliados um a um e cada saída nova fica logo visível para os seguintes no mesmo varrimento (Gauss–Seidel), por uma ordem determinística (a ordem das redes no fan-out). |
| Arranque | Tudo flutuante (Z). | Todas as redes a 0. |
| Entrada flutuante ou sem fio | Lê-se como X. | Lê-se como 0. |
| Flip-flops, memórias, barramentos, X de conflitos, Z dos tri-state | iguais | iguais |
| Uso típico | Circuitos nativos. | Projetos importados de .dwm (abrem neste modo). |
Porquê dois modos: os exemplos do Digital Works constroem latches com portas (por exemplo um JK master-slave com oito NAND). Com atraso unitário, o latch RS de duas NAND cujas entradas voltam a 1 ao mesmo tempo oscila para sempre e, a partir do arranque flutuante, fica em X. No modo sequencial assenta, como no programa original. Os testes bw-sim/tests/dwm.rs e components.rs verificam os dois comportamentos.
O modo é uma constante de compilação da função de avaliação, por isso o caminho quente do atraso unitário não ficou mais lento.
Se a rede não estabiliza ao fim de nós + 16 deltas (ou varrimentos, no modo sequencial), a simulação para com "Race condition, process halted (net N, …)". Uma oscilação verdadeira (por exemplo uma NAND realimentada pela própria saída) para nos dois modos; um latch que assenta já não para no modo sequencial.
Se, depois de o circuito estabilizar, dois ou mais condutores tri-state da mesma rede estão a conduzir 0/1, a simulação para com "Bus contention, process halted", o número da rede e os componentes em conflito. Esses componentes ficam contornados a vermelho no canvas.
- A verificação é feita no fim de cada estabilização e não a cada delta: dois enables complementares que se sobrepõem durante um delta (por atrasos diferentes) não dão falso alarme.
- Um condutor a X faz a rede X, mas não conta como conflito.
- O exemplo
examples/bus-contention.bitwerkpara logo ao abrir.
O erro diz onde, com o caminho de instâncias, por exemplo:
Bus contention at higher level, process halted (net 7, at root › Board#4 › Clash#2 › Tri-state#3 and root › Board#4 › Clash#2 › Tri-state#4)
O contorno vermelho marca, em cada nível, o componente ou a instância que contém o conflito.
- As edições chegam ao simulador como
Edite são agrupadas: a netlist é recompilada uma vez por lote. - Edições só geométricas (mover/rodar componentes, mover junções e curvas, arrastar segmentos, editar a memória) não recompilam.
- Ao recompilar, o estado dos flip-flops e o conteúdo das memórias passam para a nova compilação (por id de componente ou caminho de instâncias): editar um circuito a correr não apaga o contador nem a RAM. Só Stop (ou abrir outro circuito) repõe tudo.
- Enquanto o simulador recompila, os componentes que não mudaram mantêm a cor; os editados recebem a cor certa quando a compilação termina (≈20–30 ms para 100k componentes).
As macros são achatadas na compilação (bw_sim::flatten), por isso simular não tem custo de hierarquia. Os templates de cada definição ficam em cache pelo hash de conteúdo; editar uma definição reconstrói só o dela e os das definições que a contêm. Ver Macros e hierarquia.
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