Pinephone Modem SDK

Custom firmware for your Pinephone's modem

Dependencies

This project depends on the following repositories:

• LK - Little Kernel bootloader
• Downstream 3.18.140 Kernel based on CAF
• Forked meta-qcom repository
• The Yocto Project

Make sure you have your recoveries ready just in case:

• Quectel EG25 firmware repo

Rolling your own? Check the Howto

Want to flash it? Here's a guide!

Going back to stock? There's a Howto too!

Latest release:

Yocto 3.3.2

Current Status:

• LK Bootloader

  • Image building: Works
  • Bootloader functionality:
    • Boot: OK
    • Flash: OK
    • Debugging: Via debug UART
    • Signals and custom boot modes via GPIO pins: OK
      • Check tools/helpers for scripts to force boot into fastboot or out of it
      • Fastboot auto entering: OK
    • On reset, the bootloader enters into fastboot mode automatically for 2 seconds, and boots normally unless instructed to stay (leave the command fastboot oem stay running while rebooting the modemto make it stop at fastboot).
  • Custom fastboot commands:
    • fastboot reboot-bootlader: Reboot to fastboot
    • fastboot oem stay: Stay in fastboot instead of booting normally
    • fastboot oem reboot-recovery: Reboot to recovery mode
    • fastboot oem reboot-edl: Currently not working (investigating why)
    • fastboot oem getmfg: Try to identify the modem from the partition table

• CAF Kernel:

  • Building: Works
  • Booting: Works
    • USB Peripheral mode: WWAN+ADB are working blobfree, WWAN+GPS+ADB with blobs
    • Modem (ADSP): Firmware loading, booting, data and calling works.
  • Audio: Working, needs fine tunning (1-5 seconds of silence on call start)
  • Ring In: Works correctly when setting the modem to report RING to all interfaces. You can do this by sending the following command to the modem:
    • AT+QURCCFG="urcport","all". Most distros have this setting already enabled
  • Call volume: May need some tweaking to the ALSA UCM configuration file. You can do this by editing /usr/share/alsa/ucm2/PinePhone/VoiceCall.conf. These values seem to work well:
    • cset "name='AIF1 DA0 Playback Volume' 90%"
    • cset "name='AIF2 DAC Playback Volume' 90%"
    • A reboot is required after changing this configuration file.
  • GPS: Working
  • Sleep / Power management: The kernel is always running in low power mode now, this should make the Pinephone consume between 1.12%-1.89% battery on suspend, giving a max runtime on a battery charge of 78 hours / 3 days if there's nothing waking it up, in par with factory firmware with ADB disabled.
  • Non persistent data partition (now there's no way of corrupting anything when killing the modem)

• System images:

  • root_fs: Default system image. Includes a minimal root filesystem and one application replacing the entire Qualcomm / Quectel stack. Some functions are 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:

  • AT+ADBON / AT+ADBOFF: Enable or disable ADB at runtime (this will reset USB for a second)
  • AT+RESETUSB: Stop and start USB on the modem
  • AT+QFASTBOOT: Jump to fastboot mode
  • AT+REBOOT_REC: Jump to recovery mode
  • AT+PWRDN: Shut down the modem
  • AT+EN_PCM8K: (default) Set sampling rate to 8KHz
  • AT+EN_PCM16K: Set sampling rate to 16KHz
  • AT+EN_PCM48K: Set sampling rate to 48KHz
  • AT+EN_USBAUDIO: Enable USB audio function in the gadget driver
  • AT+DIS_USBAUDIO: Disable it

Pending tasks:

1. Find fixes to support dynamic rate settings in the Pinephone
2. Finish and tidy up the AT command handling stuff
3. Implement (or try to) Quectel's LPM notifications to smd8/DATA3 (currently testing) so it stops "speaking" while USB is suspended

Documentation

I'm really bad at documentation, but you have some docs here, thanks @Zapeth for your help!