技术文档
HeimLink 技术文档
给同事看的技术说明：每一页只讲一个主题，标题下的一句话说明它回答什么问题。页面地址带创建日期，内容以发布当时的实现与协议版本为准。
App 使用说明（详细版）
给测试与产品同事的功能说明，按页面顺序讲每个按钮做什么
- HeimLink App 使用说明：设备与配对第一次打开、设备列表每一行的含义、扫码与扫描两种添加方式、SetupCode 输入、常见配对失败、温控器与恒温阀控制页、设备设置页每个按钮、设置页各项。对应 App 0.6.3 之后的 dev 分支。2026-09-30
- HeimLink App 使用说明：固件升级升级页布局、SecureLink 设备的 OTA wire v5 流程（预检、传输、Apply 确认、等待重启）、恒温阀的升级流程与帧间隔、失败提示、离开页面后的横幅。2026-09-30
- HeimLink App 使用说明：日志与开发者选项诊断分组、上传日志拿上传 ID、导出日志、连点版本号解锁开发者选项、调试工具台三个页签、调试桥接入、控制页更新、内测包的 Debug 页。2026-09-30
调试与排查
App 内置调试工具台的用法
固件升级
SecureLink 设备的 OTA：校验链与报错处理
ShimLink 协议
TRV901Z 恒温阀所用的兼容协议
Web App 与 SDK
在 HeimLink App 内运行的网页控制页如何调用设备
- HeimLink window.ty API 文档App 注入到网页的涂鸦 API 兼容命名空间 window.ty：七组接口的支持状态、参数与返回形态；沿用已认证的设备会话，保留 window.rti。2026-09-13
- 双路浇花器 API 对照：Tuya 与 HeimLink双路浇花器实际用到的 46 个涂鸦运行时 API，与 HeimLink 当前实现逐一对照：全部对应、部分对应，还是没有公开等价。2026-09-13
- DualOutletWaterTimer 接入 HeimLink让现有的浇花器 Web 应用成为 HeimLink 里可操作的控制页：需求矩阵、bridge 差距、推荐适配架构、模拟方案与实施顺序。2026-09-12
页面按创建日期命名（主题-yyyymmdd），同一主题的更新会另建新页并在这里替换入口。