Changes

Jump to: navigation, search

Xiaomi Redmi 1S (xiaomi-armani)

791 bytes removed, 22:55, 15 March 2018
/Xiaomi_Redmi_1S_(xiaomi-armani)/: move kernel logs to hardware enablement section, remove debug-shell initfs hook
== What works ==
* USB ethernet
* Flashing, via android-recovery-zip (twrp)and pmbootstrap flasher
* Touchscreen (ft5x06_i2c)
* Screen: framebuffer (/dev/fb0), backlight & brigtness control (/sys/class/leds/wled:backlight/brightness)
== What does not work ==
{{Note|After pulling current postmarketos sources * Screen: framebuffer console (commit d3818cd2e7c8fed121b1e957624ae00e4b8e39c5no kernel boot log printed on the display), directfb applications (osk-sdl and charging-sdl)* Wifi: rfkill (no support for blocking wireless via rfkill block wifi or nmcli radio wifi off). The only way to block wireless is unloading wlan module (``rmmod wlan`` or ``/etc/init.d/wlanarmani stop``)* Sound: don't know how to initialize the device encounters a boot loopsound card * Other hardware features are untested (3D, bluetooth, modem, gps, accelerometer)* Xorg based UI: postmarketos-ui-xfce4 displays nothing on the screen. == How to enter flash mode ==* Entering fastboot: hold VolumeKeyDown + Power buttons until fastboot mode displayed on the screen.* Entering recovery: hold VolumeKeyUp + Power buttons. The default is Mi Recovery. TWRP is needed for installation, which can be obtained [[Inspecting_the_initramfshttps://twrp.me/xiaomi/xiaomiredmi1s.html here]] is needed  == Installation == === pmbootstrap flasher method === * Put the device into fastboot mode by holding both VolumeKeyDown + Power buttons or rebooting into bootloader from the twrp reboot menu.* Connect the device to the computer via usb cable* Bootstrap PostmarketOS::<code>$ pmbootstrap init #select xiaomi-armani</code>::<code>$ pmbootstrap install --no-fde</code>* Flash the kernel and system::<code>$ pmbootstrap flasher flash_kernel</code>::<code>$ pmbootstrap flasher flash_system</code>* Reboot the device::<code>$ fastboot reboot</code> === Android recovery.zip sideload method === * Put the device into TWRP recovery, either by booting twrp image via fastboot directly or by pressing VolumeKeyUp + Power button after flashing TWRP recovery image.* Connect the device to troubleshoot this issuethe computer via usb cable* Bootstrap PostmarketOS :<code>$ pmbootstrap init #select xiaomi-armani</code> :<code>$ pmbootstrap install --no-fde --android-recovery-zip</code> :<code>$ pmbootstrap export # generate symlinks inside /tmp/postmarketOS-export directory</code> * Put the twrp recovery into sideload mode :<code>$ adb shell "twrp sideload"</code> * Start sideloading the recovery file :<code>$ adb sideload /tmp/postmarketOS-export/pmos-xiaomi-armani.}}zip</code> * Reboot the device :<code>$ adb reboot</code>
* Screen: framebuffer console (no kernel boot log printed == Additional info ==It's necessary to unplug the usb cable after issuing ``poweroff`` command to properly shut down PostmarketOS. Don't leave screen on for a long time, otherwise there will be LED burn-in. If the display)screen is not used, turn the screen off. * Wifi: rfkill (no support for blocking wireless via rfkill block wifi or nmcli radio wifi off). <code>$ echo 0 | sudo tee "/sys/class/leds/wled:backlight/brightness"</code> The only way screen can be turned on with maximum value up to block wireless is unloading wlan module (``rmmod wlan`` or ``4095 :<code>$ echo 3072 | sudo tee "/sys/class/leds/wled:backlight/etcbrightness"</initcode> Battery state can be monitored.d/wlanarmani stop``Refer to [[Battery capacity monitoring]] for more information. == Hardware enablement effort == * Framebuffer: directfb based applications don't work (osk-sdl and charging sdl)* Sound: msm8226-asoc-tapan requests probe deferral.still figuring out how to initialize the sound card: /proc/asound/cards: no soundcards
: Here is part of initial kernel log.
<pre>
</pre>
: For now, the sound doesn't work at all.
* Other hardware features are untested (3D, bluetooth, modem, gps, accelerometer)
* Xorg based UI: postmarketos-ui-xfce4 displays nothing on the screen.
 
== How to enter flash mode ==
* Entering fastboot: hold VolumeKeyDown + Power buttons until fastboot mode displayed on the screen.
* Entering recovery: hold VolumeKeyUp + Power buttons. The default is Mi Recovery. TWRP is needed for installation, which can be obtained [https://twrp.me/xiaomi/xiaomiredmi1s.html here]
 
== Installation ==
 
=== pmbootstrap flasher method ===
{{Note|This method provides complete root filesystem contents. Even with this method, the boot loop issue remains.}}
* Put the device into fastboot mode by holding both VolumeKeyDown + Power buttons or rebooting into bootloader from the twrp reboot menu.
* Connect the device to the computer via usb cable
* Bootstrap PostmarketOS, adding debug-shell hook during the process
::<code>$ pmbootstrap init #select xiaomi-armani</code>
::<code>$ pmbootstrap initfs hook_add debug-shell</code>
::<code>$ pmbootstrap install --no-fde</code>
* Flash the kernel and system
::<code>$ pmbootstrap flasher flash_kernel</code>
::<code>$ pmbootstrap flasher flash_system</code>
* Reboot the device
::<code>$ fastboot reboot</code>
 
=== Android recovery.zip sideload method ===
{{Note|With {{github|1333}}, installation using recovery.zip doesn't provide complete root filesystem.}}
* Put the device into TWRP recovery, either by booting twrp image via fastboot directly or by pressing VolumeKeyUp + Power button after flashing TWRP recovery image.
* Connect the device to the computer via usb cable
* Bootstrap PostmarketOS
 
:<code>$ pmbootstrap init #select xiaomi-armani</code>
 
:* Optional: build the device specific packages. Actually, there is no need to build the device specific packages since they are available on PostmarketOS repository.
 
::<code>$ pmbootstrap build -i device-xiaomi-armani</code>
 
::<code>$ pmbootstrap build -i firmware-xiaomi-armani</code>
 
::<code>$ pmbootstrap build linux-xiaomi-armani</code>
 
{{Note|With boot loop issue with latest pmbootstrap, a debug shell is needed.}}
 
: Install the debug shell to help troubleshoot the boot loop issue
 
:<code>$ pmbootstrap initfs hook_add debug-shell</code>
 
:<code>$ pmbootstrap install --no-fde --android-recovery-zip</code>
 
:<code>$ pmbootstrap export # generate symlinks inside /tmp/postmarketOS-export directory</code>
 
* Put the twrp recovery into sideload mode
 
:<code>$ adb shell "twrp sideload"</code>
 
* Start sideloading the recovery file
 
:<code>$ adb sideload /tmp/postmarketOS-export/pmos-xiaomi-armani.zip</code>
 
* Reboot the device
 
:<code>$ adb reboot</code>
 
== Additional info ==
It's necessary to unplug the usb cable after issuing ``poweroff`` command to properly shut down PostmarketOS.
 
Don't leave screen on for a long time, otherwise there will be LED burn-in. If the display screen is not used, turn the screen off.
 
:<code>$ echo 0 | sudo tee "/sys/class/leds/wled:backlight/brightness"</code>
 
The screen can be turned on with maximum value up to 4095
 
:<code>$ echo 3072 | sudo tee "/sys/class/leds/wled:backlight/brightness"</code>
 
Battery state can be monitored. Refer to [[Battery capacity monitoring]] for more information.
== See also ==
32
edits

Navigation menu