Tutorial 1

How to setup devkitARM with Gamepark official SDK.

In this tutorial you will learn how to set up the devkitARM toolchain to develop GP32 programs using the Gamepark official SDK. The devkitARM toolchain is part of the devkitPro project.

You shouldn't spend more than 10 minutes to setup the SDK and test it.

1. Download needed files.

• devkitARM toolchain on devkitPro project website. The file you need should be something like devkitARM_r??-win32.exe.

• GamePark libraries including 16 bits colors libraries (142 KB).

• make.exe (63.6 KB).

• 16 bits C test program, or 16 bits C++ test program (70.1KB).

2. Install devkitARM.

• Execute devkitARM_r??-win32.exe and choose a destination folder, for example C:\. All files in the archive will be unpacked in the folder C:\devkitARM_r??.

• Rename folder C:\devkitARM_r?? to C:\devkitARM, if needed.

3. Unpack gamepark_sdk16bits.zip.

• Extract all files in gamepark_sdk16bits.zip into the C:\devkitARM folder. The new folder C:\devkitARM\gamepark_sdk should appear.

4. Unpack make.exe.zip.

• In the archive make.exe.zip there is only one file, extract it into the C:\devkitARM\bin folder.

5. Add compiler binaries path to Windows path.

• Right click on My Computer.

• Click on Properties.

• Choose the Advanced tab.

• Click on Environment variables.

• In the second table, double click on the Path variable.

• Add C:\devkitARM\bin on the line. Don't forget to separate the path with a ';' from other path already included in the Path variable.

• Accept all changes.

• In some cases, you will have to reboot the computer manually (e.g. under Windows XP), I don't know exactly why.

6. Test.

• Extract all files in 16bitsTest.zip (or 16bitsCppTest.zip) into your GP32 projects main folder. In my case all my GP32 projects are located in C:\Src\GP32\. In this case all files should be extracted into the C:\Src\GP32\16bitsTest (or C:\Src\GP32\16bitsCppTest) folder.

• Delete the file 16b_test.gxb. We want to be sure that we can recreate it, don't we?

• Go to the DOS command prompt.

• Go to the project folder where is located the makefile of the test program.

• Execute the makefile by typing make and pressing <Enter>.

• If all has been correctly done, the GP32 program file 16b_test.gxb and other files should have appeared in the projects folder. Try it with Geepee32.