Короткий ответ
Да. AmazHA — приложение Home Assistant для часов Amazfit — работает на 25 моделях с Zepp OS и позволяет управлять с запястья светом, климатом, шторами, замками, медиа, сценами и многим другим. Официального приложения Home Assistant для Zepp OS нет. Часы связываются с телефоном по Bluetooth, телефон — с Home Assistant, и дома ему нужен только ваш локальный адрес.
| Коротко | |
|---|---|
| Часы | 25 моделей Amazfit с Zepp OS, квадратные и круглые |
| Типы устройств | 17, у каждого свой экран управления |
| Подключение | Часы ↔ телефон по Bluetooth, телефон ↔ Home Assistant по HTTP |
| Адреса | Локальный URL дома, при желании удалённый URL вне дома |
| Токен | Долгосрочный токен доступа администратора, хранится на телефоне |
| Обновление | Каждые 8 секунд, пока приложение открыто |
| Устройства на часах | До 100; несколько десятков работают быстро |
| Виджет на циферблате | До четырёх устройств |
| Данные часов в Home Assistant | 18 датчиков по выбору, через интеграцию Mobile App |
| Модель оплаты | Бесплатное демо, затем разовая разблокировка, без подписки |
Как часы на Zepp OS связываются с Home Assistant
Сами часы с Home Assistant никогда не общаются — это делает телефон. Приложение для часов на Zepp OS не может выполнять веб-запросы, поэтому AmazHA состоит из двух половин. Одна работает на часах и рисует экраны. Другая работает на телефоне внутри приложения Zepp, и только она обращается к вашему серверу Home Assistant.
Часы ↔ телефон по Bluetooth, телефон ↔ Home Assistant по HTTP
Когда вы открываете комнату на часах, часы запрашивают её у телефона по Bluetooth. Телефон обращается к REST API Home Assistant с вашим адресом и токеном, урезает ответ до того, что нужно часам, и отправляет его обратно. Когда вы нажимаете на свет, тот же путь проходится в обратную сторону: часы сообщают телефону, а телефон вызывает службу в Home Assistant.
Из такого устройства следуют две вещи:
- На часы попадает только то, что вы выбрали. Телефон загружает только устройства, включённые в настройках, и ничего больше, поэтому трафик по Bluetooth остаётся небольшим.
- Экраны часов не зависят от того, откуда берутся данные. Бесплатное демо и ваш настоящий дом используют одни и те же экраны — меняется только источник.
Что никогда не попадает на часы
Адрес вашего Home Assistant и долгосрочный токен доступа остаются на телефоне. Часы получают имена устройств, их состояния и значения, которые они показывают, и ничего больше. Токен отправляется только на ваш сервер Home Assistant, а после сохранения настройки на телефоне показывают вместо него точки. У AmazHA нет аккаунтов, аналитики и сервера разработчика, который хранил бы что-либо о вас или вашем доме.
Почему телефон должен быть рядом и почему часам не нужен Wi-Fi
Часы добираются до Home Assistant через телефон, поэтому телефон должен быть в зоне действия Bluetooth, с включённым Bluetooth и приложением Zepp, работающим в фоне. Самим часам не нужны ни Wi-Fi, ни мобильный интернет: Bluetooth до телефона — их единственная связь.
Телефону, в свою очередь, нужен доступ к вашему серверу. Дома это локальная сеть. Вне дома нужен удалённый адрес, и если вы никогда не пользуетесь часами вне дома, он вам не понадобится.
Сначала локальный адрес, вне дома — удалённый
Можно указать два адреса: Локальный URL (LAN), например http://192.168.1.50:8123 (это пример), и Удалённый URL — для тех случаев, когда вы не дома. Любое из полей можно оставить пустым. Если заданы оба, AmazHA предпочитает локальный и сам переключается на удалённый, когда локальный не отвечает. Один токен подходит для обоих. В статье об удалённом доступе сравниваются Home Assistant Cloud, VPN и собственный домен.
Чем можно управлять с запястья
AmazHA поддерживает 17 типов устройств Home Assistant, и у каждого свой экран управления. На главном экране — ваши зоны с названиями из Home Assistant; в комнате устройства сгруппированы по типу; нажатие на плитку открывает полное управление. У света, выключателей и вентиляторов есть переключатель прямо на плитке, а сцены, скрипты, автоматизации и кнопки запускаются со своих плиток.
| Тип устройства | Домены Home Assistant | Что умеет экран на часах |
|---|---|---|
| Свет | light |
Ползунок яркости; колёсико меняет её с шагом 4%. Для света без регулировки яркости — простой круговой переключатель |
| Выключатель | switch |
Один большой переключатель |
| Вентилятор | fan |
Ползунок скорости и кнопка питания; у вентиляторов без настройки скорости — только переключатель |
| Климат | climate |
Целевая температура на круговой шкале, полградуса за шаг колёсика; режимы «выкл.», нагрев, охлаждение и авто |
| Шторы | cover |
Открыть, Стоп, Закрыть, плюс ползунок положения и колёсико, если шторы поддерживают положения |
| Замок | lock |
Закрывается одним нажатием; для открытия нужно второе нажатие для подтверждения |
| Сигнализация | alarm_control_panel |
Постановка на охрану в режимах, которые поддерживает ваша панель («дома», «ушёл»); для снятия нужен ваш код на клавиатуре |
| Медиа | media_player |
Воспроизведение, пауза, предыдущий и следующий трек, ползунок громкости (громкость задаёт колёсико) и питание — если плеер это поддерживает |
| Пылесос | vacuum |
Запуск, пауза, остановка и возврат на базу |
| Сцена | scene |
Запускается одним нажатием |
| Скрипт | script |
Запускается одним нажатием |
| Автоматизация | automation |
Срабатывает от одного нажатия |
| Кнопка | button, input_button |
Нажимается одним касанием |
| Селектор | select, input_select |
Список вариантов; нажмите на нужный, чтобы выбрать его |
| Датчик | sensor |
Текущее значение крупным шрифтом; датчики без класса показываются текстом (состояние почтового ящика, день вывоза мусора) |
| Камера | camera |
Снимок, который получает телефон, с кнопками Обновить и Эфир |
| Трекер | device_tracker, person |
Только чтение: дома, не дома или зона, с временем последнего обновления и зарядом, если Home Assistant их знает |
Датчики отфильтрованы по классам, которые имеют смысл на часах: температура, влажность, мощность, энергия, заряд батареи, качество воздуха, освещённость, давление и подобные. Диагностические датчики, например уровень сигнала или напряжение, а также метки времени намеренно не показываются.
Изменения оптимистичные: плитка переключается в момент нажатия, вызов уходит в Home Assistant в фоне, а следующее обновление поправит экран, если Home Assistant с ним не согласен.
Какие часы подходят
AmazHA работает на 25 моделях Amazfit с Zepp OS, с раскладкой для квадратных и круглых экранов. На круглых часах заголовки выровнены по центру, а списки занимают всё стекло.
| Форма | Модели |
|---|---|
| Квадратные | Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4 |
| Круглые | Active 2, Active 2 Golf, Active 3 Premium, Active Max, Balance, Balance 2, Balance 2 XT, Balance 3, Balance 3 Ti, Balance Ultra, Cheetah 2 Pro, Cheetah 2 Ultra, Cheetah Pro, Cheetah Round, Falcon, GTR 4, T-Rex 3, T-Rex 3 Pro, T-Rex Ultra, T-Rex Ultra 2 |
Трое часов исключены намеренно. У Active Edge и Bip 5 экраны слишком малы для раскладки, а у T-Rex 2 недостаточно памяти. Старые модели Zepp OS с уровнем API ниже 3.0 не поддерживаются. Ответ «да» или «нет» для каждой модели — в статье какие часы Amazfit работают с Home Assistant.
Быстрее всего проверить в самом магазине: в приложении Zepp откройте App Store и найдите AmazHA. Если ваши часы сопряжены и поддерживаются, приложение можно установить и попробовать демо.
Что нужно перед началом
Нужны четыре вещи: сервер Home Assistant, доступный с телефона, долгосрочный токен доступа администратора, приложение Zepp и сопряжённые с ним часы.
| Что нужно | Зачем |
|---|---|
| Home Assistant, доступный с телефона | Все запросы делает телефон. Дома достаточно локального адреса |
| Долгосрочный токен доступа администратора | AmazHA читает ваши зоны через API шаблонов, который Home Assistant открывает только администраторам |
| Приложение Zepp на Android или iPhone | Внутри него находятся настройки AmazHA и его телефонная половина |
| Поддерживаемые часы, сопряжённые по Bluetooth | Часы связываются с телефоном так же, как уже делает приложение Zepp |
Чтобы управлять устройствами, в Home Assistant ничего устанавливать не нужно: AmazHA использует REST API, который есть у любого сервера Home Assistant. Токен создаётся в Home Assistant в вашем профиле, на вкладке Безопасность; в статье о долгосрочном токене доступа описаны шаги и объяснено, почему токена обычного пользователя недостаточно.
Настройка за шесть шагов
Вся настройка занимает несколько минут, а первые два шага ничего не стоят. Для каждого шага есть короткий видеоурок.
1. Установите AmazHA
В приложении Zepp на телефоне откройте App Store, нажмите на значок поиска и введите AmazHA. Откройте AmazHA — Home Assistant Companion App и нажмите Установить: приложение сразу отправится на часы. Затем на часах откройте список приложений и выберите AmazHA. (Установка AmazHA)
2. Попробуйте демо
AmazHA открывается с демо-домом, в котором есть комнаты и устройства. Все экраны работают на тестовых данных без ограничения по времени: откройте комнату, нажмите на переключатель, покрутите колёсико на экране света. Это честный способ понять, каково приложение на ваших собственных часах, прежде чем за что-то платить. (Навигация на часах)
3. Разблокируйте один раз
На часах нажмите на оранжевый баннер Демо-режим · нет лицензии вверху главного экрана. Часы покажут пятизначный код. На телефоне откройте в браузере kzl.io/code, введите код, нажмите Continue и завершите оплату. Часы покажут Purchase Successful! и сами вернутся в приложение. Подробнее — ниже. (Разблокировка полной версии)
4. Подключите Home Assistant
В приложении Zepp перейдите в Профиль › ваши часы › Приложения › AmazHA › Настройки и нажмите Home Assistant. Укажите Локальный URL (LAN) и, если хотите пользоваться часами вне дома, Удалённый URL. Вставьте токен в поле Долгосрочный токен доступа и нажмите Подключиться. С одним адресом результат будет Подключено; с двумя — отдельно для LAN и Удалённого. (Подключение Home Assistant, начиная с шага 4)
5. Выберите устройства
В настройках AmazHA нажмите Устройства. Ваши комнаты уже там, а все устройства изначально скрыты: откройте комнату и включите то, чем пользуетесь. В длинных списках, например в зоне Прочее, куда попадают устройства без комнаты, есть поле Поиск; Показать все и Скрыть все действуют только на найденные устройства. У людей и телефонов своя зона — Трекеры. (Выбор устройств)
6. Откройте AmazHA на часах
На часах появятся ваши комнаты и устройства. С этого момента часы сразу запускаются с последними данными и обновляют их из Home Assistant, пока приложение открыто.
Настройте под себя
Всё, что меняет внешний вид часов, настраивается на телефоне, а часы берут это оттуда.
«Избранное» и «Избранное» в роли главного экрана
В разделе Устройства › Избранное включите Показывать на часах и выберите любые устройства из любых комнат — даже те, которые вы не включили в их комнате. Изменить порядок избранного задаёт их порядок. После этого Избранное идёт первым на главном экране часов. Включите Сделать «Избранное» главным экраном — и главным экраном часов станет только этот список, а загружаться будут только эти устройства. Зоны вернутся, когда вы выключите эту опцию. (Избранное и энергия, шаг 4)
Панель энергии
В разделе Устройства › Энергия включите Показывать панель энергии и выберите датчик для каждой роли, которая у вас есть: например, Мощность сети (со знаком), солнце, батарея, а также потребление и стоимость за сегодня. В списке только датчики, подходящие для роли. На главном экране часов появится зона Энергия с текущей мощностью сети (импорт или экспорт), а затем солнцем, батареей и итогами за сегодня. (Избранное и энергия)
Чипы главного экрана, порядок и значки комнат
В разделе Оформление › Чипы главного экрана каждый из трёх чипов вверху главного экрана может считать свет, выключатели, шторы, климат, медиа, замки, камеры или трекеры, а может показывать сигнализацию, вашу энергию или ничего. Порядок зон задаёт порядок зон, а нажатие на значок комнаты позволяет выбрать другой. В разделе Устройства у комнаты с датчиками температуры или влажности можно выбрать, какой датчик питает её чипы, чтобы внутренний датчик какого-нибудь устройства не перебивал датчик самой комнаты. (Настройка под себя)
Свои имена
Длинные имена из Home Assistant редко помещаются на плитку часов. В разделе Устройства у каждого устройства, которое показывают часы, после имени есть карандаш: нажмите на имя и введите новое в поле Имя на часах, до 32 символов. Часы используют его на всех экранах и в виджете, а в Home Assistant остаётся прежнее имя. Вернуть исходное имя возвращает его. Имена хранятся на телефоне и сохраняются после Сбросить кэш. (Свои имена и виджет)
Размер текста и карточек, вибрация и тайм-аут экрана
В разделе Параметры:
- Размер шрифта увеличивает весь текст на часах: 110%, 120% или 130%. Действует со следующего открытия AmazHA на часах.
- Размер карточек увеличивает карточки зон на главном экране и плитки устройств: 115%, 130% или 145%.
- Вибрация при действиях даёт короткий отклик, когда вы нажимаете на устройство, запускаете действие или поворачиваете колёсико на экране управления. По умолчанию выключена.
- Тайм-аут экрана задаёт, сколько экран остаётся включённым, пока AmazHA открыто: 30 секунд, 1 минута, 5 минут или Никогда — значение по умолчанию. «Никогда» также игнорирует опускание запястья: удобно, но сильнее расходует батарею.
Язык часов следует их системному языку; Язык в настройках меняет только страницу настроек. (Параметры)
Виджет на циферблате
Виджет выносит до четырёх ваших устройств на карточки быстрого доступа часов — в одно касание, не открывая приложение. Он входит в полную версию; в бесплатной версии он предлагает разблокировку.
Чтобы настроить его, откройте на телефоне Устройства › Виджет на часах и выберите до четырёх устройств в нужном порядке: слева направо, сверху вниз. Затем на часах проведите вправо от циферблата к карточкам быстрого доступа, нажмите Изменить и добавьте AmazHA. Пока вы ни разу не откроете приложение, на виджете написано Открыть AmazHA; после этого там появятся ваши устройства. (Свои имена и виджет, шаг 4)
Что делает нажатие на виджете, зависит от устройства:
| Устройство на виджете | Нажатие |
|---|---|
| Свет, выключатель, вентилятор | Включает или выключает его; виджет показывает новое состояние |
| Сцена, скрипт, кнопка, автоматизация | Запускает |
| Всё остальное (замок, шторы, датчик, камера) | Открывает его экран в AmazHA, где замок по-прежнему просит подтверждения |
Если команда не прошла, экран объясняет почему и предлагает Повторить и Открыть AmazHA; повтор никогда не выполняет действие дважды. Заголовок виджета всегда показывает, насколько свежи состояния, например AmazHA · 1 мин назад. Виджет становится серым, когда часы не в сети или состояниям 12 часов и больше, и тогда нажатие открывает приложение, которое его обновит. Изменения, сделанные на телефоне, попадают в виджет при следующем открытии AmazHA.
Одно практическое замечание: на новых часах обновление AmazHA, установленное, пока виджет стоит на циферблате, оставляет работать часть старой версии до перезапуска часов. До тех пор главный экран показывает Перезапустите часы.
Данные ваших часов в Home Assistant
AmazHA работает и в обратную сторону: оно может отправлять 18 показаний ваших часов в Home Assistant в виде сенсоров. Они приходят через собственную интеграцию Home Assistant Mobile App — как одно устройство со своими сенсорами с именами sensor.<prefix>_<key>.
Показания охватывают активность (шаги, расстояние, калории, часы активности стоя, интенсивные минуты, PAI), здоровье (пульс, пульс в покое, SpO2, стресс, температура тела, оценка сна, длительность сна, состояние сна), окружение (атмосферное давление, высота) и само устройство (батарея часов, часы на руке). Изначально все они выключены, и вы включаете только нужные в разделе Датчики часов › Отправлять в Home Assistant.
Часы отправляют данные при каждом открытии AmazHA. Чтобы обновления шли и при закрытом приложении, задайте Обновлять каждые (от 1 до 6 минут) и дайте разрешение Фоновая активность, когда часы его запросят; для каждого обновления телефон должен быть рядом. В Home Assistant часы находятся в разделе Настройки › Устройства и службы › Mobile App. В статье о датчиках часов — полная таблица и примеры автоматизаций. (Датчики часов)
Ограничения, о которых стоит знать
У приложения для часов, работающего через телефон, есть несколько ограничений, заложенных в саму схему, и о них лучше знать до покупки.
| Ограничение | Что это значит на практике |
|---|---|
| Телефон должен быть рядом | Нет связи по Bluetooth с телефоном — нет управления. Часы показывают Офлайн · Телефон не отвечает |
| Состояния обновляются, пока приложение открыто | Каждые 8 секунд, так что изменение, сделанное в другом месте, появляется за несколько секунд. При закрытом приложении ничего не обновляется |
| Home Assistant ничего не присылает сам | Часы запрашивают состояния; Home Assistant не может отправлять на часы уведомления или обновления через AmazHA |
| Не больше 100 устройств | Несколько десятков работают быстро. Экран «Устройства» советует не больше 40 на зону: на некоторых часах зона с 70 и более устройствами может исчерпать память и оставить экран чёрным |
| Вне дома нужен удалённый адрес | Только если хотите пользоваться часами вне дома; дома хватает локального адреса |
| Фоновое обновление датчиков | Нужны разрешение «Фоновая активность» и телефон в зоне досягаемости; иначе часы отправляют данные при открытии приложения |
| Только Zepp OS | Версия для Wear OS в разработке, без даты |
Первые две строки объясняют большинство сюрпризов. Если вы оставите телефон в другой комнате и выйдете из зоны действия Bluetooth, часы продолжат показывать последние данные, но ничего не смогут изменить. А если свет поменяется, пока AmazHA закрыто, часы покажут новое состояние при следующем открытии.
Если что-то пошло не так
Когда что-то не работает, часы сообщают, в чём дело, и у каждого сообщения есть одна обычная причина. Таблица повторяет урок «Если что-то не так», где каждому сообщению посвящён свой шаг.
| Часы показывают | Причина | Решение |
|---|---|---|
| Устройства не выбраны | Все устройства изначально скрыты | Включите нужные устройства в разделе Устройства в настройках AmazHA (шаг 1) |
| Офлайн · Телефон не отвечает | Часы не могут связаться с телефоном | Держите телефон рядом, с включённым Bluetooth и запущенным приложением Zepp (шаг 2) |
| Офлайн · Home Assistant недоступен | Телефон не может связаться с Home Assistant | Откройте свой адрес в браузере телефона: он должен работать там, где сейчас телефон, а вне дома ему нужен HTTPS с действительным сертификатом (шаг 3) |
| Неверный адрес | Адрес отвечает, но это не API Home Assistant | Укажите только адрес сервера, и ничего после него (без /lovelace) (шаг 4) |
| Нужен админ-токен | Токен принадлежит пользователю без прав администратора | Создайте новый долгосрочный токен под администратором и вставьте его (шаг 5) |
| Проверьте токен | В токене есть символ, которого в токенах не бывает, обычно из обрезанной копии (…) | Скопируйте его заново, целиком, и вставьте (шаг 6) |
| Часы тормозят или перезагружаются | Слишком много устройств | Держите выбор небольшим: несколько десятков работают быстро, 100 — предел (шаг 7) |
| Демо-режим · нет лицензии | Приложение не разблокировано | Нажмите на баннер и разблокируйте его (Разблокировка полной версии) |
| Демо-режим · Укажите сервер HA в приложении на телефоне | Разблокировано, но сервер ещё не указан | Введите адрес и токен в разделе Home Assistant в настройках (Подключение Home Assistant) |
| Перезапустите часы | Обновление установлено, пока виджет стоял на циферблате | Перезапустите часы |
Под баннером Офлайн часы добавляют Повтор каждые 8 с, так что, когда причина устранена, ничего делать не нужно, а под этим — короткую строку с кодом, которая точно подсказывает поддержке, что не сработало. Фото часов — самое полезное, что можно прислать.
Если ничего из списка не подходит, откройте Параметры, нажмите Сбросить кэш, затем Нажмите ещё раз для подтверждения. Это очищает кэшированные данные на часах и телефоне, а подключение, устройства и лицензия сохраняются; затем снова откройте AmazHA на часах (шаг 8). Если и это не помогло, форма Поддержка в настройках отправит отчёт вместе с вашим сообщением. В него никогда не попадают адрес вашего Home Assistant, токен или имена устройств.
Разбор примера: проверка зелёная, часы пустые
Частое сообщение в первый день: после Подключиться всё зелёное, а часы ничего не показывают. Почти все такие случаи сводятся к двум причинам. Либо ни одно устройство ещё не включено, и часы пишут Устройства не выбраны, либо токен принадлежит пользователю без прав администратора, и часы пишут Нужен админ-токен. Второе удивляет, потому что проверка подключения успешно читает состояния; Home Assistant отказывает обычному пользователю именно в определении зон через API шаблонов. Исправляется это новым токеном, созданным под учётной записью администратора.
Разблокировка полной версии
Разблокировка — разовый платёж с часов через KiezelPay: без аккаунта, без подписки, без рекламы. Она подключает AmazHA к вашему собственному Home Assistant, локально и удалённо, и включает датчики часов и виджет. До этого приложение — демо на тестовых данных, и ничего не уходит на настоящий сервер.
- На часах нажмите на оранжевый баннер Демо-режим · нет лицензии. Часы покажут пятизначный код.
- На телефоне откройте в браузере kzl.io/code.
- Введите код и нажмите Continue.
- Оплатите один раз, картой или через PayPal. Это пожизненная лицензия.
- Часы покажут Purchase Successful! и сами вернутся в приложение.
Урок Разблокировка полной версии показывает каждый экран, а в разделе о цене на главной странице перечислено, что входит в каждую версию.