ALLCENTER 授权中心
首发 第三方网关 · 局域网 / TCP 6668

涂鸦局域网照明网关

¥599 起 选期限购买 先试用 90 天

01支持哪些设备、装的是哪个包

这一段不是手写的：每次打开页面都从驱动清单和构建产物里现读。 页面上写什么，包里就是什么 —— 买之前先对一眼型号，比装到一半发现不对省事。

支持机型
TUYA_LAN_Lighting
支持系列
TUYA_LAN
最低 SDK
21.0000.0000 驱动框架门槛由 Crestron 决定，低于这个版本的主机装不上这个包
驱动版本
1.0000.0002 2026-11-08 发布 · 属性页共 5 个配置项
安装包
39.8 KB sha256 2293c26396b8… · 2026-11-12 构建
已知边界
  • 涂鸦设备必须已经在涂鸦 App 里配好网，并且能被局域网直连；只支持云控制的设备本驱动接不了
  • 每台设备的 deviceId 与 localKey 要从涂鸦 IoT 平台导出（或用 tinytuya wizard 抓），重新配网后 localKey 会变，要回来改清单
  • 协议支持 3.1 / 3.3 / 3.4；3.5 用 AES-GCM，CH 宿主 .NET 4.6 没有该实现，填进清单会当场报错而不是静默失败
  • 涂鸦固件只允许一条局域网 TCP 连接：手机 App、localtuya、本驱动会互相踢线，App 打开看一眼 CH 这边就掉线几十秒
  • 主机固件 21.0000.0000 及以上（OS 4.x）；低版本装不上，驱动不会出现在配对列表里
  • 在线码需要主机能出网；完全离线的机房请下单时说明，改发离线码

02怎么加

  1. 先在涂鸦 App 里把灯配好网、记下每盏的局域网 IP，然后在路由器上做 DHCP 静态绑定 —— IP 变了清单就得跟着改，这是现场最常见的「昨天还好好的」。
  2. 拿 deviceId 与 localKey：登录涂鸦 IoT 平台（iot.tuya.com）建一个云项目，把设备挂到该项目下，在「设备调试」页能看到这两项；也可以用 tinytuya 的 wizard 在局域网里一把抓出来。localKey 在重新配网后会变。
  3. 把 CH-TUYA-LAN.pkg 拷到主机 /User/ThirdPartyDrivers/Import —— Toolbox 的 File Manager 或 SFTP 都行，账号是主机管理员账号。
  4. 触发导入：新版 Configure Pro 打开 Devices → Add Device 就会扫到新包；旧版 Crestron Home Setup App 进 Settings → Configure System → Pair Devices → Drivers，等列表底部「Updating Drivers」转圈结束（约 10 秒）。
  5. 设备类型选 Platform → 厂商 ALLCENTER → 型号 TUYA_LAN_Lighting → 点 ⊕。一个实例管全宅的涂鸦灯，不要一盏灯建一个实例。
  6. 在 Device List 里一行一台设备，竖线分隔：名字|IP|deviceId|localKey|类型|版本。类型填 switch / dimmer / cct / rgb；版本填 3.1 / 3.3 / 3.4；DP 映射可省，省了按涂鸦标准照明 20,21,22,23,24。
  7. 填 Color Temp Range：这块 LED 模组的实际色温端点（常见 2700,6500）。涂鸦报的 temp_value 是 0–1000 的无单位值，端点填错不坏控制，但滑条两端会跟灯对不准。
  8. 起名并选房间。每台设备在 CH 里是一盏独立的灯，可以分到不同房间、进照明页、被场景和快捷动作调用。
  9. 打开门户绑定站点码 → 购买（试用 / 30 年 / 60 年 / 终生）→ 把签发的整段码粘回 License Code。保存后 30 秒内状态变化，不用重启。

03属性页每个字段怎么填

这张表按驱动属性页的实际顺序排。填错哪一项会出什么现象，最后一列写了 —— 比装完再猜快得多。

Device List
一行一台：名字|IP|deviceId|localKey|类型|版本
竖线分隔，分号或换行分设备。DP 映射可省，省了按 20,21,22,23,24
State Poll (s)
15（默认）
涂鸦只允许一条局域网连接，轮询顺带保活。低于 10 秒只增加流量，界面不会更快
Color Temp Range (K)
2700,6500
LED 模组的实际色温端点，写成 最小,最大。填错不坏控制，只是两端对不准
Site ID
自动生成，只读
下单时用这个号，不要手抄错一位
License Code
门户签发的整段码
粘错不会锁死，改对即可

