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

Aqara M3 网关桥接（灯 / 帘 / 传感）

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

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

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

支持机型
AQARA_HUB_M3
支持系列
AQARA_LAN
最低 SDK
21.0000.0000 驱动框架门槛由 Crestron 决定，低于这个版本的主机装不上这个包
驱动版本
1.0000.0001 2026-11-10 发布 · 属性页共 7 个配置项
安装包
42.9 KB sha256 651cf88e379c… · 2026-11-12 构建
已知边界
  • Aqara 网关已在 Aqara Home 里配好网，并开启「局域网通信协议」取得 16 位密钥；没开启时状态照读、控制不可用
  • 网关与主机在同一网段；跨 VLAN 要在路由器上放行 UDP 9898 与组播 224.0.0.50
  • 一栋房子建议只建一个实例；主备两台网关各建一个实例，共用同一枚站点码
  • 子设备由驱动自动枚举，不需要抄 sid；改名与型号覆盖都在配置页完成，不必重打包
  • 主机固件 21.0000.0000 及以上（OS 4.x）；低版本装不上，驱动不会出现在配对列表里
  • 在线码需要主机能出网；完全离线的机房请下单时说明，改发离线码

02怎么加

  1. 在 Aqara Home 里确认网关固件为最新版，然后进入该网关 → 更多设置 → 局域网通信协议 → 开启，复制显示的 16 位密钥（这个开关不在默认页面，部分固件要连点「设备类型」十次才出现）。
  2. 在路由器上给网关做 DHCP 静态绑定，记下它的 IP。子设备不用管，驱动会自己枚举。
  3. 把 CH-AQARA-BRIDGE.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 → 型号 AQARA_HUB_M3 → 点 ⊕。一台网关一个实例。
  6. Gateway IP 填网关地址；LAN Key 粘那 16 位密钥；State Poll 保持 15 秒。保存后 5 秒内子设备会成批出现在受管设备列表里。
  7. 给设备起名并分房间。默认名是「型号 + sid 后四位」，可以先在配置页的 Device Names 里一次写好（sid=名称，一行一条），也可以装完在 CH 里逐个改。
  8. 打开门户绑定站点码 → 购买（30 年 / 60 年 / 终生）→ 把签发的整段码粘回 License Code。保存后 30 秒内状态变化，不用重启主机。

03属性页每个字段怎么填

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

Gateway IP
192.168.1.50
留空则组播自动搜索；别墅网络多数拦组播，建议直接填
LAN Key (16 chars)
16 位字符
Aqara Home 里开启局域网通信协议后显示的那串；不填只能读不能控
State Poll (s)
15（默认）
上报即时刷新，轮询只兜底。低于 10 秒只增加流量
Device Names
sid=名称
可选，一行一条；不填用默认名
Device Overrides
sid=类别
可选，型号未收录时按台强制指定 light / curtain / sensor / skip
Site ID
自动生成，只读
下单时用这个号，不要手抄错一位
License Code
门户签发的整段码
粘错不会锁死，改对即可

04加之前要先有

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

  • Aqara 网关与主机在同一网段，且已开启局域网通信协议、拿到 16 位密钥
  • 路由器上给网关做了 DHCP 静态绑定（换 IP 要回配置页改一次）
  • 子设备是绿米自有 Zigbee 型号（第三方设备多数不上报属性）
  • 主机固件 21.0000.0000 及以上
  • 主机能出网（在线码要换租约；离线码不需要）
  • 门户账号已绑定该站点码，否则下单页选不到这台主机

05能做什么，做不到什么

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

可以

  • 一个实例管全宅：网关下的灯、窗帘、传感器自动枚举成三类设备，不需要逐台抄 sid 或写清单
  • 灯 / 插座：开、关（双键墙开自动拆成两路，各自独立进房间与场景）
  • 窗帘：开、关、停、百分比定位；位置与运行状态回读，命令后立即刷新而不是等一个轮询周期
  • 传感器：人体、门窗、水浸、烟感、燃气、温湿度、照度；状态词、温度、湿度、照度、电池电压都可进 Sequences 与条件判断
  • 双通道刷新：网关主动上报（report）即时刷新，定时轮询兜底补丢包与断网恢复
  • 断网自愈：网关重启或换 IP 后在下一轮轮询自动接回，不需要重配设备
  • 可编程面：每一路开关、每一扇帘的定位、每个传感器的状态与读数都进 Actions & Events
  • 整站点授权：一个站点加多少点位都不额外收费

