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

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

版本：0\.2\.164
npm 元数据更新时间：2026-11-08T12:25:54.406Z
中文译文更新时间：2026-11-09T00:56:58.146Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：6.5 MB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-05T07:06:29.414Z
- 最新版本发布：2026-11-08T12:25:54.215Z
- 近 30 天下载量：6657（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：175（近 12 个月 175 个）

## 中文简介

Velux KLF- 200 集成 CamStack —— 网关, 本地出入口窗口( 有雨感应器)和百叶窗封面( 位置, 无倾斜)

## 安装

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

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

## README

# Velux 提供者

Velux KLF- 200 设备提供器加通 CamStack. 网关的窗户 滚筒百叶窗 百叶窗 乌鸦变成了 `cover` 设备(定位、不倾斜),屋顶窗口的内置雨感器成为 `flood` 感应器。 国家是由门户推动的,而不是民意调查.

软件包 `@camstack/addon-provider-velux` 时间npm.

## 它提供的东西

-   **天线** (单位:千美元)`provider-velux`:通过一个Velux KLF-200网关覆盖本地网络及其窗口/滚子百叶窗(位置封面). 类别:供应商.
    -   能力: `device-provider`。 。 。 .

## 配置

从 System, Addons, 此加词, 设置( 设备的设置在设备页面上) 编辑这些 。 密码字段被存储在密钥链中 .

**连接**

-   网关: 名称
-   连接: 网关主机/ IP, 密码

## 所需资源

-   安置:只设枢纽.
-   一个CamStack枢纽。 只有在上述放置允许的情况下才使用一种剂.

## 文档

