module

Kozai::Transponders

What frequency to listen on, per satellite.

NOTE: this exists because a station has one receiver and many satellites.

Until this table, [radio] downlink_hz was a single figure for the whole station: work SO-50 on 436.795, and the next pass — AO-73 on 145.935 — left the receiver exactly where it stood. Changing satellite meant editing the configuration and restarting the daemon, which is not a ground station, it is a demonstration of one.

The format is this project's own key = value configuration, parsed by Config.parse and not by a line of new code:

[iss-fm]
catalog_number = 25544
name           = ISS FM voice
downlink_hz    = 145800000
uplink_hz      = 145990000
mode           = FM
default        = true

A section is one transponder and the satellite is named inside it, rather than the other way round, because satellites carry more than one: the ISS has FM voice, APRS and SSTV on three frequencies, and AO-7 has two whole modes. Keying sections by catalogue number would force a choice the operator should be making per pass.

Constants

BUNDLED_ON = "2026-08-09"

Transponders compiled into the binary.

The same nine satellites the fallback element sets cover, and for the same reason: a station starting for the first time with nothing configured should be able to hear something rather than present an empty selector. It is a starting point, not a database — a real station will point [radio] transponders at its own file, and the section names here are chosen so that file can override any single entry by reusing one.

Frequencies are the published ones as of the date below. They move: AO-7 alternates modes on a 24-hour timer, the ISS radio changes function between crews, and a satellite in safe mode transmits on none of these.

BUNDLED_TEXT = {{ read_file("/tmp/tmp.lHiJjp/src/src/transponders/bundled.conf") }}

Transponders compiled into the binary.

The same nine satellites the fallback element sets cover, and for the same reason: a station starting for the first time with nothing configured should be able to hear something rather than present an empty selector. It is a starting point, not a database — a real station will point [radio] transponders at its own file, and the section names here are chosen so that file can override any single entry by reusing one.

Frequencies are the published ones as of the date below. They move: AO-7 alternates modes on a 24-hour timer, the ISS radio changes function between crews, and a satellite in safe mode transmits on none of these.

Log = ::Log.for("kozai.transponders")

Nested types