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 Math+ (avec MPM)
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 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.
Méthode automatique avec plugin VS Code (plus maintenu)
- Yannis300307 a créé un plugin VS Code Casio Dev Tools qui fonctionne sous Windows (avec WSL) et Debian (probablement les dérivés aussi). Il n'est plus maintenu mais vous pouvez quand même tenter votre chance !
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/02/2025 12:03 | #
> donc je me dit que c'est surement parcque fxsdk-gdb-bridge prende des argument en -- mais apparment non...
Ca ne serait pas pour accepter tout arguments après l'argument "--"? Donc il faudrait faire qch en
fxsdk-gdb-bridge [...] -- --interpreter=mi, non?
Citer : Posté le 28/02/2025 12:11 | #
A oui bien vu !! ça marche maintenant !
Debug sur visual studio code les amis !
Citer : Posté le 28/02/2025 13:05 | #
Merci pour les réponses. C'est un sentiment spécial déjà quand quelqu'un répond à une question sur mon code, encore plus quand j'avais oublié et que la réponse est juste.
Note que pour le debugging seules les commandes de base sont supportées M.machine, donc si tu fais des choses un peu trop complexes dans Visual Studio ça pourrait ne pas marcher.
Citer : Posté le 10/03/2025 18:11 | #
Ne t'inquiète pas XD a par mettre des break point et faire des watch je ne sais pas faire grand chose...
D'ailleurs, je sais que c'est pas l'endroit pour ni le moment mais JE T'ADMIRE LEPHENIXNOIR COMMENT ON PEUT ÊTRE AUSSI FORT
Personnellement je suis encore jeune mais c'est juste incroyable de faire autant de choses incroyables comme ça... (incroyable)
Citer : Posté le 10/03/2025 18:48 | #
Ça c'est du compliment haha, merci. Ça fait bien 10 ans que je suis dessus et mon boulot est adjacent, donc j'ai eu le temps ! Si tu regardes les premières pages de ce topic, le moi d'il y a 10 ans était pas très dégourdi et serait mind blown par les dernières évolutions. Donc hésite pas à traîner ici si tu veux apprendre des trucs stylés !
Citer : Posté le 05/04/2025 19:09 | #
Hello !
J'ai essayé de prendre la version de la libsupc++.a avec "fxsdk path lib" mais il se trouve que j'ai cette erreur quand je l'utilise :
/home/leo/.local/share/fxsdk/sysroot/lib/gcc/sh3eb-elf/14.1.0/../../../../sh3eb-elf/bin/ld: /home/leo/.local/share/fxsdk/sysroot/sh3eb-elf/lib/libsupc++.a(eh_alloc.o): in function `__GLOBAL__sub_I__ZN9__gnu_cxx9__freeresEv':
(.text.startup._GLOBAL__sub_I__ZN9__gnu_cxx9__freeresEv+0x128): undefined reference to `_getenv'
collect2: error: ld returned 1 exit status
make[2]: *** [CMakeFiles/myaddin.dir/build.make:225: myaddin] Error 1
make[1]: *** [CMakeFiles/Makefile2:83: CMakeFiles/myaddin.dir/all] Error 2
make: *** [Makefile:91: all] Error 2
Voici mon makefile au cas ou (mais il marche parce qu'avec une version local/téléchargé de la lib ça compile) :
project("project_name")
include(GenerateG1A)
include(GenerateG3A)
include(Fxconv)
find_package(Gint 2.11 REQUIRED)
execute_process(
COMMAND fxsdk path lib
OUTPUT_VARIABLE FXSDK_LIB_PATH
OUTPUT_STRIP_TRAILING_WHITESPACE
)
#set(LIBSUPCPP "${CMAKE_CURRENT_SOURCE_DIR}/libsupc++.a")
set(LIBSUPCPP "${FXSDK_LIB_PATH}/libsupc++.a")
message(STATUS "Library path: ${LIBSUPCPP}")
file(GLOB_RECURSE API_SRCS
${CMAKE_CURRENT_SOURCE_DIR}/../Sources/src/*.cpp
)
set(SOURCES
./main.cpp
)
set(ASSETS_cg
)
fxconv_declare_assets(${ASSETS} ${ASSETS_fx} ${ASSETS_cg} WITH_METADATA)
add_executable(myaddin ${SOURCES} ${ASSETS} ${ASSETS_${FXSDK_PLATFORM}})
target_compile_options(myaddin PRIVATE -Wall -Wextra -Os -std=c++20 -fno-freestanding)
target_link_libraries(myaddin Gint::Gint ${LIBSUPCPP} stdc++)
set(DIR_OUT ".")
set(NAME_APP "app")
generate_g3a(TARGET myaddin OUTPUT "${DIR_OUT}/${NAME_APP}.g3a"
NAME "NameDsp" ICONS "assets/icon-uns.png" "assets/icon-sel.png")
Albert Einstein
Citer : Posté le 05/04/2025 20:59 | #
getenv() manque dans la libc, tu peux ajouter à ton projet, pour contourner
Citer : Posté le 05/04/2025 21:19 | #
Mais du coup il y a un truc que je ne saisis pas, comment ça se fait que certains libsupc++.a (téléchargé depuis l'exemple du tuto de gint) et celui compilé sur mon pc il n'y ai pas les même fonction dedans ?
Albert Einstein
Citer : Posté le 05/04/2025 21:33 | #
Euh à quel moment il y a un libsupc++.a dans le tuto de gint ?
Pour getenv() le problème vient pas de là. getenv() vient de la libc, c'est la fxlibc qui est coupable car incomplète sur ce point. Dans le "cas du tuto gint" dont tu parles tant qu'aucune fonction de la lib C++ qui dépend de getenv() n'est appelée, tu n'auras pas d'erreur. C'est que quand tu te mets à utiliser les fonctionnalités C++ qui en dépendent que l'erreur se manifeste.
D'ailleurs avant que j'oublie :
1. Ça se linke avec -lsupc++ pas l'archive directe normalement.
2. Dans les versions modernes du fxSDK on compile la lib C++ complète tu peux utiliser -lstdc++ et tu as toute la lib, notamment toutes les structures de données que t'as pas en mode freestanding (bien sûr tout ce qui dépend de trucs manquants dans la libc reste tendu).
Citer : Posté le 05/04/2025 21:55 | #
Euh à quel moment il y a un libsupc++.a dans le tuto de gint ?
ça fait longtemps que je trimbale le fichier de projet en projet que j'ai oublié d'où je l'ai pris
Mais de ce que je me souvienne c'était dans le code source d'un projet de démo.
Ok merci ! Je vais tout mettre au propre !
(Mais je trouve quand même bizarre que j'ai réussi à avoir libsupc++.a depuis un projet Casio qui contient getenv alors que la fxlibc ne l'as pas...)
Albert Einstein
Citer : Posté le 08/08/2025 09:11 | #
Hello, juste un petit up sur un sujet que je n'ai jamais regardé mais qui m'intéresse depuis fort longtemps : la com' via la lib fxlink.
Je voudrais juste signaler que chez moi j'ai dû faire qq ajustements, visiblement le tuto n'est plus à jour. Il faut remplacer :
Utilisation de libfxlink dans un projet
libfxlink expose une interface CMake, comme les autres outils du fxSDK. Du coup, en théorie il suffit d'un appel à find_package() pour la trouver. Cependant, comme le fxSDK ne s'installe pas dans les dossiers système, CMake ne trouvera pas le bon dossier tout seul. Il faut rajouter le bon chemin à la variable CMAKE_MODULE_PATH dans votre CMakeLists.txt :
if(DEFINED "$ENV{FXSDK_PATH}")
list(APPEND CMAKE_MODULE_PATH "$ENV{FXSDK_PATH}/lib/cmake")
endif()
Le code ci-dessous ajoute $HOME/.local (le dossier d'installation par défaut du fxSDK) au dossier de recherche. Ce sera suffisant pour presque tout le monde. Pour les utilisateurs qui installent le fxSDK à la main dans un autre dossier, le chemin $FXSDK_PATH est aussi ajouté, et donc il suffit de fournir la variable d'environnement FXSDK_PATH avec comme valeur le chemin indiqué dans -DCMAKE_INSTALL_PREFIX lors de l'installation du fxSDK.
Ensuite ça se fait comme d'habitude :
# ...
target_link_libraries(<TARGET> PRIVATE LibFxlink::LibFxlink)
Et vous pouvez maintenant coder avec la bibliothèque.
par :
list(APPEND CMAKE_MODULE_PATH "$ENV{HOME}/.local/${SYSROOT}lib/cmake")
if(DEFINED "$ENV{FXSDK_PATH}")
list(APPEND CMAKE_MODULE_PATH "$ENV{FXSDK_PATH}/${SYSROOT}lib/cmake")
endif()
le reste est OK. En fait, il manque ${SYSROOT} dans la chaine initialement donnée, et chez moi je me retrouve avec des erreurs de linkage.
J'espère que ça pourra en aider certains.
Citer : Posté le 08/08/2025 12:18 | #
Merci. Elle vient d'où cette variable par contre ? x) Et c'est un peu louche parce que la sysroot contient normalement les libs pour la calto, pas celles pour le PC. Faut que j'enquête...
Citer : Posté le 08/08/2025 14:09 | #
J'ai trouvé ça dans le cg_monitor.
J'ai réussi à faire fonctionner avec l'ajout en question, mais par contre j'ai encore des merdes, dès que je mets la SDL2 (et ses sous modules images et TTF) et LibFxLink, ça repart en cacahuète et ça trouve pas les libs. J'ai de nouveau des erreurs de linkage sur les fonctions de la LibFxLink
C'est une misère sans nom. Je stoppe pour aujourd'hui car là ça m'a vraiment pris la tête ce matin.
Citer : Posté le 12/08/2025 15:24 | #
Salut !
J'essaye de faire une sorte d'outil sur mon ordinateur pour un jeu sur la graph 90+e. Or j'essaye de convertir les fichier png avec fxconv, qui de maniere logique n'est pas fait pour convertir pour la toolchain GNU.
J'ai donc lu le code de fxconv et le moment interessant est dans la fonction elf() a la ligne 1202.
Donc d'après ce que j'ai compris du code, tout ce qui est fait avant cette fonction est "abstrait" et donc serai compatible avec "n'importe quelle" toolchain.
Mais ducoup est-ce que je remplace juste l'appel aux commande shell de la toolchain de sh-elf-* par celles de GNU ?
Et lors de l'appel a objcopy je met juste l'architecture de mon ordinateur ?
Ou alors il y a plus a faire ?
Merci !
Citer : Posté le 12/08/2025 15:31 | #
La toolchain sh-elf est celle de GNU, mais elle cible les processeurs SuperH au lieu de (j'assume) x86/amd64.
Si t'as envie de convertir des assets, il n'y a généralement aucune raison de modifier cela (et cela causera aussi beacoup de problème avec le linker, qui sera très confus lorsqu'il trouvera un fichier .o pour x86, alors qu'il est censé travailler avec sh4)
Citer : Posté le 12/08/2025 15:36 | #
Oui biensur
Je me suis mal exprimé... en fait le programme pour lequel j'essaye de convertir les assets est pour pour mon ordinateur sois en x86_64...
Et ducoup justement, le linker (donc ici le gcc installé de base) était confu en voyant un fichier .o pour sh4 alors qu'il est censé travailler avec x86_64...
Citer : Posté le 12/08/2025 16:16 | #
Yup, tu peux exactement remplacer l'architecture et garder le même processus. D'ailleurs y'a même une option pour ça dans fxconv : --toolchain. Tu peux voir que les commandes utilisent {toolchain}-objcopy. Stupidement, j'ai hardcodé le tiret donc même si tu mets une toolchain vide tu peux pas réduire ça à juste objcopy. Mais ça peut se modifier facilement.
Cela dit, si tu veux un truc le plus compatible possible, mieux vaut sortir tes données converties sous la forme d'un fichier .c et appeler ton compilateur dessus. Ça ça marchera même avec les toolchains pas GNU.
Citer : Posté le 12/08/2025 16:39 | #
Ok ok je vois merci beaucoup !
Mais ça peut se modifier facilement.
Plus qu'a faire un ticket mdr.
Ou au pire je modifie ça et je fait une demande d'ajout ?
Citer : Posté le 12/08/2025 16:40 | #
Oui tu peux faire une PR
Citer : Posté le 12/08/2025 16:43 | #
Alors par contre je pense qu'il faudrait que j'ai un compte sur la forge de planet casio non ?
Parce que j'ai déjà un git a moi mais il ne servira a rien ici...
Citer : Posté le 12/08/2025 16:46 | #
Oui en effet. Je vais t'en créer un. Pseudo M.machine et avec le même email que ton compte Planète Casio, ça te va ? Sinon envoie-moi ton email voulu par MP.