DCMOTO 2024.01.23 - Aide pour l'utilisation de l'émulateur

L'aide est disponible en ligne sur le site dcmoto dans trois langues grâce à Google Translation :

L'aide de dcmoto concerne uniquement le fonctionnement de l'émulateur, pas celui des ordinateurs Thomson. Les guides utilisateur des machines émulées sont disponibles à la page Documentation du site dcmoto. La section FAQ du forum dcmoto donne aussi des informations précieuses. Pour toute question ne trouvant pas de réponse dans la documentation, ou pour signaler une anomalie de l'émulateur, utilisez le forum system-cfg.

Auteur : Daniel Coulom - Site internet : dcmoto.free.fr - Dernière mise à jour le 23 janvier 2024

Raccourcis clavier

- PAUSE arrête le processeur de la machine émulée. Redémarrage par une touche quelconque, un clic de souris ou action sur l'une des manettes.

- ECHAP émule le bouton de réinitialisation programme.

- ARRET DEFILEMENT Coupe l'alimentation de l'ordinateur s'il est sous tension, et la rétablit s'il est hors tension.
Cette opération permet d'émuler un arrêt suivi d'un redémarrage de l'ordinateur (démarrage à froid).

- F12 provoque une copie d'écran "rapide" (screenshot), sans boîte de dialogue pour le choix du nom de fichier. Le fichier est créé dans le même dossier que dcmoto.exe, son nom est de la forme dcmotoxx.bmp xx est le premier nombre inutilisé dans la tranche 01-99
Pendant la copie d'écran, le processeur de la machine émulée est arrêté. En mode fenêtré une boîte de dialogue donne le nom du fichier .bmp créé. En mode plein écran, il n'y a aucune boîte de dialogue et le programme redémarre immédiatement. La taille de la copie d'écran est choisie dans les paramètres de l'émulateur (menu Options / Paramètres...).

- F11 provoque une sauvegarde "rapide" de l'état de la machine (snapshot), sans boîte de dialogue pour le choix du nom de fichier. Le fichier est créé dans le même dossier que dcmoto.exe, son nom est de la forme dcmotoxx.mrx xx est le premier nombre inutilisé dans la tranche 01-99.
Si l'ordinateur émulé est un MO5, TO7/70, MO6 ou PC128, un autre fichier, de même nom et d'extension .sddrive, est créé simultanément. Il permet de restaurer l'état de la machine sur un "vrai" MO5, TO7/70, MO6 ou PC128 équipé d'un contrôleur de carte SD (CS91-280 ou CS91-282 ou SDDISK ou SDDRIVE).
Un troisième fichier de même nom et d'extension .sdstream, est également créé. Il permet de restaurer l'état de la machine avec le contrôleur SDSTREAM.
Pendant la sauvegarde, le processeur de la machine émulée est arrêté. En mode fenêtré une boîte de dialogue donne le nom du fichier .mrx créé. En mode plein écran, il n'y a aucune boîte de dialogue et le programme redémarre immédiatement.

- F6 permet de charger un fichier binaire en mémoire. L'adresse de début et l'adresse de fin doivent avoir été définies dans l'outil de mise au point.

- F9 arrête le processeur de la machine émulée et affiche la boîte de dialogue de mise au point.

- F8 provoque la restauration rapide de l'état de la machine émulée, en utilisant un fichier dcmotoxx.mrx. Le fichier choisi est le dernier sauvé par la touche F11 depuis le lancement de dcmoto. S'il n'existe pas une boîte de dialogue permet de choisir un autre fichier de sauvegarde.

- F7 force la fréquence du processeur à 32 MHz tant que la touche est enfoncée. Quand la touche est relâchée le processeur revient à la fréquence par défaut de 1 MHz.

- PAGE UP passe l'affichage en plein écran.

- PAGE DOWN revient en mode fenêtré.

Le menu Fichier

