ALLCENTER 授权中心
首发 门锁 · 云端 · 中继

耶鲁门锁云接入(Yale Home)

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

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

支持机型
YALE_HOME
支持系列
Yale Home cloud locks via ALLCENTER relay
最低 SDK
21.0000.0000 驱动框架门槛由 Crestron 决定,低于这个版本的主机装不上这个包
驱动版本
1.0000.0003 2026-11-12 发布 · 属性页共 5 个配置项
安装包
40.2 KB sha256 67742c18e8b3… · 2026-11-12 构建
已知边界
  • 主机固件 21.0000.0000 及以上(OS 4.x);低于此版本装不上,驱动不会出现在列表里
  • 开锁需要主机能出网(中继在公网);完全离线的项目不适用
  • 每把锁一个网桥,网桥长期插电、走 2.4G Wi-Fi,锁与网桥 30 英尺内
  • 全屋门锁不超过 16 把(Crestron Home 容量)

02怎么加

  1. 先在 Yale Home App 里把锁配好:每把锁一个网桥,锁到网桥 30 英尺内(建议 15 英尺),网桥走 2.4G Wi-Fi 并长期插电 —— 这是耶鲁自己的组网要求,不是我们的限制
  2. 在门户为这个站点开通门锁中继,拿到两个值:Relay Endpoint(中继地址)与 Site Token(站点令牌)。一个站点一份,覆盖该站点全部锁,不是一把锁一份
  3. 加设备:新版 Configure Pro 走 Devices → Add Device;旧版 Crestron Home Setup App 走 Settings → Configure System → Pair Devices → Drivers —— 两代看到的是同一批驱动
  4. 设备类型选 Platform → 厂商 ALLCENTER → 型号 YALE_HOME → 点 ⊕
  5. 第一页填 Relay Endpoint、Site Token、State Poll;第二页填 License Code —— Site ID 会在页面打开约 10 秒后自动回填,下单时报它
  6. 保存后 10 秒内,中继返回的每一把锁都会在房间里生成一张设备卡;在 Yale Home App 里新增锁,最迟一个轮询周期后自动出现,不用回来改配置

03属性页每个字段怎么填

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

Relay Endpoint
中继地址,如 https://lock.allcenter.cn
内网调试填 http://<中继IP>:8790;改地址后驱动会重连并重新拉清单
Site Token
门户为本站点签发的令牌
等同钥匙:谁拿到谁就能开门,不要写进交付文档或拍照留档
State Poll (s)
10(默认),可选 5–60
低于 5 秒没有收益:云按账号限流,轮询越快越容易被限
Site ID
自动回填,只读
下单时报这个号;同机所有 ALLCENTER 驱动显示同一个值
License Code
门户签发的整段码
没填码时读状态正常、开锁与用户写入全拒,状态行写「未授权」

04加之前要先有

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

  • Yale Home App 里锁已配对、在线,且能看到实时状态(App 里点得动,驱动才读得到)
  • 每把锁都配了自己的网桥:网桥与锁之间是蓝牙,网桥与云端是 Wi-Fi,缺一个都上不了云
  • 主机能出网:门锁走云端,纯离线项目不适用
  • 站点已在门户开通门锁中继并绑定主机站点码
  • 全屋门锁不超过 16 把 —— 这是 Crestron Home 的锁容量,不是驱动限制;超过要上门禁系统

05能做什么,做不到什么

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

可以

  • 远程开锁 / 上锁,状态双向:界面显示的是锁舌的真实状态,不是「最后发过什么命令」
  • 开门记录:密码、指纹、钥匙、App、自动回锁都能归到事件里,带时间与操作人(锁上分配过用户名时)
  • 电量百分比与电量档位(正常 / 低 / 需更换)
  • 在线与就绪分开报:在线只说明云上能看见它,就绪才说明它现在能执行命令
  • 用户与密码:永久码、临时码(起止时间)、周表码;增删改都落到锁上,失败会报错而不是假装成功
  • 一个实例管整站:新增锁自动出现、撤掉的锁自动消失,不用一台一台加
  • 读状态不受授权影响:没填码也能看状态、电量与记录,只是所有写操作被拒

