tsip.h

Go to the documentation of this file.

/*! \file tsip.h \brief TSIP (Trimble Standard Interface Protocol) function library. */
//*****************************************************************************
//
// File Name    : 'tsip.h'
// Title        : TSIP (Trimble Standard Interface Protocol) function library
// Author       : Pascal Stang - Copyright (C) 2002
// Created      : 2002.08.27
// Revised      : 2002.08.27
// Version      : 0.1
// Target MCU   : Atmel AVR Series
// Editor Tabs  : 4
//
// NOTE: This code is currently below version 1.0, and therefore is considered
// to be lacking in some functionality or documentation, or may not be fully
// tested.  Nonetheless, you can expect most functions to work.
//
/// \ingroup driver_hw
/// \defgroup tsip TSIP Packet Interface for Trimble GPS Receivers (tsip.c)
/// \code #include "tsip.h" \endcode
/// \par Overview
///     This library parses and decodes the TSIP data stream from a Trimble GPS
/// and stores the position, velocity, and time solutions in the gps.c library.
/// The library also includes functions to transmit TSIP packets to the GPS for 
/// configuration and data request.
//
// This code is distributed under the GNU Public License
//      which can be found at http://www.gnu.org/licenses/gpl.txt
//
//*****************************************************************************

#ifndef TSIP_H
#define TSIP_H

#include "global.h"

// constants/macros/typdefs
// packet delimiters
#define DLE                 0x10
#define ETX                 0x03
// packet types
// command packets
#define TSIPTYPE_SET_IO_OPTIONS 0x35
// byte 0
#define POS_XYZ_ECEF        0   // outputs 0x42 and 0x83 packets
#define POS_LLA             1   // outputs 0x4A and 0x84 packets
#define POS_ALT             2   // outputs 0x4A/0x84 and 0x8F-17/0x8F-18
#define ALT_REF_MSL         3   // bit cleared = HAE Reference datum
#define POS_DBL_PRECISION   4   // bit cleared = single precision
#define SUPER_PACKETS       5   // 0x8F-17,0x8F-18,0x8F-20
// byte 1
#define VEL_ECEF            0   // outputs 0x43
#define VEL_ENU             1   // outputs 0x56
// byte 2
#define TIME_UTC            0   // 0/1 time format GPS/UTC
// byte 3
#define RAWDATA             0   // outputs 0x5A packets 
#define RAWDATA_FILTER      1   // 0/1 raw data unfiltered/filtered 
#define SIGNAL_DBHZ         3   // 0/1 signal strength in AMU/dBHz

// report packets
#define TSIPTYPE_GPSTIME        0x41
#define TSIPTYPE_POSFIX_XYZ_SP  0x42
#define TSIPTYPE_VELFIX_XYZ     0x43
#define TSIPTYPE_SATSIGLEVEL    0x47
#define TSIPTYPE_GPSSYSMESSAGE  0x48
#define TSIPTYPE_POSFIX_LLA_SP  0x4A
#define TSIPTYPE_VELFIX_ENU     0x56
#define TSIPTYPE_SATTRACKSTAT   0x5C
#define TSIPTYPE_RAWDATA        0x5A
#define TSIPTYPE_GPSSUBCODE     0x6F
#define TSIPTYPE_POSFIX_XYZ_DP  0x83
#define TSIPTYPE_POSFIX_LLA_DP  0x84


// functions
void tsipInit(void (*txbytefunc)(unsigned char c));
void tsipSendPacket(u08 tsipType, u08 dataLength, u08* data);
u08 tsipProcess(cBuffer* rxBuffer);
void tsipGpsDataPrint(void);

// packet processing functions
void tsipProcessGPSTIME(u08* packet);
void tsipProcessPOSFIX_XYZ_SP(u08* packet);
void tsipProcessVELFIX_XYZ(u08* packet);
void tsipProcessPOSFIX_LLA_SP(u08* packet);
void tsipProcessVELFIX_ENU(u08* packet);

#endif

---