ALLCENTER 授权中心
首发 软件服务 · WebSocket 9410 + MQTT 1883（回退）

UMS 全屋系统桥接（双向）

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

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

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

支持机型
ALLCENTER_UMS_BRIDGE
支持系列
ALLCENTER_UMS_BRIDGE
最低 SDK
21.0000.0000 驱动框架门槛由 Crestron 决定，低于这个版本的主机装不上这个包
驱动版本
1.0000.0026 2026-11-12 发布 · 属性页共 24 个配置项
安装包
38.2 KB sha256 53eb4f13f027… · 2026-11-12 构建

02怎么加

  1. 装包：CH-UMS-BRIDGE.pkg 拷到主机 /User/ThirdPartyDrivers/Import（Toolbox 的 File Manager 或 SFTP 都行）。触发导入：新版 Configure Pro 打开 Devices → Add Device 就会扫到；旧版 Crestron Home Setup App 进 Settings → Configure System → Pair Devices → Drivers，等列表底部「Updating Drivers」转完（约 10 秒）
  2. 配对：第三方 → Platform → 厂商 ALLCENTER → 型号 ALLCENTER_UMS_BRIDGE → ⊕，起名（例：UMS 桥）。装新包不等于已配对的设备换了驱动 —— 已配对实例一直跑配对那一刻解包出来的那一版，换版必须删掉实例、重新 Add Device，「关于」页版本号跟上了才算换成功
  3. UMS Address 填 UMS 9410 的 IP。主通路固定走 9410 的 WebSocket 通道；下面那个 MQTT Port（1883）只是回退路径，这一版不用填，留空即可
  4. 四个 Topic 的开头斜杠不能丢（/home/hap/device/… 这种）。少一个斜杠能连上但收不到消息，现场表现是「连上了却一个字不动」
  5. CH Web API URL 填 http://<CP4R 主机局域网 IP>：不要 https、不要 127.0.0.1、末尾不要带 /cws。驱动虽然跑在主机内，但要读别的驱动的设备只能走 CH 自己的 REST API，这条路必须先通；主机里要把 Web 服务开着，且与 UMS 在同一局域网
  6. CH Web API Token：Crestron Home Setup App → 齿轮 → Installer Settings → System Control Options → Web API Settings → Update Token，拿到 12 位字符串粘进来。点 Update 会让旧令牌立刻失效，现场在用的 Josh.ai / Home Assistant / Homebridge 会同时掉线，换之前先确认没人依赖
  7. 筛选规则（Bridge These Rooms / Device Types / Exclude / Max Devices）一般留空 —— 留空就是「这台主机上的设备全部进目录」，先跑通再收窄
  8. 不想全推：打开门户的「设备挑选器」（/assets/tools/ums-bridge-picker.html），勾选要同步的设备，生成一段白名单文本，粘进 Include Devices。没勾的设备不推、UMS 里也就搜不到
  9. Auto Fix UMS Names & Rooms 默认开，只做两件保守的事：UMS 里名字正好是 8 位编码（例 00052011）才改成 CH 里的中文名（例 DIN空调模块）；设备还挂在 UMS 默认房间才按 CH 房间归位。手工改过的名字、手工挪过的房间一律不动，房间只增不删
  10. Read Only 默认关：关着是双向（UMS 也能改 CH），打开只上报不回写。调试期想先看不动，就打开
  11. Site ID 只读，由主机自己算 —— 把这串 AC-xxxx 报给厂商下单，再把签发的整段码粘回 License Code，保存后 30 秒内状态行变「已授权」

03加之前要先有

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

  • UMS 9410 已开 WebSocket 通道（9410），且与 CP4R 在同一局域网
  • CP4R 的 Web API 已启用并拿到长期令牌；主机 IP 建议固定（DHCP 保留），换 IP 后要改配置
  • UMS 侧的房间先建好；没建的驱动会补建，但只会新增，不会删（人名、错名会一直留着）
  • UMS 侧要有对应产品定义：人体感应（sen-human）与安防（alarm）两类 UMS 目前没有产品，这两类设备会被静默丢弃
  • 主机能出网（在线码要换租约；离线码不需要）

04能做什么，做不到什么

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

可以

  • 双向：CH 里开灯、调光、开关空调、拉窗帘，UMS 跟着变；UMS 里操作也回写 CH，状态每 2 秒对一次
  • 设备目录带房间和类型一起上报，UMS 里直接按房间排，不用一台台手工挂
  • 名称同步：UMS 里那串 8 位编码换成 CH 的中文名，现场不用对着编号猜是哪台
  • 房间同步：按 CH 的房间归位，UMS 没有的房间自动建；同名房间只挑一个，不重复建
  • 白名单：勾了才推，没勾的 UMS 里搜不到 —— 适合先把几台关键设备跑通再放量
  • 整站点授权：一份码覆盖本站点全部设备，不限台数、不限设备数

