nyuuzyou/wikis huggingface dataset:
Asus Zenfone Max ZC550KL (asus-z010d)

== Contributors ==
* devajithvs
== Maintainer(s) ==
== Users owning this device ==
== Unlocking Bootloader ==
== How to enter flash mode ==
* Recovery: Power on the device with both Power and Volume Down buttons.
* Stock fastboot: Power on the device with both Power and Volume Up buttons. You only need this to install lk2nd.
* lk2nd Fastboot: Power on the device. After it vibrates/the display shows up, hold Volume Down.
== WLAN/BT module does not work? ==
If your device does not have wlan module (not shown in ifconfig, for example), then your dmesg output probably contains something like:
qcom-wcnss-pil a204000.remoteproc: error -22 initializing firmware wcnss.mdt
remoteproc remoteproc1: Failed to load program segments: -22
It means that firmware files, that are on your device (/dev/mmcblk0p39), different with files required. It can be fixed easily:
* unmount /lib/firmware/msm-firmware-loader/mnt/modem
* unmount /lib/firmware/msm-firmware-loader
* mount /dev/mmcblk0p39 to /mnt (for example)
* backup your /mnt/image/wcnss.* because we will overwrite it
* copy firmware files from here (files I found through browsing...) to your /mnt/image
So, now you have different firmware files. After rebooting, if everything is OK, you will have working WiFi and BT.
== Installation ==
# Install lk2nd (alternative bootloader that provides a standard fastboot interface)
# Follow Qualcomm_Snapdragon_410/412_(MSM8916)#Installation.
== Status ==
Runs on mainline kernel
Works:
USB Network,
WiFi,
Bluetooth,
Display,
Touchscreen,
Volume buttons,
Hall Effect Sensor,
Accelerometer,
Magnetometer,
Notification Lights
Audio (Headphones, Earpiece, Speaker, MIC),
Voice calls (VoLTE not supported),
SMS,
Mobile Internet
== See also ==
* Initial merge request
* Device package
* msm8916 mainline kernel package
* Mainline kernel tree for msm8916 devices
Asus Zenfone Zoom (asus-z00xs)

== Contributors ==
* grimsteel
== Users owning this device ==
== How to enter flash mode ==
Hold power button and volume up while device is off, or run adb reboot bootloader when booted into Android.
== Installation ==
Use pmbootstrap to build your own installation image.
$ pmbootstrap init
$ pmbootstrap install --fde
== See also ==
Axolotl

Axolotl is a complete cross-platform primary Signal client, compatible with the Ubuntu Phone and more. Unlike the desktop Signal client, Axolotl is completely autonomous and doesn't require you to have created an account with the official Signal application. There are still bugs and UI/UX quirks and not all Features of the official Signal clients are supported.
It is built upon the go textsecure package and a Vue frontend that runs in an electron/qml WebEngineView container.
== Discussion ==
Personally, for the last few years I have convinced people around me to use Signal instead of WhatsApp. The Signal client for Linux is usable, but not fully adaptive, and needs to be bound to an Android or iOS version with a phone number. Axolotl might present a promising alternative.
Discussion points:
* Axolotl is currently not available in Alpine Linux/PostmarketOS repos, but on Flathub
* Whisper Systems LLC has a bad reputation regarding third party clients. Is this really worth the effort?
== Installing ==
Axolotl can currently be installed via Flatpak:
$ flatpak install flathub org.nanuc.Axolotl
On the PinePhone, it is possible to use the Qt version (built via Flatpack) for text messaging.
== Links ==
* Porting effort: 
* Someone seems to have a lot of feedback, but performance it not one of them on Mobian on a Pinephone: https://github.com/nanu-c/axolotl/issues/541
Category:Apps
BLU Win HD LTE (blu-ql850)

== Contributors ==
* FieryFlames
== Users owning this device ==
== Bootloader unlock ==
* https://gus33000.me/2019/01/05/secureboot-flaw-for-all-wp-devices-literally/
== Hardware ==
* WIP HW list for BLU Win HD LTE
Feature 	Hardware	Mainline driver
Touch 	GT915L 	goodix
Accel/Gyro 	BMA223 	bmc150
Magnetometer	AK09911 	ak8975
Als/Prx 	AP3216C 	PATCH 1/3 iio: light: Add driver for ap3216c
Camera flash	SGM3780 	leds-sgm3140
== See also ==
=== Internal links ===
* Qualcomm Snapdragon 410/412 (MSM8916)
* Windows Phone
=== External links ===
* Boot shim for booting alternative bootloaders.
BQ Aquaris E5 HD (bq-vegetahd)

