Table of Contents

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Untitled

Overview

More apps need to be moved from internal to external to make room for new features in the flash ROM. Considerations regarding exactly which apps should be moved from internal to external include the following:

Some apps should remain internal for better user experience (screens with fewer menu icons, and warnings about missing apps, are not the best look at first power-on).
Some core apps should remain internal for functional reasons, including the capability to install the external apps on the SD card (including the Flash Utility, SD-over-USB, and some Settings apps).
Some apps require the SD card to be installed and often to contain specific data files (such as map data or C8/C16 files) so it may make sense to move the app itself to the SD card too; no loss of functionality.
External app code is loaded into RAM (like the baseband M4 code), so will have less free RAM space available to operate, so apps that require more memory (including those that allocate lots of memory or use File Manager to select files) should not be moved to external.
Running code from RAM, external apps may have slightly better performance than internal apps that run from ROM (although they will still make many calls into the ROM code).
We also need to devise a way to sort the apps on the screen by the user and for consistency, since the external apps are currently at the end of the list and their position in the menu is randomly determined by their position in the FAT directory.

‍

Legend

✅: Fully

✔️: Partial

🚫: Not at all

Apps Currently in SPI Flash

(THE TABLES BELOW ARE VERY INCOMPLETE)

Catalog	App Name	Can work without sdcard?	Can work without correctly put sdcard content?	Importance	Current Suggest
Home	Capture	🚫	✅	✅ Core app	Stay in SPI flash
/	Replay	🚫	✅	✅ Core app	Stay in SPI flash
/	Remote	🚫	✅
/	Scanner	✅	✅
/	Microphone	✅	✅	✅ Core app	Stay in SPI flash
/	Looking Glass	✅	✅	✅ Core app	Stay in SPI flash
Receive	ADS-B	✔️	✔️
/	AIS Boats	✅	✅
/	APRS	✅	✅
/	Audio	✔️	✅	✅ Core app	Stay in SPI flash
/	BLE Rx	✔️	✅
/	ERT Meter	✅	✅
/	Level	✅	✅
/	POCSAG	✅	✅
/	Radiosnde	✅	✔️
/	Recon	✅	✔️
/	Search
/	TPMS	✅	✅
/	Weather	✅	✅
/	SubGhzD	✅	✅

Apps Currently in sdcard

Catalog	App Name	Can work without sdcard if moved to SPI flash?	Can work without correctly put sdcard content if moved to SPI flash?	Importance	Current Suggest
Receive	AFSK				Stay in sdcard
Utilities	Pac-Man	✅	✅	Game	Stay in sdcard
Transmit	GPSSim	🚫	🚫		Stay in sdcard

Start here

How to collaborate
How to ask questions correctly

User manual

First steps
- About firmwares
- Redirections on this manual/project
Usage cautions
Intended use and Legality
Features
PortaPack Versions (which one to buy)
HackRF Versions
- Original GSG HackRF One
- Clifford's-version
Firmware update procedure
- Updating the Xilinx CPLD on hackrf board
Description of the hardware
- Enclosure/cases
  - 3d printed enclosure
- Internal speaker
- SMD buttons and caps
- Encoder knob
- SMA Antenna connector
User interface
Powering the PortaPack
Troubleshooting
Applications
- Receivers
  - ADS-B
  - AFSK
  - AIS Boats
  - Analog TV
  - APRS
  - Audio
  - BLE RX
  - ERT Meter
  - Level
  - NRF
  - POCSAG
  - Radiosonde
  - Recon
  - Search
  - TPMS Cars
  - Weather/SubGhzD
  - Fox-Hunt
  - ProtoView
- Transmitters
  - ADS-B(S)
  - APRS
  - BHT Xy/EP
  - BLE TX
  - Burger Pager
  - GPS Sim
  - Jammer
  - LGE Tool
  - Morse
  - OOK
  - OOK Editor
  - POCSAG
  - RDS
  - Soundboard
  - Spectrum Painter
  - SSTV
  - TEDI/LCR
  - TouchTunes
  - BLESpam
- Capture
  - C16 Format
- Replay
- Remote
- Scanner
- Microphone Transceiver
- Looking Glass
- Utilities
- Settings
  - App Settings
  - Audio
  - Blacklist
  - Calibration
  - Touchscreen Threshold
  - Config Mode
  - Converter
  - Date/time
  - Encoder Dial
  - Freq. Correct
  - P.Mem Mgmt
  - QR code
  - Radio
  - User Interface
  - Brightness
  - Menu Color
- Debug
- HackRF Mode
- USB Serial Console

Developer Manual

Compilation of the firmware
Create a custom map
Code formatting
PR process
Description of the Structure
Software Dev Guides
- Code contribution rules
- Create a Simple App
- Building External Apps
- Widgets
- SD Card
- Access Radio Hardware
- Interpret Guru meditation crashes
- Create a Complex App
- Theme-system
- Debug via SWD & JTAG
- Debug with serial
- I2C drivers
Tools
Research
- Dissecting the Temperature Logger
- Differences between H1 and H2
UI Screenshots
Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
Development States Notes

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.