04加之前要先有

这几条缺一样，后面都会卡住。先确认再动手。

  • 涂鸦设备已在涂鸦 App 里配好网，且与主机在同一网段（跨网段要在路由器上放行 6668）
  • 已从涂鸦 IoT 平台导出每台设备的 deviceId 与 localKey
  • 路由器上给每盏灯做了 DHCP 静态绑定，或者接受 IP 变了要回来改清单
  • 主机固件 21.0000.0000 及以上
  • 主机能出网（在线码要换租约；离线码不需要）
  • 门户账号已绑定该站点码，否则下单页选不到这台主机

05能做什么，做不到什么

右边这一列更要紧 —— 项目上的返工，多半是照着左边承诺、忽略了右边。

可以

  • 一个实例管全宅涂鸦灯：四类灯型按清单里写的类型生成对应磁贴 —— 纯开关 / 可调光 / 色温 / RGB
  • 亮度用 CH 的相对量 0.0–1.0，内部换算到涂鸦的 10–1000；色温直接给 Kelvin，物理范围可配
  • 状态双保险：设备主动上报 + 定时轮询。在涂鸦 App 里改了灯，CH 这边会跟上，不是只认自己发的命令
  • 可编程面：每盏灯的开 / 关 / 设亮度 / 设色温 / 设色相 / 设饱和度都进 Sequences；isOn 与各档属性可进条件与 Actions & Events
  • 断线自动重连：退避 3 秒起、最长 60 秒，半死的设备不会把处理器和网络打满
  • 整站点授权：一个站点加多少盏涂鸦灯都不额外收费

不行

  • 没有在真实涂鸦硬件上跑过。协议层用独立模拟器验证过 3.3 与 3.4 全流程（连接、心跳、轮询、开关、亮度、色温、彩光、错 key 报错），但模拟器是按协议文档写的，第一台上机建议只接一盏，看日志通了再批量铺
  • 协议 3.5 不支持：它用 AES-GCM，CH 宿主是 .NET 4.6，没有 AesGcm 这个类。驱动会在解析清单时直接报错告诉你是哪一台，不会静默失败
  • 涂鸦固件只允许一条局域网 TCP 连接 —— 这是固件限制，不是驱动 bug。手机 App、localtuya、本驱动三者会互相踢
  • 不做窗帘电机：CH 的 Shade 能力签名找不到可确证的权威文档，位置量纲猜错会让窗帘跑到顶，宁可不做
  • 不做插座 / 传感器 / 门锁：CH 的能力族里没有对应的展示档位，硬套成灯只会误导客户
  • 不做涂鸦云 API：那条路要客户账号、要企业资质，且断网即失效
  • 接的是 Wi-Fi 直连的涂鸦设备；纯蓝牙 / Zigbee 子设备要经涂鸦网关，本驱动没有走网关那条链路
  • 未授权时设备照常出现、照常回传真实状态，但命令会被拒绝并在设备事件里写明原因 —— 不删设备是故意的：在线租约过期时若让灯直接消失，整栋房子的房间分配、序列引用、页面布局会一起塌

06装完怎么验

这几步走完再离场。现场有网、有电、有人，比三天后接到电话再跑一趟便宜。

  • 状态行显示「已授权」并带剩余天数 —— 只显示授权码里的天数说明码生效了；显示「未填码」说明没存进去
  • 逐盏点开关，灯要真的亮灭；再在涂鸦 App 里改一次，CH 这边应跟着变（证明不是只认自己发的命令）
  • 亮度拖到 10% 与 100%，灯要真的变；色温从最暖拖到最冷，肉眼看得出变化
  • RGB 灯切到彩光，拖色相环，灯的颜色要跟着走；再拉亮度，彩光模式下亮度也要变
  • 把一盏灯的 IP 故意改错重配一次，日志里应明确写「连不上」，而不是静默没有任何输出
  • 在门户控制台确认该产品显示「有效」而不是「试用中」，试用中说明买的是试用单

