ubports-oneplus6/documentation

Documentation on Ubports / Halium for Enchilada / Fajita

Notes and things

Read everything, on the bottom you will find installation instructions. Russian Instruction/Русская иструкция

Join our discord

https://discord.gg/haVG9Ga There are many reasons for joining it.

Port status

Component	Status	Details
AppArmor	Y
Boot into UI	Y
Camera	Y	If app crashes after taking photo try switching cameras and turning flash on, and off.
Phone Calls	Y	Only works on SIM2, you will have to move your SIM card.
Cellular Data	Y
GPS	Y
Sensors	Y
Sound	Y
UBPorts Installer	N
UBPorts Recovery	N
Vibrator	Y
Wi-Fi	Y	Occasionally disconnects while device is sleeping.

Build status

Component	Status
halium-boot.img

How to install this OS?

• Stock rom, twrp and stuff for fajita (6T) stock 9
• Stock rom for enchilada (6) stock 9

Downloads

Download Ubuntu Touch from https://github.com/ubports-oneplus6/documentation/releases

Set it going whilst reading the information and instructions below.

Some preliminary information

The OnePlus 6/T supports a feature known as slots, designed to allow for seamless updates without interrupting the user other than to reboot. Functionally, this means the devices have 2 of all the important system partitions, this is great for us as we can use it to our advantage by installing Android on one and ubuntu touch on the other, allowing users to perform a tethered dual boot - for now switching OS requires a PC.

This guide if followed correctly will preserve your existing Android system and all your data, allowing you to switch back whenever you please. It also assumes you are currently running some Android 10 based ROM.

You will need the lates Android tools, they can be fetched from here: https://developer.android.com/studio/releases/platform-tools, on Arch linux pacman -S android-tools

Installation instructions

1. Downgrade to OOS 9 - this is needed and ubuntu touch doesn't work with Android 10 base
   • Download stock OOS 9 for your device from links above, you need OnePlus6TOxygen_twrp_34_OTA_android_9_Pie.zip.
   • You will unfortunately need 2 different TWRP versions if your wish to dual boot, download the latest for Android 10 - Enchilada/Fajita and an older version for Android 9 Enchilada/Fajita.
   • Power off your device and then turn it on while holding volume up, you should now be on a screen like this.
   • Now boot into TWRP recovery with the command fastboot boot twrp-3.4.0-3-<device>.img, once on on the main screen, you should see your phone in adb devices on your PC.
   • Move OxygenOS 9 zip file to your device with adb push OnePlus6TOxygen_twrp_34_OTA_android_9_Pie.zip /sdcard
   • In TWRP go to install and choose OnePlus6TOxygen_twrp_34_OTA_android_9_Pie.zip. Swipe to confirm flash and wait, it will take a few minutes. Note that this will install it to your other slot, it won't affect whatever Android system you're currently running.
   • Once it's done, go to the reboot menu and pick bootloader, then hit reboot. You should be in the bootloader - on a black screen with START in green letters like before, however you're now on the other slot (the one you just installed Android 9 to).
2. Flash Ubuntu Touch
   • If not already in the bootloader, power off the device and enter it by holding volume up and power.
   • Boot into TWRP 3.3 (the one for Andorid 9) with fastboot boot twrp-3.3.1-<device>.img
   • Copy the Ubuntu Touch installer to the device with adb push target.zip /sdcard
   • Install it from install menu in TWRP.
3. Flash kernel
   • Download kernel from here
   • With the system installed, next is the kernel, from the reboot menu pick bootloader again.
   • Whilst in the bootloader, run fastboot flash boot halium-boot.img.
4. Choose system from TWRP reboot menu, don't install the TWRP app! Enjoy your new system
5. Everything should be working now c:

Switching back to Android

• Power off the device, hold volume up and power to enter bootloader mode.
• Run fastboot getvar current-slot, this will tell you which slot ubuntu touch is installed to.
• Switch slots, if your current slot is a then run fastboot --set-active=b, if it's b use --set-active=a.
• fastboot reboot

The same steps can be used to switch to Ubuntu Touch again.

documentation's Issues

Calls not working on 1 sim

If I get a call and I answer that it's just silence and the phone freezes for ~3 minutes. And if I want to call, the call screen shows and crashes.

MTP/ADB

Will MTP and ADB work? And when?

Links to Stock ROM in README.md are broken

Thanks for this guide!

The links to the ROMs in README are not working anymore, a search in the Internet gave me following links:

oneplus 6 official build 10.3.x

oneplus 6 Android 9 ROMs found here:
OnePlus 6 OxygenOS 9.0.9 | Download
OnePlus 6T OxygenOS 9.0.17 | Download

and the Android 9 rollback firmware is found here

Edit:

Download the rollback firmware, push it to the phone with:
adb push 'fulldowngrade_wipe_MSM_17819_181025_2315_user_MP1_release.zip' /sdcard

Go to Settings > System > System Updates
Push the Gear icon followed by 'Local upgrade'
Select the fulldowngrade package
Confirm
Wait until finished
Reboot (takes a while with spinning circle logo)
Enable developer mode
Enable USB debugging
Use UBPorts installer to flash...

Edit2:

To recover back to Android/or install Android9 via terminal:

Download TWRP3.3.1
newer versions of TWRP did not work for me, but you might test and give feedback...

