airtrackrelay

airtrackrelay

UDP socket server to collect live tracking reports and relay them to metarace telegraph as JSON encoded objects.

Supported tracking devices and messages:

• Quectel GL300/320 "Air Interface"
  • +ACK : Command acknowledge, type: 'drdack'
  • +RESP, +BUFF:
  • GTFRI, GTRTL, GTSOS, GTLOC : Location report, type: 'drdpos'
  • GTINF : Information report, type: 'drdstat'
• Beaker
  • AES128 Location, type 'drdpos'

Configuration is via metarace sysconf section 'airtrackrelay' with the following keys:

key	(type) Description [default]
topic	(string) MQTT relay topic ['tracking/data']
port	(int) UDP listen port [1911]
k1	(string) Beaker K1, 128 bit hex string
k2	(string) Beaker K2, 128 bit hex string
uid	(int32) Beaker uid/config id [0]

Tracker imeis are read from the section 'tracking' under the key 'devices', which is a map of device ids to a dict object:

key	(type) Description [default]
imei	(string) Device IMEI
type	(string) Device type

Example config:

{
 "airtrackrelay": {
  "port": 12345,
  "topic": "tracking/data",
  "k1": "000102030405060708090a0b0c0d0e0f",
  "k2": "f0e0d0c0b0a090807060504030201000",
  "uid": 1234567890
 },
 "tracking": {
  "devices": {
   "bob": { "imei": "012345678901234", "label": null,
    "phone": "[phone]", "type": null },
   "gem": { "imei": "023456788901234", "label": null,
    "phone": null, "type": null },
  }
 }
}

Example Info Message:

{"type": "drdstat", "drd": "bob", "devstate": "41", "rssi": "13",
 "voltage": "4.08", "battery": "94", "charging": "0",
 "sendtime": "20220101023424" }

Example Ack Message:

{"type": "drdack", "drd": "gem", "ctype": "GTFRI", "cid": "1A3D",
 "sendtime": "20220101031607", "req": ""}

Example GL3xx/Beaker Location Message:

{"type": "drdpos", "lat": "-13.567891", "lng": "101.367815",
 "elev": "22.6", "speed": "12.7", "drd": "gem",
 "fixtime": "20220101022231", "battery": "94", "flags": 0}

Requirements

• metarace >=2.0

Installation

$ pip3 install airtrackrelay