== Contributors ==
* EmanueleSorce42
== Users owning this device ==
== How to enter flash mode ==
Reboot keeping pressed the volume up button. Then move the cursor with volume up to Fastboot Mode and press the Volume Down to confirm.
== Installation ==
Use pmbootstrap to build your own installation image.
I recommended install using TWRP sideload since fastboot may fail when trying to install the system partition.
$ pmbootstrap init
$ pmbootstrap install --android-recovery-zip --recovery-install-partition=data
$ pmbootstrap flasher --method=adb sideload
== See also ==
* Initial merge request
* Problem with install with xfce4
BQ Aquaris M10 FHD (bq-frieza)

The BQ Aquarius M10 FHD is a tablet made by BQ and Canonical, which shipped in Android and Ubuntu Touch editions, which only differ on firmware. PostmarketOS boots on both firmwares.
== Contributors ==
* 00p513
== Maintainer(s) ==
* 00p513
== Users owning this device ==
== Flashing ==
This device has got 2 different firmwares. The main difference between them is the partition sizes, with the Ubuntu firmware having a larger userdata partition. You may use both for postmarketOS, however the Ubuntu one is recommended. 
Installation can be done via the usual installation guide, however flashing the rootfs will fail due to a broken fastboot installation. You can use either dd in recovery, android recovery zips with twrp, or flashing via SP Flash Tool. 
== Interfaces ==
UI Name	Working?	Notes
Weston 	Yes 	
MATE 	Yes 	No touchscreen
BQ Aquaris M5 (bq-piccolo)

== Contributors ==
* degdag
== Maintainer(s) ==
* degdag
== Users owning this device ==
== What works ==
* Buttons
* WiFi/Bluetooth
* SD Card slot
* Touch (atmel_mxt_ts)
* Magnetometer (ak09911)
* Proximity Sensor (ltr559)
* Vibrator
* Accelerometer/Gyroscope (bmi160)
* Front flash (ocs,ocp8110)
* Rear flash (silergy,sy7802)
* Status LED (kinetic,ktd2026)
== What doesn't work ==
* Audio (wlf,wm8998)
* Front camera (s5k5e2)
* Rear camera (sony,imx214)
* NFC (bcm2079x)
hwtest:
Category 	Model 	Path 	Status
framebuffer 	msm 	/sys/class/graphics/fb0 	working
drm 	- 	/sys/class/drm/card0-DSI-1 	working
magnetometer 	ak09911 	/sys/bus/iio/devices/iio:device3	working
accelerometer	bmi160 	/sys/bus/iio/devices/iio:device2	working
gyroscope 	bmi160 	/sys/bus/iio/devices/iio:device2	working
proximity 	ltr559 	/sys/bus/iio/devices/iio:device1	working
input 	Atmel maXTouch Touchscreen	/dev/input/event5 	working
input 	GPIO Buttons 	/dev/input/event3 	working
input 	GPIO Hall Effect Sensor 	/dev/input/event2 	working
input 	pm8941_resin 	/dev/input/event1 	working
input 	pm8941_pwrkey 	/dev/input/event0 	working
== How to enter flash mode ==
=== BQ bootloader ===
* Recovery: Power on the device with both and buttons.
* Fastboot: Power on the device with both and buttons
== Installation ==
=== Unlock bootloader ===
To unlock your bootloader boot into Android, enable Developer Options from the settings and enable "Allow OEM unlock". Then boot into Fastboot and use fastboot oem unlock. You might need to use fastboot oem unlock-go. (Note: All your data will be erased!)
=== Firmware ===
It is recommended to flash to latest firmware from BQ before using postmarketos.
=== postmarketOS ===
The mainline kernel depends on an alternative bootloader (lk2nd). It does not replace the stock bootloader, but provides its own Fastboot interface. When using the mainline kernel you should always use lk2nd for flashing, not the stock Fastboot mode.
# Install lk2nd. (Just needed the first time).
#* Warning: lk2nd is installed to the boot partition.
When you have lk2nd installed and running, follow Qualcomm_Snapdragon_410/412_(MSM8916)#Installation.
== Audio ==
See Qualcomm_Snapdragon_410_(MSM8916)#Audio.
This device use WM8998 Arizona sound codec driver already in mainline but i failed to get it up ...
== Modem ==
See Qualcomm_Snapdragon_410_(MSM8916)#Modem.
Cellular networking requires the package msm-modem-uim-selection and setting /etc/conf.d/msm-modem-uim-selection to sim_wait_time=10, this will automatically detect a sim card in one of the slots and activate it.
== Pictures ==
== See also ==
* Initial merge request
*
BQ Aquaris U (bq-chaozu)