- Copier l'écran...
Cette fonction créé une copie d'écran au format bitmap de Windows (bmp). La taille des copies d'écran est choisie dans le menu Options / Paramètres... Une boîte de dialogue permet de choisir le dossier et le nom du fichier .bmp
Notez que la touche de raccourci F12 évite d'avoir à répondre à cette boîte de dialogue (voir ci-dessus la description des raccourcis clavier).

- Sauver état actuel...
Cette fonction provoque la sauvegarde de l'état actuel de la machine (registres, mémoire, etc.) dans un fichier au format mrx, propre à dcmoto. Une boîte de dialogue permet de choisir le dossier et le nom du fichier .mrx
Si l'ordinateur émulé est un MO5, TO7/70, MO6 ou PC128, un autre fichier, de même nom et d'extension .sddrive, est créé simultanément. Il permet de restaurer l'état de la machine sur un "vrai" MO5, TO7/70, MO6 ou PC128 équipé d'un contrôleur de carte SD (CS91-280 ou CS91-282 ou SDDISK ou SDDRIVE).
Un troisième fichier de même nom et d'extension .sdstream, est également créé. Il permet de restaurer l'état de la machine avec le contrôleur SDSTREAM.
Notez que la touche de raccourci F11 évite d'avoir à répondre à la boîte de dialogue (voir ci-dessus la description des raccourcis clavier).

- Restaurer état...
Cette fonction provoque la restauration de l'état de la machine à partir d'un fichier .mrx préalablement créé par la fonction précédente. Une boîte de dialogue permet de choisir le dossier et le nom du fichier .mrx
Notez que la touche de raccourci F8 évite d'avoir à répondre à cette boîte de dialogue (voir ci-dessus la description des raccourcis clavier).
Remarque : La structure des fichiers .mrx peut varier entre deux versions successives de dcmoto. La restauration de l'état de la machine n'est donc pas garantie si le fichier mrx a été créé avec une version différente de la version actuelle.

- Simuler le clavier...
Cette fonction permet de simuler la frappe en utilisant le contenu du presse-papier ou d'un fichier texte. Deux modes sont possibles :
. le mode rapide, avec affichage de l'écran après chaque ligne de texte.
. le mode normal, avec affichage de l'écran après chaque caractère.

- Charger fichier binaire...
Cette fonction permet de charger un fichier binaire en mémoire. L'adresse de début et l'adresse de fin doivent avoir été définies dans l'outil de mise au point.

- Pause processeur
Arrête le processeur 6809. Cette fonction est propre à l'émulateur, elle n'existe pas sur la vraie machine. Ne pas confondre avec la fonction STOP du Basic, qui suspend l'exécution du programme sans arrêter le processeur.
La touche Pause (raccourci clavier) a la même fonction.

- Initialisation prog.
Emule le bouton d'initialisation de la machine.
La touche Echap (raccourci clavier) a la même fonction.

- Démarrage à froid
Emule une coupure de l'alimentation de la machine (réinitialisation totale).
La touche Arrêt Défilement (raccourci clavier) a la même fonction.

- Quitter
Arrête le programme dcmoto.

La boîte de dialogue Supports amovibles

- Charger cartouche
Place une MEMO5 ou une MEMO7 dans l'emplacement des cartouches. La cartouche peut contenir une ROM (extension .rom) ou de la RAM (extension .ram). Les cartouches de RAM sont à la section Programmes du site dcmoto (cherchez par Titre "Cartouches RAM"). Les images de cartouches ont par défaut l'extension .rom ou .ram mais il est possible d'utiliser une autre extension.
Attention, en cas d'incompatibilité entre la cartouche et la machine, le résultat est imprévisible. Après avoir chargé une cartouche, il est souvent nécessaire de réinitialiser la machine émulée.

- Retirer cartouche
Retire la MEMO5 ou la MEMO7 de l'emplacement cartouche. Après avoir retiré une cartouche, il est souvent nécessaire de réinitialiser la machine émulée.

