README: BRN-POCSAG, build toggles, EEPROM layout and CHIRP driver
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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. 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.
|
||||
This firmware is **BRN-POCSAG**: F4HWN / egzumer with POCSAG paging, SMS, an OOK remote sender and 171 memory channels. 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
|
||||
|
||||
@@ -158,7 +158,7 @@ Power on ─ Main screen (VFO A / VFO B)
|
||||
| COMP | OFF, TX, RX, TX/RX | compander |
|
||||
| Mod | FM, AM, USB, BYP, RAW, ALM, BEE, CTC, FSA, UN4–UN9 | demodulation. Everything after USB is an experimental raw / test mode |
|
||||
| ScAdd1 / ScAdd2 / ScAdd3 | OFF, ON | channel is in scan list 1 / 2 / 3 |
|
||||
| ChSave | channel number | save the current VFO to a channel |
|
||||
| ChSave | channel number (1–171) | save the current VFO to a channel |
|
||||
| ChDele | channel number | delete a channel |
|
||||
| ChName | channel number | edit a channel name |
|
||||
| SList | 0 no list, 1, 2, 3, 4 lists 1+2+3, 5 all | scan list used by the channel scan |
|
||||
@@ -267,7 +267,7 @@ Power on ─ Main screen (VFO A / VFO B)
|
||||
|
||||
The modem in `FSKMod` decides what is sent:
|
||||
- **SMS modes:** this firmware's own FSK SMS. Up to 20 characters, with acknowledgement, retries and relay.
|
||||
- **PCS modes:** standard POCSAG alphanumeric pages. Up to 33 characters, to any pager or POCSAG receiver.
|
||||
- **PCS modes:** standard POCSAG alphanumeric pages. Up to 40 characters, to any pager or POCSAG receiver. The radio stores the last 26 messages.
|
||||
|
||||
**Message list:**
|
||||
|
||||
@@ -341,20 +341,45 @@ Every protocol also has **Pulse** (base pulse in µs, prefilled) and **Repeat**
|
||||
|
||||
### Build options
|
||||
|
||||
**Make toggles** (`make ENABLE_POCSAG=0 …`):
|
||||
|
||||
| Toggle | Default | Effect |
|
||||
|---|---|---|
|
||||
| `ENABLE_POCSAG` | 1 | POCSAG modem modes (PCS1200 / 512 / 2400) and `PocMon`; off leaves only the SMS FSK modes |
|
||||
| `ENABLE_POCSAG_DEBUG` | 1 | POCSAG receive log on the UART (off in the bandscope edition) |
|
||||
| `ENABLE_POCSAG_DEV_TUNING` | 0 | keys 2 / 8 in the message list tune the POCSAG deviation |
|
||||
| `ENABLE_OOK_SENDER` | 1 | OOK remote sender (F + 7, \* in the message list) |
|
||||
| `BANDSCOPE` | 0 | 1 = bandscope edition: spectrum on, FM radio off; fits with only a few bytes to spare |
|
||||
| `ENABLE_FMRADIO`, `ENABLE_SPECTRUM`, `ENABLE_FLASHLIGHT`, … | | the usual F4HWN / egzumer feature toggles at the top of the `Makefile` |
|
||||
|
||||
**Defines** (`make EXTRA_CFLAGS="-DNAME=value"`):
|
||||
|
||||
| Define | Default | Effect |
|
||||
|---|---|---|
|
||||
| `POCSAG_MAX_MESSAGE_LENGTH` | 33 | longest POCSAG message and stored message text (max 45, two batches) |
|
||||
| `MESSAGES_COUNT` | 12 | number of stored messages; the build fails if the store would reach the calibration data at `0x1E00` |
|
||||
| `POCSAG_MAX_MESSAGE_LENGTH` | 40 | longest POCSAG message and stored message text (max 45, two batches) |
|
||||
| `MESSAGES_COUNT` | as many as fit (26) | number of stored messages; the build fails if the store would reach the calibration data at `0x1E00` |
|
||||
| `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 (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.
|
||||
|
||||
### EEPROM layout and CHIRP
|
||||
|
||||
This firmware reports itself as **BRN-POCSAG** and uses its own EEPROM layout, so other UV-K5 CHIRP drivers (stock, egzumer, F4HWN) do not accept it. Use `chirp/uvk5_brnpocsag.py` (CHIRP → *Help* → *Developer mode*, then *File* → *Load Module*). It covers all 171 channels, the 14 VFOs, the settings and the message store (read, edit, delete all).
|
||||
|
||||
| Address | Contents |
|
||||
|---|---|
|
||||
| `0x0000` | channels 1–114, 32 bytes each: frequency, offset, codes, flags, 10-character name, 16-bit scrambler |
|
||||
| `0x0E40` | settings (FM presets, menu settings, DTMF codes, scan lists, POCSAG / SMS address) |
|
||||
| `0x0F50` | channel attributes (band, compander, scan lists 1–3) |
|
||||
| `0x1020` | VFOs, 7 bands × A / B |
|
||||
| `0x11E0` | channels 115–171 |
|
||||
| `0x1900` | message counters, then 26 messages × 48 bytes (40 characters) |
|
||||
| `0x1E00` | calibration (only written with *upload calibration*); `0x1FF0` F4HWN settings (written on every upload) |
|
||||
|
||||
**Upgrading from an older build:** the channel layout changed (24-byte records before, 16 bytes in stock / F4HWN). Stored channels and messages from older builds do not carry over. After flashing, do a `Reset` → `ALL` (or upload a fresh CHIRP image), then program the channels again with the driver above.
|
||||
|
||||
# Donations
|
||||
|
||||
Special thanks to Jean-Cyrille F6IWW (2 times), Fabrice 14RC123, David F4BPP, Olivier 14RC206, Frédéric F4ESO, Stéphane F5LGW, Jorge Ornelas (4 times), Laurent F4AXK, Christophe Morel, Clayton W0LED, Pierre Antoine F6FWB, Jean-Claude 14FRS3306, Thierry F4GVO, Eric F1NOU, PricelessToolkit, Ady M6NYJ, Tom McGovern (3 times), Joseph Roth, Pierre-Yves Colin, Frank DJ7FG, Marcel Testaz, Brian Frobisher, Yannick F4JFO, Paolo Bussola, Dirk DL8DF, Levente Szőke (2 times), Bernard-Michel Herrera, Jérôme Saintespes, Paul Davies, RS, Johan F4WAT, Robert Wörle, Rafael Sundorf, Paul Harker, Peter Fintl, Pascal F4ICR (2 times), Mike DL2MF, Eric KI1C (2 times), Phil G0ELM, Jérôme Lambert, Meinhard Frank Günther, Eliot Vedel, Alfonso EA7KDF, Jean-François F1EVM and Robert DC1RDB for their [donations](https://www.paypal.com/paypalme/F4HWN). That’s so kind of them. Thanks so much 🙏🏻
|
||||
|
||||
Reference in New Issue
Block a user