5
TI
-
89 / TI
-
92 Plus Sierra C Assembler Reference Manual
Not for Distribution
Beta Version February 2, 2001
1. General
Information
1.1. Introduction
This manual describes the Sierra tools, including the compiler, assembler, and
linker invoked by the TI FLASH Studio™ for development of Flash applications
(apps) and Assembly Language Programs (ASMs) for the TI-89 / TI-92 Plus
calculators, and other Plusutilities that are available to the developer. They were
developed by Sierra Systems to support certain Motorola processors and
coprocessors and IEEE format floating-point numbers. Under license from Sierra
Systems, Texas Instruments has modified this software to support TI BCD
floating-point numbers, and support for coprocessors has been removed.
Although the software has not been modified to exclude support for processors
other than the 68000, the 68000 is the only processor supported by Texas
Instruments. The license from Texas Instruments to use these products is
restricted to development of software that is targeted to execute only on TI
calculators.
Typically, the TI FLASH Studio will handle all invocations of the compiler,
assembler, and linker but information is included in the various sections to enable
developers to use them directly from the command line or create their own
makefile if they wish, although this is not encouraged.
Section 1 contains information that applies to all the tools and describes the
format of the object file generated.
Section 2 discusses features of the Sierra Systems C compiler, com68. These
include number formats, function calls, integer and floating-point arithmetic,
sections, register allocation, macros, possible error messages, and many others.
Section 3 describes both Sierra Systems assemblers: asm68 which is invoked by
the TI FLASH Studio, and asm68k which is included for developers who may
wish to take advantage of the macro support it provides. Explanations of
assembler syntax, symbols, constants, expression evaluation, addressing
modes, and complete descriptions of assembler directives for both assemblers
and the asm68k macros are in this section.
Section 4 is a brief discussion of the Sierra Systems linker, link68, and some of
its features including relocation hole compression.
Section 5 describes the Sierra Systems utilities nm68 and size68, provided as
part of the TI-89 / TI-92 Plus SDK for use by developers.