Skip to content

Latest commit

 

History

History
79 lines (67 loc) · 4.46 KB

README.md

File metadata and controls

79 lines (67 loc) · 4.46 KB
Raw

Pinephone Modem SDK

Custom firmware for your Pinephone's modem

Dependencies

This project depends on the following repositories:

Make sure you have your recoveries ready just in case:

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!