- Charger cassette
Place une cassette dans le magnétophone et la positionne au début. La cassette peut être au format .k7 ou au format .lep Les cassettes au format .k7 ont par défaut l'extension .k7 mais il est possible d'utiliser une autre extension (sauf .lep). On peut choisir un fichier existant, ou donner un nouveau nom de fichier pour créer une cassette vierge. Le fichier .k7 est par défaut en lecture seule, mais on peut le déprotéger en cochant la case d'autorisation d'écriture. Les cassettes au format .lep ne permettent pas l'écriture. Il est donc inutile d'en créer de nouvelles ou de supprimer la protection écriture.

- Retirer cassette
Retire une cassette du magnétophone. Si le fichier .k7 a été modifié après son chargement, il est sauvegardé automatiquement. Les fichiers .lep ne sont pas modifiés.

- Charger disquette
Place une disquette dans le lecteur. La disquette est par défaut en lecture seule, mais on peut la déprotéger en cochant la case d'autorisation d'écriture. Pour charger une disquette vierge, taper un nom de fichier inexistant, il sera créé automatiquement. Pour utiliser cette nouvelle disquette, il faut la formater avec la commande Basic Thomson DSKINI.

- Retirer disquette
Retire une disquette du lecteur. Si le fichier .fd a été modifié après son chargement, il est sauvegardé automatiquement.

- Charger carte SD
Place une image de carte SD dans une interface SDMO ou SDMOTO ou SDDRIVE ou SDSTREAM ou SDANIM7. Les images de cartes SD ont par défaut l'extension .sd mais il est possible d'utiliser une autre extension, par exemple .sds ou .sdstream.

- Retirer carte SD
Retire la carte SD de l'interface ou du périphérique Arduino.

- Charger carte CF
Place une image de carte CompactFlash dans l'interface CFMO. Les images de cartes CF ont par défaut l'extension .cf mais il est possible d'utiliser une autre extension.

- Retirer carte CF
Retire la carte CompactFlash de l'adaptateur CFMO

- Périphériques connectés
Permet de connecter ou déconnecter le lecteur de cassette, les lecteurs de disquettes, les interfaces SDMOTO, SDMO, SDDRIVE, SDSTREAM, SDANIM7 et CFMO.

- Lecteur de cassette
Affiche le contenu de la cassette chargée et l'index de la position actuelle. Les boutons permettent de positionner l'index en début ou en fin de cassette, et de simuler l'avance et le retour rapide

Par défaut, la lecture et l'écriture des cassettes au format .k7 et des disquettes au format .fd est beaucoup plus rapide avec l'émulateur. Deux cases à cocher permettent de diminuer la vitesse pour la rendre comparable à celle des vraies machines.

La boîte de dialogue Options

Permet de choisir :

- La machine émulée
MO5 (5 versions), MO5E, MO5N, MO5NR, MO6 (3 versions), PC128,
T9000, TO7 (3 versions), TO7/70 (2 versions), TO9 (2 versions), TO8 (2 versions), TO8D, TO9+ (2 versions).

- La langue
Français, Anglais, Italien.

