Присутствие в Home Assistant: person, zones, Companion App и защита от ложного режима «Ушёл»

Как Home Assistant определяет присутствие человека

Сам Home Assistant не умеет угадывать местоположение. Источники данных создают device_tracker: приложение телефона отправляет координаты, а интеграция маршрутизатора сообщает о подключении устройства к сети. Один или несколько трекеров назначаются человеку (person), а правила автоматизации используют его состояние или занятость географической зоны.

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

В чём разница между person, device_tracker и zone

У person возможны состояния home, not_home или название другой зоны. Поэтому проверка person.resident_one == not_home не равнозначна проверке «этого человека точно нет дома»: когда он на работе, состояние может быть work.

Как Person выбирает источник: GPS или Wi-Fi

Home Assistant различает два основных типа device trackers: connection (наличие подключения к маршрутизатору, BLE) и position (GPS и другая геолокация). Алгоритм намеренно не сводится к «последний пришедший сигнал победил».

Несколько connection trackers сравниваются по времени обновления; GPS-источники тоже выбираются с учётом актуальности. Именно задержка обновления Wi-Fi-трекера может удерживать home несколько минут после реального ухода. Это штатный защитный компромисс, а не обязательно ошибка.

В актуальной реализации device_tracker различает tracking_type: connection и tracking_type: position. Часть старых integrations ещё использует legacy-модель; Home Assistant планирует удалить её в первой половине 2027 года. Проверяйте совместимость старых интеграций маршрутизаторов.

Как работают зоны Home Assistant

Zone - круговая географическая область с центром и радиусом. При первоначальной настройке Home Assistant создаёт домашнюю зону; стандартный радиус составляет 100 метров. В Settings → Areas, labels & zones → Zones можно изменить её размер и добавить работу, школу, дачу или другие места.

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

Как выбрать радиус

• Слишком маленькая зона повышает риск ложных выходов из-за GPS-погрешности.
• Слишком большая зона может считать человека дома ещё у магазина или соседнего дома.
• Перекрывающиеся зоны могут давать неожиданный выбор зоны: смотрите атрибут in_zones и размеры областей.
• Для жилого комплекса радиус лучше уточнить по фактической геолокации, а не автоматически использовать самый маленький.

Почему zone.home удобнее двух десятков условий

Состояние zone.home - число людей, которых Home Assistant сейчас относит к домашней зоне. Например, 2 означает, что система видит двух человек дома, а 0 означает, что система не видит в зоне никого.

Но есть условие: не забудьте создать person для каждого человека, отсутствие которого важно для сценария. Если кто-то живёт дома без смартфона или без настроенного трекинга, zone.home == 0 не означает, что в квартире физически никого нет.

Companion App как GPS-трекер

Официальное приложение Home Assistant Companion App для Android и iOS создаёт device_tracker. Геолокация может обновляться при пересечении зоны, значительном перемещении, запуске приложения, фоновой проверке или запрошенном обновлении. Интервал не гарантирован: его определяют ОС, доступ к геолокации, заряд батареи и условия сети.

Exact, Zone Name Only и Disabled

У Companion App предусмотрены настройки передачи точного местоположения (Exact), только названия зоны (Zone Name Only) либо полного отключения отправки. Для простого сценария «дома/не дома» передача только имени зоны может быть достаточной и более приватной. Набор доступных параметров зависит от версии приложения и ОС.

Почему Android и iPhone отправляют координаты по-разному

Точное название экранов настроек меняется между версиями Android, iOS и Companion App. Не ориентируйтесь только на скриншоты старых гайдов: откройте текущий раздел приложения, связанный с Location и Privacy.

Нужен ли High Accuracy постоянно?

Обычно нет. Его имеет смысл включать временно для диагностики либо ограничивать определёнными зонами/условиями. Постоянная работа GPS с повышенной точностью увеличивает расход батареи и не устраняет проблемы недоступности самого сервера.

Как телефон передаст местоположение, если человек уже вышел из домашнего Wi-Fi

