@camstack/addon-provider-homematic

中文文档
1.2.170发布于 2026/11/01MITESM + CJS

homatic / homaticip (CCU3 / RaspberryMatic) CamStack的设备提供程序插件-封装了nodehomatic库

中文使用文档
文档目录5 节
  1. 它提供了什么
  2. 配置
  3. 要求
  4. 文档
  5. 设置

Homematic提供者

homatic / homaticip (CCU3 / RaspberryMatic) CamStack的设备提供程序插件-封装了nodehomatic库。

包 @camstack/addon-provider-homematic npm。

它提供了什么

  • Homematic (provider-homematic):连接到一个自制CCU3 / RaspberryMatic集线器,并采用它的开关、盖子、灯、锁、恒温器和传感器。类别:提供者。
    • 功能: device-provider, broker, device-adoption.

配置

编辑这些从系统,插件,这个插件,设置(一个设备自己的设置在其设备页面)。密码字段存储在keychain中。

插件设置

  • 本地经纪人:经纪人是单独管理的

连接

  • CCU连接方式:主机/ IP
  • 接口:使能homatic IP、使能homatic (BidCos-RF)、使能groups(加热组)、使能BidCos-Wired (HM-Wired)
  • 事件回调:回调主机(可选-当为空时自动推断),回调端口
  • web凭据:用户名、密码
  • 高级:使用TLS

要求

  • 位置:hub-only。
  • CamStack集线器。代理仅在上述位置允许的情况下使用。

文档

看到 CHANGELOG.md 每个版本的变化。

设置

  1. 在CamStack: integration中添加 Homematic. 选择在您的网络上找到的CCU(扫描要求每个主机的 local /24网络(无论是CCU3还是RaspberryMatic web)或键入its 主机/ IP. 选择 接口 要绑定,并设置 回调主机 如果集线器有多个地址(必须是一个) CCU可以达到,从不达到127.0.0.1;空白推断它)。的WebUI 用户名和密码 是可选的:它们可以解锁吗 友好的名字和房间,密码存储在CamStack钥匙链中,而不是环境变量中, 命令行或日志行。 测试 询问每个启用的接口,并使用凭据登录。
  2. 打开集成的发现。CCU显示为一体 网关 设备(在线状态、主机和链接) 其WebUI);每个CCU设备都显示为候选设备,或显示为每个实体的候选设备 实体 过滤器。id带有集成,所以两个ccu不会碰撞。产品是网关的兄弟姐妹,而不是它的兄弟姐妹 的孩子。
  3. 当CamStack启动时,CCU会以越来越长的延迟重新尝试,并且在每次集成更改时再次尝试。
  4. 不提供CCU的重启和固件更新:库没有重新启动CCU的调用,并且其 固件调用按地址在无线电设备上安装更新。

一个集线器上的两个ccu共享默认回调端口(2128):给第二个ccu另一个 回调端口. 没有迁移旧的基于代理的CCU:删除它并添加集成。

版本与发布记录

@camstack/addon-provider-homematic 共发布 206 个版本,首次发布于 2026/06/13;过去 12 个月发布了 206 个版本。

版本发布日期距今
1.2.170latest2026/11/012 天前
1.2.1692026/10/312 天前
1.2.1682026/10/312 天前
1.2.1672026/10/313 天前
1.2.1662026/10/313 天前
1.2.1652026/10/313 天前

关于 @camstack/addon-provider-homematic 的常见问题

@camstack/addon-provider-homematic 是什么?

homatic / homaticip (CCU3 / RaspberryMatic) CamStack的设备提供程序插件-封装了nodehomatic库

如何安装 @camstack/addon-provider-homematic?

在项目目录运行 npm install @camstack/addon-provider-homematic,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.3.6)、react(>=18)、react-dom(>=18)、@camstack/types(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@camstack/addon-provider-homematic 支持 TypeScript 吗?

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

@camstack/addon-provider-homematic 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@camstack/addon-provider-homematic 可以商用吗?

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

@camstack/addon-provider-homematic 还在维护吗?

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