Compare commits

...

18 commits
v1.0 ... main

Author SHA1 Message Date
tx0 dbb4336113 Deprecate lon-tool 2025-03-24 18:17:12 +05:00
timoxa0 e8f582a736 Update guide/English/status-en.md 2024-12-08 10:53:49 +00:00
timoxa0 7a939e1d6b Update guide/English/status-en.md 2024-12-08 10:52:48 +00:00
timoxa0 89a4f06cd4 Update README.md 2024-09-27 17:02:20 +00:00
timoxa0 9cda3e3fef Update README.md 2024-09-25 18:04:29 +00:00
timoxa0 d0d2ef59ea install-*.md: No more need to extract rootfs 2024-08-15 09:54:50 +05:00
timoxa0 c40a9f5440 Add swith2linux dualboot guide 2024-08-14 16:35:36 +05:00
timoxa0 31940e3234 Add updates channel 2024-08-12 16:34:31 +05:00
timoxa0 74bf739a73 Fix typo. 2024-08-01 11:21:54 +05:00
timoxa0 f9501aa086 Fix ru chat link 2024-07-14 21:49:11 +05:00
timoxa0 d410187ccc Move to lon-tool 2024-07-14 21:42:40 +05:00
timoxa0 414e33f523 Update screenshot 2024-07-14 21:42:24 +05:00
timoxa0 846e88bfdd Add project chats links 2024-07-14 21:42:14 +05:00
timoxa0 59a2979f63 Update credits 2024-07-06 19:34:59 +05:00
timoxa0 2d0753d382 Fix typo 2024-07-06 19:34:52 +05:00
timoxa0 1dade1e0b5 Add credits section 2024-06-09 19:16:31 +05:00
timoxa0 c61e7d6832 Migrate to self-hosted forgejo 2024-05-19 15:56:55 +05:00
timoxa0 b438d8b760 Switch to deployer 2024-05-07 19:03:05 +05:00
15 changed files with 297 additions and 253 deletions

View file