== Contributors ==
* JBBgameich
== Maintainer(s) ==
* JBBgameich
== How to enter flash mode ==
Run adb reboot bootloader from the recovery or stock ROM. Alternatively choose fastboot in the early boot menu (only appears if your bootloader is unlocked) by using the volume buttons.
== Installation ==
== Photos ==
== Links ==
* 
*
BQ Aquaris U Plus (bq-tenshi)

== Contributors ==
* fossdd
== Maintainer(s) ==
* fossdd
== Users owning this device ==
== Status ==
Right now only USB Netwoking (with SSHing into the system) works.
Display seems to be working in initramfs, but not after loading the kernel.
== How to enter flash mode ==
* Go to Developer options and enable OEM unlocking.
* Power off and start again using Volume Down and Power on.
* Connect your phone to your PC and run fastboot flashing unlock.
== Installation ==
Use pmbootstrap to build your own installation image.
$ pmbootstrap init
$ pmbootstrap install
To flash postmarketOS on your phone use:
$ pmbootstrap flasher flash_rootfs
$ pmbootstrap flasher flash_kernel
$ fastboot reboot # if not rebooting already
== See also ==
* Initial merge request
* 
*
BQ Aquaris X5 Plus (bq-gohan)

== Contributors ==
* Symmetrist (Nimayer)
== Maintainer(s) ==
* Symmetrist (Nimayer)
== Users owning this device ==
== How to enter flash mode ==
With device powered off press volume down + power button to get in Fastboot mode
== Installation ==
Tested using fastboot installation
== See also ==
* Initial merge request
* 
*
BQ Aquaris X / BQ Aquaris X Pro (bq-bardock / bq-bardockpro)

The BQ Aquaris X and BQ Aquaris X Pro are 2017 mid-range devices by Spanish manufacturer BQ. The non-Pro version has a plastic back, while the Pro has a glass back. They otherwise only differ in cameras.
All units of both devices appear to be unfused, meaning that secure boot is disabled and in theory, the first stage bootloader could be replaced and any firmware uploaded to the coprocessors.
== Contributors ==
== Users owning this device ==
== Unlocking the bootloader ==
Unlocking the bootloader on these devices is trivial.
* Enable developer options by pressing "Build number" in the settings repeatingly
* Insert a SIM card and enable bootloader unlocking in the developer options
* Reboot to fastboot (conveniently by enabling USB debugging and adb reboot bootloader)
* Run fastboot oem unlock and confirm with volume buttons
* When it reboots now, use the volume buttons to select fastboot again
* Run fastboot flashing unlock_critical and confirm yet again
* Done! Your bootloader is now fully unlocked and you're ready to flash lk2nd
== How to enter flash mode ==
* Bootloader: Power on the device with both and buttons.
* Recovery: Power on the device with both and buttons.
* EDL: Power off the device, hold both and buttons for 10 seconds, then plug in a USB cable
== Installation ==
Installing lk2nd before postmarketOS is required. Grab a prebuilt from the latest CI run or build it from the repository yourself, unzip it and run fastboot flash boot lk2nd.img in fastboot.
Use pmbootstrap to build your own installation image.
== Mainline ==
There are two panel/touchscreen combinations: ft8716 (with ft8716 touch) and otm1906b (with ili2120 touch). Both touchscreens and panels have mainline drivers and are fully supported.
The buttons under the screen are actually part of the touchscreen and currently not supported.
Microphones are not working due to PipeWire related issues, generally they should work fine once the MSM8953 PipeWire issues are fixed.
== UART ==
UART on these devices uses a baud rate of 115200.
== See also ==
* Close-to-mainline kernel source
Backing up a non-pmOS phone

