(nearly) Free custom firmware for your Pinephone’s modem!

This repository contains everything you need to make your own Modem userspace for your Pinephone.

Latest release: Version 0.7.4

Supported devices:

• Pinephone
• Pinephone Pro
• EG25-G connected via USB audio

• Flashing guide
• Recommended settings for this firmware
• Build your own
• Returning back to stock
• Having issues? Check out if the issue is already documented or create a new one
• We also have a Matrix room!

Current Status:

• LK Bootloader: Working
  • On reset, the bootloader enters into fastboot mode automatically for 5 seconds, and boots normally unless instructed to stay (leave the command fastboot oem stay running while rebooting the modem to make it stop at fastboot).
  • Custom fastboot commands:
  • fastboot reboot-bootloader: Reboot to fastboot
  • fastboot oem stay: Stay in fastboot instead of booting normally
  • fastboot oem reboot-recovery: Reboot to recovery mode
• CAF Kernel: Working
• Audio: Working Check out recommended settings for your phone
• SMS: Working
• GPS: Working
• Sleep / Power management: Working (New current measurement and profiling required after latest changes)
• System images:
  • root_fs: Default system image. Includes a minimal root filesystem and one application replacing the entire Qualcomm / Quectel stack. Some functions may not yet functional
  • recovery_fs: Minimal bootable image to be flashed into the recovery partitions to retrieve logs and make changes to the root image
• Custom AT Commands: Please see this document

Features not available on stock firmware:

• Signal tracking support (beta): Get notified whenever your modem changes towers, check against the OpenCellid database, and make it shutdown when it connects to an unknown cell
• Network data export as csv files
• Set a reminder on the modem and it will call you back and speak the message you sent it (perfect for boring meetings!)
• Call recording support (manual or automatic)
• Cell broadcast relay to the host as SMS
• Internal call and SMS support
  • Functionality is added on every release, check out the document for available commands
• Optional persistent storage: By default an unexpected shutdown can’t mess your modem
  • If you want to keep logs after reboot, you can enable persistent storage
• SMS logging capability: It can log every message you send or receive
• Automatic time synchronization from the carrier into the userspace
• Minimum clock frequency is set to 100Mhz, either awake or sleeping (stock is 800MHz awake and 400Mhz sleep), making the modem run cooler
• Different sampling rates available at runtime without requiring a reboot (missing companion app in the pinephone to make use of them)
• 0 binary blobs in the userspace. Only closed source running on the modem are TZ Kernel and ADSP firmware

TODO (in no particular order)

1. [WIP] Find and fix the last remaining USB port reset cause(s)
2. [Testing] Fix audio when doing conferences (audio is cut off when hanging up the first call)
3. [WIP] Internal SMS functionality (Working reliably with ModemManager and in testing with oFono):

• Can send and receive messages to/from the modem
• Modem will answer to the number: +22 33 44 55 66 77
• Send “help” for a list of commands or check the docs

4. [WIP] Internal call ability (Working with ModemManager / testing with oFono):

• Can accept outgoing calls or automatically call you when requested from the chat (send “call me” or “call