OOK - portapack-mayhem/mayhem-firmware GitHub Wiki
[!WARNING] This application is intended solely for experimental purposes on equipment you own or have permission to test. You are responsible for complying with all applicable laws.
OOK TX transmits On-Off Keying signals using pre-defined encoder chip protocols. It is commonly used for testing remote controls, gate openers, and similar 315 MHz / 433.92 MHz OAM devices. The app has two tabs: Config (manual frame construction) and de Bruijn (automated code scanning).
Config Tab
-
Type: Encoder chip protocol. 14 types are supported:
Name Chip Address symbols Data symbols Word length Default clk 2260-R2 PT2260-R2 0, 1, F 0, 1 12 150 kHz 2260-R4 PT2260-R4 0, 1, F 0, 1 12 150 kHz 2262 PT2262 0, 1, F 0, 1, F 12 20 kHz 16-bit — 0, 1 0, 1 16 25 kHz 1527 RT1527 0, 1 0, 1 24 100 kHz 526E HK526E 0, 1 0, 1 12 20 kHz 12E HT12E 0, 1 0, 1 12 3 kHz 5026 VD5026 0, 1, 2, 3 0, 1, 2, 3 12 100 kHz UM3750 UM3750 0, 1 0, 1 12 100 kHz UM3758 UM3758 0, 1, F 0, 1 18 160 kHz BA5104 BA5104 0, 1 0, 1 9 455 kHz 145026 MC145026 0, 1, F 0, 1 9 455 kHz HT6*** HT6xxx 0, 1, F 0, 1 18 80 kHz TC9148 TC9148 0, 1 0, 1 12 455 kHz -
Repeat (1–99): Minimum number of times the frame is repeated per transmission. Automatically set to the encoder's default when the type changes.
-
Clk (1–1000 kHz): Encoder oscillator clock frequency. Changing this updates Frame automatically. Step size is set by the adjacent Step selector (1 / 10 / 100 kHz).
-
Frame (300–99,999 µs): Frame duration in microseconds. Changing this updates Clk automatically. Step size is set by its adjacent Step selector (1 / 10 / 100 / 1000 µs). Clock and frame are interlinked:
frame_µs = clk_period_µs × word_length. -
Symbols: The bit pattern to transmit. Each position corresponds to a symbol in the word format shown on the line below (A = Address, D = Data, S = Sync). Symbols are selectable per encoder type — for example
0,1, andF(float) for tri-state encoders. -
Waveform: Live preview of the generated OOK waveform for the current symbol pattern.
-
Progress bar / status: Shows repeat count (
n/total) and transmission progress.
de Bruijn Tab
Transmits a de Bruijn sequence — a cyclic bit sequence that contains every possible n-bit combination exactly once. This is used to scan all possible codes for a given bit length without needing to enumerate them individually.
-
Length (3–24 bits): The code word length
n. A length-nde Bruijn sequence covers all2ⁿcombinations. -
Bit length (two fields): The duration of each bit in microseconds, entered as tens + units (e.g.
40+0= 400 µs per bit). Range: 10–889 µs.
Common Controls
- Frequency / Gain / AMP: Standard TX controls in the bottom bar. Default frequency: 433.920 MHz.
- Start / Stop: Begins or aborts transmission. When the de Bruijn tab is active, starts a scan; when the Config tab is active, transmits the configured frame.
Settings Persistence
Settings are saved to tx_ook.ini.