Home assistant сервер на роутере

Home Assistant — это открытая платформа для умного дома, которая позволяет контролировать и автоматизировать различные устройства и сервисы. Один из самых популярных способов установить Home Assistant — это запустить его на домашнем роутере Keenetic. В этом практическом руководстве мы расскажем, как установить Home Assistant на роутер Keenetic и начать использовать его для управления умным домом.

Перед установкой Home Assistant на роутер Keenetic, вам понадобится следующее:

1. Установленный и настроенный роутер Keenetic.
2. Базовые знания работы с роутером и сетевыми протоколами.
3. Доступ к интернету и аккаунт на сайте Keenetic.

Начнем с загрузки и установки Home Assistant. Войдите в систему управления вашим роутером Keenetic и перейдите на вкладку «Дополнительно». Затем выберите «Установка программ» и найдите Home Assistant в списке доступных программ. Нажмите на кнопку «Установить», чтобы запустить процесс установки.

Примечание: перед установкой Home Assistant убедитесь, что ваш роутер Keenetic поддерживает эту программу. Некоторые старые модели роутеров могут быть несовместимы с Home Assistant.

После завершения установки Home Assistant на роутер Keenetic, вам будет предоставлена возможность настроить его. Выберите язык, укажите имя пользователя и пароль для доступа к Home Assistant. Затем следуйте инструкциям на экране, чтобы настроить подключение к устройствам вашего умного дома.

Поздравляю! Теперь у вас установлен и настроен Home Assistant на роутере Keenetic. Вы можете начать добавлять устройства и настраивать автоматизацию в вашем умном доме. Удивительные возможности Home Assistant ждут вас!

Установка Home Assistant на роутер Keenetic

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

Шаг 1: Подготовка

Перед установкой Home Assistant на роутер Keenetic вам понадобится:

1. Установить на роутер прошивку с поддержкой Docker. Это можно сделать, следуя инструкциям производителя.
2. Подключиться к роутеру по SSH. Для этого вам понадобится программа для работы с SSH, такая как PuTTY, и права администратора на роутере.

Шаг 2: Установка Docker

После подготовки вы можете приступить к установке Docker на роутер Keenetic. Для этого выполните следующие шаги:

1. Откройте программу для работы с SSH и подключитесь к роутеру.
2. Введите следующую команду, чтобы загрузить и установить Docker:

sudo su
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

1. После установки Docker выполните команду:

sudo groupadd docker
sudo usermod -aG docker $USER

Теперь Docker установлен на вашем роутере Keenetic.

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

Теперь, когда у вас есть Docker, вы можете установить Home Assistant на роутер Keenetic. Для этого выполните следующие шаги:

1. Откройте программу для работы с SSH и подключитесь к роутеру.
2. Введите следующую команду, чтобы загрузить и установить Home Assistant:

sudo docker run -d --name="homeassistant" -v /opt/homeassistant:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/home-assistant:stable

После выполнения этой команды Home Assistant будет установлен на роутер Keenetic. Вы можете открыть веб-браузер и перейти по адресу http://<IP_адрес_роутера>:8123, чтобы настроить и использовать Home Assistant.

Шаг 4: Автозапуск Home Assistant

Чтобы Home Assistant запускался автоматически при включении роутера, выполните следующие шаги:

1. Откройте программу для работы с SSH и подключитесь к роутеру.
2. Введите следующую команду, чтобы отредактировать файл запуска:

sudo nano /opt/etc/init.d/rc.unslung

1. Добавьте следующую строку в файл перед строкой, которая начинается с exit 0:

/opt/homeassistant/run.sh start

1. Нажмите клавиши Ctrl+X, затем Y и Enter, чтобы сохранить изменения.

Теперь Home Assistant будет запускаться автоматически при включении роутера Keenetic.

Заключение

В этой статье мы рассмотрели, как установить Home Assistant на роутер Keenetic. Теперь у вас есть возможность контролировать и автоматизировать свои устройства через один интерфейс. Удачной работы с Home Assistant!

Практическое руководство для установки Home Assistant на роутер Keenetic

