hfmodem

Documentation

Operator guides, protocol references and recorded results. VarAC-compatible chat and supervised voice/CW contacts are included in 0.4.0.

Project contact: [email protected].

Modes

ModeRelease statusImplementationGuide
PACTORAlpha (1–3); experimental (4)shrikePACTOR guide, PACTOR-4 protocol and PRNG, PACTOR-4 limits
VARAAlphakestrelVARA
ARDOPAlphabesraARDOP
Robust PacketExperimentalbrubruIllustrated guide, waveform, framing, link boundary, station
RTTY, SITOR-B and NAVTEXExperimentallannerIllustrated text-mode guide, implementation limits
MIL-STD-188-110, STANAG waveforms, 2G ALE and HF selcallExperimentalbateleurIllustrated STANAG and military-waveform guide, host interfaces, ALE and selcall console
sabirExperimentalsabirExperimental mode
Voice and CWExperimentalmacagua, merlinSupervised contacts

Compare the modes by channel occupancy, framing, coding and link control. Recorded evidence and implementation evidence record completed transfers, independent decodes and simulation results.

Running hfmodem

Start with the Winlink quickstart or VARA chat quickstart for an FTDX10 or FT-891 on macOS or Linux.

SubjectReference
Console setup, operator data and logbookOperator guide
Station setup and operationStation setup, service and ownership
Separate CW and digital callsignsIdentification options
Kestrel chat, passive QSO following and VMailQuickstart and commands
Supervised voice and CWContact commands
VARA transmit calibrationCalibration
Single-mode receive monitoringConsole monitor
Automatic ALE, calls and native text; selcall and pagingHFLINK console
Application and modem hostsHost compatibility
Station filesConfiguration
Shared components and mode implementationsArchitecture

Technical references

SubjectReference
PACTOR-4 framing, coding and PRNGProtocol guide, packet framing, PRNG, C2 recipes
PACTOR generation selectionCapability negotiation
PACTOR implementation inputsConstants, coding and permutation map
VARA implementation inputsConstants and high-speed waveform map
Sources and strength of evidenceEvidence tiers
Classic bulletin board (BBS)Note (not included in this release)

The comparison, PACTOR, VARA and ARDOP figures are checked against their source data by docs/viz/tools/build.py --check. Sabir illustrations and recorded simulation results are maintained separately. Robust Packet, STANAG and text-mode guides use implementation-derived schematic data checked by the site tests. The PACTOR-4 guide includes offline waveform renders and recovered permutation recipes. All nine illustrated guides can be opened offline.

Regenerating the comparison's recorded figures also requires the flac command-line decoder and the retained recordings under site/examples/ and site/recordings/. Viewing the built figures does not require a decoder or an audio download.