Skip to content

Latest commit

 

History

History
83 lines (69 loc) · 2.99 KB

README.md

File metadata and controls

83 lines (69 loc) · 2.99 KB
Raw

libtrantor

A library to parse and build the binary format coming from LIVEX

Installation

Through Pip:

    $ pip install -e [email protected]:whip-live/libtrantor.git#egg=libtrantor

Or clone the repo and install it:

    $ git clone [email protected]:whip-live/libtrantor.git
    $ pip install ./libtrantor/

Usage

Parse

    from trantor import parse
    print(list(parse(b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'\
                     b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'\
                     b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'\
                     b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'\
                     b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00')))

Build

    from trantor import build
    data = {
        'acc_x': 0, 'acc_y': 0, 'acc_z': 0, 'barometer': 0, 'course': 0,
        'elevation': 0, 'fix': 0, 'geoid_height': 0, 'giroscope_x': 0,
        'giroscope_y': 0, 'giroscope_z': 0, 'hdop': 0, 'lat': 0.0,
        'lon': 0.0, 'magnetometer_x': 0, 'magnetometer_y': 0,
        'magnetometer_z': 0, 'pdop': 0, 'satellites': 0, 'speed': 0,
        'tdop': 0, 'temperature': 0, 'timestamp': 0, 'vdop': 0}
    print(build(**data))

Data format

A single record is composed of a total of 55bytes divided like this:

field type
timestamp 32 bits unsigned integer
lat 32 bits custom float (see below)
lon 32 bits custom float (see below)
course 16 bits unsigned integer
geoid_height 16 bits unsigned integer
elevation 16 bits unsigned integer
fix 8 bits unsigned integer
satellites 8 bits unsigned integer
hdop 16 bits unsigned integer
vdop 16 bits unsigned integer
pdop 16 bits unsigned integer
tdop 16 bits unsigned integer
speed 32 bits unsigned integer
acc_x 16 bits unsigned integer
acc_y 16 bits unsigned integer
acc_z 16 bits unsigned integer
barometer 24 bits unsigned integer
giroscope_x 16 bits unsigned integer
giroscope_y 16 bits unsigned integer
giroscope_z 16 bits unsigned integer
magnetometer_x 16 bits unsigned integer
magnetometer_y 16 bits unsigned integer
magnetometer_x 16 bits unsigned integer
temperature 16 bits unsigned integer

The custom float structure is used to represent latitude and longitude, and it is defined as following:

field type
sign single bit
exp 3 bits integer
digits 28 bits integer