Démarrer avec le Neo6502 sous Trinity

À la fin de ce guide, votre carte Neo6502 démarre sous Trinity, sur NeoDOS, et lance un programme copié sur une clé USB.

1. Ce qu'il faut · 2. Flasher Trinity · 3. Préparer la clé · 4. Premier programme, en C · 5. Revenir au firmware officiel · 6. En cas de problème

1. Ce qu'il faut

• Une carte Neo6502 d'Olimex.
• Un bloc secteur USB-C pour l'alimentation : le port USB-C d'un ordinateur ne suffit pas toujours (clavier et hub décrochent).
• Un câble USB-A vers USB-A, pour flasher le firmware depuis un ordinateur : il se branche sur le port USB-A de la carte, pas sur l'USB-C.
• Une clé USB formatée en FAT32 (une clé USB 2 de 8 Go a été essayée ; une clé USB 3 de 60 Go n'a pas été reconnue).
• Un clavier USB et un petit hub USB : la carte n'a qu'un port USB-A, pour le clavier et la clé.
• Un écran HDMI (la sortie est en DVI sur un connecteur HDMI).

2. Flasher Trinity

Téléchargez trinity-0.16.71.uf2 (release 0.16.71, avec son empreinte SHA-256). NeoDOS 0.32.1 est inclus.

1. Débranchez l'alimentation USB-C.
2. Maintenez le bouton BOOT de la carte, branchez le câble USB-A vers USB-A entre la carte et l'ordinateur, puis relâchez le bouton.
3. Un lecteur nommé RPI-RP2 apparaît sur l'ordinateur : copiez-y le fichier .uf2. Le lecteur disparaît quand le firmware est écrit.
4. Débranchez le câble USB-A, rebranchez l'alimentation USB-C, puis le hub avec le clavier.

Au démarrage, après les logos, l'écran affiche notamment (les lignes du milieu dépendent de ce qui est branché) :

Trinity Firmware: v0.16.71
USB Storage
NeoDOS version 0.32.1
(C) 2026 bmarty - Neo6502 disk operating system
A:\>

3. Préparer la clé

NeoDOS est intégré à Trinity : rien à copier pour l'avoir. Sans clé, l'écran indique USB Storage (no key) et NeoDOS démarre quand même.

Au démarrage, NeoDOS exécute AUTOEXEC.BAT s'il est sur la clé.

Facultatif : un dossier boot/ sur la clé fait apparaître un menu de démarrage (ses programmes .neo et images .bin, une touche de 1 à 9 pour choisir, Entrée ou 3 secondes pour NeoDOS). Un fichier boot/auto.txt qui contient le nom d'un de ces fichiers le lance après 3 secondes ; Échap ramène au menu. NeoBASIC se lance ainsi, à partir d'un boot/neobasic.bin.

4. Premier programme, en C

Cet exemple de la référence de l'API (groupe 2, fonction 6) écrit « Bonjour » en couleur :

#include <neo/api.h>

int main(void) {
    const char *texte = "\x83" "Bonjour" "\x87" "\r";   /* $83 : couleur 3, $87 : couleur 7 */
    while (*texte)
        neo_console_write_char(*texte++);
    return 0;
}

Compilez-le avec llvm-mos (SDK llvm-mos) : mos-neo6502-clang -Os -o BONJOUR.NEO bonjour.c. Copiez BONJOUR.NEO à la racine de la clé, puis tapez BONJOUR.NEO à l'invite A:\> : « Bonjour » s'affiche, puis l'invite revient.

Exemple vérifié dans l'émulateur Phosphoneo.

5. Revenir au firmware officiel

Même procédure, avec le fichier firmware_usb.uf2 du firmware officiel v1.0.0 (archive neo6502.zip). La carte sort d'usine avec un autre firmware, l'émulateur Apple II d'Olimex.

6. En cas de problème

• La clé n'est pas lue (USB Storage (no key), MSC filesystem mount failed) : vérifiez le format FAT32, essayez une clé USB 2, un autre hub, et l'alimentation par bloc secteur.
• Écran noir : certains écrans et adaptateurs posent problème (voir la FAQ d'Olimex) ; en mode vidéo 1, un changement de mode ramène l'image.
• Le menu boot/ n'apparaît pas : sans dossier boot/ sur la clé, il n'y a pas de menu ; si vous appuyez sur Échap, l'écran indique Boot : pas de boot/ -> NeoDOS.

Sinon, signalez le problème sur le dépôt de Trinity (version, matériel, ce qui s'affiche), ou écrivez-nous.

Voir aussi : la page Trinity · la référence de l'API · les logiciels Neo6502.