Skip to content

Simulacao

PedroVMota edited this page Nov 13, 2026 · 1 revision

Simulação

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.

Os quatro estados

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.

Controlos

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.

Ticks e velocidade

  • 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_period ticks (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 cada half_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.

Arranque

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.

Modos de avaliação (EvalMode)

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.

Erros que param a simulação

Race condition

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.

Bus contention

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.bitwerk para logo ao abrir.

Erros dentro de macros

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.

Editar com a simulação a correr

  • As edições chegam ao simulador como Edit e 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).

Hierarquia

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.

Clone this wiki locally