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 01/06/2021 15:53 | #
Oui, mais il faut appeler une fonction au début du programme pour les activer ; la raison est que le code qui génère les chiffres des nombres flottants est assez lourd et donc je ne veux pas forcer tout le monde à l'inclure dans l'add-in s'il n'est pas nécessaire.
/* Au début du programe */
kprint_enable_fp();
Quand j'aurai déplacé printf dans la libc, cette séquence sera différente (mais il y aura des redirections/etc donc l'ancienne version marchera toujours) :
__printf_enable_fp();
Citer : Posté le 01/06/2021 15:59 | #
Ok, merci, ça marche bien d'un coup ! xD
Citer : Posté le 01/06/2021 19:40 | #
Salut, avec ce code :
#include <gint/keyboard.h>
#include <gint/usb.h>
#include <gint/usb-ff-bulk.h>
int main(void)
{
dclear(C_WHITE);
dtext(1, 1, C_BLACK, "Sample fxSDK add-in.");
dupdate();
while (1==1)
{
usb_interface_t const *interfaces[] = { &usb_ff_bulk, NULL };
usb_open(interfaces, GINT_CALL_NULL);
if (keydown(KEY_VARS) && usb_is_open()) {
usb_fxlink_screenshot(true);
}
}
usb_close();
}
Et fxlink -iw cette commande reste en suspend mais rien ne se passe en cliquant sur VARS...
Citer : Posté le 01/06/2021 19:42 | #
usb_open(interfaces, GINT_CALL_NULL); n'est pas au bon endroit. Là tu initialise en boucle le module USB…
Citer : Posté le 01/06/2021 19:42 | #
Ah, mais oui je suis con. Merci. Ça ne marche pas plus.
Citer : Posté le 01/06/2021 20:30 | #
Tu ne lis jamais les événements dans ta boucle donc le keydown() ne passe jamais à 1.
Je me demande ce qu'il faudrait faire pour clarifier cette erreur, tout le monde la fait tout le temps, et pourtant la toute première apparition de keydown() dans les tutos gint insiste super lourdement là-dessus.
Citer : Posté le 01/06/2021 20:45 | #
Ca ne marche pas plus, même resultat que les fois précédentes :
Re-voici le code :
#include <gint/keyboard.h>
#include <gint/usb.h>
#include <gint/usb-ff-bulk.h>
int main(void)
{
dclear(C_WHITE);
dtext(1, 1, C_BLACK, "Sample fxSDK add-in.");
dupdate();
usb_interface_t const *interfaces[] = { &usb_ff_bulk, NULL };
usb_open(interfaces, GINT_CALL_NULL);
while (1==1)
{
clearevents();
if (keydown(KEY_VARS) && usb_is_open()) {
usb_fxlink_screenshot(true);
}
}
usb_close();
}
Citer : Posté le 01/06/2021 21:23 | #
Ce code marche très bien (à part le fait que ça envoie des screens en continu et qu'on ne peut pas en sortir), c'est le moment de chercher les problèmes avec WSL.
N'oublie pas que fxlink -iw doit afficher un message "Connected to ..." quand tu démarres l'add-in. S'il n'y est pas, ce n'est même pas la peine d'essayer.
Citer : Posté le 01/06/2021 21:25 | #
(Et ce n'est pas le cas, pas de Connected to)
Citer : Posté le 01/06/2021 21:28 | #
En relisant le détail des issues WSL pour l'instant il n'y a pas de pass-through simple et les workarounds qui existent sont assez compliqués, donc la conclusion (triste) c'est que tu ne peux pas utiliser fxlink avec WSL.
Citer : Posté le 01/06/2021 21:29 | #
Oh naann
Et (à part une machine virtuelle, et encore) pas moyen de faire ca sous Windows ?
Citer : Posté le 01/06/2021 21:31 | #
Avec une machine virtuelle ça irait, mais ça casse tout ton setup WSL du coup. >_>
Après tu peux aussi faire tes screens dans la mémoire de stockage, c'est pas la mort (ça prend juste 10 secondes par screen lol).
Citer : Posté le 02/06/2021 11:26 | #
Nouveau patch : gint 2.5.1
Release associée du fxSDK : fxSDK 2.5.1
Corrige des bugs de rendus avec les lignes verticales et images de très petite largeur sur Graph 90+E.
Citer : Posté le 08/06/2021 13:26 | #
Nouveau patch : gint 2.5.2 (avec fxlibc 1.2.0)
Release associée du fxSDK : fxSDK 2.5.2
Ce patch corrige un problème de bopti manifesté dans Terrario, où les quelques octets juste après la VRAM pouvaient être modifiés par dimage(). Le bug se produit si on affiche une image en niveaux de gris de plus de 32 pixels de large, en bas à droite de l'écran, qui dépasse de l'écran par la droite (après extension horizontale).
De plus, toutes les fonctions standard de gint ont été déplacées vers la fxlibc, ce qui sépare enfin les deux parties proprement !
L'implémentation de printf a aussi été déplacée vers la libc. Il y a quelque changements mineurs que vous devez faire :
La fxlibc offre beaucoup plus de fonctions standard que gint, mais quand même pas tout ; consultez le fichier STATUS pour savoir exactement ce qui est disponible.
Et voilà c'est tout pour aujourd'hui.
Citer : Posté le 12/06/2021 14:28 | #
Alors, petit probleme.
J'essaye d'écrire une fonction qui aurait le but d'écrire dans un fichier plus simplement
int writeFile(void* file, void* content) {
int fd = BFile_Open((uint16_t*) file, BFile_ReadWrite);
if(fd < 0) {
int size = 2;
int create = BFile_Create((uint16_t*) file, BFile_File, &size);
if(create < 0) return -1;//cant create file for some bizarre reason
fd = BFile_Open((uint16_t*) file, BFile_ReadWrite);
}
if((strlen(content) + 1) % 2 != 0) {
BFile_Close(fd);
return -2;//not even
}
BFile_Write(fd, content, strlen(content) + 1);
BFile_Close(fd);
return 0;// good
}
Mais quand j'essaye d'utiliser cette fonction(dans un gint_world_switch), la calto crash(bien que elle arrive à créer le fichier, qui est vide)
Y a un truc que j'ai foiré?
Citer : Posté le 12/06/2021 14:30 | #
Comment est-ce que tu spécifies le nom du fichier dans le première paramètre ?
Citer : Posté le 12/06/2021 14:33 | #
Voici la fonction qui apelle writeFile
static duk_ret_t writefile(duk_context *ctx) {
uint16_t* path = to16Bit(duk_get_string(ctx, 0));//Prendre l'argument 0, et le changer en uint16_t
char* str = duk_get_string(ctx, 1);//Prendre l'argument 1
if(((strlen(str) + 1) % 2) != 0) {
char zero = 0;
strcat(str, &zero);
int e = gint_world_switch(GINT_CALL(writeFile, path, str));
if(e != 0) {
free(str);
duk_push_boolean(ctx, (duk_bool_t) (0));
return 1;
}
}
free(str);
duk_push_boolean(ctx, (duk_bool_t) (1));
return 1;
}
Citer : Posté le 12/06/2021 14:34 | #
Ton check if((strlen(content) + 1) % 2 != 0) est chelou. Pourquoi faire compliqué ? D'ailleurs on notera qu'il est à l'inverse de ce que tu attends : impair + 1 → pair → modulo 2 = 0 → ≠ 0 = false.
Tu peux faire if(strlen(content) % 2 == 1), ça fonctionnera et ce sera plus lisible x)
Edit : my bad, c'est encore plus tordu. À ce moment là je ferais if(strlen(content) % 2 == 0)
Citer : Posté le 12/06/2021 14:36 | #
Je suppose que tu as le bon format ("\\fls0\\etc"). Quel est le code de retour du premier Open ?
Note que si le fichier existe tu ne peux pas juste l'ouvrir et le redimensionner par une autre écriture. À moins que le fs ait changé depuis que j'ai joué avec BFile initialement (ce qui est possible sur Graph 35+E II et Graph 90+E), la taille du fichier est fixée à la création. Sur les vieux modèles il faut même le supprimer pour réécrire dedans (ie. tu ne peux écrire qu'une fois), mais ça il me semble que c'est fini sur les nouveaux modèles.
Citer : Posté le 12/06/2021 14:38 | #
int create = BFile_Create((uint16_t*) file, BFile_File, &size);
On est d'accord qu'on ne peut pas redimensionner un fichier à la volée ? Et donc qu'il faut nécessairement donner la bonne taille du fichier lors de la création ? Ou c'est moi qui ai loupé un truc ?
Citer : Posté le 12/06/2021 15:27 | #
bon, comme un con, j'ai free un truc que j'ai pas du free
Ajouté le 13/06/2021 à 11:15 :
Bon, j'ai fixé mon probleme, mais j'en ai un autre)
J'essaye de récuperer une liste de fichiers dans un dossiers, et j'ai trouvé ce code(merci @Yatis!)
Le truc, c'est que ca marche seulement sur le dossier root
donc
\\fls0\* marche
mais
\\fls0\test\* ne marche pas, il me donne seulement ces dossiers/fichiers
.
..
J'ai modifié le code du giteapc
int explore_folder(uint16_t* search, uint16_t names[MAX_FILES][MAX_CHARACTERS], struct BFile_FileInfo infos[MAX_FILES]) {
/* Search descriptor */
int sd = 0;
/* Number of files found */
int found = 0;
int rc = BFile_FindFirst(search, &sd, names[found], &infos[found]);
if(rc < 0) return rc;
while(((rc = BFile_FindNext(sd, names[found], &infos[found])) != -16) && ((found++) < MAX_FILES));
BFile_FindClose(sd);
return found;
}
et ca marche(bon j'ai un bug bizzare à fix, mais bon)