Repository navigation
Interface
A janela principal (1280 × 800 por omissão, mínimo 640 × 400) é feita com eframe/egui, com o canvas desenhado na GPU.
┌──────────────────────────────────────────────────────────────────────────┐
│ Run Stop Pause Step [½ cycle] │ ticks/s [20] │ [Unit delay] │ Stopped tick 0│ ← barra
├────────────┬──────────────────────────────────────────────┬──────────────┤
│ Paleta │ │ Propriedades │
│ Tools │ canvas (GPU) │ │
│ Gates │ │ │
│ Inputs │ │ │
│ Outputs │ │ │
│ FF & mem. │ │ │
│ Notes │ │ │
│ Macros │ │ │
└────────────┴──────────────────────────────────────────────┴──────────────┘
Dentro de uma macro aparece também uma barra de breadcrumbs (root › Decade counter#3 › …). Ver Macros e hierarquia.
| Controlo | Função |
|---|---|
| Run (F9) | Começa a simular. Depois de um erro (Halted), repõe o estado antes de correr. |
| Stop (F10) | Para e repõe tudo: flip-flops com Q = 0, memórias com o conteúdo de projeto. |
| Pause (F11) | Pausa / retoma. |
| Step (F12) | Avança até ao próximo flanco de relógio (½ ciclo) ou dois flancos (ciclo completo), escolhido na lista ao lado. Só atua parado ou em pausa. |
| ticks/s | Ritmo da simulação (0,1 a 1 000 000; por omissão 20). |
| Modo | Unit delay ou Sequential (DW). Ver Simulação. |
| Estado | Stopped, Running, Paused ou Halted, o número do tick e, se houver, a mensagem de erro. |
Tools:
| Ferramenta | Uso |
|---|---|
| Select / move | Selecionar e mover componentes, segmentos, junções e curvas; caixa de seleção; pan no vazio. |
| Interact | Mudar interruptores, premir botões de pressão, mudar a fase de entradas de impulsos. |
| Wire | Desenhar fios. |
Depois vêm o seletor de símbolos ANSI / IEC, o número de entradas das portas (Gate inputs, 2 a 8) e os grupos de componentes, com ícones desenhados a partir dos próprios símbolos (o nome aparece ao passar o rato):
| Grupo | Componentes |
|---|---|
| Gates | AND, OR, NAND, NOR, XOR, XNOR, NOT, Tri-state |
| Inputs | Interruptor, botão de pressão, entrada de impulsos, relógio, gerador de sequências, VCC, massa |
| Outputs | LED, 7 segmentos, saída numérica |
| Flip-flops & memory | D-FF, RS-FF, JK-FF, RAM, ROM |
| Notes | Anotação de texto |
| Macros | In tag, Out tag, New (macro vazia), Parts Centre, Create Macro from Selection… |
Escolher um componente e clicar no canvas coloca-o; enquanto se escolhe o sítio, o símbolo aparece em transparência. Os componentes entram com as predefinições da documentação original: D por flanco ascendente e JK master-slave (ambos com PRE/CLR), RS latch, memória 256 × 8. Ver Componentes.
-
Nada selecionado: nome do projeto (com
•se houver alterações por gravar), número de componentes, segmentos, junções e, se existirem, definições de macros e tamanho achatado. Dentro de uma definição, mostra as propriedades da macro. - Um componente: tipo e id, posição, rotação e o editor do tipo (operação e entradas das portas, meio período do relógio, tipo/disparo/PRE-CLR dos flip-flops, tipo e tamanho da memória com Edit contents…, modo dos interruptores, padrão do gerador, formato da saída numérica, texto das anotações, cor para LEDs, relógios, geradores, mostradores e anotações), mais Rotate (R) e Delete (Del). Mudar algo que altera os pinos (por exemplo o tamanho da memória) só é possível sem fios ligados.
- Vários componentes: quantos são, Create Macro from Selection… e Delete all.
- Um segmento de fio: extremos, comprimento, quem conduz a rede (um componente, "no driver (floating)" ou "bus of N tri-state drivers") e Delete segment.
| Ação | Efeito |
|---|---|
| Roda do rato, pinch ou ⌘ + scroll | Zoom centrado no cursor. |
| Scroll de dois dedos, arrastar com o botão do meio ou o direito, arrastar no vazio (Select) | Pan. |
| Clique (Select) | Seleciona um componente ou um segmento. |
| Arrastar no vazio (Select) | Caixa de seleção (com Shift junta à seleção). |
| Shift-clique | Junta ou retira um componente da seleção. |
| Arrastar um componente | Move-o; os fios esticam-se na ortogonal (rubber-banding). |
| Arrastar uma junção ou curva | Move-a (o cursor mostra um anel azul quando há uma por baixo). |
| Arrastar um segmento | Desloca-o na perpendicular. |
| Duplo clique numa macro | Abre a definição no lugar. |
| Botão direito | Menu de contexto: Edit Macro (open inside), Macro Properties (numa macro), Create Macro from Selection…, New Macro, Parts Centre, Up One Level (dentro de uma macro). |
| Passar sobre um fio (Select/Wire) | Realça a rede inteira. |
| Passar sobre um pino (com zoom suficiente) | Mostra o nome do pino. |
Durante um arrasto vê-se uma pré-visualização; a edição aplica-se ao largar.
Arrastar ficheiros para a janela: .dwm é importado, .bitwerk é aberto, .bwmacro é importado para o projeto e uma pasta é importada para a biblioteca de peças.
| Tecla | Ação |
|---|---|
R |
Rodar o componente selecionado (90°). |
Del / Backspace
|
Apagar a seleção; a desenhar um fio, tira a última curva. |
Esc |
Cancela o fio em curso ou o arrasto; senão volta à ferramenta Select. |
/ ou Espaço
|
A desenhar um fio, troca o lado da curva do L. |
| F9 / F10 / F11 / F12 | Run / Stop / Pause / Step. |
| ⌘N / ⌘O / ⌘S / ⇧⌘S | New / Open… / Save / Save As… |
| ⌘I | Import Digital Works… |
| ⇧⌘M | Create Macro from Selection… |
| ⌘E | Edit Macro (abre a instância selecionada). |
| ⌘↑ | Up One Level. |
| ⇧⌘P | Parts Centre. |
| ⇧⌘T | Spawn Stress Test (100k componentes). |
| ⌘Q | Quit. |
As teclas só atuam quando nenhum campo de texto tem o foco.
| Menu | Itens |
|---|---|
| bitwerk | About, Hide, Hide Others, Quit |
| File | New, Open…, Save, Save As…, Import Digital Works…, Import Digital Works Folder to Library…, Export as Digital Works 3.0.5 (.dwm)… |
| View | ANSI Symbols (distinctive shapes), IEC Symbols (rectangular) |
| Circuit | Run, Stop, Pause / Resume, Step, Unit Delay Simulation, Sequential Simulation (Digital Works Compatible) |
| Macro | Create Macro from Selection…, New Macro, Edit Macro, Up One Level, Parts Centre, Import .bwmacro… |
| Debug | Spawn Stress Test (100k components), Spawn Macro Stress Test (2 500 nested cells), Continuous Repaint |
Abrir, criar ou importar com alterações por gravar pede confirmação (Discard / Cancel).
- Save (⌘S) grava o projeto no ficheiro dele; sem ficheiro, faz Save As….
-
Save As… (⇧⌘S; sem menu nativo, há também um botão Save As… na barra de simulação) tem dois formatos no diálogo: bitwerk project (o predefinido) e Digital Works 3.0.5 (.dwm, lossy export). Escolher
.dwmexporta uma cópia: o documento continua ligado ao seu.bitwerk, as alterações por gravar continuam por gravar e a barra de estado diz isso. -
Export as Digital Works 3.0.5 (.dwm)… pede logo um
.dwm. - A exportação corre numa thread própria e no fim abre a janela Digital Works export: o que foi escrito (contagens, cópias de macros), as notas em Dropped, Warnings e Approximations, e Copy as text.
- Nas propriedades de uma macro há Export as Digital Works macro…; na janela Memory Contents, Save… oferece o
.mapde texto do bitwerk ou o.mapbinário do Digital Works.
Ver Exportação para o Digital Works.
-
ANSI/IEEE 91 (formas distintivas, por omissão) e IEC 60617 (retângulos com
&,≥1,=1,1e bolha de inversão). - Muda-se em View, nos botões ANSI/IEC da paleta ou com
--style iec. Mudar de estilo só altera um uniform da GPU. - A escolha não é gravada entre sessões (a persistência do eframe não está ativa).
No canto superior esquerdo do canvas aparecem, quando relevante, FPS e tempos de frame, o modo de desenho (tudo ou culling na GPU) e a percentagem do upload de uma cena grande. Debug → Continuous Repaint força o redesenho contínuo para medir; normalmente a app só redesenha quando algo muda (0 % de CPU em repouso).
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