Setting up Development Environment

Setup

• Install devkitARM. If it's already installed, update it. On Windows there's a GUI installer. On Linux/Mac there's a perl-script. Make sure you also select ctrulib when installing.
• Download the files in the ctrulib repository (even though the library has already been installed) because the repository contains a 3DS project template and examples.

Linux

• First get the devkitARM updater Perl script for Linux.
• Run it with superuser privileges if your /opt directory is not marked world read-writeable.
• Get ctrulib from Smealum's GitHub repository, build and install it.

sudo -s
curl -L http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/devkitARMupdate.pl/download -o devkitARMupdate.pl
chmod +x ./devkitARMupdate.pl
./devkitARMupdate.pl
cd /opt/devkitpro
git clone git@github.com:smealum/ctrulib.git
cd ctrulib/libctru
make
make install

Building the examples

3DS examples are still being created. Currently there are a few examples in the separate ctrulib download under the "examples" folder.

• arm11u: simple homebrew example
• sdmc: demonstrates how to access files on the SD card
• mic: demonstrates how to read sound from the microphone
• gpu: demonstrates how to render 3D geometry with the GPU

Building homebrew for distribution

To build your homebrew open a terminal, browse to your homebrew's folder and run make.

• This will build a .elf file and a .3dsx file together with an icon. The icon and .3dsx file are the format required for the Homebrew Channel.

• To build a Gateway-compatible .3ds file you need to strip the .elf file and use makerom on it (with the provided RSF file):

arm-none-eabi-strip [ELF file]
makerom -f cci -o [.3ds file] -rsf [RSF file] -target d -exefslogo -elf [ELF file] -icon [icon file] -banner [banner file]