Умный дом
March 7

🛠️⚡ ТВ-бокс — не просто коробка! Ставим Home Assistant

Сегодня мы разберём, как установить Home Assistant — одну из самых гибких и мощных платформ для работы с устройствами IoT — на бюджетные ТВ-приставки Vontar X3 и H96Max X3.

Эти маленькие коробочки, спрятанные за вашим телевизором, обладают потрясающим потенциалом. С их помощью можно управлять умными лампочками, датчиками, розетками и даже роботами-пылесосами. И знаете что? Это проще, чем собрать полку из IKEA (а это уже говорит о многом)!

Так что готовьтесь: мы превратим вашу скромную ТВ-приставку в настоящий центр управления умным домом. Поехали! 🚀

Что общего у Vontar X3 и H96Max X3 (и чем они отличаются)

Обе приставки работают на базе Amlogic S905X3 — энергоэффективного 64-битного процессора с четырьмя ядрами Cortex-A55 и графическим ускорителем Mali-G31 MP2. Они оснащены 4 ГБ оперативной памяти и 32/64 ГБ встроенной памяти (eMMC), что достаточно для запуска Home Assistant.

Главные отличия:

  • Vontar X3 имеет дополнительный порт USB-C для питания, а H96Max X3 — композитный AV-выход (полезно для подключения к старым ТВ).
  • В H96Max X3 используется более новая аппаратная ревизия платы, но для наших целей это не критично.

Подготовка к установке:

Что понадобится:

  1. ТВ-приставка Vontar X3 или H96Max X3 (проверьте, что она работает)
  2. USB-флешка объёмом от 8 ГБ
  3. Клавиатура USB (для ввода команд)
  4. Кабель Ethernet (Wi-Fi в приставках нестабилен для серверных задач)
  5. Зубочистка или скрепка (для нажатия кнопки Reset).

Шаг 1: Загрузка необходимых инструментов

1.1. Скачиваем BalenaEtcher
Перейдите на официальный сайт https://etcher.balena.io и загрузите версию программы для вашей ОС (Windows/macOS/Linux). Это утилита для записи образов на флешку — альтернатива устаревшим программам вроде Rufus

1.2. Скачиваем образ Armbian
Armbian — это легковесная ОС на основе Debian, оптимизированная для устройств Amlogic. Скачайте образ по ссылке:
https://github.com/ophub/amlogic-s9xxx-armbian/releases/download/Armbian_bullseye_save_2025.03/Armbian_25.05.0_amlogic_s905x3_bullseye_6.12.17_server_2025.03.02.img.gz


Шаг 2: Запись образа на флешку

Шаг №2.1: Запись образа на флешку

Запускаем BalenaEtcher, обязательно от имени администратора. Почему это важно? Если программа запущена без прав администратора, могут возникнуть ошибки при записи образа на флешку, например, недостаточно прав доступа к устройству или проблемы с монтированием диска. Чтобы избежать головной боли, всегда запускайте такие программы с повышенными привилегиями.

Если вы уже знакомы с BalenaEtcher, то процесс записи будет для вас привычным. Для тех, кто впервые работает с этой программой, вот краткая инструкция:

  • Нажмите на кнопку Flash from file и выберите скачанный ранее файл образа (расширение .img.gz).
  • Выберите вашу USB-флешку в списке доступных устройств.
  • Нажмите Flash, чтобы начать запись.

Когда запись завершится, вытащите флешку и снова вставьте её в компьютер. Появится окно с предложением отформатировать флешку (этих окон может появится несколько) — мы, конечно же, отказываемся.

Теперь в системе появится диск с названием BOOT. Заходим в него и переходим к следующему шагу.

Шаг №2.2: Редактируем uEnv.txt

В корне диска BOOT находим файл uEnv.txt и открываем его в блокноте (или любом текстовом редакторе). Ищем строчку, которая начинается на FDT , и приводим её к такому виду:

FDT=/dtb/amlogic/meson-sm1-h96-max-x3.dtb

Это указывает приставке использовать корректный файл для загрузки.

Шаг №2.3: Переименовываем загрузочный файл

Теперь в корне диска BOOT нужно найти файл u-boot-s905X3.bin и переименовать его в u-boot.ext. Это как дать файлу новое имя, чтобы система могла его легко найти и использовать. Это ключевой загрузчик, без которого приставка не увидит образ.


Шаг 3: Загрузка приставки с флешки

Пришло время загрузить нашу приставку со свежезаписанной флешки. Это не так сложно, как кажется. Давайте разберёмся:

1. Подготовка оборудования:

  • Отключите приставку от питания.
  • Подключите её через HDMI к монитору или телевизору.
  • Вставьте флешку обязательно в порт USB 2.0. Как отличить USB 2.0 от USB 3.x? Очень просто: порты USB 3.x обычно имеют синий пластик внутри разъёма, а USB 2.0 — чёрный или белый. Если вы не уверены, посмотрите маркировку на корпусе устройства или в документации.
  • Подключите клавиатуру к любому свободному USB-порту (мышь нам не понадобится).
  • Соедините приставку с роутером через Ethernet-кабель.

2. Загрузка с флешки:

  • Возьмите зубочистку (или любой тонкий предмет) и найдите кнопку Reset. Она спрятана внутри гнезда под jack 3.5 мм.
  • Зажмите кнопку Reset, затем подайте питание на приставку. Удерживайте кнопку ещё 5–7 секунд после включения.
  • Отпустите кнопку и наберитесь терпения — приставка начнёт загружаться. Если всё сделано правильно, вы увидите процесс загрузки на экране.

