[Tutoriel] Installation manuelle de GCC (et du fxSDK)
Posté le 31/05/2014 17:02
Parmi les compilateurs C/C++ modernes de premier plan (LLVM, GCC, MSVC...), GCC est le seul à avoir un backend SuperH, ie. capable de générer des add-ins pour les calculatrices CASIO. Dans ce tutoriel, on va voir comment compiler GCC à la main. J'y mentionne également par le symbole
les étapes supplémentaires nécessaires pour installer le fxSDK tout entier à la main.
Ce tutoriel était initialement utilisé pour toutes les installation de GCC pour la calculatrice, mais il y a maintenant des méthodes automatiques via le dépôt
sh-elf-gcc, via
MiddleArch ou même l'installation complète du fxSDK avec
GiteaPC. Le texte ci-dessous est donc destiné à des personnes relativement expérimentées avec le terminal et les processus classiques de compilation, et spécifiquement à ceux qui voudraient tester des configurations inhabituelles.
Pour relire l'ancien tutoriel, voir sur la forge Gitea.
Ce tutoriel est écrit pour Linux mais vous pouvez le suivre sous Windows 10 en utilisant
WSL qui vous donnera accès à Ubuntu.
1. Présentation du processus
Dans ce tutoriel, on va compiler plusieurs logiciels. Côté compilateur, d'abord
binutils, une suite de programmes qui gère l'assembleur, les fichiers objets, les bibliothèques, et l'édition des liens ; puis
GCC, le compilateur C/C++ en lui-même.
Ensuite on va faire un détour par le fxSDK pour installer la bibliothèque mathématique et la bibliothèque standard C qui sont nécessaires pour avoir accès à la totalité du langage C.
On reviendra alors vers GCC, puisqu'une fois la lib standard C installée on peut compiler la bibliothèque standard C++, qui est là aussi nécessaire pour avoir accès à la totalité du langage C++.
Enfin on pourra finir l'installation du fxSDK avec gint et d'autres bibliothèques.
[fxSDK] Commencez par installer le dépôt
fxsdk, qui fournit la sysroot dans laquelle on va installer le compilateur. C'est un
cmake/
make classique.
2. Installation des dépendances
Nos calculatrices utilisent des processeurs de la famille SuperH, on ne peut donc pas utiliser le même compilateur C que quand on programme pour l'ordinateur. On va utiliser un
cross-compilateur qui ne s'appelera pas
gcc mais
sh-elf-gcc, attention à ne pas confondre !
Téléchargez la dernière version de binutils (
téléchargement ici) ainsi que la dernière version de GCC (
téléchargement ici). En cas d'erreur insondable, vous pourrez toujours tenter d'autres versions plus tard.
Attention : Si votre GCC système est en version 12.1 ou 12.2 (tapez
gcc -v pour le déterminer), vous devez prendre GCC 11.1 pour la calculatrice à cause de
ce bug de GCC pour x86_64.
Bien sûr GCC est un logiciel complexe avec pas mal de dépendances. Voici de quoi les installer :
# Pour Debian, Ubuntu, Mint, WSL pour Windows, et autres dérivés de Debian :
% sudo apt install libmpfr-dev libmpc-dev libgmp-dev libpng-dev libppl-dev flex g++ git texinfo
# Pour Arch Linux, Manjaro, et autres dérivés de Arch :
% sudo pacman -S mpfr libmpc gmp libpng ppl flex gcc git texinfo
- MPFR : calcul flottant à précision arbitraire
- MPC : calcul complexe à précision arbitraire
- GMP : arithmétique entière multi-précision
- libPNG : manipulations d'images PNG
- PPL : optimisation polyhédrique (optimisation magique)
- flex : générateur d'analyseurs lexicaux
- g++ : compilateur C++ pour votre système
- git : gestionnaire de versions
- texinfo : générateur de documentation formatée
3. Préparation de l'environnement de compilation
Le compilateur et toutes les bibliothèques pour la calculatrice vont être installées dans un même dossier. Si vous utilisez le fxSDK, ce dossier est pré-choisi et la commande
fxsdk path sysroot vous l'affiche. Sinon vous pouvez aller où vous voulez, mais restez dans votre dossier personnel.
% export PREFIX="$(fxsdk path sysroot)"
# Exemple de dossier hors fxSDK :
# export PREFIX="$HOME/opt/sh-elf-2.39-11.1.0"
% mkdir -p $PREFIX
Assurez-vous que
$PREFIX/bin est dans votre PATH. Extrayez le contenu des archives que vous avez téléchargées dans un dossier temporaire, et créez deux répertoires
build-binutils et
build-gcc.
% tar -xJf binutils-2.39.tar.xz
% tar -xJf gcc-11.1.0.tar.xz
% mkdir build-binutils build-gcc
On va ensuite appliquer quelques patchs. On va d'abord toucher un fichier de binutils pour éviter la régénération d'un parser avec bison qui ne marche plus depuis longtemps :
% touch binutils-2.39/intl/plural.c
Si vous utilisez GCC 11.1 (et sans doute quelques versions d'avant), téléchargez de plus
ce patch qui désactive des tests de configuration inutilement aggressifs dans la lib C++ et appliquez-le :
% patch -u -N -p0 < gcc-11.1.0-libstdc++-v3-skip-dlopen.patch
4. Compilation de binutils
La compilation de binutils est un configure/make classique. Les options qu'on utilise sont :
- --prefix pour indiquer le dossier d'installation final.
- --target="sh3eb-elf" pour spécifier qu'on veut un cross-compilateur pour SuperH.
- --with-multilib-list="m3,m4-nofpu" indique plus précisément qu'on veut une variante pour SH3 et une pour SH4 sans FPU.
- --program-prefix="sh-elf-" renomme le compilateur de sh3eb-elf-gcc à sh-elf-gcc vu qu'on a aussi le SH3.
Il n'y a pas beaucoup d'autres options intéressantes, mais vous pouvez les voir toutes avec
configure --help.
% cd build-binutils
% ../binutils-2.39/configure --prefix="$PREFIX" --target="sh3eb-elf" --with-multilib-list="m3,m4-nofpu" --program-prefix="sh-elf-"
Une fois que tout est configuré, il n'y a plus qu'à compiler et à installer. Normalement ça va assez vite, comptez quelques minutes.
% make -j4
% make install-strip
Les exécutables de
binutils ont dû apparaître dans
$PREFIX/bin Essayez
sh-elf-ld --version qui doit vous renvoyer la version de binutils (ici 2.39).
5. Compilation de gcc et de libgcc
Ensuite c'est pareil mais pour GCC. En plus des options précédentes, on indique :
- --enable-languages="c,c++" qui spécifie les compilateurs qu'on veut. Si vous voulez expérimenter avec d'autres langages notamment Ada, D, Go ou Fortran, c'est là qu'il faut commencer !
- --without-headers qui indique essentiellement qu'on veut un cross-compilateur.
- --enable-clocale="generic" qui simplifie le module <locale> de la lib C++.
- --enable-libstdcxx-allocator qui fait de même avec les allocateurs mémoire.
- --disable-threads qui désactive le threading (qu'on n'a pas).
- --disable-libstdcxx-verbose qui élimine des logs dans la lib C++.
- --enable-cxx-flags="-fno-exceptions" qui désactive les exceptions durant la compilation de la lib C++.
Voyez
le guide de configuration pour toutes les options utiles.
% cd "$PREFIX/build-gcc"
% ../gcc-11.1.0/configure --prefix="$PREFIX" --target="sh3eb-elf" --with-multilib-list="m3,m4-nofpu" --enable-languages="c,c++" --without-headers --program-prefix="sh-elf-" --enable-clocale="generic" --enable-libstdcxx-allocator --disable-threads --disable-libstdcxx-verbose --enable-cxx-flags="-fno-exceptions
Cette fois la compilation occupera entre 10 et 30 minutes... ou 5/6 heures sur un vieux Raspberry Pi.
% make -j4 all-gcc all-target-libgcc
% make install-strip-gcc install-strip-target-libgcc
Avec ça vous devez pouvoir taper
sh-elf-gcc -v et la version et les options de compilation.
[fxSDK] C'est le moment d'installer
OpenLibm, avec
make.
[fxSDK] Installez aussi la lib C,
fxlibc, un autre
cmake/
make classique.
6. Compilation de libstdc++
On peut maintenant revenir dans le dossier de compilation de GCC et compiler des libs plus évoluées, comme la lib C++. Si vous testez d'autres langages (par exemple D) c'est le moment de compiler les libs qui vont avec (libphobos), ou même de compiler libssl, libiberty, etc. selon vos goûts.
% make -j4 all-target-libstdc++-v3
% make install-strip-target-libstdc++-v3
Et voilà, la toolchain est complète. Si vous manquez d'espace disque vous pouvez supprimez les archives, dossiers de sources, et dossiers de build de binutils et GCC.
Vous pouvez aussi installer
gdb dans la même veine que binutils pour pouvoir debugger les add-ins à distance.
[fxSDK] Installez maintenant
gint, et les autres libs qui vous plaisent (eg. libprof, zlib, etc).
Et voilà, vous avez un compilateur C/C++ complet voire un SDK complet pour programmer des add-ins.
Fichier joint
Citer : Posté le 22/10/2020 13:15 | #
SH3 target works with SH4 CPUs, you can't use SH4 target with newlib
Citer : Posté le 22/10/2020 13:19 | #
Le --target n'est pas un engagement, ici c'est le --multilib-list qui importe, tu as compilé pour SH3 et SH4. Inutile de recompiler quoi que ce soit.
Citer : Posté le 22/10/2020 13:23 | #
avec ../gcc-9.2.0/configure --prefix=$PREFIX --target=sh4eb-elf --with-multilib-list=m3,m4-nofpu --enable-languages=c,c++ --without-headers --with-newlib --disable-nls --program-prefix=sh-elf-r] ?
Citer : Posté le 22/10/2020 14:12 | #
Non, ça ne fera pas ce que tu veux. Inutile d'inventer des choses, le tutoriel est déjà prévu pour les calculatrices SH3 et SH4. Tu as déjà compilé ce qu'il fallait.
Citer : Posté le 22/10/2020 15:44 | #
--target c'est le nom des exécutables de sortie. Ça n'influe en rien les capacités du compilateur, tu peux mettre --target=my-super-compiler que ça marchera quand même.
Par contre si tu change un truc dans le ./configure, faut recompiler pour que ça prenne effet.
Et Lephe a raison. Commence par le tuto de base sans rien toucher, ce sera une bonne première étape.
Citer : Posté le 22/10/2020 16:10 | #
Le nom des exécutables de sortie c'est --program-prefix. --target désigne bien la cible, les valeurs sont bien choisies. Mait ça interagit avec multilib. Compiler avec target=sh3eb-elf et le flag -m4-nofpu à la compilation donnera bien du code SH4.
Citer : Posté le 23/10/2020 10:41 | #
j'ai pas trouvé les include de fx sdk? ils sont ou?
Citer : Posté le 23/10/2020 10:44 | #
Here
Citer : Posté le 23/10/2020 10:46 | #
j'ai bien istallé mais je trouve pas les fichiers d'include
Ajouté le 23/10/2020 à 10:47 :
Citer : Posté le 23/10/2020 10:50 | #
If you made and installed gint properly, gint's include files should be like <gint/include.h>
Citer : Posté le 23/10/2020 10:53 | #
Ah
je voulais faire le tuto sans gint -_- mais bref je vais le faire
Citer : Posté le 23/10/2020 10:55 | #
Le fxSDK est gint sont un groupe, tu peux n'utiliser aucun des deux (et dans ce cas utilise fxlib) ou utiliser les deux, mais y'a pas vraiment d'intérêt à n'en utiliser qu'un. C'est comme si tu prenais que la moitié du fx-9860G SDK.
Citer : Posté le 23/10/2020 15:01 | #
je suis sous wsl
Ajouté le 23/10/2020 à 15:01 :
j'ai pas de gui pour gint
Citer : Posté le 23/10/2020 15:03 | #
Il n'y pas de GUI pour gint et le fxSDK, ce sont des outils en ligne de commande.
Citer : Posté le 24/10/2020 23:28 | # |
Fichier joint
J'ai fait un script d'installation à destination d'Ubuntu :
PREFIX="${HOME}/opt/sh-elf-2.35-10.2.0"
BINUTILS="binutils-2.35"
GCC="gcc-10.2.0"
export PATH="$PATH:${PREFIX}/bin"
echo "export PATH=\"\$PATH:$PREFIX/bin\"" >> ${HOME}/.profile
mkdir -p ${PREFIX}
cd ${PREFIX}
echo "Installing dependencies (sudoer password required)"
sudo apt install libmpfr-dev libmpc-dev libgmp-dev libpng-dev libppl-dev flex g++ git texinfo
echo "Downloading souces"
curl "https://ftp.gnu.org/gnu/binutils/${BINUTILS}.tar.xz" -o "${BINUTILS}.tar.xz"
curl "https://gcc.gnu.org/pub/gcc/releases/${GCC}/${GCC}.tar.xz" -o "${GCC}.tar.xz"
echo "Extract sources"
tar -xf ${BINUTILS}.tar.xz
tar -xf ${GCC}.tar.xz
echo "Create build directories"
mkdir build-binutils build-gcc
echo "Prepare binutils"
cd ${PREFIX}/build-binutils
../${BINUTILS}/configure \
--prefix=${PREFIX} \
--target=sh3eb-elf \
--with-multilib-list=m3,m4-nofpu \
--program-prefix=sh-elf- \
--disable-nls \
--enable-libssp \
--enable-lto \
--disable-werror
echo "Make binutils"
make -j$(nproc)
echo "Install binutils"
make install
echo "Prepare GCC"
cd ${PREFIX}/build-gcc
../${GCC}/configure \
--prefix=${PREFIX} \
--target=sh3eb-elf \
--with-multilib-list=m3,m4-nofpu \
--program-prefix=sh-elf- \
--enable-languages=c,c++ \
--without-headers \
--with-newlib \
--disable-nls \
--enable-libssp \
--enable-lto \
--disable-werror
echo "Make GCC"
make -j$(nproc) all-gcc
echo "Install GCC"
make install-gcc
echo "Compile libgcc"
make -j$(nproc) all-target-libgcc
echo "Install libgcc"
make install-target-libgcc
echo "End"
J'ai testé sous Arch (sans le apt install, ofc), c'est passé. Je veux bien des retours sous Ubuntu & cie.
Pour l'utiliser, c'est simple. Vous copiez-coller le code suivant dans un terminal. C'est moche, mais ça devrait marcher.
Ne faites jamais ça sur votre PC ! Qui vous a dit que le script suivant n'installe pas un malware dans votre dos ? À minima allez lire le code du script avant de l'exécuter.
Citer : Posté le 24/11/2020 14:43 | #
Je le reinstalle sous Oracle VM, et j'ai : bash: ../binutils-2.32/configure: Aucun fichier ou dossier de ce type
Citer : Posté le 02/01/2021 17:34 | #
Si vous avez déjà tenté de compiler GCC, vous avez peut-être eu cette erreur :
Je n'ai pas encore de réponse exacte, mais je peux la reproduire de façon fiable : la compilation marche sur mon Arch personnel, mais échoue sur les systèmes Debian minimaux que je génère avec debootstrap.
Pour l'instant je sais que ça se produit si GCC tente d'utilise le as du système au lieu du sh-elf-as qui est compilé juste avant. Je vais voir si je peux trouver pourquoi ça arrive et comment l'éviter.
Ajouté le 02/01/2021 à 17:44 :
Autre truc du même genre (qu'est-ce que j'en trouve aujourd'hui !) :
Ici GCC n'a pas réussi à trouver le binutils installé avant. Visiblement il cherche sh3eb-elf-* au lieu de sh-elf-*. L'option --program-prefix- qui permet de changer le nom de semble pas l'impressionner (GCC l'applique à lui-même mais part du principe que binutils ne l'a pas reçue).
Je vois au moins une façon moche d'arranger ça, je vais voir si j'ai mieux.
Ajouté le 03/01/2021 à 11:45 :
Après quelques efforts, j'ai mis le doigt sur la raison derrière le deuxième problème.
Le problème est que si on renomme la toolchain, comme on le fait (sh-elf-* au lieu de sh3eb-elf-*), GCC ne trouve pas automatiquement les binaires de binutils. Pour ça, il faut créer quelques liens symboliques avant de configurer. Je ne sais pas exactement pourquoi ça marchait parfois... chez moi il y avait un autre sh3eb-elf-* quelque part, mais c'est pas le cas de toute le monde. Ce qui est sûr c'est que cette erreur on ne devrait plus la revoir.
J'ai pu vérifier que les scripts automatiques sur le dépôt sh-elf-gcc compilent sans problème chez moi (après avoir viré le sh3eb-elf-*) et sur une install Debian vierge, ce qui est bon signe ! Ce tutoriel change rarement mais je pense avoir réellement éliminé un problème.
Pour les packagers (@Dark Storm principalement), avant de configurer GCC il faut linker binutils de cette façon (source dans le contexte) :
ln -s $(command -v sh-elf-as) $PREFIX/sh3eb-elf/bin/as
ln -s $(command -v sh-elf-ld) $PREFIX/sh3eb-elf/bin/ld
ln -s $(command -v sh-elf-ar) $PREFIX/sh3eb-elf/bin/ar
ln -s $(command -v sh-elf-ranlib) $PREFIX/sh3eb-elf/bin/ranlib
Citer : Posté le 14/02/2021 13:43 | #
Bonjour,
Est-ce que avec wsl pour installer gcc et binutils on peut juste faire sudo apt install binutils et sudo apt install gcc sans devoir les compiler à la main?
Citer : Posté le 14/02/2021 13:47 | #
Salut, malheureusement non parce que ça te donnera un compilateur à lancer sur ton ordinateur pour produire des programmes pour ton ordinateur. À la place, tu as besoin d'un compilateur à lancer sur ton ordinateur pour produire des programmes pour ta calculatrice (« un cross-compilateur de l'ordinateur vers la calculatrice »).
Il est donc inévitable de compiler GCC, mais il y a quelques façons de l'automatiser :
• Sous Arch Linux, il y a le paquet AUR de Dark Storm.
• Et pour (normalement) toutes les distributions, tu peux utiliser GiteaPC.
Citer : Posté le 14/02/2021 13:59 | #
Ok merci, je suis en train d'essayer GiteaPC. GitaPc marche sous WSL?
Citer : Posté le 14/02/2021 14:00 | #
En principe oui. Comme c'est un outil un peu récent j'ai pas eu beaucoup de retours encore, donc tu pourrais croiser un bug ; mais on devrait s'en sortir.