Table of Contents

RTC Subsystem

backup_ram region

data_t struct
Variables stored in persistent memory
ui_config Bit position / Description
Using this two new booleans

This is part of the RTC (Real Time Clock) subsystem, inside the LPC43xx chip on the Portapack hardware.

RTC Subsystem

The RTC subsystem keeps the actual clock (date / time) running, powered by a back up coin battery (which needs to be installed on the portapack board),even when the unit is not connected to an USB power source. And on top of this RTC functionality, the same coin battery will keep persistent a small region of VBAT-maintained SRAM (0x40041000, 256 bytes) for saving system state settings when the device is powered off.

The persistent memory map is defined at /firmware/chibios-portapack/os/hal/platforms/LPC43xx/lpc43xx.inc:

 **LPC_RTC_DOMAIN_BASE**       (0x40040000)
 **LPC_ALARM_TIMER_BASE**      (LPC_RTC_DOMAIN_BASE + 0x0000)
 **LPC_BACKUP_REG_BASE**       (LPC_RTC_DOMAIN_BASE + 0x1000) <-backup_ram region!
 **LPC_POWER_MODE_CTRL_BASE**  (LPC_RTC_DOMAIN_BASE + 0x2000)
 **LPC_CREG_BASE**             (LPC_RTC_DOMAIN_BASE + 0x3000)
 **LPC_EVENT_ROUTER_BASE**     (LPC_RTC_DOMAIN_BASE + 0x4000)
 **LPC_OTP_CTRL_BASE**         (LPC_RTC_DOMAIN_BASE + 0x5000)
 **LPC_RTC_BASE**              (LPC_RTC_DOMAIN_BASE + 0x6000)

backup_ram region

The backup_ram region is a small amount of ram (only 256 bytes), defined in /firmware/common/memory_map.hpp using the LPC_BACKUP_REG_BASE label, thus starting at address 0x40041000

data_t struct

The Portapack firmware uses the backup_ram region to store several uint32_t (and one uint64_t) variables, inside a struct, called "data_t", declared on /firmware/common/portapack_persistent_memory.cpp

Variables stored in persistent memory

Found in original portapack, but only carrying a few configuration variables, it was later expanded by furrtek's HAVOC version, incorporating several new configuration parameters.

Among those new variables, there is a uint32_t config_t used as storage for a few boolean flags.

On MAYHEM's version, we've added two new boolean configuration parameters, particularly useful for H1 users including "Speaker is present" and "Back Buttons on menus".

You can find them implemented as two new configuration checkboxes inside OPTIONS->UI.

These two new boolean parameters have been added into the uint32_t ui_config variable, Which now it is mapped as following:

ui_config Bit position / Description

31 (HAVOC)Splash screen
30 (HAVOC)Login
29 (HAVOC)Start in stealth mode
28 (MAYHEM H1 Branch)Place a back ("..") button in each menu
27 (MAYHEM H1 Branch)Use speaker output (H1 model accepts a speaker)

Using this two new booleans

They can be reached from anywhere by adding (if not already there) this include:

#include "portapack_persistent_memory.hpp"

and then you can check the configuration status for each parameter with:

portapack::persistent_memory::config_backbutton()

and

portapack::persistent_memory::config_speaker()

They return either TRUE or FALSE, depending on how they've been configured.

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

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 Connector replacement or removal
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

Hardware Hacks

Repairs
- Replace AMP
Mods
- Add GPIO TO H2
- USB‐C charging modification for older HackRF boards

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.