- 1 Contributors
- 2 Maintainer(s)
- 3 Note on device codenames and compatibility
- 4 What works
- 5 What does not work
- 6 How to enter flash mode
- 7 Installation
- 8 Serial Debugging
- 9 Known Issues
- 10 To Do List
- 11 See also
Note on device codenames and compatibility
The sailfish variant of the Google Pixel shares the same kernel builds as the Pixel XL (marlin). Therefore, anything here referencing sailfish should also be relevant to marlin.
- Kernel compilation
- Booting kernel (serial only)
What does not work
- SSH over USB
- Bluetooth (might actually work!)
N.B: The Pixel/Pixel XL are slightly different in format to a typical Android ecosystem. They are given two partition slots, dubbed slot A & B. Out-of-the-box Android installations also enable filesystem encryption by default. However, this is a non-issue for pmOS, since TWRP can reformat the partition layout to drop FDE for testing.
Default Partition Layout
~#: fdisk -l /dev/block/sda bootlocker_a bootlocker_b keymaster_a keymaster_b tz_a tz_b rpm_a rpm_b pmic_a pmic_b hyp_a hyp_b cmnlib32_a cmnlib32_b cmnlib64_a cmnlib64_b aboot_a aboot_b hosd_a hosd_b devcfg_a devcfg_b modem_a modem_b msadp_a msadp_b apdp_a apdp_b vendor_a vendor_b system_a system_b userdata reserve0
How to enter flash mode
It is required that the device is cell carrier unlocked before attempting to perform an OEM unlock using fastboot.
- Enter fastboot by shutting down the device, and hold volume down + power until you see the fastboot screen.
- Depending on the phone's previous sleep state, you may be alerted that a RAM dump is in progress. Ignore these, keep holding the buttons until you end up in fastboot.
Once cell unlocked, you must OEM unlock from fastboot through the standard command:
#fastboot oem unlock
Be sure that you are using fastboot slot A. If you need to change slots, perform:
#fastboot set_active a #fastboot reboot bootloader
At this point, you should be ready to test pmOS deployments.
More details to this section are coming soon.
Backup with TWRP
Take precaution, and keep backups if this is your primary device.
- Download the latest TWRP (both img and zip)
- From the TWRP directory, run the fastboot command:
#fastboot boot <your-twrp.img>
- At this point, TWRP will load
- Take your backup, note this does not include the user data directory. You need to copy that over with MTP as well.
#fastboot set_active a #fastboot reboot bootloader #pmbootstrap flasher flash_rootfs #pmbootstrap flasher flash_kernel #fastboot reboot
It is possible to debug the Pixel/Pixel XL with a standard Nexus Serial debug cable. This must be enabled in fastboot first:
#fastboot oem uart enable
The baud rate is 115200.
This is something added specific to Android, which skips the initramfs loading - something that shouldn't happen on pmOS.
A patch exists which strips the offending commit. However, a more comprehensive patch might be worth investing time into - since this does not remove the extra cmdline parameters.
Without the patch, you'll encounter:
[ 14.025620] No filesystem could mount root, tried: ext3 ext2 ext4 vfat msdos fuseblk [ 14.033436] c2 1 Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(253,0)
Firmware images not available
Need to include the proprietary vendor drivers.
[TP]: [ERR]:fwu_start_reflash: Firmware image synaptics_bl71.img not available
To Do List
- [ojbr] - Fix kernel panic on boot (skip_initramfs)
- [ojbr] - Serial debugging is possible with the kernel builds available on my mirror repository
- [ojbr] - Re-enable LZMA kernel image compression, add via makedepends
- [ojbr] - Test device flashing using fastboot
- Investigate boot process; attempt to get SSH over USB
- Investigate missing driver binaries
- Investigate Kernel upgrade path to 4.X where MSM8996 has better support in mainline