不行

  • 驱动不生成任何 CH 设备实体：装完 CH 里不会多出灯或开关，UMS 侧是镜像，执行器仍留在原地
  • 状态靠轮询（默认 2 秒），不是事件订阅 —— CH 没有给第三方驱动开放设备事件，所以不是「立刻」而是「一个周期内」
  • 人体感应（sen-human）与安防（alarm）建不出来：UMS 产品库里没有这两类产品，驱动跳过并在日志里记一行。补齐要等 UMS 侧出产品定义
  • UMS 的「搜索设备」读的是后端缓存：连着搜两次结果只增不减，已经删掉的设备可能还在列表里 —— 以驱动推的目录为准，别反复点搜索
  • UMS 的搜索接口会忽略请求里的名字，建完必须再调一次改名才有人话名字；驱动已自动做，手工在 UMS 里建不会
  • 搜索返回 0 台又点「下一步」，会把 UMS 设备库清空（那个接口是覆盖式的，空列表等于清库）。看到 0 台先停手，别点下一步
  • CH 的场景不当作 UMS 设备推：只镜像灯、开关、调光、窗帘、空调、温控这些有实体的设备
  • 一个站点建议只加一个桥实例：多实例不会互相顶掉（客户端 ID 随机），但每个实例都会各推一份目录，UMS 里会出现重复设备
  • 未填授权码时 UMS 下发的控制一律丢弃：目录上报、状态回读、状态行都照常，只有「往下写」被拦 —— 这样现场能一眼分清「没授权」和「网络不通」

05装完怎么验

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

  • CH 里开一盏灯，UMS 侧 2 秒内跟着变；在 UMS 里关掉，CH 侧也在 2 秒内变过来
  • UMS 设备列表里的名字是中文名，房间和 CH 对得上，没有 00052011 这类编码名
  • 拉一条窗帘到 50%，两边位置一致；再在 UMS 侧拉回 0，CH 侧跟着回
  • 重启 CP4R 主机，配对表不丢（pairing.json 已落盘），起来后自动重连，不用重新配
  • 拔掉 UMS 网线一分钟再插回，驱动自动重连；断线期间 CH 本地控制不受影响
  • 「关于」页版本号显示 1.0000.0024

06常见故障

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

配对向导第 4 步 CH Web API URL 框里打不进字，点复制也没反应
装的是 0022 及更早的包，那一栏用的是只读链接类型。装 1.0000.0023 以上，并把已配对的实例删掉重新加一遍 —— 已配对实例不会自动换驱动
日志里 errorSource 5002 / Invalid authentication token
令牌过期，或有人点过 Web API Settings 的 Update Token。重新 Update 一次，把新串填回去；保存后不用重启，30 秒内自己重连
Missing authentication key / Invalid authentication key
CH 的 Web API 是两段式：先 login 换 10 分钟有效的 authkey，业务请求带 Authkey 头。把长期令牌直接当 key 用就报 Invalid，报 Missing 是头名写错了 —— 这两条都在驱动里，出现说明包不是这一版
发了新版但「关于」页还是旧版本号
已配对的实例永远跑配对那一刻解包的目录，新包只进 Storage/Rad。删掉实例 → 重启导入 → 重新 Add Device；判断真版本只看 DeviceManifest.cfg 里的 DriverVersion
UMS 里搜不到设备 / 搜到 0 台
三个坑按顺序查：① codec 选错；② mdiName 必须传 9410/WEBSOCKET 这个 label，传哈希或小写 websocket 会直接 500；③ 搜索读的是 UMS 后端缓存，连搜两次结果只增不减
UMS 设备库被清空了
搜到 0 台又点了下一步 —— 那个接口是覆盖式的，空列表等于清库。用挑选器生成的白名单重建一遍，再跑一次名称与房间同步
UMS 里名字还是 00052011 这种编码
Auto Fix UMS Names & Rooms 关着，或这条名字被人手工改过（保守策略一律不动）。要统一就打开开关再保存一次；还是不动的那几条，就是已经人工改过的
设备没进对房间
只有还挂在 UMS 默认房间的设备才会被搬，之前手工挪过的不会被覆盖 —— 这是刻意的，房间同步只增不删
UMS 侧操作 CH 没反应，CH 侧操作 UMS 正常
先看状态行末尾的授权段：「未填码」把门户签发的整段码粘进 License Code；「需续期」是断网超过租期，联网后自动恢复；「已到期」要续费。都不是，再查 Read Only 是不是被打开了
状态行显示「这枚码授权的是另一个驱动」
码里的产品键和本驱动对不上（常见于把 DMX512 或面板的码填进来）。一份码只解锁它对应的那个驱动；同一站点多个驱动各买一枚，或买组合码

07授权怎么生效

1 取站点码

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

2 门户下单

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

3 粘贴激活

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

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

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

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

09同品牌的其它条目

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

8/12 路 RS485 继电器模块 继电器与 I/O · ALLCENTER_UM-DSW12（网转串版 ALLCENTER_UM-DSW12_IP） 8 路电源时序器 继电器与 I/O · ALLCENTER_UM-PSC08（网转串版 ALLCENTER_UM-PSC08_IP） DMX512 灯光网关（512 通道） 灯光 · ALLCENTER_AC-UDMX512（串口包 / 网口包同型号） 悠米 UM-RS 开关面板（1–8 键） 灯光 · ALLCENTER_UM_RS08（1–8 键通用，键数在属性页选） 通配指令驱动（串口版） 软件服务 · ALLCENTER_ANY_CMD 逻辑块（记忆型判断） 软件服务 · ALLCENTER_LOGIC_BLOCK

10软件服务下的其他条目

通配指令驱动（串口版） ALLCENTER 逻辑块（记忆型判断） ALLCENTER 全屋体检（主机与设备监控） ALLCENTER

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

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 元