Шаг 1: Подготовка роутера Keenetic

Перед установкой Home Assistant на роутер необходимо убедиться, что на роутере установлена прошивка KeeneticOS. Если на роутере не установлена прошивка KeeneticOS, необходимо обновить прошивку до последней версии по инструкции, предоставленной на официальном сайте Keenetic.

Шаг 2: Установка Home Assistant на роутер

1. Зайдите в веб-интерфейс роутера Keenetic, введя в адресной строке браузера IP-адрес роутера.

2. Войдите в веб-интерфейс, используя логин и пароль администратора.

3. На странице настроек роутера найдите раздел «Плагины» или «Add-ons» и выберите его.

4. В разделе «Плагины» выберите опцию «Установить плагин» или «Install Add-on».

5. В поисковой строке введите «Home Assistant» и выберите плагин «Home Assistant» из списка результатов.

6. Нажмите на кнопку «Установить» или «Install» для установки плагина Home Assistant.

7. Дождитесь завершения процесса установки, который может занять некоторое время.

8. После завершения установки плагина Home Assistant, вы увидите значок Home Assistant на странице настроек роутера.

Шаг 3: Настройка Home Assistant

1. Нажмите на значок Home Assistant на странице настроек роутера, чтобы открыть веб-интерфейс Home Assistant.

2. Следуйте инструкциям на экране для настройки Home Assistant, включая создание учетной записи пользователя и настройку подключения к сетевым устройствам.

3. После завершения настройки Home Assistant, вы сможете управлять устройствами и создавать сценарии автоматизации через веб-интерфейс.

Вывод

Установка Home Assistant на роутер Keenetic позволяет получить удобный интерфейс для управления устройствами умного дома. Следуя данному практическому руководству, вы сможете настроить и использовать Home Assistant на роутере Keenetic без особых трудностей.

Сайт Keenetic: доступ к дополнительным функциям через установку Home Assistant

Сайт Keenetic предоставляет возможность установить Home Assistant на роутер и получить доступ к его дополнительным функциям. Это позволяет пользователям управлять умным домом, собирать и анализировать данные, настраивать автоматизацию и многое другое.

Установка Home Assistant на роутер Keenetic происходит в несколько простых шагов:

1. Настройка роутера и установка необходимых пакетов.
2. Загрузка и установка Home Assistant на роутер.
3. Настройка пользовательского интерфейса и добавление устройств.
4. Настройка автоматизации и интеграция с другими сервисами.

После установки Home Assistant пользователи получают доступ к множеству функций, которые позволяют управлять и контролировать устройства и сервисы:

• Управление умным домом: включение и выключение света, регулирование температуры, управление секционными воротами и многое другое.
• Мониторинг и анализ данных: получение информации о потребляемой энергии, состоянии устройств, температуре и влажности в помещении и т. д.
• Настройка автоматизации: создание различных сценариев, регулирование освещения в определенное время, включение отопления перед приходом домой и т. д.
• Интеграция с другими сервисами: возможность обмена данными с другими системами умного дома, интеграция с голосовыми помощниками и т. д.

Установка Home Assistant на роутер Keenetic предоставляет пользователям удобный и гибкий способ управления умным домом и обеспечивает возможность интеграции с другими сервисами и устройствами. Сайт Keenetic предоставляет необходимую информацию и руководства для установки и настройки Home Assistant, что делает процесс максимально простым и понятным.

Время на прочтение
11 мин

Количество просмотров 135K

Home Assistant — это популярная система умного дома, которая автоматизирует привычные бытовые процессы и работает на YAML файлах. В этой статье я расскажу, как настроить Home Assistant (далее HA), и что конкретно я использую в повседневной жизни. Это поможет вам избежать ошибок и быстрее продвинуться в изучении HA.

На Хабре уже есть статьи о HA (раз, два, три), но здесь я хочу рассказать об установке и настройке системы от начала до конца. От первого запуска сервера до полноценно работающей системы, которую потом можно улучшать и дорабатывать для себя.

