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 08/05/2020 21:13 | #
Merci ! Tu peux juste demander la branche compat et ce sera bon pour l'instant
Citer : Posté le 08/05/2020 22:00 | #
Nope justement, cf le lien que j'ai mis avec
Citer : Posté le 08/05/2020 22:15 | #
Je vois pas le problème. Ton lien dit explicitement que tu peux mettre la branche.
Citer : Posté le 09/05/2020 12:50 | #
guint est-il compatible avec les casio 75+ ?
Citer : Posté le 09/05/2020 13:14 | #
Yup, entièrement compatible et supporté, je teste d'ailleurs sur ma Graph 75+E la plupart du temps
Citer : Posté le 09/05/2020 13:54 | #
mais il n'est disponible que sur linux pour l'instant ?
Citer : Posté le 09/05/2020 13:58 | #
Oui. Mais si tu connais Windows assez bien, tu dois pouvoir l'utiliser sans problème avec WSL. J'attends un peu de feedback pour savoir à quel point ça marche... pour l'instant, personne n'a testé en profondeur.
Citer : Posté le 09/05/2020 14:01 | #
ok merci
Citer : Posté le 09/05/2020 14:47 | #
Salut
J'ai installé gint avec WSL2 (Ubuntu). Tout fonctionne très bien avec un peu de débrouille, quelques infos (utiles ?) :
La partie mkg3a peut être un peu confuse, taricorp a déplacé son dépôt, peut-être vaudrait-il mieux linker le Gitlab directement ? https://gitlab.com/taricorp/mkg3a
Citer : Posté le 10/05/2020 11:41 | #
Merci ! J'ai ajouté la compatibilité WSL au tutoriel de compilation de GCC, qui est le plus important pour l'instant.
Je vais voir pour mkg3a, je finirai par intégrer un outil "fxg3a" au fxSDK. Pour l'instant le Gitlab est down (en maintenance ?), mais c'est noté, merci beaucoup.
Citer : Posté le 10/05/2020 15:28 | #
Mmh, le Gitlab de tarik va très bien oO
Au passage, il a update le paquet mkg3a sur l'AUR, donc vous pouvez l'installer par ce biais
Citer : Posté le 16/05/2020 17:36 | #
Un peu de nouveau aujourd'hui, j'ai ajouté le retour au menu sur Graph 90. Appuyez sur MENU pendant getkey() ou appelez gint_osmenu() et hop, voilà le menu principal
Contrairement à la Graph mono par contre, quand vous revenez dans l'add-in la barre de statut s'affiche. Yikes. Je ne possède pas de solution technique à ce problème, donc pour l'instant il va falloir faire avec. x_x
J'ai aussi ajouté les syscalls BFile sur Graph 90, comme sur Graph mono ça a tendance à crasher je ne sais pas trop pourquoi. Du coup j'ai commencé à tester mon tout nouveau gint_switch(), la fonction qui sort de gint pour revenir à l'OS et qui permet notamment de revenir au menu principal, pour gérer ça. Pour l'instant ça a l'air de marcher pas mal : si on sort de gint pour utiliser BFile ça se passe bien. J'ai bon espoir que ça va stabiliser tout le bordel. Accessoirement, ce sera une bonne piste pour implémenter un jour un système de fichiers en RAM qui fonctionne mieux que BFile.
Ajouté le 21/05/2020 à 10:41 :
J'ai mis à jour la partie mkg3a du README sur la branche dev et modifié le lien pour aller sur son Gitlab.
Citer : Posté le 29/05/2020 18:57 | #
J'ai un problème en essayant de compiler gint:
No prefix specified, let's ask the compiler:
sh-elf-gcc --print-search-dirs | grep install | sed 's/install: //'
Got '/home/leno/opt/sh-elf-2.34-9.3.0/lib/gcc/sh3eb-elf/9.3.0/'.
Configuration saved in Makefile.cfg, ready to make!
leno@laptop:~/opt/gint/build.cg$ sudo make
-e > gcc core/bootlog.c
make: sh-elf-gcc: Command not found
make: *** [Makefile:104: src/core/bootlog.c.o] Error 127
Voici mon path:
Citer : Posté le 29/05/2020 19:07 | #
Tu ne dois ni compiler ni installer gint avec sudo
Citer : Posté le 29/05/2020 19:33 | #
Quand je ne suis pas en Sudo, j’ai une erreur d’accès refusé...
Citer : Posté le 29/05/2020 19:45 | #
Es-tu sûr d'avoir installé sh-elf-gcc ? Et es-ce qu'il est bien dans ton path ? (Tu peux tester ça simplement en essayant sh-elf-gcc --version, si tu as une erreur, revois les deux point que j'ai énoncé plus haut
Citer : Posté le 29/05/2020 19:52 | #
Effectivement la commande "elf-gcc --version" n'existe pas...
Quel fichier dois-je ajouter à mon path ?
Citer : Posté le 29/05/2020 20:48 | #
Yatis, le problème c'est que sudo ne récupère pas les variables d'environnement (donc pas le PATH). Il faut vraiment rester en user.
Leno, quelle erreur d'accès refusé ? Tu l'as installé où/comment ton GCC ?
Citer : Posté le 29/05/2020 21:42 | #
En Sudo aussi...
Citer : Posté le 29/05/2020 21:45 | #
Sinon sudo chmod -R 777 /
Askip ça règle tous les problèmes d'accès refusés
C'est un troll, au cas où
Citer : Posté le 29/05/2020 21:59 | #
Avec cette commande, je n’ai pas besoin de tout réinstaller ?