al-one/hass-xiaomi-miot

This is a custom integration for Home Assistant (the open-source home automation platform) that brings Xiaomi smart home devices into the Home Assistant dashboard. It uses a Xiaomi protocol called MIoT-Spec, which describes the capabilities of Xiaomi hardware in a standardized way, to automatically discover and configure most Xiaomi devices without manual setup. The integration supports three categories of Xiaomi device: Wi-Fi connected devices, BLE (Bluetooth Low Energy) devices, and ZigBee devices. You can add all your devices at once by logging in with a Mi Account, or add individual devices by entering their local IP address and access token. For account-based setup, the integration can connect to each device either over your local network or through the Xiaomi cloud, depending on what the specific device supports. Installation is done through HACS (Home Assistant Community Store), the standard way to add third-party integrations to Home Assistant. Once installed, setup happens through Home Assistant's web interface without editing any configuration files. For users who want more control, the integration also supports YAML customization for individual devices, including options like forcing local-only connections, mapping custom sensor properties, reversing motor direction on blinds, and adjusting light transition speeds for Yeelights. The integration is available in English and Chinese, with a translation dictionary that can be extended by contributors. The README is written in both languages. The tool is designed to cover a broad range of Xiaomi products: smart plugs, air purifiers, robot vacuums, lights, cameras, air conditioners, washing machines, kettles, and more, all brought into a single Home Assistant interface that works independently of the Xiaomi app.