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 30/06/2019 18:55 | #
Dans ce cas il faut que tu modifies ou crées le fichier /Users/antoine/.profile pour y ajouter la ligne :
puis soit tu redémarres ta session, soit tu utilises la commande "source ~/.profile" dans ton terminal.
Citer : Posté le 30/06/2019 18:55 | #
Au PATH ? le dépôt de gint ? Ou le dossier build dans le dépôt gint ?
Comment je créer ce fichier ?
Ajouté le 30/06/2019 à 19:03 :
Bon, j'ai refait le configure :
No prefix specified, let's ask the compiler:
sh3eb-elf-gcc --print-search-dirs | grep install | sed 's/install: //'
Got '/Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/'.
Configuration saved in Makefile.cfg, ready to make!
Et le make ne s'est pas passé comme prévu:
-e \e[32;1m>\e[0;1m gcc\e[0m r61524/r61524.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/gint.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/setup.c
-e \e[32;1m>\e[0;1m as\e[0m core/vbr.s
-e \e[32;1m>\e[0;1m as\e[0m core/exch.S
-e \e[32;1m>\e[0;1m as\e[0m core/inth.S
-e \e[32;1m>\e[0;1m gcc\e[0m core/mpu.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/start.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/bootlog.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/mmu.c
-e \e[32;1m>\e[0;1m as\e[0m core/syscalls.S
-e \e[32;1m>\e[0;1m as\e[0m render-fx/bopti-asm.s
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dimage.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/topti.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dupdate.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dline.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dclear.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dpixel.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/masks.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/drect.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/bopti.c
-e \e[32;1m>\e[0;1m as\e[0m render-fx/topti-asm.s
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/keysc.c
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/getkey.c
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/iokbd.c
-e \e[32;1m>\e[0;1m gcc\e[0m render/topti.c
-e \e[32;1m>\e[0;1m gcc\e[0m render/dline.c
-e \e[32;1m>\e[0;1m gcc\e[0m std/memory.c
-e \e[32;1m>\e[0;1m gcc\e[0m std/string.c
-e \e[32;1m>\e[0;1m gcc\e[0m tmu/tmu.c
-e \e[32;1m>\e[0;1m as\e[0m tmu/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m rtc/rtc.c
-e \e[32;1m>\e[0;1m as\e[0m rtc/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m dma/dma.c
-e \e[32;1m>\e[0;1m as\e[0m dma/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m t6k11/t6k11.c
-e \e[32;1m>\e[0;1m gcc\e[0m clock/freq.c
-e \e[32;1m>\e[0;1m gcc\e[0m clock/sleep.c
-e \e[32;1m>\e[0;1m ld\e[0m version.o
-e \e[30;1m>\e[0;1m fxconv\e[0m font5x7.png
make: fxconv: No such file or directory
make: *** [src/font5x7.png.o] Error 1
Et j'ai pas compris, comment faire le fichier dans le .profile…
Citer : Posté le 30/06/2019 19:07 | #
Bon, on avance ! Tu as réussi à ajouter le compilateur au PATH. Maintenant il faut aussi ajouter le fxSDK au PATH !
.profile est le fichier. Tu peux l'ouvrir dans un éditeur de texte comme un .c s'il existe et le créer sinon.
Le nouvel export PATH pour le fxSDK doit aussi aller dans .profile !
Citer : Posté le 01/07/2019 07:10 | #
J'ai bien créer un fichier .profil avec cela dedans :
export PATH="$PATH:/Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/bin"
export PATH="$PATH:/Users/antoine/.local/bin"
C'est bon ?
Citer : Posté le 01/07/2019 09:29 | #
*.profile
Citer : Posté le 01/07/2019 13:39 | #
C'est bien ! Vérifie que .profile est bien dans ton dossier personnel (/Users/antoine). Tu n'as pas besoin de la première ligne, tu peux la virer
.profile est lu quand ta session démarre, il faudra donc te reconnecter pour voir les effets.
Citer : Posté le 01/07/2019 16:24 | #
Le nom est bon !
Et j'ai enlevé la première ligne je réessaye !
Ajouté le 01/07/2019 à 16:34 :
2019 après Jésus Christ, tout le dossier gint est envahit, tout ? Non… une petite erreur résiste encore et toujours à l'envahisseur ! Et la vie n'est pas facile pour les camps retranchés alentours…
J'ai refait ./configure puis make voici le terminal avec les deux commandes qui se suivent la sessions à bien été redémarrée et le ./profile est au bon endroit…
No prefix specified, let's ask the compiler:
sh3eb-elf-gcc --print-search-dirs | grep install | sed 's/install: //'
Got '/Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/'.
Configuration saved in Makefile.cfg, ready to make!
pc37:build.fx antoine$ make
-e \e[32;1m>\e[0;1m gcc\e[0m r61524/r61524.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/gint.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/setup.c
-e \e[32;1m>\e[0;1m as\e[0m core/vbr.s
-e \e[32;1m>\e[0;1m as\e[0m core/exch.S
-e \e[32;1m>\e[0;1m as\e[0m core/inth.S
-e \e[32;1m>\e[0;1m gcc\e[0m core/mpu.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/start.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/bootlog.c
-e \e[32;1m>\e[0;1m gcc\e[0m core/mmu.c
-e \e[32;1m>\e[0;1m as\e[0m core/syscalls.S
-e \e[32;1m>\e[0;1m as\e[0m render-fx/bopti-asm.s
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dimage.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/topti.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dupdate.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dline.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dclear.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/dpixel.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/masks.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/drect.c
-e \e[32;1m>\e[0;1m gcc\e[0m render-fx/bopti.c
-e \e[32;1m>\e[0;1m as\e[0m render-fx/topti-asm.s
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/keysc.c
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/getkey.c
-e \e[32;1m>\e[0;1m gcc\e[0m keysc/iokbd.c
-e \e[32;1m>\e[0;1m gcc\e[0m render/topti.c
-e \e[32;1m>\e[0;1m gcc\e[0m render/dline.c
-e \e[32;1m>\e[0;1m gcc\e[0m std/memory.c
-e \e[32;1m>\e[0;1m gcc\e[0m std/string.c
-e \e[32;1m>\e[0;1m gcc\e[0m tmu/tmu.c
-e \e[32;1m>\e[0;1m as\e[0m tmu/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m rtc/rtc.c
-e \e[32;1m>\e[0;1m as\e[0m rtc/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m dma/dma.c
-e \e[32;1m>\e[0;1m as\e[0m dma/inth.s
-e \e[32;1m>\e[0;1m gcc\e[0m t6k11/t6k11.c
-e \e[32;1m>\e[0;1m gcc\e[0m clock/freq.c
-e \e[32;1m>\e[0;1m gcc\e[0m clock/sleep.c
-e \e[32;1m>\e[0;1m ld\e[0m version.o
-e \e[30;1m>\e[0;1m fxconv\e[0m font5x7.png
make: fxconv: No such file or directory
make: *** [src/font5x7.png.o] Error 1
Citer : Posté le 01/07/2019 16:42 | #
Tape /Users/antoine/.local/bin/fxconv pour voir si le programme se lance ?
Citer : Posté le 01/07/2019 16:43 | #
Nope, j'ai ça :
-bash: /Users/antoine/.local/bin/fxconv: /usr/bin/python3: bad interpreter: No such file or directory
Citer : Posté le 01/07/2019 16:45 | #
Raah probablement le chemin qui diffère encore. Bon.
Un coup de git pull et make install du fxSDK et tu peux réessayer.
Citer : Posté le 01/07/2019 16:47 | #
Bon, l'erreur a changé :
-e \e[30;1m>\e[0;1m fxconv\e[0m font5x7.png
Traceback (most recent call last):
File "/Users/antoine/.local/bin/fxconv", line 6, in <module>
import fxconv
File "/Users/antoine/.local/bin/fxconv.py", line 9, in <module>
from PIL import Image
ModuleNotFoundError: No module named 'PIL'
make: *** [src/font5x7.png.o] Error 1
Citer : Posté le 01/07/2019 16:48 | #
Il faut que tu installes le module Pillow de Python.
Citer : Posté le 01/07/2019 16:49 | #
Il ne veut pas :
Error: homebrew/python was deprecated. This tap is now empty as all its formulae were migrated.
pc37:~ antoine$
Citer : Posté le 01/07/2019 16:50 | #
Essaies les instructions indiquées là plutôt du coup :
https://pillow.readthedocs.io/en/3.0.x/installation.html#os-x-installation
Mon blog ⋅ Mes autres projets
Citer : Posté le 01/07/2019 17:14 | #
Bon j'ai make sans problème ! Maintenant le sudo make install me chie dans les bottes :
-e \e[30;1m>\e[0;1m fxconv\e[0m font5x7.png
-e \e[36;1m>\e[0;1m ar\e[0m libgint-fx.a
pc37:build.fx antoine$ sudo make install
Password:
install -d /Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/
install libgint-fx.a -m 755 /Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/
install: -m: No such file or directory
make: *** [install] Error 71
Citer : Posté le 01/07/2019 17:21 | #
Ah ben oui exactement comme le fxSDK en fait !
Tu peux pull et reéssayer. Tu n'as pas besoin de refaire le make.
Citer : Posté le 01/07/2019 17:29 | #
C'est logique en effet
J'ai encore une erreur sur le sudo make install :
Password:
install -d /Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/
install libgint-fx.a -m 755 /Users/antoine/gcc/sh3eb-elf-2.32-8.3.0/lib/gcc/sh3eb-elf/8.3.0/
install: -m: No such file or directory
make: *** [install] Error 71
Citer : Posté le 01/07/2019 17:37 | #
Tu as pas pull ou alors pas au bon endroit !
Citer : Posté le 01/07/2019 17:41 | #
Je suis au bon endroit, j'ai bien pull, mais cela n'a pas été pris en compte :
There is no tracking information for the current branch.
Please specify which branch you want to merge with.
See git-pull(1) for details.
git pull <remote> <branch>
If you wish to set tracking information for this branch you can do so with:
git branch --set-upstream-to=origin/<branch> master
pc37:gint antoine$ git pull(1)
-bash: syntax error near unexpected token `('
Ajouté le 01/07/2019 à 17:46 :
J'ai rien dit ça marche !
J'ai gint !!!!
Merci beaucoup !!
Citer : Posté le 01/07/2019 17:48 | #
Ouais !
... /o/
\o\ ...
! \o/ !
Citer : Posté le 01/07/2019 17:49 | #
Prochaine étape : s'en servir, ça va pas être de la tarte non plus, mais là le problème c'est moi !
Ajouté le 09/07/2019 à 18:21 :
cf mon dernier post : Comment ça marche ?