Ubuntu Touch Device Configuration for the Samsung J1 2016 (samsung_j1xlte)

This should work on J120F and similar devices. Tested on a J120W8

Your warranty is now void. I am not responsible for bricked devices, data loss, or any other adverse effects caused by this rom. Install at your own risk.

This port is in a very early state! Many features don't work, and audio can be unreliable. See the devices.ubuntu-touch.io page for more details.

The EFS partition MUST be backed up, as it contains critical phone information! You should make an image backup of the EFS partition, as TWRP does not backup hidden files in this partition (including the important .nv_data.bak). You can do this in TWRP with the command dd if=/dev/block/bootdevice/by-name/EFS of=/external_sd/efs.img (or wherever you want the backup).

Installing

BACKUP YOUR DATA, ESPECIALLY EFS, BEFORE CONTINUING!

You will need a MicroSD card to install Ubuntu Touch on this device, as it's system and userdata partitions are too small.

This guide assumes a linux computer. Steps may not be the same on Windows or MacOS.

REVERT TO STOCK ANDROID. This step is important as audio may not work if you do not start from stock Android
Enable OEM Unlock and USB Debugging in Developer Settings in Android. (You may need to enable Developer Mode first)
Get the required files. Precompiled files (rootfs.tar.gz, halium-boot.img, and system.img) can be downloaded from the releases page. For building instructions, see Building and Rootfs
Install Heimdall, ADB, and clone the halium-install repository
Install TWRP on your phone from here
Put your MicroSD card into the phone while it is powered off (BACKUP YOUR DATA - it will be formatted!).
Boot into TWRP by holding Power, Home, and Volume Up while turning on your phone.
In TWRP, go to Wipe > Advanced Wipe > Select Micro SD Card > Repair or Change File System > Change File System > EXT4, and swipe to confirm. **THIS WILL FORMAT YOUR SD CARD!**
In TWRP, go to Mount > Unselect external_sd and Data
From your computer, with your phone plugged in, run the following commands (this tricks halium into thinking the SD card is the userdata partition)
```
adb shell
tune2fs -L userdata /dev/block/mmcblk1p1
mount /dev/block/mmcblk1p1 /data/
exit
```
From your computer, with your phone plugged in, run path/to/halium-install -p ut -s path/to/rootfs.tar.gz path/to/system.img. This will ask for a password which will be used to unlock your phone.
In TWRP, go to Reboot > Download > Do Not Install
From your computer, with your phone plugged in, run heimdall flash --BOOT path/to/halium-boot.img
That's it! Your phone should reboot into Ubuntu Touch.

Updating

If you were using release v0.2.1 or earlier, please revert to stock first!

Get the updated rootfs, halium-boot.img and system.img
Boot into TWRP
From your computer, with your phone plugged in, run the following commands (you will need to specify your password again)
```
adb shell mount /dev/block/mmcblk1p1 /data/
path/to/halium-install -p ut -s path/to/rootfs.tar.gz path/to/system.img
```
In TWRP, go to Reboot > Download > Do Not Install
From your computer, with your phone plugged in, run heimdall flash --BOOT path/to/halium-boot.img
That's it! Your phone should reboot into newly updated Ubuntu Touch.

Fixes to known issues

WiFi will not reconnect by default. To fix this, run nmcli c modify "YOUR WIFI SSID HERE" "802-11-wireless.mac-address" "" on the device.

Sometimes the device may get stuck on the Samsung logo. To try and fix this, reboot into TWRP and run the following commands

umount external_sd
e2fsck -fy /dev/block/mmcblk1p1
mount /dev/block/mmcblk1p1 external_sd
e2fsck -fy external_sd/rootfs.img
e2fsck -fy external_sd/android-rootfs.img

Sometimes audio will stop working. To fix this, you will need to boot stock Android. You may want to keep halium-boot.img and the stock bootimg on your phone to easily switch between them in TWRP.

Building

These instructions are intended for developers, and may not be perfect. Precompiled files can be downloaded from the releases page.

Make a build directory (e.g. ~/samsung-j1xlte/halium). This will be BUILDDIR in the following commands.

From the root of your BUILDDIR, run

repo init -u https://github.com/j1xlte-gtelwifiue/halium -b halium-10.0 --depth=1
repo sync -c -j 16
./halium/devices/setup j1xlte

Remove the file BUILDDIR/hybris-patches/external/v8/0001-blueprints-Allow-building-on-both-Linux-and-macOS.patch (it is already applied)

From the root of your BUILDDIR, run

./hybris-patches/apply-patches.sh --mb
./device/samsung/j1xlte/update-initramfs.sh
source build/envsetup.sh
breakfast j1xlte
export LANG=C USE_HOST_LEX=yes TEMPORARY_DISABLE_PATH_RESTRICTIONS=true
mka mkbootimg
mka halium-boot
mka e2fsdroid
mkdir -p out/target/product/j1xlte/recovery/root/system/etc
mka systemimage

Done! Your files are BUILDDIR/out/target/product/j1xlte/halium-boot.img and system.img

Rootfs

You can download the premade rootfs from the releases page. These instructions assume you have a basic knowledge of linux commands.

Download the default Ubuntu Touch rootfs from here
Add a symbolic link from /efs/ to /android/efs/ to the rootfs
Add an empty file /etc/gbinder.conf
Install Ubuntu Touch
Download the patched ofono.deb from here and install it on the phone. You will need to run sudo mount -o remount,rw / before using apt or dpkg

Contributors

@j1xlte-gtelwifiue

Thank you to the following contributors who worked on the unofficial LineageOS version this Ubuntu Touch port is based off of

Thanks also to everyone who has contributions on Exynos3475 Nougat.

Special thanks to

and all of the 5433/7580 AOSP developers/contributors.

You must include this contributor list in any projects created from these sources.

j1xlte-gtelwifiue / android_device_samsung_j1xlte