Вне дома Companion App должен иметь доступ к Home Assistant по мобильному интернету. Это может быть Home Assistant Cloud или корректно настроенный защищённый удалённый доступ. При отсутствии связи приложение может отправить данные позже, и автоматизация сработает с задержкой.

Не нужно ради этой задачи бездумно открывать web-порт Home Assistant через port forwarding. Для частного доступа можно использовать VPN, но важно учитывать, подключается ли он на телефоне автоматически и получает ли приложение доступ к серверу в фоне.

Дополнительные материалы: что должно работать при недоступности Home Assistant и основы архитектуры Home Assistant.

Можно ли определять присутствие по маршрутизатору Keenetic, UniFi или другому роутеру

Да, если конкретная интеграция предоставляет connection-based device_tracker для телефона. Маршрутизатор видит подключение к домашней сети; это часто хороший второй источник в дополнение к GPS.

Но Wi-Fi не равно «человек дома». Телефон может отключить Wi-Fi, уйти в энергосбережение, переключиться между точками доступа или остаться дома, пока человек ушёл без него. Некоторые интеграции определяют активность по DHCP/ARP/ICMP и имеют задержку перед переводом устройства в not_home.

Настройка определения присутствия с нуля

Как правильно определять, что все ушли из дома

В новых версиях Home Assistant удобен специальный trigger zone.occupancy_cleared: он срабатывает, когда домашняя зона переходит из занятой в пустую. У него есть параметр for, чтобы пустое состояние сохранялось заданное время.

Это лучше, чем отдельные triggers «первый человек вышел», «второй человек вышел» и сложные комбинации not_home для каждой персоны. Но дополнительная проверка достоверности person states остаётся полезной.

У зоны есть и обратный trigger zone.occupancy_detected: он реагирует на переход от нуля к одному или нескольким людям.

Все ушли: выключить только некритичное освещение

В примере два участника. Сценарий выключает конкретную группу светильников через 10 минут после опустения zone.home, но только если обе person entities имеют определённое состояние и не находятся дома.

alias: "Все ушли - выключить подсветку"
description: "Только некритичное освещение"
triggers:
  - trigger: zone.occupancy_cleared
    options:
      zone: zone.home
      for: "00:10:00"
conditions:
  - condition: template
    value_template: >-
      {{ has_value('person.resident_one')
         and has_value('person.resident_two')
         and not is_state('person.resident_one', 'home')
         and not is_state('person.resident_two', 'home') }}
  - condition: state
    entity_id: input_boolean.auto_away_enabled
    state: "on"
actions:
  - action: light.turn_off
    target:
      entity_id:
        - light.hall_decor
        - light.living_room_decor
mode: single

Замените вымышленные entity IDs на собственные и создайте helper input_boolean.auto_away_enabled либо удалите это условие, если оно не нужно. Не распространяйте пример автоматически на холодильник, котёл, сетевое оборудование, устройства безопасности и цепи жизнеобеспечения.

Кто-то вернулся: включить свет у входа после заката

При переходе домашней зоны из пустой в занятую Home Assistant включает свет у входа, если солнце уже зашло. Сценарий не отпирает замок и не отключает охранную систему.

alias: "Первый вернулся - свет у входа"
triggers:
  - trigger: zone.occupancy_detected
    options:
      zone: zone.home
conditions:
  - condition: sun
    after: sunset
    before: sunrise
actions:
  - action: light.turn_on
    target:
      entity_id: light.entrance
mode: single

Учтите, что домашняя зона имеет радиус, и свет может включиться, пока человек ещё идёт от парковки. Для точного включения при входе лучше использовать датчик открытия двери, кнопку, mmWave/PIR либо дополнительный локальный сигнал.

Проверка без команды оборудованию: уведомление о переходе

На этапе обкатки безопаснее использовать информационные уведомления и смотреть, сколько раз система ошибочно считала дом пустым.

alias: "Диагностика ухода из дома"
triggers:
  - trigger: zone.occupancy_cleared
    options:
      zone: zone.home
      for: "00:05:00"
