homebridge-ir-patio-heater

中文文档
1.1.4发布于 2026/11/04MITCommonJS零依赖

在HomeKit中,只有远程遥控的露台加热器,通过Tuya IR发射器驱动:一个开/关瓷砖,一个功率水平滑块和一个不同步按钮。

中文使用文档
文档目录9 节
  1. 需求
  2. 安装
  3. 配置
  4. 加热器是如何驱动的
  5. 恢复同步
  6. 选配智能插头(建议无人值守使用)
  7. 为什么请求不重试
  8. 响应时间
  9. 平顶火山帐户

homebridge-ir-patio-heater

npm license

显示只有远程庭院加热器,通过Tuya红外爆炸控制,作为三个HomeKit 每个加热器的瓦片:

  • 加热器 (开关):打开加热器的唯一开关。On =电源,等待,最后一层。 关=电源。
  • 水平 (风扇滑块,500w / 1000w / 1500w):加热时改变电平。或 滑块到零与加热器关闭相同。它从来没有打开加热器:选择一个水平 当我离开的时候,我只记得下一次。
  • 不同步 (按钮):不发送任何东西而翻转HomeKit显示的(On↔Off)。

重命名磁贴 levelName / syncName,或隐藏“不同步” showSyncButton: false。

需求

  • Homebridge 1.6或更高版本(包括2。Node.js 18.20或更高版本。
  • 一个Tuya(智能生活)通用红外发射器,加热器的远程学习或添加在应用程序中。
  • 一个图雅物联网平台云项目链接到您的应用程序帐户,与 物联网的核心 和 IR控制中心开放服务 授权。如果你已经使用了Tuya Homebridge插件, 重用它的项目。

安装

搜索 IR天井加热器 在Homebridge UI的Plugins选项卡中,或者运行:

npm install -g homebridge-ir-patio-heater

配置

在Homebridge UI中配置它,或者添加一个平台到 config.json:

{
  "platform": "PatioHeater",
  "name": "Patio Heaters",
  "accessId": "<Access ID of your Tuya cloud project>",
  "accessKey": "<Access Secret>",
  "endpoint": "https://openapi.tuyaus.com",
  "heaters": [
    {
      "name": "Left Heater",
      "blasterId": "<IR blaster device ID>",
      "remoteId": "<IR remote device ID>",
      "powerKey": "power",
      "levelKeys": ["500W", "1000W", "1500W"]
    }
  ]
}
  • blasterId / remoteId:在途雅物联网平台,云→你的项目→设备。这个 你在爆炸装置下添加的遥控器是一个独立的设备。Tuya应用程序也会显示这两种情况 在“设备”下→设备信息→虚拟ID。
  • powerKey / levelKeys: Tuya app中遥控器显示的按钮名称 (不区分大小写匹配)。如果一个名称不匹配,日志将列出可用的名称。
  • 端点:应用程序账户的数据中心(美洲、欧洲、印度或中国)。

每个其他选项都有一个合理的默认值,并在设置屏幕和下面解释。

加热器是如何驱动的

这些加热器有三种实际状态: 从, 备用 (通电,不加热)和 加热 在某种程度上。遥控器的电源键在开与关之间切换;水平仪按钮 启动或改变加热,但仅当加热器有电源时。

HomeKit显示你做红外按
从加热器上电源→等待 keyDelayMs →等级×2
在移动水平滑块水平×2
在加热器关闭,调平,或滑块到0权力
从移动水平滑块关卡×2(记得下一关)
从任何关闭,或水平打开没有什么

水平压力机发送两次(levelRepeat,默认为2),因为加热器忽略了重复的 级别,因此错过的IR新闻获得了第二次机会。权力是一种切换,永远只发送一次。 如果加热器醒得慢或者离它的爆能器很远,提高它的 keyDelayMs (例如:2500)。

同时到达的请求(Home应用经常同时发送多个级别的请求)被合并 变成一个序列。如果按下失败,HomeKit将回滚到实际发生的情况。

恢复同步

IR是单向的,Power是一个开关,所以HomeKit只有被颠倒了才会出错。 看看加热器,然后:

加热器瓷砖显示加热器本身做。
在黑暗,没有光利用 不同步 →瓷砖展示
从光在利用 不同步 →瓷砖显示打开,然后正常关闭,如果你想
在灯亮着,不加热移动 水平 滑块(没有按水平键)

不要通过切换加热器瓷砖来修复它:每次点击都会发送另一个能量,所以它保持倒置。

出于同样的原因, autoOffMinutes 只有智能插头才能工作,你不应该添加 “当所有人都离开时关闭”,没有一个的自动化。

集 plugId 连接到Tuya智能插头(室外,15a)。然后 关掉插头,这总是 正确,因为加热器在断电后不记得自己的状态。 在 接通电源; 等待 plugPowerUpDelayMs, Power, level。插头是轮询的,所以在任何地方都要关掉它 暖气关了。有了插头,自动关闭和离开自动化是安全的。

为什么请求不重试

由于网络错误,重新读取图雅。按下一个键不是一个计时的请求 可能还能到达爆炸装置,第二个电源按钮会打开加热器 回来。在日志中报告一次失败的按压,并且HomeKit回滚到已知的状态 已经发生了。

响应时间

每条日志线显示时间的去向,例如: On at 1500W (power 640ms, 1500W 590ms; total 2410ms after HomeKit request)。 预印时间是图雅的云接受命令;然后爆炸装置发射红外线, 通常在一秒钟之内。开启还包括 keyDelayMs (默认1000)之间的功率 加热器需要唤醒的温度。插件本身只添加 debounceMs (默认150)来组合上+级请求,并在后台更新其Tuya令牌。

平顶火山帐户

使用带有项目级令牌的Tuya云项目的访问ID /访问秘密。 它永远不会登录你的应用程序帐户,所以它可以与Tuya Homebridge共享一个项目 插件,而不注销该插件。云项目需要 IR控制中心开放服务 API授权(图雅) 插件已经使用它为您的遥控器)。

版本与发布记录

homebridge-ir-patio-heater 共发布 6 个版本,首次发布于 2026/11/03;过去 12 个月发布了 6 个版本。

版本发布日期距今
1.1.4latest2026/11/04今天
1.1.32026/11/04今天
1.1.22026/11/04今天
1.1.12026/11/04今天
1.1.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 homebridge-ir-patio-heater 的常见问题

homebridge-ir-patio-heater 是什么?

在HomeKit中,只有远程遥控的露台加热器,通过Tuya IR发射器驱动:一个开/关瓷砖,一个功率水平滑块和一个不同步按钮。

如何安装 homebridge-ir-patio-heater?

在项目目录运行 npm install homebridge-ir-patio-heater,或使用 pnpm add / yarn add / bun add。

homebridge-ir-patio-heater 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/homebridge-ir-patio-heater 是否存在。

homebridge-ir-patio-heater 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

homebridge-ir-patio-heater 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^18.20.0 || ^20.15.0 || ^22.0.0 || ^24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

homebridge-ir-patio-heater 可以商用吗?

homebridge-ir-patio-heater 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

homebridge-ir-patio-heater 还在维护吗?

最新版本 1.1.4 发布于 2026/11/04(今天);至今共发布 6 个版本,其中过去 12 个月发布了 6 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。