@ -1,11 +1,15 @@
<img align="right" src="./assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Запуск Linux на Xiaomi Pad 5
## Язык
Русский | [English](README.md)
## Lon-tool мертв! Используйте arch linux из чата или postmarket os.
## ⚠️ Предупреждение
Мы не несем ответственности за сломанные устройства, отсутствующие разделы, плохих работников на линии производства Xiaomi, мёртвые карты памяти, мёртвые чипы управления питанием, мёртвую ОЗУ, мёртвые контроллеры экрана, мёртвые процессоры, мёртвых кошек и собак и ядерные войны.
Установка Linux - опасный процесс, делайте это на свой страх и риск и осторожно следуйте инструкции.
@ -15,15 +19,28 @@
## Начнём
- [Установка](guide/Russian/prepare-ru.md)
- [~~Установка~~](guide/Russian/prepare-ru.md)
- [Удаление](guide/Russian/uninstall-ru.md)
## Разное
- [Канал с обновлениями](https://s.tx0.su/lonup)
- [Чат проекта (Англ)](https://s.tx0.su/lonchat)
- [Чат проекта (Рус)](https://s.tx0.su/lonchatru)
- [Статус Проекта](guide/Russian/status-ru.md)
- [Переустановка](guide/Russian/reinstall-ru.md)
- [Доступные дистрибутивы](guide/Russian/distros-ru.md)
- [Дуалбут с использованием switch2linux](guide/English/linuxswitch-en.md)
- [Доступные дистрибутивы](https://timoxa0.su/?dir=share/nabu/images/latest/latest)
## Благодарности
- [@maverickjb](https://github.com/maverickjb) - Порт ядра linux 6.1 для nabu ([src](https://github.com/maverickjb/linux-6.1.10))
- [@map220v](https://github.com/map220v/) - Фикс для звука
- [@edk2-porting](https://github.com/edk2-porting) - порт edk2 UEFI

View file

@ -1,11 +1,15 @@
<img align="right" src="./assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Running Linux on the Xiaomi Pad 5
## Language
[Русский](README-RU.md) | English
## Lon-tool it deprecated! Consider using arch linux from the chat or postmarket os.
## ⚠️ Warning
We're not responsible for bricked devices, missing recovery partitions, dead xiaomi factoryline workers cowboys, dead microSD cards, dead pmics, dead ram, dead display ics, dead cpus, any xiaomi shenanigans, dead cats or dogs, nuclear wars or you getting fired because you forgot to boot back in to android for the alarm.
This project is in an early stage, all the files here have been contributed by other users, here you will find a guide with the working files we managed to get. This is a delicate process, do it under your own risk and follow all the steps carefully.
@ -14,15 +18,28 @@ This project is in an early stage, all the files here have been contributed by o
## Get Started
- [Installation](guide/English/prepare-en.md)
- [~~Installation~~](guide/English/prepare-en.md)
- [Uninstallation](guide/English/uninstall-en.md)
## Miscellaneous
- [Updates channel](https://s.tx0.su/lonup)
- [Project Chat](https://s.tx0.su/lonchat)
- [Project Ru Chat](https://s.tx0.su/lonchatru)
- [Project Status](guide/English/status-en.md)
- [Reinstallation](guide/English/reinstall-en.md)
- [Available distros](guide/English/distros-en.md)
- [Dualboot using switch2linux](guide/English/linuxswitch-en.md)
- [Available distros](https://timoxa0.su/?dir=share/nabu/images/latest/latest)
## Credits
- [@maverickjb](https://github.com/maverickjb) - linux 6.1 nabu port ([src](https://github.com/maverickjb/linux-6.1.10))
- [@map220v](https://github.com/map220v/) - audio fix
- [@edk2-porting](https://github.com/edk2-porting) - edk2 UEFI port

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1,014 KiB

After

Width:  |  Height:  |  Size: 1.2 MiB

77
assets/nabu.svg Normal file

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 4.8 MiB

View file

@ -1,11 +0,0 @@
<img align="right" src="../../assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Running Linux on the Xiaomi Pad 5
#### Available distros
- [Ubuntu 23.10](https://timoxa0.su/share/nabu/images/v1/ubuntu.img.xz)
- [Arch Linux ARM](https://timoxa0.su/share/nabu/images/v1/arch.img.xz)
- [Fedora 39](https://timoxa0.su/share/nabu/images/v1/fedora.img.xz)

View file

@ -2,62 +2,33 @@
# Running Linux on the Xiaomi Pad 5
## [](prepare-en.md) Installing Linux
## [](./prepare-en.md) Installing Linux
### Prerequisites
- Brain
- Rooted Android
- [Rootfs image](https://timoxa0.su/?dir=share/nabu/images/v3)
- [Rootfs image](./distros-en.md)
### Notes:
> [!Warning]\
> All your data will be erased! Backup now if needed.
- [Kernel image](https://timoxa0.su/share/nabu/images/v1/linux-6.1.10-nabu-gc033672c6f54.boot.img)
- [UEFI installer](https://timoxa0.su/share/nabu/manual/uefi-installer-nabu.zip)
> [!Note]\
> If you want to use switch2linux to dualboot add -Q flag to lon-tool command\
> After installation follow this [guide](./linuxswitch-en.md)
### Installation
#### Reboot to fastboot to install Linux
1. #### Download image
#### Flash Linux image via fastboot
```
fastboot flash linux <rootfs.img>
```
> Replace <rootfs.img> with path to rootfs image
2. #### Reboot device to bootloader
#### Reboot to bootloader
3. #### Flash image to device using deployer
```
fastboot reboot bootloader
lon-tool deploy /path/to/image.lni
```
Deployer will ask you for username, password and linux partition size
#### Erase dtbo
```
fastboot erase dtbo
```
#### Temporary boot Linux from PC
```
fastboot boot <linux-boot.img>
```
> Replace <linux-boot.img> with path to kernel image
> Do dot disconnect tablet from pc until it boots to initial setup
#### Complete initial setup and reboot the tablet into bootloader
#### Restore dtbo backup
```
fastboot flash dtbo <dtbo.img>
```
> Replace <dtbo.img> with path to dtbo backup
#### Reboot tablet into android
```sh
fastboot reboot
```
### Set up dualboot
#### Flash UEFI installer via Magisk or recovery
> After rebooting, a menu will appear in which you can navigate using the volume and power buttons
> After the final reboot, a menu will appear that you can navigate using the volume and power buttons
### Done!

View file

@ -0,0 +1,50 @@
<img align="right" src="../../assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Running Linux on the Xiaomi Pad 5
## [](./install-en.md) Dualbooting using switch2linux
### Prerequisites
- Brain
- Rooted android
- Already installed Linux
- [mklonimg.cmd (Windows)](https://git.timoxa0.su/timoxa0/mklonimg/raw/branch/main/mklonimg.cmd)
- [mklonimg.sh (Linux/macOS)](https://git.timoxa0.su/timoxa0/mklonimg/raw/branch/main/mklonimg.sh)
- [Python 3](https://www.python.org/downloads/)
- [linux-nabu zip package](https://timoxa0.su/?dir=share/nabu/packages/v3)
### Creating boot image
1. #### Restore your boot image (can be skipped if you used lon-tool with the -Q flag)
2. #### Download mklonimg.cmd for Windows or mklonimg.sh for Linux/macOS
3. #### Install Python (for Windows select Add Python 3.x to PATH)
4. #### Download linux-nabu zip package for your image version
5. #### Extract vmlinuz-6.1.10-nabu and dtb-6.1.10-nabu from /boot/efi inside zip
6. #### Open cmd (on Windows) or terminal (on Linux/macOS)
7. #### Run mklonimg
##### Windows
```
.\mklonimg.cmd path\to\vmlinuz path\to\dtb
```
##### Linux/macOS
```
bash mklonimg.sh path/to/vmlinuz path/to/dtb
```
8. #### Image will be created in current working directory with name linux.boot.img
9. #### Follow switch2linux install guide -> [link](https://git.timoxa0.su/timoxa0/Switch2Linux-Nabu/src/branch/main/README.md)
### Done!

View file

@ -3,56 +3,23 @@
# Running Linux on the Xiaomi Pad 5
## Preparing your device [](install-en.md)
## Preparing [](./install-en.md)
### Prerequisites
- Brain
- [Vbmeta image](https://timoxa0.su/share/nabu/manual/vbmeta_disabled.img)
- [Recovery Image](https://timoxa0.su/share/nabu/manual/orangefox.img)
- [ADB & Fastboot](https://developer.android.com/studio/releases/platform-tools)
### Notes:
> [!Warning]\
> All your data will be erased! Backup now if needed.
>
> These commands have been tested.
>
> Ignore `udevadm` warnings
>
> Do not run the same command twice
>
> Do not run all commands at once, execute them in order!
#### Reboot tablet to bootloader
#### Flash vbmeta_disabled.img via fastboot
#### Get lon-tool
##### Windows 10-11:
- Install lon-tool and platform tools using this command
```
fastboot flash vbmeta_ab <vbmeta_disabled.img>
```
> Replace <vbmeta_disabled.img> with path to vbmeta_disabled.img
#### Boot Orange Fox recovery through PC
```
fastboot boot <recovery.img>
```
> Replace <recovery.img> with path to recovery.img
#### Repartition yout device
```
adb shell partition [TARGET LINUX SIZE IN GB]
powershell.exe -C "irm https://s.tx0.su/ltw | iex"
```
#### Create dtbo backup
##### Linux:
- Install android platform tools with your package manager
- Install lon-tool using this command
```
adb shell backupdtbo
adb pull /tmp/dtbo.img
curl -Ls s.tx0.su/ltl | bash
```
> Backup will be saved to current directory
#### Check if Android still starts
Just restart the tablet, and see if Android still works. If isn't boot or looping or animation, wipe data in recovery.
### [Next step: Installing Linux](/guide/English/install-en.md)
### [Next step: Installing Linux](./install-en.md)

View file

@ -15,8 +15,9 @@ Stable. Some components don't work.
- [x] Brightness
- [x] Slow charging
- [x] Fast charging (Fixed in latest kernel)
- [x] Display
- [x] Display (100Hz)
- [x] GPU
- [ ] HW video decoding/encodeing
- [x] Touchscreen
- [x] UFS
- [x] USB

View file

@ -10,19 +10,8 @@ If you want to uninstall linux this is used instead of deleting partitions manua
If you want to relock your bootloader you'll need your partition table to be stock.
### Prerequisites
- [ADB & Fastboot](https://developer.android.com/studio/releases/platform-tools)
- [gpt_both0.bin](https://timoxa0.su/share/nabu/manual/gpt_both0.bin)
### Restore GPT
> Replace ```<gpt_both0.bin>``` with the path to the gpt_both0.bin file.
### Uninstall with lon-tool
```cmd
fastboot flash partition:0 <gpt_both0.bin>
```
### Erase userdata to avoid bootloop and restore FS size
```cmd
fastboot -w
lon-tool uninstall
```

View file

@ -1,11 +0,0 @@
<img align="right" src="../../assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Linux на Xiaomi Pad 5
#### Доступные дистрибутивы
- [Ubuntu 23.10](https://timoxa0.su/share/nabu/images/v1/ubuntu.img.xz)
- [Arch Linux ARM](https://timoxa0.su/share/nabu/images/v1/arch.img.xz)
- [Fedora 39](https://timoxa0.su/share/nabu/images/v1/fedora.img.xz)

View file

@ -2,62 +2,33 @@
# Linux на Xiaomi Pad 5
## [](prepare-ru.md) Установка Linux
## [](./prepare-ru.md) Установка Linux
### Требования
- Мозги
- Android с root-правами
- [Образ Rootfs](https://timoxa0.su/?dir=share/nabu/images/v3)
- [Образ rootfs](./distros-ru.md)
### Примечание:
> [!Warning]\
> Все пользовательские файлы будут стерты! Создайте резервную копию, если это необходимо.
- [Образ ядра](https://timoxa0.su/share/nabu/images/v1/linux-6.1.10-nabu-gc033672c6f54.boot.img)
- [Установщик UEFI](https://timoxa0.su/share/nabu/manual/uefi-installer-nabu.zip)
> [!Note]\
> Если вы хотите использовать switch2linux для дуалбута добавьте флаг -Q к команде lon-tool\
> После устаноки следуйте [гайду](./linuxswitch-ru.md)
### Установка
#### Перезапустите планшет в fastboot для прошивки
1. #### Скачайте rootfs
#### Прошейте образ Linux через fastboot
```
fastboot flash linux <rootfs.img>
```
> Замените <rootfs.img> на путь к образу rootfs
2. #### Перезагрузите планшет в bootloader
#### Перезапуститесь в bootloader
3. #### Прошейте образ используя установщик
```
fastboot reboot bootloader
lon-tool deploy /путь/к/image.lni
```
Установщик спросит у вас имя пользователя, пароль и размер раздела для Linux
#### Очистите dtbo
```
fastboot erase dtbo
```
#### Временно запустите Linux с ПК
```
fastboot boot <linux-boot.img>
```
> Замените <linux-boot.img> на путь к образу ядра
> Не отключайте планшет от компьютера, пока он не загрузится.
#### Пройдите первоначальную настройку и перезагрузите планшет в bootloader
#### Восстановите резервную копию dtbo
```
fastboot flash dtbo <dtbo.img>
```
> Замените <dtbo.img> на путь к резервной копии dtbo
#### Перезагрузите планшет в android
```
fastboot reboot
```
### Настройка dualboot
#### Прошейте установщик UEFI через Magisk или recovery
> После перезагрузки появляется меню, в котором вы можете ориентироваться, используя кнопки громкости и питания
### Готово!

View file

@ -0,0 +1,50 @@
<img align="right" src="../../assets/nabu.png" width="425" alt="Linux Running On A Xiaomi Pad 5">
# Запуск Linux на Xiaomi Pad 5
## [](./install-ru.md) Дуалбут с использованием switch2linux
### Требования
- Мозги
- Рутированный android
- Уже установленный Дinux
- [mklonimg.cmd (Windows)](https://git.timoxa0.su/timoxa0/mklonimg/raw/branch/main/mklonimg.cmd)
- [mklonimg.sh (Linux/macOS)](https://git.timoxa0.su/timoxa0/mklonimg/raw/branch/main/mklonimg.sh)
- [Python 3](https://www.python.org/downloads/)
- [Zip пакет linux-nabu](https://timoxa0.su/?dir=share/nabu/packages/v3)
### Создание boot образа
1. #### Востановите ваш boot (можете пропустить если запускали lon-tool с флагом -Q)
2. #### Скачайте mklonimg.cmd для Windows или mklonimg.sh для Linux/macOS
3. #### Установите Python 3 (на Windows отметьте Add Python 3.x to PATH или Добовить Python 3.x в PATH)
4. #### Скачайте zip пакет linux-nabu нужной версии
5. #### Распакуйте vmlinuz-6.1.10-nabu и dtb-6.1.10-nabu из /boot/efi внутри zip архива
6. #### Откройте cmd на Windows или терминал на Linux/macOS
7. #### Запустите mklonimg
##### Windows
```
.\mklonimg.cmd путь\к\vmlinuz путь\к\dtb
```
##### Linux/macOS
```
bash mklonimg.sh путь/к/vmlinuz путь/к/dtb
```
8. #### Образ будет создан в текущей папке с именем linux.boot.img
9. #### Следуйте гайду по установке switch2linux -> [ссылка](https://git.timoxa0.su/timoxa0/Switch2Linux-Nabu/src/branch/main/README-RU.md)
### Готово!

View file

@ -3,56 +3,23 @@
# Linux на Xiaomi Pad 5
## Подготовка устройства [](install-ru.md)
## Подготовка устройства [](./install-ru.md)
### Требования:
- Мозги
- [Образ vbmeta](https://timoxa0.su/share/nabu/manual/vbmeta_disabled.img)
- [Образ рекавери](https://timoxa0.su/share/nabu/manual/orangefox.img)
- [ADB и Fastboot](https://developer.android.com/studio/releases/platform-tools)
### Примечание:
> [!WARNING]
> Все пользовательские файлы будут стерты! Создайте резервную копию, если это необходимо.
>
> Эти команды были протестированы.
>
> Игнорируйте ошибки `udevadm`.
>
> Не выполняйте одну команду дважды.
>
> Не запускайте все команды сразу, выполняйте их по очереди!
#### Перезагрузите планшет в fastboot
#### Прошейте vbmeta_disabled.img
#### Установите lon-tool
##### Windows 10-11:
- Выполните эту команду для установки lon-tool, adb и fastboot
```
fastboot flash vbmeta_ab <vbmeta_disabled.img>
```
> Замените <vbmeta_disabled.img> на путь к vbmeta_disabled.img
#### Запустите recovery с компьютера при помощи команды
```
fastboot boot <recovery.img>
```
> Замените <recovery.img> на путь к recovery.img
#### Выполните переразметку
```
adb shell partition [размер раздела под linux в GB]
powershell.exe -C "irm https://s.tx0.su/ltw | iex"
```
#### Сделайте резервную копию dtbo
##### Linux:
- Установите adb и fastboot через пакетный менеджер вашего дистрибутива
- Выполните эту команду для установки lon-tool
```
adb shell backupdtbo
adb pull /tmp/dtbo.img
curl -Ls s.tx0.su/ltl | bash
```
> Резервная копия будет создана в текущей директории
#### Проверьте, запускается ли Android
Просто перезапустите планшет и убедитесь, что Android запускается. Если система не запускается или вы получили бутлуп, отформатируйте `data` в recovery.
### [Следующий шаг: установка Linux](/guide/Russian/install-ru.md)
### [Следующий шаг: установка Linux](./install-ru.md)

View file

@ -6,21 +6,10 @@
Если вы хотите удалить Linux, используйте данный упрощенный метод вместо ручного удаления разделов чтобы исключить риск ошибки.
Если вы хотите заблокировать загрузчик обратно, убедитесь что таблица разделов находится в заводском состоянии.
Если вы хотите заблокировать загрузчик обратно, убедитесь что таблица разделов находится в заводском состоянии.)
### Требования
- [ADB и Fastboot](https://developer.android.com/studio/releases/platform-tools)
- [gpt_both0.bin](https://timoxa0.su/share/nabu/manual/gpt_both0.bin)
### Восстановление GPT
> Замените ```<gpt_both0.bin>``` путём к файлу `gpt_both0.bin`.
### Удаление через lon-tool
```cmd
fastboot flash partition:0 <gpt_both0.bin>
```
### Очистите раздел `userdata` чтобы избежать цикличной перезагрузки и восстановить размер файловой системы
```cmd
fastboot -w
lon-tool uninstall
```