- Le contrôleur de disquette, de carte SD, de Nanoréseau, de Lego.
CQ90-028 (Quick Disk Drive), CD90-015 (5"1/4 simple densité), CD90-640 (5"1/4 double densité), CD90-351 (3"1/2),
CS91-280 (SDMOTO), CS91-281 (SDMO), CS91-282 (SDMO interne au MO5), SDDISK, SDDRIVE
NR3 MO5 (Nanoréseau pour MO), NR3 TO7 (Nanoréseau pour TO), LEGO DACTA.

- Les périphériques connectés
Extension Musique et Jeux, pour les ordinateurs sans contrôleur musique et jeux interne.
Manettes, crayon optique, souris.

- Les synthétiseurs (optionnels)
- Synthétiseur de Parole Cedic-Nathan à base de MEA8000.
- Générateur de son numérique complexe à base de SN76489.
Pour ce dernier, il faut aussi choisir parmi les valeurs proposées l'adresse où seront envoyés les octets de commande.

- Le processeur (6809 ou 6309)
Le processeur d'origine des ordinateurs Thomson est le 6809 de Motorola. On peut le remplacer par le processeur 6309 d'Hitachi.
Le 6309 émule le 6809 et dispose de registres et d'instructions supplémentaires.
Il permet aussi, dans un autre mode dit 'natif', de réduire le nombre de cycles par instruction.
La fréquence du processeur 6809 ou 6309 peut être réglée de 10 kHz à 64000 kHz
Une autre option permet l'arrêt du processeur et l'affichage d'un message en cas d'instruction invalide.

- Le son
Volume et fréquence d'échantillonnage.
Le changement de fréquence d'échantillonnage permet d'éviter des distorsions avec certains types de sons.
Il est conseillé de la réduire si dcmoto fonctionne avec un PC lent, pour éviter des craquements gênants.
La case à cocher "Fichier wav" permet d'enregistrer le son émis par dcmoto dans le fichier "dcmoto.wav".
Ce fichier est fermé automatiquement à la fermeture de dcmoto et écrasé à chaque nouvelle session d'enregistrement.
Pour éviter de créer dcmoto.wav par erreur, la case "Fichier wav" n'est jamais cochée au lancement de l'émulateur.

- L'extension mémoire
EM90-016 (16K pour TO7 et T9000), EM97-064 (64K pour TO7/70 et TO9), EM88-256 (256K pour TO8 et TO8D).
ATTENTION : Les extensions mémoire en cartouche MEMO5 (RAM64-NR5 ou extension mémoire 512K) et en cartouche MEMO7
(extension 64K ASELEC) ne sont pas sélectionnées dans les options. Elles doivent être chargées comme les autres MEMO5 et MEMO7.
Voir à ce sujet la rubrique précédente (La boîte de dialogue Supports amovibles).

- L'émulation des manettes par le clavier
Les périphériques HMI reconnus par Windows sont utilisables pour remplacer les manettes Thomson.
En leur absence, il est possible d'émuler les manettes par le clavier, de deux façons différentes, utilisables séparément ou simultanément :

1) Emulation par les touches CTRL ou MAJ avec les flèches, la barre d'espace et la touche Entrée.
CTRL-gauche sélectionne la manette 0, SHIFT-gauche sélectionne la manette 1.
Les flèches émulent le manche, Espace et Entrée simulent les deux boutons.

2) Emulation par le pavé numérique ou la configuration personnalisée.
Manette 0: 1 2 3 5 émulent le manche, Entrée et 0 émulent les deux boutons.
Manette 1: 4 5 6 8 émulent le manche, + et 4 émulent les deux boutons.
Cette deuxième option doit être cochée pour utiliser une configuration personnalisée.
Elle est incompatible avec l'émulation du pavé numérique des TO9, TO8, TO8D et TO9+.

- Le comportement des fenêtres de l'outil de mise au point
Les fenêtres de l'outil de mise au point peuvent suivre ou ne pas suivre le déplacement de la fenêtre principale.

- L'émulation du pavé numérique des TO9, TO8, TO8D et TO9+
Emulation par le pavé numérique du PC, ou pas d'émulation.
Cette option est incompatible avec l'émulation des manettes par le pavé numérique du PC.

- L'affichage du curseur
Permet d'activer ou de désactiver l'affichage dans l'écran Thomson du curseur Windows, en forme de flèche si la souris est connectée et activée,
ou de crayon si le crayon optique est connecté et activé. Ce curseur n'est pas nécessaire si le programme Thomson affiche son propre curseur.

- La correction de gamma pour l'affichage
On peut aussi forcer le format 4/3, choisir un affichage monochrome et simuler les lignes de balayage d'un écran cathodique.

- La taille des copies d'écran
320x200 ou 640x400, avec ou sans bordures.

- Le facteur de zoom
Un facteur de zoom de 100% correspond à un écran utile (sans les bordures) de 640x400 pixels.

