TKZX - emulador TK90X / ZX Spectrum =================================== Alterações deste fork. O histórico do JSSpeccy 3 original está mais abaixo. A partir da 1.0.0 cada entrada traz a versão: o número do meio sobe a cada recurso novo, o do fim a cada correção. Em desenvolvimento (branch zx-spectrum-next): ZX Spectrum Next -------------------------------------------------------------- * (Esta entrada ganha o número da versão quando o Next for juntado ao main.) * Nova máquina "ZX Spectrum Next (JNEXT)" no quadro Máquina (ou `machine=next` no link). O Next é emulado pelo JNEXT, de Jorge Gonzalez (GPL-3.0, https://github.com/jorgegv/jnext), escrito a partir do código VHDL do FPGA do Next: Z80N, memória de 2 MB, Layer 2, sprites, tilemap, Copper, DMA, TurboSound e os NextREG. A versão para navegador do JNEXT fica em static/next/, com a licença, os créditos e o ORIGEM.txt, e só é baixada quando o Next é escolhido * Sistema "Só programas (.NEX)", o padrão: abre arquivos .NEX por "Abrir arquivo…", arrastando ou pelo link, sem cartão SD nem ROM do Next. Sistema "NextZXOS" (`nextos=1`): o visitante baixa a distribuição oficial (sn-emulator-26.11a.zip) de specnext.com e a escolhe na tela do Next, porque o specnext.com não deixa o JNEXT baixá-la direto (CORS); o JNEXT monta o cartão SD no navegador do visitante; o TKZX não traz nenhuma parte do NextZXOS. A ajuda tem o link do arquivo * Com o Next na tela, o emulador do TK90X / Spectrum fica parado e os controles que são só dele (disco, editor BASIC, snapshot, ULAplus) ficam escondidos; voltando para outra máquina, tudo volta * O mapeamento de teclas funciona no Next: a tecla do PC mapeada vira a tecla do Spectrum escolhida, enviada ao canvas do JNEXT como um evento de tecla (do mesmo jeito que o teclado de tela do JNEXT faz). Os alvos Kempston vão para um controle de videogame virtual que a página mostra ao JNEXT, porque o JNEXT para navegador só lê o joystick dos controles de videogame; o lado do TK90X ignora esse controle virtual. Testado no NextZXOS (X mapeado para Enter abre o Browser) e com um .NEX de teste que liga o joystick 1 em Kempston e mostra a porta 31: direita 1, esquerda 2, baixo 4, cima 8, fogo 16, e as combinações * Testado no navegador: uma demo de Copper e um teste de Layer 2 em 256 cores rodam certinho, e a troca TK90X → Next → TK90X funciona. Jogos que leem ou gravam no cartão (o Celeste, por exemplo) precisam do NextZXOS. Com a distribuição 26.11a o NextZXOS 2.10a inicia por completo: tela de boas-vindas, menu e o Browser com o cartão SD * Velocidade da emulação do Next, de 10% a 1000%, num deslizador como o do TK90X (no quadro Máquina, ou `nextspeed` no link), que muda na hora, sem reiniciar o Next. O JNEXT oficial só lê a velocidade quando a máquina liga, então o TKZX passa a usar o JNEXT 1.3.47 compilado por nós com uma alteração pequena (static/next/tkzx.patch): jnext_web_set_speed() no C++ e player.setSpeed() / getSpeed() no JavaScript. O ORIGEM.txt explica a alteração e como compilar. Testado: 400%, 25%, 1000% e de volta a 100% com o mesmo player, e o JNEXT confirmou 5, 81, 2 e 20 ms por quadro * Barra embaixo da tela do Next, como a do TK90X: power (player.reset(): o programa aberto começa de novo, ou o NextZXOS dá a partida de novo), pausa / continuar (player.pause() / resume()) e a figura do teclado do Next, como a do TK90X: as 58 teclas no arranjo do Spectrum+, com o comando, o símbolo e as funções do modo E de cada tecla, as cores e os gráficos dos números, e nas teclas extras (TRUE VIDEO, DELETE, EXTEND MODE, ";", setas...) a combinação que elas fazem. O "Salvar snapshot" fica escondido no Next. Testado: a pausa para o contador de quadros e o continuar o retoma, a figura do teclado abre e fecha com Esc, e o power reinicia o programa, mesmo com o Next pausado * Gravador físico no Next, com os mesmos recursos do TK90X (medidor, correção da velocidade do gravador, blocos padrão refeitos limpos, lista de blocos, .TAP / .TZX / .WAV, abrir .WAV): o botão Gravador aparece no Next só com o lado físico. Os pulsos limpos vão para uma fita ao vivo acrescentada ao JNEXT no mesmo tkzx.patch (src/core/live_tape.h, lida pelo EAR como as fitas TAP, TZX e WAV; player.liveTape no JavaScript), alimentada pelo mesmo LiveTape do TK90X, que mantém o Next cerca de 0,15 a 0,3 s à frente. Com ele ligado, a velocidade do Next fica em 100%. Testado com um bloco de cabeçalho padrão tocado na entrada de som e um .NEX que conta as bordas do EAR: 8368 bordas das 8370 do bloco, e o bloco aparece na lista * Botão "Gravar som" no gravador: grava todo o som que o Next toca até um novo clique (o SAVE que não chega a um gravador de verdade, como o do emulador de ZX81 do Next). static/audiotap.js anota os nós de áudio ligados às caixas de som e, durante a gravação, escuta só os do JNEXT (o AudioContext do SDL3), em float 32 bits, sem perder amostras. O som entra no gravador como um .WAV aberto: vai inteiro para o "Baixar .WAV" (PCM 16 bits, até uma hora, arquivo som_do_Next.wav) e os blocos aparecem na lista. Testado com um .NEX que toca um tom no beeper: 6 s gravados, 1321,3 Hz para os 1321,25 Hz do programa, todas as meias ondas com 16 ou 17 amostras, sem buracos * O rodapé credita o JNEXT * JNEXT atualizado de 1.3.47 para 1.3.52 (tag v1.3.52), que corrige os comandos "dot" na versão para navegador: com eles, o Browser do NextZXOS volta a abrir arquivos de texto e programas .NEX. O tkzx.patch aplicou sem nenhum ajuste; o ORIGEM.txt traz os novos hashes. A 1.3.52 ainda não tem o pacote para navegador publicado na página de releases do JNEXT, então LICENSE, CREDITS.md, README.txt e licenses/ vieram do pacote que o próprio "make package-web" monta (iguais aos do pacote v1.3.47, menos o número da versão no README.txt) * A ajuda do Next foi atualizada: explica a barra (power, pausa, teclado), a velocidade, o gravador físico e o "Gravar som" (inclusive para o SAVE do emulador de ZX81 do Next), e diz que só disco, editor BASIC, snapshot e ULAplus ficam escondidos. Testado pelo usuário: o SAVE do emulador de ZX81 do Next, gravado pelo "Gravar som", foi convertido para .P * Snapshot no Next: um botão na barra salva o estado do Next num .jns (player.saveSnapshot() do JNEXT), o único formato que guarda o Next inteiro (NextREGs, Layer 2, sprites, Copper). Só o JNEXT abre .jns, e ele precisa do NextZXOS ligado. Com o NextZXOS, o Next abre snapshots .jns, .sna, .szx e .z80 (por "Abrir arquivo…", arrastando ou pelo link); sem cartão SD, o JNEXT só roda .NEX, e abrir um snapshot mostra um aviso para escolher o NextZXOS. Testado: um .jns de uma demo de Copper tirado sem cartão e outro tirado com o NextZXOS voltam ao ponto salvo, e um .szx de um 48K abre no Next * Cartão SD guardado: com o NextZXOS, o que se grava no cartão (saves, recordes, arquivos, configurações) fica no navegador do visitante (IndexedDB, a opção keepWrites do JNEXT) e está lá na próxima visita; o botão da lixeira na barra apaga tudo e reinicia (player.resetCard()). Testado: desligar a tela de boas-vindas do NextZXOS (tecla D) continua valendo depois de recarregar a página, e a lixeira a traz de volta * Imagem do cartão SD: com o NextZXOS, um botão na barra baixa o cartão do Next como está (cartao-sd-next.img, 40 MB: imagem de disco com MBR e FAT32, o cartão que o JNEXT montou com o que foi gravado nele por cima), para gravar num cartão de verdade (balenaEtcher, Win32 Disk Imager) ou abrir no 7-Zip e copiar os arquivos. É o cartão mínimo do JNEXT: firmware, MACHINES, NEXTZXOS, SYS e DOT, sem os jogos e aplicativos da distribuição completa. Testado: a imagem baixada passa no fsck.vfat, e a gravação feita no Next (desligar a tela de boas-vindas troca o autoexec.1st pelo welcome.bas) está nela. Não testado num Next de verdade * Pôr arquivos no cartão: com o NextZXOS, "Pôr arquivos…" e "Pôr uma pasta…" (no quadro Máquina) copiam arquivos do PC para o cartão SD do Next, na pasta escolhida (/ é a raiz; pastas que não existem são criadas), e o Next reinicia para o NextZXOS ler o cartão de novo; um arquivo que já existe só é substituído se o usuário confirmar. A cópia usa o sdcard::add_to_image() do próprio JNEXT (o do --sdcard-file-add, com o FatFs, a mesma biblioteca do firmware do Next), exposto à página por uma função nova no tkzx.patch (jnext_web_card_add), e fica guardada com as outras gravações do cartão. Foi escolhido no lugar de carregar uma imagem de cartão inteira, que o navegador precisaria ter toda na memória (um cartão de 1 GB ocupou cerca de 3 GB). Testado: um .nex e um .tap na raiz e uma pasta com dois .nex em /TKZX chegaram idênticos ao original (conferido na imagem baixada, que passa no fsck.vfat), continuam lá depois de recarregar a página, aparecem no Browser do NextZXOS, e o Celeste abriu por ele * Correção: um arquivo aberto com o NextZXOS escolhido, mas antes do clique que liga o Next, não era carregado; agora o Next liga com ele. Um snapshot dado ao JNEXT na partida também é carregado quando a máquina fica pronta (o JNEXT, sozinho, dá a partida no NextZXOS e o ignora) 1.3.0 - 2026-11-22: Gravar som ------------------------------ * Botão "Gravar som" no gravador (ao lado de "Gravador físico"): grava todo o som que a máquina toca até um novo clique, para guardar no PC o SAVE (ou qualquer som) como .WAV. O som entra no gravador como um .WAV aberto: vai inteiro para o "Baixar .WAV" (PCM 16 bits, mono, sem compressão, na taxa da placa de som, até uma hora; arquivo som_do_TK90X.wav, ou com o nome do programa quando há um cabeçalho) e os blocos encontrados aparecem na lista, os fora do padrão só no .TZX * static/audiotap.js: anota os nós de áudio ligados às caixas de som e, só durante a gravação, escuta o que eles tocam, em float 32 bits, sem perder amostras. Começando a gravação com a máquina desligada, um aviso diz que o som entra quando ela for ligada * Testado: com o carregamento em tempo real, a carga de um .tap gravada pelo botão deu, na lista, o cabeçalho e os dados do programa, e o .TAP baixado da gravação é idêntico, byte a byte, ao original 1.2.1 - 2026-11-21: agradecimento a Mauricio Matte -------------------------------------------------- * O rodapé agradece a Mauricio Matte, que cedeu a ROM da interface MFDCspec, com link para o site dele (tmclassic.com.br) 1.2.0 - 2026-11-21: Interface MFDC ---------------------------------- * Nova interface de disco "Interface MFDC", a MFDCspec de Victor Trucco e Mauricio Matte (2025), no quadro de disco e pelo link (`beta=mfdc` ou `beta=mfdc128`). A ROM foi cedida por Mauricio Matte: é o CBI-DOS 2.4 com o logotipo da MFDCspec * Como a interface de verdade, tem os dois modos da chave 3: Beta 48 (o CBI-DOS, com os endereços da CBI: RANDOMIZE USR 15360 e 15363, e o mesmo hardware da CBI 95) e Beta 128 (o TR-DOS: RANDOMIZE USR 15616 e 15619). E a chave 2, de auto-inicialização, é a opção "Ligar direto no DOS do disco": ligada, a máquina já entra na tela da interface; desligada, entra no BASIC e o DOS fica a um RANDOMIZE USR de distância. No 128K a auto-inicialização fica desligada, como manda o manual * O núcleo ganhou duas páginas de memória para ROMs (a da MFDC e uma livre). Testado no TK90X: os dois modos, com e sem auto-inicialização, a entrada no DOS por RANDOMIZE USR 15360 e o boot pelo disco de utilitários da CBI-95; a CBI 95 e a IDS 91 continuam funcionando 1.1.0 - 2026-11-21: velocidade da emulação ------------------------------------------ * Barra "Velocidade" no quadro Máquina: no meio, 100% (a velocidade real da máquina); para a direita, mais rápido, até 5000% (50 vezes); para a esquerda, mais lento, até 10%. A escala é proporcional dos dois lados (cada passo multiplica), perto do meio a barra volta sozinha para 100%, e o botão ao lado (ou um duplo clique na barra) volta a 100%. Não reinicia a máquina * O som acompanha, como numa fita acelerada ou lenta: acima de 100% a máquina roda vários quadros a cada atualização da tela e o som de todos eles é juntado (sai mais rápido e agudo); abaixo de 100% os quadros vêm mais espaçados e cada um traz o som de um tempo maior (sai mais lento e grave), sem buracos. O buffer de som do núcleo passou de 1024 para 16384 amostras para caber os 10% * Se o computador não alcançar a velocidade pedida, a página mostra quanto ele alcança. Com o gravador físico ligado a velocidade fica em 100% (a fita de verdade toca em tempo real). O resumo do quadro Máquina mostra a velocidade quando ela não é 100% * Medido com o contador de quadros do TK90X: 10%, 50%, 100%, 300%, 1000% e 5000% (cerca de 4980%) batem com o pedido * Enquanto o emulador digita sozinho o LOAD "" (ao abrir uma fita no TK90X), a velocidade fica em 100% e depois volta à escolhida: acima de 100% cada tecla ficava apertada por muitos quadros e se repetia, e o LOAD "" saía errado; abaixo, a espera pelo boot da ROM ficava longa. A página avisa enquanto isso acontece 1.0.0 - 2026-11-21: nome TKZX e versão no cabeçalho --------------------------------------------------- * O emulador passa a se chamar TKZX - emulador TK90X / ZX Spectrum (no cabeçalho, no título da aba, no README e no texto que vai dentro dos .TZX lidos de fitas reais) * Versão própria do projeto, a partir da 1.0.0 (o estado de tudo o que está abaixo), no lugar da 3.2.0 herdada do JSSpeccy 3. O número fica no package.json e a compilação o coloca sozinha no cabeçalho, num selo que abre esta lista de mudanças 2026-11-21: Interfaces CBI 95 e IDS 91 --------------------------------------- * Nova interface de disco "Interface CBI 95", a brasileira do CBI (Centro Brasileiro de Informática), no quadro de disco e pelo link (`beta=95`). Usa o mesmo controlador e as mesmas portas da Beta e lê os mesmos discos .trd, com a ROM da CBI: o CBI-DOS 2.4, de Otto Frederico Pereira de Carvalho Filho (1991), com o CAT mostrando o espaço livre em bytes e outros comandos estendidos. A cópia da EPROM é a preservada por Eduardo Luccas * Funciona no TK90X, diferente da Beta 48 inglesa. Emulada conforme o apêndice F do manual: a ROM do DOS entra e sai pelo bit 7 da porta FFh (e não pelo endereço executado, como na Beta); a janela de 3C00 a 3CFF mostra sempre o DOS (RANDOMIZE USR 15360 entra no DOS, RANDOMIZE USR 15363: REM : comando usa o disco de dentro de um programa); a porta FCh desliga a E/S da interface (bit 7) ou até a janela (bit 6, para jogos incompatíveis). Ao ligar ou dar reset, a interface entra no CBI-DOS e roda o programa "boot" do disco, ou mostra A> * Testado no TK90X: liga no CBI-DOS V2.4 com o prompt A>, e o disco de utilitários da CBI-95 abre o seu menu * Nova interface "Interface IDS 91" (`beta=91`), a brasileira da Synchron: o mesmo hardware da CBI 95, com o seu próprio DOS (o βDOS, derivado do CBI-DOS). Testado no TK90X: liga no βDOS da Synchron com o prompt A>, o disco da IDS abre o menu da Synchron, e LOAD "jetpac" no A> carrega o Jetpac do disco * A opção "Ligar direto no TR-DOS" passou a se chamar "Ligar direto no DOS do disco", porque vale também para o CBI-DOS 2026-11-21: carga acelerada no modo instantâneo ------------------------------------------------ * Com a carga "Instantâneo", o que não dá para carregar na hora (blocos turbo, carregadores próprios, gravações diretas) tocava em velocidade normal. Agora, enquanto o jogo está lendo a fita nesses trechos, a máquina roda o mais rápido que o computador permitir: cada atualização da tela roda quantos quadros couberem (sem som) e mostra só o último. O jogo não percebe nada (a fita e a CPU andam juntas), e assim que ele para de ler a fita a máquina volta à velocidade normal. Num teste, um bloco de 3 min 36 s carregou 85 vezes mais rápido, em menos de 3 segundos * O gravador mostra "carga acelerada (N×)" enquanto isso acontece, e um aviso aparece na primeira vez em cada fita * Corrigido: com a carga instantânea, quando a ROM pedia um bloco e o próximo da fita era uma gravação direta (ou um bloco de pulsos soltos), o emulador pulava esse bloco e entregava o seguinte ao jogo, que dava erro. Agora a fita para nesse bloco e ele toca em tempo real (acelerado); depois a carga instantânea continua no bloco seguinte 2026-11-21: gravador físico entrega à máquina os blocos limpos --------------------------------------------------------------- * Com o gravador físico, a lista lia as fitas certinho, mas a máquina muitas vezes dava erro de carga: a ROM recebia o som cru, com limites fixos, e cada fita trazia um defeito diferente (sincronismo deformado, mergulhos rasos, gravador fora da velocidade, a última borda do bloco perdida no silêncio, tom guia com estalos). Agora os blocos no formato padrão chegam à máquina limpos: o emulador lê o som como a lista lê e refaz o tom guia, o sincronismo e cada bit com pulsos perfeitos, na velocidade da fita, cerca de 1 segundo depois da fita. A carga continua aparecendo ao vivo (listras na borda, tela de apresentação linha por linha) * O que não segue o formato da ROM (turbo e carregadores próprios, mesmo os que usam o tom guia padrão) vai para a máquina como o som chegou: o emulador mede os primeiros bits de cada bloco e só refaz o bloco se os dois tamanhos de bit forem os da ROM. Testado com blocos turbo de 0,8, 1,3, 1,5 e 2 vezes a velocidade: passam intactos * Testado com uma simulação da rotina de carga da ROM sobre as gravações do Savage, Blade Runner, Mask III e Green Beret: todos os blocos carregam. Antes, o Savage falhava no último byte de cada bloco e o Mask III errava bits nos blocos grandes 2026-11-21: carga instantânea para no fim da fita -------------------------------------------------- * Corrigido: com a carga instantânea, quando o jogo pedia um bloco que não está na fita (o lado B que faltou gravar, por exemplo), a fita dava voltas sem fim. O jogo recusava cada bloco e pedia de novo, e o gravador passava por todos os blocos sem parar (no After Burner, mais de 600 mil pedidos em 18 segundos). Agora, se o pedido vem logo depois de a fita chegar ao fim (menos de uns 2 segundos), ela fica no fim, como num gravador de verdade, e a máquina espera a fita. Se passou mais tempo (um LOAD "" novo, por exemplo), a fita continua voltando sozinha para o começo, como antes * Aviso na tela e no gravador quando isso acontece, dizendo o que o jogo pediu: "Fim da fita: o jogo pediu um bloco do tipo 230 de 8 bytes que não está nesta fita (talvez o outro lado). Abra a outra fita e dê Play." 2026-11-21: gravador físico corrige a velocidade do gravador ------------------------------------------------------------- * Corrigido: com um gravador fora da velocidade, a lista do gravador físico lia a fita certinho, mas a máquina dava erro de carga já no primeiro bloco. A ROM tem limites fixos para separar o bit 0 do bit 1; num gravador 9% rápido (comum em aparelhos sem ajuste), com a distorção da fita alguns bits 1 chegavam a poucos por cento desse limite, e a pequena correção de ritmo do emulador (até 1,5%) bastava para errar. Agora o emulador mede a velocidade no tom guia de cada bloco e a máquina recebe o som esticado (ou encolhido) para a velocidade certa, como se o gravador estivesse regulado. A máquina fica alguns segundos atrás da fita durante um bloco longo e recupera nos silêncios entre os blocos (cada silêncio fica com pelo menos 0,3 s). Testado com o Blade Runner gravado num gravador 9% rápido: todos os blocos carregam, mesmo com o relógio do emulador 1% mais rápido ou mais lento que o da placa de som * O gravador físico mostra a velocidade medida ("Velocidade do gravador: 9% rápido · corrigida"). Num .wav aberto, mostra a velocidade da gravação 2026-11-21: gravador físico abre .WAV e lê melhor fitas gastas ------------------------------------------------------------- * Botão "Abrir .WAV…" no gravador físico: lê a gravação de uma fita feita antes (pelo próprio gravador ou por outro programa) com o mesmo leitor da entrada de som, só que na hora (uma fita de 4 minutos leva cerca de 1 segundo). Os blocos aparecem na lista e dá para baixar o .TAP, o .TZX ou o .WAV de novo. Aceita .wav de 8, 16, 24 ou 32 bits (inteiro ou ponto flutuante), mono ou estéreo; no estéreo usa o canal mais alto, porque muitas vezes o sinal está só de um lado. Enquanto o arquivo estiver aberto, o som da entrada continua indo para a máquina, mas não entra na lista; "Limpar" fecha o arquivo e volta a ler a entrada * A ajuda "Como ligar o gravador" avisa para abaixar o volume quando aparecer "alto demais" (o som saturado dá erro de carga) e para desligar os aprimoramentos de áudio do Windows na entrada de som, que mexem no sinal da fita * O .wav também abre pelo botão "Abrir arquivo…" e arrastando o arquivo para a página: vai direto para o gravador físico, que se abre para mostrar os blocos. Não precisa de microfone nem de entrada de som: com o gravador físico desligado, a lista mostra os blocos do arquivo até "Limpar" * Corrigido: no gravador físico, um bloco padrão podia virar "Sinal fora do padrão" (e ficar de fora do .TAP) quando o segundo pulso de sincronismo chegava esticado. Nas fitas reais isso é comum: os filtros do gravador deslocam as bordas onde o tom muda do guia (pulsos longos) para o sincronismo (pulsos curtos). No Green Beret, o bloco principal de 47.618 bytes chegava com 392 + 1209 em vez de 667 + 735 e era descartado. Como a ROM, que não mede esse pulso, o leitor agora só recusa um pulso do tamanho do tom guia. O Green Beret sai com todos os blocos, iguais byte a byte aos de um .TAP lido por outro programa * Corrigido: em fitas gastas, a segunda metade de um bit 1 pode sair como um mergulho curto e raso do sinal. A máquina real ainda vê o sinal cruzar o zero, mas o leitor exigia que o sinal passasse de 25% do volume e perdia essa borda: dois meios pulsos viravam um só e o bloco era cortado ali (no Mask III, o bloco de 36.060 bytes parava nos 15.745 e o último bloco perdia um byte). Agora basta 12% do volume. Green Beret e Mask III saem com todos os blocos iguais aos de um .TAP lido por outro programa * Com isso o .TZX desse tipo de fita também passa a levar o bloco como bloco padrão, em vez de gravação direta (que a carga rápida pulava, entregando o bloco seguinte ao jogo e dando erro) 2026-11-20: contador de acessos e painel escondido -------------------------------------------------- * O servidor registra cada visita à página (data e hora, IP, país, jogo aberto por `?url=`, navegador e site de origem) em arquivos de texto por mês, em `dados/acessos-AAAA-MM.jsonl`, sem banco de dados. Os arquivos do emulador (`.js`, `.wasm`, ROMs) não contam, e os robôs ficam marcados. Atrás do Nginx Proxy Manager, o IP do visitante vem do cabeçalho `X-Real-IP`, que só é aceito quando a conexão vem da rede interna * Painel em `/painel?k=TOKEN` (senha em `PAINEL_TOKEN`, no `.env`): visitantes e acessos de hoje, 7 dias, 30 dias e total, gráfico por dia, países, jogos mais abertos, sites de origem, últimos 200 acessos e planilha CSV de cada mês. Sem token, ou com token errado, responde "Não encontrado". Tema claro e escuro, funciona no celular * País sem serviço externo: o servidor baixa sozinho, uma vez por mês, a base gratuita do DB-IP (CC BY 4.0) e a lê com um leitor próprio do formato .mmdb, sem dependências novas * Os registros mais velhos que `RETENCAO_MESES` (padrão 12) são apagados. Sem a pasta `dados` gravável, o site funciona normalmente e o log avisa que o contador está desligado * `docker-compose.yml`: nova pasta `./dados` montada em `/app/data`, a única gravável do container. Os comentários do arquivo explicam como criar a pasta (`chown 12334:12334`) e o `.env` 2026-11-20: gravador virtual sem lixeira nos blocos da fita ----------------------------------------------------------- * Corrigido: no gravador virtual, os blocos de uma fita aberta (do segundo em diante) mostravam o botão de lixeira, que só existe para os blocos lidos do gravador físico. Clicar nele tentava apagar um bloco da lista do gravador físico, e não da fita. Agora a lixeira aparece só com o gravador físico ligado 2026-11-20: editor BASIC: DEF FN --------------------------------- * Corrigido o DEF FN do editor de BASIC: a ROM guarda, logo depois de cada parâmetro (o x$ de DEF FN u$(x$)), um espaço escondido de 6 bytes onde o FN põe o valor do argumento, e o editor não criava esse espaço. Ao chamar a função, a ROM gravava o argumento por cima do resto da linha do DEF FN, que aparecia estragada no LIST (TRACE, UDG, Σ...) e dava erro. Agora o editor grava a linha como a máquina gravaria, e o verificador de sintaxe sabe pular esse espaço 2026-11-20: ULAplus (64 cores) ----------------------------- * Suporte ao ULAplus, o modo de 64 cores usado por jogos e demos novos (e versões coloridas de jogos antigos): porta 0xBF3B escolhe o registro e 0xFF3B grava ou lê a cor ou o modo. No modo de paleta, os bits FLASH e BRIGHT escolhem uma de 4 tabelas de 16 cores (8 de tinta, 8 de papel), nada pisca e a borda usa as cores de papel da primeira tabela. A porta 0xFF3B pode ser lida, então os programas descobrem sozinhos que o ULAplus existe. Funciona em todas as máquinas * Opção "ULAplus (64 cores)" no quadro Máquina, desligada por padrão: ligue para os jogos e demos que usam ULAplus. Desligada, as portas são como numa máquina comum (e um snapshot com a paleta abre com as cores normais). O navegador lembra a escolha * Os snapshots .szx levam e trazem a paleta (bloco PLTT), inclusive os salvos pelo botão "Salvar snapshot" * Limite: a paleta é aplicada à imagem inteira do quadro, como ela está no fim dele; demos que trocam as cores no meio da tela (efeitos de raster) aparecem só com as últimas cores. Ideia do PR #28 do JSSpeccy original 2026-11-20: controle de videogame (gamepad) ------------------------------------------ * Controles de videogame ligados no PC (USB ou Bluetooth: Xbox, PlayStation, genéricos) funcionam no emulador, com o mesmo mapeamento do joystick da tela (quadro "Controles na tela"): Kempston, Q A O P, Cursor, Sinclair ou teclas escolhidas. Direcional ou alavanca esquerda → direções; A, X e gatilhos da esquerda → botão 1; B, Y e gatilhos da direita → botão 2; Start → Enter. O quadro mostra o controle conectado. Um toque rápido fica apertado pelo menos 60 ms, para a ROM não perder a tecla entre duas leituras do teclado. Ideia do PR #35 do JSSpeccy original (fechado lá sem ser incorporado) 2026-11-20: continuar rodando em segundo plano ---------------------------------------------- * Opção "Continuar rodando em segundo plano" no quadro Máquina: com a aba escondida (outra aba, janela minimizada), o jogo e o som continuam. Os navegadores param a animação da página nas abas escondidas e deixam os relógios dela lentos (uma vez por segundo); com a opção ligada, quem marca o tempo dos quadros é o worker do emulador, que não sofre esse freio. Desligada (o padrão), a máquina fica parada até você voltar, como antes. O navegador lembra a escolha. Baseado no PR #41 do JSSpeccy original * Com o gravador físico ligado a máquina sempre continua em segundo plano, com a opção ligada ou não: uma carga em tempo real não pode parar no meio 2026-11-20: correções vindas do JSSpeccy original ------------------------------------------------- Três correções dos pedidos de alteração (PRs) pendentes no projeto original (gasman/jsspeccy3): * Som estéreo (PR #36): o canal direito apontava para a mesma memória do esquerdo, então o som do chip AY saía igual nos dois lados. Agora os canais A, B e C ficam separados como no 128K de verdade * Travamento (do PR #43): a cópia das amostras de som que sobram de um quadro usava um contador de 8 bits; com mais de 255 amostras sobrando, o contador dava a volta e o emulador ficava parado para sempre * Tempo da fita (do PR #43): a leitura da porta da ULA vê o nível da fita no fim da espera de memória contida, como na máquina de verdade, e não no começo. Faz diferença para carregadores e proteções que medem os pulsos bem no limite (segundo o autor do PR: Alcatraz, Rainbow Islands, Rescate Atlántida). Os 1335 testes do Z80 do projeto passam, e as fitas testadas em tempo real (Commando, H.E.R.O., uma fita do 128K) continuam carregando 2026-11-20: salvar snapshot (.szx) --------------------------------- * Botão "Salvar snapshot" (na barra de cima, no ícone de disquete da barra do emulador e no menu Arquivo): baixa o estado da máquina naquele instante (memória, registradores, borda, paginação do 128K e chip AY) num arquivo .szx com o nome do jogo aberto. Abrir esse arquivo continua o jogo do mesmo ponto, inclusive em outra aba ou outro dia; se a página estiver em outra máquina, ela troca sozinha. Funciona no TK90X, 48K, 128K e Pentagon (o TK90X é salvo como 48K: a ROM não vai no arquivo). O .szx é o formato do Spectaculator, e o Fuse e outros emuladores também abrem. Não guarda o disco do TR-DOS (se o TR-DOS estiver ativo, o emulador avisa) * O leitor de .szx passa a ler o bloco do chip AY e lê o indicador de HALT no byte certo (a mesma correção do branch `szx-halt`) * Corrigido o emulador travando de vez (imagem parada, sem responder) ao abrir um snapshot com a máquina já ligada: o snapshot põe o relógio da máquina para trás no meio da contagem de som, a conta das amostras de som do quadro ficava negativa e o quadro seguinte tentava copiar uns 4 bilhões de amostras. Podia acontecer com qualquer .szx, .z80 ou .sna, dependendo do instante em que o arquivo era aberto 2026-11-19: gravador físico: blocos longos, captura direta e .WAV ------------------------------------------------------------------ * Corrigido o erro de carga perto do fim dos blocos longos (jogos inteiros) lidos de uma fita real: o relógio da placa de som e a velocidade do emulador nunca batem exatamente, e a diferença ia comendo a folga de 0,15 s até faltar som no meio dos dados. A folga agora é de 0,4 s e a velocidade da fita acompanha a folga (no máximo 1,5% mais rápida ou mais lenta, bem menos do que os gravadores de verdade variam). Num teste com um bloco de 30 KB (3 minutos) e o emulador 0,3% fora do relógio, antes o bloco falhava no meio; agora chega inteiro, mesmo com a página engasgando 250 ms de vez em quando * As bordas do sinal são marcadas onde o som passa pelo zero, com fração de amostra, em vez de onde ele cruza o limiar do gatilho: a duração de cada meio pulso fica mais exata (o desvio caiu de ~80 para ~47 T-states num teste com bits turbo), o que importa para os carregadores turbo que medem meios pulsos * Captura direta do som da placa (MediaStreamTrackProcessor, no Chrome e no Edge), sem passar pelo Web Audio: o Web Audio toca no relógio da saída de som e, quando o relógio da entrada é um pouco diferente, corta ou repete pedacinhos do som da entrada. Numa fita real (Commando) isso cortava de 3 a 11 amostras do meio de alguns pulsos, em pontos espalhados pelo bloco de 48 KB: um só bastava para o erro de carga. Nos outros navegadores fica o Web Audio, rodando na taxa da entrada. O painel do gravador físico mostra a entrada de som em uso e qual dos dois caminhos está sendo usado ("captura direta" ou "Web Audio") * Cliques da fita (picos de uma ou duas amostras no meio de um pulso, de sujeira ou desgaste) não viram bordas: um filtro passa-baixa suave e a exigência de o sinal ficar uns 40 µs do outro lado, como a entrada EAR da máquina de verdade * Chiado antes ou entre os blocos não aparece mais como "Sinal fora do padrão": um trecho só conta se a maior parte dos pulsos cair em poucas durações (como num carregador de verdade) * "Baixar .WAV": o som da fita como chegou na placa de som (16 bits, os últimos 15 minutos), para guardar a fita ou para examinar uma fita que não carrega. "Limpar" apaga também o som gravado 2026-11-19: gravador físico: lixeira e .TZX ------------------------------------------- * Cada bloco lido da fita real tem uma lixeira, para tirar da lista o que foi lido sem querer antes de baixar o arquivo * "Baixar .TZX": guarda tudo o que foi lido, na ordem e com as pausas da fita. Os blocos no formato padrão vão como blocos normais (0x10); os trechos em outro formato (carregador turbo ou próprio) vão como gravação direta (bloco 0x15), exatamente como o som foi lido, e carregam de novo no emulador * Os trechos fora do padrão aparecem na lista como "Sinal fora do padrão", com a duração e o número de pulsos. Chiado entre os blocos e pedaços soltos de tom guia não viram trechos * O .TAP continua com os blocos no formato padrão; se houver trechos fora do padrão, o emulador avisa que eles ficam de fora * Leitura mais firme: o limiar de leitura fica acima do chiado entre os blocos (acompanha o pico dos últimos segundos) e uns poucos pulsos estranhos no meio do tom guia não fazem perder o bloco * A ajuda de como ligar o gravador fica recolhida, para sobrar espaço para a lista 2026-11-19: gravador físico (fita de verdade) --------------------------------------------- * Opção "Gravador físico" no gravador virtual: liga a entrada de som do PC (entrada de linha ou microfone) no EAR do emulador e a saída MIC do emulador nas caixas de som, para carregar e gravar com um gravador e uma fita de verdade * LOAD: o som passa por um filtro (tira o nível DC) e por um gatilho com histerese que acompanha o volume do sinal; cada borda vira um pulso na entrada da fita, em tempo real, com uma folga de 0,15 s para os pedaços de som chegarem sem buraco. A captura é feita numa AudioWorklet (thread de áudio), para não perder amostras quando a página está ocupada * SAVE: o bit MIC (porta FE, bit 3) vai para o som. Enquanto o gravador físico está ligado, o som guarda uma folga maior e não descarta nada, para a gravação não ter falhas, e o som da entrada não é tocado (o gravador pode devolver o que está gravando e fechar um laço) * Recuperar fitas: os blocos no formato padrão da ROM lidos da fita real (tom guia, sincronia e bits, acompanhando a velocidade do gravador) aparecem na lista, com tipo, nome, tamanho e soma de verificação, e podem ser baixados num .TAP * Medidor de nível e indicação de sinal ("sem sinal", "recebendo sinal", "alto demais"), para acertar o volume do gravador * Enquanto ele está ligado, o carregamento fica em tempo real e a fita virtual espera de lado; desligando, ela volta * Precisa de página https (ou localhost) e da permissão de microfone do navegador 2026-11-19: gravador virtual ---------------------------- * Novo gravador virtual (botão "Gravador" ao lado de "Ver teclado" e ícone de fita na barra do emulador; funciona também em tela cheia e no celular) * Mostra a estrutura da fita aberta (.tap ou .tzx), bloco a bloco: cabeçalhos com tipo (Programa, Código, Tela, matrizes), nome, linha de autostart, endereço de início e tamanho; blocos de dados com o tamanho; duração de cada bloco; e no .tzx os blocos turbo, tons, pausas, grupos, textos e as informações do arquivo (título, autor, ano...). Blocos com soma de verificação errada são marcados * Um clique num bloco leva a fita até o começo dele; botões de Play/Pause, voltar ao começo, bloco anterior, bloco seguinte e ejetar. O bloco atual fica destacado e acompanha a fita, inclusive no carregamento instantâneo * "Play e pause automáticos" (ligado de fábrica, a escolha fica guardada no navegador): o emulador percebe quando um carregador está lendo a fita (leituras seguidas da porta EAR contando no registrador B, como no Fuse) e dá play sozinho; quando o jogo para de ler a fita, ela pausa sozinha. Se nesse meio-tempo a fita já tinha entrado no bloco seguinte, ela volta ao começo dele, para o bloco ficar inteiro quando o jogo pedir. Ideal para jogos multiload. Um Pause dado à mão durante o carregamento é respeitado * Fitas .tzx: o bloco "pausa 0" agora para a fita (antes era ignorado), os blocos de gravação direta (0x15) agora tocam (antes travavam a fita) e o bloco 0x2A é reconhecido * Depois do fim da fita, Play volta ao começo (antes não tocava mais nada) 2026-11-19: ejetar fita e ordem dos botões ----------------------------------------- * Botão de ejetar a fita na barra do emulador, depois do botão da fita. Fica apagado quando não há fita; ejetada, a fita não volta a carregar depois de uma troca de máquina * Na barra do emulador, o botão de ligar/reiniciar agora vem antes do de abrir arquivo 2026-11-19: verificação de sintaxe do BASIC ------------------------------------------- * Antes de montar o programa, o editor confere a sintaxe de cada linha, do jeito que a máquina escolhida faria ao digitar a linha: comandos e seus parâmetros, contas, parênteses, aspas, texto contra número, nomes de variáveis (texto e matrizes têm nome de uma letra), FOR/NEXT, IF ... THEN, DEF FN, SAVE/LOAD com LINE, CODE, SCREEN$ e DATA * Cada erro mostra o número da linha do BASIC e a coluna, com uma explicação em português (ex.: "falta LET", "depois de THEN use GO TO", "o BASIC do Spectrum não tem ELSE"); um clique seleciona o ponto do erro no texto * Segue a máquina escolhida: nomes do TK90X (SOUND, GOTO, RAND...) no TK90X, PLAY e SPECTRUM só no 128K e no Pentagon, e avisa quando um comando é de outra máquina * Se o verificador reclamar de algo que está certo, dá para "executar mesmo assim" ou "baixar o .TAP mesmo assim" * Linhas com UDG ou TRACE do TK90X, e os comandos do Interface 1 (CAT, FORMAT, MOVE, ERASE, SAVE *), não são conferidos 2026-11-19: editor de BASIC e Assembly -------------------------------------- * Novo quadro "Editor BASIC / Assembly", abaixo do emulador, com as abas BASIC e Assembly Z80 * "Executar" (ou Ctrl+Enter) monta o programa, gera um .TAP e carrega no emulador como uma fita (instantâneo), em qualquer máquina. O texto continua no editor depois do reset * "Baixar .TAP" salva o programa no computador a qualquer momento; "Salvar texto" baixa o .bas ou o .asm * "Abrir…" carrega no editor um .bas, .txt ou .asm, ou o programa BASIC de um .tap (convertido de volta para texto). Arrastar um .bas, .txt ou .asm para a página também abre no editor * BASIC: comandos por extenso, em maiúsculas ou minúsculas, com os nomes do TK90X e do Spectrum (SOUND/BEEP, GOTO/GO TO, GOSUB/GO SUB, RAND/RANDOMIZE, CONT/CONTINUE), UDG e TRACE no TK90X, PLAY e SPECTRUM no 128K/Pentagon. Números guardados no formato de 5 bytes da ROM, BIN, REM, UDG (\A a \U) e blocos gráficos. Sem números de linha, o programa é numerado de 10 em 10 * Assembly Z80: todas as instruções (inclusive IX/IY, IXH/IXL e SLL), rótulos, ORG, EQU/=, DEFB/DB, DEFW/DW, DEFS/DS, DEFM/DM, END e ENTRY, expressões com $, hexadecimal ($FF, #FF, 0FFh), binário (%1010) e caracteres. O .TAP leva um carregador BASIC (CLEAR, LOAD "" CODE e RANDOMIZE USR) * Os erros aparecem com o número da linha; um clique leva até ela * Na primeira visita o quadro do editor vem recolhido; um clique no título abre * O texto digitado em campos da página (o editor e o campo de URL) não vai mais para o emulador enquanto ele roda 2026-11-19: painel de opções recolhível --------------------------------------- * Os quadros do painel de opções (Máquina, Disco (TR-DOS), Teclado e joystick, Controles na tela) recolhem e abrem com um clique no título, para a coluna não ficar comprida demais * Fechado, cada quadro mostra um resumo do que está escolhido (ex.: "TK90X · 60 Hz", "Beta 128", "mapeamento ligado"), que acompanha as mudanças, inclusive quando o emulador troca de máquina sozinho * O navegador lembra quais quadros ficaram abertos; na primeira visita, só "Máquina" vem aberto 2026-11-19: teclado da tela com todas as legendas ------------------------------------------------- * Cada tecla do teclado da tela (celular e tablet) mostra todas as legendas, como no teclado real: a letra ou o número, o comando (cursor K), o símbolo do SYMBOL SHIFT, a palavra do modo E em cima e a do modo E com SYMBOL SHIFT embaixo. Na linha dos números aparecem as cores, as funções do CAPS SHIFT (EDIT, setas, DELETE...) e os blocos do modo gráfico * As legendas seguem a máquina escolhida: TK90X (modo E em azul, cores em caixinhas, UDG, TRACE, SOUND, LPRINT, LLIST) ou ZX Spectrum (modo E em verde, £, ©, BEEP) * Botão "MODO E", que aperta CAPS SHIFT + SYMBOL SHIFT; um segundo toque sai do modo E, como na máquina real * Com CAPS SHIFT ou SYMBOL SHIFT preso, ou no modo E, só as legendas que a próxima tecla vai dar ficam acesas * Cabeçalho "Teclado" que recolhe e mostra as teclas; a escolha fica guardada no navegador * Em tela cheia, o teclado aparece igual, com todas as legendas, por cima da imagem; o cabeçalho recolhe as teclas quando for preciso ver a tela inteira * Em tela cheia, a imagem do emulador sobe para o espaço acima do joystick e do teclado, em vez de ficar por baixo deles, e se ajusta quando o teclado é recolhido ou escondido. Com o celular deitado, as teclas ficam mais baixas (com todas as legendas) para a imagem caber, e o joystick fica por cima da imagem, semitransparente, para ela não diminuir * Docker: o container passa a rodar com o usuário 12334:12334 (`user:` no docker-compose.yml) 2026-11-18: interfaces de disco Beta 48 e Beta 128 -------------------------------------------------- * Interfaces de disco Beta 128 e Beta 48 (TR-DOS 5.03), que podem ser ligadas ou desligadas em qualquer máquina no novo card "Disco (TR-DOS)" e pelo parâmetro `beta=128` / `beta=48` * Beta 128: o TR-DOS entra ao executar de 3D00 a 3DFF com a ROM do BASIC 48 ativa. Beta 48: de 3C00 a 3DFF, com qualquer ROM. A Beta 48 não funciona no TK90X (a ROM dele usa 3C00-3CFF), como no aparelho real, e a página avisa * Controlador de disquete WD1793 emulado no núcleo: Restore, Seek, Step, leitura e gravação de setores (um ou vários), Read Address, Read Track, Write Track e Force Interrupt, com pulso de índice e as regras do datasheet para começar a gravar * Quatro drives (A a D) com "Inserir…", "Novo" (disco formatado vazio), "Salvar" (baixa o disco como .trd) e "Ejetar". A página avisa antes de fechar se houver disco alterado sem salvar * Discos .trd, .scl e .fdi, por link, por arquivo, arrastando ou dentro de .zip, com detecção pelo conteúdo. Abrir um disco liga a Beta 128 (se a máquina não tiver interface), coloca o disco no drive A e dá boot no TR-DOS. Vários links vão para os drives A, B, C e D * Opção "Ligar direto no TR-DOS" (parâmetro `trdos=1`) para o TK90X e o 48K, como a chave de boot da interface * O Pentagon passa a ler e gravar discos com a Beta 128 embutida (antes só trocava a ROM) * Trocar de máquina mantém os discos nos drives, com o que foi gravado neles * Correção: na troca de ROM do 128K, a escolha feita pela porta 7FFD não desliga mais a ROM do TR-DOS enquanto ela está ativa * Correção: um arquivo aberto pelo "Abrir arquivo…" ou arrastado é lido na hora e fica guardado na memória. Antes, a troca de máquina lia o arquivo do PC de novo e dava "NotReadableError" se ele tivesse sido alterado, movido ou apagado JSSpeccy 3 (projeto original) ============================= 3.2 (2024-11-23) ---------------- * Add mappings from keyboard symbol keys to equivalent Spectrum keypresses (Andrew Forrest) * Add support for the Recreated ZX Spectrum's "game mode" (Andrew Forrest) * Add `keyboardEnabled` configuration option * Add `uiEnabled` configuration option * Add `loadSnapshotFromStruct` API endpoint * Add `onReady` API endpoint * Enable 'instant tape loading' option in sandbox mode * Make keyboard event listeners play better with other interactive elements on the page 3.1 (2021-08-26) ---------------- * Real-time tape loading, including turbo loaders (except for direct recording, CSW and generalized data TZX blocks) * Emulate floating bus behaviour * Fix typo in docs (`openURL` -> `openUrl`) 3.0.1 (2021-08-16) ------------------ * Fix relative jump instructions to not treat +0x7f as -0x81 (which broke the Protracker 3 player) 3.0 (2021-08-14) ---------------- Initial release of JSSpeccy 3. * Web Worker and WebAssembly emulation core * 48K, 128K, Pentagon emulaton * Accurate multicolour * AY and beeper audio * TAP, TZX, Z80, SNA, SZX, ZIP loading * Fullscreen mode * Browsing games from Internet Archive