Skip to content

Latest commit

 

History

History
executable file
·
83 lines (53 loc) · 2.6 KB

Sockets.md

File metadata and controls

executable file
·
83 lines (53 loc) · 2.6 KB
Raw

LoRa Gateway Socket Interfaces

The LoRa Gateway provides some socket interfaces, configurable in gateway.txt:

  • ServerPort - TCP/IP server socket, allowing a single client. Sends status and packet information in JSON format. Also allows for gateway settings (e.g. frequency) to be polled or changed.
  • DataPort - TCP/IP server socket, allowing a single client. Sends raw telemetry packets (e.g. $$...).
  • UDPPort - UDP client broadcast socket, sending raw telemetry.
  • OziPlotterPort - UDP client broadcast socket, sending basic telemetry reformatted as OziPlotter CSV format.
  • OziMuxPort - UDP client broadcast socket, sending basic telemetry reformatted as OziMux JSON format.

JSON Port

This port has several functions:

  1. Sends telemetry packets, soon after they are received.
  2. Sends RSSI, every 100ms
  3. Accept single-word commands
  4. Accept new settings
  5. Accept messages to send to HAB

1. Telemetry Packets

These are JSON packets with these fields:

  1. class = "POSN"
  2. index = Payload index - from 0 up to max payloads (32 currently) minus 1.
  3. channel = LoRa module channel (SPI channel) - 0 or 1
  4. payload = payload ID
  5. time = UTC time from payload
  6. lat = Latitude from payload
  7. lon = Longitude from payload
  8. alt = Altitude from payload
  9. rate = Calculated ascent (+ve) or descent (-ve) rate, as calculated by gateway
  10. sentence = Raw sentence sent by payload, including CRC, excluding terminating LF.

Example:

{"class":"POSN","index":0,"channel":1,"payload":"RTLS3","time":"14:59:07","lat":
51.95068,"lon":-2.54703,"alt":59,"rate":0.0,"sentence":"$$RTLS3,1,14:59:07,51.95
068,-2.54703,00059,0,0,11,34.7,26.5,987,35.7,0.50,0.00000,0.00000,0.0,0,None,92,
0,0,0,0,0.0,0.0,0.0,0.0,0.0,0,0,0,0,0,0.0,0,0,0.0,0,0,0.0,0.0*FA61"}

2. RSSI Reporting

To Do ...

3. Commands

All commands are case-insensitive, and are terminated with a .

Settings command

Returns the current gateway settings. Sample excerpt:

{"class":"SET","set":"tracker","val":"M0RPI/5"}
{"class":"SET","set":"EnableHabitat","val":0}
{"class":"SET","set":"EnableSSDV","val":0}
{"class":"SET","set":"LogTelemetry","val":1}
{"class":"SET","set":"LogPackets","val":0}
{"class":"SET","set":"CallingTimeout","val":60}

Save command

Saves the current gateway settings to gateway.txt.

4. New settings

General format is "[setting]=[new value]"

e.g.:

tracker=M0RPI
frequency_0=434.450

5 Uplink Messages

Send

Format is "send:[message]"