前言
在前端开发中，我们经常需要使用一些 npm 包来简化开发流程，提高开发效率。在家庭自动化领域，homebridge-tado-manual 是一个非常有用的 npm 包，它通过 Homebridge 技术，使得在苹果 HomeKit 平台下，我们可以控制 Tado 温控系统。本文将介绍 homebridge-tado-manual 的基本使用方法，以及如何进行扩展和配置。
安装
首先，我们需要在系统环境中全局安装 Homebridge：
$ sudo npm install -g --unsafe-perm homebridge
接着，我们可以通过 npm 安装 homebridge-tado-manual：
$ sudo npm install -g homebridge-tado-manual
使用
安装完毕后，在我们的 Homebridge 配置文件（一般是 ~/.homebridge/config.json）中添加 homebridge-tado-manual：
"platforms": [{
"platform": "TadoThermostat",
"name": "Tado",
"username": "YOUR_TADO_USERNAME",
"password": "YOUR_TADO_PASSWORD"
}]上述配置文件中，我们需要填写 Tado 的用户名和密码。完成配置后，启动 Homebridge，等待加载完毕后，我们可以在苹果 HomeKit 中看到 Tado 设备了。在 HomeKit 中，我们可以进行一些控制操作，比如调节室温、查看温度、调整时间表等。
配置和扩展
- 修改默认温区和时间偏移量
homebridge-tado-manual 的配置选项有很多，可以很方便地进行扩展和个性化修改。比如，我们可以通过修改“温区”（Zone）和“时间偏移量”（Timezone Offset）来适应不同的需求。
-- -------------------- ---- -------
------------ --
----------- -----------------
------- -------
----------- ---------------------
----------- ---------------------
-------- --
--------- ------
------- ------
------------- ----
----------------- -
--
--温区（Zone）是针对 Tado 温控系统而言的，它可以在控制室内各个区域的温度。在上述配置文件中，我们可以通过设置“zones”选项来添加温区。在“zones”数组中，我们设置温区的 ID、名称、温度偏移量和时间偏移量。例如，上述配置文件中的“tempOffset”选项表示温度偏移量，0.5 表示当前温度比实际温度高 0.5 度。如果你的房间内通常会容忍一些温度波动，可以设置一个适当的偏移量。
- 快捷操作
通过配置“Switch”选项，我们可以在 HomeKit 中添加一个开关，用于快速操作 Tado 在“家庭”和“离家”状态之间切换。
"platforms": [{
"platform": "TadoThermostat",
"name": "Tado",
"username": "YOUR_TADO_USERNAME",
"password": "YOUR_TADO_PASSWORD",
"switch": true,
}]上述配置文件中，“switch”选项为“true”，表示开启“快捷操作”（Switch）。当我们在 HomeKit 中打开这个 switch 的时候，Tado 就会从“家庭”状态切换到“离家”状态，反之亦然。
示例代码
-- -------------------- ---- -------
----- -------------- - ----------------------------------
----- -------------------- ------- -------------- -
-- -- ----------- --
------------- -
----- -------- - --------------------
----- ------------ - --- ---------------- - - -------- ----------
-------------------------------------------------
---------- ---------- -- -
-------------------------- ---- ----- --- ------- --------
-------------- ------------
--
---------- ------- --------- -- -
----------------------- ---- ----- --- ------- ---- -- ------------
-------------------------------------------- -- -
-------------------- ----- --- ------- ---- --- -- -----------------
-----------
-------------- -- -
--------------------- ------- ---- ----- --- ------- ---- -- ---------------- -----
--------------
---
---
----------------------------
------ ---------
-
-
-------------- - ------------ -- -
-------------- - -----------------------------
------------------------------------------------------ ----------------------- ----------------------
--上述代码中，我们先通过require()方法引入了 homebridge-tado-manual 的依赖，然后定义了一个名为 CustomTadoThermostat 的类。CustomTadoThermostat 继承 TadoThermostat，重写了 getServices() 方法。在 getServices() 方法中，我们添加了一个名为 CustomSwitch 的 switch，它用于快捷操作 Tado 在“家庭”和“离家”之间切换。
最后，通过 module.exports 导出一个函数，实现了自定的 homebridge 插件，并调用 homebridge 的 API，将 CustomTadoThermostat 注册为插件。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005763581e8991b448ea92f