HeimLink App 使用说明：设备与配对

第一次打开、设备列表、添加设备、控制页、设备设置、设置页 · 对应 App 0.6.3 之后的 dev 分支（2026-09-30）· Android / iOS

HeimLink App 使用说明系列

这一页讲 HeimLink App 的日常用法：第一次打开要做什么、设备列表怎么看、两种添加设备的方法、控制页上有什么、设备设置页里每个按钮做什么，以及设置页的各项。固件升级、日志与开发者选项各有单独一页。

先看这三点

不用注册、不用登录。设备与配对凭据只保存在这部手机上，手机和设备之间直接走蓝牙，不经过服务器。
添加设备有两条路：首页左上角的扫码图标扫设备二维码，或右上角的加号在附近设备列表里选一台再输入配对码。
换手机、给家人共用设备时，要在原手机上「解除绑定」或把设备恢复出厂，再在新手机上重新配对。设备只认配过对的手机。

第一次打开

引导页与权限

App 在手机上显示为 RtiTek。第一次打开是引导页，标题「欢迎使用 RtiTek」，列出四项能力（扫描附近的 BLE 设备、保存并重命名设备、读写 GATT 特征、导出和导入设备列表），点「开始使用」进入首页。以后可以在设置页的「查看引导」再看一次。

第一次扫描设备时系统会请求蓝牙权限；Android 11 及以下还需要开启系统的位置信息，否则扫不到蓝牙设备。位置信息关着的时候，首页和扫描页顶部会出现一条提示，带「打开设置」按钮。

界面总览

两个页签、三个入口

底部有两个页签：「设备」和「设置」。「设备」页签的页面标题是「我的设备」，标题栏左侧是扫码图标（扫设备二维码添加），右侧是加号（扫描附近设备）。设备列表里点任意一行进入这台设备的控制页，控制页右上角的设置图标进入设备设置页。

设备列表

「我的设备」页每一行的含义

没有设备时显示「还没有设备」和「点击 + 扫描附近的蓝牙设备」。有设备时每一行是一张卡片：左边是设备图标，中间三行分别是设备名、连接状态和状态摘要，右边是箭头。停留在这个页签时 App 一直在后台扫描广播，已保存的设备一被扫到就变成「在范围内」，不用先打开扫描页。

状态文字	颜色	含义	点这一行会怎样
已连接	绿色	手机正与这台设备保持连接并已通过认证。头像变成渐变色块。	进入控制页
在范围内	蓝色	最近 20 秒内收到过它的广播，但还没连接。	进入控制页并自动连接
不在范围内	灰色	超过 20 秒没收到广播。设备可能没电、太远，或正被另一部手机连着（连接期间设备不广播）。	进入控制页，App 会扫描 10 秒找它，找不到则显示「不在范围内」
保存的凭据可能已失效	橙色	上次连接时设备拒绝了 App 保存的凭据，设备可能被恢复出厂或被别的手机重新配对。	进入控制页，页面会提示移除后重新添加
协议已升级 - 需重新配对	橙色	这条记录是旧协议版本配的，或是从导出文件导入的，现在的 App 不能直接用。	打开扫描页，重新配对
需要恢复存储	橙色	App 保存的密钥与设备不再匹配。	打开设备设置页，用「仅从 App 移除」删掉后重新配对

第三行的摘要来自上次连接时读到的设备状态，比如「制热 · 21.0°C · 电量 80%」。未连接时显示的是旧值；从没读到过状态时显示「暂无设备数据」。列表按已连接、在范围内、不在范围内的顺序排。

添加设备：方式一，扫二维码

首页左上角的扫码图标

相机页提示「Scan the pairing QR on the device or its packaging.」，对准设备机身或包装上的配对二维码即可，不用按快门。App 认三种码：

RT 码：SecureLink 设备（温控器等）的配对二维码，扫到后直接开始配对，不用再输入配对码。
TRV 二维码：ShimLink 恒温阀（TRV）的二维码。扫到后 App 在附近找处于配网状态的阀门并配对，所以扫码前先在阀门上开启配网窗口。
标准 Matter 码：能解码，但如果不是本公司产品，会报「这台 Matter 设备不是 RtiTek 产品（厂商 …，产品 …），请用它自带的 app 配网」。

不是配对码的二维码会被忽略，相机继续等。扫到后画面切换成配对进度：上面一行是当前步骤，下面的列表逐条打勾。配对成功后直接进入设备控制页。失败时显示「配对失败」、原因说明和一行小字 reason: … · step: …（报问题时把这行一起截图），下面是「重试」和「取消」。

添加设备：方式二，扫描附近设备

首页右上角的加号

扫描页顶部一行是状态：左边的圆点绿色表示蓝牙已开、红色表示蓝牙关着，文字是「扫描中…」或「找到 N 个设备」，右边的按钮在「停止」和「重新扫描」之间切换。设备分两组：「支持的设备」和「其他设备」。只有支持的设备那一行的「连接」按钮能按。一台设备停止广播 5 秒后就从列表里消失，所以列表里的都是此刻能连上的。

