# @camstack/addon-provider-homematic 中文文档

规范地址：https://npmcn.com/package/%40camstack/addon-provider-homematic/

版本：1\.2\.170
npm 元数据更新时间：2026-10-31T16:24:18.042Z
中文译文更新时间：2026-10-31T18:43:49.745Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40camstack/addon-provider-homematic
原文对照：https://npmcn.com/package/%40camstack/addon-provider-homematic/?lang=original
项目主页：https://camstack-docs.zentik.app/
源码仓库：https://github.com/camstack/server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9.6 MB，39 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：zod ^4\.3\.6，react \>=18，react-dom \>=18，@camstack/types \*
- 首次发布：2026-06-13T14:09:51.705Z
- 最新版本发布：2026-10-31T16:24:17.871Z
- 已发布版本数：206（近 12 个月 206 个）

## 中文简介

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

## 安装

```sh
npm install @camstack/addon-provider-homematic
```

也可以使用：`pnpm add @camstack/addon-provider-homematic`、`yarn add @camstack/addon-provider-homematic`、`bun add @camstack/addon-provider-homematic`

## README

# 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集线器。代理仅在上述位置允许的情况下使用。

## 文档

-   [文档/建筑/ device-model.md](https://github.com/camstack/server/blob/main/docs/architecture/device-model.md)

看到 [CHANGELOG.md](https://npmcn.com/package/%40camstack/addon-provider-homematic/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 是什么？

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 和提交记录判断。