gint : un noyau pour développer des add-ins
Posté le 20/02/2015 17:30
Les SDKs classiques pour écrire des add-ins sont le
fx-9860G SDK de Casio avec fxlib (pour Graph monochrome) et le
PrizmSDK avec libfxcg (pour Prizm et Graph 90+E).
Voici mon alternative : le fxSDK avec gint, pour toutes les plateformes.
Contrairement à fxlib et libfxcg, qui appellent les fonctions de l'OS pour faire leur travail,
gint est un noyau indépendant de l'OS qui exploite seul le matériel et le met à disposition de votre add-in. Il vous offre plus de finesse sur le contrôle du matériel, notamment le clavier, l'écran et les horloges, de meilleurs performances sur le dessin, les drivers et la gestion de interruptions, et des choses entièrement nouvelles comme le moteur de gris.
Toutes les sources de gint sont publiques et accessibles sur la forge de Planète Casio :
» Dépôt Gitea Lephenixnoir/gint «
Voici plus précisément ce que gint vous offre de nouveau :
• Un contrôle détaillé du clavier pour les jeux, parfait pour les combos !
• Des timers avec une précision de 60 ns, d'autres à 30 µs
• Toutes vos images converties automatiquement sans code à copier (plus de Sprite Coder)
• Des polices personnalisées
• Des fonctions de dessin, d'images et de texte fulgurantes et optimisées la main
• Mesurer les performance de votre code à la microseconde près (avec
libprof)
• Le contrôle du matériel et des interruptions
• Plein de petites choses pratiques comme
dprint(1, 1, "x=%d", x)
• (Graph monochrome) Un moteur de gris pour faire des jeux en 4 couleurs !
• (Graph monochrome) La compatibilité SH3 et SH4, avec le même fichier g1a.
• (Graph 90+E) Une nouvelle police de texte, plus lisible et économe en espace
• (Graph 90+E) Le dessin en plein écran, sans les bordures blanches et la barre de statut !
• (Graph 90+E) Un driver écran capable de triple-buffering
Le coût de tout ceci, c'est que vous avez une copie du code de gint dans votre add-in. Cela prend environ 20 ko de place (selon la quantité de fonctions que vous utilisez), soit à peu près comme le
sprintf() de fxlib qui fait 18 ko !
Et voici quelques photos et captures d'écran !
Tester gint sur votre machine
La fin du portage vers la Graph 90+E signera la sortie de
gint v2. L'add-in de test de l'application est désormais gintctl :
» Dépôt Gitea Lephenixnoir/gintctl «
En plus de tester les fonctionnalités de gint, cet add-in contient quelques outils permettant d'inspecter la machine, la mémoire, et les registres. Je le développe au fur et à mesure, et je posterai un protocole de test complet avec la sortie de la v2 !
Utiliser gint pour développer des add-ins
Normalement, vous avez besoin du
fxSDK pour développer avec gint. Le fxSDK est compatible avec Linux et Mac OS, et on peut réfléchir à un portage sous Windows s'il y a vraiment des intéressés. Il faut l'installer en premier (et avoir un cross-compilateur GCC).
La procédure de compilation et d'installation de gint est décrite
sur le README du dépôt, c'est du
configure -
make tout à fait banal.
Une fois que gint est installé sur votre système, voyez les
tutoriels de développement pour avoir un aperçu de son fonctionnement. La plupart des choses sont expliquées dans les en-têtes (fichiers
.h) de la bibliothèque que vous pouvez
consulter en ligne, sur votre copie locale du dépôt, ou dans les dossiers d'installation du compilateur.
Obtenir la dernière version de gint après une mise à jour
Je pousse régulièrement des mises à jour de gint sur le dépôt du projet. Pour les télécharger, tapez
git pull, puis recompilez et réinstallez gint avec
make et
make install.
Changelog et infos de migration
Ci-dessous se trouve la liste des posts indiquant les nouvelles versions de gint, et les instructions pour modifier vos add-ins quand c'est nécessaire.
•
gint 2.4.0 (27 Avril 2021) —
Api GINT_CALL() pour les callbacks
•
gint 2.3.1 (2 Février 2021)
•
gint 2.3.0 (29 Janvier 2021)
•
gint 2.2.1 (12 Janvier 2021)
•
gint 2.2.0 (11 Janvier 2021)
•
gint 2.1.1 (16 Septembre 2020)
•
gint 2.1.0 (21 Août 2020) —
Polices Unicode —
Nouvelle API du moteur de gris
•
gint 2.0.3-beta (10 Juillet 2020) —
Modifications de l'API timer
•
gint 2.0.2-beta (17 Juin 2020)
Anecdotes et bugs pétés
Ô amateurs de bas niveau, j'espère que vous ne ferez pas les mêmes erreurs que moi.
•
Toujours spécifier les flags dans .section en assembleur
•
Ne pas oublier des registres lors de la sauvegarde du contexte durant une interruption
•
Aligner correctement les adresses des sections dans le linker script
•
Toujours spécifier l'alignement des structures packed (message du 01/03/2017)
Fichier joint
Citer : Posté le 12/01/2021 17:16 | # |
Fichier joint
Bugs corrigés
• Il manquait des headers à l'installation, et j'ai du mal à réaliser comment c'est passé inaperçu aussi longtemps ! ^^"
Ajouté le 25/01/2021 à 22:52 :
La prochaine version (2.3) changera le système de build vers CMake ; j'ai déjà fait le changement sur dev, c'est bien 3 à 4 fois plus propre qu'avant. Les Makefile d'avant étaient dur à maintenir pour moi et obscurs pour à peu près tout le reste du monde, donc je suis bien content d'avoir quelque chose de plus direct.
Citer : Posté le 26/01/2021 07:58 | #
Ohhhhhh nonnnnnnnn pitié pas Cmake
Citer : Posté le 26/01/2021 10:23 | #
Hmm ?
Citer : Posté le 26/01/2021 10:28 | #
Citer : Posté le 26/01/2021 13:48 | #
Tu ne devrais pas avoir trop de problèmes ici. C'est le fxSDK et les bibliothèques qui fournissent les instructions, et comme toutes les libs sont installées au même endroit (dans le compilateur) ça ne peut quasiment pas rater. Je garde un oeil sur les erreurs possibles mais y'a pas trop de risque.
Citer : Posté le 26/01/2021 14:34 | #
ok...
Citer : Posté le 02/02/2021 18:25 | #
Un peu en retard, voici les détails de la release 2.3.0 qui allait avec celle du fxSDK.
Nouvelles fonctionnalités
• gint peut maintenant être installé avec GiteaPC.
Modifications
• Changé le système de compilation pour le CMake fourni par le fxSDK.
Et en même temps, un patch que je viens de publier.
Corrections de bugs
• Corrigé la commande de dés-installation qui ne marchait pas sur les OS avec sh comme shell par défaut.
• Restauré le calcul de gint[HWURAM] qui n'était plus fait.
• Descendu la version minimale de CMake à 3.16 pour suivre les paquets Debian.
Citer : Posté le 03/02/2021 17:54 | #
Quand j'essaye de compiler l'add-in de base, j'ai
Citer : Posté le 03/02/2021 18:01 | #
Tu y es presque ! C'est un outil pour générer des fichiers g3a. Le fxSDK a un outil pour générer des g1a (fx1a), mais pas encore pour les g3a, donc j'utilise celui de Tari. Tu peux le trouver ici : https://gitlab.com/taricorp/mkg3a
mkg3a est mentionné à plusieurs endroits, mais pas assez visiblement puisque tu n'a pas vu l'info. Je referai une passe sur les tutos.
Citer : Posté le 03/02/2021 21:10 | #
Il faut que je compile mkg3a moi même ?
Citer : Posté le 03/02/2021 21:14 | #
Oui, bien qu'il me semble il y est un paquet sur l'AUR qui automatise ça, si jamais tu utilise Arch
(BTW, I use Arch)
Citer : Posté le 03/02/2021 22:03 | #
ça marche ! J'ai enfin réussi
Merci pour votre aide !
Citer : Posté le 26/03/2021 21:25 | #
Yo ! J'ai quelques nouvelles un peu cachées à annoncer. Je n'ai pas beaucoup communiqué ces derniers temps parce que je vais doucement et qu'on essaie de pas mettre trop d'accent sur les add-ins, mais je pense qu'il est temps de s'y mettre.
Une extension de malloc(), qui donne plus de stats et (un peu) plus de mémoire
Vous connaissez sans doute la fonction malloc() de la bibliothèque C, qui permet d'obtenir à l'exécution de la mémoire pour stocker des données (généralement des tableaux). malloc() puise de la mémoire dans une zone qui lui est réservée et qu'on appelle le « tas ». Jusqu'ici dans gint, si vous appeliez malloc() vous étiez simplement renvoyé·e vers le tas de l'OS (48 kB sur mono pré-Python, 90 kB sur Graph 35+E II, 128 kB sur Graph 90).
Le tas de l'OS avait une mauvaise réputation par le passé (du genre si on l'utilise trop longtemps il ne marche plus bien à cause de fragmentation ¹ ² ), mais après l'avoir testé je ne lui ai pas trouvé ces défauts. Je pense qu'il a changé, notamment parce que Python l'utilise intensément et a donc besoin qu'il soit très fiable, ce qui est une bonne nouvelle pour tout le monde !
En plus de ça, j'ai implémenté un autre algorithme de tas (et donc un malloc() et un free()) spécifique à gint, avec plein de statistiques, et j'ai fait en sorte qu'on puisse créer des tas partout où l'on veut. J'ai déjà ajouté un tas supplémentaire, qui couvre toute la mémoire normalement disponible pour les variables globales mais pas utilisée par le programme. Ça représente en général 6 kB sur Graph mono SH3, 12 kB sur Graph mono SH4, et jusqu'à 500 kB sur Graph 90+E (moins si vous créez des gros tableaux).
J'ai testé l'algorithme avec plein de méthodes différentes, et une fois tous les bugs éliminés (il n'y en avait pas à part dans realloc() en fait) j'ai poussé ces changements sur la branche dev du dépôt. Ce sera pour la prochaine publication.
Un prototype de driver USB ?!
Ça c'est une collaboration avec Yatis. Petit teaser pour la RDP de la semaine prochaine je suppose.
@RDP
Citer : Posté le 03/04/2021 10:06 | # |
Fichier joint
Comme promis, voici les suites de la hype de la semaine précédente (qui sont tout autant @RDP d'ailleurs).
Un driver USB à venir, avec du protocole personnalisé et standard
Avec Yatis on a attaqué sérieusement un driver USB il y a deux semaines. La première semaine on a regardé comment faire fonctionner le module USB de la calculatrice (notamment comment l'allumer et l'utiliser correctement) ; j'ai résumé des notes de ces tentatives sur la bible. Le driver n'est pas encore 100% stable (en gros celui de gint freeze si vous faites un gint_switch() trop rapide), mais pas mal de progrès ont été faits et j'ai fini par tomber sur une version qui ne fait pas planter LINK et qui marche sous tous les niveaux d'overclock sur mes Graph 75+E, 35+E II, et 90+E. Pour la SH3, euh... meh.
Avec ça la calculatrice peut communiquer avec l'ordinateur (on a testé sous Linux), et si on capture les échanges avec Wireshark on voit passer des paquets (comme ci-dessous où Linux demande à la calculatrice son identité).
Cette semaine on a commencé à regarder le protocole à proprement parler, ce qui consiste plus à lire les documents du standard USB et à répondre aux échanges selon le protocole standardisé. On a pas mal de latitude là-dessus, et en particulier on a deux approches :
• La plus simple (mais la moins jolie) consiste à juste envoyer des données de la façon qui nous plaît, et de coder nous-même un programme qui les récupère sur l'ordinateur. Comme ça on peut juste envoyer les données en brut, notre programme se débrouille pour les décoder (est-ce du texte ? une image ? etc). C'est un peu ce que fait p7 par exemple (sauf que c'est pas Cakeisalie5 qui a choisi le protocole, c'est CASIO).
• La plus élégante (mais plus compliquée) consiste à suivre un protocole standardisé, par exemple le Stockage de Masse USB ou les périphériques vidéo USB. L'avantage c'est que si on fait ça dès qu'on branche la calculatrice en USB Linux se débrouille et vous la voyez apparaître dans votre explorateur de fichiers (pour le Stockage de Masse) ou dans votre lecteur vidéo (pour le périphérique vidéo).
Idéalement j'aimerais utiliser le plus possible les protocoles standardisés, mais ce n'est pas évident. Pour l'instant je vois trois types de choses à transférer :
Pour le texte, Yatis a commencé à regarder le protocole standard approprié. Pour les captures d'écran, il n'y a rien de vraiment satisfaisant, la seule chose qui existe c'est PTP, qui est utilisé par les appareils photos, mais en correspond pas à nos besoins. Pour la vidéo, tout est parfaitement prévu mais aussi parfaitement compliqué, donc je n'ai pas osé m'y attaquer encore.
Pour l'instant, j'ai juste réalisé des échanges bourrins qui ne respectent aucun protocole, en utilisant un programme personnalisé sur l'ordinateur pour accéder aux données. J'ai notamment pu transmettre un petit message de la calculatrice à l'ordinateur ; c'est loin d'être très propre et encore moins optimisé, mais ça montre que c'est possible !
Vous pouvez voir le message "Hello, USB" affiché sur la calculatrice avant l'envoi et ensuite récupéré par le programme sur l'ordinateur. (Excusez la qualité de l'image, l'éclairage à 10 heures du matin est juste beaucoup trop fort et inégal pour une bonne photo.)
D'autres nouvelles arriveront plus tard ! Mais pendant que j'y suis, autant vous teaser sur quelque chose d'autre.
Un outil pour faciliter les transferts USB dans le fxSDK
Comme vous pouvez le voir sur la photo ci-dessus, le petit programme que j'ai utilisé pour récupérer les données s'appelle fxlink. Comme je me suis attaqué à la gestion de l'USB côté PC, j'ai pris un détour en fin de semaine pour ajouter ce nouvel outil au fxSDK. Ce n'est pas un outil révolutionnaire, mais je pense qu'il sera assez pratique. J'en parlerai en détail la semaine prochaine.
Citer : Posté le 03/04/2021 10:07 | # |
Fichier joint
(Image supplémentaire)
Citer : Posté le 03/04/2021 19:40 | #
ca em donne envie de faire une app qui utilise le PC pour se connecter à internet et de pouvoir chatter.
Aussi, j'essaye d'utiliser VSCode avec GINT, mais ou se trouve les fichiers pour les include?
EDIT: C'est bon j'ai trouvé les .h!(dans /home/<nom d'utilisateur>/.local/share/giteapc/Lephenixnoir/gint/include/ sur Linux(au moins sur Manjaro) )
Citer : Posté le 03/04/2021 20:20 | #
Merci ! Je vois que tu as réussi à tout installer avec GiteaPC, c'est super.
Par contre ton dossier d'en-têtes n'est pas bon - le dossier correct est dans le dossier d'installation du compilateur sh-elf-gcc, et c'est fait de telle façon que tu n'as pas besoin de spécifier d'option, il les trouve tout seul. Du coup je me demande vaguement si tu ne compiles pas avec ton compilateur système, fais attention à ça.
Dans tous les cas je te conseille d'utiliser le fxSDK pour compiler (il sert à ça), ça te donnera tout de suite les bonnes options.
Citer : Posté le 03/04/2021 20:43 | #
J'essayais de trouver les chemins des .h juste pour IntelliSense(je confonds toujours avec IntelliJ IDEA)
mais quand j'ai essayé, rien.
Citer : Posté le 03/04/2021 20:47 | #
Ah, je vois ! Ça devrait aller alors, ce n'est pas du tout critique. Pour plus de fidélité, tu peux obtenir le chemin comme ceci :
Si tu as installé sh-elf-gcc avec GiteaPC, ça devrait être $HOME/.local/share/giteapc/Lephenixnoir/sh-elf-gcc/lib/gcc/sh3eb-elf/10.2.0/include/gint.
Citer : Posté le 03/04/2021 21:15 | #
Ah, merci pour l'astuce!
Mais si quelqun sait comment setup IntelliSense avec gint, ca serait sympa
EDIT: c'est bon j'ai trouvé, c'est juste que avec OSS(la version que j'utilisais) fallait installer un plugin(que j'ai trouvé sur AUR) pour voir les plugins VSCode du marketplace normal
apres j'ai installé l'extension C/C++ et ca marche
Citer : Posté le 05/04/2021 15:41 | #
J'ai un message d'erreur dans le fichier /Users/MrDupont/.local/bin/fxsdk quand je fais fxsdk build-fx
/Users/XXX/.local/bin/fxsdk: line 248: syntax error: unexpected end of file
La fin du fichier fxsdk est
# Project creation
"new")
fxsdk_new_project "${@:2}";;
# Project compilation
"build"|"b")
fxsdk_build "${@:2}";;
"build-fx"|"bf"|"bfx")
fxsdk_build_fx "${@:2}";;
"build-cg"|"bc"|"bcg")
fxsdk_build_cg "${@:2}";;
# Install
"send"|"s")
fxsdk_send;;
"send-fx"|"sf"|"sfx")
fxsdk_send_fx;;
"send-cg"|"sc"|"scg")
fxsdk_send_cg;;
# Misc
-h|--help|-\?)
usage 0;;
?*)
error "unknown command '$1'" ERREUR ICI
exit 1;;
*)
usage 0;;
esac
Quel est le problème ?
Merci