行内元素	含义
左上角小标签	设备广播出来的配对状态：可配对可以直接配；已配对已经绑过一部手机，要先在设备上重置；锁定中配对码连续输错，设备暂时拒绝配对；配对窗口已关闭设备暂时不接受配对，去设备上重新开启。
设备名	设备广播的名字，例如 `RT-0460`。
dBm	信号强度，颜色从绿到红表示由强到弱。数字只在收到新广播时更新。
#0460 这样的四位数	设备的识别码（discriminator）。同型号设备多台时靠它和二维码对应。
一串地址	系统给这台设备的蓝牙标识。Android 是 MAC 地址，iOS 是一串 UUID。

点「连接」后进入配对页，App 连上设备后弹出「Enter SetupCode」表单：

在「Product」里选产品型号。列表只列出当前 App 已安装契约、且品类与这台设备相符的产品。
输入 11 位数字的 SetupCode（占位提示 XXXX-XXX-XXXX，可以不输连字符）。输错会提示「Not a valid SetupCode — check for a typo.」；如果这个码不属于你选的那台设备，提示「This SetupCode does not match the selected device. Cancel and scan again.」。
也可以点输入框右侧的扫码图标，直接扫设备上的配对二维码，App 会核对它和列表里选的是不是同一台。
点「Pair」开始配对。之后的进度和失败画面与扫码添加相同。

配对进度里会出现的步骤

正在启动蓝牙… → 正在查找你的设备… → 正在连接… → 已连接。 → 正在配对… → 正在写入设备归属… → 正在安全重连… → 正在验证已保存的 OwnerKey… → 正在保存设备… → 配对成功！扫码添加时如果附近有多台匹配的设备，会出现「正在尝试下一个匹配的设备（1/2）…」。TRV 配对多一步「正在用新钥匙与阀门对账…」。

常见的配对失败

提示	怎么处理
附近没有与此二维码的产品和标识码匹配的可配对设备。	确认设备已上电、在配对状态、离手机 1 到 2 米内；扫的确实是这台设备的码。
该设备已与另一部手机配对。请先将其恢复出厂设置，再重新配对。	在设备上做重置（长按按键），或在原手机上「解除绑定」。
设备已锁定，请在 N 秒后重试。 / 设备已锁定。请长按设备按钮将其恢复出厂设置。	配对码连续输错触发了限速。等倒计时结束，或按提示重置设备。
位置信息已关闭，无法扫描到设备。	Android 11 及以下打开系统位置信息后重试。
配对需要蓝牙权限。	到系统设置里给 App 授予蓝牙（Android 12 起是「附近的设备」）权限。
该设备使用的协议版本不受支持。	设备固件比 App 新或旧。更新 App，或让固件同事确认版本。
阀门当前不可配对，请按设备按键开启配网窗口。 / 附近未发现可配对的阀门…	TRV 的配网窗口是有时限的，先在阀门上开启再扫码。
发现 N 台可配对阀门，请靠近你扫码的那台后重试。	同时有多台阀门在配网状态，靠近目标那台或让其它阀门退出配网。
配对码校验失败，请重新扫描二维码（剩余 N 次尝试）。 / …尝试次数已用尽，请在阀门上重新开启配网窗口。	二维码不是这台阀门的。用尽次数后要在阀门上重新开配网。
这台设备已保存的密钥与它不再匹配。请在「我的设备」里打开它并删除，然后重新配对。	照提示做：设备设置页 →「仅从 App 移除」→ 重新添加。

设备控制页

从列表点进去看到的页面

控制页是内置在 App 里的网页，按产品品类选择：温控器品类打开「Thermostat」，ShimLink 恒温阀打开「Radiator Valve」。顶部标题栏左侧「Devices」回到列表，右侧设置图标进入设备设置。打开页面时 App 会自动连接这台设备（可在设备设置里关掉），连接过程中控制项是灰的。

如果控制页打不开，页面中间会给出原因和「重试」「返回」「移除设备」三个按钮。四种原因：设备拒绝了保存的凭据（移除后重新添加）；需要重新配对；保存的密钥与设备不匹配（移除后重新配对）；其它情况（重试或更新 App）。

温控器控制页（Thermostat）

顶部连接条：圆点和「Connected / Connecting… / Disconnected」，已连接时显示设备名，断开时是「Connect」或「Reconnect」按钮。
安全配对面板：连上但还没完成安全握手时，页面被「Secure pairing required」盖住；握手失败显示「Secure pairing failed」和「Try Again」「Disconnect」。
温度表盘：拖动表盘或点下方的减号、加号调目标温度，松手后下发。范围与步进按产品定，例如 RUS695 是 5 到 35 °C、步进 0.5。表盘下方「Room」是当前室温，「Mode」是当前模式。
Mode：Off / Heat / Cool / Auto 四段开关，点一下即下发。
Device：产品契约里声明了才显示的项目：「Child lock」开关、「Display unit」°C/°F（改的是设备屏幕上的单位）、「Runtime history」进入历史页。
Device diagnostics：折叠区，放风扇等不常用的项和调试信息。
History 页：从「Runtime history」进入，选时间范围和单位，显示设备记录的温度曲线。数据从设备读，范围大时要等几秒。