-   [文件/建筑/设备-模型](https://github.com/camstack/server/blob/main/docs/architecture/device-model.md)

见 [变动情况](https://npmcn.com/package/%40camstack/addon-provider-velux/CHANGELOG.md) 对于每个版本的变化.

## 对齐门户

1.  **先放一个连接槽.** KLF-200只接受少数同时举行的API会话(见下文). 若为 家庭助理的VELUX集成连接到同一个网关上,每个会话可以,但是 如果还有其它东西(电话应用会话, ioBroker, 第二个中枢) 也被连接, 在添加前关闭它 这里的网关.
2.  在《CamStack:整合》中,添加 **天线**。选择您网络上发现的网关( KLF- 200 自行宣布) 作为 `VELUX_KLF_…`)或类型 **主机/ IP 设备**,然后输入网关 **密码**。 。 。 . **测试** 检查登录 并立即结束会议.
3.  密码是 **WiFi / 网络密码打印在单位背面**,而不是 WiFi 网络密码 你的路由器。 它存储在 CamStack 密钥链中; 它从未被放入环境变量, 命令 线条或日志行.
4.  打开整合的发现。 KLF- 200 是一个 **网关** 设备(重启、固件、链接到 网页);每个窗口、百叶窗、盲和发光都显示为封面。 带有雨感应器的窗口显示为 一个容器 封面和雨传感器。 收养你想要的 未提供固件更新 : 网关 API 无法做到这一点.

没错 **没有** 需要禁用家庭助理的整合:两个客户中每个客户一个会话适合在 网关的限制. 如果网关开始拒绝登录, 请禁用( 或重新加载) , 并查看下面的限制 .

## 连接限制

KLF-200 API规格(v3.18)允许 **两次同时举行的API会议** 在端口的 TLS 套接字上 **第51200条**; 拒绝第三个登录直到一个关闭。 分开门户 **关闭闲置的会话 15分钟**。 。 。 .

这个加登对此做了些什么:

-   打开了 **一个** 每个网关套接字, 绝不是第二个( 不针对命令, 不针对雨) (见注一)。 指挥、通知和雨水交通共享这一段.
-   它发出一个州请求 **10分钟** 所以闲置的计时器从不开火.
-   它能打开网关 _房屋状况监测器_,所以每个变化(也是用遥控器作出的改变)都是 **驱动**;没有投票循环.
-   当会话结束( 网关重设, 网络被丢弃, 密码被更改) 原因被登录 用网关设备 id 、 封面显示离线和 a **新鲜** 会话以 指数后退: 2秒,4秒,8秒... 封顶5分钟。 一个被拒绝的密码等待完整的5分钟 在下次尝试之前,所以错误的密码不会敲击单位.

因此,随着家庭助理连接(1会话)和CamStack(1会话),网关已经满了。 第三个客户端 (例如同一网络上的电话应用,或第二个CamStack中枢)会被拒绝.

## 证书

网关在每个单位上呈现相同的自签名证书, 而该共享证书 **过期于 2026-07-12 (中文(简体) )**编辑 `klf-200-api` 库(8.x)只接受该确切的大小写: 当 唯一的缺陷是"证书过期" **财务报告和审定财务报表** 同伴的指纹等于被钉住的VELUX 1。 任何其他 证书,不管是否过期,都会被拒绝。 没有 `rejectUnauthorized: false` 在这个加词.

## 覆盖图绘制

| KLF- 200 起动器 | 凸轮 | 页:1 |
| --- | --- | --- |
| 窗口打开器 | `cover` (类) `window`(中文(简体) ) | 0 = 已关闭,100 = 已关闭 |
| 摇摆式百叶窗、摇摆式百叶窗、双层百叶窗 | `cover` (单位:千美元)`shutter`(中文(简体) ) | 双层百叶窗是这里的一面 |
| 发光、水平发光 | `cover` (单位:千美元)`awning`(中文(简体) ) |  |
| 网易 / 外出 网易 / 卢弗盲 幕道 | `cover` (单位:千美元)`blind`(中文(简体) ) | 无倾斜 |
| 车库/滚动门打开器 | `cover` (单位:千美元)`garage`(中文(简体) ) |  |
| 打开闸机 | `cover` (单位:千美元)`gate`(中文(简体) ) |  |
| 带有雨传感器的窗口打开器 | 额外 `flood` 传感器 ("雨") | 角色: 漏出传感器 |
| 灯、锁、开关、取暖 | 未曝光 |  |

电线位置为0x000. 0xC800 **0已完全打开**,对于每一种起动器类型; CamStack 的封面是 0=关闭. 100=打开,所以 `open% = round(100 * (1 - raw / 0xC800))`。0xC800以上的原始值是一个协议 标记(目标、当前、忽略),作为未知位置报告,并显示为 `stopped`永远 `closed`。 。 。 . `stop` 以停止标记0xD200发送.

盖子由引爆者识别 **序列号**,而不是通过它的节点id(一个节点id只是一个索引 网关可以在节点被移除后重新使用)。 一个不报告序列的节点会回到它的节点ID.

## 雨声

以集成雨感应器显示为雨水的窗口 **开口限制** (至少89%或以上). 网关不推动限制更改,所以加通每5分钟和每一次窗口重读一次 停止移动。 无法读取的值会保留上一个关卡 .

## 已知限制

-   倾斜不支持(KLF-200在其封面模型中没有倾斜).
-   图片、组和网关重启按钮不曝光 .
-   双滚子快门作为一面被曝光(这是家庭助理的两个实体).
-   卖家图书馆仍然打印几行 `console` 本身(登录错误文本,过期证书) )),该词的原意是: 那些消息从来不包含密码.

## 常见问题

### @camstack/addon-provider-velux 是什么？

Velux KLF- 200 集成 CamStack —— 网关, 本地出入口窗口\( 有雨感应器\)和百叶窗封面\( 位置, 无倾斜\)

### 如何安装 @camstack/addon-provider-velux？

在项目目录运行 npm install @camstack/addon-provider-velux，或使用 pnpm add / yarn add / bun add。

### @camstack/addon-provider-velux 支持 TypeScript 吗？

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

### @camstack/addon-provider-velux 支持 ESM 还是 CommonJS？

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

### @camstack/addon-provider-velux 可以商用吗？

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

### @camstack/addon-provider-velux 的下载量有多少？

根据 npm 官方下载统计，@camstack/addon-provider-velux 在 2026/10/09 – 2026/11/07 这 30 天内被下载 6,657 次，日均约 222 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @camstack/addon-provider-velux 还在维护吗？

最新版本 0\.2\.164 发布于 2026/11/08（今天）；至今共发布 175 个版本，其中过去 12 个月发布了 175 个；首次发布于 2026/07/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。