Repository navigation
Parts Centre
O Parts Centre é o navegador de macros: as definições do projeto, a biblioteca incluída no binário e as peças do utilizador.
Abre-se em Macro → Parts Centre (⇧⌘P), no botão da paleta, no menu de contexto do canvas ou com --parts [CHAVE]. Pode ser uma janela flutuante ou um painel acoplado (opção Docked).
- Pesquisa por nome.
-
Pastas:
- This project — as definições do projeto e quantas instâncias tem cada uma;
- Built-in › … — a biblioteca incluída;
- My parts › … — a biblioteca do utilizador.
- Pré-visualização do símbolo e dos pinos (com os números DIL) e o datasheet.
- Place e depois clicar no canvas, duplo clique, ou arrastar a peça para o canvas.
- Colocar uma peça da biblioteca importa-a com as dependências; as definições com o mesmo conteúdo (hash) já presentes no projeto são reutilizadas.
- Uma definição importada lembra a origem (chave e hash). Quando a versão da biblioteca muda aparece Update from library, que substitui a definição mantendo o id (todas as instâncias seguem).
| Ação | Efeito |
|---|---|
| Import… (ou Macro → Import .bwmacro…) | Lê um .bwmacro para o projeto. |
| Export .bwmacro… | Grava uma definição com todas as dependências. |
| Export as Digital Works macro… (propriedades da macro) | Grava uma definição como macro .dwm do Digital Works 3.0.5 (com perdas; ver Exportação para o Digital Works). |
| Import Digital Works folder… | Converte todos os .dwm de uma pasta para a biblioteca do utilizador. Ver Importação do Digital Works. |
Ficheiros .bwmacro em crates/bw-io/library/, embutidos com include_str!. São circuitos originais feitos com as primitivas do bitwerk, cada um com um datasheet escrito para este projeto. Todas as peças têm testes de comportamento (tabelas de verdade completas e sequências de relógio).
| Pasta | Chave | Peça |
|---|---|---|
| Arithmetic | builtin/half-adder |
Meio somador |
| Arithmetic | builtin/full-adder |
Somador completo (dois meios somadores) |
| Arithmetic | builtin/adder-4 |
Somador de 4 bits (quatro somadores completos; três níveis) |
| Selectors | builtin/mux-2 |
Multiplexador 2:1 |
| Selectors | builtin/mux-4 |
Multiplexador 4:1 (três 2:1) |
| Selectors | builtin/decoder-3to8 |
Descodificador 3 → 8 |
| Registers | builtin/register-4 |
Registo de 4 bits (LD, CLR) |
| Registers | builtin/shift-register-4 |
Registo de deslocamento de 4 bits com carga paralela |
| Counters | builtin/counter-4 |
Contador síncrono de 4 bits (EN, CLR, carry) |
| Counters | builtin/decade-counter |
Contador de décadas (BCD) |
| Flip-flops | builtin/t-flip-flop |
Flip-flop T |
| Display | builtin/bcd-7seg |
Driver BCD → 7 segmentos |
| Gates |
builtin/and-5, builtin/or-5, builtin/and-6, builtin/or-6
|
AND/OR de 5 e 6 entradas (árvores de portas) |
| DIL packages | builtin/quad-nand2 |
Quatro NAND de 2 entradas (DIL-14, estilo série 74) |
| DIL packages | builtin/quad-and2 |
Quatro AND de 2 entradas (DIL-14) |
| DIL packages | builtin/hex-inverter |
Seis inversores (DIL-14) |
| DIL packages | builtin/dual-dff |
Dois flip-flops D (DIL-14; PRE/CLR ativos a 1, ao contrário de muitas peças reais, como diz o datasheet) |
Os ficheiros são gerados por código (crates/bw-sim/tests/library.rs, com um pequeno router de labirinto para os fios) e um teste falha se divergirem. Para os regenerar (também examples/macros-demo.bitwerk):
BITWERK_REGEN_LIBRARY=1 cargo test -p bw-sim --test library- Ficheiros
.bwmacroem~/Library/Application Support/bitwerk/Parts(criada quando é precisa), com um subnível de pastas por pasta da biblioteca. As peças importadas do Digital Works vão paraImported/…. - Ações: Add to my parts (nas propriedades de uma macro do projeto), Rename, Move (para outra pasta) e Delete… (com confirmação).
-
Segurança: a leitura nunca segue links simbólicos, ignora entradas escondidas, tem a profundidade (3) e o número de ficheiros (2000) limitados e trata cada ficheiro como entrada hostil. As operações só aceitam ficheiros
.bwmacrodentro dessa pasta e nomes saneados (sem separadores, sem ponto inicial, sem caracteres de controlo).
A pré-visualização do Parts Centre não mostra o estilo IEC (as macros só têm um estilo).
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