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 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)
Citer : Posté le 13/05/2021 15:12 | #
Tu as retiré les changements à quel point ? Si tu arrives à git pull sur le dépôt tout sera bon. Tu peux toujours fetch et ensuite te téléporter au bout de la branche en jetant les modifications, ou autres techniques usuelles. GiteaPC ne fait que git pull, tant que le git pull passe sans erreur tout ira bien.
Ajouté le 13/05/2021 à 15:13 :
Ah ça c'est un truc con. Il faut supprimer le dossier build du fxSDK. C'est un peu difficile à automatiser. >_>
Citer : Posté le 13/05/2021 16:14 | #
Bon, sinon Lephé, la fonction usb_fxlink_fill_header elle existe pas, ou elle est juste pas dans les headers des fichiers usb-*.h?
Si elle existe pas, quelles valeurs sont données aux variables de la structure header?
Citer : Posté le 13/05/2021 16:19 | #
Si tu veux utiliser l'USB, utilise la branche dev, où la fonction est documentée (et le protocole correctement implémenté).
Citer : Posté le 15/05/2021 09:42 | #
Bon j'ai reussi à avoir quelque chose qui ""marche"" mais quand je transfere des données de ma calc j'ai cette erreur(coté fxlink)
mais avant d'exit, je recevoit bien mon message
Et pour envoyer mon message je fais
//e est déja définit, ainsi que data, et le channel USB est ouvert avant d'envoyer me message
e = usb_write_sync(usb_ff_bulk_output(), data, 1, 4, true);
if(e == 0) usb_commit_sync(usb_ff_bulk_output());
usb_close();
Citer : Posté le 15/05/2021 15:22 | #
Le protocole fxlink actuel est très (trop) trivial et n'utilise pas d'endpoint interruption pour indiquer qu'un transfert est souhaité. Du coup, fxlink sur le PC passe son temps à demander des transferts qui timeout pour la plupart. Après avoir reçu ton message avec succès, il demande un autre transfert qui échoue lorsque le périphérique se fait déconnecter. La plupart du temps ça n'affiche pas de message d'erreur.
Là tu fermes la connexion immédiatement donc ce n'est pas surprenant. Mais bref, le transfert qui ne se fait pas c'est celui qui suit ton message, donc tout va bien, ton application marche.
Citer : Posté le 15/05/2021 18:12 | #
Ah ok!
Aussi j'ai essayé de faire un getChar(), mais bizzarement, ca skippe toujours le if(les autres fonctions ne posent pas de problemes de mes tests)
char readChar(void)
{
key_event_t event = getkey();
if (((event.mod) && (event.alpha)))//always skips this part, why?
{
return keyCodeToLetter(event.key);//Useless for the explanation, but it never gets executed when I press SHIFT
}
return keyCodeToNumber(event.key);//Always get run.
}
Citer : Posté le 15/05/2021 18:17 | #
Ça devrait être bon. Tu appuies bien une seule fois sur ALPHA et sans appuyer sur SHIFT pour le test (le commentaire parle de SHIFT) ?
Citer : Posté le 15/05/2021 18:21 | #
a non c'était une erreur de ma part pour le SHIFT dans mon commentaire
Et oui j'appuie bien sur alpha
Aussi, c'est comment j'utilise mon getChar
//bad way of #include here, but hey, it works!
int main(void) {
char* p = malloc(2);
char c = readChar();
*(p + 0) = c;
*(p + 1) = '\0';
dclear(C_WHITE);
dprint(1, 1, C_BLACK, p);
dupdate();
getkey();
free(p);
return 1;
}
Citer : Posté le 15/05/2021 18:37 | #
Merci. Durant une modification du fonctionnement du clavier j'ai modifié les options et je ne me suis pas rendu compte que mod n'était plus affecté à 1 (dans le nouveau fonctionnement c'est une information redondante). J'ai corrigé le bug sur dev, mais en attendant tu peux simplement ne pas tester la valeur de event.mod (elle vaut forcément 1 dans la spécification).
Citer : Posté le 21/05/2021 21:59 | #
Ladies and gentlemen, malgré plusieurs jours de code, des papiers de recherche, 280 lignes de code, et 69 cas de test, je réalise en testant d'autres choses que le %f de gint freeze sur la valeur 0. Comme quoi tout ce qui n'est pas testé explicitement n'est pas testé du tout. x)
Citer : Posté le 21/05/2021 23:21 | #
Comme tu dis, comme quoi les cas triviaux doivent être testés aussi
Citer : Posté le 22/05/2021 00:00 | #
Ah mais carrément ouais. Bon pour ma défense l'algo externe fait pas ce que je m'imaginais sur l'entrée 0.
Sinon tu seras content de savoir qu'avec Yatis on a commencé sérieusement la libc et que ça devrait permettre de compiler la lib C++ ensuite. On croise les doigts, mais c'est la bonne direction.
Citer : Posté le 22/05/2021 13:42 | #
Ah super. Oui j'ai vu des messages sur le topic de la libc. C’est cool merci à vous deux
Citer : Posté le 23/05/2021 23:10 | # |
Fichier joint
Hey !
Je sais pas vous, mais quand je fais une police quelconque pour un projet en C, j'ai toujours peur de "dépasser" et de devoir la refaire. Du coup je me faisais à la main une grille avec des carrés oranges et d'autre bleus avec un pixel de padding pour ne pas dépasser pour ensuite supprimer les cadres.
Bon, c'est vite chiant de faire des cadres à la main, donc j'ai automatisé la création de cette grille avec un petit script python. Je sais pas trop où le mettre, du coup il est en fichier joint…
L'utilisation est simple : il suffit d'appeler la fonction make_grid en passant la largeur et la hauteur des caractères en paramètres (dans cet ordre). Cela va créer une image au format png dans le répertoire du script et voila.
Je vais essayer de faire une fonction similaire qui va supprimer les cadres, une fois que la police est terminée.
Citer : Posté le 24/05/2021 08:49 | #
Merci ! C'est très cool. J'ai pris l'habitude d'utiliser les outils de grille de GIMP mais c'est vrai que je n'en ai pas parlé dans le tuto ! J'ai lié ton script comme ça il est bien ancré à l'endroit qui va bien. J'ai aussi ajouté les références sur quelle partie du code va dans quel fichier dans le second tuto, comme on en avait discuté
Citer : Posté le 24/05/2021 08:54 | # |
Fichier joint
Ok merci !
Pour le petit script j'ai fini la fonction qui nettoie la grille une fois les caractères terminés
Citer : Posté le 24/05/2021 08:55 | #
Maintenant que j'y pense il me semble que tu peux passer la grille à fxconv, puisque fxconv découpe (et donc ignore) les bordures.
Citer : Posté le 24/05/2021 08:57 | #
Ah ok, je savais pas ! Bon ben du coup la deuxième fonction a pas beaucoup d'intérêt xD
C'est peut-être plus joli dans les sources d'avoir une planche de police sans cadre orange et bleu autour ?
Citer : Posté le 26/05/2021 14:11 | #
Ya du support de la fxlibc maintenant?
Bon temps de faire un Duktap+E
Ajouté le 26/05/2021 à 14:34 :
Ca a foiré.
Citer : Posté le 26/05/2021 14:36 | #
Tu donnes pas de contexte, c'est dur de t'aider. J'avais des erreurs similaires et supprimer build-{cg-fx} puis rebuild les a fait disparaitre.