x16-emulator
Ordinateur néo-rétro inspiré du Commodore 64, le Commander X16 est émulé par x16-emulator, un projet open source de Michael Steil disponible en Release 48 pour macOS 10.15 ou ultérieur.
x16-emulator est un émulateur open-source dédié au Commander X16, un ordinateur néo-rétro inspiré du Commodore 64 mais doté d’architecture moderne. Il reproduit fidèlement son matériel, incluant le processeur 65C02/65C816, la carte graphique VERA (avec sprites et effets raster), le son (PCM, PSG, YM2151), et des périphériques comme la carte SD, le clavier, et les ports joystick. L’émulation est quasi-cycle-exacte, garantissant une compatibilité optimale avec les logiciels conçus pour la plateforme.
Disponible pour macOS 10.15 et versions ultérieures, il dépend de SDL2 pour son fonctionnement. Bien que les binaires officiels ne ciblent pas explicitement Apple Silicon, il peut fonctionner sur ces architectures via SDL2 natif. Une ROM compatible (rom.bin) est requise pour démarrer l’émulateur, disponible dans les releases ou compilable depuis le dépôt source. L’outil s’adresse aux développeurs, collectionneurs et passionnés souhaitant explorer ce système rétro-moderniste.
Dernière mise à jour :
Plateformes
Architecture
Mac OS X - macOS
Apple Silicon
64 bits
SDL Library
Téléchargement et liens
- Télécharger x16-emulator
- Site officiel
- Code source 295 étoiles sur GitHub
- Licence : BSD-2-Clause
Historique des versions
49
- Ajout du support pour un système -gs avec 24 bits d’adressage RAM et un processeur 65C816, en prévision du X16 GS.
- Correction des comportements incorrects des sprites 8bpp avec un décalage de palette non nul dans VERA.
- Implémentation de la commande READ_MULTIPLE_BLOCK pour les cartes SD, et optimisation de MACPTR dans HostFS.
- Correction du bruit du PSG VERA (fréquence doublée par rapport au matériel) et gestion améliorée des registres write-only/read-only.
- Support MIDI série via FluidSynth, avec exclusion du threading dans la build Web pour éviter les conflits.
- Débuggeur amélioré avec prise en charge du système GS et gestion des breakpoints (F9).
- Passage à C11 avec corrections de syntaxe et de headers, et corrections des instructions MVN/MVP du 65C816.
- Builds macOS Intel requièrent macOS 15 (Sequoia) ou supérieur, ARM/M1 requièrent macOS 14 (Sonoma) ou supérieur.
Version R49 ("Pyrite")
-
BUGS CONNUS
- Dans X16EDIT, appuyer sur Ctrl+F puis sur B ne compile pas le programme avec BASLOAD. Pour contourner ce bug, quittez X16EDIT pour revenir à BASIC et exécutez
BASLOAD "".
- Dans X16EDIT, appuyer sur Ctrl+F puis sur B ne compile pas le programme avec BASLOAD. Pour contourner ce bug, quittez X16EDIT pour revenir à BASIC et exécutez
-
Fonctionnalités/Corrections
- VERA : Ajout d'avertissements lors de la lecture en écriture seule et lors de l'écriture en lecture seule des registres [irmen]
- VERA : Rendre le temps d'occupation SPI plus fidèle au matériel
- VERA : Correction du comportement incorrect des sprites en 8 bpp lorsque le décalage de palette est non nul
- VERA PSG : Correction de la fréquence de bruit doublée par rapport au matériel
- CARTE SD : ajout du support de la commande READ_MULTIPLE_BLOCK [stople]
- VIA : Correction du traitement du drapeau IFR [catharinejm]
- Permet à l'émulateur de quitter avec Alt+F4 même si SDL ne le gère pas [JimmyDansbo]
- Libère uniquement le tampon de mémoire du presse-papiers lorsque celui-ci provient du gestionnaire de collage de SDL
- Ajout de l'émulation MIDI série via FluidSynth
- Exclusion du multithreading (nécessaire pour FluidSynth) dans la construction wasm
- Ajout du support pour
-gs, qui met en œuvre un système avec une RAM adressable sur 24 bits et un processeur 65C816, en anticipation du X16 GS prévu avec cette fonctionnalité. [Fulgen301] - Amélioration considérable des performances de l'implémentation HostFS de MACPTR
- Ajout des implémentations HostFS de XMACPTR et XMCIOUT pour refléter les implémentations CMDR-DOS
- Corrections de l'émulation du 65C816 pour MVN, MVP [Fulgen301, cnelson20]
- Passage de C99 à C11, quelques corrections de syntaxe et d'en-têtes [skeeto]
- Options supplémentaires pour l'émulateur web, incluant celles pour supporter le type et la vitesse du CPU [JimmyDansbo]
- Corrections du débogueur de l'émulateur, incluant le support pour GS, et l'appui sur F9 une deuxième fois pour effacer le point d'arrêt
- Plus de modifications dans le ROM.
En raison de la disponibilité des images GitHub runner, les versions compilées publiées ici peuvent ne pas fonctionner sur des versions du système d'exploitation antérieures à celles sur lesquelles elles ont été construites.
- La version macOS Intel est construite sous macOS 15 Sequoia (fonctionne sur macOS 15 ou versions ultérieures)
- La version macOS ARM/M1/Apple Silicon est construite sous macOS 14 Sonoma (fonctionne sur macOS 14 ou versions ultérieures)
- La version Linux x86_64 est construite sous Ubuntu 22.04 (fonctionne avec glibc 2.35 ou versions ultérieures)
Cependant, x16-emulator peut être compilé à partir des sources sur des versions antérieures du système d'exploitation.
48
- Ajout du support du débogage pour les banques ROM 13 à 15 (utilisées par x16edit et Basload).
- Correction du calcul des adresses indirectes relatives pour le processeur 65C816 (problème de page directe).
- Mise à jour du débogueur pour afficher le temps CPU écoulé depuis le dernier point d'arrêt ou pas.
- Prise en compte de l’inversion du rapport cyclique (pulse width) pour les ondes saw et triangle du VERA PSG (comportement conforme à la version matérielle 47.0.2).
- Correction des lectures de débogage depuis la pile et des valeurs non bornées dans l’affichage du débogueur.
Version R48 ("Cadmium")
- Fonctionnalités/corrections
- La horloge SPI émulée VERA a été mise à jour pour fonctionner à la moitié de la vitesse de la horloge VERA au lieu de celle du CPU.
- Le débogage pour les banques ROM 13-15 (x16edit et Basload) est désormais pris en charge [stefan-b-jakobsson]
- Corrections des lectures de débogage depuis la pile et de quelques valeurs non bornées dans l'affichage du débogueur
- VERA PSG : pour les ondes en dents de scie et triangulaires, l'inverse de la valeur de largeur d'impulsion est XORée avec la valeur de l'onde. Il s'agit du comportement de la VERA 47.0.2 sur matériel. [m00dawg]
- Permet de définir la quantité de RAM dans la version web de l'émulateur [JimmyDansbo]
- Windows 11 : les coins arrondis ne doivent plus couper la partie inférieure gauche et inférieure droite de la fenêtre de l'émulateur.
- Nouvelle fonctionnalité de statistiques de mémoire [irmen]
- HostFS : implémentation de la commande DOS "T"ell
- Le débogueur inclut désormais le nombre de cycles CPU écoulés depuis le dernier point d'arrêt ou l'étape.
- 65C816 : correction du calcul d'adresse indirecte relative à la pile utilisant à tort la page directe [Fulgen301]
- 65C816 : les octets hauts de .X et .Y sont maintenant effacés lorsque PLP ou RTI avec x=1 [cnelson20]
- 65C816 : PEI ne fait plus de dépassement de page incorrect, les modes indirects
[dp]lisent maintenant correctement l'adresse. [Fulgen301] - Plus de modifications dans le ROM.
Release 48
Aucun détail pour cette version.
47
- Ajout du support du CPU 65C816, activable via la nouvelle option -c816 (et -c02 pour forcer le mode 65C02).
- Correction de la détection de la signature "MIST" KERNAL relocalisée à 0xC008 dans le ROM R47.
- Build natif pour Apple Silicon (M1/M2/M3), compilé sur le runner macOS ARM de GitHub.
- Correction d’un bug dans VPOKE en BASIC : les expressions de pointeurs dans le troisième argument écrivaient à l’adresse VRAM erronée.
- Flexibilité accrue pour l’adressage des périphériques IEC, évitant que HostFS ne monopolise tous les numéros de périphérique.
- Ajout de l’option -hostfsdev pour configurer un numéro de périphérique non standard pour HostFS, compatible avec -sdcard.
Version 47 ("Roswell")
Il s'agit d'une version majeure avec de nombreuses corrections de bugs, ainsi que l'ajout du support pour le 65C816. * Bugs connus
* Dans le BASIC, les expressions de pointeurs dans le troisième argument de VPOKE entraînent une écriture à l'adresse de VRAM incorrecte. Par exemple : VPOKE 1,$B000,PEEK($400). La solution de contournement consiste à utiliser une affectation de variable, telle que N=PEEK($400):VPOKE 1,$B000,N. - Corrigé dans la branche git master. * Fonctionnalités/Corrections.
* Il est possible d'émuler optionnellement un processeur 65C816, sélectionnable via un nouveau commutateur en ligne de commande `-c816`. Il existe également un commutateur en ligne de commande `-c02` pour sélectionner explicitement le mode 65C02.
* Afin de libérer de la place pour la table complète des vecteurs 65C816, le ROM R47 déplace la signature "MIST" du noyau de l'adresse 0xFFF6 à 0xC008. L'émulateur a été mis à jour pour vérifier la signature à la nouvelle adresse.
* La gestion des adresses des périphériques IEC est devenue plus flexible en empêchant le HostFS de consommer tous les numéros de périphérique.
* Les calculs de temporisation pour les opérations HostFS ont été améliorés afin de traduire le temps réel en cycles d'horloge CPU écoulés.
* Si HostFS est utilisé, le nombre par défaut de `-abufs` pour les tampons audio est de 32, sinon il est de 8. Cela devrait réduire les saccades audio pour les jeux qui chargent des ressources depuis le disque pendant que le son est en cours de lecture.
* HostFS peut être modifié pour répondre à un numéro de périphérique non par défaut. Nouvelle option en ligne de commande `-hostfsdev`. L'utilisation de cette option en combinaison avec `-sdcard` permet aux deux périphériques d'apparaître dans le système.
* En correspondance avec la fonctionnalité matérielle VERA, le bit de configuration de couche T256 peut être utilisé comme commutateur de palette en modes tuiles et bitmap. Cela est particulièrement utile en profondeur de 2 bits par pixel et 4 bits par pixel, en définissant ce bit sur la couche, la valeur haute résolue de l'index d'entrée de palette est forcée à 1. Par exemple, en mode 4 bits par pixel, un pixel de tuile avec un index 1, sur une tuile configurée avec un décalage de palette 6, résoudrait normalement à l'entrée de palette 0x61 (soit 97 en décimal), avoir ce bit de couche défini fera en sorte que ce pixel résolve à l'entrée de palette 0xE1 (soit 225 en décimal).
* En copiant le comportement matériel de VERA, l'IRQ de la ligne peut se produire dans la zone de balayage vertical non visible.
* HostFS : un nom de fichier vide retourne maintenant une erreur appropriée.
* IO2, la plage YM2151, est partiellement décodée sur le matériel. Le comportement de l'émulateur correspond désormais à cela, de sorte que le YM2151 est en miroir dans toute la plage $9F42-$9F5F.
* Nouveau commutateur en ligne de commande `-nokeyboardcapture` qui fait fonctionner le mode capture sans intercepter les touches au niveau du système d'exploitation telles que Alt+Tab.
Améliorations des avertissements -wuninit pour afficher l’opcode approprié et la localisation des accès non initialisés.
Reconnaissance du code de touche INTL1, présent sur certains claviers comme le pt-BR.
Mise à jour de la table des opcodes 65C02 pour gérer correctement les NOPs sur plusieurs octets et mettre à jour les comptes de cycles.
La sortie -trace a été mise à jour et améliorée, affichant les banques pour les adresses effectives. Ajout de listes pour les nouvelles banques.
Nouvelle option -longpwron pour reproduire le comportement de la longue pression du bouton d’alimentation SMC 47 au démarrage.
VERA FX : correction d’un bug de résolution d’adresse avec le remplissage de cache non aligné en 4bpp.
VERA : DC_VSTOP prenait effet une ligne de balayage trop tard.
SMC : mise à jour de la logique de l’indicateur d’activité. Le matériel était incorrectement documenté comme permettant 255 niveaux d’intensité PWM, alors qu’en réalité il fonctionne en tout ou rien.
VERA PSG : mise à jour de la table de volume du PSG depuis VERA 47.0.0. Avant cette modification, plusieurs valeurs de volume PSG à bas niveau donnaient le même niveau de sortie.
SDL2 : définition du nom de l’application en « Commander X16 Emulator », visible dans le mélangeur audio et dans la liste des applications exemptées de l’écran de veille sur les environnements de bureau Linux. Cela devrait être plus informatif que « My SDL application ».
Nouveau commutateur en ligne de commande -pastewarp qui déforme l’émulateur lors de la réception de données collées, que ce soit depuis le presse-papiers ou via l’option -bas.
HostFS : amélioration du parsing des chemins avec les syntaxes CMD et Unix, notamment pour les noms de chemins absolus. DOS "MD//:TEST" crée désormais le dossier dans la racine du système de fichiers au lieu de l’erreurusement dans le répertoire courant.
VERA : les valeurs DC_HSCALE et DC_VSCALE supérieures à 0x80 s’affichent désormais comme sur le matériel.
Prise en charge native de SMC 47.0.0 pour la lecture rapide PS/2.
- Construction native pour Apple Silicon (construite sur le runner GitHub MacOS ARM)
- Plus de modifications dans le ROM.
46
- Correction du décalage des boutons des manettes via une mise à jour du ROM affectant la réponse du VIA aux requêtes de polling.
- HostFS : correction du comportement de UNLSN pour aligner le statut KERNAL sur celui de CMDR-DOS lors de l’ouverture de fichiers.
- HostFS : création automatique d’un fichier en mode Modify s’il n’existe pas encore.
- Empêchement de l’initialisation de la bibliothèque YM2151 invalide lorsque le son est désactivé via -sound none.
- Amélioration du traitement des fichiers ZIP sans manifest.json pour WebAssembly.
- Déplacement automatique de la fenêtre si la barre de titre est hors écran au lancement.
- Mode capture de souris : mouvement relatif et option -capture pour démarrer avec la souris capturée.
Version 46 ("Winnipeg")
Il s'agit principalement d'une sortie de correction de bugs.
- Fonctionnalités/Corrections
- Une modification dans la ROM a provoqué un décalage des boutons des manettes en raison de la manière dont le VIA émulé répond aux interrogations. Le problème a été corrigé dans la ROM et bien qu'il ne s'agisse pas techniquement d'un bug de l'émulateur et qu'aucune modification n'ait été apportée aux routines de la manette de l'émulateur, il est mentionné ici.
- HostFS : UNLSN définissait incorrectement l'octet de statut du KERNAL en fonction de l'existence d'un fichier lors de l'ouverture. Il a été modifié pour se comporter comme CMDR-DOS. (découvert par [voidstar78])
- HostFS : l'ouverture d'un fichier en mode Modification crée désormais correctement le fichier s'il n'existe pas encore (découvert par [m00dawg])
- Audio : empêche
-sound nonede tenter d'utiliser la bibliothèque YM2151 YM non initialisée. Le registre de statut YM a également été modifié pour toujours retourner 0 dans ce cas. (découvert par [jestin]) - WebAssembly : amélioration du traitement des fichiers zip sans
manifest.json[Cyber-Ex] - Interface graphique : si l'émulateur démarre dans une fenêtre dont la barre de titre est hors écran, la fenêtre est déplacée pour qu'elle soit visible. (avec l'aide de [irmen])
- Interface graphique : le mouvement de la souris utilise désormais un mouvement relatif en mode capture, ce qui rend la position de la souris hôte sans importance en mode capture.
- Interface graphique : nouvelle option de ligne de commande
-capturepour démarrer l'émulateur avec la souris capturée - Benchmark de test : corrections diverses [irmen]
- Plus de modifications dans la ROM.
45
- Ajout du support Intellimouse dans l'émulation du SMC, incluant la roulette (ID 3), sans gestion des boutons supplémentaires (ID 4).
- Réversion de la résolution d'amplitude du PSG VERA à 6 bits, conformément à une mise à jour ultérieure du firmware VERA.
- Nouveaux registres de débogage avec comportements modifiés pour le compteur d'horloge CPU et des messages utilisateur dans la console.
- Implémentation de MCIOUT (écriture bloc) pour HostFS, reproduisant une fonctionnalité du noyau pour les cartes SD.
- Ctrl+M/⇧⌘M désormais toujours traité pour basculer le mode capture (souris/clavier), indépendamment du flag "Disable Emulator Keys".
Version 45 ("Nuuk")
Il s'agit d'une version mineure concernant l'émulateur. La majorité des modifications concernent le ROM.
- Fonctionnalités/Corrections
- Retour à une résolution d'amplitude PSG de VERA en 6 bits. Elle avait été augmentée précédemment pour correspondre à la firmware de VERA. Elle a ensuite été réinitialisée dans VERA pour laisser de la place à la fonctionnalité FX. [akumanatt]
- Ajout du support pour la souris Intellimouse dans le SMC émulé, implémentant partiellement la nouvelle fonctionnalité de la firmware SMC matériel 45.1.0. [stefan-b-jakobsson]
- La roulette de défilement est supportée (ID de périphérique souris 3)
- Non implémenté : Boutons supplémentaires (ID de périphérique souris 4)
- Nouveaux comportements des registres de débogage de l'émulateur
- La lecture des adresses $9FB8-$9FBB dans cet ordre retourne le compteur d'horloge CPU 32 bits, capturé au moment où $9FB8 est lu. Précédemment, le compteur d'horloge continuait de progresser et les bits supérieurs du compteur pouvaient déborder de manière imprévisible.
- L'écriture vers $9FB8-$9FBB a de nouveaux comportements :
- $9FB8 : réinitialise le compteur d'horloge CPU à 0.
- $9FB9 : affiche un message de débogage dans la console
User debug 1: $xx. - $9FBA : affiche un message de débogage dans la console
User debug 2: $xx. - $9FBB : affiche la représentation UTF-8 du caractère ISO dans la console. Cela peut être traité comme une sortie de débogage STDOUT.
- Avant d'utiliser l'un de ces registres de débogage de l'émulateur, il est recommandé de tester la présence de l'émulateur en premier.
- Lire depuis
$9FBEet$9FBF. Lorsque l'on exécute sous l'émulateur, les valeurs retournées doivent être$31et$36respectivement. Si d'autres valeurs sont retournées, on peut généralement supposer que l'on exécute sur du matériel réel. Bien que la machine de série ne dispose d'aucun périphérique I/O écoutant la plage I/O de l'émulateur, une carte d'extension pourrait choisir d'utiliser la même plage d'adresses à l'avenir pour ses propres fonctions.
- Lire depuis
- Nouvelle implémentation MCIOUT (écriture par blocs) pour HostFS, reflétant la fonctionnalité du noyau pour une utilisation sur carte SD.
- Nouveau comportement de la touche commande et de la capture :
- Ctrl+M/⇧⌘M est toujours traité par l'émulateur pour basculer (capture souris/clavier), indépendamment de l'état du drapeau "Désactiver les touches de l'émulateur".
- Activer le mode capture désactive toutes les autres touches de l'émulateur jusqu'à ce que le mode capture soit désactivé. Pendant la capture, l'émulateur redirige la plupart des combinaisons de touches raccourcis du système vers le X16 : par exemple, Alt+Tab.
44
- Ajout de l'émulation FX pour VERA, incluant la boucle PCM FIFO via des écritures spécifiques sur VERA_AUDIO_CTRL.
- Correction du comportement VPB (Vector Page Break) pour le BRK et une meilleure fidélité matérielle.
- Support de clés supplémentaires (NumLock, Menu) et amélioration du débogueur pour les points d'arrêt.
- Nouveaux paramètres CLI : -fullscreen, -opacity, et suppression de -geos.
- Remplacement du noyau audio YM2151 (MAME → ymfm) avec gestion des IRQs via -enable-ym2151-irq.
- Correction de la caselessness partielle des noms de fichiers (dans OPEN et commandes sans /).
- Ajout de screenshots (Ctrl+P/⌘P) et de la navigation CD (CD:←) pour les répertoires.
Release 44 ("Milan")
This is the third release of x16-emulator by the X16Community team
- Features/Fixes
- Many changes to HostFS, including
- Fix regression for loading "
:*" from HostFS while also using an SD card image - Fix
-prgand-sdcardoptions working together, which did not properly handle the case after emulator reset - Proper wildcard behavior in dir filters and OPEN string
- Fix filetype directory filter command parsing
- Add
$=Llong mode directory listing to emulate the new feature in the ROM. - Speed up directory filetype filter
- Add CMD/SD2IEC style directory navigation:
CD:←to enter parent directory - Partial emulation of case-insensitivity in filenames on case-sensitive host filesystems.
- This works in
OPENstrings and directory names in commands (CD:, etc.) which do not contain a/character. - It also works on the last path segment in relative or absolute paths in directory names or
OPENstrings. In other words, if given a path specification containing one or more/characters, it will do only a case-insensitive search on the part after the final/.
- This works in
- Proper translation between UTF-8 filenames and their ISO representations.
- Fix regression for loading "
- Implement VPB behavior to match hardware [akumanatt]
- Fix BRK to have VPB behavior
- Support for additional keycodes (NumLock, Menu) [stefan-b-jakobsson]
- Fix debugger to set the correct bank for breakpoints [gaekwad]
- New
-fullscreenCLI option - Proper cleanup when the emulator exits when in full screen [irmen]
- FX emulation, which mirrors the features in the FX enhancement to the VERA firmware. See the VERA FX Reference for details.
- Writing bit 6 and bit 7 together into VERA_AUDIO_CTRL now enables looping the PCM FIFO (and does not reset the FIFO). Any other write into VERA_AUDIO_CTRL disables looping.
- New
-opacityCLI option for window transparency [tstibor] - New support for screenshots (Ctrl+P/⌘P) [dressupgeekout]
- Fix small memory leak caused by pasting into the emulator
- Use relative mouse motion while in grabbed mode
- Remove
-geosCLI option [dressupgeekout] - New YM2151 audio core: remove old MAME core, replace with ymfm
- Allows for IRQs from the YM, requires specifying
-enable-ym2151-irqon the command line
- Allows for IRQs from the YM, requires specifying
- Emulate hardware open bus behavior when reading from a device that doesn't exist in the
$9Fxxspace - Reset via I2C command: defer machine reset to the main loop, which allows the I2C write routine to return cleanly.
- Fix 65C02
BITimmediate behavior [XarkLabs] - New NMI trigger emulator hotkey, emulates Ctrl+Alt+Restore on hardware (Ctrl+Backspace/⌘Delete) [XarkLabs]
- Fix line artifact in application icon/logo
- Grabbing the mouse with (Ctrl+M/⇧⌘M) now grabs the keyboard as well. It allows the emulator to receive keystrokes and key combinations which would otherwise be intercepted by the operating system.
- Fix description of fill value in
makecart - New features implemented in the ROM
- Many changes to HostFS, including
- Build
- Link-time optimization is now enabled by default
- Portability enhancements [dressupgeekout]
- Suppress clang warnings due to deprecated sprintf usage in ymfm lib [XarkLabs]
43
- Modification majeure obligatoire : le protocole clavier entre l’émulateur et le ROM nécessite une mise à jour simultanée vers la version R43 des deux composants.
- Nouveautés fonctionnelles : ajout du paramètre -mhz pour choisir une vitesse CPU autre que 8 MHz et support du mode 240p en NTSC/RGB pour VERA.
- Améliorations du débogueur : affichage correct du banc en mémoire dans la disassemblage et prise en charge des breakpoints spécifiques à un banc.
- Corrections techniques : gestion des événements SDL par frame pour éviter un mouvement de souris saccadé et optimisation des lectures HostFS via conversion temps réel en cycles 6502.
- Fix macOS : corrections de build spécifiques pour macOS.
Release 43 ("Stockholm")
This is the second release of x16-emulator by the X16Community team
- BREAKING CHANGE
- The keyboard protocol between the emulated SMC and the KERNAL has changed, thus x16-emulator version R43 requires x16-rom version R43.
- This change also affects how the custom keyboard handler vector works (keyhdl). For details, see Chapter 2 of the Programmer's Reference Guide
- Your Keyboard will not work unless you are running
- R43 of both x16-rom and x16-emulator
- Features
- Updates to support translation from SDL scancodes to new keynum encoding supported by KERNAL [stefan-b-jakobsson]
- More granular support for RAM amount as argument to
-ram - Minor HostFS bugfixes and enhancements, including tying the activity light to HostFS activity.
- VERA updates: new support for 240p in NTSC/RGB modes. Chroma disable only works on NTSC.
- Stepping the debugger now supports stepping over
WAI - Debugger now shows the correct bank in the disassembly by default. [gaekwad]
- Debugger breakpoints are now bank-specific [gaekwad]
- Randomized RAM is now the default. New option:
-zeroram[irmen] - Host's mouse cursor is now shown unless either the KERNAL mouse is enabled or the mouse cursor is captured (Ctrl+M/⇧⌘M).
- Esc key is now Esc rather than STOP. Pause key sends STOP. (Ctrl+C is also recognized by the KERNAL as STOP)
- SD card emulation now responds to CMD9
- Emulated SMC can now assert NMI.
- Add
-mhzoption to select a speed other than 8 - When built with
TRACE, the-traceoutput now shows the effective address for indirect and indexed opcodes and VERA data0/data1 reads and writes. - New comamnd line option
-midline-effectsthat supports mid-line changes to the palette or tile/sprite data. R42 always had this behavior, which results in performance degradation for programs write to VERA heavily if the host CPU is not fast enough. This behavior is now disabled by default.-midline-effectsrestores this optional behavior. - New features implemented in the ROM
- Other
- Release builds have link-time optimization enabled which seems to help performance.
- Add git hash of build to
-versionstring. - WebAssembly enhancements in the supporting html/js [Cyber-EX]
- Fixed potential off-by one row with non-zero DC_VSTART.
- Prevent laggy hostfs reads from causing the emulator to warp to catch up by translating the wall clock time to elapsed 6502 clocks. This effectively makes HostFS MACPTR behave like a DMA card, including the possibility that it prevents the CPU from executing instructions while interrupt sources may have been waiting for service.
- Bugfix: Process multiple SDL events per frame. (Fixed choppy mouse movement if there were keystrokes in the keyboard buffer)
- Audio resampling and ring buffer fixes [DragWx]
- Build fixes on Mac
KNOWN BUGS
In release R43, due to improper parsing of escape tokens, REN will improperly treat arguments to these statements as line numbers:
FRAMERECTMOUSECOLORPSGWAV
42
- Ajout du mode testbench pour le débogage matériel et de l’option -noemucmdkeys pour désactiver les touches de commande de l’émulateur.
- Support des ROM cartridges via les options -cart et -cartbin, avec un utilitaire makecart pour générer des fichiers .crt.
- Prise en charge des images de cartes SD compressées et amélioration du système de fichiers hôte avec des options -fsroot et -startin.
- Mode mouse grab activable par ⇧⌘M (Mac) pour capturer la souris, et correction de la détection du bouton central.
- Amélioration de l’audio (équilibrage VERA/YM2151) et synchronisation des interruptions VERA avec le matériel (ISR à VSYNC/LINE/SPRCOL).
- Compatibilité avec le Proto 4 (déplacement de la broche IRQ du VIA1) et ajustements des effets raster de VERA pour coller au timing réel.
This is the first release of x16-emulator by the X16Community team
- Features
- Added testbench mode [stefan-b-jakobsson, indigodarkwolf]
- Added
-noemucmdkeysoption [jestin] - New
FIFO_EMPTYflag inPCM_CTRLto reflect new VERA feature [ZeroByteOrg] - Added
-widescreenoption to simulate stretched 640x480 output at a 16:9 aspect ratio [jestin] - New
SCANLINEVERA register behavior to reflect updated VERA feature [mooinglemur] - Added
-randramand-wuninitcommand line arguments to randomize RAM at boot, and to emit a console warning when uninitialized RAM is read, respectively. [stefan-b-jakobsson] - Allow specifying non-power-of-2 argument to
-ram, in increments of 8k [JimmyDansbo] - Added
-via2option to selectively enable a VIA at $9F10. [akumanatt] - Added ROM cart loading with
-cartand-cartbin[indigodarkwolf] - New
makecartutility for building.crtcartridge files [indigodarkwolf] - Compressed SD card image support [indigodarkwolf]
- Mouse grab mode, press Ctrl+M (Mac: ⇧⌘M) to toggle. [mooinglemur]
- New
-fsrootand-startinoptions to specify the root of the emulated host fs, and the host directory to start in respectively. [mooinglemur] - Many, many new features implemented in the ROM
- Other
- PS/2 devices now connected via SMC via I2C, I2C pins have moved to match hardware [stefan-b-jakobsson]
- Recognize middle mouse button [ZeroByteOrg]
- Synchronized keymaps with ROM [megagrump]
- Build fixes [irmen]
- Show dialog when a
STPinstruction is encountered with debug turned off [akumanatt] - Improved emulated behavior of
WAI[LRFLEW] - Clear D flag on interrupt entry [LRFLEW]
- Update BRK length in debugger [indigodarkwolf]
- IRQ/NMI entry clock cycles are now accounted for [mooinglemur]
- Add reason string to memory dump output [irmen]
- Clear sprite line buffer when disabling sprite layer [jestin]
- Improved audio balance between VERA and YM2151. Much improved mixing routines to reduce stutters and clicking. [akumanatt]
- To match hardware, VERA ISR bits are set at VSYNC, LINE, and SPRCOL regardless of whether their respective IEN bits are set [mooinglemur]
- Changes to match Proto 4, including moving VIA1 interrupt pin to IRQ [akumanatt]
- VERA mid-frame raster effects more closely match the timing of real hardware [mooinglemur]
- Enabled and built out CI/CD build workflows [maxgerhardt, indigodarkwolf, mooinglemur]
- Many host fs enhancements, bringing host fs very close to feature parity with SD card images [davidgiven, ZeroByteOrg, mooinglemur]
- Many documentation updates and fixes [veganaize, irmen, tomxp411]
Release 48
- Correction du calcul de la fréquence SPI de la VERA, désormais basée sur la vitesse du bus VERA et non du CPU.
- Ajout du support du débogage pour les banques ROM 13-15 (utilisées par x16edit et Basload).
- Correction des lectures de débogage dans la pile et de valeurs non bornées dans l’affichage du débogueur.
- Prise en charge de la configuration de la RAM dans la version web de l’émulateur.
- Correction du calcul des adresses indirectes relatives pour le CPU 65C816 (mode direct page et indirect).
- Nettoyage des octets hauts de .X et .Y lors de l’exécution de PLP ou RTI avec x=1 pour le 65C816.
Release 48
- Features/Fixes
- Emulated VERA SPI clock has been updated to half of the VERA clock speed rather than the CPU clock.
- Trace for ROM banks 13-15 (x16edit and Basload) is now supported [stefan-b-jakobsson]
- Fixed debug reads from the stack and a few unbounded values in the debugger display
- VERA PSG: for the saw and triangle waves, the inverse of the pulse width value is XORed with the value of the wave. This is the behavior of VERA 47.0.2 on hardware. [m00dawg]
- Allow setting the amount of RAM in the web version of the emulator [JimmyDansbo]
- Windows 11: Rounded corners should no longer cut off the lower left and lower right of the emulator window.
- New memory statistics feature [irmen]
- HostFS: Implement DOS "T"ell command
- Debugger now includes elapsed cpu clocks since the last breakpoint or step
- 65C816: Fixed stack relative indirect address calulation wrongly using the direct page [Fulgen301]
- 65C816: high bytes of .X and .Y are now cleared when PLP or RTI set x=1 [cnelson20]
- 65C816: PEI no longer does improper page wraparound,
[dp]indirect modes now properly read the address. [Fulgen301] - More changes in the ROM.
Release 47
This is a major release with numerous bugfixes, as well as introducing 65C816 support.
- Known bugs
- in BASIC, pointer expressions in the third argument of
VPOKEwill cause the system to write to the wrong VRAM address. For example:VPOKE 1,$B000,PEEK($400). The workaround is to use a variable assignment, such asN=PEEK($400):VPOKE 1,$B000,N. - Fixed in git master.
- in BASIC, pointer expressions in the third argument of
- Features/Fixes.
- Optionally emulate a 65C816 CPU, selectable via a new command line switch
-c816. There is also a-c02command line switch to explicitly select 65C02 mode. [Fulgen301] - In order to make room for the full 65C816 vector table, the R47 ROM relocates the "MIST" KERNAL signature from 0xFFF6 to 0xC008. Emulator has been updated to check for the signature in the newer location. [Fulgen301]
- Made IEC device addressing more flexible by preventing the HostFS from consuming every device number [DragWx]
- Improved timing calculations for HostFS operations to translate wall clock time to elapsed CPU ticks
- If HostFS is in use, the default
-abufsaudio buffer count is 32, otherwise 8. This should reduce audio stuttering for games which load assets from disk while sound is playing. - HostFS can be changed to respond to a non-default device number. New command line option
-hostfsdev. Using this option in conjunction with-sdcardallows both devices to appear on the system. - Matching the VERA hardware feature, the layer config T256 bit can be used as a palette switch in tile and bitmap modes. Most useful in 2bpp and 4bpp depths, setting this bit on the layer forces the resolved high bit of the palette entry index to 1. For instance, in 4bpp mode, a tile pixel with index 1, on a tile configured with palette offset 6 would normally resolve to palette entry 0x61 (or 97 decimal), having this layer bit set will cause this pixel to resolve to palette entry 0xE1 (or 225 decmial).
- Copying VERA hardware behavior, the LINE IRQ can happen in the non-visible vertical blanking area.
- HostFS: empty filename now returns an error as appropriate
- IO2, the YM2151 range, is partially decoded on hardware. Emulator behavior now matches this so that the YM2151 is mirrored throughout the $9F42-$9F5F range.
- New command line switch
-nokeyboardcapturecauses capture mode to operate without intercepting OS-level keystrokes such as Alt+Tab. - Improvements to
-wuninitwarnings to show the appropriate opcode and location of uninitialized accesses. - Recognize the INTL1 key code, which exists on some keyboard layouts such as pt-BR.
- Update the 65C02 opcode table to properly handle multi-byte NOPs and update cycle counts.
-traceoutput has been updated and enhanced, showing banks for effective addresses. Add listings for new banks.- new
-longpwronoption to match SMC 47 long power button press behavior at power on. - VERA FX: fix address resolution bug with 4bpp unaligned cache filling.
- VERA: DC_VSTOP was taking effect one scanline too late.
- SMC: update activity light logic. Hardware was mistakenly documented as allowing 255 PWM intensity levels, while in fact it is binary on/off.
- VERA PSG: update PSG volume table from VERA 47.0.0. Prior to this change, there were multiple PSG volume values at the low end that resulted in the same output level.
- SDL2: Set the application name to "Commander X16 Emulator", which shows up in the audio mixer, and in the screensaver inhibit application list on Linux desktop environments. This should be a bit more informative than "My SDL application".
- New
-pastewarpcommand line switch that warps the emulator when receiving paste data either from the clipboard or from the-bascommand line switch. - HostFS: improve path parsing with both CMD and unix path syntax, particularly with absolute path names. DOS"MD//:TEST" now creates the directory in the FS root rather than erroneously in the current directory.
- VERA: DC_HSCALE and DC_VSCALE values > 0x80 now render as they do on hardware.
- SMC 47.0.0 fast PS/2 read support
- Now with native build for Apple Silicon (built on the GitHub MacOS ARM runner)
- More changes in the ROM.
- Optionally emulate a 65C816 CPU, selectable via a new command line switch
Release 46
This is mainly a bugfix release.
- Features/Fixes
- A change in the ROM caused controllers to have their buttons offset due to how the emulated VIA responds to polling. The issue was fixed in the ROM and while it was not technically an emulator bug and no changes were made to the emulator's joystick routines, it gets a mention here.
- HostFS: UNLSN was incorrectly setting the KERNAL status byte based on whether a file existed upon open. It has been changed to behave like CMDR-DOS. (discovered by [voidstar78])
- HostFS: Opening a file in Modify mode now properly creates file if it doesn't yet exist (discovered by [m00dawg])
- Audio: prevent
-sound nonefrom trying to use the uninitialized ymfm YM2151 library. The YM status register was also modified to always return 0 in this case. (discovered by [jestin]) - WebAssembly: improve handling of zip files without
manifest.json[Cyber-Ex] - GUI: If emulator launches in a window with the titlebar offscreen, move the window so that it is visible. (with help from [irmen])
- GUI: Mouse movement now uses relative motion in capture mode, which makes the position of the host mouse irrelevant while in capture mode.
- GUI: new
-capturecommand line option to start emulator with mouse captured - Testbench: miscellaneous fixes [irmen]
- More changes in the ROM.
Réagir sur le forum
Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.