Samsung Galaxy S5 mini (samsung-kminilte)

From postmarketOS Wiki
Samsung Galaxy S5 mini
Samsung Galaxy S5 mini
Samsung Galaxy S5 mini
Manufacturer Samsung
Name Galaxy S5 mini
Codename samsung-kminilte
Released 2014
Type handset
Hardware
Chipset Samsung Exynos 3470
CPU Quad-core 1.4 GHz Cortex-A7
GPU Mali-400MP4
Display 720x1280 AMOLED
Storage 16GB
Memory 1.5GB
Architecture armv7
Software
Original software Android
Original version 4.4.2 (Linux 3.10)
postmarketOS
Category testing
Pre-built images no
Features
Flashing
Broken
USB Networking
Works
Internal storage
SD card
Battery
Screen
Works
Touchscreen
Works
Multimedia
3D Acceleration
Audio
Camera
Camera Flash
Connectivity
WiFi
Works
Bluetooth
GPS
Modem
Calls
SMS
Mobile data
Miscellaneous
FDE
Works
USB OTG
HDMI/DP
Sensors
Accelerometer
Magnetometer
Ambient Light
Proximity
Hall Effect
Haptics
Barometer


Users owning this device


Special keycombo's

Download/Flash/ODIN mode - Press and hold "volume down + home + power" simultaneously. Then click volume up to confirm.

Recovery - press and hold VOL+, PWR and HOME

Problems

  • Currently, Heimdall seems to be unable to flash the device's SYSTEM partition, so we can't do the entire install using just pmbootstrap flasher.
  • udevadm trigger causes a complete system freeze and eventual reboot. If you comment out that line in start_weston.sh and replace it by udevadm trigger --attr-match=name=sec_touchscreen, the touch screen should work.

Preparing for install

First, download the TWRP recovery ROM. You'll need both the .img.tar and the .img file. First, extract the tar file to obtain recovery.img. Then, put your phone in flash mode and flash using Heimdall:

$ heimdall flash --RECOVERY recovery.img --BOOT twrp-3.2.3-0-kminilte.img

Now you should be able to connect to the device using adb.

Note: Be aware that the stock Android ROM reflashes stock recovery upon boot, wiping TWRP out if you let it start booting.

Installing system

Follow the android-recovery-zip steps, using samsung-kminilte when the init commands asks. Heimdall is currently unable to flash the SYSTEM partition, and adb sideload method seems broken, so you will have to do pmbootstrap export after generating the recovery and pushing it to the phone while it is booted in TWRP via adb push /tmp/postmarketOS-export/pmos-samsung-kminilte.zip /sdcard/.

Then just flash it via recovery as you would a normal android ROM. Currently on Samsung devices you may get an error about unmounting .log files, it seems to work on second try but due to another issue you have to make sure SYSTEM is unmounted in TWRP before attempting to do so.

If you get an error lddtree not found, simply run apk add lddtree in the chroot environment and try again.

If you get the following errors:

device-mapper: reload ioctl on   failed: No such file or directory
Failed to setup dm-crypt key mapping for device /dev/block/mmcblk0p18.
Check that kernel supports aes-xts-plain64 cipher (check syslog for more info).

You can try to reinstall with a different cipher, by editing install_options and changing the CIPHER line to CIPHER="aes-cbc-plain64", re-zipping and using adb sideload again.

Installing kernel

This can be done via ./pmbootstrap.py flasher flash_kernel, but if you followed the recovery ROM steps then you don't need to do this.

It should boot, and show the Samsung splash screen. After that you should be able to setup and connect via SSH

Getting Wifi to work

Wifi requires firmware blobs to be installed:

 apk add firmware-samsung-kminilte


After installation, either reboot the device, or:

  1. start "deferred-initcalls" service
  2. restart networkmanager and / or wpa_supplicant and / or whatever you want to do with networking

When using networkmanager, you should now be able to connect to a network:

 nmtui

Troubleshooting Wifi

  • Interface wlan0 does not exist
  • using wlan0 or p2p0 fails with "Operation not permitted"
    • Check dmesg for messages containing "dhdsdio_download_firmware", to see if there was an error loading the firmware

What works

  • Booting off a microSD card
  • Display
  • Touchscreen
  • USB Networking
  • Full disk encryption
  • Proximity sensor
  • Light sensor
  • Heart rate sensor
  • Magnetic sensor
    • Chip: ALPS HSCDTD0008A (Datasheet)
    • Attached via: I2C, address 0x0c
    • Driver: hscd_i2c
  • Audio jack events
  • Physical buttons
    • Driver: gpio-keys
    • Device node: /dev/input/event8
      • KEY_HOMEPAGE: Home button
      • KEY_POWER: Power button
      • KEY_VOLUMEUP: Volume up button
      • KEY_VOLUMEDOWN: Volume down button
    • Use triggerhappy to configure what the buttons do
    • If you are running elogind, make sure to prevent it from handling the power button, by setting HandlePowerKeyIgnore in logind.conf
  • Touch keys
    • Attached via: I2C, address 0x20
    • Driver: i2c-gpio
    • Device node: /dev/input/event1
      • KEY_BACK Back button (right of the home button)
      • 254 (name neither listed by libinput, nor linux/input.h) Other button (left of the home button)
    • The left button cannot be used for triggerhappy right now, since it doesn't support configuring numeric key codes
  • Notification LED
    • Chip: Samsung KTD 2026
    • Attached via: I2C, address 0x30
    • Driver: ktd2026
    • This is an RGB LED. The red, green and blue channels can be controlled individually though led_r, led_g and led_b in /sys/class/leds/$led. Some examples:
      • full brightness red: echo 48 > /sys/class/leds/led_r/brightness (check max_brightness to make sure this is correct)
      • half brightness red: echo 24 > /sys/class/leds/led_r/brightness
      • blink green: echo 1 > /sys/class/leds/led_g/blink (set delay_{on,off} afterwards to control timing)
  • Vibration motor
  • Gyroscope
  • Wifi
  • Flashlight
    • Write mode "Torch" / "Off" to /sys/class/flashlight/rt-flash-led/mode to turn the light on and off
    • Change brightness by writing a value from 0 to 15 to /sys/class/flashlight/rt-flash-led/torch_brightness
    • See pmaports!1150 for details

Links