Основной единицей в HA является интеграция — логика, которая описывает взаимодействие с умным устройством или внешним сервисом. Большая часть полезной нагрузки HA ориентировано на связку: умное устройство + интеграция или внешнее API + интеграция.

Набор моих интеграций

Железо, участвующее в статье:

• Микроконтроллер Esp8266, а также датчик температуры и влажности DHT11;
• Лампа Xiaomi Desk Lamp;
• Raspberry Pi 4B в 2GB версии, как сервер для HA (в дальнейшем буду ее называть малинкой);
• Xiaomi Router 4A .

Сервисы, которые будем использовать:

• OpenWeatherMap для получения погоды, температуры, влажности на улице и других метеопараметров;
• Telegram для создания системы уведомлений;
• Google drive для создания бекапов;
• SpeedTest для замеров скорости;
• А также OpenUV для замеров ультрафиолетового излучения и др.

Установка

Установка HA предельно проста:

1. Записать образ HA на SD карточку (подробная инструкция с ссылками на скачивание для разных версий Raspberry Pi тут).
2. Подключить питание и Ethernet к малинке
3. Подождать несколько минут, пока система развернется в локальной сети на <ip адрес малинки>:8123.

Также можно установить на уже имеющуюся систему с помощью Docker-compose:

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: homeassistant/raspberrypi4-homeassistant:stable
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    network_mode: host

А теперь разберем несколько сценариев использования.

Отслеживание устройств

Начнем с отслеживания устройств, с помощью которого мы можем фиксировать вход и выход носителей из дома.
Я предлагаю 2 способа отслеживания:

• с помощью роутера (у меня в наличии Xiaomi Router Mi4A),
• с помощью GPS.

В системе доступно много производителей роутеров. Для старых и не перечисленных в списке моделей можно использовать nmap (более подробно тут).
Если установить на телефон официальное приложение, HA по умолчанию создаст интеграцию, и в системе появится дополнительное устройство, которое можно отследить.

С помощью Xiaomi Router Mi4A

Плюсы

• Не требует никаких действий на устройстве, отслеживает всех в локальной сети.

Минусы

• Если устройство не подключено к домашней сети, то устройство пропадает в пустоту, и на картах мы его не увидим.
• Иногда может сработать триггер выхода/входа из зоны, когда фактически девайс не покидает зону (можно попробовать решить расширением зоны).

С помощью GPS

Плюсы

• Точность работы сравнима с GPS трекером в телефоне.
• О телефоне можно узнать: процент заряда аккумулятора, заряжается устройство или нет, а также показатель состояния аккумулятора.

  
• Можно контролировать устройства (пользователей) не только на вход домой, но и на вход в любую из кастомных зон.

Минусы

• Активно тратит заряд.
• Требует подключение Интернета.
• Для точного трекинга необходимо настроить SSL, чтобы телефон мог отправлять данные о местоположении из вне локальной сети.
• Требует дополнительных прав доступа к GPS, возможна утечка данных третьей стороне в будущем.
• На бюджетных телефонах, которые имеют свойство неожиданно менять местоположение GPS, возможны проблемы с выпадением из зоны.

Создание системы отслеживания через роутер

Трекинг через локальную сеть роутера требует настройки, в отличие от GPS отслеживания. Два вида трекинга можно комбинировать для повышения точности. Ниже можно заметить, что в моем случае отслеживание через роутер работает лучше, чем через GPS. Зеленая зона значит, что телефон внутри зоны, красная — вне зоны.

Результаты работы отслеживания (сверху — роутер, снизу — GPS)

platform: xiaomi
host: 192.168.31.1
password: !secret xiaomi_router_password
configuration.yaml
device_tracker: !include configs/router_device_tracker.yaml

После перезагрузки HA мы можем увидеть, что у нас появился новый глобальный объект device_tracker и наши устройства в нем.

Трекинг устройств через роутер

Освещение

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

Для этого необходимо произвести действие по определенному событию. В этом нам помогут автоматизации.

- alias: Entering home
  trigger:
    platform: state
    to: home
    entity_id: device_tracker.mi9lite
  action:
    - service: light.turn_on
      data:
        entity_id: light.midesklamp1s_f86f
        brightness: 35
        color_temp: 350

