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.
User Interface
The PortaPack display is 240×320 pixels. The screen is divided into three horizontal bands that are always present:
┌─────────────────────────────┐ ← 16 px Title bar
│ │
│ App content area │ ← 288 px
│ │
├─────────────────────────────┤ ← 16 px Information bar
Title bar
The top 16 pixels form the Title-Bar. It contains:
- Navigation controls (back arrow, app name) on the left
- Configurable status icons and quick-action buttons on the right
App content area
The middle 288 pixels are used by the currently running app. On the main-menu this shows the 2-column button grid. Inside apps it shows the app's own controls and display.
Information bar
The bottom 16 pixels always show:
- Left: Firmware version string (e.g.
n_250606). If a firmware checksum error is detected at boot, this showsFLASH ERRin red instead. - Right: Live UTC clock, updated every second. Date display can be enabled via Settings → User Interface.
Splash screen
A splash screen is shown on each boot before the main menu appears. Tap the screen or press any button to skip it immediately.
By default a random image is selected from the SPLASH/ folder on the SD card. If a file named splash.bmp exists in the SD card root, that file is used instead and the random selection is skipped.
Splash display can be enabled or disabled under Settings → Display. See Create-a-custom-splash-screen for image format requirements.
Sub-pages
- Title-Bar — all title bar icons, their functions and active colours
- main-menu — main menu layout and available entries
- Main-Controls — common controls: frequency field, step size, bandwidth, gain
- Text-Entry — the on-screen keyboard used for text input
- Screenshots — how to capture and save screenshots
- Sleep-mode — display sleep and backlight auto-timeout
- Stealth-Mode — automatic backlight-off during transmission
- SD-Card-Content — SD card folder structure used by the firmware
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.