OnePlus 6 (oneplus-enchilada)
This page is about the dedicated port of this device. There is also an optional generic port available for this device - see Qualcomm SDM845 (qualcomm-sdm845). |
Running Phosh | |
Manufacturer | OnePlus |
---|---|
Name | 6 |
Codename | oneplus-enchilada |
Model | ONEPLUS A600x |
Released | 2018 |
Type | handset |
Hardware | |
Chipset | Qualcomm Snapdragon 845 (SDM845) |
CPU | Octa-core (4x 2.8 GHz Kryo 385 Gold & 4x 1.7 GHz Kryo 385 Silver) |
GPU | Adreno 630 |
Display | 1080 x 2280 AMOLED |
Storage | 64/128/256 GB |
Memory | 6/8 GB |
Architecture | aarch64 |
Software | |
Original software | Android (OxygenOS/HydrogenOS) |
Original version | 8.0 |
Extended version | 11 on Linux 4.9 (OxygenOS 11.1.2.2) |
FOSS bootloader | no |
postmarketOS | |
Category | community |
Pre-built images | yes |
postmarketOS kernel | Mainline |
Unixbench Whet/Dhry score | 6029.9 |
Optional Generic Port | Qualcomm SDM845 (qualcomm-sdm845) |
Flashing |
Works |
---|---|
USB Networking |
Works |
Internal storage |
Works |
SD card | |
Battery |
Works |
Screen |
Works |
Touchscreen |
Works |
Multimedia | |
3D Acceleration |
Works |
Audio |
Works |
Camera |
Broken |
Camera Flash |
Works |
Connectivity | |
WiFi |
Works |
Bluetooth |
Works |
GPS |
Partial |
NFC |
Partial |
Modem | |
Calls |
Partial |
SMS |
Works |
Mobile data |
Works |
Miscellaneous | |
FDE |
Works |
USB OTG |
Partial |
Sensors | |
Accelerometer |
Works |
Magnetometer |
Works |
Ambient Light |
Works |
Proximity |
Works |
Hall Effect |
Broken |
Haptics |
Works |
Barometer | |
This device is based on the Snapdragon 845. See the SoC page for common tips, guides and troubleshooting steps |
The OnePlus 6 is an incredibly powerful and efficient mobile device, well regarded and (bar the notch) an excellent portable work horse, getting mainline Linux working means not only freedom from proprietary software, but also continual security patches and the ability to boot any mobile or desktop Linux distro.
After the OnePlus 6 reached End-of-Life by OnePlus in December 2021, running newer Linux kernel versions is the only way to ensure that the device can continue to be safe and usable for years to come. The Snapdragon 845 is still an incredibly capable SoC, likewise the OnePlus 6 is a well-built and perfectly adequate device. That the millions of sold units have been dropped, destined for Landfill (or at best recycling) by OnePlus is abhorrant, join us in doing our best to continue to make devices like the OnePlus 6 safe and usable.
The phone is currently capable of booting modern Linux with only a few patches, check the table on the right (or above on mobile) for the hardware support checklist.
Despite being able to run an up to date kernel, we are still dependant on the now aging firmware for features like the bootloader, modem, wifi and bluetooth to function. While it is relatively unlikely that a vulnerability is discovered in this firmware, it is absolutely a possibility. Until OnePlus releases the signing keys used to sign new versions of the firmware – allowing us to potentially make use of future security patches – we're stuck with what we've got.
How to enter flash mode
Unplug from USB and hold Power and Volume Up until you see a screen showing the word START
and information about the device.
For the OnePlus 6T, hold Power and both volume buttons.
If you're struggling to enter fastboot, ensure that you have unplugged the USB cable and do not release the button combination until after the START text appears on screen |
Installing
The bootloader is the only firmware that postmarketOS doesn't install itself, all other firmware (devicetree, GPU, modem etc.) is supplied by postmarketOS. In contrast to custom Android ROMs, it is incredibly unlikely that any bugs or issues you encounter are caused by whatever OS you previously had installed on the device. |
Prerequisites
To install prebuilt images, you will need:
1. A computer with fastboot
This can be obtained by installing the android-tools
package on Linux or by installing the Android SDK Platform-Tools on Windows, Mac (or Linux).
Upgrade
Before installing postmarketOS, it's recommended that you upgrade your device to the latest release of OxygenOS (OnePlus's version of Android) on both slots. This is not a requirement but is heavily recommended to get GPS working. Try this first if you encounter issues with fastboot.
If you have a very old version of OxygenOS (for example after using the "MSM Download tool" for android 10), you probably need to update twice, because the device uses A/B partitioning (read this page if you're not sure what that means). First do a normal update, then find the latest version of OxygenOS OTA signed zip, upload it to the phone, go to the updater in the settings and do a local update of the latest version again (source). OnePlus' support/softwareupgrade page seems to be inaccessible at this moment, so look at this XDA thread for 6 and this one for 6T |
Unlock the bootloader
Before installing postmarketOS you have to unlock your bootloader. For the T-Mobile version of the device in the US, refer to Google for guides on obtaining an unlock code. If your device is not carrier locked, the following is all that's needed to unlock the bootloader:
1. Open Settings, go to "About" and tap on the "Build number" box ~10 times until the "You are now a developer" toast message appears.
2. Go back to the main settings page, go to "System" and then "Developer options" (it might be hidden behind a dropdown menu). Toggle the switch to "Enable OEM unlocking"
3. Refer to "How to enter flash mode" above to get into fastboot mode, then re-attach your USB cable. Run the following command on your host:
fastboot oem unlock
If you see < waiting for any device >
, try running as sudo
and restart your device into fastboot mode again by selecting "Restart Bootloader" on the device.
4. Read the message displayed on your device screen. Once read, confirm the unlock if you're willing to proceed. THIS WILL ERASE YOUR DEVICE'S INTERNAL STORAGE.
All done! You can now continue with this guide.
Pre-built images
Follow the installation article to download image files, note that the device code-names are oneplus-enchilada
for the OnePlus 6 and oneplus-fajita
for the 6T.
Once downloaded, decompress the files with unxz
. On Windows you can use a tool like 7zip.
Finally, use fastboot to flash:
Erasing the dtbo partition will make Android (and ALL Android-based software like Ubuntu Touch or TWRP recovery) unbootable on the current slot (read this page if you're not sure what that means). You can re-flash an Android ROM via fastboot by extracting the payload.bin from the OTA zip and using a tool like android-ota-payload-extractor to get the individual partition images. It is almost never necessary to resort to extreme measures like "MSM Download tool" to reflash the device via EDL. |
If you are using Arch Linux and getting errors like std::out_of_range . Uninstall android-tools and install android-sdk-platform-tools from the AUR[1][2] or build and flash your own build with pmbootstrap |
fastboot erase dtbo fastboot flash boot [the file that ends in -boot.img] fastboot flash userdata [the other file]
If you see < waiting for any device >
, try running as sudo
and restart your device into fastboot mode again.
It can be effective to run fastboot reboot
after each command succeeds, to avoid above "waiting for device" connection problem.
WARNING: Do not reboot via the power button on the device! This can result in not all data being properly written to storage, corrupting the rootfs and resulting strange behaviour like postmarketOS getting stuck during boot! |
Always use fastboot reboot after flashing. |
Manual build
The vendor is OnePlus, the codename is "enchilada" for the OnePlus 6 and "fajita" for the OnePlus 6T.
Follow the pmbootstrap article, until you have done the install action.
With FDE (it stands for Full Disk Encryption)
pmbootstrap install --split --fde pmbootstrap export
Without
pmbootstrap install
Reboot back into flash mode as explained above. (If you encounter weird behaviour like the command getting stuck before the flashing starts, reboot into flash mode or select "Restart Bootloader" on the phone itself)
Without FDE by default, the rootfs will be flashed to the system partition. This doesn't leave much free space for your applications / data, so if you don't mind factory resetting the device you can instead flash to the userdata partition by specifying the partition like below.
WARNING: Do not reboot using the power button on the device! This can result in not all data being properly written to storage, corrupting the rootfs and resulting in strange behaviour like postmarketOS getting stuck during boot! |
Always use fastboot reboot after flashing. |
With FDE
By booting twrp from bootloader/fastboot mode you can do the partitioning.
If you install pmOS only to the slot b you can install twrp as recovery.
After partitioning you will need to format userdata in twrp.
You can install to both slots if you prefer.
In twrp (Android 11 version ie. 3.7.0) in Advanced->Terminal
you can use sgdisk
, it has long flags only e.g. --print
and not -p
.
Or you can use adb shell
(when booted into twrp) to run these commands from your computer.
#Get userdata number and info on the disk sgdisk /dev/block/sda --print #Delete userdata partition to remake it smaller sgdisk /dev/block/sda --delete=17 #Make userdata 2 gigabytes, minimum size unknown sgdisk /dev/block/sda --new=0:0:+2G --change-name=0:userdata #Make pmOS boot partition 256 megabytes (default size) sgdisk /dev/block/sda --new=0:0:+256M --change-name=0:pmOS_boot #Make pmOS system partition uses the rest of the disk sgdisk /dev/block/sda --new=0:0:0 --change-name=0:pmOS_root
#Both slots fastboot erase dtbo fastboot flash pmOS_boot /tmp/postmarketOS-export/oneplus-enchilada-boot.img fastboot flash pmOS_root /tmp/postmarketOS-export/oneplus-enchilada-root.img fastboot flash boot /tmp/postmarketOS-export/boot.img fastboot reboot #Slot b only fastboot erase dtbo_b fastboot flash pmOS_boot /tmp/postmarketOS-export/oneplus-enchilada-boot.img fastboot flash pmOS_root /tmp/postmarketOS-export/oneplus-enchilada-root.img fastboot flash boot_b /tmp/postmarketOS-export/boot.img fastboot set_active b fastboot reboot
Without FDE
fastboot erase dtbo pmbootstrap flasher flash_rootfs --partition userdata pmbootstrap flasher flash_kernel pmbootstrap chroot fastboot reboot
If you have flashing or booting issues, try flashing the latest version of OxygenOS to the slot you want to install postmarketOS to (i.e., flash the ROM using TWRP from your other slot). If you still have no luck, try flashing OxygenOS 9, as the bootloader can be more forgiving.
Dual booting
(See OnePlus_6_(oneplus-enchilada)/Dual_Booting_and_Custom_Partitioning)
Fastboot bugs
If you encounter "weird" errors from fastboot, such as "device does not support slots":
Once the device is in fastboot mode, unplug it, run your fastboot / flasher command and wait for the "<waiting for device>" message, then choose the "reboot bootloader" option on the device, press the power button to select that option and plug in the device while it reboots.
Upgrading
Upgrading can be done through Alpine's package manager "apk", to upgrade everything simply open a terminal and run sudo apk upgrade -a
. This includes kernel upgrades.
Building
Feel like helping? Want to learn kernel development?
Check out the mainlining guide SDM845 Mainlining for detailed SDM845 specific instructions on initial device porting and building.
Feel free to contact @caleb (or anyone) in the #postmarketos-mainline matrix channel if you're stuck.
See this quick and dirty tutorial on how to build the kernel.
Info
Hacking
See Hacking for details.
Partition map
oneplus-enchilada:~$ ls -lah /dev/disk/by-partlabel/
total 0 drwxr-xr-x 2 root root 2.0K Jan 7 1970 . drwxr-xr-x 8 root root 160 Jan 7 1970 .. lrwxrwxrwx 1 root root 10 Jan 7 1970 ALIGN_TO_128K_1 -> ../../sdd1 lrwxrwxrwx 1 root root 10 Jan 7 1970 ALIGN_TO_128K_2 -> ../../sdf1 lrwxrwxrwx 1 root root 11 Jan 7 1970 ImageFv -> ../../sde72 lrwxrwxrwx 1 root root 11 Jan 7 1970 LOGO_a -> ../../sde20 lrwxrwxrwx 1 root root 11 Jan 7 1970 LOGO_b -> ../../sde48 lrwxrwxrwx 1 root root 10 Jan 7 1970 abl_a -> ../../sde8 lrwxrwxrwx 1 root root 11 Jan 7 1970 abl_b -> ../../sde36 lrwxrwxrwx 1 root root 10 Jan 7 1970 aop_a -> ../../sde1 lrwxrwxrwx 1 root root 11 Jan 7 1970 aop_b -> ../../sde29 lrwxrwxrwx 1 root root 11 Jan 7 1970 apdp -> ../../sde63 lrwxrwxrwx 1 root root 10 Jan 7 1970 bluetooth_a -> ../../sde5 lrwxrwxrwx 1 root root 11 Jan 7 1970 bluetooth_b -> ../../sde33 lrwxrwxrwx 1 root root 11 Jan 7 1970 boot_a -> ../../sde11 lrwxrwxrwx 1 root root 11 Jan 7 1970 boot_aging -> ../../sde58 lrwxrwxrwx 1 root root 11 Jan 7 1970 boot_b -> ../../sde39 lrwxrwxrwx 1 root root 10 Jan 7 1970 cdt -> ../../sdd2 lrwxrwxrwx 1 root root 11 Jan 7 1970 cmnlib64_a -> ../../sde13 lrwxrwxrwx 1 root root 11 Jan 7 1970 cmnlib64_b -> ../../sde41 lrwxrwxrwx 1 root root 11 Jan 7 1970 cmnlib_a -> ../../sde12 lrwxrwxrwx 1 root root 11 Jan 7 1970 cmnlib_b -> ../../sde40 lrwxrwxrwx 1 root root 11 Jan 7 1970 config -> ../../sda12 lrwxrwxrwx 1 root root 10 Jan 7 1970 ddr -> ../../sdd3 lrwxrwxrwx 1 root root 11 Jan 7 1970 devcfg_a -> ../../sde14 lrwxrwxrwx 1 root root 11 Jan 7 1970 devcfg_b -> ../../sde42 lrwxrwxrwx 1 root root 11 Jan 7 1970 devinfo -> ../../sde61 lrwxrwxrwx 1 root root 11 Jan 7 1970 dip -> ../../sde62 lrwxrwxrwx 1 root root 10 Jan 7 1970 dsp_a -> ../../sde9 lrwxrwxrwx 1 root root 11 Jan 7 1970 dsp_b -> ../../sde37 lrwxrwxrwx 1 root root 11 Jan 7 1970 dtbo_a -> ../../sde18 lrwxrwxrwx 1 root root 11 Jan 7 1970 dtbo_b -> ../../sde46 lrwxrwxrwx 1 root root 10 Jan 7 1970 frp -> ../../sda6 lrwxrwxrwx 1 root root 10 Jan 7 1970 fsc -> ../../sdf5 lrwxrwxrwx 1 root root 10 Jan 7 1970 fsg -> ../../sdf4 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_4j1ed_a -> ../../sde21 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_4j1ed_b -> ../../sde49 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_4u1ea_a -> ../../sde22 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_4u1ea_b -> ../../sde50 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs3_a -> ../../sde23 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs3_b -> ../../sde51 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs4_a -> ../../sde24 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs4_b -> ../../sde52 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs5_a -> ../../sde25 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs5_b -> ../../sde53 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs6_a -> ../../sde26 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs6_b -> ../../sde54 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs7_a -> ../../sde27 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs7_b -> ../../sde55 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs8_a -> ../../sde28 lrwxrwxrwx 1 root root 11 Jan 7 1970 fw_ufs8_b -> ../../sde56 lrwxrwxrwx 1 root root 10 Jan 7 1970 hyp_a -> ../../sde3 lrwxrwxrwx 1 root root 11 Jan 7 1970 hyp_b -> ../../sde31 lrwxrwxrwx 1 root root 11 Jan 7 1970 keymaster_a -> ../../sde10 lrwxrwxrwx 1 root root 11 Jan 7 1970 keymaster_b -> ../../sde38 lrwxrwxrwx 1 root root 10 Jan 7 1970 keystore -> ../../sda5 lrwxrwxrwx 1 root root 11 Jan 7 1970 limits -> ../../sde67 lrwxrwxrwx 1 root root 11 Jan 7 1970 logdump -> ../../sde71 lrwxrwxrwx 1 root root 11 Jan 7 1970 logfs -> ../../sde69 lrwxrwxrwx 1 root root 10 Jan 7 1970 mdtp_a -> ../../sde7 lrwxrwxrwx 1 root root 11 Jan 7 1970 mdtp_b -> ../../sde35 lrwxrwxrwx 1 root root 10 Jan 7 1970 mdtpsecapp_a -> ../../sde6 lrwxrwxrwx 1 root root 11 Jan 7 1970 mdtpsecapp_b -> ../../sde34 lrwxrwxrwx 1 root root 11 Jan 7 1970 minidump -> ../../sde57 lrwxrwxrwx 1 root root 10 Jan 7 1970 misc -> ../../sda3 lrwxrwxrwx 1 root root 10 Jan 7 1970 modem_a -> ../../sde4 lrwxrwxrwx 1 root root 11 Jan 7 1970 modem_b -> ../../sde32 lrwxrwxrwx 1 root root 10 Jan 7 1970 modemst1 -> ../../sdf2 lrwxrwxrwx 1 root root 10 Jan 7 1970 modemst2 -> ../../sdf3 lrwxrwxrwx 1 root root 11 Jan 7 1970 msadp -> ../../sde64 lrwxrwxrwx 1 root root 11 Jan 7 1970 odm_a -> ../../sda15 lrwxrwxrwx 1 root root 11 Jan 7 1970 odm_b -> ../../sda16 lrwxrwxrwx 1 root root 10 Jan 7 1970 oem_dycnvbk -> ../../sda8 lrwxrwxrwx 1 root root 10 Jan 7 1970 oem_stanvbk -> ../../sda9 lrwxrwxrwx 1 root root 11 Jan 7 1970 op1 -> ../../sde59 lrwxrwxrwx 1 root root 10 Jan 7 1970 op2 -> ../../sda7 lrwxrwxrwx 1 root root 10 Jan 7 1970 param -> ../../sda4 lrwxrwxrwx 1 root root 10 Jan 7 1970 persist -> ../../sda2 lrwxrwxrwx 1 root root 11 Jan 7 1970 qupfw_a -> ../../sde15 lrwxrwxrwx 1 root root 11 Jan 7 1970 qupfw_b -> ../../sde43 lrwxrwxrwx 1 root root 11 Jan 7 1970 reserve1 -> ../../sda10 lrwxrwxrwx 1 root root 11 Jan 7 1970 reserve2 -> ../../sda11 lrwxrwxrwx 1 root root 11 Jan 7 1970 sec -> ../../sde60 lrwxrwxrwx 1 root root 11 Jan 7 1970 splash -> ../../sde66 lrwxrwxrwx 1 root root 11 Jan 7 1970 spunvm -> ../../sde65 lrwxrwxrwx 1 root root 10 Jan 7 1970 ssd -> ../../sda1 lrwxrwxrwx 1 root root 11 Jan 7 1970 sti -> ../../sde70 lrwxrwxrwx 1 root root 11 Jan 7 1970 storsec_a -> ../../sde19 lrwxrwxrwx 1 root root 11 Jan 7 1970 storsec_b -> ../../sde47 lrwxrwxrwx 1 root root 11 Jan 7 1970 system_a -> ../../sda13 lrwxrwxrwx 1 root root 11 Jan 7 1970 system_b -> ../../sda14 lrwxrwxrwx 1 root root 11 Jan 7 1970 toolsfv -> ../../sde68 lrwxrwxrwx 1 root root 10 Jan 7 1970 tz_a -> ../../sde2 lrwxrwxrwx 1 root root 11 Jan 7 1970 tz_b -> ../../sde30 lrwxrwxrwx 1 root root 11 Jan 7 1970 userdata -> ../../sda17 lrwxrwxrwx 1 root root 11 Jan 7 1970 vbmeta_a -> ../../sde17 lrwxrwxrwx 1 root root 11 Jan 7 1970 vbmeta_b -> ../../sde45 lrwxrwxrwx 1 root root 11 Jan 7 1970 vendor_a -> ../../sde16 lrwxrwxrwx 1 root root 11 Jan 7 1970 vendor_b -> ../../sde44 lrwxrwxrwx 1 root root 10 Jan 7 1970 xbl_a -> ../../sdb1 lrwxrwxrwx 1 root root 10 Jan 7 1970 xbl_b -> ../../sdc1 lrwxrwxrwx 1 root root 10 Jan 7 1970 xbl_config_a -> ../../sdb2 lrwxrwxrwx 1 root root 10 Jan 7 1970 xbl_config_b -> ../../sdc2
Camera Flash
Two leds (yellow and white), both functionnal, at the back of the phone.
Their max brightness value is 255.
A simple extension for Gnome mobile adds a button to the activities overview : https://gitlab.com/NekoCWD/nekotorch
See LEDs for more details.
Upgrading firmware without Android installed
When you install postmarketOS and all you get is just blank screen after a reboot or you have some other problems it is possible that firmware was not upgraded. Follow these steps to upgrade firmware.
- Download newest firmware from here
- Extract payload.bin file from zip you downloaded in a previous step
- Extract firmware with payload-dumper-go or payload_dumper
- Run command:
payload-dumper-go payload.bin
- Enter fastboot mode
- Unlock partitions for flashing
fastboot flashing unlock_critical
- Run below commands to update firmware
fastboot flash abl abl.img fastboot flash aop aop.img fastboot flash bluetooth bluetooth.img fastboot flash cmnlib cmnlib.img fastboot flash cmnlib64 cmnlib64.img fastboot flash devcfg devcfg.img fastboot flash dsp dsp.img fastboot flash fw_4j1ed fw_4j1ed.img fastboot flash fw_4u1ea fw_4u1ea.img fastboot flash hyp hyp.img fastboot flash keymaster keymaster.img fastboot flash LOGO LOGO.img fastboot flash --slot=all modem modem.img fastboot flash oem_stanvbk oem_stanvbk.img fastboot flash qupfw qupfw.img fastboot flash storsec storsec.img fastboot flash tz tz.img fastboot flash xbl xbl.img fastboot flash xbl_config xbl_config.img
- If you are not able to write via fastboot, even after
unlock_critical
use edl mode instead (turn off phone, push volume +/- and plugin the usb cable):
edl w abl_a abl.img
and so on with all the mentioned files.
The big list of issues
In no particular order...
Audio in calls
There are issues with audio disappearing in calls.
Tri-state key support
First support was in userspace: https://github.com/michele-perrone/postmarketos-oneplus6-tristatekey
A kernel device driver for the tri-state key has now been developed, and it emits EV_SW with codes 17/18/19 for the top/middle/bottom states.
It has been suggested that the kernel driver is converted to using the ABS_MISC codes rather than introduce more "generic" input events.
The next step is to write hkdm configs for it but this may need to wait for the driver to get upstreamed. hkdm itself needs support for EV_SW devices added.
OTG doesn't work
"OTG" (USB-C role switching to host mode) is blocked on USB-C power delivery support in the charger driver. Host mode can be forced by modifying the DTS when building a kernel, but it isn't clear what this fixes or may break.
See this matrix post by User:Caleb:
no, OTG isn't really a thing anymore anyway - it's technically specific to micro USB, usb-c has role-switching where a device can either be a host device or a peripheral device. Right now we force peripheral mode always. Once support for the full USB-C power delivery system is implemented in the charger driver, we can negotiate a role with the other device, e.g. if it's a powered dock we want to charge but also be the host device.
Once that's done we can implement DP alt mode on top which requires talking to the dwc3 driver I think, and configuring some external orientation switch for the USB SBU pins which are directional and required by displayport
that's all the missing pieces, that will give us displayport on the SHIFT6mq, neither the Pocophone F1 nor OnePlus 6 support DP alt mode
The phone won't supply its own power, so you need either a powered hub or an extension cable wired up to 5v. Some hubs may refuse to work without power being supplied from the port however. |
Host mode can be enabled by Dts method and Sysfs method.
Dts method
Install dtc and decompile the appropriate file for you device like so:
# apk add dtc # cd /boot/dtbs/qcom # dtc sdm845-oneplus-<model>.dtb -o temp.dts
Now edit the temp.dts file and change dr_mode from "peripheral" to "host", recompile it and run mkinitfs to regenerate and flash the boot image:
# dtc temp.dts -o sdm845-oneplus-<model>.dtb # mkinitfs # reboot
To revert the changes just do the same thing again but change the line back to peripheral, kernel updates will also revert it.
Sysfs method
Change "device" to "host" in "/sys/kernel/debug/usb/a600000.usb/mode" :
# echo host | sudo tee /sys/kernel/debug/usb/a600000.usb/mode
To revert the changes just do the same thing again but change host to device or reboot the device.
Verify
Run the command as below to verify:
# sudo cat /sys/kernel/debug/usb/a600000.usb/mode
If the command return host
then congratulation you have enabled the host mode successfully.
GPS
WARNING: To use and test GPS functions, make sure a SIM card is inserted (mmcli v1.22.x), GPS is enabled in mmcli, geoclue is executed. Then disable suspend, go outside for 15min. until you get a fix |
Carefully read Troubleshooting:GPS for more details on how to activate the GPS using ModemManager's CLI and enabeling Geoclue.
As discovered in this comment thread: if you want GPS to work, you may need to flash OxygenOS in a specific version, before flashing postmarketOS; 9.0.8 for OP6, 9.0.16 for OP6T. Its recommended to flash it to both slots (ie. use copy-partitions from LineageOS) although it is not proved that it is necessary.
Camera
It is possible to make it work since libcamera has everything in place and pre-installed on the OP6 images for basic support (like on Poco f1) once the required kernel bits for the IMX519 driver are upstreamed, see this patch as an example and see this branch where we are stuck.
The driver source is available here see also this.
Help and discussion can be found in sdm845-mainline!21 or on the matrix channel.
Listen pmOS podcast #34 for information (Sep 28 2023).
Wifi
Wifi works out of the box.
Wifi monitor mode works, but requires reloading the driver with frame_mode=0
and enabling raw mode in firmware-5.bin
.
The commands to do this can be found here: [1]. Packet injection however does not work.
When creating a hotspot you might encounter the issue that you are not be able to connect to it. In this case, create it from command line with wifi-sec.pmf
disabled:
nmcli dev wifi hotspot ifname wlan0 ssid hotspotname password "password" nmcli c modify Hotspot 802-11-wireless-security.pmf 1 nmcli connection modify Hotspot wifi-sec.pmf disable
Sensors
Initial sensor support was added in pmaports!4050. Which works nice but constantly sucks 1-2% of CPU. To fix this we need your help.
NFC
As written here, NFC is working on OP6/OP6T devices.
sudo apk add dtc cd /boot/dtbs/qcom sudo dtc sdm845-oneplus-enchilada.dtb -o sdm845-oneplus-enchilada.dts patch < NFC.patch sudo dtc sdm845-oneplus-enchilada.dts -o sdm845-oneplus-enchilada.dtb sudo reboot
get NFC.patch here.
More info by contacting User:Biemster or opening an issue in the repo
We just miss an userspace application and the libnfc-nci as Alpine package.
TrustZone
Drivers to communicate with the QSEE (Qualcomm Secure Execution Environment) are not on mainline and you can't flash OP-TEE because XBL_SEC checks the signature. Those drivers are called QSEECOM in the CAF kernel but there is the need to standardize them using the generic interface defined in include/uapi/linux/tee.h
. You can use the OP-TEE implementation as an example. More documentation here https://www.kernel.org/doc/html/latest/tee/op-tee.html.
Having a TrustZone is useful to do a lot of things related to security, but mainly fingerprint management, secure encryption involved in NFC, useful to emulate contactless smart cards, and Widevine L1 to watch premium streaming services with the best resolution!
Regarding DRMs and userland, on Waydroid or Android mainline you need to develop oemcrypto.so
with the support of the standard API for the TEE; manufacturers implement it with their custom interfaces. Look at this https://source.android.com/devices/drm#drm-plugins.
On GNU/Linux, you need to implement/enable Widevine L1 on players. For example on Firefox, if you want to watch Netflix or other in-browser streaming services, but you might also want to use an extension like https://github.com/lkmvip/netflix-4K-DDplus to spoof the device and so make Netflix give you the encrypted stream. Another good implementation opportunity is on FFMPEG/VLC, it would be cool to make VLC able to stream Netflix and also having the possibility to save decrypted streams.
Battery/Power
While battery and charging are working, we sometimes get inaccurate power percentage values reported.
Charging on variable powersources like solarpanel/dynamo does not work as expected.
Fastboot flashing issues
The fastboot implementation leaves some to be desired... If you encounter issues flashing with fastboot getting stuck or displaying weird errors like device does not support slots
, prepare the fastboot flash command in your terminal, on the device choose the "reboot bootloader" option from fastboot, press the power button to confirm and then run the command while the device reboots.
You'll see a "waiting for device" message in your terminal, the flashing should start as soon as the device gets back into fastboot mode.
Modem bugs
The recent enablement of ModemManager enables SMS and mobile data to work on supported SDM845 devices including the OnePlus 6 and 6T. It isn't possible to test these extensively due to the number of region specific and carrier specific issues that could arise.
If you're encountering modem issues, perform the following steps to collect logs and submit them so that I or someone else can review:
On your device with SIM card inserted:
sudo service modemmanager stop sudo service msm-modem-uim-selection restart sudo ModemManager --debug 2>&1 | tee mm.log
If your device requires SIM unlocking, perform that in Phosh settings, wait for a few seconds and then stop modemmanager again.
Create a new issue in ModemManager here to explain your issue, include a link to a pastebin containing the logs you captured (they're in mm.log in your home directory on device). At the bottom of your issue add Cc: @calebccff
so that I'll be notified.
Please also include the output of uname -a
and sudo qmicli -d qrtr://0 --uim-get-card-status
in your issue.
Sim not appearing
Some SIM cards or modem firmwares might take longer to initialize. If the SIM card does not appear, but sudo qmicli -d qrtr://0 --uim-get-card-status
shows that the card is present (Card state: 'present'
), one possible solution is to increase the wait time for the SIM card to appear after starting the modem. Edit the file: /etc/conf.d/msm-modem-uim-selection
and change: sim_wait_time=1
to sim_wait_time=30
and reboot.
Dual Sim
Some users have reported issues with dual SIM causing modemmanager issues, whilst modemmanager should automatically select the first SIM, it lacks proper dual SIM support and sometimes can get confused. Currently the best workaround is to make sure you only have one SIM card inserted.
Countries Where Device Fails To Connect To Mobile Network
Australia - Since 3G closure this device is rejected due to SOS calls needing 3G network. See this forum for possible workarounds depending on the model of OnePlus 6: https://forums.whirlpool.net.au/archive/9m01z7np
Also see this issue tracker for VoLTE progress: https://gitlab.postmarketos.org/postmarketOS/pmaports/-/issues/1878
Renegade Project
Has support in main tree, can boot PostmarketOS.
See also OnePlus 6 (oneplus-enchilada)/Dual Booting and Custom Partitioning#Dual booting pmos with other uefi based os (like openbsd , netbsd , freebsd,windows,etc) via Renegade Project and Oneplus 6/6T Renegade Project Page
Community Info
postmarketOS users that own the device
- Aa13q
- Aleksander (Notes: WWAN stack tinkering)
- Antonok
- AppleCross (Notes: PostmarketOS Gnome)
- BenTheTechGuy (Notes: On loan)
- Blacklight
- BotchedRPR (Notes: dead (crashdump mode))
- Breakfastisready (Notes: 128GB)
- CalcProgrammer1
- Caleb (Notes: 256GB postmarketOS daily driver)
- Caleb (Notes: 3rd party touch screen to be fixed)
- Caleb (Notes: lab rat)
- Chainbits (Notes: daily driver, available for testing)
- Chayleaf (Notes: 8/128; runs NixOS)
- Craftyguy
- DanSman (Notes: pmOS (v24.12 + FDE) UI: plasma-mobile)
- Deathmist (Notes: 8/128 GB model)
- DevelLevel
- DrGit (Notes: 256GB)
- DylanVanAssche (Notes: LineageOS)
- E-v (Notes: [available for testing] 128 GB, dual boot with DivestOS, userdata partition split in two)
- Earboxer (Notes: formerly sxmo-sway on pmOS edge. current daily driver(2023). Still using pulseaudio, custom alsa UCM to fix thing. using Hyprland)
- Elagost (Notes: family device running Android, can't wipe)
- Emacsevangelist (Notes: Runs pmOS with a custom EXWM-based UI)
- EnderNightLord
- EspiDev (Notes: 8/128 GB Plasma Mobile)
- Frankwalter (Notes: [6GB/128GB] I bought it to experiment with Linux mobile, so I can help mainlining it and learn about drivers development in the process! (fajita))
- FuchtelJockel (Notes: daily driver (DivestOS))
- Gbhdrew (Notes: About to start testing for daily use)
- Giannidunk (Notes: 128 GB)
- Hacker420 (Notes: Daily driver, dualbooted with Android and pmOS on the other slot. (8/128))
- Hastalavista (Notes: LineageOS)
- Haui2 (Notes: Running pmOS stable and phosh)
- Iramosu (Notes: 8/128GB GNOME)
- Jrg
- JuniorJPDJ
- Kbingham
- Ksqeib (Notes: Using as Minecraft Server)
- Langfingaz (Notes: Running PostmarketOS edge)
- Linmob (Notes: Kupfer with Phosh)
- Lolgzs (Notes: 128GB, PMOS daily driver)
- Memoryfile (Notes: spare phone running GNOME mobile)
- Naproxen (Notes: Daily Driver)
- NekoCWD (Notes: 6/64GB postmarketOS daily driver)
- No112 (Notes: currently non-functional with a dangerous looking battery)
- Okias (Notes: 8G/128G)
- Operachi (Notes: Android + PostmarketOS Plasma Mobile (Main PostmarketOS Phone))
- PanzerSajt
- Plata (Notes: Plasma Mobile)
- Proycon (Notes: daily driver with sxmo)
- QC8086
- Rabbit (Notes: Daily driver, GNOME mobile, 128GB)
- Retourmy (Notes: Powerfull indeed, but no VoLTE. Reinstalled "from" OOS 9.0.8 to have GPS working with all cariiers)
- Robert.mader (Notes: Development / Testing)
- Russanandres (Notes: PMOS)
- Sado1 (Notes: x4, one with screen replacement)
- SevralT (Notes: My second phone for Linux ;p)
- Some Chinese Guy (Notes: daily driver)
- StephanieBread (Notes: pmOS edge with Phosh, daily driver)
- Susurrus (Notes: Broken front camera)
- Syboxez (Notes: (128G/8G) Daily driver on one slot, kupfer on the other)
- Techwizz (Notes: My daily driver, with pmos of course!)
- ThatGeekZen (Notes: PMOS Daily Driver)
- Thenightterrorx (Notes: Now running lineageOS,pmOS used as daily driver for a while, but call audio kept breaking)
- TQMatvey (Notes: Third-party Touchscreen, dualboot linux and CrDroid)
- Usia (Notes: running e/os/)
- Usia (Notes: running PostmarketOS)
- Wann (Notes: Unlocked - Running Gnome Mobile - Main Phone)
- WhyNotHugo (Notes: Running postmarketOS. Mostly for experimentation.)
- Wjtje (Notes: Second phone for running PostmarketOS edge)
- Xanadul (Notes: 128 GB)
Maintainers
See also
Internal pages
- OnePlus 6 (oneplus-enchilada)/Hacking
- OnePlus 6 (oneplus-enchilada)/Multi Booting and Custom Partitioning
External links
- Kernel sources
- pmaports!1221 Initial merge request.
- pmaports!1271 Updates to add panel mode and WiFi support.
- pmaports!2088 Move the OnePlus 6 to "community" devices category
- pmaports!1967 Switch to common linux-postmarketos-qcom-sdm845 kernel instead of device specific kernel
- pmaports!2206 Update to 5.12.8 and add support for the speaker / headphone jack on the OnePlus 6
- pmaports!2215 Support automatic kernel updates for Android devices (including A/B!)
- Enchilada device package
- Fajita device package
- Kernel package
- postmarketOS podcast interview with Caleb about mainlining the OnePlus 6
- Recent updates concerning USB C role switching on Oneplus 6