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 28/06/2019 19:43 | #
Ça c'est une différence entre Linux et Mac. Désolé, je n'aurais pas trop pu la prévoir.
J'ai poussé un fix, tu peux git pull et refaire make. Dis-moi si ça va mieux
Citer : Posté le 28/06/2019 19:45 | #
Merci !
Ah ! alors ça marche, mais j'ai une autre erreur…
fxg1a/icon.c:5:10: fatal error: 'png.h' file not found
Citer : Posté le 28/06/2019 19:47 | #
Tu prends un peu les pots cassés dis donc.
Il te faut la libpng, que tu dois pouvoir installer avec la commande "brew install libpng". Je suis surpris de pas l'avoir noté. >_>
Citer : Posté le 28/06/2019 20:14 | #
Elle est dans les dépendances de g1a-wrapper ça doit être pour ça que personne n'a remarqué
Citer : Posté le 28/06/2019 20:29 | #
J'étais persuadé que le g1a-wrapper ne lisait que du bmp, et ai donc été lire les sources pour vérifier.
Me connecter sur Bitbucket a failli me faire vomir.
Lire le code de l'outil m'a vraiment dégoûté. Dire que ça a moins de 4 ans...
J'envisage sérieusement de m'assurer que compiler le fxSDK avec uniquement fxg1a soit aussi facile que compiler le g1a-wrapper puis supprimer définitivement le g1a-wrapper des dépôts et du tutoriel. Berk berk...
Citer : Posté le 28/06/2019 20:35 | #
Et du coup, libpng ou pas ?
Citer : Posté le 28/06/2019 20:35 | #
Non, pas libpng.
Citer : Posté le 29/06/2019 15:22 | #
Bon >_<' plus que les pots cassé, je suis en passe de devenir le plus grand recycleur de poterie de France ! Oui Môssieur
Sans blague, la libpng s'est installée sans problème mais toujours au niveau du make du fxsdk :
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1
Voila !
Citer : Posté le 29/06/2019 15:25 | #
Il me faudrait plus de contexte, peux-tu me montrer une plus grande partie du log de compilation ?
Citer : Posté le 29/06/2019 15:26 | #
Oky, tiens je te met tout !
gcc -c fxg1a/icon.c -o build/fxg1a/icon.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/icon.c.o -MMD -MP -MF build/fxg1a/icon.c.d
gcc -c fxg1a/main.c -o build/fxg1a/main.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/main.c.o -MMD -MP -MF build/fxg1a/main.c.d
gcc -c fxg1a/util.c -o build/fxg1a/util.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/util.c.o -MMD -MP -MF build/fxg1a/util.c.d
fxg1a/util.c:22:36: warning: implicit declaration of function 'htobe16' is
invalid in C99 [-Wimplicit-function-declaration]
for(int i = 0; i < 8; i++) sum += htobe16(shorts[i]);
^
1 warning generated.
mkdir -p bin
gcc build/fxg1a/dump.c.o build/fxg1a/edit.c.o build/fxg1a/file.c.o build/fxg1a/icon.c.o build/fxg1a/main.c.o build/fxg1a/util.c.o -o bin/fxg1a -lpng
Undefined symbols for architecture x86_64:
"_be16toh", referenced from:
_check in dump.c.o
"_be32toh", referenced from:
_check in dump.c.o
"_htobe16", referenced from:
_sign in edit.c.o
_checksum in util.c.o
"_htobe32", referenced from:
_sign in edit.c.o
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [bin/fxg1a] Error 1
Citer : Posté le 29/06/2019 15:45 | #
Mais mais. Aah. C'est encore le endian.h qui vient me hanter vu que Mac OS appelle pas ses fonctions pareil. Sérieux quoi.
Bon, j'ai tenté un autre fix. J'ai pas pu tester sous Mac donc ça va être à toi de le faire. J'ai modifié le passé de Git donc tu ne peux pas git pull, tu dois faire comme ça (en supposant que tu n'a pas modifié les fichiers du dépôt) :
% git reset --hard origin/master
Cela télécharge les modifications sans essayer de les appliquer, puis te téléporte à la dernière version.
Citer : Posté le 29/06/2019 15:48 | #
J'ai une autre erreur, mais je pense qu'il s'agit d'une erreur de syntaxe…
gcc -c fxg1a/dump.c -o build/fxg1a/dump.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/dump.c.o -MMD -MP -MF build/fxg1a/dump.c.d
gcc -c fxg1a/edit.c -o build/fxg1a/edit.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/edit.c.o -MMD -MP -MF build/fxg1a/edit.c.d
gcc -c fxg1a/util.c -o build/fxg1a/util.c.o -Wall -Wextra -std=c11 -g -I fxg1a/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxg1a/util.c.o -MMD -MP -MF build/fxg1a/util.c.d
gcc build/fxg1a/dump.c.o build/fxg1a/edit.c.o build/fxg1a/file.c.o build/fxg1a/icon.c.o build/fxg1a/main.c.o build/fxg1a/util.c.o -o bin/fxg1a -lpng
gcc -c fxos/analysis.c -o build/fxos/analysis.c.o -Wall -Wextra -std=c11 -g -I fxos/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxos/analysis.c.o -MMD -MP -MF build/fxos/analysis.c.d
gcc -c fxos/asm.c -o build/fxos/asm.c.o -Wall -Wextra -std=c11 -g -I fxos/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxos/asm.c.o -MMD -MP -MF build/fxos/asm.c.d
fxos/asm.c:21:3: error: expected ')'
err("too many tables, skipping");
^
fxos/errors.h:61:35: note: expanded from macro 'err'
#define err(str, ...) errf(0, str __VA_OPT__(,) __VA_ARGS__)
^
fxos/asm.c:21:3: note: to match this '('
fxos/errors.h:61:27: note: expanded from macro 'err'
#define err(str, ...) errf(0, str __VA_OPT__(,) __VA_ARGS__)
^
1 error generated.
make: *** [build/fxos/asm.c.o] Error 1
Citer : Posté le 29/06/2019 15:58 | #
Quelque chose que tu as une version de clang (le compilateur, qui n'est en réalité pas gcc) tellement vieille qu'elle ne supporte pas __VA_OPT__. Tu peux essayer en tapant gcc --version. T'as regardé s'il y a des mises à jour pour ça ?
Citer : Posté le 29/06/2019 16:02 | #
J'ai pas trop trouvé où est indiqué la version…
Configured with: --prefix=/Library/Developer/CommandLineTools/usr --with-gxx-include-dir=/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/include/c++/4.2.1
Apple LLVM version 10.0.1 (clang-1001.0.46.4)
Target: x86_64-apple-darwin18.6.0
Thread model: posix
InstalledDir: /Library/Developer/CommandLineTools/usr/bin
Citer : Posté le 29/06/2019 16:12 | #
Wtf, ça correspond même pas aux numéros de version de clang.
Voici un test : dans fxos/errors.h, à la ligne 61 (tout à la fin), remplace :
par :
puis recompile. Si ça ne marche toujours pas, essaie :
Citer : Posté le 29/06/2019 16:17 | #
Ça marche avec la première solution !
Edit : Ah, euh j'ai une autre erreur avec sudo make install >_<' :
Password:
install -d /Users/antoine/.local/bin
install -d /Users/antoine/.local/share/fxsdk
install bin/fxg1a bin/fxos -m 755 /Users/antoine/.local/bin
install: -m: No such file or directory
make: *** [install] Error 71
Citer : Posté le 29/06/2019 17:48 | #
D'abord tu n'es pas obligé de mettre sudo ici, et je te conseille de ne pas le faire.
Ensuite la prochaine fois qu'on me dit que Mac c'est un genre de Linux, juste non. è_é
Tu peux git pull et continuer.
Citer : Posté le 29/06/2019 17:52 | #
Alors… sans le sudo ça me renvoie : Permission denied (à la limite c'est logique et pas de ta faute…
sed: 1: "/Users/antoine/.local/b ...": command a expects \ followed by text
Citer : Posté le 29/06/2019 17:58 | #
Zut, ça c'est une erreur de ma part qui est passée inaperçue parce que GNU sed est gentil.
J'ai réécrit un bout de l'histoire, utilise git fetch puis git reset --hard origin/master, comme tout à l'heure, pour continuer.
Et merci de ta patience ! Les bugs qu'on corrige là ne devraient plus se présenter pour les prochaines compilations sous Mac. Ils sont résolus pour de bon !
Citer : Posté le 29/06/2019 18:01 | #
Mais c'est moi qui te remercie !
Bon, par contre j'ai encore une erreur, au premier make cette fois-ci :
gcc -c fxos/asm.c -o build/fxos/asm.c.o -Wall -Wextra -std=c11 -g -I fxos/ -D_GNU_SOURCE -DFXSDK_PREFIX='"/Users/antoine/.local"' -MT build/fxos/asm.c.o -MMD -MP -MF build/fxos/asm.c.d
fxos/asm.c:21:3: error: expected ')'
err("too many tables, skipping");
^
fxos/errors.h:61:35: note: expanded from macro 'err'
#define err(str, ...) errf(0, str __VA_OPT__(,) __VA_ARGS__)
^
fxos/asm.c:21:3: note: to match this '('
fxos/errors.h:61:27: note: expanded from macro 'err'
#define err(str, ...) errf(0, str __VA_OPT__(,) __VA_ARGS__)
^
1 error generated.
make: *** [build/fxos/asm.c.o] Error 1
Citer : Posté le 29/06/2019 18:02 | #
Yup, l'un des bugs était resté sur ta copie et du coup je l'ai poussé. git pull te mettra sur les rails.