PhoenixRising's NDS Library (libpr[79]) Overview

For a full list of classes available in the library, click on the "Class Heirachy" link above.

How to Use libpr Starting from the Template Project

A few modifications to make files in the template project are required to take advantage of libpr.

CommonMakefile.in

Right after the export of NDSLIBPATH, add an export for PRLIBPATH:

Before:

# path to library - this can be deleted if you set the path in windows
export NDSLIBPATH       :=      /home/ndsdev/ndslib

# Name stuck in the GBA header of the DS booter ROM

After:

# path to library - this can be deleted if you set the path in windows
export NDSLIBPATH       :=      /home/ndsdev/ndslib
export PRLIBPATH        :=      /home/ndsdev/libpr

# Name stuck in the GBA header of the DS booter ROM

A second change is near the bottom of the file:

Before:

#---------------------------------------------------------------------------------
# list of directories containing libraries, this must be the top level containing
# include and lib
#---------------------------------------------------------------------------------
LIBDIRS :=      $(NDSLIBPATH)
#LIBDIRS +=

After:

#---------------------------------------------------------------------------------
# list of directories containing libraries, this must be the top level containing
# include and lib
#---------------------------------------------------------------------------------
LIBDIRS :=      $(NDSLIBPATH)
LIBDIRS +=      $(PRLIBPATH)
#LIBDIRS +=

arm7/Makefile

While LIBS looks like you can add a list of libraries to use, in fact it is not possible. To fix this, we do the following:

Near the top of the file: Before:

export BUILDDIR         :=      build
#SOURCES                +=      ?
#INCLUDES               +=      ?
LIBS            +=      nds7

After:

export BUILDDIR         :=      build
#SOURCES                +=      ?
#INCLUDES               +=      ?
LIBS            +=      -lnds7 -lpr7

Next, seaching for "LIBS" yields the following changes:

Before

%.elf:
        @$(LD) $(LDFLAGS) -Wl,-Map,$(notdir $@).map -specs=ds_arm7.specs $(OFILES) $(LIBPATHS) -l$(LIBS) -o $@

After

%.elf:
        @$(LD) $(LDFLAGS) -Wl,-Map,$(notdir $@).map -specs=ds_arm7.specs $(OFILES) $(LIBPATHS) $(LIBS) -o $@

arm9/Makefile

The changes for the arm9/Makefile are similar to the changes for the arm7 makefile.

Near the top of the file: Before:

export BUILDDIR         :=      build
#SOURCES                +=      ?
#INCLUDES               +=      ?
LIBS            +=      nds9

After:

export BUILDDIR         :=      build
#SOURCES                +=      ?
#INCLUDES               +=      ?
LIBS            +=      -lnds9 -lpr9

Next, seaching for "LIBS" yields the following changes:

Before

%.elf:
        @$(LD) $(LDFLAGS) -Wl,-Map,$(notdir $@).map -specs=ds_arm9.specs $(OFILES) $(LIBPATHS) -l$(LIBS) -o $@

After

%.elf:
        @$(LD) $(LDFLAGS) -Wl,-Map,$(notdir $@).map -specs=ds_arm9.specs $(OFILES) $(LIBPATHS) $(LIBS) -o $@

---