[DRAFT] Amateur Balloon Telemetry Format

This page describes the telemetry format that is uploaded to the SondeHub ElasticSearch Database.

Each telemetry datapoint is uploaded as a JSON object, with the fields described in the tables below. Multiple telemetry datapoints can be uploaded in one request.

Mandatory Fields

These fields represent the bare minimum amount of data that must be included in an upload.

Field	Type	Description	Allowed Values	Notes
software_name	string	Name of the decoding software		e.g. 'radiosonde_auto_rx', 'rdzTTGOsonde', 'RS41Tracker'
software_version	string	Version of the decoding software		e.g. '1.4.0', 'devel20210728'
uploader_callsign	string	Callsign of the uploader		Arbitrary string. Uploader position information and other metadata will be handled separately, but will need to match this callsign to enable calculation of listener statistics.
time_received	string	The time the telemetry packet was received. UTC time in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format.
payload_callsign	string	Callsign of the payload being launched
datetime	string	Date/Time from the sonde's GPS, provided in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format
lat	float	Latitude (decimal degrees)
lon	float	Longitude (decimal degrees)
alt	float	Altitude (metres)
upload_time	string	Time when packet was sent to the SondeHub server YYYY-MM-DDTHH:MM:SS.SSSSSSZ format

Optional Telemetry Fields

These fields should only be included in the uploaded JSON object if they are available, and considered to be reliable. Additional fields will be accepted however they may not be able to be queries from certain APIs.

Field	Type	Description	Notes
temp	float	Measured Temperature (deg C)
humidity	float	Measured Relative Humidity (%)
pressure	float	Measured Pressure (hPa)
vel_h	float	Horizontal Velocity (m/s)
vel_v	float	Vertical Velocity (m/s)
heading	float	Heading (degrees True)
sats	int	Number of SVs used in position solution
batt	float	Battery Voltage (volts)
frequency	float	Transmit frequency of the radiosonde in MHz, as estimated by the receiver software (e.g. FSK frequency estimation).
tx_frequency	float	Transmit frequency of the radiosonde in MHz, as determined by information provided in the radiosonde telemetry.

Optional Metadata Fields

These fields provide additional information about how and where the radiosonde telemetry was received.

Field	Type	Description	Notes
frame	int	Frame Number, ideally unique over the entire flight.
snr	float	Signal-to-Noise ratio of the received signal, in dB
rssi	float	Received-Signal-Strength-Indication of the radiosonde signal, nominally in dBm
uploader_position	list	Station position, as a list [lat, lon, alt]
uploader_antenna	string	Station antenna information, free-text string.