Homebridge SwitchBot 集成教程

Homebridge SwitchBot 集成教程

homebridge-switchbot The Homebridge SwitchBot plugin allows you to access your SwitchBot Device(s) from HomeKit. Homebridge. 项目地址: https://gitcode.com/gh_mirrors/ho/homebridge-switchbot

1. 项目介绍

Homebridge SwitchBot 是一个开源项目，它允许用户通过 HomeKit 使用 Homebridge 来控制 SwitchBot 设备。SwitchBot 是一系列智能家居设备，包括窗帘开关、温度湿度计、机器人等，可以通过蓝牙或 OpenAPI 连接。Homebridge 是一个开源的智能家居桥接器，可以将各种智能家居设备集成到 Apple HomeKit 中。

2. 项目快速启动

环境要求

• Node.js
• Homebridge
• SwitchBot App

安装步骤

首先，确保你已经安装了 Homebridge。然后，通过以下命令安装 Homebridge SwitchBot 插件：

npm install -g homebridge-switchbot

接下来，配置你的 Homebridge：

1. 在 Homebridge 配置文件中（通常是 config.json），添加以下内容：

{
  "plugins": [
    "homebridge-switchbot"
  ],
  "platforms": [
    {
      "platform": "SwitchBot",
      "name": "SwitchBot Platform"
    }
  ]
}

2. 如果你使用的是 OpenAPI 连接，你需要在 SwitchBot App 中生成一个 Token 和 Secret，并将它们添加到配置文件中。

3. 如果你使用的是蓝牙连接，你需要知道设备的 BLE MAC 地址，并将其添加到配置文件中。

配置示例

以下是使用 OpenAPI 的配置示例：

{
  "platforms": [
    {
      "platform": "SwitchBot",
      "name": "SwitchBot Platform",
      "apiToken": "your_api_token",
      "apiSecret": "your_api_secret"
    }
  ]
}

使用蓝牙连接的配置示例：

{
  "platforms": [
    {
      "platform": "SwitchBot",
      "name": "SwitchBot Platform",
      "devices": [
        {
          "name": "Device Name",
          "type": "bot",
          "address": "ble_mac_address"
        }
      ]
    }
  ]
}

保存配置文件后，重新启动 Homebridge。

3. 应用案例和最佳实践

• 自动化窗帘：使用 SwitchBot Curtain 设备，可以通过 HomeKit 创建自动化规则，如定时打开或关闭窗帘。
• 温度监控：结合 SwitchBot 温度湿度计，可以在 HomeKit 中实时监控家中的温度和湿度。
• 远程控制：通过 HomeKit 的远程访问功能，即使不在家，也可以控制 SwitchBot 设备。

4. 典型生态项目

• Homebridge：作为 HomeKit 的桥接器，Homebridge 支持众多智能家居设备，SwitchBot 只是其中之一。
• Node-RED：一个可视化编程工具，可以与 Homebridge 和 SwitchBot 集成，实现更复杂的自动化流程。
• Home Assistant：另一个智能家居平台，可以与 SwitchBot 和 Homebridge 一起使用，提供更多集成和自动化选项。

homebridge-switchbot The Homebridge SwitchBot plugin allows you to access your SwitchBot Device(s) from HomeKit. Homebridge. 项目地址: https://gitcode.com/gh_mirrors/ho/homebridge-switchbot