Getting Started/devkitARM: Difference between revisions

From devkitPro
Jump to navigation Jump to search
No edit summary
(Redirected page to Getting Started)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
If your host platform is Windows then use the [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/ Windows Installer/Updater] package. For OSX and linux users there is a perl script at http://sourceforge.net/p/devkitpro/perlupdaters which will automate most of the instructions here. We would obviously prefer to have a good cross platform installer setup that works the same way for all platforms but making that happen is proving difficult.
#REDIRECT [[Getting_Started]]
 
The first thing that you need to do is create a folder for the devkitPro toolchains. Start by opening a terminal - on OSX use the apple key + space, then type terminal. In the terminal window type the following command to create a new folder - all these commands are executed by pressing the return key. You'll need to create the initial folder with root privileges
 
sudo mkdir -p /opt/devkitpro
 
Once you've done that you can grant world access to the folder so you can extract the archives with normal privileges. You can also leave the access as it is and follow these instructions as a superuser.
 
sudo chmod 777 /opt/devkitpro
 
When we're done the layout for your devkitPro folder should end up like this, each folder links to the appropriate sourceforge package.
 
devkitpro
    |
    +-- [http://sourceforge.net/projects/devkitpro/files/devkitARM devkitARM]
    +-- examples
    |    |
    |    +-- [http://sourceforge.net/projects/devkitpro/files/examples/gba gba]
    |    +-- [http://sourceforge.net/projects/devkitpro/files/examples/gp32 gp32]
    |    +-- [http://sourceforge.net/projects/devkitpro/files/examples/nds nds]
    +-- [http://sourceforge.net/projects/devkitpro/files/libgba libgba]
    +-- [http://sourceforge.net/projects/devkitpro/files/libmirko libmirko]
    +-- [http://sourceforge.net/projects/devkitpro/files/libnds libnds]
 
Nothing else should be placed inside these folders unless otherwise instructed by the devkitPro toolchain maintainers. On Windows several of these folders are removed and replaced by the update system.
 
The first package to install is the devkitARM tarball, obtained from the [http://sourceforge.net/projects/devkitpro/files/devkitARM devkitARM] link shown above. Download the appropriate tarball for your host platform - the files are named as devkitARM_<revision>-<processor>-<os>.tar.bz2. For OSX we provide universal binaries - devkitARM_<revision>-osx.tar.bz2.
 
Once the file is downloaded then you need to extract it into the devkitpro folder
 
cd /opt/devkitpro
tar -xvjf <file you downloaded>
 
Obviously replace <file you downloaded> with the name of the file obtained from sourceforge. On OSX you can simply drag & drop the downloaded file into the terminal window to get the file path.
 
Now you need to obtain the support libraries for your target platform - we'll start with the Nintendo DS libraries.
 
Download the latest binary of [http://sourceforge.net/projects/devkitpro/files/libnds libnds] then create a new folder and extract the tarball from the terminal window as before. '''Note:''' This is the file without "-src-" in the name.
 
mkdir libnds
cd libnds
tar -xvjf <libnds tarball>
 
Again, replace <libnds tarball> with the name of the file obtained from sourceforge. On OSX you can simply drag & drop the downloaded file into the terminal window to get the file path.
 
Now download [http://sourceforge.net/projects/devkitpro/files/libfat libfat-nds], this is the libfat-nds tarball and may not be in the release at the top of the list. You may need to expand the second section to find the appropriate file. This should be extracted to the same folder as the libnds tarball earlier.
 
tar -xvjf <libfat-nds tarball>
 
Download the [http://sourceforge.net/projects/devkitpro/files/dswifi dswifi] tarball and extract in the same place.
 
tar -xvjf <dswifi tarball>
 
Download the [http://sourceforge.net/projects/devkitpro/files/maxmod maxmod] tarball and extract in the same place.
 
tar -xvjf <maxmod-nds tarball>
 
Download the [http://sourceforge.net/projects/devkitpro/files/filesystem/ libfilesystem] tarball and extract in the same place.
 
tar -xvjf <libfilesystem tarball>
 
Lastly you'll need the arm7 binary that handles the wifi, audio and touchscreen on the DS.
 
Download the [http://sourceforge.net/projects/devkitpro/files/default%20arm7 default arm7] tarball and extract, still inside the libnds folder.
 
tar -xvjf <default arm7 tarball>
 
Now all that remains for DS programming is the examples archive. Move back to the devkitpro folder and create an examples/nds folder.
 
cd ..
mkdir -p examples/nds
cd examples/nds
 
Grab the [http://sourceforge.net/projects/devkitpro/files/examples/nds nds examples] archive from sourceforge & extract it here.
 
tar -xvjf <examples tarball>
 
Add these variables in your execution environment, for instance, editing the .bashrc file located in your home folder:
 
export DEVKITPRO=/opt/devkitpro
export DEVKITARM=$DEVKITPRO/devkitARM

Latest revision as of 01:11, 6 June 2018

Redirect to: