Repository navigation
Memoria
| Parâmetro | Valores | Por omissão |
|---|---|---|
Linhas de endereço (addr_bits) |
4 … 14 (16 a 16 384 palavras) | 8 (256 palavras) |
Bits por palavra (data_bits) |
1, 2, 4, 8 ou 16 | 8 |
O diálogo original do Digital Works tem um seletor de 5 posições, que corresponde a estas larguras.
À esquerda, de cima para baixo:
- A0 … A(n−1) — endereço;
- só na RAM: D0 … D(d−1) (dados de entrada) e R/W̄;
- C̄S̄ (chip select, ativo a 0).
À direita: Q0 … Q(d−1), saídas tri-state (podem formar barramento).
Sem fio, C̄S̄ fica selecionado (0) e R/W̄ fica em leitura (1); assim uma ROM funciona sem fios de controlo.
| C̄S̄ | R/W̄ | Efeito |
|---|---|---|
| 1 | — | Saídas flutuantes (Z), nada é escrito. |
| 0 | 1 | Leitura: as saídas mostram a palavra no endereço (X se algum bit de endereço é desconhecido). |
| 0 | 0 (só RAM) | Escrita por nível (SRAM assíncrona): enquanto dura, a palavra segue os dados de entrada (bits X/Z guardados como 0). As saídas ficam flutuantes. |
| desconhecido | ou desconhecido | (C̄S̄ ou R/W̄ a X) Saídas X, nada é escrito. |
- Endereço desconhecido numa escrita: nada é escrito.
- Não há pino OE separado: R/W̄ faz também de OE (a saída só é ativada numa leitura selecionada).
- A ROM não tem D nem R/W̄ e está sempre em leitura quando selecionada.
- Não há pinos bidirecionais: para ligar a RAM a um barramento, liga-se Q ao barramento e o barramento a D.
- O conteúdo de projeto vive no modelo (
Circuit, partilhado copy-on-write) e é gravado no ficheiro. - As escritas da RAM durante a simulação mudam só o conteúdo vivo (um
Vec<u16>por instância no simulador, no máximo 32 KiB). - Stop repõe o conteúdo de projeto, e gravar o projeto não guarda o que a RAM escreveu durante a simulação.
- Editar uma célula na janela Memory Contents muda os dois.
- Ao recompilar depois de uma edição, o conteúdo vivo passa para a nova compilação.
Abre-se em Properties → Edit contents… (só no nível raiz, não dentro de uma macro) ou com --memory-window ID.
- Grelha virtualizada: só as linhas visíveis são desenhadas, por isso 16K palavras custam o mesmo que 16.
- Mostra o endereço (
$0000) e cada palavra em hexadecimal ou binário. - Editar: clicar numa célula; Enter grava e passa à seguinte, Esc ou clicar fora cancela. Um valor inválido ou mais largo do que a palavra é recusado com uma mensagem.
- Ao vivo: atualiza-se enquanto a simulação corre, por um canal próprio (no máximo a cada 100 ms e só quando o conteúdo muda); a indicação live/design diz a origem. Com a janela fechada, o custo é zero: o conteúdo das memórias nunca vai nos snapshots.
- Clear… pede confirmação ("Clear all memory contents?").
-
Load… e Save… usam ficheiros
.map. Save… é um menu com bitwerk map (text)… e Digital Works map (binary)…; os dois gravam de forma atómica. Um mapa maior do que a memória é truncado, um menor é completado com zeros e as palavras mais largas são cortadas à largura da memória. A janela diz o que aconteceu e que formato foi lido.
# bitwerk memory map (linhas começadas por # ou ; são comentários)
bitwerk-map 1 (identificador e versão; primeira linha útil)
width 8 (bits por palavra, 1..=16)
words 256 (número de palavras, 1..=16384)
0000: 3e 00 c3 10 ... (endereço: palavras, tudo em hexadecimal)
0010: ...
- Cada linha de dados começa pelo endereço da primeira palavra e dois pontos, seguidos de palavras em hexadecimal separadas por espaços.
- Os endereços têm de crescer (um salto deixa zeros); as palavras que faltam valem 0.
- O gravador escreve 16 palavras por linha.
- Limites do parser: 1 MiB por ficheiro, 4 KiB por linha, tokens com até 4 dígitos, valores dentro da largura, endereços dentro do tamanho, nada de dados antes do cabeçalho nem cabeçalhos repetidos.
O Load… lê também os .map binários do Digital Works, detetados pelo número mágico 0xABCD. São truncados ou completados com zeros como no original. Ver Importação do Digital Works.
Save… → Digital Works map (binary)… grava neste formato: número mágico 0xABCD e número de palavras (32 bits little-endian cada), seguidos de uma palavra de 32 bits por endereço (o Digital Works lê palavras de 16 bits). O mapa oficial de exemplo (low1.map) é reescrito byte a byte igual. O conteúdo das memórias também vai dentro de um .dwm exportado. Ver Exportação para o Digital Works.
O conteúdo vai na lista memories codificado de forma compacta (bw_core::memenc): palavras em hexadecimal, sequências iguais como valor*N e zeros finais omitidos (por exemplo "12 0*3 ab*3"). Uma ROM de 16K palavras quase vazia ocupa poucas dezenas de bytes. Ver Formato de ficheiros.
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