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 28/05/2021 20:40 | #
<gint/usb.h> est présent depuis gint 2.4.0 (ie. la release d'avant), et fxlink fait partie du fxSDK aussi depuis cette release, donc ta mise à jour n'a pas dû marcher.
Si tu n'es pas sur une branche, tu peux toujours faire
Au passage le code que j'ai donné dans le post ci-dessus n'est pas un copier/coller, il faut le lire et le comprendre - tu n'as même pas déclaré la variable key, ça ne risque pas de marcher.
Citer : Posté le 28/05/2021 20:43 | #
Ah, merci !
J'ai une erreur :
A required package was not found
Call Stack (most recent call first):
/usr/local/share/cmake-3.18/Modules/FindPkgConfig.cmake:733 (_pkg_check_modules_internal)
CMakeLists.txt:13 (pkg_check_modules)
-- Configuring incomplete, errors occurred!
See also "/home/utilisateur/.local/share/giteapc/Lephenixnoir/fxsdk/build/CMakeFiles/CMakeOutput.log".
make: *** [giteapc.make:12: configure] Error 1
error: error 2 in command: make -f giteapc.make configure
Citer : Posté le 28/05/2021 20:46 | #
Tu as omis la partie la plus importante, qui est au-dessus. Et tu es sûr que la mie à jour a marché ?
Citer : Posté le 28/05/2021 20:52 | #
Meme erreur lors de la mise à jour.
Citer : Posté le 28/05/2021 20:53 | #
Ah mais c'est un erreur lors de la mise à jour, pardon. Et donc, la partie la plus importante, qui est au-dessus ?
Explique-moi ce que tu as compris de cette erreur.
Citer : Posté le 28/05/2021 20:59 | #
Un package n'est pas installé, mais lequel ? Comment l'installer ?
Citer : Posté le 28/05/2021 21:03 | #
Lequel, c'est noté au-dessus (de la partie que tu as copiée).
Citer : Posté le 28/05/2021 21:05 | #
Alors, c'est udisks2. Comment l'installer ?
Citer : Posté le 28/05/2021 21:07 | #
La question d'abord c'est si tu veux l'installer. udisks2 c'est l'utilitaire qui monte les clés USB (et Graph 35+E II et Graph 90+E) sur la plupart des distros. Le paquet que tu n'as pas c'est la lib qui permet de communiquer avec udisks2. La première chose à déterminer c'est si tu as udisks2 sur ton PC, parce que si tu ne l'as pas ça ne sert à rien d'installer la lib.
Tu peux déterminer si udisks2 est utilisé en lançant la commande udisksctl, si tu as une aide c'est que l'outil est utilisé sur ton PC, sinon non.
Citer : Posté le 28/05/2021 21:12 | #
J'ai une aide, donc udisk2 est installé. Comment faire ensuite ?
Citer : Posté le 28/05/2021 21:19 | #
Ça dépend de ta distribution, sous Debian et dérivés (Ubuntu, Mint, etc.) je crois que le paquet à installer est libudisks2-dev.
Note qu'il y a aussi une option dans le fxSDK pour désactiver les fonctionnalités udisks2, c'est l'alternative (mais moins bien).
Citer : Posté le 28/05/2021 21:21 | #
Alors. J'ai un problème avec mon installation via apt install qui est là depuis longtemps, y a pas un autre moyen de faire ca ?
Citer : Posté le 28/05/2021 21:29 | #
Tu peux désactiver les fonctionnalités udisks2 en installant le fxSDK comme ça
Citer : Posté le 28/05/2021 21:30 | #
Erreur :
File "/home/utilisateur/.local/bin/giteapc", line 150, in <module>
sys.exit(main(sys.argv[1:], commands))
File "/home/utilisaateur/.local/bin/giteapc", line 145, in main
return commands[argv[0]]["function"](*data, **options)
File "/home/utilisateur/.local/lib/giteapc/giteapc/repo.py", line 374, in install
build(*plan, install=True)
File "/home/utilisateur/.local/lib/giteapc/giteapc/repo.py", line 291, in build
r.set_config(s.config)
File "/home/utilisateur/.local/lib/giteapc/giteapc/repos.py", line 156, in set_config
os.symlink(target, source)
FileExistsError: [Errno 17] File exists: '/home/utilisateur/.local/share/giteapc/Lephenixnoir/fxsdk/giteapc-config-noudisks2.make' -> '/home/utilisateur/.local/share/giteapc/Lephenixnoir/fxsdk/giteapc-config.make'
Citer : Posté le 28/05/2021 21:52 | #
J'ai mis à jour la branche master du fxSDK (ce qui explique pourquoi t'avais pas fxlink lol), réessaie s'il te plaît. Vérifie qu'il pull bien le fxSDK avant de reconfigurer et ça devrait aller.
Citer : Posté le 28/05/2021 21:56 | #
Et dans la catégorie des erreurs chiantes, veuillez applaudir (et flemme de masquer mon prénom pour "utilisateur", je mets mon vrai nom de session) :
collect2: error: ld returned 1 exit status
make[3]: *** [CMakeFiles/fxg1a.dir/build.make:180: fxg1a] Error 1
make[3]: Leaving directory '/home/orian/.local/share/giteapc/Lephenixnoir/fxsdk/build'
make[2]: *** [CMakeFiles/Makefile2:153: CMakeFiles/fxg1a.dir/all] Error 2
make[2]: Leaving directory '/home/orian/.local/share/giteapc/Lephenixnoir/fxsdk/build'
make[1]: *** [Makefile:149: all] Error 2
make[1]: Leaving directory '/home/orian/.local/share/giteapc/Lephenixnoir/fxsdk/build'
make: *** [giteapc.make:15: build] Error 2
error: error 2 in command: make -f giteapc.make build
Citer : Posté le 28/05/2021 21:58 | #
Ton fxSDK était même pas à jour en arrivant ici du coup. C'est un reste de compilation pré-CMake, chiant mais au moins le fix est simple.
# ensuite on relance giteapc
Désolé pour le détour, ce problème-là c'est moi.
Citer : Posté le 28/05/2021 21:59 | #
Héhé, ca marche !
Merci !
...mais non, toujours l'erreur de fatal error: gint/usb.h: No such file or directory
Ajouté le 28/05/2021 à 22:17 :
(Pas de problème pendant l'update)
Citer : Posté le 28/05/2021 22:19 | #
Tu as mis à jour gint aussi ? Quand tu as eu l'erreur sur le fxSDK on s'est concentrés sur le fxSDK mais il ne faut pas oublier gint non plus.
Citer : Posté le 28/05/2021 22:26 | #
Ca marche, merci !
Citer : Posté le 30/05/2021 14:59 | #
J'ai refait quelques tentatives sur la compilation de la lib standard C++, mais ça reste très compliqué parce qu'il fait tout comme si c'était du hosted et c'est vraiment pas facile à gérer.
Ninestars, si tu as l'occasion de venir discuter pour Windmill je veux bien.