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/12/2019 17:56 | #
Je voulais savoir si la transparence est gérée, ou pas ? Dans la version actuelle de Gint.
Merci d'avance !
Citer : Posté le 08/12/2019 17:58 | #
Absolument. Si tu es sur Graph monochrome, il faut convertir avec les profils mono_alpha ou gray_alpha. Si tu donnes à fxconv une image contenant des pixels transparents, il le fera automatiquement pour toi.
Sur Graph 90, il faut utiliser les profils r5g6b5a, p8 ou p4.
Citer : Posté le 08/12/2019 18:36 | #
Okay… J'ai pas très bien compris… je le met où le mono_alpha (c'est le blanc qui est transparent)…
Citer : Posté le 08/12/2019 18:37 | #
Tu le mets nulle part, tu enregistres ton image dans le dossier des images comme d'habitude, c'est tout.
Citer : Posté le 08/12/2019 18:39 | #
Donc j'ai le blanc en canal alpha, je met l'image en *.png comme d'habitude, mais où intervient la conversion ? (je suis avec ma Graph 35++) Comment je dit au compilateur que le blanc de cette image est transparent ? Il détecte tout seul le canal alpha ?
Citer : Posté le 08/12/2019 18:39 | #
Il faut qu'avec gimp l'image ait de la transparence
Projet de jeu multijoueur : 1V1 3D
Une lib de debug simple : la liblog
Citer : Posté le 08/12/2019 18:41 | #
Euh… Tu m'a perdu @Milang… mon image est un png avec le blanc en canal alpha… C'est bon ou il faut faire autrement ?
Citer : Posté le 08/12/2019 18:41 | #
Euh… Tu m'a perdu @Milang… mon image est un png avec le blanc en canal alpha… C'est bon ou il faut faire autrement ?
Si c'est alpha c'est transparent, donc ce n'est pas blanc... x)
Citer : Posté le 08/12/2019 18:43 | #
Oui mais ce que je veux dire c'est que c'est le blanc qui est transparent
Citer : Posté le 08/12/2019 18:44 | #
Si tu as utilisé la fonction "Calque » Transparence » Couleur vers alpha" alors ce n'est plus du blanc. Ça s'affiche comme un damier peu importe la couleur qu'il y avait avant.
Dans ce cas, tu l'enregistres en PNG et tu balances à fxconv.
Citer : Posté le 08/12/2019 18:48 | #
Oui c'est ça
Donc le seul truc qui change par rapport aux image non transparente c'est le canal alpha et c'est tout ? fxconv se démerde seul ? Quel est l'intérêt des deux fonctions que tu a donné tout à l'heure du coup ? (mono_alpha gray_alpha)
Citer : Posté le 08/12/2019 18:51 | #
Oui si tu donnes une image qui a un canal alpha et des pixels transparents, fxconv le détecte et utilise un profil de stockage approprié.
Dans gint sur Graph monochrome, il y a quatre profils de stockage d'images : noir et blanc (mono), pareil avec la transparence (mono_alpha), quatre niveaux de gris (gray) et quatre niveaux de gris avec la transparence (gray_alpha). Pour des raisons de compacité et d'optimisation, il vaut toujours mieux choisir le "plus petit" profil permettant de représenter l'image.
fxconv se débrouille pour le sélectionner automatiquement. S'il voit de la transparence, il prendra mono_alpha s'il n'y a pas de gris et gris_alpha s'il y en a. Et hop, c'est plié. Tu n'as rien d'autre à faire.
Citer : Posté le 08/12/2019 18:51 | #
Ok ! Merci !!
Ajouté le 08/12/2019 à 19:01 :
J'ai essayé avec Plague… Le fichier pieces.png comporte une partie transparente. Mais ça ne compile pas (je viens de mettre Gint à jour) et j'ai ce rapport :
fxconv -i assets-fx/img/pieces.png -o build-fx/assets/img/pieces.png.o --fx name:img_pieces
Traceback (most recent call last):
File "/Users/antoine/.local/bin/fxconv", line 130, in <module>
main()
File "/Users/antoine/.local/bin/fxconv", line 124, in main
fxconv.convert(input, params, target, output, model)
File "/Users/antoine/.local/bin/fxconv.py", line 668, in convert
convert_bopti_fx(input, output, params, target)
File "/Users/antoine/.local/bin/fxconv.py", line 246, in convert_bopti_fx
img = Image.open(input)
File "/usr/local/lib/python3.7/site-packages/PIL/Image.py", line 2705, in open
% (filename if filename else fp))
OSError: cannot identify image file 'assets-fx/img/pieces.png'
make: *** [build-fx/assets/img/pieces.png.o] Error 1
Citer : Posté le 08/12/2019 19:02 | #
La bibliothèque d'images de Python n'a pas réussi à lire ton image. Je sais pas avec quoi tu l'as enregistré (de la drogue ?). Tu devrais certainement retourner dans Gimp pour la réexporter proprement.
Citer : Posté le 08/12/2019 19:06 | #
Hey ça marche ! merci !!
Citer : Posté le 17/12/2019 09:14 | #
J'ai un messages d'erreur lorsque j'ai tenté de make gint
j'ai bien suivi les tutoriel pour gccet binutils à la lettre pourtant (j'ai tenté avec les option--whit-libssp et--with-lto)
>as core/exch. s
as: unrecognized option '-big'
make: *** [makefile:97: src/core/exch. s. o] error 1
une idée de ce que j'ai pus oublier ?
Citer : Posté le 17/12/2019 12:21 | #
Essaie sh-elf-as -big pour voir si ça donne une erreur (sinon ça attend du texte, tape C-C ou C-D pour produire un a.out vide). Voilà la version que j'ai compilée :
Citer : Posté le 17/12/2019 12:24 | #
hmmm... j'ai pas d'erreur XD
Ajouté le 17/12/2019 à 12:25 :
je crois que je sais pourquoi, un instant...
Citer : Posté le 17/12/2019 12:25 | #
Le fait que le message d'erreur affiche "as:" et non pas "sh-elf-as:" me laisse penser que tu compiles avec l'assembleur système.
As-tu bien spécifié --toolchain=sh-elf ?
N'hésite pas à lancer make VERBOSE=1 pour voir le détail des commandes.
Citer : Posté le 17/12/2019 12:29 | #
j'ai bien CONFIG. TOOLCHAIN=sh-elf dans mon makefile. cfg
Ajouté le 17/12/2019 à 13:04 :
j'ai trouvé
j'ai pas défini PREFFIX parce que je pensais qu'il était déjà dans mon. profile:'(
Ajouté le 17/12/2019 à 13:05 :
est-ce que je peux déplacer tout ça où il faut recompiler ?
Citer : Posté le 17/12/2019 13:12 | #
Une fois compilé, tu peux supprimer ton build-gcc et déplacer le reste des dossiers (y'a des bin/share/etc) à peu près où tu veux, typiquement /usr/local ou ~/.local.