Кстати, некоторые модели приставок не требуют таких сложных манипуляций. Для них достаточно просто включить устройство, и через 15–20 секунд начнётся автоматическая загрузка с флешки.

Если приставка зависает на логотипе, это значит, что что-то пошло не так на шагах №2.2 или №2.3. Не паникуйте! Вернитесь назад, проверьте все изменения, и попробуйте снова.


Шаг 4: Установка Home Assistant

Итак, спустя несколько минут (и, возможно, чашечку кофе), наша приставка загрузилась, и теперь она готова стать мозгом будущего умного дома. Пора приступить к установке Home Assistant! На этом этапе всё довольно просто — нужно просто повторить несколько команд. Не пугайтесь их количества, они выполняются одна за другой, как волшебный ритуал.

Открываем терминал (логин: root, пароль: 1234) и вводим следующее:

apt update && apt install -y bluez jq wget curl udisks2 libglib2.0-bin network-manager dbus apparmor-utils systemd-journal-remote lsb-release systemd-resolved
wget https://github.com/home-assistant/os-agent/releases/download/1.5.1/os-agent_1.5.1_linux_aarch64.deb
dpkg -i os-agent_1.5.1_linux_aarch64.deb
curl -fsSL https://get.docker.com -o get-docker.sh
sh ./get-docker.sh
usermod -aG docker $USER
wget -O homeassistant-supervised.deb https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
apt install -y ./homeassistant-supervised.deb

Эти команды обновляют систему, устанавливают необходимые зависимости, настраивают Docker (контейнерную платформу) и скачивают сам Home Assistant. По сути, это как собрать конструктор LEGO: каждый блок имеет свою роль, а вместе они создают нечто удивительное.

Теперь запускаем финальную команду для установки Home Assistant:

BYPASS_OS_CHECK=true
dpkg -i homeassistant-supervised.deb

В процессе установки система спросит, какой тип платы вы используете. Выбираем Odroid C4 — и вот почему: как на Odroid C4, так и на нашей приставке установлен процессор Amlogic S905X3 , поэтому этот вариант подходит идеально.

Когда командная строка снова станет доступна, самое время перейти к шагу №5. И да, не пугайтесь — всё будет хорошо! 😉


Шаг №5: Начинаем "колдовать" с конфигами

Сначала открываем файл /boot/uEnv.txt для редактирования:

nano /boot/uEnv.txt

В этом файле ищем строку APPEND= и дописываем в её конец следующие параметры:

apparmor=1 security=apparmor systemd.unified_cgroup_hierarchy=0

Теперь нужно выйти из редактора nano. Для этого нажимаем Ctrl+O, чтобы сохранить изменения (да-да, это как "ОК, я всё сделал, запомни это!"), а затем Ctrl+X, чтобы покинуть редактор. Проще простого, правда?

Далее переходим к следующему файлу — /etc/os-release. Открываем его:

nano /etc/os-release

Здесь меняем строку PRETTY_NAME="Armbian ХХ.ХХ.ХХ bullseye" на PRETTY_NAME="Debian GNU/Linux 11 (bullseye)". Это как переименовать свой компьютер в паспорте — теперь он будет представляться немного иначе.

Шаг №6: Переносим всё на внутреннюю память EMMC

Теперь самое интересное — перенесём все наши труды (всё, что установили и настроили) на внутреннюю память EMMC. Зачем это нужно? Всё просто: внутренняя память EMMC работает быстрее, чем флешка, и система станет более автономной. Теперь вам не придётся постоянно держать флешку в устройстве, чтобы всё работало.

Для этого выполняем команду:

armbian-install && poweroff

Появится список вариантов. Если у вас Vontar X3, выбирайте цифру 512. Если же у вас H96Max X3, то ваш выбор — 514. Дальше вас спросят, в какую файловую систему отформатировать память. Выбираем цифру 1 (это ext4 — надёжная и проверенная временем файловая система).

Когда процесс завершится, приставку можно смело выключать и извлекать флешку. Теперь система полностью автономна и готова к работе!

Ну что, справились? Поздравляю, вы только что совершили маленькое техническое чудо! 🎉


Шаг №7: Финальный аккорд

Выключаем приставку, достаём флешку и снова включаем устройство. Теперь система загружается уже с внутренней памяти EMMC — никаких лишних носителей больше не нужно!

Чтобы начать работу с Home Assistant, нужно узнать IP-адрес вашей приставки. Это можно сделать через настройки роутера или с помощью специальных приложений для сканирования сети (например, **Fing**). Нашли адрес? Отлично!

Открываем браузер и вводим:

http://адрес_приставки:8123

Нажимаем Enter... и вот оно! Перед вами появляется интерфейс Home Assistant, готовый к работе. Поздравляем, вы только что запустили собственную систему умного дома!

А дальше — полный простор для творчества: подключайте умные лампочки, датчики движения, розетки, роботов-пылесосов и всё, что душе угодно. Но это, как говорится, уже совсем другая история… 🚀

Теперь можно расслабиться, гордиться собой и начинать экспериментировать. Умный дом ждёт ваших команд! 😊


Заключение

Вот мы и добрались до финала нашего технического приключения! Теперь ваша ТВ-приставка превратилась в настоящий центр управления умным домом. Home Assistant готов служить вам верой и правдой, автоматизируя рутину и делая жизнь чуточку волшебнее.

Надеюсь, этот гайд помог вам разобраться во всех шагах, а процесс установки оказался не таким страшным, как могло показаться вначале. Удачи в ваших умных начинаниях, и пусть ваш дом станет ещё немного умнее и комфортнее. До новых встреч в мире технологий! 🚀💡