Les membres ayant 30 points peuvent parler sur les canaux annonces, projets et hs du chat.

Forum Casio - Projets de programmation


Index du Forum » Projets de programmation » gint : un noyau pour développer des add-ins
Lephenixnoir Hors ligne Administrateur Points: 20993 Défis: 143 Message

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.6.0 (29 Août 2021)
gint 2.5.2 (8 Juin 2021)
gint 2.5.1 (2 Juin 2021)
gint 2.5.0 (26 Mai 2021) — Intégration de fxlibc (dépôt)
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 UnicodeNouvelle 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


Précédente 1, 2, 3 ··· 10 ··· 20 ··· 30 ··· 40, 41, 42, 43, 44, 45, 46, 47 ··· 50 ··· 59, 60, 61 Suivante
Massena Hors ligne Rédacteur Points: 1922 Défis: 11 Message

Citer : Posté le 23/08/2020 18:51 | #


Yes, je me procure gint demain.
Kirafi Hors ligne Membre Points: 2174 Défis: 10 Message

Citer : Posté le 27/08/2020 10:41 | #


Ah yes ! Bien joué je vais trouver le temps pour refaire l'image docker, même si y'a que moi qui l'utilise je trouve .
iPod
Pour des parties rapides
Jusqu'où pourras-tu aller dans ce jeu "partie rapide" qu'est Dextris (élu Jeu Du Mois)
Pourras-tu survivre plus de 20 secondes dans ce fameux tunnel appelé Graviton
Rebondis entre les murs en évitant les piques dans SpikeBird
Pourras-tu éviter de te faire écraser dans FallBlocs (élu Jeu Du Mois)
Autres
Franchement ils valent le coups
Deviens l'amiral de la marine dans SeaRush (jeu concours) (élu Jeu Du Mois)
La version 2048 tactile amélioré au plus haut point : 2048 Delux !
Pars à la recherche des morceaux d'étoile dans Lumyce (élu Jeu Du Mois)
Lephenixnoir Hors ligne Administrateur Points: 20993 Défis: 143 Message

Citer : Posté le 27/08/2020 10:47 | #


Il y a bien quelqu'un qui a essayé (https://gitea.planet-casio.com/Lephenixnoir/gint/issues/6) mais ça ne marchait déjà plus. xD
Kirafi Hors ligne Membre Points: 2174 Défis: 10 Message

Citer : Posté le 31/08/2020 10:38 | #


Je crois que justement j'avais corrigé cette erreur quand j'avais vu le post un peu plus tard à ce moment là .
iPod
Pour des parties rapides
Jusqu'où pourras-tu aller dans ce jeu "partie rapide" qu'est Dextris (élu Jeu Du Mois)
Pourras-tu survivre plus de 20 secondes dans ce fameux tunnel appelé Graviton
Rebondis entre les murs en évitant les piques dans SpikeBird
Pourras-tu éviter de te faire écraser dans FallBlocs (élu Jeu Du Mois)
Autres
Franchement ils valent le coups
Deviens l'amiral de la marine dans SeaRush (jeu concours) (élu Jeu Du Mois)
La version 2048 tactile amélioré au plus haut point : 2048 Delux !
Pars à la recherche des morceaux d'étoile dans Lumyce (élu Jeu Du Mois)
Lephenixnoir Hors ligne Administrateur Points: 20993 Défis: 143 Message

Citer : Posté le 16/09/2020 20:33 | #


Aujourd'hui, en tentant d'implémenter la solution à un bug de Terrario causé par gint, j'ai croisé et résolu un bug parmi les plus pétés que j'ai eu la chance de voir, donc comme je l'ai fait parfois dans le passé voici un résumé. J'espère que ça évitera à quelqu'un de tomber dans le même piège.

TL;DR : Toujours spécifier les flags dans .section (eg. .section .my.super.text, "ax" ou .section .my.super.data, "aw").

