Repository navigation
Componentes
Cada componente é um bw_core::ComponentKind com parâmetros próprios, uma posição na grelha inteira e uma rotação (0°, 90°, 180°, 270°). A geometria dos pinos é uma função pura do tipo (ComponentKind::pin_offset) e os símbolos desenhados coincidem exatamente com ela (há testes para todos os tipos e variantes).
Convenções gerais:
- As entradas ficam à esquerda (de cima para baixo) e as saídas à direita, salvo indicação em contrário.
- Os níveis são de quatro estados: 0, 1, Z (flutuante) e X (desconhecido/conflito). Uma entrada flutuante lê-se como X no modo de atraso unitário e como 0 no modo sequencial. Ver Simulação.
- Com zoom suficiente, passar o rato sobre um pino mostra o nome dele.
| Componente | Nome no ficheiro | Entradas | Saídas | Tamanho (grelha) |
|---|---|---|---|---|
| AND/OR/NAND/NOR/XOR/XNOR | Gate(op, inputs) |
2–8 | 1 | 4 × 2·n |
| NOT | Not |
1 | 1 | 4 × 2 |
| Tri-state | TriState |
IN, EN | OUT (tri-state) | 4 × 3 |
| Interruptor / botão / impulsos | Switch(on, mode) |
— | 1 | 2 × 2 |
| Relógio | Clock(half_period) |
— | 1 | 2 × 2 |
| Gerador de sequências | SeqGen(pattern, len, half_period) |
— | 1 | 4 × 2 |
| VCC / massa | Const(high) |
— | 1 | 2 × 2 |
| LED | Led |
1 | — | 2 × 2 |
| 7 segmentos | SevenSeg(common_anode) |
a…g | — | 8 × 12 |
| Saída numérica | Numeric(bits, format, signed) |
2–16 | — | depende dos algarismos |
| Flip-flop D/RS/JK | FlipFlop(ty, trigger, preset_clear) |
D,C / S,C,R / J,C,K (+PRE, CLR) | Q, Q̄ | 8 × 4 ou 8 × 6 |
| RAM / ROM | Memory(ty, addr_bits, data_bits) |
A…, (D…, R/W̄), C̄S̄ | Q… (tri-state) | 8 × variável |
| Tag de macro | Tag(dir, tristate) |
1 (Out) |
1 (In) |
4 × 2 |
| Instância de macro | Macro(id) |
da definição | da definição | caixa ou DIL |
| Anotação de texto | Text(w, h) |
— | — | caixa do texto |
- AND, OR, NAND, NOR, XOR, XNOR com 2 a 8 entradas (o número define-se em Gate inputs na paleta ou nas propriedades). O Digital Works só tinha XOR/XNOR de 2 entradas; aqui todas as portas aceitam 2–8.
- NOT com uma entrada.
- Regras de quatro estados: AND com algum 0 dá 0; OR com algum 1 dá 1; NAND/NOR igual mas negado. Fora disso, qualquer entrada X dá X. XOR/XNOR/NOT dão X com qualquer entrada desconhecida.
- No estilo ANSI, o lado das entradas cresce com uma linha de entrada prolongada; no IEC o retângulo cresce.
- Pinos: IN, EN (no topo do símbolo) e OUT.
- EN = 1 → OUT segue IN (IN desconhecido dá X); EN = 0 → OUT flutuante (Z); EN desconhecido → X.
- A saída pode partilhar uma rede com outras saídas tri-state, formando um barramento. Ver Fios e junções.
| Modo | Comportamento com a ferramenta Interact | Propriedade on
|
|---|---|---|
| Toggle (por omissão) | Cada clique troca o nível. Funciona também com a simulação parada. | nível atual |
Push button (Momentary) |
O nível é o inverso de on enquanto o botão do rato está premido. |
false: push-to-make; true: push-to-break
|
| Pulse | Onda quadrada à velocidade de relógio por omissão (10 ticks por meio período); um clique define a fase atual. | nível com que o ciclo começa |
Dentro de uma macro, mudar um interruptor altera a definição (todas as instâncias).
Onda quadrada que troca a cada half_period ticks (1 a 1 000 000; por omissão 10, ou seja 1 Hz com os 20 ticks/s por omissão). Pode ter cor.
Padrão cíclico de 1 a 64 bits: o bit i do padrão é o passo i, e cada passo dura half_period ticks, como um relógio (um relógio é o padrão 01). O reset recomeça no passo 0 e o Step conta cada passo como meio ciclo. Nas propriedades há um editor binário (passos) ou hexadecimal, com pré-visualização da forma de onda.
Nível fixo 1 (VCC, Const(high: true)) ou 0 (massa, Const(high: false)).
Uma entrada. Aceso a 1 (na cor do LED), apagado a 0, cinzento quando flutuante (a "terceira cor" do original) e laranja quando desconhecido. Pode ter uma de 16 cores.
Entradas a…g ao longo da base, uma unidade entre si (como no Digital Works). Cátodo comum: um segmento acende a 1; ânodo comum (common_anode: true): acende a 0.
2 a 16 entradas à esquerda (a entrada k é o bit k, pinos D0…). Mostra o valor em binário (um algarismo por bit), hexadecimal ou decimal, com interpretação em complemento para dois opcional (signed). Um bit X/Z mostra traços. Os algarismos são calculados no shader.
Os mostradores são simulados como nós cujos "sinais de mostrador" espelham as entradas, por isso o renderizador acende segmentos e algarismos sem trabalho extra por frame.
Três tipos, cada um com saídas Q e Q̄ (Q̄ é sempre o complemento de Q; com Q = X, ambas são X) e, opcionalmente, PRE (topo) e CLR (base), assíncronos e ativos a 1.
| Tipo | Entradas | Tabela (quando "toma" as entradas) | Disparo por omissão |
|---|---|---|---|
| D | D, C | Q ← D | Flanco ascendente |
| RS | S, C, R | 00 mantém, S = 1 SET, R = 1 RESET, 11 proibido → Q = Q̄ = X | Latch |
| JK | J, C, K | 00 mantém, 01 RESET, 10 SET, 11 toggle | Master-slave |
Modos de disparo (trigger):
| Modo | Comportamento | Marca no símbolo |
|---|---|---|
| Level (latch) | Transparente enquanto C = 1, memoriza com C = 0. Não existe para o JK (oscilaria). |
C simples |
| Master-slave | O master segue as entradas com C = 1 e Q copia o master no flanco descendente. No JK o master recebe a realimentação de Q, por isso muda no máximo uma vez por impulso (ones catching). |
C com a marca de saída adiada ⌐ junto a Q/Q̄ |
| Rising edge | Entradas lidas só no flanco 0 → 1 de C. | Triângulo dinâmico |
| Falling edge | Entradas lidas só no flanco 1 → 0 de C. | Triângulo com bolha |
- PRE/CLR atuam sem relógio e dominam-no enquanto ativos; os dois ativos dão Q = Q̄ = X. Sem fio ficam inativos.
- A avaliação com X é exata: uma entrada desconhecida só dá X se os valores possíveis discordarem (JK com J = 1, K = 0 dá 1 mesmo com Q desconhecido). Um flanco "talvez" (0 → X ou X → 1) só torna Q desconhecido se o novo valor diferir do atual.
- Arrancam com Q = 0. Um flip-flop com o relógio flutuante nunca dispara.
2ⁿ palavras com n = 4…14 linhas de endereço (16 a 16 384 palavras) e 1, 2, 4, 8 ou 16 bits por palavra (por omissão 256 × 8). Pinos, semântica e janela de conteúdo estão em Memória.
-
Tag
In/Out: pinos de interface de uma definição de macro. Uma tagInconduz a rede interior a partir do pino da instância; umaOutlê-a. UmaOuttri-state torna essa saída da instância tri-state. -
Instância (
Macro): referência a uma definição, desenhada como caixa ou DIL.
Ver Macros e hierarquia.
Texto sem pinos, com várias linhas (até 16 linhas e 1 KiB, sem caracteres de controlo), altura, cor, negrito, itálico, barra superior e rotação de 90°. O texto fica nas notes do circuito e a caixa segue o texto.
LEDs, relógios, geradores, mostradores (7 segmentos e numérico) e anotações podem ter uma cor de uma paleta de 16: Red, Orange, Yellow, Lime, Green, Cyan, Blue, Navy, Purple, Magenta, White, Grey, Black, Brown, Olive, Teal. Sem cor usa-se a do tipo. O preto desenha-se cinzento-claro, para se ver no fundo escuro.
Quando não estão ligados: PRE/CLR ficam inativos (0), o C̄S̄ da memória fica selecionado (0) e o R/W̄ fica em leitura (1). Ligados a uma rede flutuante, leem-se como X. Assim um flip-flop ou uma ROM funcionam sem fios de controlo, e um controlo ligado mas indefinido continua visível.
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