xiaomi-mi-air-purifier 的安装和配置教程

项目基础介绍

xiaomi-mi-air-purifier 是一个开源项目，旨在为小米空气净化器提供 HomeKit 支持。通过这个项目，用户可以使用苹果的 HomeKit 应用控制和管理小米空气净化器。项目主要使用 TypeScript 编程语言开发。

项目使用的关键技术和框架

本项目使用了以下关键技术和框架：

• Homebridge: 一个开源的 HomeKit 服务器，允许你通过 HomeKit 控制非 HomeKit 设备。
• TypeScript: 一种由微软开发的开源编程语言，它是 JavaScript 的一个超集，为 JavaScript 提供了类型系统和其他功能。

项目安装和配置的准备工作

在开始安装和配置之前，请确保你的系统已经满足了以下要求：

• 安装了 Node.js（推荐使用最新版）。
• 安装了 Homebridge。
• 已经获取了小米空气净化器的设备 token 和 IP 地址。

安装步骤

1. 安装 Homebridge（如果尚未安装）：

   在终端中运行以下命令来全局安装 Homebridge：

   npm install -g homebridge
   

2. 克隆项目代码：

   在合适的位置克隆本项目：

   git clone https://github.com/torifat/xiaomi-mi-air-purifier.git
   

3. 安装项目依赖：

   进入项目目录，安装必要的 npm 依赖：

   cd xiaomi-mi-air-purifier
   npm install
   

4. 配置 Homebridge：

   使用 Homebridge Config UI X 进行配置，或者直接编辑 config.json 文件。在 accessories 数组中添加以下内容，并替换 <YOUR_DEVICE_IP_ADDRESS> 和 <YOUR_DEVICE_TOKEN> 为你的设备信息：

   {
     "accessories": [
       {
         "name": "Air Purifier",
         "address": "<YOUR_DEVICE_IP_ADDRESS>",
         "token": "<YOUR_DEVICE_TOKEN>",
         "enableAirQuality": true,
         "enableTemperature": true,
         "enableHumidity": true,
         "filterChangeThreshold": 5,
         "enableFanSpeedControl": true,
         "enableChildLockControl": true,
         "accessory": "XiaomiMiAirPurifier"
       }
     ]
   }
   

5. 启动 Homebridge：

   在终端中运行以下命令来启动 Homebridge 服务：

   homebridge
   

6. HomeKit 配对：

   打开你的设备上的 Home 应用，点击右上角的加号图标，然后选择“添加配件”。选择“我没有代码或无法扫描”，然后按照指示完成配对。

现在，你应该能够在 Home 应用中看到你的小米空气净化器，并且可以像其他 HomeKit 设备一样进行控制了。