前言
homebridge-smarthome-plus 是一个基于 Homebridge 扩展的 npm 包,用于连接智能家居设备,以在 iOS 上使用 HomeKit 控制。本文将为大家介绍如何使用 homebridge-smarthome-plus 连接智能家居设备。
准备工作
安装 Homebridge
在开始使用 homebridge-smarthome-plus之前,我们需要先安装 Homebridge。Homebridge 是一个在非苹果设备上运行的开源软件,它能够将普通的智能家居设备变成兼容 HomeKit 的设备,让你的非苹果设备也能通过 iOS 控制 HomeKit。
Homebridge 的安装请参考:Homebridge 安装指南
安装 homebridge-smarthome-plus
在安装完 Homebridge 后,我们需要安装 homebridge-smarthome-plus:
sudo npm install -g homebridge-smarthome-plus
设备兼容性
HomeKit 并非支持所有智能家居设备。在使用 homebridge-smarthome-plus 之前,请先确认你的设备是否兼容 HomeKit。你可以在苹果官网上查找支持 HomeKit 的设备列表:https://www.apple.com/cn/ios/home/accessories/
查找智能家居设备信息
在使用 homebridge-smarthome-plus 联接智能家居设备之前,我们需要了解设备的信息,包括设备名称、设备 ID、控制方式等。你可以从设备厂商提供的文档中找到这些信息。
使用 homebridge-smarthome-plus
1. 创建配置文件
在 Homebridge 安装目录下创建一个新的配置文件 config.json,然后输入以下内容:
-- -------------------- ---- ------- - --------- - ------- ------------- ----------- -------------------- ------- ------ ------ ------------ -- -------------- ----- -- -- ------- ------------- --- ----- ---- ------ ------------ - - ----------- ---------------- ------- ------ ---- ------ ---------- - - ------- ------- --- ---------------- ------ ----------- --------- --------------- ------------- --- -------- ------- ----- --- --------- ------- ------ --- -------------- ------------------------------------------------------------------- --------------- ------------------------------------------------------------------ -- - ------- ------- --- ---------------- ------------ ----------- --------- --------------- ------------- --- -------- ------- ----- --- --------- ------- ------ --- -------------- ------------------------------------------------------------------- --------------- ------------------------------------------------------------------ - - - - -
配置文件详解
- bridge: 描述 Homebridge 服务器的信息
- description: 描述该配置文件的信息
- platforms: 定义 homebridge-smarthome-plus 的配件信息
- devices: 描述每个配件的信息,包括名称、型号、ID、访问令牌等
接下来,我们逐一解析一下配置信息。
bridge
- name: Homebridge 服务器的名称
- username: 该服务器的 MAC 地址
- pin: HomeKit 配对码。该代码用于将设备连接到 HomeKit。请注意,你可以自定义该配对码,但需要注意配对码的规范。
platforms
- platform: 连接到 homebridge-smarthome-plus 的设备平台
- name: 该平台的名称
- devices: 或多个配件节点的信息,每个智能家居设备都可以被视为一个配件,需要将其信息填入此节点中。
devices
- accessoryType: 物联网设备类型。当前支持 Air Conditioner、DoorLock、Fan、HumidifierDehumidifier、Lightbulb、Outlet 等类型。
- name: 配件名称
- deviceId: 物联网设备 ID
- manufacturer: 物联网设备厂商
- model: 物联网设备型号
- serial: 物联网设备序列号
- accessToken 和 refreshToken: 智能家居设备的访问授权码,使用其中的访问令牌和更新标记。
2. 联接智能家居设备
在创建好配置文件后,通过以下命令启动 homebridge-smarthome-plus:
homebridge
在 Terminal 中输入该命令并按 Enter,然后你将会在终端窗口中看到类似以下的信息:
-- -------------------- ---- ------- ----------- ------- --- ------ ------- ------------------------- ----------- ------- --- ----------- --------- ------- -- ----------- ------- --- ----------- --------- ------- -- ----------- ------- --- ----------------- ---------- ---- -------- --- ---------- --- -------- ----- ---------- --------- --------- -------- ----- ---------- ------ -------- ----- ----------- ------- --- ----------- ------------ --------- -------- ----------- ------- --- --------------- ------------ ------------- ----------- ----------- ------- --- --------------- -------- ------------ ------------- ---------
这表示 homebridge-smarthome-plus 已经成功连接到你配置的智能家居设备。
3. 在 HomeKit 中添加智能家居设备
在联接好智能家居设备后,就可以在 iOS 上的 HomeKit 中添加该设备了。在 Homekit 中,点击「添加设备」,然后按照提示完成连接,你就可以在 iOS 上控制你的智能家居设备了。
示例代码
以下是一个简单的 homebridge-smarthome-plus 示例代码,用于连接一个 Sonoff 智能开关:
-- -------------------- ---- ------- - --------- - ------- ------------- ----------- -------------------- ------- ------ ------ ------------ -- -------------- ----- -- -- ------- ------------- --- ----- ---- ------ ------------ - - ----------- ---------------- ------- ------ ---- ------ ---------- - - ------- -------- ---------------- ------------ ----------- --------- --------------- --------- -------- ------- ------- --------- ---------- -------------- ------------------------------------------------------------------- --------------- ------------------------------------------------------------------ -- - - - -
在上面的示例代码中,我们以 Sonoff 智能开关为例,将其作为一个智能家居设备进行了连接。在配置文件中,我们需要为 SONOFF 开关提供设备信息,来指明其连接到 HomeKit 。在这里,「deviceId」是 SONOFF 开关的 Wi-Fi ID,而「accessToken」和「refreshToken」代表设备的访问令牌和更新标记。
结语
通过使用 homebridge-smarthome-plus,你可以将非 HomeKit 兼容的智能家居设备接入到 HomeKit,并使用 HomeKit 控制这些设备。上面的教程是基于 Homebridge 平台,希望本文对您有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60057c4181e8991b448ebc6b