From c5a2b41fdb5efde9c5fa92bc3effd32176ec6827 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bruno=20Ryb=C3=A1rsky?= Date: Sun, 15 Nov 2026 01:24:16 +0100 Subject: [PATCH] README: OOK on F+7, spectrum keys, bandscope edition, build options Co-Authored-By: Claude Opus 5.5 --- README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 45 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ddb64cf..6a4bad0 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ Anyway, have fun. ## User guide (this build) -This section describes the firmware as built from this repository with the default `Makefile` options: FM broadcast radio, flashlight, UART and the F4HWN features are on; VOX, NOAA, AirCopy, alarm/1750 Hz, voice prompts and the spectrum analyser are off. If you enable or disable features, some keys and menu items change. +This section describes the firmware as built from this repository with the default `Makefile` options: FM broadcast radio, flashlight, UART and the F4HWN features are on; VOX, NOAA, AirCopy, alarm/1750 Hz, voice prompts and the spectrum analyser are off. The spectrum and the FM radio do not fit in the flash together: `make BANDSCOPE=1` builds the bandscope edition with the spectrum (F + 5) instead of the FM radio. If you enable or disable features, some keys and menu items change. ### Conventions @@ -46,8 +46,9 @@ Power on ─ Main screen (VFO A / VFO B) ├─ F + M ──────────── Messages (SMS / POCSAG) │ ├─ M / PTT ── destination (RIC) ── M ── text ── M / PTT (send) │ └─ * ──────── OOK sender - ├─ F + EXIT ───────── OOK sender ── protocol list ── M ── fields ── PTT / M (send) + ├─ F + 7 / long 7 ── OOK sender ── protocol list ── M ── fields ── PTT / M (send) ├─ F + 0 / long 0 ─── FM broadcast radio + ├─ F + 5 ──────────── Spectrum (bandscope edition) ├─ F + 4 / long 4 ─── Frequency scanner ("close call") ├─ F + * ──────────── CTCSS / DCS scanner ├─ long * ─────────── Channel / range scan (on the main screen) @@ -64,14 +65,14 @@ Power on ─ Main screen (VFO A / VFO B) | **2** | type digit 2 | swap VFO A / B | same as long | | **3** | type digit 3 | toggle VFO / channel (memory) mode | same as long | | **4** | type digit 4 | frequency scanner | same as long | -| **5** | type digit 5 | channel: cycle the channel's scan lists (1, 2, 3 combinations). VFO: set / clear the scan range between VFO A and VFO B frequency | nothing (spectrum not built) | +| **5** | type digit 5 | channel: cycle the channel's scan lists (1, 2, 3 combinations). VFO: set / clear the scan range between VFO A and VFO B frequency | spectrum (bandscope edition only) | | **6** | type digit 6 | cycle TX power | same as long | -| **7** | type digit 7 | nothing (VOX not built) | nothing | +| **7** | type digit 7 | OOK sender (the VOX key; VOX is not built) | OOK sender | | **8** | type digit 8 | frequency reverse (swap RX / TX of a repeater pair) | backlight on demand (stays on; press again to restore) | | **9** | type digit 9 | go to the "1 Call" channel | backlight back to the normal timer | | **UP / DOWN** | next / previous channel or frequency step (hold to repeat) | repeat | squelch +1 / -1 | | **M** | open the menu | programmable action (menu `ML`) | Messages screen | -| **EXIT** | delete the last typed digit; stop scanning | cancel any typed input | OOK sender | +| **EXIT** | delete the last typed digit; stop scanning | cancel any typed input | cancel F | | **\*** | DTMF entry | start / stop scanning | CTCSS / DCS scanner | | **F** | arm F for the next key | keypad lock / unlock | - | | **SK1** | programmable (menu `F1S`, default MONI) | programmable (menu `F1L`, default NONE) | step size + | @@ -229,6 +230,39 @@ Power on ─ Main screen (VFO A / VFO B) | **F + 5** | cycle de-emphasis | | **F + 6** | cycle stereo blend | +### Spectrum / bandscope (F + 5, bandscope edition only) + +**Scanning view:** + +| Key | Action | +|---|---| +| **UP / DOWN** | move the centre / start frequency | +| **1 / 7** | scan step + / - | +| **2 / 8** | frequency change step + / - (what UP / DOWN move by) | +| **3 / 9** | display dB maximum + / - | +| **4** | number of scan steps (span) | +| **5** | type a frequency (digits, \* = decimal point, M confirms, EXIT deletes / cancels) | +| **0** | cycle the listening modulation | +| **6** | cycle the listening bandwidth | +| **\* / F** | RSSI trigger level + / - | +| **SK1** | blacklist the current peak frequency | +| **SK2** | backlight on / off | +| **PTT** | listen to the peak (still view) | +| **EXIT** | leave the spectrum (settings are saved) | + +**Still view (after PTT):** + +| Key | Action | +|---|---| +| **UP / DOWN** | tune; with a register selected: change the register value | +| **3 / 9** | display dB maximum + / - | +| **5 / 0 / 6** | frequency input / modulation / bandwidth | +| **\* / F** | RSSI trigger level + / - | +| **M** | select the next BK4819 register to adjust (LNA, mixer, PGA, …) | +| **SK1** | monitor (open squelch) on / off | +| **SK2** | backlight on / off | +| **EXIT** | leave the register selection / back to the scanning view | + ### Messages: SMS and POCSAG (F + M) The modem in `FSKMod` decides what is sent: @@ -241,7 +275,7 @@ The modem in `FSKMod` decides what is sent: |---|---| | **UP / DOWN** | previous / next page (2 messages per page, newest on the last page) | | **M** or **PTT** | write a new message | -| **2 / 8** | POCSAG only: TX deviation + / - (a popup shows the value; not saved, for tuning) | +| **2 / 8** | only in builds with `POCSAG_DEVIATION_TUNING=1`, POCSAG modes: TX deviation + / - (a popup shows the value; not saved) | | **\*** | OOK sender | | **EXIT** | back to the main screen | @@ -280,7 +314,7 @@ Pages are standard POCSAG alphanumeric (function 3, 576-bit preamble, two batche Build with `-DPOCSAG_DEBUG_UART=0` to switch the log off. -### OOK sender (F + EXIT, or \* in the message list) +### OOK sender (F + 7, long 7, or \* in the message list) Sends 433 MHz style remote control codes (garage doors, sockets, doorbells) by keying the carrier on and off on the current VFO frequency, usually 433.920 MHz. The frequency must be TX-allowed (`F Lock`). Otherwise the radio beeps and does not transmit. @@ -314,7 +348,10 @@ Every protocol also has **Pulse** (base pulse in µs, prefilled) and **Repeat** | `POCSAG_DEVIATION` | 963 | POCSAG TX deviation (REG_40) | | `POCSAG_TONE2_GAIN` | 127 | POCSAG FSK TX level | | `POCSAG_INVERT` | 1 | POCSAG bit polarity (1 = standard: logical 1 is the lower frequency) | -| `POCSAG_DEBUG_UART` | 1 | POCSAG receive log on the UART | +| `POCSAG_DEBUG_UART` | 1 | POCSAG receive log on the UART (0 in the bandscope edition) | +| `POCSAG_DEVIATION_TUNING` | 0 | keys 2 / 8 in the message list tune the POCSAG deviation | + +Pass defines with `make EXTRA_CFLAGS="-DPOCSAG_DEVIATION_TUNING=1"`. `make BANDSCOPE=1` builds the spectrum edition (FM radio off, debug log off); it fits with only a few bytes to spare. Changing `POCSAG_MAX_MESSAGE_LENGTH` or `MESSAGES_COUNT` moves the message slots in EEPROM, so messages stored before read back as garbage.