Repository navigation
Exportacao para o Digital Works
O bitwerk grava circuitos e macros no formato .dwm do Digital Works 3.0.5 (versão 34 do ficheiro, como o Digital Works 3.x grava) e memórias no .map binário do Digital Works. É o caminho inverso da Importação do Digital Works.
Como o Digital Works não consegue representar tudo o que o bitwerk tem, a conversão perde informação: por isso é uma exportação e não um formato de gravação do documento. Tudo o que é aproximado ou perdido aparece no relatório.
Não verificado no Digital Works real: os ficheiros exportados ainda não foram abertos no Digital Works. A confiança vem dos testes descritos abaixo (ida e volta com o importador, comparação estrutural com os ficheiros reais e um parser independente). Ver Confiança e limitações.
-
File → Save As… (⇧⌘S): o diálogo tem dois formatos, bitwerk project (o predefinido) e Digital Works 3.0.5 (.dwm, lossy export). Escolher um nome
.dwmexporta. -
File → Export as Digital Works 3.0.5 (.dwm)… pede logo um
.dwm(a extensão é acrescentada se faltar). - Na linha de comandos:
bitwerk FICHEIRO --export-dwm SAÍDA.dwm(sem janela) ou--save-as-dwm SAÍDA.dwm(dentro da app). Ver Linha de comandos.
O que acontece ao documento:
-
Continua a ser o mesmo ficheiro
.bitwerk: o caminho do documento não muda e ⌘S continua a gravar o projeto bitwerk, não o.dwm. -
As alterações por gravar continuam por gravar (o
•mantém-se); a barra de estado diz que o documento não mudou e quantas aproximações/omissões houve. - A exportação (construção do grafo, escrita, verificação e gravação atómica) corre numa thread própria (
bw-dw-export) com uma cópia partilhada do circuito: a interface não para. Só corre uma exportação de cada vez.
Nas propriedades de uma macro, Export as Digital Works macro… grava essa definição como macro do Digital Works: as tags são a interface e, num modelo DIL, os pinos seguem a ordem DIL. As macros que ela usa vão copiadas lá dentro. Ver Macros e hierarquia.
Na janela Memory Contents, Save… é um menu com bitwerk map (text)… e Digital Works map (binary)… (palavras de 16 bits, número mágico 0xABCD). O conteúdo das memórias também vai dentro do .dwm. Ver Memória.
No fim abre a janela Digital Works export: nome, caminho, versão do formato, tamanho em bytes e tempo; o que foi escrito (contagens por tipo e quantas cópias de macros foram embutidas, de quantas definições); e as notas agrupadas em Dropped (o Digital Works não as consegue representar), Warnings e Approximations, com o número de ocorrências. Copy as text copia tudo. Se a exportação falhar, a janela mostra o erro e nada é escrito.
| bitwerk | No Digital Works |
|---|---|
| Porta com mais de 4 entradas | Árvore de portas de 2 a 4 entradas |
| XOR/XNOR com mais de 2 entradas | Cadeia de portas de 2 entradas |
| D por flanco descendente ou master-slave | D com um NOT no relógio |
| JK ou RS por flanco | D com portas de próximo estado |
| RS master-slave | Latch RS + D |
| Latch D ou RS | Biestável RS do Digital Works com portas (preset/clear também com portas) |
| RAM com dados de entrada e de saída em redes diferentes | Buffers tri-state ativos durante a escrita (os pinos de dados do Digital Works são bidirecionais) |
| Junção com n ligações | Cadeia de n − 2 soldas de três fios (como nos ficheiros reais) |
| Item | O que acontece |
|---|---|
| Modo de simulação | O Digital Works propaga sempre como o modo Sequencial e não tem o nível X; um projeto em atraso unitário perde esse timing. Ver Simulação. |
| Velocidade dos relógios | Não está no .dwm (é uma opção global do Digital Works). |
| Formato das saídas numéricas | Não é guardado: o Digital Works mostra um algarismo por linha de entrada. |
| Botões de pressão | Passam a interruptores normais. |
| Nomes dos pinos das macros | Não são guardados: as tags mostram o número do pino. |
| Texto do datasheet e link de documentação | Perdem-se; só o caminho do ficheiro de datasheet sobrevive. |
| Rotação de flip-flops, interruptores, relógios, geradores, VCC/massa, LEDs e 7 segmentos | O Digital Works desenha-os sempre sem rotação: ficam com o símbolo dele, com os pinos sobre os nossos sempre que possível (senão um stub de fio liga-os). |
| Texto com várias linhas | Dividido num texto por linha. |
| Carateres fora do Windows-1252 | Passam a ? (aviso no relatório). |
| Partilha de definições de macros | O Digital Works não partilha definições: cada instância leva uma cópia. |
Uma hierarquia que, copiada instância a instância, passe os 2 milhões de objetos (o limite do leitor) é recusada com erro, sem escrever nada.
| Peça | Função |
|---|---|
export.rs |
Constrói o grafo de objetos do Digital Works a partir do modelo (o inverso de convert.rs). Coordenadas × 5 em float32. Portas, NOT, tri-state, memórias, saídas numéricas, tags e macros levam um desenho do nosso símbolo já rodado, com os contornos dos pinos exatamente sobre os nossos pinos. Os fios passam a polilinhas entre pinos e soldas. Cada instância de macro passa a um TMacro com a cópia da definição, com os TMacroPin exteriores ligados aos das tags. |
writer.rs |
Escreve o grafo com os mesmos programas de campos por classe que o leitor (reader.rs): o leitor e o escritor não podem divergir. Objetos em profundidade a partir da raiz, inteiros na forma mais pequena, strings em Windows-1252, cabeçalho igual ao do Digital Works 3.x. Pilha explícita (sem recursão) e todos os limites do leitor verificados, por isso o que o escritor produz o leitor aceita. |
mod.rs |
export_project, export_circuit, export_macro e o ExportReport. Antes de entregar os bytes, volta a lê-los com o leitor: nunca sai um ficheiro que o próprio bitwerk recusaria. |
memmap.rs |
save_dw_path: .map binário do Digital Works, gravado de forma atómica. |
bw-app/src/dwexport.rs |
Diálogos, thread bw-dw-export, janela do relatório e --export-dwm. |
Os detalhes do formato usados pelo escritor (cabeçalho, fios de comprimento zero, contornos dos pinos, dispositivos sem desenho guardado, saídas numéricas) estão na secção 12 de docs/dwm/DWM-FORMAT.md.
| Teste | Resultado |
|---|---|
Reescrever os 503 ficheiros do pacote oficial (495 .dwm, 8 .dwt) com o writer
|
Byte a byte iguais |
Corpus completo (whole_corpus_round_trips_through_export, com BITWERK_DWM_CORPUS) |
495/495 importam, exportam e voltam a importar com os mesmos componentes e redes; 495/495 voltam a exportar byte a byte iguais; 437/437 macros exportam como macros com a mesma interface |
bw-io/tests/dwm_export.rs |
As 13 fixtures e os 5 exemplos voltam a importar com a mesma estrutura; 120 circuitos aleatórios (todos os tipos, rotações, macros DIL) exportam sem falhar; o teste de carga de 20 mil componentes exporta; exportar de novo um circuito que já passou pelo Digital Works dá o mesmo ficheiro byte a byte; o parser Python independente tools/dwm_parse.py lê todas as exportações (se houver python3) |
bw-sim/tests/dwm_export.rs e dwm.rs
|
Simulação lado a lado, original e exportado/reimportado, com as mesmas mudanças de interruptores: fixtures (XOR com NAND, igualdade de 4 bits, JK master-slave com portas, contador 1…14, 74HC00/74/76/125 como macros), exemplos, cada tipo de componente em cada rotação (todas as variantes de flip-flop, RAM, ROM, portas de 2 a 8 entradas), 80 circuitos aleatórios com macros aninhadas e macros aleatórias exportadas como macros |
.map binário |
O mapa oficial low1.map é reescrito byte a byte igual |
Fuzzing (roundtrip_dwm) |
Ver Segurança |
O Micro 5.dwm (408 mil objetos) exporta em ≈125 ms. Ver Desempenho.
- Os ficheiros nunca foram abertos no Digital Works real. A confiança vem da ida e volta com o importador, do parser Python independente e da comparação estrutural com os ficheiros reais (mesmas classes, campos, valores típicos e invariantes: soldas com três fios, contornos de pinos 8 × 8, cabeçalho igual).
- O maior risco identificado são as saídas numéricas: o formato de apresentação não existe no ficheiro e o desenho segue o dos 13 exemplos do pacote.
- O alvo de fuzzing
roundtrip_dwmfoi compilado (make fuzz-check), mas não há registo de uma sessão longa de fuzzing. - Como o Digital Works copia as macros para cada instância, hierarquias grandes dão ficheiros grandes (e podem passar o limite de 2 milhões de objetos).
Ver também Limitações e roadmap.
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