Dans gint, il y a du code qui est exécuté avec SR.BL=1, c'est-à-dire sans exceptions ni interruptions. Ce code c'est les gestionnaires d'exceptions et d'interruptions, plus quelques routines qu'ils appellent. Lorsque SR.BL=1, les TLB miss sont désactivés et en provoquer un résulte en un crash. Il est donc absolument indispensable que le code de ces choses ne soit pas virtualisé. Pour cette raison, le manuel explique qu'il doit être dans P1 ou P2. Pour nous, ça veut dire qu'il faut connaître l'adresse physique d'un endroit où on peut charger le code. (On a bien de la RAM qui est virtualisée en permanence, mais on ne peut pas exécuter du code si on y accède via le MMU.)

À l'origine, dans le proof-of-concept de Kristaba qui a donné lieu à gint, le gestionnaire d'interruptions et les routines associées sont installées sauvagement à une adresse fixe qui n'était par chance utilisée pour rien. Avec l'évolution de l'OS la zone est maintenant utilisée pour plein de choses donc il est hors de question de charger du code là. J'ai donc décidé de charger le code au début de la RAM de l'add-in, ce qui n'est pas facile sur Graph mono car la zone est très petite (8k) et je veux pas trop empiéter dessus. L'adresse de cette zone est 8801c000 dans tous les modèles jusqu'à la Graph 35+E II.

Sur la Graph 35+E II, l'adresse change (c'est 88048000), mais actuellement gint utilise encore l'ancienne adresse, et écrase bien sûr des trucs au passage sans faire exprès. C'est ce qui cause le bug de Terrario dont je parlais tout à l'heure. La solution est simple : détecter l'adresse au démarrage (ça on sait faire) et charger le code au bon endroit. Pour des raisons historiques, les gestionnaires d'interruptions sont déjà chargés de cette façon depuis longtemps, et seules quelques fonctions restaient à déplacer.

J'ai donc sorti mon linker script, défini une section .gint.mapped pour isoler les fonctions à charger dynamiquement, modifié le code pour les appeler via des pointeurs sur fonctions, charger la section à la bonne adresse, calculer les pointeurs sur fonction après le chargement, et tout allait bien. Jusqu'à ce que je me prenne des System ERROR catégorie "Illegal Instr Err" avec TEA/PC = 0. Après avoir cherché pas mal, j'ai fini par réaliser deux choses :

• Quand le bug se produit, les contenus de .gint.mapped ne sont pas chargés en RAM, et en fait ils ne sont pas non plus à leur place en ROM ;
• L'apparition du bug est dépendante de l'ordre dans lequel le linker arrange les sections .gint.mapped issues des différents fichiers objets de l'add-in.

C'est après avoir constaté que les données étaient dans l'ELF mais pas dans le g1a que j'ai pensé que la section pouvait être NOLOAD. Et c'est exactement ce qui s'est passé. En fait, dans le code assembleur j'avais des .section .gint.mapped au milieu des fichiers, sans flags spécifiés. Le problème c'est que ça hérite les flags de la section précédente d'une façon un peu malsaine, et du coup les fichiers objets qui possédaient une section .gint.mapped dans l'add-in n'étaient pas du tout d'accord sur les flags, avec parfois des choses très gênantes comme CONTENTS, READONLY.

Le résultat, c'est que le linker combine les flags hétérogènes de ces sections d'entrée d'une façon qui dépend de l'ordre. Dans mon cas, certains ordres provoquaient l'apparition d'un LOAD tandis que d'autres ordres non. Bien sûr, quand il n'y a pas de LOAD, la section n'est pas supposée être chargée donc la conversion au format binaire pur par objcopy supprime les données. Et c'est ainsi qu'avant même d'arriver dans la calculatrice il n'y a plus rien. C'est fourbe car j'ai tendance à lire le fichier ELF avec objdump et pas le g1a, en oubliant que le passage du premier au second peut réserver des surprises.

Une fois qu'on a mis la main sur ça, c'est facile : bien spécifier les flags pour éviter l'absence de load. Pour du code, "ax" (le "a" est "allocatable", c'est ce qui donne le LOAD), et pour des données, "aw".

Ajouté le 17/09/2020 à 15:26 :
Nouveau patch : gint 2.1.1

