Getting Started
2.2 Installing TIGA on Your System
2-4
Note:
If you have an earlier version of TIGA on your system, be aware that the TIGA installation procedure overwrites same-named files in the tiga and
tigapgms directories. For this reason, files of previous versions of TIGA should be backed up, if needed, before proceeding with the new TIGA in-stallation.
Both the TIGA DDK and SPK kits have an automated installation program to aid in installing TIGA on your system. In general, the installation proce-dure for the DDK and the SPK are the same.
The DDK package is a subset of the SPK; the SPK package contains all of the files in the DDK plus additional files required for porting purposes.
Therefore, if you have both the DDK and the SPK packages, install only the SPK on your system.
Follow these instructions to install your TIGA kit:
Step 1: Place disk #1 (DDK #1 or SPK #1) of your TIGA kit into drive A:
Step 2: If A: is not your current drive, enter A:
8
at the MS-DOS prompt.Step 3: Make sure you are at the root directory of A:. If you are not sure, enter cd\
8
at the MS-DOS prompt.Step 4: Enter setup drive:
8
where drive:designates your destination drive (hard diSk). For example, if you want to install TIGA on your C: hard disk, enter setup c:8.
Step 5: Follow the instructions displayed on the screen to complete instal-lation.
During installation, you have the option of installing a collection of TIGA-compatible examples and demonstrations. It is recommended that these examples be installed because they are referenced as coding examples in this guide.
The installation of your TIGA kit creates a number of subdirectories on your destination drive. Consult one of the following two sections (depending on the TIGA kit you installed) for information describing these subdirectories and the files contained within them.
Getting Started
Installing TIGA on your System
2.2.1 Driver Developer's Kit (DDK) Subdirectories
Installing the DDK on your system creates the following subdirectories:
Subdirectory Description
\tiga TIGA root directory, TIGA drivers, system files, and
\tiga\ai
Extended primitives source code archive Include files
TIGA compatible examples and demonstrations (see Section 2.2.3 for more information)
The \tiga\gm\extprims directory contains the self-extracting archive file extprims . exe. This archive contains source for every extended function available within TIGA. It enables you to choose the extended functions you need, link them with your specific user extensions, and create a custom TIGA dynamic load module with the TMS340 functions that your application or driver requires. To unarchive the source files contained in this archive, en-ter extprims ~ from within this directory.
2.2.2 Software Porting Kit (SPK) Subdirectories
Installing the DOK on your system creates the following subdirectories:
Subdirectory Description
\tiga TIGA root directory, TIGA drivers, system files, and utility programs
\tiga\ai Application interface library and source
\tiga\cd TIGA communication driver source
\tiga \gm TIGA graphics manager root directory
\tiga \gm\corprims TIGA graphics manager core primitives
\tiga \gm\extprims TIGA graphics manager extended primitives
\ tiga \gm\sdb TIGA graphics manager SOB specific files
\tiga\include Include files
\ tigapgms TIGA compatible examples and demonstrations (see Section 2.2.3 for more information)
Installing TIGA on your System
2.2.3 TIGA Demonstrations and Example Subdirectories
DUring installation, you have the option of installing a collection of TIGA compatible demonstrations and examples. When installed, the following di-rectories are created on the destination drive:
\tigapgms TIGA compatible examples and demonstrations
\ tigapgms \adi TIGA compatible AutoCAD example driver
\tigapgms\asmtst Assembly language application example
\ tigapgms \ball Interrupt example using graphics
\tigapgms\clock Downloaded interrupt function example
\ tigapgms \ curves Floating-point example
\tigapgms\examples Examples supplied in Chapter 3 of this guide.
\tigapgms\flysim 3-D flying simulator example
\tigapgms\stars Downloaded function example
\tigapgms\tests TIGA test suite
\tigapgms\tigademo Demonstrates many of TIGA's functions
\tigapgms\tigamode Board mode query/initialization program
\ tigapgms \ tigalogo Demonstrates fixed-point math operations
\tigapgms\windows TIGA-compatible MS-Windows driver (SPK only) Each subdirectory contains a readme .1st file, complete source, and a make file to rebuild that particular demonstration. Consult the readme .1st file for a description of the demonstration and rebuilding instructions.
If you opted not to load the TIGA examples during the initial TIGA kit installa-tion, you can install the examples and demonstrations at any time, following the installation instructions outlined on page 2-4. Simply insert program disk #1 into drive A: instead of the DDK or SPK disk #1 as directed in step 1. Continue installation as described.
2.2.4 Running a TIGA Demonstration
2-6
After installing TIGA on your system, you can run any of the supplied dem-onstration programs. One such program, tigademo, is a free-running dem-onstration of TIGA's graphics primitives. The following instructions outline how to run tigademo:
1) At the MS-DOS prompt, enter set path=c:\tiga ~
This provides access to TIGA's DOS commands from any directory.
2) Enter
set TlGA=~c:\tiga ~
This informs TIGA to look in the c:\tiga directory for TIGA-specific runtime files.
Getting Started
Installing TIGA on your System
~ _ _ _ .o$Si~~~~~~~!~?;w»"-;~m'7~s('=:·· =:=:=:=:: m·· .. : .. ~ .. ~ ... · .. ·'m~m»)~
3) Enter
cd \tigapgms\tigademo ~
This directory contains the tigademo program.
4) Enter tigacd
ED
This loads the TIGA communication driver (CD). The CD provides the communication interface between a TIGA application and the target TMS340-based board. Once loaded, the CD remains resident in memory and requires reloading only after rebooting your system.
5) Finally, enter tigademo ~
This executes tigademo.
You can run any of the other supplied examples in a similar manner.
Note:
Because the OOKlSPK is shipped with a TI software development board (SOB) version of TIGA, you must have an SOB in your system (or have a version of TIGA compatible with your TMS340-board) before running any of the supplied examples.
Installing TIGA on your System
.
~---~
2.2.5 TIGA Include Files
2-8
The directory \t iga \ incl ude contains include files used in the TIGA source code itself and when writing TIGA applications. These include files are di-vided in two groups: those designed to run on the host processor and those designed to run on the TMS340 processor. They are also divided, as to whether they are used in C-source files or in assembler source files as fol-lows:
£l Host-side include files
• C-source
extend.h tiga.h typedefs.h
Use when calling TIGA extended primitives Include always in a TIGA C program Include when using TIGA structure types
• Assembler source
extend. inc Use when calling TIGA extended primitives.
tiga. inc Include always in a TIGA assembly program.
typedefs. inc Include when using TIGA structure types
£l TMS340-side include files
• C-source
gspextnd. h Use for external declarations of all TIGA extended primitives
gspglobs . h Use for external declarations of all TIGA global variables
gspregs . h Use for TMS340 register definitions
gsptiga. h Use for external declarations of all TIGA core primitives
gsptypes . h Include when using TIGA structure types
• Assembler source
gspextnd. inc Use for external declarations of all TIGA extended primitives
gspglobs • inc Use for external declarations of all TIGA global variables
gspregs . inc Use for TMS340 register definitions
gsptiga. inc Use for external declarations of all TIGA core primitives
gsptypes . inc Include when using TIGA structure types
gspmac. lib Use for macro library
Getting Started
Modifying Autoexec and the Environment
~