actions:
  - action: persistent_notification.create
    data:
      title: "Home Assistant: зона дома пуста"
      message: >-
        В {{ now().strftime('%H:%M') }}
        zone.home = {{ states('zone.home') }}.
        Проверьте реальные положения людей.
mode: single

Это сообщение появляется в интерфейсе Home Assistant, не управляет устройствами и удобно для первичной проверки логики.

Почему возникают ложные уходы и возвращения

Двойное подтверждение, но без самообмана

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

Как отличить «человек ушёл» от «перестали приходить данные»

В Home Assistant unknown и unavailable не равнозначны not_home. Более того, у person за пределами домашней зоны может быть другое именованное состояние: work, school и т. п.

Для автоматизаций, управляющих дорогостоящими или опасными процессами, полезна стратегия fail-safe: при сомнениях сохранить безопасный режим, не принимать необратимых решений и уведомить владельца.

Подробнее о корректной обработке состояний читайте в статье Шаблоны Jinja, template sensors и availability.

Что происходит с задержкой for после перезагрузки

У обычных state/template triggers ожидание for не переживает перезапуск Home Assistant или перезагрузку автоматизаций. Это необходимо учитывать и при выборе специальных zone triggers: проверяйте фактическое поведение на используемой версии.

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

Сценарии, для которых геолокация действительно подходит

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

Как определять присутствие в комнате, а не только дома

GPS и домашняя зона не дадут надёжного ответа на вопрос, находится ли человек в спальне или гостиной. Для этого нужны PIR, mmWave, датчики дверей, локальные Bluetooth-системы или сочетания сигналов.

На сайте уже есть подробный материал mmWave или PIR: какой датчик присутствия выбрать. А практические сценарии освещения, отопления и протечек рассмотрены в статье Локальные сценарии Home Assistant.

Стоит ли использовать Bluetooth, iBeacon и Wi-Fi одновременно

Иногда стоит, но не ради количества датчиков. Wi-Fi подтверждает локальное подключение телефона; BLE/iBeacon может дать дополнительный локальный сигнал, а GPS удобен для зоны «Работа» и возвращения домой.

• Если достаточно знать, что кто-то дома, начните с Person + Companion + корректной home zone.
• Если GPS регулярно ошибается у дома, добавьте качественный connection tracker от маршрутизатора.
• Если нужна точность по комнате, используйте локальные датчики и не рассчитывайте на один GPS.
• Если решение влияет на безопасность, добавьте ручное подтверждение или независимые средства контроля.

Что проверить, если присутствие Home Assistant определяется неправильно

Если проблемы начались после обновления, откройте материал Home Assistant после обновления: unavailable и не работают автоматизации.

Как настроить контроль присутствия без лишнего наблюдения

• Отслеживайте только тех участников, кто дал согласие и понимает, какие данные сохраняются.
• Выбирайте Zone Name Only вместо точных координат, если этого достаточно для сценария.
• Не публикуйте dashboard с картой местоположений в открытый интернет.
• Настройте индивидуальные учётные записи, права и двухфакторную аутентификацию.
• Проверяйте доступ к истории и резервным копиям Home Assistant.
• Не используйте данные присутствия как скрытый инструмент контроля работников или членов семьи.

Безопасность пользователей и устойчивость отопления, электропитания и физического доступа важнее удобства автоматического режима «Ушёл».

Что должно быть готово перед запуском автоматического режима «Ушёл»

Что читать дальше

Официальные источники

Основой материала служат актуальные разделы документации Home Assistant и Companion App. Поскольку интерфейс и набор triggers развиваются, при настройке конкретной системы проверяйте версию Home Assistant Core и приложения.

• Home Assistant: Person - объединение GPS и connection trackers.
• Home Assistant: Device Tracker - типы трекеров и состояния.
• Home Assistant: Zone - настройка home zone, счётчик людей, passive zones.
• Zone occupancy cleared - современный trigger для отсутствия людей.
• Zone occupancy detected - современный trigger для возвращения.
• Companion App: Location - разрешения, способы и настройки обновления геопозиции.
• Automation triggers - поведение for при перезапуске.

Частые вопросы о присутствии в Home Assistant