07常见故障

按「先证线、再证设备、最后怀疑驱动」的顺序查，能省掉大半时间。

加了设备，配对第一步就问「设备清单」
正常：Platform 驱动只有这一页。清单里分号、竖线、换行都认，但一行里至少要有 4 段（名字|IP|deviceId|localKey）
日志一直「连不上」，最后报超时
IP 不对、灯不在同一网段，或者灯被涂鸦 App 占着。先 ping，再用 telnet 试 6668 端口
连上了，但 10 秒内没收到任何状态
localKey 与该设备不匹配。重新配网后 key 会变，回涂鸦 IoT 平台重新取一次
报「设备返回错误码 858665728」
协议版本填错了。3.3 的设备填成 3.1、或 3.4 填成 3.3 都会这样，按型号逐个试
报「协议 3.5 不支持」
这台是新固件。涂鸦多数型号不允许降级，这一台先另想办法（换设备或用厂家自己的网关）
能开灯，但亮度滑条没反应
类型填成了 switch。可调光灯要填 dimmer；带色温的填 cct；带彩光的填 rgb
色温滑条两端跟灯对不准
Color Temp Range 填的不是这块 LED 的实际端点。查灯具规格书或问厂家，常见 2700,6500 或 2000,6500
CH 里能控，一打开手机 App 这边就掉线
固件只允许一条局域网连接。这是设备限制，等 App 退出后 30 秒内驱动会自己连回来
状态行显示「未授权 · 站点 AC-XXXX」
没填码，或码不是这个产品的。把站点码报给供应商，或直接在门户下单；填错不会锁死，改对即可

08授权怎么生效

1 取站点码

驱动属性页状态栏显示本站点码，形如 AC-7K3M-9QX2-4BTR。

2 门户下单

绑定站点、选套餐、付款，授权码即时签发，不用等人工。

3 粘贴激活

把授权码整段粘回属性页。在线码会自动换租约，到期前 30 天控制台提醒。

09买完之后，后面还收不收钱

这四条是承诺，不是话术 —— 内容直接取自价格配置，改条款不用改代码。 签合同前先对一眼，比事后争「这算不算升级」便宜。

版本更新
买断后 1.x 大版本内的升级免费重下，不额外收费；跨大版本按当时首发价 5 折补差
到期之后
买断授权永久有效，没有到期日、不续费。授权码是离线码，不联网也照常工作
技术支持
工作日 09:00–21:00，微信或邮件，4 小时内首次响应；不含现场上门与第三方设备排障
迁移换机
换主机不用换码：站点码由 SN/MAC 派生，恢复出厂或换同型号主机仍是同一个站点；增减灯具、换 IP 也都不重签

10同品牌的其它条目

一个品牌往往横跨几个品类 —— 灯光、遮阳、面板可能来自同一家。 报价前先看全，别漏了同一套系统里能一起卖的东西。

VRF 多联机网关（涂鸦局域网 / 分区控制） 暖通空调 · TUYA_VRF_Gateway

11第三方网关下的其他条目

易来局域网照明网关 易来 Yeelight Aqara M3 网关桥接（灯 / 帘 / 传感） Aqara 绿米

没找到你要的型号？我们免费帮你写驱动

Crestron 驱动按型号收录，同品牌换个系列往往就不通用 —— 这一页没有，不代表接不了。 只要能拿到协议文档或开放 API，驱动由我们免费开发，做完直接进目录，长期有效。

登记这个型号
  1. 01
    品牌与型号品牌已填好，同系列其他型号也写上
  2. 02
    固件版本设备铭牌或厂家 App 里能查到
  3. 03
    协议或 APIRS-485 / RS-232 指令表、TCP 文档
  4. 04
    负责人与电话能拍板、也能提供文档的人

暂时没有协议文档？也告诉我们 —— 能做的照做，说不清的会说清原因，不让你白等。 习惯发邮件的话 umiot@allcenter.cn， 微信 AC_UMIOT。

测试反馈 装过才有发言权

这条驱动在你的现场跑得怎么样？接不上、掉线、某个字段没反应， 都直接写在这里。可以带截图和日志，最多 3 个文件、单个 5MB。 内容只有你和我们看得到，不会公开。

+10 被采纳得 10 币
1 币抵 1 元