Skip to main content

Module altos_telem_csv

Module altos_telem_csv 

Source
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,TRUE

Recognition. The header, after any byte-order mark, opens serial,tick,ptype,.

Reading by the header. Each column is read by its name:

ColumnsRead asWhy
tickthe clock, s, as writtenthe table writes the tick in seconds, to the hundredth, the tick’s 10 ms
heightQuantity::AltitudeAboveGround, m, and the primary trackthe document’s meters above the pad: the board’s own estimate
accelerationQuantity::Acceleration, m/s²the document’s sixteenths of a m/s², divided out: the board’s estimate along its axis, about 0 at rest
speedQuantity::Speed, m/sthe document’s sixteenths of a m/s, divided out: the board’s estimate, which leans on its accelerometer
ground_presQuantity::Pressure, Pa, where the column’s first value lies between 10 and 120 kPa, as every launch site’s pad does; as written otherwisethe document’s barometer reading on the ground
v_batt, v_pyro, v_apogee, v_main, each number of senseQuantity::Voltage, Vthe 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, stateQuantity::Number, as writtenthe board’s serial number, the packet’s type and the flight’s state
ground_accel, accel_plus_g, accel_minus_gQuantity::Unrecognized, as writtenthe 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 sense cell 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,.