Le menu Outils

- Clavier...
Affiche une image permettant de simuler le clavier de la machine émulée, en cliquant sur les touches avec la souris. Pour bloquer une touche en position enfoncée, relâcher le bouton de la souris hors de la touche. Pour modifier la configuration du clavier du PC, cliquer sur le clavier graphique hors des touches.

- Configuration du clavier
La boîte de dialogue donne la correspondance Thomson-->PC. La table de correspondance peut être modifiée pour s'adapter à tous les types de clavier, ou aux préférences de l'utilisateur. Le pavé numérique des TO8 et TO9 peut être désactivé dans la boîte de dialogue Options, pour éviter un conflit avec l'émulation des manettes.

- Manettes...
Affiche une boîte de dialogue permettant de modifier la correspondance des directions et des boutons d'action avec les touches du PC. Utilisez de préférence des touches ne risquant pas d'être interprétées comme des frappes au clavier par le programme Thomson. La personnalisation des touches d'émulation des manettes est active uniquement si l'option "Pavé numérique" est cochée dans l'option d'émulation des manettes.

- Mise au point...
Cette double boîte de dialogue contient des outils de mise au point réservés aux spécialistes. Une fonction peut toutefois être utilisée sans connaissances spéciales : la protection ou déprotection des programmes Basic. Choisir la case à cocher correspondant au Basic concerné.
Toutes les précisions sur l'utilisation de l'outil de mise au point peuvent être obtenues en posant les questions dans la rubrique Emulateurs et utilitaires du forum system-cfg.

Le menu Aide

La boîte de dialogue Aide affiche des informations sur l'émulateur dcmoto et permet d'accéder à l'aide et aux notes de version.

Le fichier d'aide est dcmoto_xxxxxxxx_aide.html ou xxxxxxxx est le numéro de version.
Il doit se trouver dans le même répertoire que dcmoto.
A défaut on peut y accéder par internet. Le lien est en haut de cette page.

Le fichier de notes de version est dcmoto_xxxxxxxx_notes.html ou xxxxxxxx est le numéro de version.
Il doit se trouver dans le même répertoire que dcmoto.
A défaut on peut y accéder par internet. Le lien est en haut de cette page.

La licence de dcmoto doit être lue attentivement avant d'utiliser l'émulateur.
Le bouton "OK" en bas de la boîte de dialogue permet de copier cette licence dans le presse-papier pour la coller ensuite dans un fichier texte.

Emulation des cassettes

Les cassettes Thomson sont émulées par des fichiers (images de cassettes) au format .k7 ou .lep
- Les fichiers .k7 contiennent uniquement les informations utiles pour charger les données. Ils ont l'avantage d'être lus très rapidement. En contrepartie ils ne reproduisent pas les structures des blocs spéciaux utilisées par les éditeurs pour protéger les cassettes contre la copie avec un ordinateur Thomson. Les cassettes doivent donc avoir été déprotégées pour être converties au format .k7.
- Les fichiers .lep contiennent les mêmes informations que les cassettes originales, y compris les structures spéciales de protection contre la copie. Ils sont lus exactement comme les vraies cassettes, à la même vitesse. Ils permettent de lire toutes les cassettes, protégées ou non.

Emulation des disquettes et des Quick Disks

Les disquettes Thomson sont émulées par des fichiers (images de disquettes) au format .fd. Chaque fichier fd contient une, deux, trois ou quatre faces, correspondant respectivement aux unités 0: 1: 2: et 3: des machines Thomson.

La taille du fichier .fd détermine son contenu :
- 80 Ko = 5\"1/4 simple densité unité 0:
- 160 Ko = 5\"1/4 double densité unité 0:
- 320 Ko = 3\"1/2 double densité unité 0:
- 640 Ko = 3\"1/2 double densité unités 0: 1:
- 960 Ko = 3\"1/2 double densité unités 0: 1: 2:
- 1280 Ko = 3\"1/2 double densite unités 0: 1: 2: 3:

