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 29/08/2019 15:51 | #
Ouuups xD
C'est la fonction qui déclenche le gestionnaire d'erreur quand une erreur d'adresse se produit durant un transfert DMA. Je l'ai ajoutée récemment, mais quand j'ai commit la dernière fois j'ai séparé les modifs du DMA de celles du gestionnaires d'erreur, donc le commit est incomplet...
Et bien sûr j'ai testé dans mon environnement à moi où la fonction est fournie par gintctl et du coup je m'en suis pas rendu compte...
Ajouté le 03/09/2019 à 22:37 :
Voilà, j'ai poussé tout ce qu'il fallait, à savoir les gestionnaires d'exceptions. Tu devrais pouvoir compiler maintenant, puisque j'ai fait pointer l'erreur d'adresse du DMA dessus.
Désormais, si votre code fait une opération illégale, au lieu de crasher gint affiche un message d'erreur, exactement comme une System ERROR en fait.
Si vous rencontrez un crash, alors il y a probablement un bug et un rapport de bug est le bienvenu.
Je mettrai demain des images des erreurs en question.
Citer : Posté le 04/09/2019 11:11 | #
Génial ! j'intègre tout de suite le dma dans mon code, alors
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 05/09/2019 08:21 | # |
Fichier joint
Voici les photos promises des gestionnaires d'exception. D'abord sur Graph 90 :
Citer : Posté le 05/09/2019 08:22 | # |
Fichier joint
Et sur Graph mono :
C'est encore un peu brut de décoffrage mais ça fait le taf'.
Citer : Posté le 05/09/2019 09:43 | #
C'est fou comme c'est plus romancé dès qu'il y a un peu de place pour écrire les messages d'erreur
Bien joué en tout cas
Citer : Posté le 05/09/2019 13:02 | #
T'as vu hein, j'ai même la place pour mettre des infos spécifiques au type d'erreur. Impensable sur l'autre >_>
Citer : Posté le 05/09/2019 13:13 | #
À moins de prévoir un scrollbar dans l'affichage des erreurs
Citer : Posté le 05/09/2019 13:15 | #
Le problème c'est que tu ne peux pas vraiment, lors de l'affichage de ce message la calculatrice est bloquée dans le traitement d'une exception. Tu ne peux quasiment rien faire. Il faudrait un driver clavier particulier qui n'utilise pas les interruptions.
Citer : Posté le 05/09/2019 13:16 | #
Par contre, y'a indiqué 040 TLB… sur la G90, et le 040 disparaît sur la monochrome. Vu le placement et le fait que ce soit un n°, je pense que c'est le code de l'erreur, non ?
Si c'est le cas, il serait intéressant de l'avoir sur monochrome pour pouvoir chercher les détails dans une doc externe.
Et si c'est pas le cas, ce serait intéressant d'avoir un tel système de code d'erreur.
Citer : Posté le 05/09/2019 13:24 | #
Oui, c'est le code d'erreur. Je dois pouvoir l'ajouter dans un coin...
Citer : Posté le 05/09/2019 13:45 | #
Le problème c'est que tu ne peux pas vraiment, lors de l'affichage de ce message la calculatrice est bloquée dans le traitement d'une exception. Tu ne peux quasiment rien faire. Il faudrait un driver clavier particulier qui n'utilise pas les interruptions.
Tu sais que tu peux autoriser les interruptions dans ton handler d'exceptions (à condition de sauvegarder SPC (au minimum) avant d'autoriser à nouveau les interruptions) ? C'est ce que je fais (en gros résumé) pour gérer l'instruction TRAPA correctement
Citer : Posté le 05/09/2019 13:56 | #
Je savais qu'on pouvait faire ça dans une gestionnaire d'interruptions (en particulier pour pouvoir interrompre une interruption), mais j'avoue que c'est pas ma priorité pour afficher des messages de crash. Je préférerais debugger avec un fichier ou par USB
Citer : Posté le 05/09/2019 18:23 | #
à quand le système de log en ram qui écrit dans un fichier lors d'une system error ?
Ce système serait d'une très grande utilité lors de debuggage, ou pour les rapports de bug, par exemple
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 05/09/2019 18:26 | #
J'ai déjà fait ça une fois... le problème c'est que quand tu reset, ben la RAM pouf.
J'avais trouvé une zone pas trop volatile qui avait une probabilité raisonnable d'être intacte au redémarrage, et j'y inscrivais des logs. Mais ils se sont avérés inutiles parce que les problèmes qui se présentent sont trop tordus ou simplement issus de ma stupidité, et aucun log peut régler ça.
Donc j'ai supprimé la fonction à une époque. Je pense que logger par USB est une méthode bien plus prometteuse pour le futur ; mais cet avis n'est pas définitif.
Ajouté le 05/09/2019 à 19:05 :
Voilà, j'ai ajouté le code d'erreur en haut à droite dans la barre du haut.
Citer : Posté le 05/09/2019 20:40 | #
Personnellement je pensais à un log en ram, qui n'est enregistré/affiché que quand il y a une exception.
Donc le log ne ralentirait que très peu le programme de par l'utilisation de la ram au lieu de la memoire flash, mais laisserait la possibilité d'en avoir une trace.
Pour le log par usb, cela me semble être une bonne idée, mais cela limiterait le log au debuggage, et non dans le cas d'un rapport de bug
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 05/09/2019 21:58 | #
Admettons qu'on ait la place d'afficher un log complet. Qu'est-ce que mets dedans ? Des messages personnalisés définis par l'application ?
Citer : Posté le 06/09/2019 07:46 | #
Oui, c'est en partie ce à quoi je pensais, notamment si cela peut aider à définir la fonction qui est à l'origine des opérations illégales.
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 06/09/2019 08:39 | #
Hmm. À ce niveau de généralité autant que je laisse l'utilisateur spécifier quoi faire quand une exception se produit non ? Les photos que j'ai postées seraient le comportement par défaut. Si une autre fonction est spécifiée je réactive les interruptions ou bien je termine l'exception et je saute à cette fonction (via spc). La fonction ne doit jamais terminer.
Citer : Posté le 06/09/2019 10:10 | #
Dans ce cas je trouve que c'est très bonne idée !
La fonction ne doit jamais se terminer, c'est à dire ?
Si elle se termine, la calculatrice fait un reset instantanément ?
Une autre des questions que je me pose quant à la syntaxe de ces fonctions est sur les fonctions à utiliser :
faudra-t'il utiliser getkey, ou alors une boucle d'attente active sera obligatoire afin d'empécher d'autres interruptipns liéez aux timers ?
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 06/09/2019 10:21 | #
Si elle se termine, la calculatrice fait un reset instantanément ?
C'est l'idée. C'est pas comme si tu pouvais reprendre l'exécution après une exception sans la gérer de toute façon.
Une autre des questions que je me pose quant à la syntaxe de ces fonctions est sur les fonctions à utiliser :
faudra-t'il utiliser getkey, ou alors une boucle d'attente active sera obligatoire afin d'empécher d'autres interruptipns liéez aux timers ?
A priori je pense que tu pourras utiliser getkey(), toutefois si ta fonction a le malheur de provoquer une exception c'est la mort assurée. Donc moi tu appelles de choses mieux c'est.
Citer : Posté le 06/09/2019 10:26 | # |
Fichier joint
Tiens, j'ai eu un problème au moment de mettre à jour gint
Voici le contenu du terminal :
Il y a visiblement un problème de dépendances...
Je vais essayer de faire make clean mais je ne comprends pas, tout se passait bien avant....
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog