Texas Instruments TMS34010 User Manual

The TMS34010 C Language
Warning:
Extreme care must be taken not to disrupt the C environment
with asm commands. No checking of the inserted instructions
is done. Insertion of jumps and labels into C code may cause
unpredictable results in variables manipulated in or around the
inserted code. This command is provided so you can access
features of the hardware, which by definition C is unable to
access. Specifically, this command should not be used to
change the value of a C variable; however, it can be used safely
to read the current value of a variable.
In addition, the asm construct should not be used to insert as-
sembler directives which would change the assembly environ-
ment.
The asm command is very useful in the context of register variables. A register
variable
is a variable in a C program that is declared by the user to reside in a
machine register. The
TMS3401 0 C compiler allows up to four machine reg-
isters
to be allocated to register variables. These four registers, combined with
the asm command, provide a means of manipulating data independently of the
C environment.
4.10 Lexical Scope Rules
The lexical scope rules stated in K&R apply to TMS3401 0 C also, except that
structures and unions each have
distinct name spaces for their members. In
addition, the name space of both enumeration variables and enumeration
constants
is the same as for ordinary variables.
4-9

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.