--- title: Linux на X96 Max Plus categories: - linux - cpp tags: - x96 max plus - linux - armbian - ender-3 - прошивка - программирование date: 2023-11-17T21:09:25+03:00 lastmod: 2024-04-26T23:04:24+03:00 draft: false featured_image: miniature.jpg telegram_entry_id: mmotium/9 --- Сегодня будем экономить на Raspberry Pi и поставим armbian на X96 Max Plus. > ⚠ **Прошу обратить внимание!** > > Моя модификация - **X96MaxPlus_2101**. Соответственно, действия описаны для этой модификации. > Для других модификаций действия могут отличаться. > > Подробнее о модификациях: [4pda](https://4pda.to/forum/index.php?showtopic=1013103&st=40#entry102780026) ## Подготовка USB накопителя Для начала скачиваем образ файловой системы для нужного процессора отсюда: [ophub/amlogic-s9xxx-armbian](https://github.com/ophub/amlogic-s9xxx-armbian/releases). Ищем в списке последний релиз для процессора s905x3. В момент написания статьи это был файл **Armbian_23.11.0_amlogic_s905x3_lunar_6.1.62_server_2023.11.12.img.gz**. Ищем USB флешку. Моя была на 8 ГБ (успешно загружался и с 16). С помощью какой-либо программы записываем образ диска на неё. Я использовал [Rufus](https://rufus.ie/ru/). Можно использовать что угодно, что умеет записывать сырой образ диска на накопитель (Balena Etcher / dd / etc.). В Rufus сразу выбираем .gz архив, программа сама его распаковывает в процессе записи. ![rufus](rufus.png) После записи образа на накопителе открываем раздел fat32, в нём файл `uEnv.txt`. Меняем имя файла в параметре FDT на `meson-sm1-x96-max-plus-2101.dtb`: ```diff LINUX=/zImage INITRD=/uInitrd -- FDT=/dtb/amlogic/meson-sm1-x96-max-plus-100m.dtb ++ FDT=/dtb/amlogic/meson-sm1-x96-max-plus-2101.dtb APPEND=root=UUID=a40af2d2-999f-4b37-98b6-973b0e6faf52 rootflags=data=writeback rw rootfstype=ext4 console=ttyAML0,115200n8 console=tty0 no_console_suspend consoleblank=0 fsck.fix=yes fsck.repair=yes net.ifnames=0 max_loop=128 cgroup_enable=cpuset cgroup_memory=1 cgroup_enable=memory swapaccount=1 ``` ## Загрузка с USB накопителя Вставляем USB накопитель в приставку с **отключенным питанием**, зажимаем Reset (находится внутри гнезда AV), подключаем питание, держим Reset ~5 секунд. {{< video src="firstrun.webm" >}} На видео нет логотипа стоковой прошивки, потому что на устройство был уже установлен armbian. После запуска скрипт предложит сконфигурировать систему. ![firsrun](firstrun.jpg) После предложения ввести новый пароль суперпользователя лучше немного подождать, так как система всё ещё загружается и будут выводиться сообщения из журнала, сбивающие с толку. Отвечаем на вопросы и завершаем установку. ## Установка на eMMC На данном этапе вся конфигурация сохраняется на **USB накопитель**. Для того, чтобы загрузить armbian нужно будет каждый раз нажимать reset при загрузке. Чтобы установить armbian на встроенный eMMC накопитель и загружаться с него нужно выполнить: ```bash armbian-install -m yes ``` Без параметра -m у меня отказывалась загружаться операционная система. Сам параметр расшифровывается как "Use Mainline u-boot" (см. [тут](https://github.com/ophub/amlogic-s9xxx-armbian/tree/main/documents#81-installation-method-for-amlogic-series)). При установке будет предложено выбрать устройство и файловую систему (я выбрал X96 Max Plus 2101 и ext4). После того, как скрипт завершит работу, вводим poweroff, извлекаем USB накопитель и переподключаем питание. Система теперь будет загружаться со встроенной памяти. Если приставка к Wi-Fi не подключена, то советую это сделать (с помощью armbian-config или nmcli). Через Ethernet подключить вроде как не получится, проблемы с драйвером. Если вы уже подключили приставку к Wi-Fi, то можно управлять ей с помощью ssh (в дистрибутиве уже настроен ssh сервер). ## Решение проблем с нестабильным Wi-Fi В процессе работы я начал наблюдать подобные сообщения ядра: ```bash [ 83.751980] ------------[ cut here ]------------ [ 83.754595] firmware failed to ack driver for entering Deep Power mode [ 83.760091] WARNING: CPU: 1 PID: 9 at drivers/net/wireless/realtek/rtw88/ps.c:106 rtw_power_mode_change+0x154/0x1a0 [rtw88_core] [ 83.771493] Modules linked in: cpufreq_userspace cpufreq_conservative cpufreq_powersave sunrpc hci_uart btqca btrtl btbcm btintel rtw88_8822cs rtw88_8822c rtw88_sdio rtw88_core bluetooth panfrost mac80211 gpu_sched snd_soc_meson_axg_sound_card drm_shmem_helper snd_soc_meson_card_utils snd_soc_meson_g12a_tohdmitx cfg80211 snd_soc_meson_axg_tdmout snd_soc_meson_codec_glue rfkill snd_soc_meson_axg_frddr libarc4 snd_soc_meson_axg_fifo zram ir_nec_decoder meson_gxbb_wdt meson_imeson_vdec(C) videobuf2_dma_contig v4l2_mem2mem snd_soc_meson_axg_tdm_interface snd_soc_meson_axg_tdm_formatter tcp_bbr sch_fq ip_tables x_tables hid_logitech_hidpp hid_logitech_dj [ 83.832293] CPU: 1 PID: 9 Comm: kworker/u8:0 Tainted: G C 6.1.62-ophub #1 [ 83.840398] Hardware name: AMedia X96 Max+ (DT) [ 83.844885] Workqueue: phy0 rtw_watch_dog_work [rtw88_core] [ 83.850404] pstate: 60400009 (nZCv daif +PAN -UAO -TCO -DIT -SSBS BTYPE=--) [ 83.857302] pc : rtw_power_mode_change+0x154/0x1a0 [rtw88_core] [ 83.863166] lr : rtw_power_mode_change+0x154/0x1a0 [rtw88_core] [ 83.869031] sp : ffffffc00a18bcc0 [ 83.872309] x29: ffffffc00a18bcc0 x28: ffffff800005bd00 x27: ffffff800000ec00 [ 83.879382] x26: ffffff80030908e0 x25: ffffff8003092080 x24: 0000000000000001 [ 83.886454] x23: 0000000000068dbc x22: 00000013843748d4 x21: 0000000000000001 [ 83.893527] x20: 0000000000000000 x19: ffffff8003092080 x18: ffffffffffffffff [ 83.900599] x17: 0000000000000004 x16: 0000000000000000 x15: 0000000000000006 [ 83.907671] x14: 0000000000000000 x13: ffffffc009d9ce50 x12: 0000000000000648 [ 83.914744] x11: 0000000000000218 x10: ffffffc009e4ce50 x9 : ffffffc009d9ce50 [ 83.921816] x8 : 00000000ffffdfff x7 : ffffffc009e4ce50 x6 : 0000000000000001 [ 83.928889] x5 : 0000000000000000 x4 : 0000000000000000 x3 : 0000000000000000 [ 83.935961] x2 : 0000000000000000 x1 : 0000000000000000 x0 : ffffff80000a7000 [ 83.943035] Call trace: [ 83.945810] rtw_power_mode_change+0x154/0x1a0 [rtw88_core] [ 83.950970] rtw_sdio_deep_ps+0x90/0xd0 [rtw88_sdio] [ 83.955886] rtw_enter_lps+0xf4/0x110 [rtw88_core] [ 83.960629] rtw_watch_dog_work+0x25c/0x270 [rtw88_core] [ 83.965890] process_one_work+0x1dc/0x370 [ 83.969858] worker_thread+0x168/0x4e0 [ 83.973567] kthread+0xd4/0xdc [ 83.976585] ret_from_fork+0x10/0x20 [ 83.980123] ---[ end trace 0000000000000000 ]--- ``` Связано это с проблемами входа wi-fi модуля в режим экономии энергии. Поэтому эту самую экономию мы отключим. Открываем файл `/etc/NetworkManager/conf.d/default-wifi-powersave-on.conf` и значение параметра `wifi.powersave` изменяем с 3 на 2: ```bash sudo nano /etc/NetworkManager/conf.d/default-wifi-powersave-on.conf ``` ```diff [connection] # Values are 0 (use default), 1 (ignore/don't touch), 2 (disable) or 3 (enable). -- wifi.powersave = 3 ++ wifi.powersave = 2 ``` После этого перезагружаемся (команда reboot). Проверить, отключилось ли энергосбережение можно командой: ```bash sudo iwconfig wlan0 | grep "Power Management" ``` Результат должен быть `Power Management:off`. ## Вывод произвольного текста на семисегментный дисплей В репозитории [ophub/amlogic-s9xxx-armbian](https://github.com/ophub/amlogic-s9xxx-armbian) описывается как включать или отключать индикаторы на дисплее (TL;DR: `sudo armbian-openvfd`). Однако нет информации как выводить произвольный текст вместо часов. После изучения исходников [сервиса openvfd](https://github.com/arthur-liberman/linux_openvfd/blob/3118dda3aeb5b2f02b0ac0b5d30cbef58947a805/OpenVFDService.c#L342-L357) стало понятно, что сервис использует канал по пути `/tmp/openvfd_service`. При записи в этот файл, сервис отключает вывод по умолчанию (часы) и выводит заданную информацию. Сама информация передаётся в виде структуры `vfd_display_data` (`openvfd_drv.h`). В этой структуре достаточно установить `mode = DISPLAY_MODE_TITLE` и заполнить `string_main`. Имея всю эту информацию я сделал небольшую программку, которая устанавливает произвольный текст на дисплее. Что нужно сделать? Клонировать репозиторий [arthur-liberman/linux_openvfd](https://github.com/arthur-liberman/linux_openvfd): ```bash git clone https://github.com/arthur-liberman/linux_openvfd ``` Перейти в директорию репозитория: ```bash cd linux_openvfd ``` Создаём исходный файл программы. Я назвал его `set-display-text.c`: ```bash nano set-display-text.c ``` Код: ```c #include #include #include #include #include #include "driver/openvfd_drv.h" #define SERVICE_PIPE "/tmp/openvfd_service" int main(int argc, char const *argv[]) { if (argc < 2) { fprintf(stderr, "Text not provided\n"); exit(1); } // Открыть именованный канал сервиса int service_fd = open(SERVICE_PIPE, O_RDWR); if (service_fd < 0) { perror("Open " SERVICE_PIPE " failed\n"); exit(1); } // Структура данных драйвера дисплея static struct vfd_display_data data; // Инициализировать структуру пустыми значениями memset(&data, 0, sizeof(data)); // Режим вывода на экран - произвольный текст data.mode = DISPLAY_MODE_TITLE; // Скопировать максимум 4 символа strncpy(data.string_main, argv[1], 4); data.string_main[5] = '\0'; // Записать в канал сервиса int written = write(service_fd, &data, sizeof(data)); if (written != sizeof(data)) { perror("Write failed\n"); } close(service_fd); return 0; } ``` Компилируем: ```bash gcc -O2 -Werror set-display-text.c -o set-display-text ``` На всякий случай оставлю тут собранный бинарник: [set-display-text](set-display-text) Проверяем. Сначала запускаем драйвер и сервис (если на экране уже что-то выводится, то сервис уже запущен!): ```bash sudo armbian-openvfd ``` Или ```bash sudo armbian-openvfd 12 ``` Где 12 - номер модели (x96maxplus s905x3). Далее проверяем нашу утилиту: ```bash sudo ./set-display-text lol ``` ![lol.jpg](lol.jpg) Если всё работает, то можно скопировать исполняемый файл в локальное окружение для того, чтобы можно было его выполнять из любого места: ```bash sudo cp set-display-text /usr/local/bin ``` ### Автозапуск драйвера и сервиса индикации Открываем файл автозапуска и меняем строки: ```bash sudo nano /etc/custom_service/start_service.sh ``` ```diff # Led display control -- openvfd_enable="no" ++ openvfd_enable="yes" -- openvfd_boxid="15" ++ openvfd_boxid="12" [[ "${openvfd_enable}" == "yes" && -n "${openvfd_boxid}" && -x "/usr/sbin/armbian-openvfd" ]] && { armbian-openvfd ${openvfd_boxid} && echo "[$(date +"%Y.%m.%d.%H:%M:%S")] The openvfd service started successfully." >>${custom_log} } ``` openvfd_boxid можно узнать выполнив `sudo armbian-openvfd`. ### Вывод текста на экран без root прав Так как каналу `/tmp/openvfd_service` не установлено никаких групп кроме root, то ничего не остается, кроме как разрешить пользователю выполнять команду через sudo без пароля. Для этого нужно создать файл `/etc/sudoers.d/allow-set-display-text-nopasswd` с содержимым `multimote ALL=(ALL) NOPASSWD: /usr/local/bin/set-display-text`, где: * allow-set-display-text-nopasswd - любое имя для правила * multimote - необходимое имя пользователя Создать правило одной командой: ```bash echo "multimote ALL=(ALL) NOPASSWD: /usr/local/bin/set-display-text" | sudo tee /etc/sudoers.d/allow-set-display-text-nopasswd ``` ### Отображение процентов печати в Klipper Мне не раз попадалась информация об установки klipper на тв-приставки. [Klipper](https://www.klipper3d.org) - прошивка для 3d принтеров, состоящая из двух частей. Первая часть устанавливается на контроллер самого 3d принтера, а вторая на любой компьютер, который поддерживает установку Klipper. Установка производится через [kiauh](https://github.com/dw-0/kiauh) и не вызывает никаких трудностей. Для отображения прогресса печати на дисплее x96 Max Plus я использовал дополнение [G-Code Shell Command](https://github.com/dw-0/kiauh/blob/master/docs/gcode_shell_command.md). Устанавливается дополнение тоже через kiauh. Для этого нужно перейти в меню Advanced: ![kiauh1](kiauh1.png) И выбрать там G-Code Shell Command: ![kiauh2](kiauh2.png) Теперь нужно добавить в printer.cfg следующее: ```yaml # Определить команду для вывода на дисплей # Важно! Для команды sudo set-display-text должен быть отключен ввод пароля (см. sudo NOPASSWD) [gcode_shell_command set_display_text] command: sudo /usr/local/bin/set-display-text verbose: False # Перехватить команду M73 [gcode_macro M73] rename_existing: M73.1 gcode: {% set P = params.P|default(0)|int %} M73.1 {rawparams} RUN_SHELL_COMMAND CMD=set_display_text PARAMS={P} ``` После этого можно использовать команду M73 для вывода прогресса печати на дисплей (например, для 55% - `M73 P55`). Осталось сконфигурировать слайсер для того, чтобы он добавлял эти команды в g-код. Для [PrusaSlicer](https://www.prusa3d.com/prusaslicer/) достаточно включить **Supports remaining times** в **настройках принтера**: ![prusaslicer](prusaslicer.png) ![printprogress](printprogress.jpg "Прогресс печати на Ender-3")