不行

  • 本版覆盖三类：开关 / 插座、窗帘、传感器。无线开关（场景按钮）、门锁、摄像头不在本版范围 —— 场景按钮请继续用 Aqara App 的自动化或网关本地联动
  • CH 原生 Sensor 类型还未提供（官方列为 future version），本版传感器以属性 + 事件方式提供：可进 Sequences、可做条件判断，磁贴样式随 CH 版本更新自动改善
  • 子设备须为绿米自有 Zigbee 型号。第三方 Zigbee 设备接入 Aqara 网关后多数不上报属性，驱动只能认到一个空壳，不建议混接
  • 电池只报电压（mV），不换算百分比 —— 换算要按型号猜放电曲线，猜出来的数看着精确、其实不准；2600 mV 以下建议更换
  • 绿米不承诺局域网协议的版本兼容。固件大版本升级后若协议有变，驱动需同步更新；升级网关固件前建议先在样板间验证
  • 发布基线：协议层已用独立模拟网关完成 v1 / v2 两代全流程验证（握手、批量读、主动上报、开关、窗帘百分比、错误密钥、无密钥只读），真机首装建议先接一台网关、观察 5 分钟再批量铺开

06装完怎么验

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

  • 状态行显示「已授权」并带剩余天数 —— 只显示未填码说明码没存进去
  • 逐路点开关，灯要真的亮灭；再在 Aqara App 里按一次墙开，CH 这边应在 1 秒内跟着变（证明上报通了，不是只认自己发的命令）
  • 窗帘点开 / 停 / 关，帘子要真的动；能读位置的型号再拖一次 50%，看百分比是否回到 50 附近
  • 把一扇门磁分离再合上，CH 里的门窗设备状态与事件要跟着翻；人体传感器走过去应报「有人」并在无人后回到「无人」
  • 温湿度传感器与 Aqara App 里显示的数对比，误差应在 ±0.5℃ / ±3%RH 以内
  • 把网关网线拔掉 30 秒再插回，设备应在两轮轮询内自动恢复在线，不需要重启主机
  • 在门户控制台确认该产品显示「有效」而不是「试用中」，试用中说明买的是试用单

07常见故障

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

日志写「网关未应答」
按顺序查四项：IP 是否写对；网关与主机是否同网段（很多别墅的无线与有线是两张网）；路由器是否开了 AP 隔离或 IGMP 过滤；Aqara Home 里「局域网通信协议」是否真的打开了
状态能读、一点控制就被拒
密钥没填或填错。Aqara Home → 网关 → 更多设置 → 局域网通信协议 里那 16 位就是它；注意不要填成 Aqara 账号密码或网关 token
只认出一部分设备，日志里出现「型号未收录」
新型号不在内置表里。在 Device Overrides 里加一行 sid=light / curtain / sensor（双路写 light:2）先跑起来，把型号报给供应商，下个版本正式收录
设备列表里全是「型号 + 四位数字」
默认名。用 Device Names 一次写好（sid=名称），或装完在 CH 里逐个改名，房间分配不受影响
窗帘点百分比不动
部分早期型号只支持开 / 关 / 停，不认百分比。用开、关、停三个命令；能读回 curtain_level 的型号才支持定位
换了路由器，网关 IP 变了
在配置页把 Gateway IP 改成新地址保存即可，子设备与房间分配都不丢；顺手把 DHCP 静态绑定做上

08授权怎么生效

1 取站点码

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

2 门户下单

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

3 粘贴激活

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

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

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

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

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

涂鸦局域网照明网关 涂鸦 Tuya 易来局域网照明网关 易来 Yeelight

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

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 元