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 30/04/2021 18:57 | #
j'attends l'update avec l'USB,
ma patience craqueCiter : Posté le 30/04/2021 19:02 | #
Incroyable tout ça Je suis impatient de pouvoir tester cette update.
Est-ce que le côté ordi passe par udisks2 ? Si oui, il va falloir que je prenne le temps de m'y pencher sérieusement.
Citer : Posté le 30/04/2021 19:09 | #
Merci ! Non tout ça c'est par libusb, la partie UDisks2 c'est que pour accéder à la calto en mode clé USB dans l'application LINK officielle.
Citer : Posté le 30/04/2021 22:07 | #
Je vois déjà des supers projets à faire avec fxlink !
C’est excellent, bravo !
Citer : Posté le 30/04/2021 23:50 | # | Fichier joint
Merci ! Je pense que ce sera utile surtout comme "compagnon" pour prendre rapidement des screens et des vidéos, ou sauvegarder des logs. Je n'ai pas beaucoup d'autres idées de quoi faire avec... ! J'ai pensé à contrôler la calculatrice par le clavier de l'ordinateur mais ça demande plus de travail côté PC, je ne le coderai peut-être pas dans fxlink.
Sinon j'ai encore avancé un peu, et le code est dégueulasse parce qu'il est presque minuit, mais fxlink sauvegarde les screens en PNG !
Donc pour rappel j'ai lancé la connexion USB, là j'ai juste à appuyer sur OPTN dans le test USB de gintctl et pouf j'ai un piti fichier PNG qui apparaît par magie sur l'ordinateur
Citer : Posté le 01/05/2021 11:39 | # | Fichier joint
Pendant que j'y suis... on peut envoyer du texte aussi, et oui ça marche sur les Graph mono (SH4 seulement)
Citer : Posté le 01/05/2021 15:55 | #
Perso, j'aimerai avec fxlink pouvoir faire du debug, c'est à dire envoyer des valeurs numériques, style des float, double, int, ... pour connaitre la valeur de certaines variables en temps réelle pendant l'execution.
Ça ça serait maxi top ! Et le truc parfait ça serait pas que les valeurs se mettent les une a la suite des autres dans la console, mais que l'on puisse donner en plus un id à chaque variable. Cette id permettrait de visuellement écrire par dessus l'ancienne valeur affichée. On s'y retrouve mieux.
Je dois pas être clair du tout
Citer : Posté le 01/05/2021 15:57 | #
Il y a un double problème avec ça ; d'une part tu dois envoyer les données et une description de leur type en même temps, ce qui requiert tout un autre protocole (à moins que tu passes le tout à printf() sur la calto et que tu envoies que le texte). D'autre part pour faire un affichage plus subtil qu'un truc qui se déroule dans le terminal il faudrait coder une TUI ou une GUI (ce que tu peux faire, mais ce sera probablement pas built-in).
Idéalement y'aurait le debugger à la Yatis + GDB qui serait immensément plus puissant.
Citer : Posté le 01/05/2021 16:24 | #
Oui, ça pourrait être un argument type printf, une str.
Ok ok, je vois, plus complexe que ça en a l'air
Citer : Posté le 01/05/2021 18:33 | #
Du printf ça c'est possible facilement, il suffit de faire sprintf puis d'envoyer le message. C'est du debugging assez cru mais c'est sûr que c'est plus facile de lire le texte dans le terminal ou dans un fichier sur l'ordinateur qu'à l'écran de la calculatrice.
Citer : Posté le 04/05/2021 07:45 | #
Sinon, coté calto, comment on pourrait lire du PC?
Citer : Posté le 04/05/2021 07:52 | #
Pour l'instant je ne l'ai pas codé, mais en gros quand tu implémentes une interface tu fournis une structure avec des détails sur les pipes, les endpoits, les buffers etc., et dans le paquet il y a une fonction à donner pour répondre aux requêtes SETUP (pas encore implémenté) et une pour lire des données (pas encore codé non plus).
Selon l'endpoint où le PC écrit, les données sont envoyées à la bonne interface. Le plus difficile maintenant c'est que dans le cas de la pseudo-classe ff-buk que j'utilise pour l'instant, tu peux échanger des données soit en brut soit avec le mini-protocole fxlink, et à la réception je n'ai pas encore d'outil pour distinguer ces deux choses.
Citer : Posté le 05/05/2021 13:55 | # | Fichier joint
J'ai ajouté une fonctionnalité à gintctl qui me permet de prendre des screenshots partout où getkey() est utilisé. Et j'ai réussi à avoir des résutats assez scuffed du fait que les couleurs sont pas décodées correctement, ce que je ne voyais pas en noir et blanc
Edit: C'était un problème d'endianness.
Citer : Posté le 05/05/2021 14:14 | # | Fichier joint
Pendant que j'y suis, voilà des screenshots en gris.
Citer : Posté le 05/05/2021 14:40 | #
wow
Citer : Posté le 05/05/2021 14:50 | #
Génial,
Je vois pas, c’est quoi le problème avec les couleurs ? C'est stylé comme ça !
Citer : Posté le 05/05/2021 17:04 | #
Bravo ! C'est super !
Citer : Posté le 12/05/2021 09:21 | #
Nouveau patch : gint 2.4.1
Que des corrections de compilation et packaging.
Citer : Posté le 13/05/2021 14:01 | #
J'ai esayé d'update gint mais voila:
Citer : Posté le 13/05/2021 14:02 | #
Tu sembles avoir ajouté des modifications non-officielles dans ton dépôt. Il faut voir au cas par cas, mais un bon début serait :
% git status
% git diff
Citer : Posté le 13/05/2021 15:09 | # | Fichier joint
Bon, j'ai toujours le meme probleme, et j'ai retiré les changements
(bon apres un petit git restore)