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 05/07/2015 09:06 | #
Vive Arch et sa rolling release d'ailleurs
Citer : Posté le 05/07/2015 09:27 | #
[insistance]Je peux avoir les sources?
Oui. Ne t'inquiète pas, elles arrivent.
Le temps de nettoyer du code et d'ajouter un tout petit poil de fonctionnalité (déplacement et suppression des ressources), vous pourrez tester.
Citer : Posté le 05/07/2015 09:55 | #
Cool
Citer : Posté le 05/07/2015 17:34 | #
C'est super beau !
Pong400
PierrePaCiseaux (CP400)
Les Triangles
Menu
ASCII
Nombres premiers
Citer : Posté le 05/07/2015 18:05 | #
Enfin, ça c'est quand tu as les bonnes tailles de police
Palindrome de points
Citer : Posté le 05/07/2015 18:05 | #
J'ai mis à jour le screen qui commençait un peu à vieillir. Maintenant que j'ai le noyau du programme, j'ai besoin de vous.
J'aurais besoin de deux/trois testeurs sous Linux avec un compilateur de type sh3eb-elf-gcc.
Seul prérequis : il vous faut Qt 5. Pour ce qui est de la compilation du fxSDK et des quelques tests que je vous demanderais, il y en a pour tout au plus 20/30 minutes.
Voilà, merci à ceux qui prendront le temps pour ce test.
Citer : Posté le 05/07/2015 18:10 | #
Prêt à servir sous tes ordres, Chef
Citer : Posté le 05/07/2015 18:13 | #
Intelligide, sers-toi dans les sources que je vais t'envoyer du coup.
Je précise quand même que les fichiers HighlighterCpp.cpp et CodeEdit.cpp sous implicitement sous des conditions de licenses plus restrictives, donc ne les utilise pas.
Citer : Posté le 05/07/2015 18:13 | #
Pareil pour moi si je peux aider.
Citer : Posté le 05/07/2015 18:21 | #
Intelligide, sers-toi dans les sources que je vais t'envoyer du coup.
Je précise quand même que les fichiers HighlighterCpp.cpp et CodeEdit.cpp sous implicitement sous des conditions de licenses plus restrictives, donc ne les utilise pas.
Tkt pas, je vais juste jeter un coup d'oeil au colorateur syntaxique
Citer : Posté le 05/07/2015 18:24 | #
C'est l'exemple de Qt de toute façon, il est en ligne...
Je vais vous envoyer de suite un MP à tous les deux. Au passage, gardez le lien de téléchargement de l'archive pour vous pour l'instant.
Ajouté le 05/07/2015 à 18:31 :
Voilà, MPs envoyés malgré mon réseau hypothétique...
Citer : Posté le 05/07/2015 19:20 | #
J'ai l'impression que l'archive est corrompue...
Quand j'essaie de l'extraire, il me sort ça...
tar: Child returned status 1
tar: Error is not recoverable: exiting now
Enfin, je pense pas m'y prendre mal pour le coup, donc je sais pas trop...
Citer : Posté le 05/07/2015 19:27 | #
Voilà que maintenant elle fait 1.6 Mio... -_-
Punaise, le stockage en ligne...
J'ai mis à jour le fichier d'instructions et corrigé le tout.
Citer : Posté le 05/07/2015 19:58 | #
Comme quoi
Citer : Posté le 05/07/2015 20:07 | #
Sérieux, va expliquer pourquoi avec wget ça fonctionne mais pas avec le navigateur... -_-
Citer : Posté le 05/07/2015 20:14 | #
Ça t'ira lui demander
Plus sérieusement, t'as essayé sur d'autres sites .
Citer : Posté le 05/07/2015 21:01 | #
Hop, petit résumé rapide :
- Pour ce qui est de la police, comme avec DS, elle était quand même plutôt petit je trouve, mais en augmentant la taille c'est de suite lisible (sauf, comme DS encore, pour certains éléments (numéro des lignes, noms d'onglets pas en "focus", noms des fichiers, la chaîne "Compiler Output", etc... Mais tu es déjà au courant je crois bien !
- Pour ce qui est de l'aspect, c'est tout comme sur les captures, et "en plus" c'est propre et joli !
- Pas de soucis de coloration syntaxique à priori.
- Pour le build, il manquait le wrapper, du coup je te met le log sans le wrapper, et le log après l'avoir ajouté.
sh3eb-elf-gcc -c /home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c -o build/main.c.o -m3 -mb -O9 -Wall -Iinclude -Llib -L/home/nemo/Dev/Lephe/fxSDK-b/tmp
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c: In function 'main':
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:50:3: warning: implicit declaration of function 'cos' [-Wimplicit-function-declaration]
p[i].x = 24 * cos(angle) + 64;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:50:17: warning: incompatible implicit declaration of built-in function 'cos' [enabled by default]
p[i].x = 24 * cos(angle) + 64;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:51:3: warning: implicit declaration of function 'sin' [-Wimplicit-function-declaration]
p[i].y = 24 * sin(angle) + 32;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:51:17: warning: incompatible implicit declaration of built-in function 'sin' [enabled by default]
p[i].y = 24 * sin(angle) + 32;
^
sh3eb-elf-as -c /home/nemo/Dev/Lephe/fxSDK-b/tmp/crt0.s -o build/crt0.s.o
sh3eb-elf-gcc build/main.c.o build/crt0.s.o -o "build/tmp.elf" -T addin.ld -nostdlib -Llib -L/home/nemo/Dev/Lephe/fxSDK-b/tmp -lfx
/
usr/local/cross/lib/gcc/sh3eb-elf/4.8.2/../../../../sh3eb-elf/bin/ld: warning: section `.bss' type changed to PROGBITS
sh3eb-elf-objcopy -R .comment -R .bss -O binary "build/tmp.elf" "build/tmp.bin"
g1a-wrapper "build/tmp.bin" -o "tmp.g1a" -i icon.bmp
make: quittant le répertoire « /home/nemo/Dev/Lephe/fxSDK-b/tmp »
/bin/sh: 1: g1a-wrapper: not found
make: *** ["tmp.g1a"] Erreur 127
sh3eb-elf-gcc -c /home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c -o build/main.c.o -m3 -mb -O9 -Wall -Iinclude -Llib -L/home/nemo/Dev/Lephe/fxSDK-b/tmp
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c: In function 'main':
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:50:3: warning: implicit declaration of function 'cos' [-Wimplicit-function-declaration]
p[i].x = 24 * cos(angle) + 64;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:50:17: warning: incompatible implicit declaration of built-in function 'cos' [enabled by default]
p[i].x = 24 * cos(angle) + 64;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:51:3: warning: implicit declaration of function 'sin' [-Wimplicit-function-declaration]
p[i].y = 24 * sin(angle) + 32;
^
/home/nemo/Dev/Lephe/fxSDK-b/tmp/main.c:51:17: warning: incompatible implicit declaration of built-in function 'sin' [enabled by default]
p[i].y = 24 * sin(angle) + 32;
^
sh3eb-elf-as -c /home/nemo/Dev/Lephe/fxSDK-b/tmp/crt0.s -o build/crt0.s.o
sh3eb-elf-gcc build/main.c.o build/crt0.s.o -o "build/tmp.elf" -T addin.ld -nostdlib -Llib -L/home/nemo/Dev/Lephe/fxSDK-b/tmp -lfx
sh3eb-elf-objcopy -R .comment -R .bss -O binary "build/tmp.elf" "build/tmp.bin"
g1a-wrapper "build/tmp.bin" -o "tmp.g1a" -i icon.bmp
/usr/local/cross/lib/gcc/sh3eb-elf/4.8.2/../../../../sh3eb-elf/bin/ld: warning: section `.bss' type changed to PROGBITS
offset : 130
header size : 108
[W] Unreconized BMP file. Icon will be BLANK.
Output size is 1036 bytes.
make: quittant le répertoire « /home/nemo/Dev/Lephe/fxSDK-b/tmp »
- Pour ce qui est de l'ajout / suppression de fichiers dans le projets, pas de soucis, enfin, pas de comportement anormal en tout cas !
- Il y a bien les 3 chemins dans le terminal.
- Le projet a l'air de bien charger (par contre j'ai mis un petit moment avant de comprendre qu'il fallait choisir le dossier et non le fichier .pro pour le charger
- Je testerai bien le g1a... Si j'avais la machine pour...
Enfin en tout cas ça promet, c'est propre joli, léger ! Et puis, puisque ça carbure au makefile, une version adaptée également à la Prizm sera l'affaire de peu de boulot je pense !
En revanche, il y a un effet digne d'un Windows qui plante quand on passe une fenêtre devant celle du sdk !
Citer : Posté le 05/07/2015 21:24 | #
Merci pour toutes les remarques !
Je m'occuperai de la taille de police.
Pour le wrapper, en fait, c'est le mien, j'ai oublié de vous le passer en même temps...
Je vais changer pour choisir le fichier .pro au lieu du répertoire, c'est mieux.
Pour l'effet « Windows », c'est géré par Qt... pas par moi, a priori. D'autant plus que je ne l'ai pas...
Encore merci
Ajouté le 09/07/2015 à 13:41 :
J'ai automatisé la coloration syntaxique avec une classe Qt facilement utilisable (elle hérite de QSyntaxHighlighter). Il ne me reste qu'à gérer plusieurs règles dites « multiples » (qui peuvent agir sur plusieurs lignes) et le tout sera complet.
Ça me donne des fichiers comme ça :
##
# fxSDK syntax definition file.
# Warning: this file follows a strict syntax. Please do not edit.
##
[Meta]
lang: C/C++
[SingleRules]
name: types.native
regex: \b(?:void|char|short|int|long|float|double|enum|union [i][...][/i]
color: #55afff
name: types.extra
regex: \b(?:ushort|u?int(?:8|16|32)_t|s?size_t|template|class [i][...][/i]
color: #55afff
name: types.qualifiers
regex: \b(?:register|extern|const|static|volatile|inline [i][...][/i]
color: #ff2e4c
name: constants.define
regex: \b(?:true|false|NULL|nullptr)\b
color: #ae6deb
name: constants.numeric
regex: \b\d+\b|\b0x[\dA-Fa-f]\b
color: #ae6deb
name: functions.call
regex: \b[A-Za-z_]\w*(?=\()
color: #55afff
name: functions.def
regex: \b[A-Za-z_]\w*\s+([A-Za-z_]\w*)(?=\()
color: #80d435
name: statements
regex: \b(?:if|else|for|do|while|switch|case|default|continue [i][...][/i]
color: #ff2e4c
name: statements.cpp
regex: \b(?:try|catch|throw|new|delete|operator|namespace)\b
color: #ff2e4c
name: preprocessor
regex: ^\s*#\s*(if|else||elif|ifdef|ifndef|endif|undef|include|define|pragma|not [i][...][/i]
color: #ff2e4c
name: iso646
regex: \b(?:and|and_eq|bitand|bitor|compl|not|not_eq|or|or_eq [i][...][/i]
color: #ff2e4c
name: comment.single
regex: //[^\n]*
color: #464646
[MultiRules]
name: comment.multi
open: /\*
close: \*/
color: #464646
Le principe des règles est que si la regex contient au moins une capture, ce sont les captures qui sont colorées, sinon c'est la partie validée en général.
J'ai fait ça pour les instructions préprocesseur à la base (#instruction, avec instruction seulement colorée), parce que je ne pouvais pas utiliser un negative lookbehind pour chercher le début de ligne + un potentiel espacement + le dièse + un potentiel espacement puisque la plupart des moteurs de regex ne peuvent utiliser le lookbehind que si sa longueur est définie, ne sachant pas appliquer les regex à l'envers.
Au final, je suis assez content du résultat. C'est souple et facile d'utilisation (et puis ça me fait bosser mes regex
Citer : Posté le 09/07/2015 15:25 | #
copie tout ce que fait Lephe
.
.
.
.
Oups
Citer : Posté le 09/07/2015 15:28 | #
Tu pourra l'utiliser si tu veux.
Ajouté le 09/07/2015 à 16:32 :
Et voilà, la coloration multi-ligne est opérationnelle ! \o/
Ah, ce bonheur de pouvoir éditer de fichiers de définition et avoir le résultat sans plus de difficulté...
Au fait Intelligide, tu la gères comment ta coloration syntaxique toi ?
Citer : Posté le 09/07/2015 16:36 | #
Au fait Intelligide, tu la gères comment ta coloration syntaxique toi ?
Ben avec un fichier XML pour le style et les couleurs et une QList contenant les regex