This guide will show you how to backup a phone, tablet, or other device before installing postmarketOS.
== Things to remember ==
It's useful to have a checklist of things to back up from a device:
* Files, both photos and other files (downloads, documents, etc.)
** Some phones may also have a "secure folder" feature; if you used it, remember to back up those files as well. 
* Contacts, which can be exported to .vcf format from your contacts app of choice.
** You can re-import your contacts later on postmarketOS; see your interface's wiki page for instructions.
* Call logs or SMS message logs.
* 2FA app data, if you use your phone for two-factor authentication. Back up your authentication keys, so that you don't lock yourself out of your accounts.
* App data. Save data of various applications or games.
** Of note are things like notes from your preferred notepad app, etc.
* Saved account information, in case you're logged into any accounts on your phone that you otherwise may not have access to.
==Android==
Note: Do not use Google Drive's "backup" to backup your phone, as it only backs up some app data among basic phone data like call logs and messages, but not all app data. Additionally the format is unknown and proprietary and there is no way to download this data except restoring it to Google's Android skin.
===Android 9 "Pie" and up===
1. Install Seedvault backup
2. In settings, choose to not have any quota
...
===rooted Android 4 "Ice Cream Sandwich" and up===
1. Enable developer mode by repeatedly tapping the build number in settings.
2. Enable USB debugging.
3. Download BusyBox from F-Droid: https://f-droid.org/packages/ru.meefik.busybox/
4. Install that file with adb install.
5. Run that app to install BusyBox.
6. Run `adb exec-out "su -c tar --exclude=proc --exclude=sys -c / 2> /dev/null" > rootdir.tar` on the host device (i.e. not the phone).
Note that this will also exclude other files or folders named "proc" or "sys", not just those direcly in the root directory. If you know how to exclude /proc and /sys without excluding other files and folders named "proc" or "sys", please edit the wiki to describe how!
7. Make sure the backup can open correctly and contains files!
Backup and restore your data

This article explains how to backup and restore your data.
== rsync ==
A method that works regardless of which UI is installed, is using the tried and tested command-line program rsync.
=== Backing up data ===
Make sure is installed on your phone and PC before you begin and SSH is enabled.
On your PC, create a folder where you want to backup your phone data too. In our example we'll use ~/postmarketOS_backup.
 $ mkdir ~/postmarketOS_backup
 $ rsync -avz --exclude=.cache <ip address of your phone>:/home/<your username>/ ~/postmarketOS_backup/
Example:
 $ rsync -avz --exclude=.cache user@172.16.42.1:/home/user/ ~/postmarketOS_backup
-a makes sure rsync runs in archive mode, -v increases verbosity so you can see the files being transferred, and -z compresses the files during transfer to speedup the transferring. --exclude=.cache makes sure the ~/.cache directory is skipped, as those files are temporary and do not need backing up, unless the purpose of the backup is for incident response or manual malware analysis, in which you exclude the exclusion flag.
You can now see all your files from your phone on your PC in ~/postmarketOS_backup
If you make a full system backup, make sure to exclude --exclude=/sys/devices/platform/ to prevent unwanted shutdowns or reboots.
=== Restoring data ===
After making sure your upgraded or new installation is running properly it's time to restore the data you backed up earlier. Make sure is still installed and SSH is still enabled.
From your PC:
 $ rsync -avzu ~/postmarketOS_backup/ <ip address of your phone>:/home/<your username>/
The single letter arguments to rsync are the same with the notable exception of -u. That arguments makes sure files that are newer on the destination (phone) are skipped. This is mainly needed for cases where processes running on the phone constantly alter files (and are thus newer) like KDE's Baloo.
== See also ==
Backup and restore your packages
Category:Technical Reference
Backup and restore your packages

This article explains how to backup and restore your packages.
= Backuping packages =
On source device.
Backup list of installed packages into a text file.
$ apk info > /path/to/my_apk_backup.txt
= Restoring packages =
On destination device.
Install packages from a text file.
# while read -r line; do apk add $line; done < /path/to/my_apk_backup.txt
== See also ==
Backup and restore your data
Category:Guide
Banana Pi BPI-M2 Zero (bananapi-bpi-m2-zero)

== Additional notes ==
* WiFi and dhcpd with NetworkManager is stable as of 
== Contributors ==
* User0
== Users owning this device ==
== How to enter flash mode and flash the device ==
Connect an microSD card to your PC and follow the steps below.
Use pmbootstrap to flash to the microSD card: 
 pmbootstrap init # select bananapi as manufacturer, bpi-m2-zero as device
 pmbootstrap install --sdcard=/dev/X # replace X with your microSD card blockdevice
== See also ==
* Official wiki page
* - Initial merge request
* 
*
Bananui

