Ce dépôt est un modèle (template) pour le développement de logiciels et de jeux pour le Thomson MO5 en langage C.
Il automatise l'installation de l'environnement, la gestion du SDK et la création d'images disques bootables.

• src/ : Contient le code source de votre application (ex: main.c).
• tools/ : Répertoire généré contenant le SDK (bibliothèques et headers) ainsi que les utilitaires de conversion.
• bin/ : Contient l'exécutable .BIN après compilation.
• output/ : Contient les images disquettes finales au format .fd et .sd.

• CMOC : Le compilateur C pour processeur 6809.
• Git : Requis pour cloner les outils de dépendance lors de l'installation.
• Python 3 / Pillow : Requis pour les scripts de conversion (fd2sd.py et png2mo5.py).

Si vous utilisez GitHub Codespaces, vous pouvez installer automatiquement tous les prérequis avec :

make setup-codespace

Cette commande installe :

• flex (requis pour lwtools)
• Pillow (bibliothèque Python pour la conversion d'images)
• lwtools (assembleur 6809)
• CMOC (compilateur C pour 6809)
• Python 3 / Pillow : Requis pour le script de traitement d'image png2mo5.py.

Ouvrez le fichier Makefile à la racine du projet et modifiez la variable suivante pour définir le nom de votre programme :

PROGRAM := MYAPP

(Remplacez MYAPP par le nom souhaité.)

Avant de compiler pour la première fois, lancez la commande suivante pour configurer le SDK et les outils système :

make install

Cette commande :

• télécharge et compile le sdk_mo5, sdk permettant de faciliter le développement sur Thomson MO5. Le sdk inclus aussi des scripts python permettant de générer les fichiers disquettes du type fd et sd (compatible avec SDDrive) 👉 https://github.com/thlg057/sdk_mo5.git
• exporte l'ensemble des fichiers nécessaires dans le dossier tools/

Pour générer votre programme et les images disques, utilisez simplement :

make

Cette action va compiler votre code source, le lier à la bibliothèque SDK et créer les images disquette (.fd et .sd) dans le dossier output/.

Le SDK mo5_sdk s'appuie sur le code helper du projet sdk_mo5, qui regroupe un ensemble de fonctions que j’ai développées pour simplifier et accélérer le développement sur Thomson MO5.

Pour utiliser ces fonctions dans votre code, incluez les fichiers d'en-tête exportés :

#include <mo5_stdio.h>
#include <mo5_defs.h>

Le Makefile s'occupe automatiquement d'inclure les chemins (-Itools/include) et de lier la bibliothèque statique (tools/lib/libsdk_mo5.a) lors de la compilation.

Le projet inclut un script Python qui transforme une image PNG en fichier .h contenant la définition C du sprite correspondant.

Pour convertir une image :

make convert IMG=./assets/sprite.png

Cette commande :

• Analyse l'image PNG et détecte automatiquement les couleurs (2 couleurs par groupe de 8 pixels)
• Génère automatiquement le fichier include/assets/sprite1.h avec la définition du sprite
• Crée les répertoires nécessaires si besoin
• Préserve la structure de dossiers (ex: ./assets/perso/hero.png → ./include/assets/perso/hero.h)

Le fichier généré contient :

• Les données de FORME (bitmap 1 bit/pixel)
• Les données de COULEUR (attributs par groupe de 8 pixels)
• Les commentaires avec visualisation ASCII du sprite

Vous pouvez ensuite inclure le fichier généré dans votre code :

#include "assets/sprite1.h"

• make clean : Supprime les fichiers de build du projet (fichiers objets, binaires et images disques).
• make clean-all : Supprime tout le projet ainsi que le dossier tools/ (SDK et outils inclus).

Ce template est conçu pour fonctionner avec le Model Context Protocol (MCP).
Branchez votre agent IA (Claude Desktop, Cursor, Augment…) sur la base de connaissances MO5, et il devient instantanément expert : 6809, CMOC, SDK, patterns de développement jeu vidéo, etc.

Ajoutez simplement ceci dans le fichier de configuration de votre agent :

{
  "mcpServers": {
    "mo5-rag": {
      "command": "npx",
      "args": ["-y", "@thlg057/mo5-rag-mcp"],
      "env": {
        "RAG_BASE_URL": "https://retrocomputing-ai.cloud"
      }
    }
  }
}

Pas d'installation, pas de chemin à configurer. npx télécharge et lance le serveur à la volée. 🎉

Des exemples de fichiers de configuration pour Claude Desktop, Cursor et Augment sont disponibles dans le dossier .mcp-templates/.

• 🛠️ SDK MO5 : https://github.com/thlg057/sdk_mo5
• 📦 Ce template : https://github.com/thlg057/mo5_template
• 🤖 Serveur MCP : https://www.npmjs.com/package/@thlg057/mo5-rag-mcp
• 🌐 Base de connaissances : https://retrocomputing-ai.cloud