@camstack/addon-provider-velux

中文文档
0.2.164发布于 2026/11/08MITESM + CJS零依赖近 30 天下载 6657

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

中文使用文档
文档目录10 节
  1. 它提供的东西
  2. 配置
  3. 所需资源
  4. 文档
  5. 对齐门户
  6. 连接限制
  7. 证书
  8. 覆盖图绘制
  9. 雨声
  10. 已知限制

Velux 提供者

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

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

它提供的东西

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

配置

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

连接

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

所需资源

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

文档

见 变动情况 对于每个版本的变化.

对齐门户

  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 共发布 175 个版本,首次发布于 2026/07/05;过去 12 个月发布了 175 个版本。

版本发布日期距今
0.2.164latest2026/11/08今天
0.2.1632026/11/072 天前
0.2.1622026/11/072 天前
0.2.1612026/11/072 天前
0.2.1602026/11/063 天前
0.2.1592026/11/054 天前

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

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