MartyPC

Émulateur 0.4.1

MartyPC 0.2.2 est un émulateur IBM PC écrit en Rust par dbalsom, distribué uniquement sous forme de code source et prévu pour fonctionner sur Mac Intel comme sur les modèles équipés d’une puce Apple.

MartyPC est un émulateur d’ordinateurs IBM PC compatibles, conçu pour reproduire fidèlement l’architecture matérielle des machines anciennes, notamment autour du processeur Intel 8088. Développé en Rust, il cible principalement les développeurs et passionnés de rétro-informatique, offrant des outils avancés de débogage et de traçage cycle par cycle pour analyser ou tester du code pour l’Intel 8088.

Distribué uniquement sous forme de code source, il fonctionne sur macOS Intel et Apple Silicon, à condition de le compiler localement. Son approche rigoureuse, validée par des tests matériels (comme un Arduino connecté à un vrai 8088), garantit une précision élevée, avec un taux de fidélité proche de 100 % pour l’émulation CPU. Bien que moins accessible aux utilisateurs occasionnels, il se distingue par sa capacité à exécuter des démos techniques exigeantes, comme 8088 MPH.

The Secret of Monkey Island dans Marty

Dernière mise à jour :

Plateformes

Architecture

Mac OS X - macOS Mac OS X - macOS Intel x86 Intel x86 Apple Silicon Apple Silicon 64 bits 64 bits

Aucun binaire n’est distribué ici. Le code source est disponible : ce logiciel s’obtient en le compilant, ou par installation hors App Store.

Téléchargement et liens

Historique des versions

0.4.1
  • Ajout du mode d'émulation 8080 pour le processeur V20, avec un test limité et des retours demandés.
  • Correction de la définition des ROMs IBM et ajout d’un champ repeat pour les BIOS 1982 5160.
  • Fix de la mise à jour de la fenêtre CPU Status lors des pauses ou étapes manuelles.
  • Correction du comportement du bit de désactivation du curseur VGA (référence Ferraro inversée).
  • Amélioration de la détection des géométries de disques durs pour le contrôleur Xebec.

MartyPC 0.4.1

Il s'agit principalement d'une mise à jour de correction de bugs, bien qu'une nouvelle fonctionnalité soit incluse : le mode d'émulation 8080 de la V20 est désormais pris en charge. Cela n'a pas été testé aussi rigoureusement que je l'aurais souhaité, donc signalez tout problème que vous pourriez rencontrer.

Corrections et améliorations de l'interface utilisateur

  • Ajout de la fonctionnalité de flag ROM personnalisée pour faciliter le chargement des extensions ROM personnalisées.
  • Suppression du fichier de définition ROM IBM défectueux.
  • Ajout du champ « repeat » aux définitions ROM et modification des définitions ROM IBM pour l'utiliser – corrige les BIOS 5160 de 1982.
  • Correction de la mise à jour de la fenêtre d'état du processeur lors d'une pause ou d'un pas à pas.
  • Correction du vidage de la PIQ sur le processeur V20.
  • Ajout du flag « Mode » à la fenêtre d'état du processeur lors de l'utilisation d'un processeur V20.
  • Correction de l'option --machinescan.
  • Amélioration de la fonction de génération de noms de fichiers uniques – évite un comportement O(n) à mesure que la liste des fichiers grandit (maintenant O(log N), O(1) avec indice).

