Congratulations on your purchase of a Trimble OEM GPS Starter Kit.

This toolkit disk contains 8 executable programs:

1) GPSSK 

This is a TAIP monitor program with graphics.  A complete description
is at the end of this file.

2) TSIPCHAT 

This program is a TSIP control-and-display program which allows the
user to exercise the complete range of documented commands in the TSIP
protocol.  

TSIPCHAT can be run under a DOS window in Windows 3.1 or Win 95. 
Always close the program with ESC; closing the DOS window without
exiting the program will hang the serial ports.  Two copies of TSIPCHAT 
on two different ports can be run simultaneuosly in DOS two windows.  

To examine the command line options, type 'TSIPCHAT' with no arguments. 
Once the program is running, type '?' for a complete list of keyboard
commands.  

3) TSIPPRNT 

This program parses a TSIP binary file, recorded by TSIPCHAT or any 
other binary recording device, and dsiplays it on the screen.  The
output uses the same formatting as the TSIPCHAT display.   The output 
can be piped to a file as follows:
tsiprnt infilename > outfilename
Full source code is provided for BORLAND or MS Visual C compilers in 
the directory T_SOURCE.  (SEE "SOURCE CODE" BELOW.)

4) TCHAT 

This program gives a basic TSIPCHAT capability.  Its primary purpose is 
as a basic, easy-to-read source code template that compiles under both 
Borland & MSVC, with full report parsing and sample command formatting 
with a limited menu of single-keystroke commands.  (SEE "SOURCE CODE" 
BELOW.)

5) RTCM_MON 

This program is a simple monitor program for RTCM SC-104 differential 
correction messages.   The program prints them in ASCII form on the 
screen.  The program was built from TSIPCHAT source code.  A null-modem 
cable is needed to attach the RTCM source to the PC.

6) 34055-61 - CAUTION! This program will change the receiver's default 
settings.  It is compatible ONLY with receivers having v5.10 firmware 
and PN 34055-xx!

This program allows the developer to change the receiver protocol to 
Port 1: TSIP in/out at 9600 baud 8-odd-1;
Port 2: RTCM in at 4800 baud 8-none-1.
This program will return the receiver to its original as-shipped 
condition if one of the next two programs is applied.  

7) 34055-62 - CAUTION! This program will change the receiver's default 
settings.  It is compatible ONLY with receivers having v5.10 firmware 
and PN 34055-xx!

This program allows the developer to change the receiver protocol to 
Port 1: NMEA in/out at 4800 baud 8-none-1;
Port 2: RTCM in at 4800 baud 8-none-1.

8) 34055-63 - CAUTION! This program will change the receiver's default 
settings.  It is compatible ONLY with receivers having v5.10 firmware 
and PN 34055-xx!

This program allows the developer to change the receiver protocol to 
Port 1: TAIP in/out at 4800 baud 8-none-1;
Port 2: RTCM in at 4800 baud 8-none-1.

	Trimble Navigation
	645 N. Mary Ave
	Sunnyvale, CA 94088
	Copyright 1995

=====================================================
SOURCE CODE 
*********    NO SOURCE CODE WARRANTY *****************

Source code is given for TCHAT and TSIPPRNT.  The enclosed source code 
is usable, in whole or in part, royalty-free for the purpose of 
interfacing to TSIP or TAIP-speaking GPS receivers made by Trimble.  It 
is meant only as a template to speed the developer's work.  

TRIMBLE WARRANTIES NONE OF THE ENCLOSED SOURCE CODE.   
IT IS THE SOLE RESPONSIBILITY OF THE SYSTEM DEVELOPER TO GUARANTEE 
RELIABLE OPERATION OF HIS SYSTEM.

In case of disagreement between the software source code and the
TSIP manual, please consult the Trimble Technical Assistance Center.

Full Borland-only source code is also given for TSIPCHAT, but it is 
highly recommended that the developer understand TCHAT source code 
completely before using TSIPCHAT as a source code template. 

TSIP_IFC.C (together with TSIP_IFC.H) is a source file of TSIP parsing 
and formatting 'primitives'.  This is basically a transcription of the 
TSIP manual into C source code.  It should be followed closely in 
creating an application.  

In creating an application, the developer must supply four basic Serial 
I/O functions: 
  initialize serial, 
  close serial, 
  get byte, and 
  send byte.  
