tsip 0.3.2

Python package for parsing and creating TSIP packets

About Python-TSIP

Python-TSIP is a Python package for parsing and creating TSIP packets. The Trimble Standard Interface Protocol (TSIP) is the binary protocol spoken by the GPS receivers sold by Trimble Navigation Ltd. (http://www.trimble.com).

Python-TSIP is available under the “BSD 2-Clause Simplified License”.

Status

Almost the full set of TSIP command and report packets understood by the Copernicus II receiver has been implemented but so far only some of them have been tested against the actual GPS. Implementing a complete set of tests against an actual Copernicus II receiver is currently work in progress. Presumably Trimble Thunderbolt and Thunderbolt-E are also supported as they appear to implement a subset of the commands/reports of the (newer) Copernicus II receiver. I don’t have access to any other Trimble products.

Python-TSIP is automatically tested against the following Python versions.

• Python 2.6

• Python 2.7

• Python 3.3

• Python 3.4

• Python 3.5

• pypy

• pypy3

The tests currently fail on the following Python versions.

• Python 3.2 (syntax error in the coverage module, it may work otherwise)

• Jython (can’t get Tox to work with jython)

The master branch equals the latest release. The develop branch represents the latest development but may not always pass all tests.

Example

The following code shows how to receive the current GPS time from the receiver.

• Command packet 0x21 requests the current GPS time.

• Report packet 0x41 contains the current GPS time. Its fields are accessible by index.

import tsip
import serial

# Open serial connection to Copernicus II receiver
serial_conn = serial.Serial('/dev/ttyS0', 38400)
gps_conn = tsip.GPS(serial_conn)

# Prepare and send command packet 0x21
command = tsip.Packet(0x21)
gps_conn.write(command)

while True:      # should implement timeout here!!!
    report = gps_conn.read()
    if report[0] == 0x41:
        print 'GPS time of week .......: %f' % (report[1])
        print 'Extended GPS week number: %d' % (report[2])
        print 'GPS UTC offset .........: %f' % (report[3])
        break

More examples can be found in the docs/examples/ folder.

History

0.3.2 (28-Oct-2017)

• Added Report Packet 0x58: GPS System Data from the Receiver.

• Fixed Report Packet 0x47: Signals Levels for Tracked Satellites.

• Fixed Report Packet 0x6D: Satellite Selection List.x

• Added docs/examples/example2.py wich provides a more comprehensive template program than the example in the README.

0.3.1 (26-Sep-2017)

• Fixed README.rst so it renders properly on PyPi.

0.3.0 (26-Sep-2017)

• Argument to tsip.Packet() can now also be a tuple or list (inspired by Criss Swaim).

• Changed development status from alpha to beta.

• Cleaned up lots of code to satisfy flake8.

0.2.0 (03-Dec-2015)

• Rewritten from scratch.

• Implements almost complete set of TSIP commands supported by Trimble Copernicus II and Thunderbolt/Thunderbolt-E GPS receivers.

0.1.0 (20-Jun-2015)

• First release on PyPI.