恒温阀控制页（Radiator Valve）

页面按 ShimLink 的数据点分区，每一项改动后立即下发，设备回报后界面刷新：

Connection / Heating / Battery / Window：连接状态、是否在加热、电量、开窗检测状态。
Temperature：当前温度与目标温度（Current / Setpoint）。
Work Mode：Manual、Frost、Auto、Boost、Holiday，以及设备上手动改出来的 Temporary manual（在设备上设置，到下一个日程点结束）。下面是各模式的目标温度、Boost 时长、假期天数与假期目标温度、临时模式结束后回到的模式。Boost 和 Holiday 的参数在选中该模式时一起发送，模式运行中改参数会立即生效。
Settings：Child Lock、Open Window Detection、Smart Temperature Control、Temperature Calibration、Control Hysteresis、Display Direction（Up/Down）、Low Battery Valve Opening、Preheating（设备不回报这一项，所以看不到当前值）。
Valve Calibration：「Start」「End」触发阀门校准，下面显示校准状态和结果。
Schedule：周日程表。第一次打开显示「The schedule has not been read from the device yet.」，读到后可以逐天编辑，「Copy to all days」复制到每一天，「Save schedule」写回设备。

设备一次只服务一件事

设备在配对或固件升级期间不接受其它操作，此时控制会提示「设备正在配对，请等配对结束后再试。」或「设备正在升级固件，请等升级结束后再试。」。升级期间列表里其它设备的自动连接也会暂停。

设备设置页

控制页右上角的设置图标，标题「Device Settings」

分区	项目	说明
设备信息	设备 ID / 添加于 / 最后发现	只读。设备 ID 是 App 内部的记录编号，不是蓝牙地址。
名称	输入框	改设备在列表里的显示名，最长 64 个字，离开输入框或按完成键即保存。原始名称仍保留用于识别设备。
连接	自动连接	默认开。关掉后打开控制页不再自动连接，要在控制页里手动点「Connect」。
操作	断开连接	只在已连接时可按。断开后设备恢复广播，别的手机才能连它。
	固件升级	只在已连接时可按，进入升级页。见「固件升级」一页。
	轮换设备密钥	只有 TRV 有这一项，且要已连接并认证。让设备换一把新的认证密钥：本机保持配对，其它还持有旧密钥的手机会失去访问权；设备的配置、历史和固件都保留。设备的密钥代次有上限，用尽后提示「轮换次数已用尽」，只有重新配对才能恢复。
	解除绑定	红色按钮，需已连接。让设备忘掉这部手机，同时删除本机保存的记录。设备的配置、历史记录、当前固件和升级状态都保留，之后任何手机都能重新配对它。
	解除绑定并清除数据	红色按钮，需已连接。在解除绑定之外还让设备恢复出厂设置：用户配置、历史记录、日程、用户校准和待处理的升级数据都清除，当前固件保留。
	仅从 App 移除	红色按钮，未连接时显示。只删本机记录和凭据，不通知设备。设备仍认为自己绑着这部手机，要让别的手机配对它得先在设备上按重置按钮。

每个红色按钮都会先弹确认。「解除绑定」和「解除绑定并清除数据」发出后，如果 App 没能认证设备的最终应答，页面顶部会出现黄色的「移除结果未知」提示：设备可能已经解除绑定，App 保留了凭据；下次成功连接并认证时会自动清掉这个状态，也可以直接点里面的「仅从 App 移除」。设备正忙时会提示「设备忙」，请稍后重试；设备拒绝或存储失败时两边都保持原状。

设置页

底部「设置」页签

分区	项目	说明
通用	主题	跟随系统 / 浅色 / 深色。
通用	语言	跟随系统，或 Deutsch、English、Español、Français、Italiano、简体中文。语言名一律用该语言自己的写法。
关于	应用	显示 RtiTek。
	版本	版本号与构建号。连续点 7 次解锁开发者选项，见「日志与开发者选项」一页。
	隐私政策	打开内置的隐私政策页。
	查看引导	重看引导页。
数据	导出设备	把设备列表导出为 JSON 文件，走系统分享菜单。文件里没有配对凭据，所以它只是一份清单。
	导入设备	选一个导出的 JSON 文件合并进列表。导入的设备都带「协议已升级 - 需重新配对」或「需要恢复存储」标记，必须重新配对才能用。
	移除所有设备	清空本机的设备列表和凭据，不通知设备，不可撤销。
诊断	Env / Build / Protocol / Operator / Debug / 导出日志 / 清除日志	见「日志与开发者选项」一页。