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 12/07/2019 13:44 | #
Ok, j'essaye !
Citer : Posté le 12/07/2019 13:52 | #
Tu peux aussi ne pas mettre d'espace du tout. Je pense que Tiled te permet de dire combien tu en as mis.
Le principe c'est que chaque case de la map doit contenir le numéro du tile associé dans le tileset. Si tu n'as pas tous les tiles dans la même image comment leur attribuer des numéros ? Et surtout comment garantir qu'on aura les mêmes numéros côté add-in que côté Tiled ?
En plus tout stocker ensemble est beaucoup plus efficace avec gint.
Citer : Posté le 12/07/2019 13:52 | #
Je m'y met (au passage il faudra que je règle le pixel parce que là j'ai tout décalé
Citer : Posté le 12/07/2019 15:20 | # |
Fichier joint
J'ai fait un tilset avec toutes les tiles du jeu (y en a 101
Ajouté le 12/07/2019 à 15:50 :
J'ai modifié le tilset, je te re-donnerai le dossier complet
Citer : Posté le 12/07/2019 15:51 | #
T'inquiète, c'est surtout le principe qui compte
Citer : Posté le 12/07/2019 15:53 | #
Alors en fait, t'as pas fourni le tileset, seulement le chemin relatif vers lui
Odysée_tileset.tsx
<tileset version="1.2" tiledversion="1.2.4" name="Odyssée_tileset" tilewidth="8" tileheight="8" spacing="1" tilecount="112" columns="16">
<image source="../../Odyssée/Dessins/Odyssée_tileset.png" width="143" height="62"/>
</tileset>
Citer : Posté le 12/07/2019 15:56 | #
Ben j'ai donné le *.tmx
Citer : Posté le 12/07/2019 15:57 | #
Odysée.tmx
<map version="1.2" tiledversion="1.2.4" orientation="orthogonal" renderorder="right-down" width="16" height="8" tilewidth="8" tileheight="8" infinite="0" backgroundcolor="#ffffff" nextlayerid="2" nextobjectid="1">
<tileset firstgid="1" source="Odyssée_tileset.tsx"/>
<layer id="1" name="Tile Layer 1" width="16" height="8">
<data encoding="csv">
24,25,24,25,77,13,77,13,63,13,72,29,29,29,29,29,
40,41,40,41,68,70,69,69,101,72,69,29,15,0,15,29,
20,23,19,20,68,88,85,102,70,86,102,29,15,0,15,29,
20,22,20,20,13,76,48,62,79,91,92,29,15,0,15,29,
62,62,60,77,97,29,32,32,11,12,32,32,0,0,0,14,
63,75,92,92,0,0,0,32,27,28,32,0,0,0,0,0,
90,91,92,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
</data>
</layer>
</map>
Ça c'est ta map que tu exporte en csv
Citer : Posté le 12/07/2019 15:59 | #
AH… okay…
Citer : Posté le 12/07/2019 16:13 | # |
Fichier joint
Bon, j'ai tout remis dans le zip ^^' j'ai pas encore fait les fontaines, mais je ne sais pas si je les mettrait…
Citer : Posté le 15/07/2019 19:22 | #
Y a-t-il un manip' particulière pour créer des add-in sur Graph 90 ?
Citer : Posté le 15/07/2019 19:23 | #
Oui !! Il faut installer le g3a wrapper, disponible ici
Citer : Posté le 15/07/2019 19:24 | #
donc j'installe le sdk normalement puis j'installe ce wrapper ?
Citer : Posté le 15/07/2019 19:25 | #
C'est ça
Je te conseille de mettre le dossier télécharger dans un autre dossier, ensuite tu te places dans ce dossier et tu lances cmake et après make puis make install
Citer : Posté le 15/07/2019 19:26 | #
Il faut installer mkg3a car je n'ai pas encore implémenté de programme équivalent dans le fxSDK. Sinon, c'est tout pareil mais tu remplaces fx par cg partout.
Si tu utilises gint il faut bien sûr une version Graph 90, c'est pareil que pour la Graph monochrome mais à la compilation on remplace --target=fx9860g par --target=fxcg50. Les fonctions de gint sont très proches, la seule différence majeure c'est que les couleurs sont pas définies pareil.
Et... c'est tout ! fxsdk build-cg puis tu installes et tout le reste roule.
Citer : Posté le 15/07/2019 19:56 | #
J'ai un bug là
fxg1a/file.c:1:10: fatal error: sys/types.h: Aucun fichier ou dossier de ce type
#include <sys/types.h>
^~~~~~~~~~~~~
compilation terminated.
Makefile:58: recipe for target 'build/fxg1a/file.c.o' failed
make: *** [build/fxg1a/file.c.o] Error 1
Et ça me fait la meme pour tous les fichiers du dossier sys.
Après, là je n'ai pas installé le compilateur, don je m'attends à des bugs, mais là je n'ai pas l'impression que ça ait quelque chose à voir
Citer : Posté le 15/07/2019 19:56 | #
@Shadow15510 Attends, je comprend pas trop...
J'ai copié le Git mkg3a dans un dossier à part et ensuite ?
(J'ai installé ubuntu pour l'occasion donc je ne suis pas très à l'aise avec)
Citer : Posté le 15/07/2019 19:58 | #
Tu compiles sur quel système Milang ? Je suppose que je dois améliorer la compatibilité du code, mais un système qui n'a pas <sys/types.h>, c'est exotique... ça compilait même sur un Mac
Tu configures et tu compiles mkg3a, il y a certainement des instructions dans le README
Citer : Posté le 15/07/2019 20:12 | #
@Leno : tu as pas téléchargé le dossier… Il est dispo là : https://bitbucket.org/tari/mkg3a/downloads/ Ensuite ce dossier téléchargé tu le place dans un autre dossier.
Par exemple, je télécharge le dossier et je le renomme g3a_wrapper je créer ensuite un autre dossier nommé fxcg-50. Je place g3a_wrapper dans le dossier fxcg-50. Grâce à cd (Mac/Linux) ou mv (windows) tu change de répertoire de travail
Citer : Posté le 15/07/2019 21:04 | #
J'ai réussi à l'installer
Ensuite je dois installer Gint ?
Citer : Posté le 15/07/2019 22:41 | #
Si tu ne l'as pas encore fait alors oui ! Mais tu devras d'abord passer par la case GCC, celle que Milang a sautée
(Y'en a pas d'autres, après GCC et gint c'est fini