Bananui is a user interface for feature phones based on parts of Phosh and a custom UI toolkit. The name comes from the "Bananaphone" Nokia 8110 4G (nokia-argon), which it was originally designed for. It should also work on other feature phones that can run mainline Linux.
== Installation ==
Bananui can be installed by installing the package or selecting "bananui" as the interface in pmbootstrap.
Development files for the Bananui toolkit can be found in the package.
== Usage ==
Bananui shows a simple homescreen with a clock on startup. Pressing or on the D-Pad takes you to the app list. Pressing opens a quick settings panel which lets you adjust the screen brightness.
If your phone has a button, it can be used to open a shortcut menu that allows switching between open windows.
=== Making calls ===
Phone numbers can be dialed on the homescreen with the clock. Pressing places the call. Incoming calls can be accepted using the button. The button declines and hangs up calls.
=== Editing text ===
Text can be typed by repeatedly pressing a number key, which cycles through the letters assigned to the key. Pressing or another key commits the last character and lets you enter another character using the same key. The key (which is the same as on some phones) deletes the last character.
=== Useful keyboard shortcuts ===
* +: show quick settings panel
* +: show homescreen
* +: toggle virtual mouse cursor
== Development ==
Apps can be written using the Bananui toolkit, the documentation for which is available at https://obp.abscue.de/bananui/bananui.
== See also ==
* aports!52253 (merge request adding Bananui to aports)
Barns and Noble Nook HD+ (barnsnoble-ovation)

== Contributors ==
* FieryFlames
== Users owning this device ==
== Progress ==
* u-boot work needs converting to driver model to work on master u-boot
== See also ==
=== Internal links ===
* Texas Instruments OMAP 4 (OMAP44xx)
=== External links ===
* outdated existing u-boot port
* modified downstream kernel, also has interesting stuff like a 4.9 kernel
Barns and Noble Nook Tablet (barnsnoble-acclaim)

== Contributors ==
* NoriTech
== Maintainer(s) ==
NoriTech
== Users owning this device ==
== How to enter flash mode ==
Boot Cyanoboot off a micro SD card.
== Installation ==
To-do
== Status ==
Device won't load the kernel and will just endlessly bootloop, possibly needs Cyanoboot but could also be a nonfunctional kernel.
== More info ==
=== This doesn't seem to actually work, just leaving it up incase!! ===
Something I learned after taking apart the boot images for Cyanogenmod10, cyanoboot is just u-boot and the boot image is a kernel appended to u-boot.
Warning: Unknown if this works, still figuring it out.
A binwalk shows:
DECIMAL HEXADECIMAL DESCRIPTION
--------------------------------------------------------------------------------
0 0x0 Android bootimg, kernel size: 180500 bytes, kernel addr: 0x80F00000, ramdisk size: 4096 bytes, ramdisk addr: 0x80E3F090, product name: "BauwksBoot"
104676 0x198E4 U-Boot version string, "U-Boot 1.1.4-gb2da2b92 (Nov 23 2012 - 20:58:40)"
109512 0x1ABC8 CRC32 polynomial table, little endian
114951 0x1C107 Android bootimg, kernel size: 1869570560 bytes, kernel addr: 0x203A6974, ramdisk size: 543449442 bytes, ramdisk addr: 0x746F6F62, product name: "boot image magic"
262144 0x40000 Android bootimg, kernel size: 4510344 bytes, kernel addr: 0x80088000, ramdisk size: 249351 bytes, ramdisk addr: 0x81080000, product name: ""
266240 0x41000 Linux kernel ARM boot executable zImage (little-endian)
284560 0x45790 gzip compressed data, maximum compression, from Unix, last modified: 1970-01-01 00:00:00 (null date)
4780032 0x48F000 gzip compressed data, from Unix, last modified: 1970-01-01 00:00:00 (null date)
You can replace the kernel image at the end using dd with the decimal addresses:
dd if=zImage of=boot.img bs=1 count=4780032 seek=266240
== See also ==
* Files for this port (since it does not boot I will not make a PR)
Barns and Noble Nook Tablet 10.1 2018 (barnsnoble-bntv650)

== Contributors ==
== Users owning this device ==
== How to enter flash mode ==
Apply USB/power while holding the volume up button to get into BROM mode. See Mtkclient for more info.
Boot with the volume down button to enter fastboot (?)
== Installation ==
Use pmbootstrap to build your own installation image.
== See also ==