Skip to content

Exportacao para o Digital Works

PedroVMota edited this page Nov 13, 2026 · 1 revision

Exportação 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.

Como usar

Um circuito

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

Uma macro

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.

Uma memória

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.

Relatório

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.

O que se perde ou é aproximado

Reconstruído com outras peças (mesmo comportamento)

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)

Perdido ou alterado

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.

Como funciona (crates/bw-io/src/dwm/)

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.

Testes e resultados

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.

Confiança e limitações

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

Clone this wiki locally