ansible | ||
.gitignore | ||
IMAGE.md | ||
LICENSE | ||
README.md |
sargo-temp
Temporary fixes that make Mobian work on sargo.
Please note that the MIT license does not apply to qcom-firmware
.
What to do
Build Image
Instructions can be found in IMAGE.md in this repo.
Flash image
First flash the image. Boot the phone.
Connect via SSH: ssh mobian@10.66.0.1
Accept the host key.
Note: If you built the image with a different username, you will have to set that in ansible/ansible.cfg
.
Roll out workarounds using Ansible
You have to have ansible-playbook
installed.
Go to the Ansible folder: cd ansible
Roll out workarounds: ./workarounds.sh
Reboot phone via SSH.
Connect to wifi.
Rolling out the workarounds for audio requires installing packages from the repo, so we need an internet connection.
Roll out audio workarounds: ./audio.sh
Note:
- You might have to switch SIM slots if your SIM card is not recognised.
- Command:
mmcli -m any --set-primary-sim-slot=1
, options are1
or2
- Command:
- The kernel does not get updates from the repos yet, so watch the git repo to find out when there are new releases so you can compile it again and install the
.deb
file. - Watch the RSS feed for this repo to learn when there is something new:
Project Status
Issues on Debian Salsa
Various issues can be found on Salsa: https://salsa.debian.org/Mobian-team/devices/kernels/qcom-linux/-/issues/?sort=created_date&state=opened&search=sargo%2Fbonito&first_page_size=20
To Do List
- Make installer images work on this device
- Have droid-juicer run on installer images
- Create an ITP for
tinyalsa
andq6voiced
and get both into the repos (use the workarounds from this repo to get working call audio for now) - Combine SDM670 kernel patches with those in the Mobian qcom kernel
- Patches are already being upstreamed by the sdm670-linux project, maybe that's already done before I start working on it xD
Issues To Solve To Get Official Mobian Images
- Combining SDM670 kernel patches with the Mobian qcom kernel (To Do List entry above, help wanted)
Done:
- New release of qcom-phone-utils required so that my patches are available from the repo
4f77281197
(firmware folders)9aa29a1d0b
(fixes bootimg generation with LUKS)3ddb192b5c
(fixes on-screen keyboard for LUKS passphrase)
- Remove hard-coded value in the
droid-juicer
systemd unit - Make sure my
q6voiced
package no longer includes a hard-coded config for this device (known solution, need to implement) - add udev rule for the vibration motor to the right package
- Wireplumber config
For those I will remove the workarounds once the changes are in the Mobian repo
Misc Issues
- ALSA config for the device has not been upstreamed yet (can be added using the Playbook in this repo)
- Bug in Pipewire that causes issues with the camera: https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/4227
- Some people have issues connecting to 5 GHz wifi and/or dual 2.4 GHz/5 GHz wifi, while for others this works perfectly fine
- https://salsa.debian.org/Mobian-team/devices/kernels/qcom-linux/-/issues/6
- Can be worked around by forcing the phone to only use the 2.4 GHz band, for example using
nmtui
, the network settings of GNOME/Phosh are bit too simplistic for that
- Currently no way to switch cameras, only one is usable at a time, requires change in Wireplumber
- https://gitlab.freedesktop.org/pipewire/wireplumber/-/merge_requests/670 <- someone is working on that
(This is a non-exhaustive list)
Low Priority
- fix udev rule for the Bluetooth workaround in this repo
- create/find script/tool that brings up Bluetooth & then package it
- https://salsa.debian.org/Mobian-team/devices/kernels/qcom-linux/-/issues/5
- for now this repo contains a simple script specific to this device and a udev rule, but something is wrong with the udev rule. Run
/opt/bluetooth-mac.bash
to get Bluetooth working, repeat after reboots
This Works
- booting
- display
- touch
- modem
- plymouth
- battery/charging
- SMS
- mobile data
- wifi
- torch
- suspend
- call audio
- vibration
- Bluetooth™
- full disk encryption
- eSIM (provisioning tool not yet packaged and has to be compiled and installed manually)
- audio (ALSA config not packaged, but can be manually added using the playbook in this repo)
- camera (currently only one camera works at a time, image quality is still not anywhere near Android, driver is work in progress, udev rule required)
This Has An Unknown Status
- Fingerprint Sensor
- NFC (should work, does so on pmOS)
This Does Not Work Yet (Soon™)
- GPS
- USB host mode (no Kernel support yet, but apparently this is being worked on)
- Verified Boot (first need to do research whether this is actually feasible)
This Is Missing And Will Come Later
- accelerometer
- magnetometer
- ambient light sensor
- barometer
The Sources (Use The Source, Luke)
- My efforts of packaging a device-specific kernel: https://salsa.debian.org/erebion/sdm-670-linux (which can be used for now as patches are not yet in upstream Linux)
mobian-recipes
, which is used to build images: https://salsa.debian.org/Mobian-team/mobian-recipesdroid-juicer
, which retrieves some important files, such as firmware, from some partitions: https://gitlab.com/mobian1/droid-juicer- postmarketOS wiki: https://wiki.postmarketos.org (lovely folks, thanks for sharing everything you found out the hard way :D)
Thanks For All The Fish
Huge thanks to be sdm670-linux project and flamingradian who did and still does an awful lot of work to make sure the Kernel works on those devices! :)
I don’t know how Kernel development works, so I would have never started porting without this project.
Find that here: https://gitlab.com/sdm670-mainline/linux