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.
Automatic Packet Reporting System
The APRS RX app receives and displays messages transmitted using the APRS (Automatic Packet Reporting System) protocol. It shows a live list of received stations including callsign, position (if available), hit count, and last received time.
Pre-configured Regions
Select a region to automatically tune to the correct APRS frequency for that area:
| Code | Frequency | Region |
|---|---|---|
| MAN | user-defined | Manual — frequency set manually |
| NA | 144.390 MHz | North America |
| NZ | 144.575 MHz | New Zealand |
| JAP | 144.640 MHz | Japan |
| PHI | 144.740 MHz | Philippines |
| EUR | 144.800 MHz | Europe / UK |
| THA | 144.900 MHz | Thailand |
| AUS | 145.175 MHz | Australia |
| BR | 145.570 MHz | Brazil |
| ISS | 145.825 MHz | International Space Station |
When a region is selected, the frequency field updates automatically. If you change the frequency manually afterwards, the region selector switches to MAN.
Controls
Frequency
- Use the rotary encoder over the frequency field to adjust in steps
- Press the middle button over the frequency field to enter a frequency manually via keypad
- Load a frequency from SD card using the frequency manager
Radio Settings
From left to right:
- AMP — RF amplifier:
0= off,1= on (+14 dB). Enable if signal is weak. - LNA — IF gain (0–40 dB in 8 dB steps)
- VGA — Baseband gain (0–62 dB in 2 dB steps)
See Description of gain settings for more details.
Volume
Audio volume is shown after the signal strength bars. Use the rotary encoder when focused on it.
Station List
The main screen shows a list of recently received APRS stations with the following columns:
| Column | Description |
|---|---|
| Source | Callsign of the transmitting station (with SSID if present) |
| Location | GPS coordinates if the packet contained a position report |
| Hits | Number of times this station has been received |
| Time | Time of last received packet |
Tap or select an entry to open the Detail View.
Detail View
Selecting a station from the list opens a detail screen showing the full decoded APRS packet information including the raw info field content. Two buttons are available:
- Done — return to the station list
- See Map — opens the map view centered on the station's position. This button is only visible if the station transmitted a valid GPS position.
Logging
Received packets are automatically logged to the SD card at:
LOGS/APRS.TXT
Each line contains the raw decoded APRS stream data. Logging is active as long as the app is running and a writable SD card is present.
Important Notes
- APRS RX on the HackRF is relatively insensitive. Enable AMP if you are not receiving stations that are clearly audible on a dedicated receiver.
⚠️ Be careful not to connect strong signals directly — the HackRF has no input protection.
- Some stations transmit with a bandwidth wider than the default 8.5 kHz. If you are missing packets, increase the reception bandwidth by editing the settings file on the SD card:
- Navigate to
SETTINGS/rx_aprs.iniusing the File Manager app - Select the file, press down to select the pen icon, press OK
- Find the line starting with
nbfm_config_indexand change the value:0= 8.5 kHz (default)1= 11 kHz2= 16 kHz
- Navigate to
Further Reading
- APRS TX — transmit APRS packets
- APRS Protocol Reference Manual
- aprs.fi — Live APRS map
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.