tranZPUter FusionX Manuel Utilisateur

Presentation

Presentation de la carte

Connecteurs et broches

• Connecteur JTAG 10 broches — Utilise pour la programmation en systeme (ISP) du CPLD Altera MAX7000AE via un programmateur JTAG compatible (par ex. USB-Blaster). Ce connecteur est egalement utilise pour la programmation initiale lorsqu'un CPLD vierge ou incorrectement programme doit etre flashe avec une nouvelle variante. Voir le Guide technique pour les details de programmation.
• Connecteur USB-Serie (CH340E) — Un connecteur micro-USB ou un connecteur a broches route a travers un pont USB vers UART CH340E embarque. Cela fournit un acces direct a la console serie Linux a 115200 bauds, 8N1. Cote SOM, il se connecte au UART principal. C'est l'interface de gestion principale lors de la configuration initiale et de l'administration quotidienne.
• Port USB 2.0 (SOM) — Un port hote USB 2.0 Type-A standard expose depuis le SOM SSD202D. Ce port peut etre utilise pour connecter un stockage de masse USB, des adaptateurs USB-Ethernet ou d'autres peripheriques USB supportes par le noyau Linux.
• Emplacement carte SD (SOM) — Un emplacement micro-SD connecte a l'interface SDIO du SOM. La carte SD est utilisee pour le stockage supplementaire, contenant des images ROM, des fichiers programme MZF et des images de mise a jour firmware OTA. Le SOM detectera une carte SD correctement preparee au demarrage et effectuera automatiquement une mise a jour OTA si une image firmware valide est presente.
• Connecteur d'antenne WiFi — Un connecteur coaxial IPEX/U.FL pour une antenne WiFi 2,4 GHz externe, connecte au module sans fil SSW101B integre du SSD202D. Une antenne appropriee doit etre installee pour une connectivite sans fil fiable.

Indicateurs d'etat

• LED d'alimentation — S'allume lorsque l'alimentation 3,3 V est presente sur la carte, confirmant que le convertisseur abaisseur TLV62569DBV fonctionne correctement.
• LED d'activite — Pilotee par le SOM ; indique l'activite du noyau Linux et de l'emulation Z80. Clignote pendant le demarrage et pendant les cycles d'emulation Z80 actifs.
• LED CPLD — Pilotee par le CPLD ; indique l'activite du bus sur le bus Z80 hote. Utile pour confirmer que le CPLD interface activement avec la machine hote.

Alimentation

Cartes filles

• Carte fille MZ-80A — Interface les sorties video et audio du FusionX avec l'ecran interne et les circuits audio du Sharp MZ-80A.
• Carte fille MZ-700 — Interface les sorties video et audio du FusionX avec l'ecran interne et les circuits audio du Sharp MZ-700.
• Carte fille MZ-2000 — Interface les sorties video et audio du FusionX avec l'ecran interne et les circuits audio du Sharp MZ-2000.

Machines hotes supportees

Configuration initiale

Etape 1 — Verifier la variante CPLD [Commun]