- alias: Leaving home
  trigger:
    platform: state
    to: not_home
    entity_id: device_tracker.mi9lite
  action:
    - service: light.turn_off
      entity_id: light.midesklamp1s_f86f

Теперь импортируем в наш основной файл весь каталог automation — так нам будет удобнее при написании следующих автоматизаций.

automation: !include_dir_merge_list automation

Пример работы:
https://www.youtube.com/watch?v=Sii4rBtXYVw

Для того, чтобы получить адаптивное освещение в зависимости от времени суток, нужно настроить цветовую температуру. Это удобно сделать внутри блока switch. Тут важно понимать, что пока данный switch включен, изменить параметры температуры будет невозможно (через interval минус время_с_прошлого_обновления лампа примет старые параметры).

Здесь вы найдете больше про динамическую цветовую температуру (flux в терминологии HA). А если вам интересна тема адаптивного освещения, на Хабре есть отличная статья по этому поводу.

switch:
  - platform: flux
    lights:
      - light.midesklamp1s_f86f
    name: Fluxer
    start_time: '9:00'
    stop_time: '0:00'
    start_colortemp: 5000
    sunset_colortemp: 3200
    stop_colortemp: 2800
    brightness: 25.5
    disable_brightness_adjust: true # яркость будет константой
    mode: mired # для не rgb ламп
    transition: 30
    interval: 30```

<!--</spoiler>-->
# Погода
По умолчанию в HA уже присутствует интеграция с погодным API от [Meteorologisk institutt](https://www.home-assistant.io/integrations/met/) (Норвежский метеорологический институт), но мы можем легко создать другую прямо через UI.

## Создание новой интеграции OpenWeatherMap
Переходим в config / Integration на UI , нажимаем на Add integration, и выбираем из списка OpenWeatherMap.

![](https://habrastorage.org/webt/wk/q5/gu/wkq5guripld3x0rlvuuvrh6us-8.png)

Вводим api_key, полученный на их сайте и нажимаем Submit. В итоге получим 19 сущностей, которые можем использовать для своих целей в автоматизациях.

![](https://habrastorage.org/webt/l1/dj/ps/l1djps20zhxaghdhbfrxzcm7tac.png)
*Сущности OWM (на скриншот попали не все 19)*

Таким же образом через UI можно создать интеграции к другим сервисам вроде SpeedTest, или OpenUV.

# Уведомления
Для настройки уведомлений можно использовать стандартные оповещения HA, отображаемые в боковом меню, уведомления на конкретных устройствах (нужно установленное приложение на девайсе), а также оповещения в сторонние сервисы.

![](https://habrastorage.org/webt/vw/lo/uk/vwloukneshhkvd6sklfjojnsvrc.png)
*persistent_notification*

Альтернативный способ уведомлений - это уведомления в сторонние сервисы, например Telegram. Для начала нужно создать бота, получить его api_key (при создании отправят ключ) и chat_id, который можно найти в ответе внутри `result.chat.id` после запроса на https://api.telegram.org/bot{api_key}/getUpdates .

<!--<spoiler title="Ответ с Telegram API приходит пустой">-->

Такое иногда случается по разным причинам. 
В таких случаях подходит другой способ получения chat_id - написать @getmyid_bot  боту и скопировать себе user ID.
<br>
![](https://habrastorage.org/webt/h_/em/a_/h_ema_sk04ldd4xsfkdzdthaml4.png)

<!--</spoiler>-->
Простейшая настройка Telegram бота:

<!--<spoiler title="notification/telegram_bot.yaml">-->

Для того, чтобы не разглашать всем секретные данные, создадим еще secrets.yaml. Туда мы сложим все данные, которые не должны попасть в публичный доступ. Для использования переменных из этого файла используем !secret.

Пример секретов:

telegram_api: %api_key%
telegram_chat_id: %chat_id%

telegram_bot: !include notification/telegram_bot.yaml

В итоге у нас имеется Telegram бот, готовый к отправке сообщений.

Утренние (или нет) погодные оповещения

Теперь, когда у нас есть настроенный сервис уведомлений и погодная интеграция, мы можем сделать утренние оповещения о погоде.

Создаем новый файл автоматизации, и начинаем писать логику.

Пишем переменную, которая будет отвечать за срабатывание оповещений только по будням. Если он true — то в выходные оповещений не будет.

alarmweekday:
  name: Weekdays Only
  initial: off
  icon: mdi:calendar

И подключаем в основном конфиг файле.

input_boolean: !include input_boolean.yaml

- alias: 'Wake Me Up'
  trigger:
    platform: time
    at: input_datetime.weather_notification
  condition:
    condition: or
    conditions:
      - condition: and
        conditions:
          - condition: state
            entity_id: input_boolean.alarmweekday # оповещение в выходные
            state: 'on'
          - condition: time
            weekday:
              - mon
              - tue
              - wed
              - thu
              - fri
      - condition: and
        conditions:
          - condition: state
            entity_id: input_boolean.alarmweekday
            state: 'off'

  action:
    service: telegram_bot.send_message
    data: # тут
      message: "{% if now().strftime('%H')|int < 7 %} 
        Доброй ночи,
        {% elif now().strftime('%H')|int < 12 %}
        Доброе утро,
        {% elif now().strftime('%H')|int < 18 %}
        Хорошего дня,
        {% else %}
        Хорошего вечера,
        {% endif %}
         сейчас на улице {{states('sensor.openweathermap_temperature')}}°C. "

Пример работы:
https://www.youtube.com/watch?v=vSmSbSd_f-Q

Добавим blueprints

Теперь небольшое лирическое отступление в виде рассказа о написании blueprints на примере уведомлений.

В данном случае я бы перевел blueprints не как чертежи, а как шаблоны или заготовки. Их удобнее использовать, если нужно написать несколько похожих автоматизаций, а основную логику оставить нетронутой.

Например, можно упростить создание уведомлений о начинающихся осадках.

blueprint:
  name: Fallout start notification
  domain: automation
  input:  # аргументы шаблона
    precipitation:
      name: Precipitation level
      selector:
        entity:
          domain: sensor # только для ui, поможет создать автоматизацию, предоставляя только сенсоры в выпадающем списке
    message_start:
      name: Telegram message
      default: "No message"

trigger: # условия срабатывания
  - platform: numeric_state  
    entity_id: !input precipitation
    above: 0.9
    for: 
         minutes: "{{ states('input_number.minimum_time_for_stable_value')|int }}"

action:
  - service: telegram_bot.send_message
    data:
      message: !input message_start 

“for” — это время, в котором должен оставаться выбранный параметр, чтобы сработал триггер на превышение уровня осадков.

minimum_time_for_stable_value:
  name: Minimum time for stable value
  initial: 1
  min: 0
  max: 59
  step: 1

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

- alias: 'Rainy is started'
  use_blueprint:
    path: homeassistant/fallout_start_notification.yaml
    input:
      precipitation: sensor.openweathermap_rain
      message_start: "Похоже, дождь начинается. Уже накапало {{states('sensor.openweathermap_rain')}}мм."
automation/snow_start.yaml

- alias: 'Snow is started'
  use_blueprint:
    path: homeassistant/fallout_start_notification.yaml
    input:
      precipitation: sensor.openweathermap_snow
      message_start: "Пошел снежок. Уже навалило {{states('sensor.openweathermap_snow')}}мм."

Мы смогли вынести часть функциональности в отдельный файл. В подобных случаях, когда со временем появляется похожий код, можно выносить часть логики в отдельный файл.

Для большей полезности можно изменить шаблон и поменять action на повышение яркости для света в доме или закрытие штор.

Бэкапы

В бэкап попадает весь каталог /config, а также все установленные расширения. С любого бекапа можно восстановить состояние системы на момент его создания.

Можно настроить создание резервных копий в Google Drive:

1. Скопировать ссылку https://github.com/sabeechen/hassio-google-drive-backup и зайти в HA (также можно прочитать подробную инструкцию в ReadMe репозитория по ссылке)
2. Добавить ссылку как кастомный репозиторий в Supervisor’е через UI.

   
3. Открыть его (Open Web UI) и следовать инструкциям по аутентификации с Google Drive

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

ESP

NodeMCU

Так как умного градусника у меня нет, а температуру измерять хочется, воспользуемся ESP8266.
Сначала установим интеграцию ESPHome из официального списка интеграций.

Для каждого микроконтроллера, используемого в системе, требуется создать файл с подобным содержанием.

esphome/home_params.yaml

Проинициализируем контроллер.

esphome:
  name: home_params
  platform: ESP8266
  board: nodemcuv2

logger:
api:
ota:

Подключимся к WiFi

wifi:
  ssid: !secret xiaomi_router_ssid
  password: !secret xiaomi_router_password

По умолчанию используются секреты только от ESPHome. А для того, чтобы подгрузить секреты из HA, можно создать отдельный файл, где мы заинклудим эти секреты.

Теперь подключим data pin (обычно это средняя нога) термометра к D2 порту, дадим на него питание и землю. Потом создаём сам термометр (DHT11) и две переменные, которые будем отслеживать в HA.

sensor:
  - platform: dht
    model: DHT11
    pin: D2
    temperature:
      name: "Living Room Temperature"
    humidity:
      name: "Living Room Humidity"
    update_interval: 60s

Дальше нужно скомпилировать прошивку и загрузить на контроллер. Если он подключен напрямую к Raspberry Pi, то мы увидим его на /dev/ttyUSB0 и сможем загрузить прошивку в первый раз. Все последующие обновления можно загружать по воздуху. А если в списке устройства не видно, то можно скачать прошивку и воспользоваться ESPHome-Flasher.

Загружаем прошивку.

Если все заработало, то в Developer Tools мы увидим созданные переменные.

Немного оптимизации

По умолчанию в HA используется SQLite, и сброс данных на диск происходит часто (каждую секунду). Это может привести в скором времени к выходу из строя SD карточки на малинке (если сервер стоит на ней). Чтобы продлить срок службы карточки, скажем HA, что нужно записывать на диск раз в commit_interval и исключить некоторые сущности, которые мы не хотим отслеживать на длинном временном промежутке (или вообще не хотим отслеживать).

commit_interval: 1500
purge_keep_days: 7
exclude:
  domains:
    - updater
    - automation
  entity_globs:
    - sensor.miwifi_router*
  entities:
    - sensor.date
    - sensor.date_time
    - sensor.time
    - sensor.openweathermap_forecast_time

recorder: !include  configs/recorder.yaml

Если мы хотим использовать СУБД, отличную от SQLite, то можно сделать один из следующих пунктов на выбор:

1. Установить соответствующий аддон для перехода на MariaDB.
2. Использовать существующую реляционную базу данных на удаленной машине, если указать строку для подключения в параметр db_url.

Отслеживание системных параметров

- platform: systemmonitor
  resources:
    - type: disk_use_percent
      arg: /
    - type: memory_free
    - type: memory_use_percent
    - type: processor_use
    - type: processor_temperature
    - type: disk_free
      arg: /

При желании можем создать автоматизацию, которая при критических показателях будет отправлять уведомление о необходимости принятия мер.

- platform: uptime
  name: Time Online

sensor: !include_dir_merge_list sensors

Заключение

Плюсы HA

• Простая установка и настройка, не требующая знания программирования.
• Большое коммьюнити — вопросов на форуме много, ответов тоже хватает.
• Огромное количество готовых интеграций со сторонними сервисами — скорее всего не придется писать свою интеграцию руками.

Минусы HA

• Достаточно сложно отлаживать систему. Если action можно запустить программно в обход триггера, то триггер тестировать уже сложнее.

Что дальше? Можно добавить HACS (сборник UI компонентов и даже целых интеграций от коммьюнити, пригодится при использовании Яндекс Станции) и установить несколько UI элементов. Можно интегрировать умную колонку или телевизор и включать их по определенному условию. Вариантов апгрейда бесконечное множество.

Успехов в автоматизации!

Литература

• Документация HA