Que des changements internes, ce patch résout un problème de compatibilité Graph 35+E II qui peut notamment causer :
• Un crash à 801ebbac dans malloc() (notamment au démarrage lors de l'initialisation du moteur de gris)
• Une System ERROR lors du lancement de n'importe quelle application lorsqu'un add-in se termine

Nouvelles fonctionnalités :
• Ajouté un système de relocalisation du code indépendant du TLB (exécuté lorsque SR.BL=1) qui est désormais chargé à l'adresse physique de la RAM utilisateur déterminée dynamiquement (la Graph 35+E II n'utilise plus l'ancien 8801c000) ; les fonctions concernées sont appelés via des pointeurs.
• Étendu l'API du module MMU pour faciliter l'accès aux adresses physiques et notamment celle de la RAM utilisateur.

Changements :
• Modifié les drivers TMU, ETMU, RTC, et la méthode d'appel des fonctions de traitement des exceptions (gint_exc_catch) pour éviter l'usage de GMAPPED.
• Remanié le driver ETMU en conséquence.
• Modifié la méthode de calcul de la VBR pour utiliser l'adresse dynamique de la RAM utilisateur au lieu de celle fixe fournie par le linker script.

Suppressions :
• Supprimé la macro GMAPPED, qui n'est plus nécessaire dans le code utilisateur ; seul le code assembleur est concerné.

Instructions de mise à jour :
1. Tirez le code mis à jour sur les branches master ou dev (git pull)
2. Recompilez et réinstallez gint pour votre compilateur (make puis make install)
3. Recompilez et relinkez vos projets (make -B)

Instructions de migration :
Si vous utilisez gint_exc_catch() pour détecter ou corriger des exceptions, retirez GMAPPED de la fonction concernée. Sinon, rien à modifier.

Testé sur : Graph 35+ SH3, Graph 75+E, Graph 35+E II, Graph 90+E
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:09 | #


Derniere ligne droite !

Erreur : j'obtiens ca :

bash: ../configure: No such file or directory

Lors de ../configure ...

Ajouté le 15/10/2020 à 13:16 :
Je n'ai pas fait de copie du dépot, il faut en faire une ?
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 15/10/2020 13:27 | #


En général ça marche mieux quand on a les fichiers sur son PC.
Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:34 | #


Ah oui !
Je suis le genre de mec con qui suit le readme à la lettre sans reflechir 2 secondes

Ajouté le 15/10/2020 à 13:34 :
Bon par contre a près clonage du dépot toujours la meme erreur...
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 15/10/2020 13:36 | #


Il faut être dans le dossier sinon ça marche pas.

git clone https://gitea.planet-casio.com/Lephenixnoir/gint.git
cd gint
mkdir build.fx && cd build.fx
../configure --target=fx9860g

Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:36 | #


Je dois le cloner ou le depot ( genre dans quel doss ) ?

Ajouté le 15/10/2020 à 13:43 :
désolé je ne m'y connais pas du tout en linux
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 15/10/2020 13:45 | #


N'importe où, c'est pas important. Si possible dans ton $HOME quand même
Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:46 | #


ok !

Ajouté le 15/10/2020 à 13:49 :
ModuleNotFoundError: No module named 'PIL'
Maintenant j'ai ca au make ...

Ajouté le 15/10/2020 à 13:49 :
un jour je vais y arriver
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 15/10/2020 13:52 | #


sudo apt-get install python3-pil (source)

Tu connais l'existence des moteurs de recherche ? Genre au pif Qwant, DuckDuckGo ou Google ?
La commande au dessus est le premier résultat qui sort quand je copie/colle ton erreur…
Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:53 | #


Justement je l'avais fait avant mais E: Unable to locate package python-pip

Ajouté le 15/10/2020 à 13:54 :
en fait c'est bon !
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 15/10/2020 13:54 | #


STFW
Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Potter360 Hors ligne Rédacteur Points: 815 Défis: 0 Message

Citer : Posté le 15/10/2020 13:55 | #


Justement j'y étais !

Ajouté le 15/10/2020 à 13:56 :
Merci !
L'installation est finie, !
Hop là... toi qui lis cette signature... tu pourrais aussi aller voir mon projet Elphorina, un jeu de RPG-building !
Lephenixnoir Hors ligne Administrateur Points: 20993 Défis: 143 Message

Citer : Posté le 24/10/2020 17:06 | #


Je signale que j'ai porté OpenLibm à l'improviste et en mode freestyle complet, et ça marche du tonnerre ! On a donc un lib de calcul en point flottant pour tous projets, sans prise de tête.

Les instructions de compilation sont complètes mais il y a un détail d'include que je pousserai bientôt dans le fxSDK. En tous cas, plus besoin de newlib pour avoir la lib mathématique. Non seulement OpenLibm est bien plus petite, mais en plus ce sera je pense l'addition parfaite à FxLibC pour gint.

Comme ça commence à faire pas mal de libs et logiciels compilables pour développer des add-ins (en tout : GCC, FxLibC, OpenLibm, gint lui-même, libprof, libimg...) j'envisage de remodeler le fxSDK pour automatiser l'installation. Je pourrais packager pour toutes les distributions mais la charge de travail est énorme par rapport à simplement avec un script pour clôner et compiler des dépôts Git. Je veux pas que ça se finisse en gestionnaire de paquets mais pas non plus y passer des mois.
Pedrobzh Hors ligne Membre Points: 616 Défis: 0 Message

Citer : Posté le 24/10/2020 17:46 | #


j'ai une erreur, il dir que l'argument '-big' existe pas
pensés suicidaires
   90%
Lephenixnoir Hors ligne Administrateur Points: 20993 Défis: 143 Message

Citer : Posté le 24/10/2020 18:03 | #


J'ai déjà vu cette erreur mais je serais bien incapable de te dire où est le problème. Comme d'habitude tu sautes vraiment tous les détails... tu as installé quoi, et tu compiles quoi, avec quel compilateur, avec quelles options ?
Pedrobzh Hors ligne Membre Points: 616 Défis: 0 Message

Citer : Posté le 24/10/2020 18:36 | #


j'ai fais le config et make

EDIT:
j'ai installé debian en dual boot (la je suis sur windows)
pensés suicidaires
   90%
Dark storm Hors ligne Labélisateur Points: 11541 Défis: 176 Message

Citer : Posté le 24/10/2020 18:55 | #


tu as installé quoi, et tu compiles quoi, avec quel compilateur, avec quelles options ?

Il manque encore un tas d'infos pour qu'on puisse te donner une réponse efficace…
Finir est souvent bien plus difficile que commencer. — Jack Beauregard
Précédente 1, 2, 3 ··· 10 ··· 20 ··· 30 ··· 40, 41, 42, 43, 44, 45, 46, 47 ··· 50 ··· 59, 60, 61 Suivante

LienAjouter une imageAjouter une vidéoAjouter un lien vers un profilAjouter du codeCiterAjouter un spoiler(texte affichable/masquable par un clic)Ajouter une barre de progressionItaliqueGrasSoulignéAfficher du texte barréCentréJustifiéPlus petitPlus grandPlus de smileys !
Cliquez pour épingler Cliquez pour détacher Cliquez pour fermer
Alignement de l'image: Redimensionnement de l'image (en pixel):
Afficher la liste des membres
:bow: :cool: :good: :love: ^^
:omg: :fusil: :aie: :argh: :mdr:
:boulet2: :thx: :champ: :whistle: :bounce:
valider
 :)  ;)  :D  :p
 :lol:  8)  :(  :@
 0_0  :oops:  :grr:  :E
 :O  :sry:  :mmm:  :waza:
 :'(  :here:  ^^  >:)

Σ π θ ± α β γ δ Δ σ λ
Veuillez donner la réponse en chiffre
Vous devez activer le Javascript dans votre navigateur pour pouvoir valider ce formulaire.

Si vous n'avez pas volontairement désactivé cette fonctionnalité de votre navigateur, il s'agit probablement d'un bug : contactez l'équipe de Planète Casio.

Planète Casio v42 © créé par Neuronix et Muelsaco 2004 - 2021 | Il y a 38 connectés | Nous contacter | Qui sommes-nous ? | Licences et remerciements

Planète Casio est un site communautaire non affilié à Casio. Toute reproduction de Planète Casio, même partielle, est interdite.
Les programmes et autres publications présentes sur Planète Casio restent la propriété de leurs auteurs et peuvent être soumis à des licences ou copyrights.
CASIO est une marque déposée par CASIO Computer Co., Ltd