The last routine is named sendb() and must be supplied; it is called by 
TSIP_IFC.C.  The routine SERIAL.C provides a limited serial port 
buffering capability for demonstration purposes only.  

=============================================

GPSSK - is a software package provided to aid users of Trimble
GPS receivers that use the "TAIP" communication protocol.  TAIP
is an acronym for "Trimble ASCII Interface Protocol".  GPSSK can
be used to setup, diagnose, and monitor TAIP GPS receivers.

	GPSSK allows the user to perform the following operations:

	   o   Program the GPS receiver for automatic message reporting
	       and verify the success of the programming.

	   o   Log the GPSSK session with the GPS receiver to disk and
	       replay this data.

	   o   Plot the GPS position from the receiver on an X-Y grid.

	   o   Poll for and view any combination of TAIP messages.
	       Polling intervals may be different for each message type.

	   o   Hold an interactive terminal session with the GPS receiver.


	GPSSK Hardware And Software Checklist 
	----------------------------------------------------------------
	GPSSK requires PC-DOS or MS-DOS version 2.0 or greater and runs
	on all 286 (minimum) based IBM-compatible personal computers and
	most near-compatibles.  The program may be executed from a hard
	disk or a diskette and requires the following minimum hardware: 
 
	   o    80286 processor
	   o    256 kilobytes of available RAM
	   o    VGA Graphics adapter (required only for plot screen)
 
	In addition to the required computer configuration, the following
	hardware options are strongly recommended for GPSSK operations:

	   o    Hard disk drive
	   o    80287/80387 Math Co-processor
	   o    512 to 640 kilobytes of RAM
 

	Printer Interface/PRINTING PLOTS
	----------------------------------------------------------------
	GPSSK does not contain any internal printer support.


	Installing and Operating GPSSK
	----------------------------------------------------------------
	For hard disk operation, copy the files "GPSSK.EXE" and "GPSSK.HLP"
	to a hard disk directory.  From the directory containing GPSSK,
	or from any directory if the directory containing GPSSK is part of
	the current system path, enter the command:

		  gpssk

	For an explanation of the "path" environment variable, see your DOS
	manual.  Program loading ends with the display of the GPSSK program
	title page.  After the display of the title page, pressing <Any Key>
	(or waiting 10 seconds) will begin GPSSK operations.  To terminate
	GPSSK, simply "back out" of the menu hierarchy "tree" by continually
	pressing <F9> until GPSSK prompts for exit confirmation.

	On startup, GPSSK will attempt to initialize itself by querying
	the GPS receiver for some basic information.  If you wish to
	abort the initialization process (GPSSK just being used for rerun
	so no GPS receiver attached) press <Ctrl>X (hold down the control
	key and press x).  Note that after the initialization process is
	aborted, GPSSK must be restarted in order to run with an attached
	GPS receiver.

	Once GPSSK is running, on-line help is available to aid the user
	with all GPSSK operations.  The help is context sensitive and will
	display information regarding the current display/menu.  A brief
	overview of GPSSK is available in the main menu's help screen.
	GPSSK's start-up default display will be a few selected TAIP
	messages.  Note that one of these default messages (LN) is not
	available in our "Placer" product (Trimble part #18700-00) and
	therefore will not be displayed.  The LN message is available
	in our Placer 300, Placer 400, etc. products.

	There are several command line options available.  For help with
	command line options, run GPSSK with a /help argument:

		  gpssk /help

	The help available on GPSSK's main menu will explain GPSSK menu
	operation and menu hierarchy.


	Connection of the GPS Receiver to the Computer
	----------------------------------------------------------------
	Connect the serial port of the GPS receiver to the computer's
	COM1 or COM2 port.  The default serial port settings for GPSSK
	are 4800 baud, 8 data bits, no parity, and 1 stop bit.  This is
	the power on default for Trimble's Placer 400 GPS receiver.  If
	the GPS receiver is connected to the COM2 port, run GPSSK with
	the /2 option.  (Run "gpssk /help" for more information on
	command line options.)


	TAIP Message Encoding/Decoding Source Code
	----------------------------------------------------------------
	TAIP.C contains 'C' source code for encoding and decoding TAIP
	messages.  There is no warranty of any kind on this software.
	It is provided only as an example of TAIP message processing.
	Use it at your own risk.  Note that TAIP.C cannot be built
	into a .EXE without the user providing their own serial port
	handling software.

