This repository contains all the tools you need use to make your own Modem userspace for your Pinephone.
Latest release: Version 0.4.2
- Rolling your own? Check the Howto
- Want to flash it? Here's a guide!
- Going back to stock? There's a Howto too!
- Having issues? Check out if the issue is already documented or create a new one
- There's also a Matrix room now!
-
LK Bootloader: Working
- On reset, the bootloader enters into fastboot mode automatically for 2 seconds, and boots normally unless instructed to stay (leave the command
fastboot oem stayrunning while rebooting the modem to 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
- On reset, the bootloader enters into fastboot mode automatically for 2 seconds, and boots normally unless instructed to stay (leave the command
-
CAF Kernel: Working
-
Audio: Working, needs fine tunning (1-5 seconds of silence on call start)
-
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='AIF2 DAC Playback Volume' 90%"*cset "name='AIF2 ADC Capture Volume' 90%"* A reboot is required after changing this configuration file. * Feel free to play around with the values, default value is '160' for both items (without '%' sign). Mine sounds loud enough at both extremes with 90% and 80% respectively -
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 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: Please see this document
- Non persistent storage: There's no way of corrupting your modem firmware from a bad shutdown
- 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
- Find and fix the last remaining USB port reset cause
- Find fixes to support dynamic rate settings in the Pinephone
- Finish and tidy up the AT command handling stuff
- Allow bootloader PIN lock to prevent accidental flashing
- Implement opensource ACDB loader?
- Fix fastboot reboot to EDL if possible
- Companion app to update the firmware / manage modem settings / retrieve logs
Contribution is always welcome! Feel free to share any issue or something that you think may be interesting to have!
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:
I'm really bad at documentation, but you have some docs here, thanks @Zapeth for your help!