Il est possible de trouver sur internet un autre format d'images de disquettes Thomson, dont l'extension est .sap (Système d'Archivage Alexandre Pukall). L'émulateur dcmoto lit aussi les fichiers .sap et les convertit automatiquement au format .fd. Chaque fichier .sap ne contient qu'une seule face de disquette, il faut donc concaténer deux faces pour obtenir une image de disquette double face. Pour cette opération, on peut utiliser la commande COPY de MS-DOS ou de Windows.
Exemple: COPY /B face0.fd+face1.fd disquette.fd
La même méthode s'applique aux images de 3 ou 4 faces.

Les Quick Disks Thomson sont émulés par des fichiers (images de quick disks) au format .qd. Un fichier qd contient les 400 secteurs de 128 octets du Quick Disk, dans l'ordre des secteurs logiques, soit un total de 50 Ko.

Extension mémoire et RAMDISK MO

Une extension mémoire de 512K peut être utilisée avec tous les ordinateurs MO. Elle fonctionne sur le même principe que l'extension 64K de Thomson, avec contrôle du numéro de banque par le registre $A7CB. Les bits 0-3 sont compatibles avec les deux extensions. Les bits 4-6 sont les bits de poids fort du numéro de banque de l'extension 512K. Complétés par les deux bits de poids faible ils permettent d'adresser 32 banques de 16K.
Le bit 2 de $A7CB permet de sélectionner l'extension mémoire, qui masque alors le BASIC. Le bit 3 est l'autorisation d'écriture. S'il est à zéro l'extension est en lecture seule.
Le contrôleur SDDRIVE permet d'utiliser l'extension 512K des ordinateurs MO comme un RAMDISK. Il simule une face de disquette 3"1/2 de 320K en mémoire accessible comme unité 3:. En contrepartie, l'unité 3: d'un fichier .sd n'est pas accessible avec un ordinateur MO. Avec un ordinateur TO cette restriction ne s'applique pas, l'extension 512K des MO est ignorée.

Emulation des cartes SD et CompactFlash

Les contrôleurs de cartes SD sont émulés dans dcmoto s'ils sont sélectionnés dans les options. Avec le contrôleur CS91-280 utilisez l'option CS91-280 pour l'interface SDMOTO et CS91-281 pour l'interface SDMO. CS91-282 est le contrôleur interne du MO5. Les autres contrôleurs pour les cartes SD sont SDDISK et SDDRIVE.

Il n'est pas possible d'émuler une carte SD contenant plusieurs fichiers .sd pour des raisons de taille mémoire. Un seul fichier .sd est accessible, il doit être sélectionné dans la boîte de dialogue Supports amovibles.

L'accès à une carte SD par l'intermédiaire d'un Arduino est aussi émulé en sélectionnant la carte SD et le périphérique SDSTREAM ou SDANIM7 dans la boîte de dialogue Supports amovibles.

L'émulation des cartes CompactFlash a été créée pour un ancien projet aujourd'hui abandonné. Elle n'a plus d'utilité réelle.

En cas de difficulté pour l'émulation des cartes SD n'hésitez pas à demandez de l'aide dans le forum system-cfg.

Emulation de l'imprimante

Lorsqu'un caractère est envoyé vers l'imprimante, dcmoto l'écrit automatiquement dans le fichier dcmoto-printer.txt. Si ce fichier n'existe pas, il est créé automatiquement dans le dossier de dcmoto.exe. S'il existe, les caractères imprimés sont ajoutés en fin de fichier. L'émulateur ne réinitialise jamais le fichier dcmoto-printer.txt. L'utilisateur doit le supprimer manuellement s'il n'est plus utile.

Complément d'information

Pour obtenir toute les informations et toute l'aide nécessaires à l'utilisation de l'émulateur dcmoto utilisez le forum system-cfg. Dans la section Emulateurs et Utilitaires plusieurs fils de discussion sont consacrés à dcmoto : Forum system-cfg / Emulateurs et Utilitaires