fxSDK, un SDK alternatif pour écrire des add-ins
Posté le 29/08/2014 22:00
Cette page sert d'index pour la série de topics du fxSDK.
Le fxSDK est une collection d'outils permettant de développer des add-ins pour les calculatrices Casio des séries Graph. C'est une alternative au
fx-9860G SDK et
PrizmSDK qui ne sont plus activement maintenus, et le compagnon classique de mon noyau
gint.
Index des topics
Ce projet existe depuis 2015, alors il y a pas mal de topics liés. En voici une liste complète !
Topics principaux
Installation du fxSDK
Tutoriels
Compatibilité sur calculatrice et PC
Côté PC, le fxSDK est compatible avec
Linux, Mac OS, et WSL pour Windows ; normalement tout le monde peut l'utiliser. Je teste constamment sous Linux, et WSL est un Linux donc c'est testé aussi. Je n'ai pas de Mac OS donc il peut y avoir quelques surprises, mais en général c'est l'affaire de corriger un bug ou deux.
En termes de calculatrices, le fxSDK supporte :
Calculatrices monochromes
Graph 35+E II
Graph 35+ USB / Graph 35+E (SH3/SH4)
Graph 75/75+/75+E
Graph 85/85 SD/95 (SD) (pas activement testé)
Calculatrices couleurs
Graph 90+E / fx-CG 50
Prizm fx-CG 10/20
Comment installer le fxSDK et coder des add-ins
Le fxSDK s'installe à partir de dépôts Git sur la
forge de Planète Casio (par exemple
Lephenixnoir/fxsdk). Il y en a un peu beaucoup, donc manuellement c'est assez long. Pour que ça aille plus vite et pour simplifier le travail des débutants, il y a un outil appelé
GiteaPC qui peut faire ça pour vous.
Si vous utilisez Windows, vous aurez besoin de WSL pour accéder à un système Linux dans Windows. Heureusement, Microsoft a fait ça bien et c'est facile à faire. Voyez le
tutoriel d'installation de WSL 2 (et l'explication rapide de
ce que WSL 2 est).
Si vous utilisez Mac OS, ouvrez l’œil en lisant les topics pour ne pas manquer les informations supplémentaires et éventuelles déviations par rapport à la procédure normale sous Linux.
Méthode automatique avec GiteaPC (plus rapide / recommandée pour les débutants)
- Suivez le tutoriel d'utilisation de GiteaPC, qui explique comment obtenir le fxSDK.
Méthode automatique avec plugin VS Code
- Yannis300307 a créé un plugin VS Code Casio Dev Tools qui fonctionne sous Windows (avec WSL) et Debian (probablement les dérivés aussi).
Méthode AUR pour les utilisateurs Arch/Manjaro/dérivés (ils se reconnaîtront)
- Dark Storm maintient MiddleArch, un dépôt de paquets précompilés qui a entre autres le fxSDK.
Méthode manuelle (plus fine / classique pour les habitués)
- Compilez et installez le cross-compilateur GCC pour SuperH.
- installez (dans cet ordre) les dépôts fxSDK, OpenLibm, fxlibc, gint ; en option, Slyvtt/µSTL_2.3.
Description sommaire du fxSDK
Pour une introduction à l'utilisation du fxSDK qui montre comment utiliser les outils pour développer un add-in, lisez plutôt les
tutoriels d'utilisation de gint. Cette section est juste une description sommaire.
Le cœur du fxSDK est un cross-compilateur GCC pour SuperH, habituellement nommé
sh-elf-gcc. Bien sûr on a avec toute la suite d'outils, dont
as,
ld,
objdump,
objcopy (entre autres). Contrairement au vieux compilateur du SDK, GCC est un compilateur moderne avec beaucoup d'options et capable de très solides optimisations.
Sur la calculatrice, c'est
le noyau gint qui fait la majorité du travail. Il remplace fxlib/libfxcg et une partie de l'OS pour vous offrir des fonctionnalités plus cool et plus rapides. Les add-ins développés avec le fxSDK utilisent gint toutes les trois lignes !
Il y a enfin plusieurs outils utiles sur le PC qui sont utilisés durant le développement ou l'utilisation des add-ins :
- fxsdk est un script shell qui permet de créer et compiler les projets sans se prendre trop la tête. Le système de compilation officiel pour les add-ins est CMake, mais un système plus ancien de Makefile est encore supporté.
- fxconv est un outil très polyvalent qui convertit à la compilation les assets (images, polices, maps....). Il permet de travailler avec des logiciels et formats de fichiers normaux sur le PC et d'avoir automatiquement un format optimisé sur la calculatrice. fxconv est extrêmement extensible et chaque projet peut ajouter des conversions personnalisées.
- fxgxa crée les fichiers g1a (format des add-ins pour Graph monochromes) et g3a (format des add-ins pour Graph couleurs) à partir des programmes compilés.
- fxlink est un outil de communication qui peut transférer des fichiers vers les Graph 35+E II et Graph 90+E en ligne de commande, mais aussi échanger interactivement avec les add-ins gint par le câble USB, et est couramment utilisé pour réaliser des captures d'écran ou captures vidéo des add-ins.
Changelog et informations techniques
Ci-dessous se trouve la liste des posts annonçant les nouvelles versions du fxSDK, ainsi que des liens vers les instructions/tutoriels supplémentaires publiés avec.
Citer : Posté le 18/11/2024 17:21 | #
Ah, bas justement j'éssai d'utiliser les flottants! Alors ça s'explique tout seul. Je n'ai pas trouvé comment les activer
Citer : Posté le 18/11/2024 17:23 | #
Voici la formule magique
// dans ton main()
__printf_enable_fp();
C'est pas activé par défaut parce que ça rajoute genre ~15 ko sur l'add-in ce qui est beaucoup si tu t'en sers pas (et malheureusement y'a pas moyen de détecter quand tu t'en sers pas x_x).
Citer : Posté le 18/11/2024 17:30 | #
Merci beaucoup!
Ca marche bien maintenant. Je n'ai pas vraiment besoin de %f car je l'utilise juste pour convertire les premier 15 chiffres decimal d'un chiffre en char *. Il y a surment un moyen simple de les convertir sans utiliser %f
Citer : Posté le 18/11/2024 17:37 | #
Étonnamment, non. Récupérer les chiffres décimaux d'un nombre flottant est toute la difficulté de %f. Tu peux toujours, si tu y tiens, y aller à coup de multiplications etc. :
for(int i = 0; i < 15; i++) {
y = y * 10;
str[i] = (int)y + '0';
}
str[15] = '\0';
mais tu auras des résultats approximés avec des chiffres parfois incorrects surtout sur la fin. Si tu veux les bons chiffres, il faut aller chercher les algorithmes un peu compliqués comme celui utilisé par fxlibc pour %f (Grisu 2b) qui prennent de la place.
Citer : Posté le 21/11/2024 19:10 | #
Juste pour info
J'ai réinstallé fxsdk sur debian 12 et tout semble fonctionner (avec GiteaPC) et quelques #apt install qui manquaient.
fxsdk --version me renvoie : fxSDK version 2.11.0
cependant je suis toujours obligé de faire un export PATH à chaque reconnexion.
bon pour l'instant je me sers de cette machinerie uniquement avec fxconv pour générer des fichiers image
faudrait que je reprenne les didacticiels de Slyvtt .
Bien à vous
https://joz.alwaysdata.net/info/
Citer : Posté le 21/11/2024 19:11 | #
Tu peux mettre la commande export PATH=... dans ton .profile et ça devrait s'appliquer automatiquement.
Citer : Posté le 23/11/2024 18:36 | #
Hello les gens je cherche à faire ces fonctions sur Gint :
bool PathExists(const char* path);
bool FileRemove(const char* path);
bool DirectoryCreate(const char* path);
bool DirectoryRemove(const char* path);
Et du coup j'ai utilisé <filesystem> pour les faire et j'obtient ces erreurs :
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(basic_file.o): in function `__ZNSt12__basic_fileIcE9showmanycEv':
(.text._ZNSt12__basic_fileIcE9showmanycEv+0xa4): undefined reference to `_fstat'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem12current_pathB5cxx11ERSt10error_code':
(.text._ZNSt10filesystem12current_pathB5cxx11ERSt10error_code+0x1dc): undefined reference to `_getcwd'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem12current_pathERKNS_7__cxx114pathE':
(.text._ZNSt10filesystem12current_pathERKNS_7__cxx114pathE+0x20): undefined reference to `_chdir'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem12current_pathERKNS_7__cxx114pathERSt10error_code':
(.text._ZNSt10filesystem12current_pathERKNS_7__cxx114pathERSt10error_code+0x3c): undefined reference to `_chdir'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem11permissionsERKNS_7__cxx114pathENS_5permsENS_12perm_optionsERSt10error_code':
(.text._ZNSt10filesystem11permissionsERKNS_7__cxx114pathENS_5permsENS_12perm_optionsERSt10error_code+0xec): undefined reference to `_chmod'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem19temp_directory_pathB5cxx11Ev':
(.text._ZNSt10filesystem19temp_directory_pathB5cxx11Ev+0x120): undefined reference to `_getenv'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem19temp_directory_pathB5cxx11ERSt10error_code':
(.text._ZNSt10filesystem19temp_directory_pathB5cxx11ERSt10error_code+0x188): undefined reference to `_getenv'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_ops.o): in function `__ZNSt10filesystem12do_copy_fileEPKcS1_NS_26copy_options_existing_fileEP4statS4_RSt10error_code':
(.text._ZNSt10filesystem12do_copy_fileEPKcS1_NS_26copy_options_existing_fileEP4statS4_RSt10error_code+0x1a0): undefined reference to `_chmod'
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/lib/libstdc++.a(fs_dir.o): in function `__ZNKSt10filesystem7__cxx114_Dir11open_subdirEbbRSt10error_code':
(.text._ZNKSt10filesystem7__cxx114_Dir11open_subdirEbbRSt10error_code[_ZNKSt10filesystem7__cxx114_Dir11open_subdirEbbRSt10error_code]+0x130): undefined reference to `_dirfd'
Donc je suppose qu'il manque plusieurs fonctions dans la lib standard, du coup est-ce qu'il y a un moyen pour contourner le problème ?
Albert Einstein
Citer : Posté le 23/11/2024 19:09 | #
Utilise Bfile ?
Citer : Posté le 23/11/2024 19:10 | #
Pour info remove() existe déjà dans la lib standard, les autres sont des one-liners sauf PathExists() qui n'a pas masse sens : toujours le même problème que la seule façon raisonnable de faire est d'essayer d'ouvrir et si ça échoue tu sais que ça existe pas.
Citer : Posté le 23/11/2024 19:57 | #
D'ac merci je vais regarder ça !
Pour PathExists c'est pour savoir si un dossier existe par exemple et dans ce cas la, tenter de l'ouvrir n'a pas de sens
Albert Einstein
Citer : Posté le 23/11/2024 21:38 | #
Tu pourras pas savoir si un dossier existe je pense. Tu peux juste essayer d'ouvrir les fichiers qui t'intéressent dedans.
Edit: Enfin si avec Find*() tu peux savoir, my bad.
Edit': Tu peux aussi avec <dirent.h>
Citer : Posté le 23/11/2024 23:19 | #
Ok parfait ça marche !
J'ai une autre question, j'aimerai faire un gint_world_switch en deux temps c'est à dire faire quelque chose comme ça :
gint_world_switch_out();
//mon code
gint_world_switch_in()
Alors je suis allé voir le code de gint_world_switch j'ai essayé de la split mais il fait des appels à kernel.h et je ne peux pas l'include car il est dans src de gint. Alors j'ai essayé de mettre le prototype void gint_load_onchip_sections(void); dans mon code mais il dit que ce n'est pas définie
Albert Einstein
Citer : Posté le 23/11/2024 23:22 | #
Ce n'est en effet pas proposé par l'API pour imposer une séparation entre le code exécuté dans gint et sur l'OS. Pourquoi t'est-il nécessaire de faire ces allers-retours manuellement ?
Citer : Posté le 23/11/2024 23:26 | #
Parce que je veux créer une nouvelle syntaxe pour ouvrir un fichier et que ça fasse le gint_world_switch automatiquement à l'ouverture et à la fermeture du fichier, en gros le constructeur ouvre le fichier et le destructeur le ferme.
if (OpenFileWith file = OpenFileWith("ZTOTN/SaveStateTOTN.dat", "r"))
{
fread_bigendian(&Save, sizeof(DataSave), 1, file);
}
Albert Einstein
Citer : Posté le 24/11/2024 00:22 | #
Bon finalement tant pis pour la mémoire onchip je vais juste faire gint_world_switch_out(gint_world_addin, gint_world_os); et gint_world_switch_in(gint_world_os, gint_world_addin);
ça a l'air de marcher comme ça donc bon, a vrai dire je ne sais pas si elle est utile
Albert Einstein