Revision 1.0
RSP Software Development Tools
21
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.
Summary of Contents for Ultra64
Page 2: ...2 ...
Page 10: ...10 ...
Page 12: ...12 Figure 6 2 buildtask Operation 137 ...
Page 14: ...14 ...
Page 80: ...80 Vector Unit Instructions vmadm dres_int dres_int vconst 3 vmadn dres_frac vconst vconst 0 ...
Page 104: ...104 RSP Coprocessor 0 ...
Page 150: ...150 Advanced Information ...
Page 155: ...Revision 1 0 155 ...
Page 248: ...248 Exceptions None ...
Page 251: ...Revision 1 0 251 Exceptions None ...
Page 254: ...254 Exceptions None ...
Page 257: ...Revision 1 0 257 Exceptions None ...
Page 293: ...Revision 1 0 293 Exceptions None ...
Page 316: ...316 Exceptions None ...