gint : un noyau pour développer des add-ins
Posté le 20/02/2015 17:30
Ce topic fait partie de la série de topics du fxSDK.
En plus des options de programmation intégrée comme le Basic Casio ou Python, la plupart des calculatrices Casio supportent des
add-ins, des programmes natifs très polyvalents avec d'excellentes performances. Les add-ins sont généralement programmés en C/C++ avec l'aide d'un ensemble d'outils appelé SDK.
Plusieurs SDK ont été utilisés par la communauté avec le temps. D'abord le
fx-9860G SDK de Casio avec fxlib pour Graph monochromes (plus maintenu depuis longtemps). Puis le
PrizmSDK avec libfxcg pour Prizm et Graph 90+E (encore un peu actif sur Cemetech). Et plus récemment celui que je maintiens, le
fxSDK, dont gint est le composant principal.
gint est un unikernel, ce qui veut dire qu'il embarque essentiellement un OS indépendant dans les add-ins au lieu d'utiliser les fonctions de l'OS de Casio. Ça lui permet beaucoup de finesse sur le contrôle du matériel, notamment la mémoire, le clavier, l'écran et les horloges ; mais aussi de meilleures performances sur le dessin, les drivers et la gestion des interruptions, plus des choses entièrement nouvelles comme le moteur de gris sur Graph monochromes.
Les sources de gint sont sur la forge de Planète Casio :
dépôt Gitea Lephenixnoir/gint
Aperçu des fonctionnalités
Les fonctionnalités phares de gint (avec le fxSDK) incluent :
- Toutes vos images et polices converties automatiquement depuis le PNG, sans code à copier (via fxconv)
- Un contrôle détaillé du clavier, avec un GetKey() personnalisable et un système d'événements à la SDL
- Une bibliothèque standard C plus fournie que celle de Casio (voir fxlibc), et la majorité de la bibliothèque C++
- Plein de raccourcis pratiques, comme pour afficher la valeur d'une variable : dprint(1,1,"x=%d",x)
- Des fonctions de dessin, d'images et de texte optimisées à la main et super rapides, surtout sur Graph 90+E
- Des timers très précis (60 ns / 30 µs selon les cas, au lieu des 25 ms de l'OS), indispensables pour les jeux
- Captures d'écran et capture vidéo des add-ins par USB, en temps réel (via fxlink)
Avec quelques mentions spéciales sur les Graph monochromes :
Un moteur de gris pour faire des jeux en 4 couleurs !
La compatibilité SH3, SH4 et Graph 35+E II, avec un seul fichier g1a
Une API Unix/POSIX et standard C pour accéder au système de fichiers (Graph 35+E II seulement)
Et quelques mentions spéciales sur les Graph 90+E :
Une nouvelle police de texte, plus lisible et économe en espace
Le dessin en plein écran, sans les bordures blanches et la barre de statut !
Un driver écran capable de triple-buffering
Une API Unix/POSIX et standard C pour accéder au système de fichiers
Galerie d'add-ins et de photos
Voici quelques photos et add-ins réalisés avec gint au cours des années !
Arena (2016) — Plague (2021)
Rogue Life (2021)
Momento (2021)
Communication avec le PC (cliquez pour agrandir)
Utiliser gint pour développer des add-ins
Les instructions pour installer et utiliser gint sont données dans les divers tutoriels recensés dans le
topic du fxSDK. Il y a différentes méthodes de la plus automatique (GiteaPC) à la plus manuelle (compilation/installation de chaque dépôt). Le fxSDK est compatible avec Linux, Mac OS, et marche aussi sous Windows avec l'aide de WSL, donc normalement tout le monde est couvert
Notez en particulier qu'il y a des
tutoriels de développement qui couvrent les bases ; tout le reste est expliqué dans les en-têtes (fichiers
.h) de la bibliothèque que vous pouvez
consulter en ligne, ou dans les ajouts aux changelogs ci-dessous.
Changelog et informations techniques
Pour tester les fonctionnalités et la compatibilité de gint, j'utilise un add-in de test appelé gintctl (
dépôt Gitea Lephenixnoir/gintctl). Il contient aussi une poignée d'utilitaires d'ordre général.
Ci-dessous se trouve la liste des posts indiquant les nouvelles versions de gint, et des liens vers des instructions/tutoriels supplémentaires qui accompagnent ces versions.
Anecdotes et bugs pétés
Ô amateurs de bas niveau, j'espère que vous ne tomberez pas dans les mêmes pièges que moi.
TODO list pour les prochaines versions (2023-04-03)
gint 2.11
- Changements de contextes CPU. À reprendre du prototype de threading de Yatis pour permettre l'implémentation d'un véritable ordonnanceur. Demandé par si pour faire du threading Java.
- Applications USB. Ajouter le support de descripteurs de fichiers USB. Potentiellement pousser jusqu'à avoir GDB pour debugger.
- Support de scanf() dans la fxlibc. Codé par SlyVTT, plus qu'à nettoyer et fusionner.
Non classé
- Regarder du côté serial (plus facile que l'USB) pour la communication inter-calculatrices (multijoueur) et ultimement l'audio (libsnd de TSWilliamson).
- Un système pour recompiler des add-ins mono sur la Graph 90+E avec une adaptation automatique.
- Support des fichiers en RAM pour pouvoir utiliser l'API haut-niveau sur tous les modèles et éviter la lenteur de BFile à l'écriture quand on a assez de RAM.
Citer : Posté le 11/04/2021 20:49 | #
Ok merci pour l'explication, en tout cas Youhu ! Plus aucun message d'erreur !!
C'est bien parce que j'apprends comment marche git au passage
En effet, je pensais que tu t'étais trompé dans les chemins, quand je supposais que le prefix était bon c'était dans CASIO/fxsdk/fxsdk/fxsdk.sh
Du coup là j'ai bien un fichier dans CASIO/fxsdk/build/fxsdk.sh avec le bon prefix : .../CASIO
Ok donc le fxsdk c'est tout bon. Maintenant Gint !
Donc là j'ai fait
cd gint
export PATH="$PATH:/Users/olivier/Documents/CASIO/bin"
Ensuite
Could not find toolchain file: /lib/cmake/fxsdk/FX9860G.cmake
Call Stack (most recent call first):
CMakeLists.txt:4 (project)
CMake Error: CMake was unable to find a build program corresponding to "Unix Makefiles". CMAKE_MAKE_PROGRAM is not set. You probably need to select a different build tool.
CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
CMake Error: CMAKE_ASM_COMPILER not set, after EnableLanguage
-- Configuring incomplete, errors occurred!
Citer : Posté le 11/04/2021 20:58 | #
C'est pas top, tu devrais indiquer un chemin absolu, parce que tu ne seras pas dans le même dossier quand tu lanceras la compilation !
C'est d'ailleurs pour ça que ça ne marche pas encore quand tu tentes de compiler gint.
Citer : Posté le 11/04/2021 21:08 | #
Autant pour moi, c'était pour ne pas tout écrire, j'ai bien un chemin absolu :
PREFIX=/Users/olivier/Documents/CASIO
Citer : Posté le 11/04/2021 21:16 | #
Tu as bien /Users/olivier/Documents/CASIO/lib/cmake/fxsdk avec des fichiers CMake dedans ?
Citer : Posté le 11/04/2021 21:20 | #
Oui, 7 fichiers Cmake dedans
Citer : Posté le 11/04/2021 21:31 | #
Atta mais comment il peut sortir ça ?
Alors que le chemin c'est ça
et que le PREFIX est un chemin valide ? x)
Citer : Posté le 11/04/2021 22:53 | #
J'ai même essayé en écrivant en dur à la ligne 173 et c'est exactement pareil
Citer : Posté le 11/04/2021 23:05 | #
Wtf. Tu as bien réinstallé à chaque fois que tu as modifié (ou alors modifié directement dans Documents/CASIO/bin/fxsdk) ?
Si c'est le cas alors ça va être un peu la merde. Tu peux aussi essayer de taper la commande directement :
(y'a pas tous les arguments mais déjà si tu arrives à lui faire trouver le fichier de toolchain la suite devrait aller)
Au passage vérifie que le fichier exact que tu passes existe bien, on sait jamais.
Citer : Posté le 12/04/2021 21:09 | #
... Je suis perdu entre ce que j'ai fais et pas fait au final. J'ai tout supprimé ce qui avait à trait avec fxsdk. En fait j'ai laissé que bin utils et gcc.
Je ferme tout, je redémarre,
je change le ssd de mon ordi,et ensuite j'ai réinstallé fxsdk :git clone "https://gitea.planet-casio.com/Lephenixnoir/fxsdk.git"
cd fxsdk
git checkout dev
cmake -B build -DCMAKE_INSTALL_PREFIX="/Users/olivier/Documents/CASIO" -DFXLINK_DISABLE_UDISKS2=1
make -C build install
la ligne 4 de CASIO/bin/fxsdk est "PREFIX=/Users/olivier/Documents/CASIO"
la ligne 4 de CASIO/fxsdk/fxsdk/fxsdk.sh est "PREFIX=@FXSDK_PREFIX@"
Ensuite :
git clone "https://gitea.planet-casio.com/Lephenixnoir/gint.git"
cd gint
fxsdk build-fx
Could not find toolchain file: /lib/cmake/fxsdk/FX9860G.cmake
Call Stack (most recent call first):
CMakeLists.txt:4 (project)
CMake Error: CMake was unable to find a build program corresponding to "Unix Makefiles". CMAKE_MAKE_PROGRAM is not set. You probably need to select a different build tool.
CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
CMake Error: CMAKE_ASM_COMPILER not set, after EnableLanguage
-- Configuring incomplete, errors occurred!
Voilà où j'en suis
Citer : Posté le 12/04/2021 21:11 | #
Wtf encore une fois. Tu peux essayer la commande que je t'ai passée précédemment dans le dossier de gint ? Pour "nettoyer" après ce test, il te suffira de supprimer build-fx.
Citer : Posté le 12/04/2021 21:15 | #
Ok, j'ai entré ta dernière commande dans gint et voici
-- The C compiler identification is unknown
-- The ASM compiler identification is unknown
-- Didn't find assembler
CMake Error at CMakeLists.txt:4 (project):
The CMAKE_C_COMPILER:
sh-elf-gcc
is not a full path and was not found in the PATH.
Tell CMake where to find the compiler by setting either the environment
variable "CC" or the CMake cache entry CMAKE_C_COMPILER to the full path to
the compiler, or to the compiler name if it is in the PATH.
CMake Error at CMakeLists.txt:4 (project):
No CMAKE_ASM_COMPILER could be found.
Tell CMake where to find the compiler by setting either the environment
variable "ASM" or the CMake cache entry CMAKE_ASM_COMPILER to the full path
to the compiler, or to the compiler name if it is in the PATH.
Citer : Posté le 12/04/2021 21:26 | #
Une chose à la fois, du coup. Le premier problème c'est pourquoi quand tu lances fxsdk build-fx la commande ne charge pas le bon $PREFIX. Ça va être chiant à debugger mais il faut bien en passer par là.
Est-ce que tu peux me mettre un « echo "PREFIX = $PREFIX" » après la ligne 4, avant la ligne 171, refaire le make install dans le fxSDK, supprimer build-fx dans gint et refaire fxsdk build-fx, histoire de voir si la variable passe correctement ?
Pour l'autre erreur, oui il te manque un bout de ton PATH. Le export que tu as fait dans ce message sert à ça, mais ça ne persiste pas quand tu fermes ton terminal donc il faut le refaire à chaque fois (pour le rendre permanent faut voir dans ~/.bashrc ou un truc comme ça, pour Mac je sais pas faut que tu te renseignes).
Je pars aussi du principe que les différences sur les chemins (slash en plus/moins, variations sur ton dossier utilisateur) sont juste du copier/coller et que tous les dossiers en Documents/CASIO sont identiques.
Citer : Posté le 12/04/2021 21:49 | #
J'ai ajouté les deux echo dans CASIO/fxsdk/fxsdk/fxsdk.sh (j'ai vérifié 3 fois XD)
et j'ai aucun retour de echo dans la console, exactement le même message
Could not find toolchain file: /lib/cmake/fxsdk/FX9860G.cmake
Call Stack (most recent call first):
CMakeLists.txt:4 (project)
CMake Error: CMake was unable to find a build program corresponding to "Unix Makefiles". CMAKE_MAKE_PROGRAM is not set. You probably need to select a different build tool.
CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
CMake Error: CMAKE_ASM_COMPILER not set, after EnableLanguage
-- Configuring incomplete, errors occurred!
Ok pour l'autre erreur.
Et pour les chemins utilisateur, c'est que je retire mon nom de famille à la main quand je colle ici
Citer : Posté le 12/04/2021 21:52 | #
Si tu n'as pas de retour de echo dans la console c'est probablement que tu n'as pas réinstallé le script... après avoir refait le make install tu dois avoir les modifications aussi dans CASIO/fxsdk/build/fxsdk.sh (la version où le PREFIX est inséré) et dans CASIO/bin/fxsdk (la version installée).
Citer : Posté le 12/04/2021 21:57 | #
Si j'ai bien réinstallé en suivant toutes tes instructions.
Et... désolé XD mais dans CASIO/bin/fxsdk il y a bien les deux echo !!!
Ajouté le 12/04/2021 à 23:39 :
Bon, pour compléter nos échanges d'hier sur la shout, pour le dernier point, c'était une faute de frappe fxdsk build-fx
Donc là je lance fxsdk build-fx et il y a déjà du mieux !
PREFIX = /Users/olivier/Documents/CASIO
...tout un tas de de building...
File "/Users/olivier/Documents/CASIO/bin/fxconv.py", line 11, in <module>
from PIL import Image
ModuleNotFoundError: No module named 'PIL'
Donc là il me manque pillow, je regarde pour installer ça et j'édite ce poste
PS : j'ai compris comment ça marche pour le PATH et surtout les : en jetant un oeil avec env
Citer : Posté le 12/04/2021 23:42 | #
FYI : https://www.planet-casio.com/Fr/programmation/tutoriels.php?id=93
Citer : Posté le 13/04/2021 00:25 | #
Très intéressant, ça m'a bien éclairé merci Dark et le rédacteur de l'article (Lephé j'imagine)
Ajouté le 13/04/2021 à 23:04 :
Ah nan mais c'est l'enfer, chaque truc que je fais soulève autre chose. Il me faut python 3.7 car pillow bug à l'install sur 2.7.
Mais là j'ai un bug à l'installation de python 3.7
Ça commence sérieusement à m'énerver tout ça je tape des lignes dans la console depuis 3 jours
Bon allé je continue quand même
Citer : Posté le 13/04/2021 23:10 | #
Python 2.7 est définitivement (et officiellement) mort, là il n'y a rien à faire. Aujourd'hui ne pas avoir Python 3 c'est presque ne pas avoir Python du tout... je ne sais pas trop comment tu as réussi à avoir le 2.7 mais pas le 3. ^^"
Citer : Posté le 13/04/2021 23:13 | #
T'as pas installé brew sur ton mac ? sudo brew install python3 c'est pourtant pas si compliqué <_<
Citer : Posté le 13/04/2021 23:14 | #
Booonnn j'ai réussi
Là j'ai fais
blabla
[100%] Built target gint-fx
Citer : Posté le 13/04/2021 23:15 | #
Impeccable ! Maintenant fxsdk build-fx install et tu peux passer à ton projet.