Expand description
AltOS’s radio telemetry decoded to a table: one row a packet, under a header naming the
packet’s fields, serial,tick,ptype,state,v_batt,…,height,crc.
An Altus Metrum flight computer’s radio packet opens with the board’s serial number, its clock
in ticks of 10 ms and the packet’s type, and the type lays out the rest (crate::altos_telem;
AltOS Telemetry, Bdale Garbee and Keith Packard, v1.9.22.2, 2025, §2.1, p. 2). A TeleMega
sends its sensors in two packets, and type 0x09, “TeleMega Kalman and Voltage Data for 15V
boards”, holds the flight’s state, v_batt, v_pyro, the six pyro channels’ continuity
sense, ground_pres, ground_accel, accel_plus_g, accel_minus_g, acceleration in
sixteenths of a m/s², speed in sixteenths of a m/s and height in meters (§2.3, Tables 4
and 6, pp. 3–4). One sample file is such packets decoded to a CSV, by software it doesn’t
name: its header names a row’s serial number, its tick, its packet type and a crc flag,
then the packet’s fields by the document’s names, the scales already applied:
serial,tick,ptype,state,v_batt,v_pyro,sense,v_apogee,v_main,ground_pres,ground_accel,accel_plus_g,accel_minus_g,acceleration,speed,height,crc
1234,402.94,9,3,4.1,4.19,0.00 0.00 0.00 4.20,4.2,4.14,98500,-28,-29,10,62.25,27.375,6,TRUERecognition. The header, after any byte-order mark, opens serial,tick,ptype,.
Reading by the header. Each column is read by its name:
| Columns | Read as | Why |
|---|---|---|
tick | the clock, s, as written | the table writes the tick in seconds, to the hundredth, the tick’s 10 ms |
height | Quantity::AltitudeAboveGround, m, and the primary track | the document’s meters above the pad: the board’s own estimate |
acceleration | Quantity::Acceleration, m/s² | the document’s sixteenths of a m/s², divided out: the board’s estimate along its axis, about 0 at rest |
speed | Quantity::Speed, m/s | the document’s sixteenths of a m/s, divided out: the board’s estimate, which leans on its accelerometer |
ground_pres | Quantity::Pressure, Pa, where the column’s first value lies between 10 and 120 kPa, as every launch site’s pad does; as written otherwise | the document’s barometer reading on the ground |
v_batt, v_pyro, v_apogee, v_main, each number of sense | Quantity::Voltage, V | the document sends the converter’s counts, but the table holds volts: 4.1 for the battery, a single LiPo cell’s, the battery a TeleMega takes (The Altus Metrum System, v1.9.22.2, §3.2, p. 6); only v_batt is held to a band, by the survey |
serial, ptype, state | Quantity::Number, as written | the board’s serial number, the packet’s type and the flight’s state |
ground_accel, accel_plus_g, accel_minus_g | Quantity::Unrecognized, as written | the accelerometer’s counts, as the telemetry reader keeps them |
Every other column is kept as written, Quantity::Unrecognized, with a note. sense holds
several numbers in one cell, by spaces, one a pyro channel: each is its own channel, sense 1
and on, and every row must hold as many as the first. A TeleMega has six pyro channels, four of
them programmable (The Altus Metrum System, §1, p. 3), and the sample file’s sense holds
four, beside v_apogee and v_main.
The flight’s states. Each change of state is an Event, named as AltosUI’s exports
name the state’s number (crate::altos_telem): 2 pad, 3 boost, 4 fast, 5 coast, 6
drogue, 7 main and 8 landed; another number is state N.
What is left out, and refused. A row whose crc is FALSE, a packet whose check failed,
is left out and counted in a note: its bytes are noise. A crc that is neither TRUE nor
FALSE, a row with another number of cells than the header, a row whose serial number or packet
type isn’t the first row’s (two boards, or one table holding two packets’ fields), and a tick
no later than the one before refuse the file at the row’s line. The board’s tick turns over
every 655.36 s (§2.1), and a table of seconds can’t tell a turn from a board switched off and
on, so this reader doesn’t guess. A last line the file ends in with no line end, which isn’t a
whole row, is dropped with a note. A cell that is empty or not a finite number is a gap, NaN,
counted per column in a note.
The primary track. FlightLog::altitude_m is height, the board’s own estimate of its
height above the pad, on the rows’ ticks; FlightLog::battery_v is v_batt. The vertical
speed is absent: speed leans on the accelerometer, as for AltOS’s CSV.
The document is published under CC BY-SA 3.0; this reader restates its facts, not its tables.
Constants§
- MAX_
COLUMNS - The most columns a header may name.
- MAX_
SENSES - The most numbers a
sensecell may hold.
Functions§
- read
- Reads AltOS’s telemetry decoded to a table, from its text.
- recognizes
- Whether a text is AltOS’s telemetry decoded to a table: its header, after any byte-order
mark, opens
serial,tick,ptype,.