Anglais | 简体中文
MIoT-Spec : La spécification de protocole pour les appareils Xiaomi IoT, est une norme conçue par la plateforme Xiaomi IoT pour décrire la définition des fonctions des produits matériels en fonction du mode de mise en réseau des produits matériels, des caractéristiques des fonctions du produit, des caractéristiques des scénarios d'utilisation des utilisateurs. et les exigences de l'utilisateur en matière de spécification de l'expérience d'utilisation du produit matériel.
Ce composant utilise le protocole miot pour intégrer automatiquement les appareils Xiaomi dans HomeAssistant et prend actuellement en charge la plupart des appareils Xiaomi IoT. Et il prend en charge HA Web UI, et vous pouvez facilement intégrer des appareils Xiaomi dans HA sans configurer yaml.
HACS > Intégrations > ➕ EXPLORER ET TÉLÉCHARGER DES DÉPÔTS >
Xiaomi Miot Auto
> TÉLÉCHARGER CE DÉPÔT
HACS > Intégrations >
Xiaomi Miot Auto
> MISE À JOUR / Retéléchargement
Téléchargez et copiez le dossier
custom_components/xiaomi_miot
dans le dossiercustom_components
de votre dossier de configuration HomeAssistant.
wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot bash -
# Or
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
dans les outils de développementConfiguration > Appareils et services > ? Intégrations > ➕ Ajouter une intégration > ? Rechercher
Xiaomi Miot Auto
Ou cliquez sur :
À partir de la version v0.4.4, le composant a ajouté la prise en charge de la sélection du mode du périphérique de connexion lorsqu'il est intégré par compte :
Convient aux appareils prenant en charge le protocole miot-spec en LAN
Configurer le cloud Xiaomi pour les appareils intégrés par hôte/jeton
# configuration.yaml
xiaomi_miot :
username : xiaomi_username
password : xiaomi_password
# server_country: cn # Location of xiaomi cloud: cn(default), de, i2, ru, sg, tw, us
# http_timeout: 15 # Timeout (seconds) for requesting the xiaomi apis
Configuration > Appareils et services > ? Intégrations > Xiaomi Miot Auto > Options > ☑️ Activer miot cloud
Dans l'attente de votre contribution.
# configuration.yaml
xiaomi_miot :
language : zh # Using the built-in dictionary, currently only `zh` is supported
# https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/translation_languages.py
translations :
# Global dictionary
idle : '空闲'
busy : '工作中'
# Dictionary for specifying fan modes
fan.mode :
straight wind : '直吹模式'
natural wind : '自然风'
# Dictionary for specifying the drying modes of the washer
washer.drying_level :
moist : '微湿'
extra : '特干'
# configuration.yaml
homeassistant :
customize : !include customize.yaml
# Customize via device model
xiaomi_miot :
# https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/device_customizes.py
device_customizes :
chuangmi.plug.212a01 :
miot_local : true
chunk_properties : 7
# Customize via parent entity
# customize.yaml
domain.your_entity_id :
miot_local : true # Force to read and write data in LAN (integrate by account)
miot_cloud : true # Enable miot cloud for entity (read, write, action)
miot_cloud_write : true # Enable miot cloud (only write)
miot_cloud_action : true # Enable miot cloud (only action)
check_lan : true # Check LAN connection in cloud mode
miio_properties : power,battery # Get miio properties to state attributes
miio_cloud_props : prop.power,event.dev_online
# Custom sub entities
domain.parent_entity_id :
sensor_properties : temperature,humidity,illumination # Miot properties
binary_sensor_properties : is_volume_muted,any_boolen_property
switch_properties : on,power
number_properties : volume
select_properties : mode
fan_properties : mode,fan_level
cover_properties : motor_control
light.your_entity_id :
color_temp_reverse : false # Reverse color temperature (Requires reload config entry)
yeelight_smooth_on : 2000 # milliseconds (Only for Yeelights in local mode)
yeelight_smooth_off : 3000 # milliseconds (Only for Yeelights in local mode)
climate.your_entity_id :
bind_sensor : sensor.temperature_entity,sensor.humidity_entity # Sensor entities
camera.your_entity_id :
video_attribute : 1 # https://github.com/al-one/hass-xiaomi-miot/issues/11#issuecomment-773054167
keep_streaming : true # Continuously update stream address
cover.your_entity_id :
closed_position : 5 # Change cover state to closed when position <= 5%
deviated_position : 2 # Current position deviation 2% -> 0%, 98% -> 100%
motor_reverse : true # Reverse motor state (Requires reload config entry)
position_reverse : true # Reverse motor position (Requires reload config entry)
open_texts : Open,Up
close_texts : Close,Down
media_player.mitv_entity_id :
bind_xiaoai : media_player.xiaoai_entity_id # Bind xiaoai speaker for turn on TV
domain.your_entity_id_xxxx :
interval_seconds : 30 # Seconds between each update state (Requires reload config entry)
chunk_properties : 10 # Chunk miot properties on update state (LAN)
reverse_state : true # Reverse the On/Off state of a binary sensor
Trop d'attributs d'entité rendront la base de données de votre HA très volumineuse. Si certains attributs d'entité vous sont inutiles, vous pouvez configurer
exclude_state_attributes
pour les ignorer.
# configuration.yaml
xiaomi_miot :
exclude_state_attributes :
- miot_type
- stream_address
- motion_video_latest
Ce composant a ajouté la prise en charge du rechargement de la configuration (pour éviter d'avoir à redémarrer l'instance HomeAssistant après une modification de configuration YAML) :
? Outils de développement > Configuration YAML > Rechargement de la configuration YAML > ? Recherchez
Xiaomi Miot Auto
(presque en bas de la liste)
Ce composant utilise la méthode d'interrogation pour obtenir l'état de l'appareil, il ne peut donc pas écouter les événements de certains appareils en temps réel.
La réponse du service de support HA étant attendue depuis un certain temps, ce composant ne déclenche plus d'événements à partir de la 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 # Update to entity state attributes
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
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 # Keyword of device name in Mihome / IP / Model.
xiaomi_miot.intelligent_speaker
service : xiaomi_miot.intelligent_speaker
data :
entity_id : media_player.xiaoai_lx04_xxxx
text : Turn on the light
execute : true # Execute text directive.
silent : true # Silent 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 ID / Email / Phone
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
Plus de services
? Outils de développement > État > ? Filtrer l'entité
# configuration.yaml
logger :
default : warning
logs :
custom_components.xiaomi_miot : debug
Configuration > Système > ✍️ Journaux
xiaomi_miot.get_token
, entrez le mot-clé du nom de l'appareilWrite custom log files
et Enable app's debug mode
vevs/logs/misc/devices.txt
après le redémarrage de l'applicationCXVbfhHuSRsi
)