{"id":13459217,"url":"https://github.com/ha0y/xiaomi_miot_raw","last_synced_at":"2025-05-15T09:06:53.989Z","repository":{"id":37642636,"uuid":"325470745","full_name":"ha0y/xiaomi_miot_raw","owner":"ha0y","description":"All-in-one \u0026 Easy-to-use. Integrate all your Xiaomi Smart Home - with a single integration and NO YAML files - into Home Assistant.","archived":false,"fork":false,"pushed_at":"2024-01-06T15:41:41.000Z","size":2785,"stargazers_count":2195,"open_issues_count":264,"forks_count":230,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-04-14T15:00:54.736Z","etag":null,"topics":["hacs","home-assistant","home-assistant-addons","homeassistant","miot","miot-protocol","xiaomi","xiaomi-miot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ha0y.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-12-30T06:13:35.000Z","updated_at":"2025-04-08T13:42:35.000Z","dependencies_parsed_at":"2024-02-17T03:31:35.402Z","dependency_job_id":null,"html_url":"https://github.com/ha0y/xiaomi_miot_raw","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha0y%2Fxiaomi_miot_raw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha0y%2Fxiaomi_miot_raw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha0y%2Fxiaomi_miot_raw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha0y%2Fxiaomi_miot_raw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ha0y","download_url":"https://codeload.github.com/ha0y/xiaomi_miot_raw/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254310515,"owners_count":22049469,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs","home-assistant","home-assistant-addons","homeassistant","miot","miot-protocol","xiaomi","xiaomi-miot"],"created_at":"2024-07-31T09:01:10.664Z","updated_at":"2025-05-15T09:06:53.974Z","avatar_url":"https://github.com/ha0y.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Xiaomi MIoT for Home Assistant\n\n简体中文 | [English](https://github.com/ha0y/xiaomi_miot_raw/blob/add-miot-support/README_en.md)\n\n[![version](https://img.shields.io/github/manifest-json/v/ha0y/xiaomi_miot_raw?filename=custom_components%2Fxiaomi_miot_raw%2Fmanifest.json)](https://github.com/ha0y/xiaomi_miot_raw/releases/latest) [![stars](https://img.shields.io/github/stars/ha0y/xiaomi_miot_raw)](https://github.com/ha0y/xiaomi_miot_raw/stargazers) [![issues](https://img.shields.io/github/issues/ha0y/xiaomi_miot_raw)](https://github.com/ha0y/xiaomi_miot_raw/issues) [![HACS](https://img.shields.io/badge/HACS-Default-orange.svg)](https://hacs.xyz)\n\n### 2021.9.14：🎉现在支持小爱万能遥控模拟出的红外设备啦！首批支持`灯`、`电视`、`空调`品类虚拟设备，接入 HA 后直接显示为对应类型设备并可以控制！欢迎试用，[如有问题可讨论\u003e\u003e](https://github.com/ha0y/xiaomi_miot_raw/issues/239)\n\n## 介绍\n\nMIoT 协议是小米智能家居从 2018 年起推行的智能设备通信协议规范，此后凡是已接入米家的设备均可通过此协议进行通信。此插件按照 MIoT 协议规范与米家设备或小米服务器通信，实现对设备的状态读取及控制。\n\n通过本插件，已接入米家的智能设备均可快速高效地接入 Home Assistant，而无关设备的具体型号。**本插件已全面支持图形界面配置，全程无需编辑配置文件。**\n\n本插件具有本地（局域网）和云端两种工作方式。两种方式结合，可以接入绝大多数米家智能设备（包括蓝牙、蓝牙 Mesh 和 ZigBee 设备）。\n\n如果对您有帮助，欢迎给个 Star！🌟  \n欢迎加入 MIoT 插件交流群，在这里您不仅可以快速地得到插件相关问题的解答，还可与大家交流智能家居心得，畅所欲言！  \n1 群： **982 100 289**（已满）  2 群： **789 221 593**\n\n## 安装或升级\n\n以下两种安装/升级方法，选择其中一种即可。  \n请不要使用一种方法安装然后用另一种方法升级，可能导致问题。\n\n### 通过 HACS 自动安装\n\n1. 打开 Home Assistant 的 HACS 页面。\n2. 点击`集成`。\n3. 点击右下角的`浏览并添加存储库`。\n4. 在新打开的页面中找到`Xiaomi MIoT`，安装即可。  \n**注意**：如果您刚刚安装好 HACS，或者网络不通畅，您可能看不到`Xiaomi MIoT`插件，而能看到带有其他后缀的插件。  \n**`Xiaomi MIoT`插件名称不带任何后缀，请注意识别。** 如果在 HACS 中找不到此插件，可以使用下面的手动安装方法。\n5. 重新启动 Home Assistant。\n\n- **如需升级：** 在您打开 HACS 页面时，会自动出现升级提示。按照提示操作即可。\n\n### 手动安装\n1. 下载插件 [zip 压缩包](https://github.com/ha0y/xiaomi_miot_raw/archive/refs/heads/master.zip)（该链接始终为最新版本）。\n2. 依次打开压缩包中的`xiaomi_miot_raw-master`/`custom_components`文件夹。\n3. 将该文件夹中的`xiaomi_miot_raw`文件夹拷贝至自己 HA 安装目录的`custom_components`文件夹。\n4. 重新启动 Home Assistant。\n\n\u003e 若不知道自己的 HA 安装目录：在 HA 中点击`配置`-底部`信息`，页面中的`configuration.yaml 路径`即为 HA 的安装目录。  \n\u003e 若无`custom_components`文件夹，可自己新建。\n\n- **如需升级：** 下载最新版插件压缩包后，按照上述方法，覆盖原有文件即可。\n\n\n## 使用方法\n**本插件已实现全面 UI 化，所有配置均可通过 UI（网页端）完成，无需您编辑配置文件。**\n\n**对于您可能遇到的细节问题，例如空调没有温度传感器、晾衣架显示方向是反的、需要指示灯童锁开关等，作者都已经考虑到了，别忘了看[特色功能](https://github.com/ha0y/xiaomi_miot_raw#%E7%89%B9%E8%89%B2%E5%8A%9F%E8%83%BD)部分！**\n\n对本插件进行配置有以下两种途径：\n\n**途径 1**：点击集成页面右下角的`添加集成`，然后选择`Xiaomi MIoT`。  \n如果您想要登录账号、添加设备，请使用此途径。\n\n**途径 2**：在集成页面找到已添加的设备/账号，然后点击`选项`。  \n如果您想要修改账号地区、修改已添加设备的选项，请使用此途径。\n\n---\n**首次使用建议您先登录小米账号。**\n\n\u003cdetails\u003e\n\u003csummary\u003e登录小米账号的方法，请点击查看\u003c/summary\u003e\n\n![HACS中不支持显示图片，请在浏览器中打开查看](images/flow/1.png)\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/2.png\" width=\"500\"/\u003e\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/3.png\" width=\"500\"/\u003e\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/4.png\" width=\"500\"/\u003e\n\u003c/details\u003e\n\n**登录账号后，即可立即选择要添加的设备。**\n\n**后续如需添加更多设备，再次通过`途径 1`进入插件，即可选择要添加的设备。**\n\u003cdetails\u003e\n\u003csummary\u003e图片步骤说明\u003c/summary\u003e\n\n![1](images/flow/1.png)\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/8.png\" width=\"500\"/\u003e\n\u003c/details\u003e\n\n**如需添加多个传感器设备，使用此方法会更加快捷：**\n\u003cdetails\u003e\n\u003csummary\u003e批量添加设备步骤说明\u003c/summary\u003e\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/5.png\" width=\"500\"/\u003e\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/6.png\" width=\"500\"/\u003e\n\n\u003cimg src=\"https://github.com/ha0y/xiaomi_miot_raw/raw/master/images/flow/7.png\" width=\"500\"/\u003e\n\u003c/details\u003e\n\n## 特色功能\n\n**对设备进行细微调整，使之更适合您的实际情况：**\n1. 对于所有类型的设备，指示灯和童锁的开关默认是隐藏的。您可以通过`途径 2`启用它们。\n2. 对于空调类实体，可以指定一个温度传感器作为该空调实体的温度来源。您可以通过`途径 2`来设置。\n3. 对于卷帘类实体，如果出现上/下位置颠倒的情况，您可以通过`途径 2`来反转位置。注：此功能只改变 HA 的显示，不会反转电机方向。\n4. 设备的部分选项（如模式）支持删除或修改名称，例如将风扇的模式修改为中文。您可以在`途径 1`添加设备时，修改“配置参数”来实现。\n\n## 技术支持\n如果在插件使用上遇到问题，可加入 QQ 群，大多数问题并非插件本身的问题，在 QQ 群中能更快地得到解答。若是插件存在 Bug，可通过 GitHub 的 Issue 功能提交问题，这样便于跟踪。\n\n这里有一个[常见问题列表](https://github.com/ha0y/xiaomi_miot_raw/issues?q=is%3Aissue+label%3AFAQ+)，汇总了许多常见的或具有共性的问题。\n\n您可以先[看看 Issue 列表](https://github.com/ha0y/xiaomi_miot_raw/issues)，找找您的问题是否已经有人提出或者已经有办法解决了？  \n如果没有的话，可点击绿色的`New Issue`按钮提交新问题。\n\n在某些情况下，插件作者可能需要您提供更为详细的调试日志。启用详细日志的方法是：\n\n```yaml\n# configuration.yaml\n\nlogger:\n  default: warn\n  logs:\n    custom_components.xiaomi_miot_raw: debug\n    miio: debug\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fha0y%2Fxiaomi_miot_raw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fha0y%2Fxiaomi_miot_raw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fha0y%2Fxiaomi_miot_raw/lists"}