Corrections et améliorations du noyau

  • Prise en charge préliminaire du mode d'émulation 8080 de la V20.
  • Correction du bit de désactivation du curseur VGA (la référence Ferraro avait l'inverse).
  • Correction du support du contrôleur sous Windows 7.
  • Ajout de géométries supplémentaires de disques durs pour le contrôleur Xebec.
0.4.0
  • Ajout d’un système sonore complet avec support des cartes AdLib (OPL2), SN76489 (3 voix) et Disney Sound Source pour les jeux compatibles.
  • Prise en charge de nouveaux formats d’images de disquettes (TD0, IMD, PSI, TC, PRI, MFM, HFE, 86f, MFI, SCP, RAW) et montage dynamique de fichiers ZIP en disquettes.
  • Émulation du contrôleur VGA (modes 13h et ModeX/Y) et amélioration de l’émulation vidéo pour PCjr et TGA, incluant le mode 2bpp (ColorPaint).
  • Ajout de contrôleurs de disque dur XT-IDE (Rev 2) et jr-IDE pour le support LBA et mémoire étendue, avec compatibilité bidirectionnelle avec les VHD de 86Box.
  • Interface utilisateur redessinée avec dialogues natifs (ouverture/enregistrement de fichiers) et gestion améliorée des entrées (souris, clavier, joysticks).

0.4.0 (2025-05-11)

Cette mise à jour apporte une longue liste de nouvelles fonctionnalités, voici un résumé rapide :

  • Nouveau système sonore et périphériques sonores incluant Adlib, Disney Sound Source et SN76489 à trois voix
  • Nouvelle bibliothèque d'images de disquettes permettant de nombreux nouveaux types d'images de disquettes et le support de plusieurs protections anti-copie
  • Nouveau frontend supportant à la fois les versions natives et WASM, avec support des boîtes de dialogue de fichiers natives
  • Émulation de périphériques ATA, supportée par les dispositifs XT-IDE et jr-IDE pour un support de disques durs plus importants
  • Support VGA et amélioration de l'émulation vidéo PCjr et TGA
  • Édition de la mémoire et des registres

Nouveau frontend eframe

Certains changements dans les API de dépendances m’ont poussé à changer les frameworks de fenêtres. Le frontend Bureau actif pour MartyPC est désormais basé sur une version personnalisée d’un fork d’eframe.

Boîtes de dialogue de fichiers natives

  • La crate RFD permet d’accéder aux boîtes de dialogue de fichiers natives pour votre système d’exploitation particulier, incluant les boîtes de dialogue « Ouvrir un fichier » et « Enregistrer un fichier ».
  • Les erreurs de démarrage sont désormais signalées via une boîte de message système. Vous n’aurez plus à dépendre de la sortie en ligne de commande pour savoir pourquoi MartyPC n’a pas démarré.

Nouveaux périphériques

  • VGA

    • La carte VGA IBM est enfin émulée. La VGA de MartyPC est basée sur son implémentation EGA, avec les modifications et ajouts appropriés. Cadencée à 28 MHz, la VGA est un périphérique coûteux à exécuter à un taux précis au niveau de la horloge de caractères, vous pourriez avoir besoin d’un ordinateur rapide. Les modes 13h et ModeX/Y sont supportés (le « ModeY » de Wolfenstein 3D fonctionne !).
    • La fenêtre de débogage de la carte vidéo affichera l’état des registres VGA, incluant la palette actuelle en temps réel.
  • Contrôleur de disque dur XTIDE

    • Un périphérique XTIDE Rev 2 peut désormais être émulé. Puisque ce BIOS est open-source, une configuration de machine incluant le support de disque dur est désormais la configuration par défaut : ibm5160_xtide.
    • Si vous souhaitez une expérience « authentique rétro », le contrôleur IBM/Xebec reste disponible sous la forme habituelle ibm5160_hdd.
    • Le créateur de VHD a été mis à jour pour supporter la large sélection de géométries de disques durs courantes que le XTIDE peut supporter. Vous devrez exécuter une machine avec le XTIDE configuré pour les voir.
    • Il est désormais possible de prendre un fichier VHD depuis 86Box (en supposant que vous l’ayez créé comme un VHD « fixe ») et de l’utiliser dans MartyPC (et inversement !).

Contrôleur de disque dur jr-IDE

Pour accompagner le XTIDE, il est désormais possible d'émuler le jr-IDE. Cela permet de supporter les disques durs ATA avec prise en charge LBA et de fournir 736 Ko de mémoire conventionnelle pour le PCjr.

Carte musicale Adlib

Le premier périphérique audio de MartyPC, en plus du haut-parleur PC, est la carte musicale Adlib. L'émulation OPL2 est assurée par la bibliothèque hautement précise nuked-opl3.

SN76489

Le circuit sonore à trois voix présent dans l'IBM PCjr et le Tandy 1000 sera automatiquement installé sur ces machines.

Source sonore Disney

Si vous spécifiez un adaptateur parallèle, vous pouvez y attacher une Source sonore Disney et profiter de divers sons numérisés et criards dans les jeux qui la supportent (principalement des titres Disney, Wolf 3D, Prince of Persia et quelques autres. Consultez Mobygames pour une liste des titres supportés).

Cartes d'expansion mémoire

Les cartes d'expansion mémoire conventionnelle peuvent désormais être spécifiées, à n'importe quelle adresse et avec n'importe quelle capacité. Il est possible d'avoir des régions mémoire non contiguës si vous le souhaitez, mais à vos risques et périls.

Une surcouche pour l'IBM PCjr appelée pcjr_memory_sidecar fournira une mémoire supplémentaire de 512 Ko pour porter la mémoire du PCjr à 640 Ko.

Émulation d'images de disque au niveau bitstream

L'inclusion de la bibliothèque d'images de disque fluxfox a grandement étendu la prise en charge des images de disquettes de MartyPC et permis de supporter plusieurs schémas de protection par copie.

Prise en charge des images de disque

Fluxfox supporte la lecture d'une large gamme de formats d'images de disque :

  • TD0 (TeleDisk)
  • IMD (ImageDisk)
  • PSI (PCE Sector Image)
  • TC (TransCopy Image)
  • PRI (PCE Bitstream Image)
  • MFM (HxC/MFM Bitstream Image)
  • HFE (v1) (HxC Bitstream Image)
  • 86f (86Box Disk Image)
  • MFI (Mame Floppy Image)
  • SCP (SuperCardPro Image)
  • RAW (Kryoflux stream file set)

Le chargement des images de disque est multithreadé afin que les grandes images de disque puissent être chargées sans mettre en pause l'émulateur.

Écriture d'images bitstream

Fluxfox peut écrire des images bitstream au format 86f et PRI.

Visualisation des images de disque

Fluxfox permet également une nouvelle fenêtre d'informations sur l'image de disquette, incluant une vue de disque montrant une visualisation graphique de la surface du disque.

Montage de disquettes ZIP

Grâce à rust-fatfs, il est désormais possible de construire dynamiquement des images FAT12. Cela permet de monter des archives ZIP en tant qu'images de disquette.

Bien sûr, le contenu doit s’adapter ! Par défaut, une image de la taille maximale prise en charge pour le périphérique concerné sera créée. Il existe également quelques options pour permettre la création de disquettes amorcables. * Voir le Wiki pour plus d’informations.

Visualiseur de mémoire

  • Grâce à la nouvelle fenêtre Visualiseur de mémoire, il est désormais possible de visualiser graphiquement le contenu de la mémoire, en interprétant les octets bruts comme du texte en mode rendu, ou des pixels en 1, 2, 4 ou 8 bpp. Cela permet d’explorer facilement le contenu de la mémoire, et lors de l’investigation d’un jeu en cours d’exécution, on peut trouver des éléments comme le tampon arrière du jeu ainsi que des sprites chargés en mémoire.

Nouveautés du débogueur

  • Une fenêtre de débogage pour le contrôleur de disquettes montre l’état opérationnel et les journaux de commandes.
  • Une fenêtre de débogage pour le SN76489 affiche l’état des canaux avec des indicateurs de niveau sonore optionnels et des affichages oscilloscopiques.
  • Le visualiseur de mémoire résout désormais les adresses en mémoire cartographiée, bien que ce qui s’affiche dans ces zones soit spécifique au périphérique.
  • Le visualiseur de mémoire prend désormais en charge l’édition de la mémoire.
  • Le visualiseur d’état du CPU prend désormais en charge l’édition des registres et des drapeaux lorsque le CPU est en pause.
  • Le visualiseur de désassemblage désassemble désormais les instructions dans les régions en mémoire cartographiée, comme les cartouches PCjr.
  • Afficher les numéros d’interruptions d’affichage en hexadécimal dans le visualiseur IVT.
  • Afficher à la fois l’adresse source et l’adresse de retour dans la pile d’appels.

Corrections et améliorations de l’interface utilisateur

  • La capture de la souris est encore plus simple, avec une double-clique pour capturer et un clic milieu pour libérer, implémentés par défaut.

  • Le nouveau menu Son a été amélioré avec la possibilité de couper le son et d’ajuster le volume des sources sonores.

  • Basculer entre l’arrière-plan de la fenêtre et une fenêtre de widget GUI. Les shaders sont également disponibles en mode fenêtre (avec le backend wgpu) !

  • Appliquer une surcouche de bordure en mode fenêtre. Cela fonctionne mieux avec un preset de shader qui applique une courbure, et l’ouverture « précise » sélectionnée. Ce n’est pas vraiment un effet de shader, juste un tour de passe-passe GUI.

  • Corrigé un problème où MartyPC recevait des événements clavier même lorsqu’il n’avait pas le focus clavier.

  • Empêcher la machine émulée de recevoir des événements clavier lorsqu’elle est en pause.

  • Réinitialiser le clavier en cas de perte de focus sur la fenêtre (empêche les touches bloquées).

  • Le menu Entrées/Sorties revu permet de contrôler les périphériques :

    • La sensibilité/vitesse de la souris est désormais ajustable via le menu Souris.
    • Le menu Clavier permet de réinitialiser le clavier (effacer les touches bloquées).
  • Mode de capture de la souris : bascule entre l'émulation de la souris et du stylo lumineux

    • Les manettes de jeu port jeu peuvent être mappées aux contrôleurs hôtes
  • Aperçu des performances : affiche les statistiques pour les sources audio

  • Navigateur d'arborescence de fichiers :

    • Refactorisation du menu des médias disquettes
    • Ajout du support pour la création de nouvelles images de disque, formatées ou non
    • Affichage des dossiers avant les fichiers
    • Affichage des icônes correctes pour différents types de fichiers

Corrections et améliorations du noyau

  • Améliorations de l'émulation vidéo TGA/PCjr

    • Support du mode haute résolution 2bpp (ColorPaint)
    • Recherche dans les palettes en mode 2bpp
    • Corrections du taux d'images en mode basse résolution (160x200)
    • Support des fenêtres TGA de 256 Ko (1000HX)
  • Ajout du sous-type 8086 du processeur 8088 pour le support du bus de données 16 bits

  • Amélioration de la précision du minuteur d'interruptions programmables (PIT)

  • Reprise des calculs des états d'attente

  • Amélioration de l'émulation DMA de rafraîchissement DRAM

    • Suppression du hack de minuteur pour les crédits finaux d'Area 5150, car la précision DMA est désormais suffisante
    • De nombreux tests dans Acid88 passent désormais
  • BUS/PPI : amélioration de la gestion du clavier PCjr

  • PPI : correction des masques de commutateurs DIP pour les configurations de mémoire inférieures à

0.2.2
  • Ajout de l’émulation de la carte LoTech 2MB EMS et du port jeu IBM avec joystick clavier (raccourci Ctrl-F9 et configuration joystick_keys).
  • Correction des problèmes d’affichage en plein écran sous macOS Intel (activer macos_stripe_fix dans la config).
  • Fix des erreurs série (8250 UART) pour le PCjr et amélioration du débogage (fenêtre Serial Status, gestion des ports IO).
  • Support des cartouches PCjr au format JRipCart (réinitialisation automatique à l’insertion/retrait).
  • Ajout d’un enregistreur de décompilation (via disassembly_file) et d’un port terminal (terminal_port).
  • Mise à jour des dépendances (Rust 1.76, egui 0.27.2, wgpu 0.19.4) et des médias (SvarDOS, GLaBIOS 0.2.6).

MartyPC 0.2.2 est disponible !

Problèmes connus

  • Vous pourriez recevoir une notification SmartScreen de Windows indiquant que cette application est « inconnue ». Vous devrez cliquer sur « exécuter quand même ». L’exécutable Windows de MartyPC est signé via Sectigo ; j’ai tout tenté pour rassurer Microsoft, mais je ne sais pas quoi faire de plus. Ce n’est pas un avertissement de malware.

  • Le support WGPU pour les anciennes cartes graphiques a été déplacé de DirectX vers OpenGL. Si vous utilisez une ancienne carte graphique ou un adaptateur graphique intégré et rencontrez des problèmes de performance, définissez la variable d’environnement utilisateur suivante :

WGPU_BACKEND=gl

  • Les utilisateurs macOS sous Intel peuvent observer des bandes colorées à l’écran en mode plein écran. Activez macos_stripe_fix dans la configuration pour résoudre ce problème.

Nouveaux périphériques

  • Carte LoTech 2MB EMS

    • Ajout de l’émulation de la carte EMS LoTech 2MB. Cette carte peut être ajoutée à toute configuration de machine via l’overlay lotech_ems. Vous pouvez spécifier le segment de fenêtre et l’adresse de base IO. Cependant, ces valeurs doivent correspondre à l’une des valeurs prises en charge par le matériel réel, sinon le pilote ne fonctionnera pas.
  • Port de jeu et manette

    • Ajout de l’émulation de la carte IBM du port de jeu et de l’émulation basique de manette basée sur le clavier. Une nouvelle touche clavier (JoyToggle) a été ajoutée (provisoirement définie comme Ctrl-F9) pour l’activer ou la désactiver, ainsi que des joystick_keys configurables dans la configuration que vous pouvez utiliser pour définir quelles touches contrôlent la manette.

    • Les machines PCjr et Tandy 1000 disposeront automatiquement d’un port de jeu installé. Vous pouvez ajouter un port de jeu à toute configuration PC ou XT via l’overlay game_port.

    • Deux manettes à deux boutons et deux axes sont supposées connectées lorsque vous spécifiez un port de jeu. D’autres configurations de manettes pourraient être prises en charge à l’avenir.

  • Emplacements de cartouches PCjr

    • Ajout du support dans le noyau, l’interface utilisateur et l’interface graphique pour les cartouches PCjr au format JRipCart. L’insertion ou le retrait d’une cartouche redémarre la machine. Vous ne verrez les emplacements de cartouches que lorsque vous utilisez la machine PCjr.

Corrections et améliorations de l’interface utilisateur

  • Ajout d’un nouveau type de ressource « cartouche » et d’une interface de menu pour parcourir et sélectionner les cartouches PCjr.

Corrections et améliorations du noyau

  • SÉRIEL : Correction de nombreuses erreurs dans l’émulation du 8250 UART de MartyPC. Le PCjr démarre désormais sans le code d’erreur « D » et les diagnostics de série Checkit2 passent également.
  • BUS : Implémentation d'une option de configuration terminal_port sous [machine] dans la configuration principale. Les écritures vers ce port seront affichées dans le terminal de l'hôte.

  • MC6845 : Correction d'un problème empêchant l'entrée de la période d'ajustement total vertical si le total vertical était égal à 127. Corrigé certains problèmes d'affichage de Hercules.

  • HERCULES : Augmentation de la taille du champ d'affichage de Hercules pour accommoder certains émulateurs CGA qui pilotent le moniteur MDA légèrement hors synchronisation (Correction de BBSIMCGA).

  • CGA : Ajout du registre de mode externe CGA dans la sortie de débogage.

  • MACHINE : Ajout d'une fonctionnalité pour enregistrer des listes de désassemblage à partir du code en cours d'exécution. Le nom du fichier de sortie est défini par disassembly_file sous [machine] dans la configuration principale. Cette fonctionnalité sauvegarde essentiellement le désassemblage des instructions dans une table de hachage par CS:IP. Les modifications des segments de code écraseront les désassemblages précédents, donc cette fonction est surtout utile pour activer/désactiver cette fonctionnalité sur des périodes spécifiées.

Corrections et améliorations du débogueur

  • Fenêtre d'état série : Affiche les registres et les statistiques des ports série.

  • Fenêtre d'état IO

    • Ajout d'un bouton « reset » pour réinitialiser tous les compteurs de port.
    • Ajout de la valeur du dernier octet lu pour chaque port.
    • Correction d'une panne/crash lors de la réinitialisation de la machine avec la fenêtre des statistiques IO ouverte et défilée.

Modifications de distribution

  • Ajout d'un disque de démarrage MartyPC basé sur SvarDOS dans media/floppies/boot. Ce disque chargera le pilote LoTech EMS et le pilote CTmouse.
  • Déplacement de FreeDOS vers media/floppies/DOS.
  • Ajout de disquettes SvarDOS build 20240201 dans media/floppies/DOS.
  • Ajout de ctmouse v1.91 (dernière version fonctionnelle pour Non-VGA) dans media/floppies/utilities/mouse.
  • Ajout des utilitaires de carte EMS LoTech 2MB dans media/utilities/EMS.
  • Ajout de JOYCALIB dans media/utilities/joystick.
  • Mise à jour des ROMS GLaBIOS 0.2.6 pour corriger un bug lors de l'override du vecteur int 10h.

Mises à jour des dépendances

  • Version minimale de rustc fixée à 1.76.
  • Mise à jour d'egui à 0.27.2.
  • Mise à jour de wgpu à 0.19.4.

Réagir sur le forum

Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.

Réagir sur le forum