Etape 2 — Installer la carte fille correcte [Specifique a l'hote]

Etape 3 — Installer dans la machine hote [Commun]

Etape 4 — Connecter l'adaptateur USB-Serie [Commun]

• Debit en bauds : 115200
• Bits de donnees : 8
• Parite : Aucune
• Bits d'arret : 1
• Controle de flux : Aucun

Etape 5 — Mise sous tension [Commun]

Etape 6 — Acceder a la console Linux [Commun]

Modes de demarrage de la machine

Demarrage general — start_FusionX.sh

1. Charge le module noyau ttymzdrv, qui mappe le clavier et l'ecran de l'hote sur /dev/ttymz0.
2. Isole le CPU1 du planificateur Linux en utilisant isolcpus, le reservant exclusivement pour la boucle d'emulation Z80.
3. Charge le module noyau z80drv, qui initialise le moteur d'emulation Z80 et l'interface de bus CPLD.
4. Demarre l'emulation Z80 en utilisant l'image ROM par defaut et la configuration materielle pour la variante CPLD installee.

sudo /opt/fusionx/start_FusionX.sh

Mode ROM Filing System — startZ80_RFS.sh

• Les pages ROM commutables sont activees, permettant de commuter plusieurs images ROM dans et hors de l'espace d'adressage Z80 a l'execution.
• Les fichiers programme MZF stockes sur la carte SD peuvent etre charges directement en memoire Z80 et executes sans necessiter une interface de cassette.
• Le systeme de fichiers ROM fournit une interface pilotee par menu sur l'ecran de l'hote pour selectionner et charger des programmes.

sudo /opt/fusionx/startZ80_RFS.sh

Mode tranZPUter Filing System — startZ80_TZFS.sh

sudo /opt/fusionx/startZ80_TZFS.sh

Basculer entre les modes de demarrage

z80ctrl --stop
sudo rmmod z80drv
sudo /opt/fusionx/startZ80_TZFS.sh

Utilisation de l'emulateur Z80

Charger une image ROM

z80ctrl --loadrom /path/to/rom.bin --addr 0xE800 --size 0x2000

Ajouter un peripherique materiel virtuel

z80ctrl --adddev --device mz80a

Demarrer et arreter l'emulation

z80ctrl --start

z80ctrl --stop

Inspecter la memoire

z80ctrl --dump --addr 0x0000 --size 256

Charger un programme MZF

z80ctrl --loadmzf /sd/programs/test.mzf

Basculer entre la console Z80 et Linux

Suspendre la session Z80 pour acceder a la console Linux

Retourner a la session Z80

sharpbiter --resume

Configuration WiFi

Configurer le WiFi avec wpa_supplicant

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

network={
    ssid="YourNetworkName"
    psk="YourNetworkPassword"
    key_mgmt=WPA-PSK
}

sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
sudo udhcpc -i wlan0

Acces SSH

ip addr show wlan0

ssh fusionx@<ip-address>

Carte SD et gestion des fichiers

Montage de la carte SD

sudo mkdir -p /mnt/sd
sudo mount /dev/mmcblk1p1 /mnt/sd

/dev/mmcblk1p1  /mnt/sd  vfat  defaults,noatime  0  2

Organisation des fichiers

/mnt/sd/
  roms/          - Images ROM binaires (.bin)
  programs/      - Fichiers programme au format MZF (.mzf)
  firmware/      - Images de mise a jour firmware OTA

Mises a jour firmware OTA

1. Telechargez l'image de mise a jour firmware depuis la page des versions du projet.
2. Copiez l'image firmware dans le repertoire firmware/ sur la carte SD.
3. Inserez la carte SD dans l'emplacement carte SD du SOM.
4. Redemarrez la machine hote. Le processus de demarrage du SOM detectera l'image firmware, l'ecrira sur la Flash NAND et redemarrera automatiquement.
5. Apres la mise a jour, l'image firmware sur la carte SD est renommee ou supprimee pour empecher les mises a jour repetees lors des demarrages suivants.

Depannage

L'hote ne demarre pas / ecran vide

• Verifiez que la broche 1 de la carte FusionX est alignee avec la broche 1 du socle DIP-40. Une orientation incorrecte empechera la carte de fonctionner et pourra endommager la machine hote.
• Confirmez que les 40 broches de la carte FusionX sont completement et correctement inserees dans le socle. Une seule broche pliee ou manquee peut causer une defaillance complete.
• Si vous utilisez une carte fille, confirmez qu'elle est correctement installee et que ses connecteurs cote hote sont attaches aux bons points sur la carte mere de l'hote. Une carte fille mal routee entraînera l'absence de sortie video.
• Confirmez que la variante CPLD correspond a la machine hote. Un CPLD programme avec la mauvaise variante produira une synchronisation de bus incorrecte, resultant en l'absence d'affichage ou une sortie corrompue. Consultez le Guide technique pour la verification de la variante CPLD.

Pas de console Linux sur USB-Serie

• Confirmez que le pilote USB-serie CH340E/CH34x est installe sur votre PC. Sous Windows, telechargez et installez le pilote depuis la page du fabricant CH340. Sous Linux, executez lsmod | grep ch341 pour confirmer que le pilote est charge.
• Confirmez que l'emulateur de terminal est configure a 115200 bauds, 8 bits de donnees, pas de parite, 1 bit d'arret, pas de controle de flux.
• Confirmez que le cable USB est capable de transferer des donnees (pas un cable de charge uniquement). Les cables de charge uniquement ne portent pas les lignes de donnees D+ et D-.
• Verifiez que le port USB-serie n'est pas deja ouvert dans une autre application sur votre PC.
• Essayez un autre port USB sur votre PC. Certains controleurs USB gerent les peripheriques USB-serie pleine vitesse avec plus de fiabilite que d'autres.

L'emulation Z80 ne demarre pas

• Verifiez si le module noyau z80drv est charge : executez lsmod | grep z80drv. S'il n'est pas liste, le script de demarrage n'a pas reussi a charger le module.
• Consultez le journal du noyau pour les messages d'erreur lors du chargement du module : executez dmesg | tail -50 et recherchez les messages relatifs a z80drv ou ttymzdrv.
• Verifiez le script de demarrage pour les erreurs. Executez le script manuellement depuis la console serie et observez toute sortie d'erreur.
• Confirmez que le chemin de l'image ROM specifie dans le script de demarrage est correct et que le fichier existe et est lisible.

Le programme MZF ne se charge pas

• Confirmez que la carte SD est montee : executez mount | grep mmcblk1. Si elle n'est pas montee, montez-la avec sudo mount /dev/mmcblk1p1 /mnt/sd.
• Confirmez que le chemin du fichier passe a z80ctrl --loadmzf est correct et que le fichier existe : executez ls -la /mnt/sd/programs/.
• Verifiez que le fichier MZF n'est pas corrompu. Un fichier MZF valide a un en-tete de 128 octets commencant par un octet de type de fichier de 0x01 (code machine) ou 0x02 (BASIC). Utilisez xxd /mnt/sd/programs/test.mzf | head -8 pour inspecter l'en-tete.
• Assurez-vous que l'emulation Z80 est en cours d'execution avant de tenter de charger et d'executer un fichier MZF.

Le WiFi ne se connecte pas

• Confirmez que l'antenne WiFi externe est connectee au connecteur IPEX/U.FL sur la carte FusionX. Utiliser le module SSW101B sans antenne peut resulter en un signal extremement faible ou une incapacite totale a s'associer.
• Verifiez que le SSID et la phrase secrete dans /etc/wpa_supplicant/wpa_supplicant.conf sont corrects. Les deux sont sensibles a la casse.
• Verifiez le journal wpa_supplicant pour les erreurs d'association : executez wpa_cli status ou inspectez dmesg | grep -i wlan pour les messages d'erreur.
• Confirmez que votre point d'acces fonctionne sur la bande 2,4 GHz. Le SSW101B ne supporte pas les reseaux 5 GHz.

La machine fonctionne trop vite / erreurs de timing

• Confirmez que la variante CPLD correspond exactement a la machine hote. Chaque machine hote supportee necessite une variante CPLD specifique compilee dans Quartus II. Consultez le tableau des machines hotes supportees ci-dessus pour l'identifiant de variante correct.
• Si le CPLD a ete recemment reprogramme, confirmez que le fichier .pof correct a ete utilise. Consultez le Guide technique pour les procedures de programmation et de verification de variante CPLD.
• Si la variante CPLD correcte est confirmee, verifiez la configuration d'horloge de l'emulation Z80. Le module z80drv peut necessiter un ajustement de son parametre de diviseur d'horloge pour la frequence d'horloge Z80 attendue de votre machine hote specifique.

Sites de reference

Avis reglementaire sans fil