174 lines
6 KiB
Markdown
174 lines
6 KiB
Markdown
# AdaCasio
|
|
|
|
Building and developing Ada applications for the **Casio fx-CG50**
|
|
|
|
---
|
|
|
|
The Casio fx-CG50 (from here on only called CG50) uses the SuperH architecture. Specifically a custom SH4-A chip. To be able to develope Add-ons, we first need to compile gcc with Ada and SuperH support.
|
|
|
|
> [!NOTE]
|
|
> This guide is mostly based on [Lephenixnoir](https://git.planet-casio.com/Lephenixnoir) guides for building fxSDK manually.
|
|
> I have changed a few parts to add Ada support _without_ an Ada Runtime (Later project)
|
|
|
|
## Building a GNAT cross compiler
|
|
|
|
We start by downloading the `binutils` and `gcc` source code.
|
|
|
|
```bash
|
|
wget -O binutils.tar.gz "https://ftp.gnu.org/gnu/binutils/binutils-2.46.0.tar.gz"
|
|
wget -O gcc.tar.gz "https://ftp.gnu.org/gnu/gcc/gcc-15.2.0/gcc-15.2.0.tar.gz"
|
|
tar -xf binutils.tar.gz
|
|
tar -xf gcc.tar.gz
|
|
```
|
|
|
|
> [!NOTE]
|
|
> You need a working ada compiler to compile ada. If you don't have gnat available in your repo, you can compile a stage1 gcc compiler.
|
|
> For my own sanity sake, I'll just assume that you already have gnat installed on your system.
|
|
|
|
Prepare the build environment to configure the tools.
|
|
|
|
```bash
|
|
mkdir build-binutils build-gcc sysroot
|
|
```
|
|
|
|
`sysroot` is where _gcc_ and _binutils_ is going to be installed at. The `build-*` directories is where the tools are going to be build at. But before we do that we first have to configure them.
|
|
|
|
### Configuring binutils
|
|
|
|
```bash
|
|
cd build-binutils
|
|
../binutils-*/configure \
|
|
--prefix="$(pwd)/../sysroot" \
|
|
--target="sh3eb-elf" \
|
|
--with-multilib-list="m3,m4-nofpu" \
|
|
--program-prefix="sh-elf-" \
|
|
--enable-libssp \
|
|
--enable-lto
|
|
```
|
|
|
|
You might ask yourself now why we chose these flags. Here I have tried to lay out _why_ we use some of these flags.
|
|
|
|
| Flag | Meaning |
|
|
|----------------------- | ----------------------------------------------------- |
|
|
| --prefix | The install path. In our case it's `sysroot` |
|
|
| --target | What our target architecture is. The CG50 uses SuperH |
|
|
| --with-multilib-list | TODO: for what is that? |
|
|
| --program-prefix | prefix of the binuitls tools |
|
|
| --enable-libssp | No Idea |
|
|
| --enable-lto | Link Time Optimization. Glue code faster together |
|
|
|
|
### Compiling binutils
|
|
|
|
We now compile `binutils` with our custom configuration using
|
|
|
|
```bash
|
|
make -j$(nproc)
|
|
make install-strip
|
|
```
|
|
|
|
%TODO: What does configure-host do? why install-strip?
|
|
|
|
We now configure and install `gcc` using the same steps but with different flags.
|
|
|
|
### Configuring GCC (Part 1)
|
|
|
|
We will first compile a working C cross compiler without a libc and add it later on to compile gcc with C++ and Ada support.
|
|
|
|
```bash
|
|
cd ../build-gcc
|
|
../gcc-*/configure \
|
|
--prefix="$(pwd)/../sysroot" \
|
|
--target="sh3eb-elf" \
|
|
--with-multilib-list="m3,m4-nofpu" \
|
|
--enable-languages="c,c++,ada" \
|
|
--without-libada \
|
|
--without-headers \
|
|
--program-prefix="sh-elf-" \
|
|
--enable-libssp \
|
|
--enable-lto \
|
|
--enable-clocale="generic" \
|
|
--enable-libstdcxx-allocator \
|
|
--disable-threads \
|
|
--disable-libstdcxx-verbose \
|
|
--enable-cxx-flags="-fno-exceptions"
|
|
```
|
|
|
|
TODO: Da fuck all these flags for?
|
|
| Column1 | Column2 |
|
|
|--------------- | --------------- |
|
|
| --disable-libada | We will be adding our own runtime |
|
|
| Item1.2 | Item2.2 |
|
|
| Item1.3 | Item2.3 |
|
|
| Item1.4 | Item2.4 |
|
|
|
|
|
|
### Compiling GCC
|
|
|
|
We now compile `gcc` the same way we did `binutils`.
|
|
|
|
```bash
|
|
make -j$(nproc) all-gcc all-target-libgcc
|
|
make install-strip-gcc install-strip-target-libgcc # TODO: may need to add Ada stuff?
|
|
```
|
|
|
|
### Adding libc
|
|
|
|
We will now install a libc implementation that works on the CG50. For that we will use [OpenLibm](https://git.planet-casio.com/Lephenixnoir/OpenLibm) and [fxlibc](https://git.planet-casio.com/Vhex-Kernel-Core/fxlibc/)
|
|
|
|
```bash
|
|
COMPILER_DIR="$(sh-elf-gcc --print-file-name=.)" #TODO: maybe more elegant way to search for path?
|
|
LIBDIR="$COMPILER_DIR"
|
|
INCDIR="$COMPILER_DIR/include"
|
|
git clone https://git.planet-casio.com/Lephenixnoir/OpenLibm.git
|
|
cd OpenLibm
|
|
make USEGCC=1 TOOLPREFIX=sh-elf- AR=sh-elf-ar CC=sh-elf-gcc libdir="$(pwd)/../sysroot/lib/gcc/sh3eb-elf/15.2.0/" includedir="$(pwd)/../sysroot/lib/gcc/sh3eb-elf/15.2.0/include" install-static-superh install-headers-superh
|
|
# make USEGCC=1 TOOLPREFIX=sh-elf- AR=sh-elf-ar CC=sh-elf-gcc \
|
|
# libdir="$LIBDIR" includedir="$INCDIR" \
|
|
# install-static-superh install-headers-superh
|
|
```
|
|
|
|
Now we install the actual libc
|
|
|
|
```bash
|
|
git clone https://git.planet-casio.com/Vhex-Kernel-Core/fxlibc.git
|
|
cd fxlibc
|
|
cmake -B build-gint -DFXLIBC_TARGET=gint -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-sh.cmake -DCMAKE_INSTALL_PREFIX="$SYSROOT" #instead of Sysroot use lib/gcc/15.2.0
|
|
make -C build-casiowin-cg
|
|
make -C build-casiowin-cg install
|
|
```
|
|
|
|
> [!NOTE]
|
|
> There is also gint and vhex form the repo but those target also other calculators that I don't have access to.
|
|
> For my own sanity sake I'll just stick with the casiowin-cg
|
|
|
|
## Compiling GCC (Part 2)
|
|
|
|
Build now the c++ support with
|
|
|
|
```bash
|
|
make -j$(nproc) all-target-libstdc++-v3
|
|
make install-strip-target-libstdc++-v3
|
|
```
|
|
|
|
---
|
|
|
|
## Adding our custom compiler to GPRBuild
|
|
|
|
TODO: look into ironclad gprbuild integration
|
|
|
|
|
|
Sources used:
|
|
- https://osdev.wiki/wiki/GNAT_Cross-Compiler
|
|
- https://www.planet-casio.com/Fr/forums/topic12970-1-tutoriel-installation-manuelle-de-gcc-et-du-fxsdk.html
|
|
- https://gcc.gnu.org/install/configure.html
|
|
- https://git.planet-casio.com/Lephenixnoir/fxsdk
|
|
|
|
---
|
|
Copyright (c) 2026 Ada Orbit. All Rights Reserved.
|
|
|
|
|
|
## TODO
|
|
|
|
Idea space thingy
|
|
|
|
Maybe try installing gcc the way Lephexnior does and just sneakally add --language=ada and no adalib to build everything?
|