不行

  • 只覆盖 Yale Home 生态(国内 YDM / YMF / YMK 等已配网桥的型号)。美标 Assure 系列那套走 infiNET EX / Z-Wave,不在本驱动范围;Matter 版要求主机有 Matter 控制器,CH 目前没有
  • 状态只有「已锁 / 未锁」两个值,不含门开没开。要知道门是不是虚掩,必须另建门磁(Sensor),不要指望锁能告诉你
  • 开锁命令被云端受理不等于门开了。驱动先报「开锁中」,以回读为准;8 秒内没有回读就退回上一次已知状态并记一条错误 —— 宁可显示「不知道」,也不显示一个假的「已开锁」
  • 开门记录只有「最近一条」是实时的:CH 的锁能力没有事件队列,驱动自己维护一个短队列并去重,两次轮询之间的中间事件会被覆盖。轮询 10 秒时,记录粒度就是 10 秒一条
  • 时间表在锁与云端执行,不在 CH 里算:CH 掉线不影响临时码到期,这是刻意的设计;反过来,CH 也改不了锁的系统时间
  • 中继是必需品:CH 在局域网里收不到公网推送,事件靠中继保持长连接再转成轮询。中继不可达时所有锁显示「状态未知」,不会伪装成「已锁」
  • 数据经中继转发:Yale Home 账号若属境外服务,开锁记录与用户名出境需按项目做合规评估
  • 单站点 16 把上限(Crestron Home 容量);超过 16 把请提前说明,改走门禁

06装完怎么验

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

  • 状态行显示「已连接 · N 把锁」,N 与 Yale Home App 里的锁数一致
  • 房间里每把锁一张卡,名字与 App 里一致;改名在 App 里改,下一个轮询周期 CH 跟着变
  • 点开锁:先「开锁中」,听到锁体动作后变「已开锁」;再点上锁同理
  • 在锁上按密码开门,10 秒内 CH 的事件里出现「密码开锁」并带用户名
  • 拔掉网桥电源,2 分钟内锁卡变离线;插回后 2 分钟内恢复
  • 门户控制台里该产品显示「有效」,不是「试用中」

07常见故障

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

状态行写「未授权」
没填码,或码是给别的主机签的。用属性页里的 Site ID 重新下单,粘回 License Code 保存,30 秒内状态变化;读状态一直不受影响
状态行写「中继不可达」
先在能上网的电脑上打开 <中继地址>/healthz,返回 ok 才说明中继活着;再看主机能不能出网(DNS / 防火墙 443)
开了锁,界面停在「开锁中」后跳回「已锁」
云端没在 8 秒内给回读。看锁卡上的错误码 confirm_timeout,再去 Yale Home App 点一次:App 也点不动就是网桥或云的问题,与驱动无关
房间里没有出现锁
中继返回的清单是空的:Site Token 可能对应另一个 Yale Home 账号,或 App 里那把锁还没同步到云。先在中继上手动拉一次 /v1/site 看返回
锁显示离线,但 App 里正常
网桥掉线或路由器把它踢了。锁与网桥是蓝牙,网桥与云端是 Wi-Fi —— App 走的是同一条路,两边不一致时以中继的 /v1/site 为准
加用户报错
锁拒绝写入:密码位数不在 4–8 位、这把锁的用户已满、或型号不支持密码。把错误码报给供应商,不要重复重试
删用户报错
官方要求删不掉必须报错 —— 这时锁上的码还在。先在 Yale Home App 里删一次,确认锁已收到再回 CH 重试

08授权怎么生效

1 取站点码

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

2 门户下单

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

3 粘贴激活

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

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

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

版本更新
买断后 1.x 大版本内的升级免费重下,不额外收费;跨大版本按当时首发价 5 折补差
到期之后
买断授权永久有效,没有到期日、不续费;在线授权按租约自动续期
技术支持
工作日 09:00–21:00,微信或邮件,4 小时内首次响应;不含现场上门与耶鲁账号、网桥的排障
迁移换机
换主机不用换码:站点码由 SN/MAC 派生;增补或更换门锁也不重签,授权是按站点不是按锁

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

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 元