113 lines
6.0 KiB
Markdown
113 lines
6.0 KiB
Markdown
# ESP32-H2 POCSAG Receiver
|
|
|
|
An experimental ESP-IDF 6.0 receiver for 1200-baud POCSAG using an ESP32-H2, CC1101, and 128x64 SPI SSD1306 OLED. The CC1101 is configured for a 26 MHz crystal and 435 MHz by default. Reception is decoded in firmware from the CC1101 asynchronous GDO0 output.
|
|
|
|
This project is receive-only. It does not implement POCSAG transmission.
|
|
|
|
## Hardware Pins
|
|
|
|
All button inputs are active-low and use the ESP32-H2 internal pull-ups. Connect external pushbuttons between their GPIO and GND. BOOT remains available as a complete single-button fallback.
|
|
|
|
| ESP32-H2 GPIO | Function |
|
|
| --- | --- |
|
|
| GPIO0 | CC1101 MISO |
|
|
| GPIO1 | CC1101 CSN |
|
|
| GPIO2 | Battery-divider ADC input when enabled; ADC1 channel 1 |
|
|
| GPIO3 | CC1101 GDO0 asynchronous data |
|
|
| GPIO4 | Shared SPI SCLK for CC1101 and OLED |
|
|
| GPIO5 | Shared SPI MOSI for CC1101 and OLED |
|
|
| GPIO6 | Menu Up button |
|
|
| GPIO7 | Menu Down button |
|
|
| GPIO8 | On-board NeoPixel data |
|
|
| GPIO9 | BOOT button |
|
|
| GPIO10 | OLED CS |
|
|
| GPIO11 | OLED DC |
|
|
| GPIO12 | OLED reset |
|
|
| GPIO13 | Normal status LED |
|
|
| GPIO14 | Menu Select button |
|
|
|
|
The shared SPI bus runs CC1101 and the OLED on separate chip-select pins. Keep the listed SPI, RF, display, and LED pins unchanged unless you also update the firmware and wiring.
|
|
|
|
**Button wiring change:** GPIO2 is now reserved for the optional battery ADC. The optional Select button is GPIO14; if it is still wired to GPIO2 from an earlier firmware version, move it to GPIO14 before enabling battery monitoring.
|
|
|
|
## Battery Measurement
|
|
|
|
The board's battery pads are power connections, not a voltage-sense output. Do not connect a Li-ion battery directly to an ESP32 GPIO: a charged cell can reach 4.2 V and exceed the ADC input range.
|
|
|
|
To measure battery voltage, install an external resistor divider:
|
|
|
|
```text
|
|
BAT+ ---- Rtop ----+---- GPIO2 (ADC1_CH1)
|
|
|
|
|
Rbottom
|
|
|
|
|
GND ---------------+---- ESP32-H2 GND
|
|
```
|
|
|
|
The defaults in `main/main.c` are `Rtop = 100 kOhm` and `Rbottom = 100 kOhm`, so 4.2 V at the battery produces about 2.1 V at the ADC pin. Use the actual installed resistor values in `BATTERY_DIVIDER_TOP_OHMS` and `BATTERY_DIVIDER_BOTTOM_OHMS`; the firmware calculates:
|
|
|
|
```text
|
|
battery_mV = adc_pin_mV * (Rtop + Rbottom) / Rbottom
|
|
```
|
|
|
|
After wiring and checking that the ADC pin voltage stays below the ESP32-H2 ADC limit, set `BATTERY_MONITOR_ENABLE` to `1`. The firmware uses ADC one-shot mode with IDF calibration, samples every five seconds, logs millivolts, and shows the voltage on the live screen. It is disabled by default because this board revision has no built-in voltage-sense circuit.
|
|
|
|
## Controls and Menu
|
|
|
|
With the added buttons:
|
|
|
|
- **Up / Down:** move through menu items; browse older/newer history; decrease/increase the tuning candidate.
|
|
- **Select:** activate the selected menu item, apply a tuned frequency, enter history from Live, or return to Live from History.
|
|
- **BOOT fallback:** short press advances through menu items, message pages, and history; long press opens the menu or selects/applies the current item.
|
|
|
|
The menu contains:
|
|
|
|
- **Filter:** Private mode is the default and stores/displays only `MY_RIC`. Monitor mode stores/displays all decoded RICs. Switching modes clears the in-memory history.
|
|
- **Frequency:** opens the receive-only tuner.
|
|
- **Live display:** returns to the main screen.
|
|
- **Message history:** shows the eight most recent saved messages.
|
|
- **Return:** goes back to the previous screen.
|
|
|
|
The tuner steps in 25 kHz increments across 433.000 to 435.500 MHz. Up/Down choose either direction; Select applies the frequency, recalibrates the CC1101, and resumes reception. With BOOT only, short presses step upward and wrap at the end; a long press applies the candidate.
|
|
|
|
The live screen updates while a message is decoded. Messages up to 159 characters are displayed over multiple pages. In Live, BOOT short-press advances message pages and then opens history. The OLED turns off after 60 seconds without UI activity; button presses and displayed pages wake it.
|
|
|
|
Pages addressed to `MY_RIC` (default `1234567`) flash the normal LED on GPIO13 and NeoPixel on GPIO8 for approximately three seconds.
|
|
|
|
## Persistent Message History
|
|
|
|
The firmware stores the eight-entry message ring in the default NVS partition. Saved messages are restored after reboot or power loss. Private mode saves only `MY_RIC`; Monitor mode saves all decoded RICs. Changing the filter mode clears the stored history. NVS is initialized automatically on startup; if its metadata is incompatible or out of free pages, ESP-IDF recovery may erase the NVS partition and the saved messages.
|
|
|
|
## Flash Layout
|
|
|
|
The ESP32-H2 has 4 MB of flash, and `sdkconfig` now sets the ESP image header flash size to 4 MB. The existing single-app partition layout is retained: it provides a 1 MB factory application partition plus the standard NVS and PHY partitions. The remaining flash is currently unused; the firmware does not resize partitions automatically.
|
|
|
|
## Configuration
|
|
|
|
Important definitions are near the top of `main/main.c`:
|
|
|
|
- `RF_FREQ_HZ`: startup receive frequency.
|
|
- `TUNE_MIN_HZ`, `TUNE_MAX_HZ`, `TUNE_STEP_HZ`: menu tuner range and step.
|
|
- `MY_RIC`: private-mode address and own-page alert address.
|
|
- `BATTERY_MONITOR_ENABLE`: battery voltage reading, disabled by default.
|
|
- `BATTERY_DIVIDER_TOP_OHMS`, `BATTERY_DIVIDER_BOTTOM_OHMS`: installed divider resistor values.
|
|
- `OLED_IDLE_OFF_MS`: OLED timeout.
|
|
|
|
The firmware assumes a 26 MHz CC1101 crystal. Confirm the crystal and signal frequency for your hardware. The frequency tuner only changes the receiver frequency.
|
|
|
|
## Build and Flash
|
|
|
|
Open the project in ESP-IDF 6.0 with target `esp32h2`, then run:
|
|
|
|
```sh
|
|
idf.py build
|
|
idf.py -p PORT flash
|
|
idf.py -p PORT monitor
|
|
```
|
|
|
|
The component dependencies include the ESP-IDF GPIO, SPI, GPTimer, ADC, NVS, and Espressif LED-strip drivers.
|
|
|
|
## Limitations
|
|
|
|
This is a proof of concept, not a certified pager or radio product. Reception quality depends on CC1101 configuration, antenna, RF environment, and signal timing. The firmware does not transmit pages or save menu settings across reboot.
|