-
-
Notifications
You must be signed in to change notification settings - Fork 914
Config Menu
The Config Menu is a minimal pre-boot configuration interface that runs before the main firmware loads. It uses only the hardware buttons and LEDs — the LCD screen is not used.
The Config Menu activates automatically after 3 consecutive failed boot attempts (crashes or resets before the firmware fully loads). To enter it intentionally, press the RESET button 3 times in quick succession — each time before the firmware finishes loading.
Note
Some PortaPack models do not have a working RESET button. On those, unplugging and replugging the USB cable counts as a reset, and doing so 3 times quickly enough will trigger the Config Menu.
Note
The Config Menu can be disabled entirely via Settings → Config Mode. If disabled, it will never activate automatically or manually.
When entered successfully, all three LEDs (TX, RX, USB) will blink rapidly (~8 times per second). At this point, press the DFU button once to display the currently active settings.
Settings are displayed via the TX and RX LEDs. The USB LED is only used during the initial waiting phase and goes dark once the DFU button is pressed.
| TX LED | Setting |
|---|---|
| Off | Option 1: Automatic detection (default) |
| On | Option 2: LCD driver 1 |
| Blinking fast | Option 3: LCD driver 2 |
| Blinking slow | Option 4: LCD driver 2 QFP100 chip |
| Inverse blink slow | Option 5: LCD driver 1 QFP100 chip |
Note
The LCD driver can also be set at power-on using the directional buttons. See Won't-boot for details.
| RX LED | Setting |
|---|---|
| Off | External TCXO enabled / autodetect (default) |
| On | External TCXO disabled |
Note
This setting can also be changed via Settings → Radio.
Note
On HackRF R9 hardware, if the Config Menu is entered automatically due to boot failures, the external TCXO is temporarily disabled for the duration of the Config Menu session. This is because the TCXO is the most likely cause of the crash. The original setting is restored when you exit.
Each press of the DFU button advances to the next combination of settings. Both the LCD driver and TCXO settings are cycled together — after 10 presses you return to the original active combination.
Warning
Do not press the DFU button too quickly. Hold it down for at least 200ms or the press may be ignored.
Each new selection is saved immediately to persistent memory. The device can be restarted at any time and the selected settings will be active.
In some cases a PortaPack may enter Config Menu mode unexpectedly — for example when the power button is pressed rapidly multiple times, or if electrical noise occurs when a USB cable is attached (causing false resets). If this happens frequently (dark screen with blinking LEDs), the Config Menu can be permanently disabled via Settings → Config Mode, which sets a flag in persistent memory to skip the Config Menu entirely on all future boots.
How to collaborate
Contributing Guidelines
Trusted contributors
How to ask questions correctly
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
-
Description of the hardware
- Enclosure/cases
- Repairs
- Mods
- 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
- 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
- 📥 Receivers
- 2-Tone-RX
- ACARS
- ADS-B
- AFSK
- AIS Boats
- Analog TV
- APRS RX
- Audio
- BLE RX
- Detector
- EPIRB RX
- ERT Meter
- Flex RX
- Radio
- Fox-Hunt
- FPV-Detect
- gfxEQ
- Level
- Meteor
- Morse RX
- NOAA
- NRF
- POCSAG
- ProtoView
- Radiosonde
- RTTY RX
- Scanner
- Search
- Signal Hunter
- SSTV RX
- SubCar
- SubGhzD
- Tetra RX
- Time Sink
- TPMS RX
- Weather
- WeFax
- VOR RX
- 📤 Transmitters
- 2-Tone-TX
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB TX
- Flex TX
- 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
- Security+ TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- VOR TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
▶️ Replay- 🖲️ Remote
- 🔍 Looking Glass
- 🛠️ Utilities
- 🎮 Games
- ⚙️ Settings
- 💻 HackRF Mode
-
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