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 10/12/2019 18:53 | #
Ton paquet python-pillow ne doit pas être à jour.
Citer : Posté le 11/12/2019 11:18 | #
Je ne comprends toujours pas
Mon paquet python et mon paquet python-pillow sont à jour, et alors que j'ai la version 3.8 de python, python-pillow s'installe dans le dossier python3.7
Ajouté le 11/12/2019 à 11:30 :
En fait je n'ai rien dit, manjaro vient de publier un paquet de mises à jour, je vous redirai ça après
Ajouté le 11/12/2019 à 11:31 :
Ça marche, je n'ai définitivement rien dit
Citer : Posté le 11/12/2019 13:24 | #
Voilà qui est mieux ! Amuse-toi bien
Citer : Posté le 30/12/2019 16:32 | #
J'ai une petite question est-ce que fxSDK a été porté sur Windows ou pas encore car je serait intéréssé
Citer : Posté le 30/12/2019 17:50 | #
Pas encore, mais c'est envisageable. Le moyen idéal c'est si quelqu'un serait prêt à tester au fur et à mesure pour debugger.
Comme je suis en train de sortir fxos du fxSDK, et que c'est la principale source d'incompatibilités, on devrait être pas mal. Reste essentiellement la façon dont fxconv appelle les sous-process- ah mais non en fait puisque c'est en Python ça.
Donc en fait il reste quoi, l'outil fxsdk qui est en Bash actuellement (je pourrais le faire en Python à la place), et des détails pour le reste sans doute. Ça devrait pas être trop dur.
Citer : Posté le 04/01/2020 13:56 | # | Fichier joint
Bonjour ! j'ai une erreur à l'étape du "make" : voici l'erreur :
Dijkstra - The Witcher
Citer : Posté le 04/01/2020 14:18 | #
Il te manque libpng.
Citer : Posté le 04/01/2020 14:21 | #
Pourtant, j'ai bien installé gcc et libgcc avant...
Dijkstra - The Witcher
Citer : Posté le 04/01/2020 14:32 | #
C'est autre chose. libpng est une bibliothèque pour manipuler des images PNG. Il faut que tu l'installes avec ton gestionnaire de paquets. Tu peux compiler GCC sans l'avoir, il va juste se débrouiller pour ne pas s'en servir. Mais le fxSDK en a vraiment besoin.
Citer : Posté le 20/01/2020 16:30 | #
Hi I have a small question: Does fxSDK have commands related to outputting sound/square wave? (It seems to be true because C.Basic has them, too)
If yes, then I would like to propose a feature for testing the sound.
Is it a good idea?
Citer : Posté le 20/01/2020 18:06 | #
Hi, so the library/kernel behind the fxSDK, which is called gint, does not currently support sound output. I have experimental code which shows how it can be done, however I feel that the result is still unsatisfactory. There is old code by Martin Poupe which changes the state of the serial output pin fast enough to produce analog output, with very good sound quality, although low volume. I wanted to experiment with that before merging my code in gint. (There are also performance issues because sending a lot of data to the serial port eats up most of the available CPU power.)
In any case, I am interested in your testing feature. Can you tell me a bit more about it?
Citer : Posté le 20/01/2020 18:39 | #
So the concept is like this:
| Sound frequency:
| [1000] Hz
| Sound duration:
| [1] seconds
| [TEST] [APPLY]
---------------------------
You can adjust the tone by changing the sound frequency and length by changing the sound duration.
Then, you can press [TEST] to have a trial on this sound.
If it is desired, press apply and fxSDK/gint will automatically generate the code to create it.
(Actually what I'm doing here is very similar with the functions of C.Basic Beep command)
Citer : Posté le 20/01/2020 18:41 | #
This is a good idea, indeed!
When I tested my code I added a function where the pattern of the wave could be chosen. I hoped to create a small collection of sounds that I could later recompose in games. But it doesn't give very good results.
Citer : Posté le 20/01/2020 18:51 | #
If I understand what you mean , then did you try this one? (Website) It has four kinds of wave sounds for you to test.
http://onlinetonegenerator.com/
And this website has most of the frequency that corresponds to the tone: (C, C#, D, E ...)
https://www.szynalski.com/tone-generator/
Citer : Posté le 21/01/2020 07:27 | #
Yes it's like this! Except that we can only output square waves unless we use really high frequencies, hence the "pattern" is a binary string that is repeated all over.
Citer : Posté le 29/01/2020 10:45 | #
Bonjour,
j'ai découvert que l'on pouvait utiliser fxconv avec --script pour la conversion avec un script personnalisé :o
Ça a l'air super pratique, y a-t-il un moyen de faire en sorte comme une ligne dans le fichier de config pour qu'il soit automatiquement appelé à chaque build pour les fichiers d'un dossier spécifique ?
Et je n'ai pas encore compris si il faut que je linke le fichier objet après, ou si cela est fait automatiquement
Ajouté le 29/01/2020 à 10:51 :
Ah, si j'en crois le message d'erreur ce n'est pas pour tout de suite
Je vais trouver un autre moyen
Ajouté le 29/01/2020 à 10:53 :
Est-ce que fxconv peut convertir en binaire automatiquement à chaque build ou je dois le faire à la main ?
Citer : Posté le 29/01/2020 11:28 | #
Ah, si j'en crois le message d'erreur ce n'est pas pour tout de suite
En fait cette option n'a quasiment rien à faire, il suffit de changer le PYTHONPATH pour inclure le dossier d'install du fxSDK et ensuite import fxconv. Le module est déjà documenté avec plein d'outils. Tu peux le faire sans difficulté
Ensuite dans ton Makefile tu peux invoquer ton script avec un fichier à convertir à chaque fois (remplace juste fxconv par le script) et tout est bon.
En binaire, c'est-à-dire ? Si tu veux encoder un fichier de données brutes sans conversion pour y accéder dans le programme, utilise -b.
Citer : Posté le 29/01/2020 11:47 | #
Je suis en train d'écrire un script qui exploite fxconv et qui compile tous les niveaux
Est-ce que fxconv peut convertir en binaire automatiquement à chaque build ou je dois le faire à la main ?
En binaire, c'est-à-dire ? Si tu veux encoder un fichier de données brutes sans conversion pour y accéder dans le programme, utilise -b.
Citer : Posté le 29/01/2020 12:12 | #
Ah, ok ! Oui, comme tu peux le voir ici : https://gitea.planet-casio.com/Lephenixnoir/fxsdk/src/branch/master/fxsdk/assets/Makefile#L136
Il suffit de les mettre dans le dossier bin et ensuite dans le fichier de projet tu écris BIN.lefichier = <props>...
Citer : Posté le 01/02/2020 16:49 | #
Si dans le fichier de configuration, j'ajoute le fichier qui est dans assets-fx/bin/, sous quel nom apparaîtra-t-il dans le programme ?
Il s'appellera bin_<monfichier> ?
Citer : Posté le 01/02/2020 17:27 | #
Oui par défaut le fichier s'appelle comme ça. Par exemple assets-fx/bin/level1.data s'appellera bin_level1. Tu peux le voir dans le Makefile que j'ai lié juste au-dessus !
Cela se produit tout seul même si tu ne mets rien dans le fichier de config. Par contre si tu utilises le fichier de conf tu peux changer ça :