Английский | Китайский
MIoT-Spec: Спецификация протокола для устройств Xiaomi IoT, разработана платформой Xiaomi IoT для описания определения функций аппаратных продуктов в соответствии с режимами сетевого подключения, характеристиками функциональных возможностей продукта, особенностями сценариев использования пользователями и требованиями к опыту использования аппаратных продуктов.
Этот компонент использует протокол miot для автоматической интеграции устройств Xiaomi в HomeAssistant, и в настоящее время поддерживает большинство устройств Xiaomi IoT. Поддерживается также графический интерфейс Home Assistant, что позволяет легко интегрировать устройства Xiaomi в Home Assistant без необходимости конфигурирования YAML.
HACS > Интеграции > ➕ Поиск и загрузка репозиторий >
Xiaomi Miot Автоматическая
> Загрузить этот репозиторий
HACS > Интеграции >
Xiaomi Miot Автоматическая
> Обновить / переустановить
Скачайте и скопируйте папку
custom_components/xiaomi_miot
в папкуcustom_components
в вашей директории конфигурации HomeAssistant
wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot bash -
# Или
wget -O - https://raw.githubusercontent.com/al-one/hass-xiaomi-miot/master/install.sh | ARCHIVE_TAG=latest bash -
configuration.yaml
shell_command:
update_xiaomi_miot: |-
wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot bash -
service: shell_command.update_xiaomi_miot
в разделе Разработочные инструменты⚙️ Конфигурация > Устройства и службы > 🧩 Интеграции > ➕ Добавить интеграцию > 🔍 Поиск
Xiaomi Miot Auto
Или нажмите:
Начиная с версии v0.4.4 компонент поддерживает выбор режима подключения устройства при интеграции по аккаунту:
Подходит для устройств, поддерживающих протокол miot-spec в локальной сети
Настройте облачную среду Xiaomi для устройств интегрированных по адресу хоста/токену```yaml
xiaomi_miot: username: xiaomi_username password: xiaomi_password
> [⚙️ Настройка](https://my.home-assistant.io/redirect/config) > Устройства и службы > [🧩 Интеграции](https://my.home-assistant.io/redirect/integrations) > Xiaomi Miot Auto > Опции > ☑️ Включить облачную службу miot### Переводы
> Жду вашего [вкладки](https://github.com/al-one/hass-xiaomi-miot/edit/master/custom_components/xiaomi_miot/core/translation_languages.py).
```yaml
# configuration.yaml
xiaomi_miot:
язык: zh # Используется встроенный словарь, в настоящее время поддерживаются только `zh`
# https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/translation_languages.py
переводы:
# Глобальный словарь
idle: 'Пустует'
busy: 'Занят'
# Словарь для указания режимов работы вентилятора
fan.mode:
straight_wind: 'Прямой поток'
natural_wind: 'Натуральный ветер'
# Словарь для указания уровней сушки стиральной машины
washer.drying_level:
moist: 'Мокро'
extra: 'Дополнительно'
# configuration.yaml
homeassistant:
customize: !include customize.yaml
# Настройка через модель устройства
xiaomi_miot:
# https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/device_customizes.py
устройство_настроек:
chuangmi.plug.212a01:
miot_local: true
chunk_properties: bk7
```# Настройка через родительскую сущность
# customize.yaml
домен.идентификатор_сущности:
miot_local: true # Принудительно читать и записывать данные в локальной сети (интегрироваться по аккаунту)
miot_cloud: true # Включить облачную службу miot для сущности (читать, писать, действие)
miot_cloud_write: true # Включить облачную службу miot (только запись)
miot_cloud_action: true # Включить облачную службу miot (только действие)
проверка_локальной_сети: true # Проверять соединение в локальной сети при работе в облаке
miio_свойства: мощность, батарея # Получать свойства miio для атрибутов состояния
miio_облачные_свойства: свойство.мощность, событие.устройство_онлайн# Настройка подсущностей
домен.родительский_идентификатор_сущности:
сенсорные_свойства: температура, влажность, освещение # Свойства MiOT
бинарные_сенсорные_свойства: отключен_голос, любое_логическое_свойство
выключатели_свойства: вкл, мощность
число_свойства: громкость
выбор_свойства: режим
вентилятор_свойства: режим, уровень_ветра
шторы_свойства: управление_двигателем
```yaml
light.your_entity_id:
color_temp_reverse: false # Обратный порядок цветовой температуры (требует перезагрузки конфигурационной записи)
yeelight_smooth_on: 2000 # миллисекунды (только для локального режима в Yeelight)
yeelight_smooth_off: 3000 # миллисекунды (только для локального режима в Yeelight)
climate.your_entity_id:
bind_sensor: sensor.temperature_entity, sensor.humidity_entity # Элементы сенсоров
camera.your_entity_id:
video_attribute: 1 # https://github.com/al-one/hass-xiaomi-miot/issues/11#issuecomment-773054167
keep_streaming: true # Непрерывное обновление адреса потока
cover.your_entity_id:
closed_position: 5 # Изменение состояния штор до закрытого при позиции ≤ 5%
deviated_position: 2 # Отклонение текущей позиции 2% -> 0%, 98% -> 100%
motor_reverse: true # Обратный порядок работы двигателя (требует перезагрузки конфигурационной записи)
position_reverse: true # Обратный порядок положения двигателя (требует перезагрузки конфигурационной записи)
open_texts: Открыть, Вверх
close_texts: Закрыть, Вниз
media_player.mitv_entity_id:
bind_xiaoai: media_player.xiaoai_entity_id # Привязка динамика XiaoAI для включения телевизора
```domain.your_entity_id_xxxx:
interval_seconds: 30 # Интервал времени между каждым обновлением состояния (требует перезагрузки конфигурационной записи)
chunk_properties: 10 # Частичное обновление свойств MiOT (локальная сеть)
reverse_state: true # Включение обратного порядка состояния бинарного сенсора
---
### Фильтрация атрибутов сущностей
> Слишком много атрибутов сущностей может привести к увеличению размера базы данных Home Assistant. Если некоторые атрибуты сущностей вам не нужны, вы можете настроить `exclude_state_attributes`, чтобы игнорировать их.
```yaml
# configuration.yaml
xiaomi_miot:
exclude_state_attributes:
- miot_type
- stream_address
- motion_video_latest
Этот компонент поддерживает перезагрузку конфигурации YAML (что позволяет избежать необходимости перезапуска экземпляра Home Assistant после изменения конфигурации YAML):
🔨 Инструменты разработчика > Конфигурация YAML > Перезагрузка конфигурации YAML > 🔍 Поиск
Xiaomi Miot Auto
(почти в самом низу списка)## Поддерживаемые устройства - 🔌 розетка / выключатель
Поскольку поддержка сервисного ответа HA существует уже некоторое время, этот компонент больше не генерирует события начиная с версии v0.7.18.
xiaomi_miot.set_property
service: xiaomi_miot.set_property
data:
entity_id: camera.isa_hlc7_xxxx
field: camera_control.on
value: true
xiaomi_miot.set_miot_property
service: xiaomi_miot.set_miot_property
data:
entity_id: camera.isa_hlc7_xxxx
siid: 2
piid: 1
value: true
xiaomi_miot.get_properties
service: xiaomi_miot.get_properties
data:
entity_id: camera.isa_hlc7_1ab7
mapping:
- siid: 2
piid: 1
- siid: 3
piid: 2
update_entity: true # Обновление атрибутов состояния сущности
xiaomi_miot.call_action
service: xiaomi_miot.call_action
data:
entity_id: vacuum.dreame_p2259_entity_id
siid: 4 # vacuum-extend
aiid: 1 # start-clean
params:
- 18 # piid: 1 - work-mode
- '{"selects":[[7,1,0,2,1]]}' # piid: 10 - clean-extend-data
```#### [`xiaomi_miot.send_command`](https://my.home-assistant.io/redirect/developer_call_service/?service=xiaomi_miot.send_command)
```yaml
service: xiaomi_miot.send_command
data:
entity_id: switch.your_entity_id
method: set_power
params:
- on
xiaomi_miot.get_token
service: xiaomi_miot.get_token
data:
name: Light # Key word for device name in Mihome / IP / Model.
xiaomi_miot.intelligent_speaker
service: xiaomi_miot.intelligent_speaker
data:
entity_id: media_player.xiaoai_lx04_xxxx
text: Включите свет
execute: true # Execute command.
silent: true # Silent mode execution.
xiaomi_miot.xiaoai_wakeup
service: xiaomi_miot.xiaoai_wakeup
data:
entity_id: media_player.xiaoai_lx04_xxxx
xiaomi_miot.renew_devices
service: xiaomi_miot.renew_devices
data:
username: 80001234 # Xiaomi account / Email / Phone number
xiaomi_miot.request_xiaomi_api
service: xiaomi_miot.request_xiaomi_api
data:
entity_id: sensor.your_entity_id
api: /v2/plugin/fetch_plugin
data:
latest_req:
api_version: 10070
plugins:
- model: brand.device.model
🔨 Инструменты разработчика > ℹ️ Состояние > 🔍 Фильтрация сущностей### Получение отладочных логов
# configuration.yaml
logger:
default: warning
logs:
custom_components.xiaomi_miot: debug
xiaomi_miot.get_token
, введите ключевое слово имени устройстваЗапись пользовательских лог-файлов
и Включение режима отладки приложения
vevs/logs/misc/devices.txt
после перезапуска приложенияCXVBFHHSRSI
)Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.