flash it with:
fastboot boot 'twrp-3.3.1-2-enchilada.img'

Download original Oxygen Android 9 ROM

push this image to the device with:
adb push OnePlus6Oxygen_22_OTA_025_all_1809150101_35981ba3cecc19e.zip /sdcard

in TWRP on the phone select: INSTALL and there select the pushed .zip file
this might take quite a while...

Now you are ready to use Android (first boot takes ages...) or to start installing UBports again.

BTW:
pw is: phablet

Progress and contributing

Does anyone have an estimate on when we might see a newer image or OTA integration of the OnePlus 6T?
Is there a road map of what needs to be done and how to help?
Where is the work being done?
Can we follow the progress somewhere?
How can we help to get the device page on ubports.com to reflect the current state of the device?
What is needed to get it added to the installer?
Can I compile a newer GSI for the 6T and if yes where is the code and are there instructions?

Armhf libs on aarch64

While trying to install Arm64 click package on the 6T using the UT tweak tool, click via the command line or pkcon via the command line arm64 apps fail to install.

While using pkcon and allowing untrusted it then reports

Package architecture "arm64" not compatible with system architecture "armhf"

, but if you run "arch" or "uname -a" on the command line it reports the phone being aarch64.

If I search the phone for directories containing aarch64 folders I get 0
If I search the phone for directories containing arm64 folders I get 2

/sys/module/kyro3xx_arm64_edac
/android/vendor/app/Rftoolkit/lib/arm6

If I search the phone for directories containing gnueabihf I get 24 like these examples

/usr/lib/arm-linux-gnueabihf/
/usr/lib/gcc/arm-linux-gnueabihf/
/usr/share/click/preinstalled/com.ubuntu.camera/3.1.3/lib/arm-linux-gnueabihf

Plus every other preinstalled app and working app I have installed. Since they are all armhf libs I think we are looking at an armhf file system on an arm64 device.

Am I misunderstanding this or was this a quick way of getting a working image or some other reason

Libertine X apps crash on start

I am trying to run gedit in libertine, however install a base container will have errors, so I fix that in this Impossible to create a libertine container #1305 .

add self.run_in_container('apt remove -y makedev') to line 86 of /usr/lib/python3/dist-packages/libertine/ChrootContainer.py

and run with libertine-container-manager create -i mycontainer it will create a container.

When I try to install gedit using apt, it success.

However launch gedit with ubuntu-app-launch or just touch in start menu, and crashing without anything error. Like this

I find log, there is not anything log file like $HOME/.cache/upstart/application-legacy-puritine_*_0.0-.log

Is anyone success to run X app in libertine? Anything help for this solutions? Or provide anything log files?

op6t screen turns off and doesnt turn back on

I saw a similar issue but I would like to provide more details.

I tried to use the brightness slider and the screen turned off.

If I leave it it'll turn back on after exactly 1 minute, but if I touch the screen or any button, it'll turn back off.

I tried rebooting obviously and even tried to bring the slider back up in the few seconds that the screen functions while freshly booted, but no luck.

GPS not working [Solved]

Device: Oneplus 6 (A6003)
OS: Ubuntu 16.04 (2021-07-31/2) stable channel

Apps using GPS are not finding GPS at all, even after leaving them open for a full day.
In terminal, after entering
test_gps

I get:

*** setup signal handler ***
*** get gps interface ***
GPS interface not found :(
Bye!

Location detection is on,
also tried with wifi enabled and disabled and
with switching to RC channel... nothing did help.

Do I need to install a GPS driver or something?
Any help very welcome.

USSD codes error.

If I trying to execute USSD code on my phoen with Ubuntu Touch, I am getting stuck on loading screen.

PIN ？

Hello guys，the kernel has PIN， I don't know what the PIN is. Could you tell me please~

OP6 turns itself off, can't turn screen back on

After a week of enjoying my OP6 with UBports, it started to act up a bit, particularly with wifi and mobile data connection. I usually solved this by doing a complete reboot, but the last few times the phone would only reboot into UBports with screen at max brightness and then shortly turn itself off. The battery is at over 90% and I am able to ssh into the phone, just like before, but the screen remains off.

With Anbox installed the system never seems to finish shutting down / rebooting

When rebooting or shutting down UBPorts before Anbox is installed via the OnePlus 5 documentation, it seems to successfully do so in due time, however when Anbox is installed the system seems to get stuck on the black screen it displays when shutting down or rebooting and never successfully does said operation.

(OnePlus 6)

Flashlight option isn't present in the GUI

In short, the option to turn on the flashlight isn't present in the GUI, when I've heard rumblings that it should be displayed in the Battery indicator's menu as a toggle. The flashlight does work when used in the Camera application.

(OnePlus 6)

I have some password questions

Because I don't know the password,
I can't use the terminal, when i lock screen, never enter in system,
I am a beginner ,
I don't know how to deal with this problem,
btw，
thank you && good job。

USB OTG broken

USB OTG does not work on One Plus 6. When inserting a USB-C stick that worked fine under Sailfish OS does not get power when inserting it in phone running Ubuntu Touch.

Low volume on built-in speaker

The volume on OP6 is very very low. I have tried uVolman to amplify it, but it is still really low. Headphone volume is loud though. I don't know if this is a software issue or if it has to do with the hardware.