Skip to content

Parts Centre

PedroVMota edited this page Nov 13, 2026 · 2 revisions

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).

O que mostra

  • 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.

Colocar uma peça

  • 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).

Importar e exportar

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.

Biblioteca incluída

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

Biblioteca do utilizador

  • Ficheiros .bwmacro em ~/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 para Imported/….
  • 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 .bwmacro dentro dessa pasta e nomes saneados (sem separadores, sem ponto inicial, sem caracteres de controlo).

Limitações

A pré-visualização do Parts Centre não mostra o estilo IEC (as macros só têm um estilo).

Clone this wiki locally