Buildtask; Rsp2Elf; Rsp, Rspg - Nintendo Ultra64 Programmer's Manual

Revision 1.0 RSP Software Development Tools
m4
The m4 macro processor is a useful tool that can optionally be invoked by the
assembler (rspasm -m). If requested, m4 will process the source code after
cpp, but before assembly.
Although this is a powerful feature, it is not used to build the currently
released software.

buildtask

This tool is a simple 'linker' which facilitates dynamic code overlays. its use
is not required.
buildtask uses a conspiracy between RSP microcode, DMEM usage, and
RSP task invocation to assist with code overlays. It concatenates code (and
data) objects (enforcing alignment) in the order provided on the command
line, and updates a table in DMEM with offsets and code sizes. This allows
the microcode to find a piece of code and overlay it into IMEM during
execution.
Additional details and examples of code overlays are described in
Chapter 6, "Advanced Information."

rsp2elf

Since ELF files are required by makerom and gvd, this tool is necessary to
construct final microcode objects out of the rspasm output. It creates a
dummy ELF .o and inserts the code and data sections into the appropriate
locations. It also synthesizes some program symbols from the file name, so
that the application code can reference the RSP text and data sections. From
this .o, makerom can link the RSP microcode object into the game.

rsp, rspg

This tool is a software simulation of the RSP with a debugger-like interface.
21