小米/石头扫地机器人Homebridge插件使用指南

小米/石头扫地机器人Homebridge插件使用指南

homebridge-xiaomi-roborock-vacuumA Xiaomi Roborock vaccum plugin (1st, 2nd and 3rd generation) for homebridge.项目地址:https://gitcode.com/gh_mirrors/ho/homebridge-xiaomi-roborock-vacuum

1. 项目介绍

本项目为一款专为小米及石头（Roborock）品牌第一代至第三代扫地机器人的Homebridge插件。通过此插件，您可以在Apple的Home App中便捷控制您的智能吸尘器，尽管目前HomeKit不原生支持真空吸尘器类别，此插件巧妙地将设备模拟成风扇以便于管理和使用。它利用了miio库的一个衍生版本来实现与设备的通信，提供了包括开关控制、虚拟风扇速度调节、电池状态监控以及低电量提醒等丰富功能。

2. 项目快速启动

安装前准备

确保您的系统已安装Homebridge 和 Node.js 环境。

步骤

1. 克隆或下载插件

   git clone https://github.com/homebridge-xiaomi-roborock-vacuum/homebridge-xiaomi-roborock-vacuum.git
   

2. 进入项目目录

   cd homebridge-xiaomi-roborock-vacuum
   

3. 安装依赖

   使用npm安装所有必需的依赖：

   npm install
   

4. 配置Homebridge

   在Homebridge的配置文件config.json中添加以下示例配置段落，替换相应的设备ID和你的API token。您可以通过第三方工具或者小米Home App获取设备信息。

   {
     "platforms": [
       {
         "platform": "XiaomiRoborockVacuum",
         "name": "Xiaomi Vacuum",
         "devices": [
           {
             "id": "your_device_id",
             "token": "your_api_token"
           }
         ]
       }
     ]
   }
   

5. 启动Homebridge

   启动您的Homebridge服务，插件随之加载。

   sudo homebridge
   

6. 在Home App中添加

   打开iPhone或iPad上的Home App，您的小米或石头扫地机应出现在配件列表中，可作为“风扇”进行控制。

3. 应用案例和最佳实践

• 自动化场景：设置自动化任务，如当家中无人时自动清扫。
• 定时清理：通过Home App定时功能，安排每日清洁时间。
• 区域限制：虽然本插件直接控制有限，但结合其他智能家居系统，可以间接实现特定区域的清扫限制。

4. 典型生态项目

小米智能家居生态系统内，该插件可以与其他支持HomeKit的小米设备如智能插座、温湿度传感器等集成，实现智能化联动。例如，当室内灰尘水平超过预设值时，自动触发扫地机器人的清扫任务。此外，通过Homebridge的广泛插件支持，理论上可以与数千种不同品牌的智能家居产品协同工作，构建个性化的智能家庭环境。

---

请注意，为了安全起见，请勿公开分享您的设备ID和API token，并且定期检查插件更新以保持其兼容性和安全性。

homebridge-xiaomi-roborock-vacuumA Xiaomi Roborock vaccum plugin (1st, 2nd and 3rd generation) for homebridge.项目地址:https://gitcode.com/gh_mirrors/ho/homebridge-xiaomi-roborock-vacuum