Compiling - Leseratte10/d2xl-cios GitHub Wiki

Compiling the d2xl-cIOS requires devkitARM r32, which is pretty old. I did compile devkitARM r32 for a couple newer linux distributions (Debian Buster and Ubuntu Focal), which can be downloaded here, but instead of directly installing that on your machine, I'd recommend to use a Docker container to compile the cIOS, that way you don't have to install an ancient build of devkitARM, and the compiling is more likely to work.

If you are interested in compiling devkitARM yourself, you can take a look at my compile-devkitARM-r32 repository, which contains the Dockerfile and code to compile devkitARM r32.

If you are just interested in compiling the d2xl-cIOS, there is a Dockerfile in this repository that can do exactly that (while downloading a precompiled version of devkitARM from my server).

1. If you haven't already, install Docker (for example, using apt install docker)
2. Checkout the repo and open a terminal in the repository folder
3. Create the docker container using sudo docker image build -t cios . (cios can be any container name you want)
   After that is finished, you have a container named "cios" which is capable of compiling the d2xl-cIOS.
4. Compile the cIOS using sudo docker run -v $(pwd):/docker-mountpoint -it cios
5. The resulting cIOS binaries should be in the folder build (ciosmaps.xml and a d2xl-* subfolder)
6. To recompile again after making changes to the source code, repeat steps 3. and 4. - repeating only step 4 will result in compiling the old version again.

1. Make sure that Virtualization is enabled in your BIOS (if you ever used a Virtual Machine, it probably is)
2. Download and install Docker Toolbox (pick the newest version from here)
   During the installation, select all the additional components and setup tasks.
3. Open the "Docker Quickstart Terminal" icon on your Desktop. It will configure some stuff, then you should see a mingw64 prompt (like yourname@computername MINGW64 /c/Program Files/Docker Toolbox)
4. TODO (this tutorial is still incomplete)

You can now copy the contents of the build folder to the d2x-cios-installer folder and install the cIOS. cIOS created using this method will always have a version number of v999, with the description containing the git commit ID.