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 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.
Citer : Posté le 29/06/2019 18:04 | #
L'erreur au make est résolue, mais le sudo make install me renvoie ça :
sed -i '/^PREFIX=\\$/ a \/Users/antoine/.local' /Users/antoine/.local/bin/fxsdk
sed: 1: "/Users/antoine/.local/b ...": command a expects \ followed by text
make: *** [install] Error 1
Citer : Posté le 29/06/2019 18:27 | #
Mais... mais il est là ton backslash. Dans ton terminal, tape cette commande pour voir ?
Citer : Posté le 29/06/2019 18:35 | #
Lorsque je tape ta commande, j'ai :
pc37:fxsdk antoine$ sed -i '/^PREFIX=\\$/ a \ /Users/antoine/.local' /Users/antoine/.local/bin/fxsdk
sed: 1: "/Users/antoine/.local/b ...": command a expects \ followed by text
et après je retompbe sur la même erreur du sudo make install :
pc37:fxsdk antoine$ sudo make install
Password:
install -d /Users/antoine/.local/bin
install -d /Users/antoine/.local/share/fxsdk
install bin/fxg1a bin/fxos /Users/antoine/.local/bin
install fxos/*.txt /Users/antoine/.local/share/fxsdk
install -d /Users/antoine/.local/share/fxsdk/assets
install fxsdk/assets/* /Users/antoine/.local/share/fxsdk/assets
install fxsdk/fxsdk.sh /Users/antoine/.local/bin/fxsdk
sed -i '/^PREFIX=\\$/ a \/Users/antoine/.local' /Users/antoine/.local/bin/fxsdk
sed: 1: "/Users/antoine/.local/b ...": command a expects \ followed by text
make: *** [install] Error 1
Citer : Posté le 29/06/2019 18:55 | #
J'ai tenté une variante, Tape git fetch puis git reset --hard origin/master puis tu peux retenter l'installation
Citer : Posté le 29/06/2019 18:57 | #
J'ai toujours la même erreur :
install -d /Users/antoine/.local/bin
install -d /Users/antoine/.local/share/fxsdk
install bin/fxg1a bin/fxos /Users/antoine/.local/bin
install fxos/*.txt /Users/antoine/.local/share/fxsdk
install -d /Users/antoine/.local/share/fxsdk/assets
install fxsdk/assets/* /Users/antoine/.local/share/fxsdk/assets
install fxsdk/fxsdk.sh /Users/antoine/.local/bin/fxsdk
sed -i '' -e '/^PREFIX=\\$/ a \/Users/antoine/.local' /Users/antoine/.local/bin/fxsdk
sed: 1: "/^PREFIX=\\$/ a \/Users ...": extra characters after \ at the end of a command
make: *** [install] Error 1
Citer : Posté le 29/06/2019 18:58 | #
Essaie cette commande dans ton terminal ? Sans réessayer d'installer après, dis-moi juste si elle marche.
Citer : Posté le 29/06/2019 18:59 | #
Je ne sais pas si cela veut dire marcher, mais elle me renvoie ça :
sed: 1: "/^PREFIX=\\$/ a \ /User ...": extra characters after \ at the end of a command
Citer : Posté le 29/06/2019 19:00 | #
Ça marche pas. Waat. On continue, essaie ceci ?
Citer : Posté le 29/06/2019 19:01 | #
Toujours la même :
sed: 1: "/^PREFIX=\\$/ a /Users/ ...": command a expects \ followed by text
Citer : Posté le 29/06/2019 20:05 | #
J'ai trouvé une solution qui marche sur un vrai Mac que j'ai pu emprunter. Refais un fetch/reset et on réessaie !
Citer : Posté le 29/06/2019 20:21 | #
Hey ! Ça marche !
T'es prêt ? Je fais Gint demain !
Citer : Posté le 29/06/2019 20:29 | #
Ouf !
Chaud pour gint demain ! Quand tu veux !
Je vais rajouter deux notes sur Mac dans les fichiers et le README.
Citer : Posté le 29/06/2019 20:31 | #
Ouais demain aprè'm Comme ça je pourrais jeter un œil mardi, après mon oral et je serais tranquille pour faire ça à fond !
Déjà, je vois se profiler la première erreur que j'anticipe : je n'ai pas de dossier gint, un dépôt à cloner ?
Citer : Posté le 29/06/2019 20:35 | #
Yup, c'est là : https://gitea.planet-casio.com/Lephenixnoir/gint
Attends-toi à pull régulièrement ce que j'enverrai sur le dépôt !
Ajouté le 30/06/2019 à 00:21 :
J'ai ajouté un README au fxSDK. Je vais penser à mettre à jour les tutoriels !
Ajouté le 30/06/2019 à 02:07 :
J'ai refait le post principal avec le tuto comme il faut. Il faut que je fasse pareil côté gint pour mettre le bon lien, et expliquer comment faire des projets avec. Ça va venir !
Citer : Posté le 30/06/2019 13:57 | #
Pas de problèmes !
J'ai cloné le dépôt j'en suis à bash configure avec ce problème : bash: configure: No such file or directory
Citer : Posté le 30/06/2019 16:19 | #
Tu es sûr que tu t'es déplacé dans le dossier de gint ?
Pour l'instant il faut que tu suives cette page, celle de gint est trop vieille (désolé) : https://gitea.planet-casio.com/Lephenixnoir/gint
Citer : Posté le 30/06/2019 17:19 | #
Bon, j'en suis au ./configure --target=fx9860g j'obtient cela :
No prefix specified, let's ask the compiler:
sh3eb-elf-gcc --print-search-dirs | grep install | sed 's/install: //'
configure: line 168: sh3eb-elf-gcc: command not found
Got ''.
Directory does not exist (or is not a directory), giving up.
Configuration saved in Makefile.cfg, ready to make!
Je passe au make et là erreur :
-e \e[32;1m>\e[0;1m gcc\e[0m r61524/r61524.c
make: sh3eb-elf-gcc: No such file or directory
make: *** [src/r61524/r61524.c.o] Error 1
J'ai fait ça pour récupperer le contenu du dépôt : git checkout origin/compat puis git checkout -b master
Citer : Posté le 30/06/2019 18:38 | #
Bon alors l'erreur de regex est de ma faute, mais pourquoi tu veux changer ATEXIT_MAX aussi ?
Le compilateur est pas dans le PATH. Tu te souviens du $PREFIX que tu avais défini dans le tutoriel de compilation de GCC ? Un truc du genre /Users/antoine/Casio/sh3eb-elf.
Tu dois ajouter le sous-dossier bin au PATH sinon personne ne peut appeler le compilateur.
Note : tu devrais refaire le ./configure qui n'a pas marché !
Citer : Posté le 30/06/2019 18:49 | #
D'accord, mais j'ai trouvé pourquoi : hier quand j'ai recompilé en Sh3, ben c'était du SH4 !
Sinon ouais, j'ai retrouvé le préfix : /Users/antoine/gcc/sh3eb-elf-2.32-8.3.0
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.