Table of Contents
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Receives pager messages using the POCSAG protocol.
This protocol operates in the VHF/UHF bands using FSK modulation.
UI Overview
Settings
- Frequency: Sets the frequency to receive pager messages on. Can be adjusted with the encoder knob, on-screen numpad, or loaded from frequencies saved on an SD card. 439.9875 MHz is the most popular worldwide frequency used by amateur radio for POCSAG. Amateur radio POCSAG uses 1200 bps.
- RF amplifier (0 or 1): Enables/disables the internal RF amplifier.
- LNA gain (0, 8, 16, 24, 32, 40): Sets the LNA gain. See Receive Quality Issues for details.
- VGA gain (0 to 62): Sets the VGA gain. See Receive Quality Issues for details.
- RSSI/Audio: Top bar indicates signal strength. Bottom bar indicates the audio level. The audio bar can be useful for tuning settings without headphones or a speaker.
- Squelch (0–99): Sets the minimum signal level required to start decoding. 0 disables squelch (all signals decoded regardless of strength). Higher values require a stronger signal — use this to avoid decoding weak or noisy signals that would produce garbled output.
- Volume: Output volume for the received audio.
Information
- Decoder Status: Indicates the status of the decoder state machine. White: Idle, Cyan: Clear, Yellow: Waiting for message start, Green: Waiting for rest of message.
- Batch Count: Number of message batches received. A batch has 16 codewords.
- Bits: Displays the bits being decoded into codewords.
- Sync: Green when the frame decoder has received a sync frame. Messages are not decoded unless a sync frame is found.
- Codewords: Shows the number of codewords in the current batch. When the bar fills, the batch is complete and processed.
- Baud Rate: The detected rate of the current message.
05: 512 bps,12: 1200 bps,24: 2400 bps.
Buttons
- Ignore Last: Sets the filter to drop messages sent to the last received address.
- Config: Opens the settings page
Config
- Enable Log: Logs decoded messages to
LOGS/POCSAG.TXTon the SD card. - Log Raw Data: Also logs the batch codewords as hexadecimal. Useful for debugging decoder issues.
- Use Small Font: Uses a smaller font in the UI to show more messages on screen at once.
- Hide Bad Data: Do not show (or log) codewords that fail checksum validation.
- Hide Addr Only: Do not show (or log) codewords that contain an address but no message payload.
- Filter Mode / Filter Address: Controls address filtering.
Nonedisables filtering.Drophides messages sent to the specified address.Keepshows only messages sent to the specified address and hides all others. - Beta: Enables the newer POCSAG baseband processor. The app must be restarted after changing this option.
- Save: Saves the current settings changes.
Note: Settings are only saved and restored if App Settings is enabled in the global Settings menu.
Message Display
Typical message:
12:34 1200 #432123 F2
This is a test message
Description (from top-left):
12:34— Time: When the message was received (PortaPack clock time).1200— Data rate: The baud rate used to receive the message.#432123— Address: The pager address the message was sent to.F2— Function: A value 0–3 indicating the message type or source category.This is a test message— Message: The decoded message text.
Messages displayed in magenta contain a high number of decoding errors and may be unreliable.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Start here
Contributors
How to collaborate
Contributing Guidelines
How to ask questions correctly
Hardware
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
- Description of the hardware
- Enclosure/cases
- Repairs
- Mods
User manual
Intended use and Legality
- Usage cautions
- First steps
- Firmware update procedure
- User interface
- Powering the PortaPack
- Troubleshooting
- Won't boot
- Config Menu
- Firmware upgrade
- Diagnose firmware update in Windows
- Receive Quality Issues
- No TX/RX
- TX Carrier Only
- H2+ speaker modifications
- Dead Coin Cell Battery
- Factory Defaults
- SD card not recognized by PC with the SD-card over USB selected
- DFU overlay
- Full reset
- SolveBoard
- How to Format SDCard
- What if I don't like some of the apps
Applications
- 📥 Receivers
- 📤 Transmitters
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB
- FlipperTX
- GPS Sim
- Hopper
- Jammer
- KeeLoq TX
- Key fob TX
- LGE Tool
- MDC-1200 TX
- Morse TX
- OOK
- OOK Brute
- OOK Editor
- P25 TX
- POCSAG TX
- RDS
- RTTY TX
- SAME TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
- ▶️ Replay
- 🖲️ Remote
- 🔍 Looking Glass
- 🛠️ Utilities
- 🎮 Games
- ⚙️ Settings
- 💻 HackRF Mode
Misc
Developer Manual
- Compilation of the firmware
- Compile on WSL with ninja
- How to compile on Windows faster with WSL 2
- Using Docker and Kitematic
- Docker command-line reference
- Using Buddyworks and other CI platforms
- Notes for Buddy.Works (and other CI platforms)
- Using ARM on Debian host
- All in one script for ARM on Debian host
- Compile on Arch based distro (exclude Asahi), or other weird distros
- Dev build versions
- Notes About ccache
- Create a custom map
- Code formatting
- PR process
- Description of the Structure
- Software Dev Guides
- Tools
- Research
- UI Screenshots
- Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
- Development States Notes
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Note
The wiki is incomplete. Please add content and collaborate.
Important
- This is a public wiki. Everything is visible to everyone. Don't use it for personal notes.
- Avoid linking to external tutorials/articles; they may become outdated or contain false information.