Texas Instruments TMS34010 User Manual

Invocation and Operation of the TMS34010 C Compiler
3.5 Assembling a C Program
The GSPC batch file automatically produces and assembles TMS34010 as-
sembly language source from C programs, The assembly language source file
is available under the name <input file>,ASM, If you wish to see an assembler
listing
of the file, you must explicitly assemble this file using the -I option of
the GSP assembler, •
Appendix E is an example showing the assembly language produced from C
programs,
3.6 Archiving a C Program
C program object files may be archived using the GSPAR archiver program,
Libraries
should be organized so that all references to external symbols or
functions are defined within the same library or in a following library, See the
TMS34010 Assembly Language Tools User's Guide for more information,
3.7 Linking a C Program
Modular code is an important concept in writing software because it simplifies
the tasks
of debugging and porting, To make this modularization possible, the
programmer
must have the capability to link separate modules into one exe-
cutable program, The TMS3401 0 C environment offers this capability by pro-
viding an assembler that produces object code which is linkable by the
TMS34010 linker.
In
the simplest case, a C program consisting of modules prog1, prog2, etc, can
be
linked to produce an executable output file called prog,out by invoking the
linker as follows:
gsplnk ~ ~ prog.out progl.obj prog2.obj ~ rts.lib [flib.libJ
For further information, refer to the TMS34010 Assembly Language Tools
User's Guide,
3.7.1 Run-Time Initialization
All C programs must be linked with an object module called boot.obj, which
contains code and data for initializing the run-time environment, This is the
first
code executed when the program begins running, and it has the following
responsi bi I ities:
• Sets up the system stack.
• Processes the run-time initialization table and auto-initializes global
variables,
• Disables
interrupts and calls -main.
Boot.obj is supplied in the run-time support object library RTS,LI B, If you use
the C code option with GSPLNK and include RTS,LlB in your link control file,
boot.obj is automatically linked in (see Section 3,7,3, The -c Option in the
Linker).
Alternatively, you can use the archiver GSPAR to extract boot.obj
from the library and link it in explicitly.
3-7

Texas Instruments TMS34010 Specifications

General

Manufacturer	Texas Instruments
Model	TMS34010
Data Bus Width	32-bit
Operating Voltage	5 V
Year Introduced	1986
Category	Graphics Processor Unit (GPU)
Clock Speed	40 MHz (Maximum)
Instruction Set	Custom
Graphics Capabilities	2D graphics
Package	PGA
Resolution Support	up to 1024x768
Architecture	32-bit RISC

Summary

TMS34010 C Compiler Package Product Overview

Applicable Documents

Lists related Texas Instruments and C programming publications.

Documentation Conventions

Explains symbols and formatting used in the guide.

TMS34010 C Compiler Package Installation

Installation for Texas Instruments and IBM PC Systems

Details installation steps for PC systems, including hardware requirements and diskette usage.

VAX/VMS Systems Installation

Covers tape mounting, VMS commands, and setup for VAX/VMS.

VAX/ULTRIX and VAX/UNIX System V Installation

Outlines tape installation and tool verification for ULTRIX and UNIX systems.

Invocation and Operation of the TMS34010 C Compiler

The TMS34010 C Preprocessor (GSPCPP)

Describes GSPCPP's role in macro processing, include files, and conditional compilation.

The TMS34010 Parser (GSPCC)

Explains GSPCC's function in syntax checking and generating intermediate files.

The Code Generator (GSPCG)

Details GSPCG's process of converting intermediate code to assembly source.

Batch Execution of the C Compiler

Explains how to use GSPC.BAT for compiling and assembling C programs.

Linking a C Program

Covers modular code linking, object libraries, and the role of the linker.

The TMS34010 C Language

Identifiers and Keywords

Discusses identifier significance, case sensitivity, and new keywords.

TMS34010 C Data Types

Details basic and derived data types, including enum and void.

Structure and Union Declarations

Explains alignment, bit fields, and member name rules for structures and unions.

Enumeration Declarations

Describes the syntax and usage of named integer constants (enumerations).

TMS34010 C Run-Time Environment

Memory Model

Describes memory organization, including code and data placement.

Register Conventions

Outlines register usage for stack management, function calls, and general operations.

Function Call Conventions

Details how functions pass arguments, handle return values, and manage the stack.

System Initialization

Explains the creation and initialization of the C run-time environment, including stacks.

TMS34010 Run-Time Support

Memory Management

Describes C dynamic memory management routines like malloc, calloc, and free.

String Functions

Lists and describes functions for string manipulation, search, and comparison.

Character Typing and Conversion Macros

Explains macros for identifying character types and converting between cases.

Fatal Errors

Compiler Error Messages

Describes the format and common fatal error messages from the compiler.

Floating Point Facility

Single-Precision Floating-Point Format

Details the 32-bit format for single-precision floating-point numbers.

Double-Precision Floating-Point Format

Details the 64-bit format for double-precision floating-point numbers.

Floating Point Conversions

Explains conversions between integer, float, and double types.

Floating-Point Error Exception Handling

Describes how to trap and handle floating-point errors using fp-error.