diff --git a/docs/en/instalations/booting/index.md b/docs/en/instalations/booting/index.md index 4b19a71..aa26bdf 100644 --- a/docs/en/instalations/booting/index.md +++ b/docs/en/instalations/booting/index.md @@ -1,7 +1,69 @@ -# Installing or update loader +# Tow-Boot - +## Installing Tow-Boot on Pine Phone Pro -## Installing Tow-Boot +### Writing the Tow-Boot image to an SD card using the graphical interface: - \ No newline at end of file +- Unpack the downloaded ALT Mobile image. +- Use gnome-disk-utility to write the image to the SD card: + - Open gnome-disks and select the SD card. + - Format the card and select the "Restore Disk Image" option. + - Specify the unpacked image and begin the writing process. + +### Writing the Tow-Boot image to an SD card via terminal: + +- Write it to an SD card, where /dev/XXX is your SD + card (replace XXX with your details): + +```Shell +dd if=spi.installer.img of=/dev/XXX bs=1M oflag=direct,sync status=progress +``` + +- After writing the Tow-Boot image to the SD card, follow these steps: + +**Note:** If you are not sure that the battery is fully charged, it is recommended to connect the phone to a power source. + +### Installation process + +- The process of installing Tow-Boot on Pinephone Pro is well explained in this [video](https://yandex.ru/video/preview/7204406835731215668) + +1. Turn off the Pinephone Pro. +2. Remove the battery from the device. +3. Insert the SD card with the Tow-Boot image into the SD card slot. +4. Reinsert the battery into the Pinephone Pro. +5. Press and hold the RE button while turning on the device. +6. Keep holding the RE button until the phone vibrates and the LED indicator turns red. It might be more convenient to connect the phone to a power source via USB than to press the power button. +7. After turning on with the Tow-Boot image, the phone will vibrate slightly, the LED indicator will light up red and then turn yellow after a short time. +8. After a while, the screen will turn on showing a blue color or directly load into the graphical installer interface. +9. In the graphical installer interface, select "Install Tow-Boot to SPI", connect the charger to the phone, and press the "Start installation" button. + +**Note:** Erasing the storage before installation is not required. The erasing option can be used to remove Tow-Boot (or any other firmware installed in the SPI partition). + +# Additional + +### Default Account Data + +- Default logins: root: `root`, password: `altlinux`; user: `altlinux`, password: `271828`. + +### Boot Order in Pinephone Pro + +In the Pinephone Pro, the following boot order is used by default: + +1. **SPI flash:** The first source for the bootloader search is the SPI flash. If a bootloader is installed there (such as Tow-Boot or U-Boot), it will be used to boot the system. +2. **Internal memory (eMMC):** If the bootloader is not found in the SPI flash, the device will attempt to boot from the internal eMMC memory. +3. **MicroSD card:** If there is no bootloader in the SPI flash and eMMC, the system will try to boot from the microSD card. + +**Choosing the Boot Source:** + +- In the **Explorer Edition, ordered after November 2023**, the microSD card boots first due to the use of rk2aw instead of Tow-Boot. +- In the **Explorer Edition, ordered after July 2022**, hold the volume down button while turning on the device. These devices come with Tow-Boot firmware for SPI. +- In the **Explorer Edition, ordered from January to July 2022**, hold the RE button under the cover for a few seconds when turning on the device. Older batches require re-flashing of Tow-Boot. + +This boot order and the ability to choose the boot source provide flexibility in using the Pinephone Pro, allowing easy switching between different operating systems installed on various media. + +Possible Issues + +**Problems with eMMC flashing:** + +- If you experience connectivity issues, try flipping the Type-C connector. +- Ensure that you are using the appropriate port and cable. \ No newline at end of file diff --git a/docs/en/instalations/mobile-device/index.md b/docs/en/instalations/mobile-device/index.md index ae02ec4..bdf5bf1 100644 --- a/docs/en/instalations/mobile-device/index.md +++ b/docs/en/instalations/mobile-device/index.md @@ -1,7 +1,93 @@ -# Instalition ALT Mobile +# ALT Mobile Pinephone / Pinephone Pro - +This section is dedicated to the installation of the ALT Mobile system on devices such as Pinephone and Pinephone Pro and other important information that may be useful during the installation process. -## Installation ALT Mobile on Pinephone / Pinephone Pro +## Installing ALT Mobile on Pinephone / Pinephone Pro - +### Downloading ALT Mobile Image + +- The ALT Mobile image can be downloaded from [ftp](http://beta.altlinux.org/mobile/latest/). We need images starting with "pinephone", for example, `pinephone-phosh-20231123-aarch64.img.xz`. + +### Installing on Internal Memory (emmc) + +**Preparing the Phone:** + +- Make sure your Pine Phone has the tow-boot loader installed on the SPI flash. +- To boot the phone in emmc export mode as a USB drive, hold the Volume Up button while turning it on. + +**Graphical Method of Installation:** + +- Unpack the downloaded ALT Mobile image. +- Use gnome-disk-utility to write the image to the SD card: +- Open gnome-disks and select your Pinephone’s USB drive. +- Format it and select the "Restore Disk Image" option. +- Specify the unpacked image and begin the writing process. +- After writing, it is recommended to extend the system partition. For this, choose the "Resize" option. + +**Installing ALT Mobile on emmc via Terminal:** + +- Execute the command where `sdX` is your Pinephone’s drive (replace X with your specific data): + +```Shell +xzcat pinephone-phosh-latest-aarch64.img.xz | dd of=/dev/sdX oflag=direct,sync iflag=fullblock bs=1M status=progress +``` +- It is recommended to increase the size of the file system, which can be done with the commands: + +``` +echo ", +" | sfdisk -N 1 /dev/sdX +resize2fs -p /dev/sdX1 +``` +- After completing the procedure, restart the device to boot from the new system. + +### Installing on SD Card + +**Graphical Method of Installation:** + +- Unpack the downloaded ALT Mobile image. +- Use gnome-disk-utility to write the image to the SD card: +- Open gnome-disks and select the SD card. +- Format the card and select the "Restore Disk Image" option. +- Specify the unpacked image and begin the writing process. + +**Installing via Terminal:** + +- Use the `dd` command to write the ALT Mobile image to the SD card: +```Shell + xzcat your-image-file.img.xz | dd of=/dev/sdX oflag=direct,sync iflag=fullblock bs=1M status=progress +``` +- After completing the writing process, remove the card from the computer and insert it into the Pine Phone. +- To boot from the SD card, hold down the Volume Down button while turning on the phone. + +### Installing Tow-Boot on Pinephone Pro + +- Download the Tow-Boot installer image from the [release page](https://github.com/Tow-Boot/Tow-Boot/releases/tag/release-2022.07-006). Search for an image according to your device model. + +## Additional Information + +### Standard Account Data + +- Default logins: root: `root`, password: `altlinux`; user: `altlinux`, password: `271828`. + +### Boot Order in Pinephone Pro + +In Pinephone Pro, the following default boot order is used: + +1. **SPI flash:** The first source to search for a bootloader is the SPI flash. If a bootloader (such as Tow-Boot or U-Boot) is installed there, it will be used to boot the system. +2. **Internal Memory (eMMC):** If no bootloader is found in SPI flash, the device will attempt to boot from the internal eMMC memory. +3. **MicroSD Card:** In the absence of a bootloader in SPI flash and on eMMC, the system will attempt to boot from the microSD card. + +**Choosing the Boot Source:** + +- In **Explorer Edition, ordered after November 2023**, the microSD card boots first due to the use of rk2aw instead of Tow-Boot. +- In **Explorer Edition, ordered after July 2022**, hold the volume down button during the device's power-on. These devices come with Tow-Boot firmware for SPI. +- In **Explorer Edition, ordered from January to July 2022**, hold the RE button under the cover for a few seconds when powering on the device. Older batches require Tow-Boot firmware reflashing. + +This boot order and the ability to choose the boot source provide flexibility in using the Pinephone Pro, allowing easy switching between different operating systems installed on various media. + +## Possible Issues + + +**Problems with emmc firmware:** + +- If there are connection issues, try reversing the Type-C connector. +- Ensure you are using the appropriate port and cable. \ No newline at end of file diff --git a/docs/en/instalations/virtual-machine/index.md b/docs/en/instalations/virtual-machine/index.md index 2e2d628..a8bb57d 100644 --- a/docs/en/instalations/virtual-machine/index.md +++ b/docs/en/instalations/virtual-machine/index.md @@ -1,3 +1,79 @@ -# Installing ALT Mobile on a virtual machine +# ALT Mobile Virtual Machine - \ No newline at end of file +## Installing ALT Mobile on a Virtual Machine + +### Downloading the ALT Mobile Image + +The ALT Mobile operating system image can be downloaded from: +[ftp](http://beta.altlinux.org/mobile/latest/) + +Please select the image format as: + +- **phosh-20231004-x86_64.img.xz** + +**Note:** For virtualization purposes, an image with x86_64 architecture is required. Images for architectures aarch64 and risc-v are also supported and can be used in a similar manner. + +Extract the downloaded image to a convenient location, for example: + +- `/home/petr/images/phosh-20231004-x86_64.img` + +### Configuration and Launch in Qemu + +#### With Acceleration (Qemu-KVM) + +1. Install Qemu-KVM: +```Shell +apt-get install /usr/bin/qemu-kvm +``` + +2. Start the system as a regular user (not as root): +```Shell +kvm -m 4G -k en-gb -hda /home/petr/images/phosh-20231004-x86_64.img +``` + +Here: + +- `kvm` - indicates that it is run using qemu-kvm +- `-m 4G` - 4 GB of RAM will be allocated for the machine +- `-k en-gb` - an English keyboard layout will be used +- `-hda /home/user/images/phosh-20231004-x86_64.img` - path to our image + +Instructions for running images for +[aarch64](https://www.altlinux.org/Ports/aarch64/QEMU) +and [riscv64](https://www.altlinux.org/Ports/riscv64/QEMU) + +3. To work with the graphical interface, install and use remote-viewer: +```Shell +apt-get install /usr/bin/remote-viewer +remote-viewer vnc://localhost:5900 +``` + +#### Without Acceleration + +1. Install Qemu and the SDL interface: +```Shell +apt-get install qemu-system-x86 qemu-ui-sdl +``` +2. Start the system as a regular user: +```Shell +qemu-system-x86_64 -m 4G -k en-gb -hda /home/petr/images/phosh-20231004-x86_64.img -smp cpus=4 -net user +``` +Here: + +- `qemu-system-x86_64` - indicates that we are emulating an x86_64 computer +- `-m 4G` - 4 GB of RAM will be allocated for the machine +- `-k en-gb` - an English keyboard layout will be used +- `-hda /home/user/images/phosh-20231004-x86_64.img` - path to our image +- `-smp cpus=4` - 4 CPU cores will be used +- `-net user` - the computer's network will be used + +### Result + +After launching the system in QEMU, you will be able to control the ALT Mobile interface using the mouse, simulating finger input, as well as enter characters from a physical keyboard. Note that when using a virtual machine, access to hardware functions like telephony, camera, and other devices will be limited. Nonetheless, the virtual machine is an excellent tool for adapting and testing applications under the ALT Mobile interface. + +## Additional + +### Standard Account Information + +- Default logins: root: `root`, password: `altlinux`; user: `altlinux`, + password: `271828`. \ No newline at end of file diff --git a/docs/instalations/booting/index.md b/docs/instalations/booting/index.md index c37eac9..41f68db 100644 --- a/docs/instalations/booting/index.md +++ b/docs/instalations/booting/index.md @@ -1,7 +1,98 @@ -# Загрузчик +# Tow-Boot - +## Установка Tow-Boot на Pine Phone Pro -## Установка Tow-Boot +### Запись образа Tow-Boot на SD карту через графический интерфейс: - \ No newline at end of file +- Распакуйте скаченный образ ALT Mobile. +- Используйте gnome-disk-utility для записи образа на SD карту: +- Откройте gnome-disks и выберите SD карту. +- Отформатируйте карту и выберите пункт "Восстановить образ системы". +- Укажите распакованный образ и начните процесс записи. + +### Запись образа Tow-Boot на SD карту через терминал: + +- Запишите его на SD карту, где /dev/XXX - это ваша SD + карта(необходимо заменить XXX на ваши данные): + +```Shell +dd if=spi.installer.img of=/dev/XXX bs=1M oflag=direct,sync status=progress +``` + +- После записи образа Tow-Boot на SD карту, выполните следующие шаги: + +**Примечание:** Если не уверены, что батарея полностью заряжена, +рекомендуется подключить телефон к источнику питания. + +### Процесс установки + +- Процесс установки Tow-Boot на Pinephone Pro хорошо изложен в данном + [видео](https://yandex.ru/video/preview/7204406835731215668) + +1. Выключите Pinephone Pro. +2. Извлеките батарею из устройства. +3. Вставьте SD карту с записанным образом Tow-Boot в слот для SD карт. +4. Верните батарею обратно в Pinephone Pro. +5. Предварительно удерживая кнопку RE включите устройство. +6. Удерживайте кнопку RE до тех пор, пока телефон не завибрирует, и + индикатор LED не загорится красным. Может быть удобнее подключить + телефон к источнику питания через USB, чем нажимать на кнопку + питания. +7. После включения с образом Tow-Boot, телефон слегка вибрирует, + индикатор LED загорится красным, а затем через короткое время - + желтым. +8. Через некоторое время экран включится, показывая синий цвет, или + напрямую загрузится в графический интерфейс установщика. +9. В графическом интерфейсе установщика выберите "Install Tow-Boot to + SPI", подключите зарядку к телефону и нажмите кнопку "Start + installation". + +**Примечание:** Стирание хранилища перед установкой не требуется. Опция +стирания может использоваться для удаления Tow-Boot (или любого другого +прошивочного ПО, установленного в раздел SPI). + + +# Дополнительно + +### Стандартные данные учётных записей + +- Логины по умолчанию: root: `root`, password: `altlinux`; user: `altlinux`, + password: `271828`. + +### Порядок загрузки в Pinephone Pro + +В Pinephone Pro используется следующий порядок загрузки по умолчанию: + +1. **SPI flash:** Первым источником для поиска загрузчика является SPI + flash. Если в нем установлен загрузчик (например, Tow-Boot или + U-Boot), он будет использоваться для загрузки системы. +2. **Внутренняя память (eMMC):** Если загрузчик не найден в SPI flash, + устройство попытается загрузиться с внутренней памяти eMMC. +3. **Карта microSD:** В случае отсутствия загрузчика в SPI flash и на + eMMC, система попытается загрузиться с карты microSD. + +**Выбор источника загрузки:** + +- В **Explorer Edition, заказанном после ноября 2023 года**, карта + microSD загружается первой из-за использования rk2aw вместо + Tow-Boot. +- В **Explorer Edition, заказанной после июля 2022 года**, удерживайте + клавишу уменьшения громкости во время включения устройства. Эти + устройства поставляются с прошивкой Tow-Boot для SPI. +- В **Explorer Edition, заказанном в период с января по июль 2022 + года**, удерживайте кнопку RE под крышкой в течение нескольких + секунд при включении устройства. Для старых партий требуется + перепрошивка Tow-Boot. + +Этот порядок загрузки и возможность выбора источника обеспечивают +гибкость в использовании Pinephone Pro, позволяя легко переключаться +между различными операционными системами, установленными на разных +носителях. + +Возможные проблемы + +**Проблемы при прошивке emmc:** + +- Если возникают проблемы с подключением, попробуйте перевернуть + разъем Type-C. +- Убедитесь, что используете подходящий порт и кабель. \ No newline at end of file diff --git a/docs/instalations/mobile-device/index.md b/docs/instalations/mobile-device/index.md index 000b43e..648516c 100644 --- a/docs/instalations/mobile-device/index.md +++ b/docs/instalations/mobile-device/index.md @@ -1,7 +1,122 @@ -# Установка ALT Mobile +# ALT Mobile Pinephone / Pinephone Pro - +Данный блок посвящён установке системы ALT Mobile на устройства +Pinephone и Pinephone Pro и другой важной информации которая может пригодится при установке. ## Установка ALT Mobile на Pinephone / Pinephone Pro - \ No newline at end of file + +### Скачивание образа ALT Mobile + +- Образ ALT Mobile можно скачать c + [ftp](http://beta.altlinux.org/mobile/latest/), нам + необходимы образы начинающиеся с pinephone, к примеру + `pinephone-phosh-20231123-aarch64.img.xz`. + +### Установка на внутреннюю память (emmc) + +**Подготовка телефона:** + +- Убедитесь, что на вашем Pine Phone установлен загрузчик tow-boot на + SPI flash. +- Для загрузки телефона в режиме экспорта emmc как USB-диска, при + включении зажмите кнопку Volume Up. + +**Графический способ установки:** + +- Распакуйте скаченный образ ALT Mobile. +- Используйте gnome-disk-utility для записи образа на SD карту: +- Откройте gnome-disks и выберите USB-диск вашего Pinephone. +- Отформатируйте его и выберите пункт "Восстановить образ системы". + - Укажите распакованный образ и начните процесс записи. + - После записи рекомендуется расширить системный раздел. Для этого выберите пункт "Изменить размер" + +**Запись образа ALT Mobile на emmc через терминал:** + +- Выполните команду, где `sdX` - это накопитель вашего + Pinephone(необходимо заменить X на ваши данные): + +```Shell +xzcat pinephone-phosh-latest-aarch64.img.xz | dd of=/dev/sdX oflag=direct,sync iflag=fullblock bs=1M status=progress +``` +- Рекомендуется увеличить размер файловой системы, это можно сделать + командами: + +``` +echo ", +" | sfdisk -N 1 /dev/sdX +resize2fs -p /dev/sdX1 +``` +- После завершения процедуры, перезагрузите устройство для запуска с + новой системой. + +### Установка на SD карту + +**Графический способ установки:** + +- Распакуйте скаченный образ ALT Mobile. +- Используйте gnome-disk-utility для записи образа на SD карту: +- Откройте gnome-disks и выберите SD карту. +- Отформатируйте карту и выберите пункт "Восстановить образ системы". +- Укажите распакованный образ и начните процесс записи. + +**Установка через терминал:** + +- Используйте команду `dd` для записи образа ALT Mobile на SD карту: +```Shell + xzcat your-image-file.img.xz | dd of=/dev/sdX oflag=direct,sync iflag=fullblock bs=1M status=progress +``` +- После завершения записи, извлеките карту из компьютера и вставьте её + в Pine Phone. +- Для загрузки с SD карты, при включении телефона зажмите кнопку + Volume Down. + +### Установка Tow-Boot на Pinephone Pro + +- Скачайте образ установщика Tow-Boot со [страницы + релизов](https://github.com/Tow-Boot/Tow-Boot/releases/tag/release-2022.07-006). Образ установщика ищем согласно модели вашего устройства. + +## Дополнительно + +### Стандартные данные учётных записей + +- Логины по умолчанию: root: `root`, password: `altlinux`; user: `altlinux`, + password: `271828`. + +### Порядок загрузки в Pinephone Pro + +В Pinephone Pro используется следующий порядок загрузки по умолчанию: + +1. **SPI flash:** Первым источником для поиска загрузчика является SPI + flash. Если в нем установлен загрузчик (например, Tow-Boot или + U-Boot), он будет использоваться для загрузки системы. +2. **Внутренняя память (eMMC):** Если загрузчик не найден в SPI flash, + устройство попытается загрузиться с внутренней памяти eMMC. +3. **Карта microSD:** В случае отсутствия загрузчика в SPI flash и на + eMMC, система попытается загрузиться с карты microSD. + +**Выбор источника загрузки:** + +- В **Explorer Edition, заказанном после ноября 2023 года**, карта + microSD загружается первой из-за использования rk2aw вместо + Tow-Boot. +- В **Explorer Edition, заказанной после июля 2022 года**, удерживайте + клавишу уменьшения громкости во время включения устройства. Эти + устройства поставляются с прошивкой Tow-Boot для SPI. +- В **Explorer Edition, заказанном в период с января по июль 2022 + года**, удерживайте кнопку RE под крышкой в течение нескольких + секунд при включении устройства. Для старых партий требуется + перепрошивка Tow-Boot. + +Этот порядок загрузки и возможность выбора источника обеспечивают +гибкость в использовании Pinephone Pro, позволяя легко переключаться +между различными операционными системами, установленными на разных +носителях. + +## Возможные проблемы + + +**Проблемы при прошивке emmc:** + +- Если возникают проблемы с подключением, попробуйте перевернуть + разъем Type-C. +- Убедитесь, что используете подходящий порт и кабель. \ No newline at end of file diff --git a/docs/instalations/virtual-machine/index.md b/docs/instalations/virtual-machine/index.md index 2a18732..527ba59 100644 --- a/docs/instalations/virtual-machine/index.md +++ b/docs/instalations/virtual-machine/index.md @@ -1,3 +1,89 @@ -# Установка ALT Mobile на виртуальную машину +# ALT Mobile Виртуальная машина - +## Установка ALT Mobile на виртуальную машину + +### Скачивание образа ALT Mobile + +Образ операционной системы ALT Mobile можно скачать с +[ftp](http://beta.altlinux.org/mobile/latest/) + +Выберите образ формата: + +- **phosh-20231004-x86\_64.img.xz** + +**Примечание:** Для целей виртуализации требуется образ с архитектурой +x86_64. Образы для архитектур aarch64 и risc-v также поддерживаются и +могут быть использованы аналогичным образом. + +Распакуйте скачанный образ в удобное для вас место, например: + +- `/home/petr/images/phosh-20231004-x86\_64.img` + +### Настройка и Запуск в Qemu + +#### С ускорением (Qemu-KVM) + +1. Установите Qemu-KVM: +```Shell +apt-get install /usr/bin/qemu-kvm +``` + +2. Запустите систему от обычного пользователя (не от root): +```Shell +kvm -m 4G -k en-gb -hda /home/petr/images/phosh-20231004-x86_64.img +``` + +Здесь: + +- `kvm` - указывает, что запускаем при помощи qemu-kvm +- `-m 4G` - для машины будет выделено 4 ГБ ОЗУ +- `-k en-gb` - будет использоваться английская раскладка +- `-hda /home/user/images/phosh-20231004-x86\_64.img` - путь к нашему образу + +Инструкции по запуску образов для +[aarch64](https://www.altlinux.org/Ports/aarch64/QEMU) +и [riscv64](https://www.altlinux.org/Ports/riscv64/QEMU) + +3. Для работы с графическим интерфейсом установите и используйте +remote-viewer: +```Shell +apt-get install /usr/bin/remote-viewer +remote-viewer vnc://localhost:5900 +``` + +#### Без ускорения + +1. Установите Qemu и интерфейс на SDL: +```Shell +apt-get install qemu-system-x86 qemu-ui-sdl +``` +2. Запустите систему от обычного пользователя: +```Shell +qemu-system-x86_64 -m 4G -k en-gb -hda /home/petr/images/phosh-20231004-x86_64.img -smp cpus=4 -net user +``` +Здесь: + +- `qemu-system-x86\_64`{style="font-family: monospace; color: #003300; background-color: #EEEEEE; font-weight: bold; font-size: normal;"} - + указывает, что мы эмулируем x86\_64 компьютер +- `-m 4G` - для машины будет выделено 4ГБ ОЗУ +- `-k en-gb` - будет использоваться английская раскладка +- `-hda /home/user/images/phosh-20231004-x86\_64.img` - путь к нашему образу +- `-smp cpus=4` - будет использовано 4 ядра процессора +- `-net user` - будет использована сеть компьютера + +### Результат + +После запуска системы в QEMU, вы сможете управлять интерфейсом ALT +Mobile с помощью мыши, имитируя ввод пальцами, а также вводить символы с +физической клавиатуры. Обратите внимание, что при использовании +виртуальной машины доступ к аппаратным функциям телефонии, камеры и +прочих устройств будет ограничен. Тем не менее виртуальная машина - +отличный инструмент для адаптации и тестирования приложений под +мобильный интерфейс ALT Mobile. + +## Дополнительно + +### Стандартные данные учётных записей + +- Логины по умолчанию: root: `root`, password: `altlinux`; user: `altlinux`, + password: `271828`. \ No newline at end of file