主题
工装管理员-检具蓝牙绑定SOP
文档编号: BayesMES-SOP-TOOLING-003-V1.0 文档版本: V1.0 适用系统: BayesMES 制造执行系统 适用角色: 工装管理员、质量工程师（登记绑定）；超级管理员（换绑与解绑授权） 适用终端: 安卓 App（平板） 角色类型: 管理员/工程师 最后更新: 2026-09-21 下次评审: 2026-10-21 文档状态: 评审中（直连、登记、解绑、换绑已真机实测，见第 9 节） 编制人: BayesMES团队 审核人: 待确认 批准人: 待确认
真实性核对说明
本文档依据以下真实依据编写：
- BayesMES 后端工装模块检具蓝牙绑定能力与权限定义（2026-09-21 交付）
- App 页面
src/mes/pages/tooling/gauge/bluetooth.vue与src/mes/composables/use-bt-gauge-scan.ts @bayes-mes/shared工装类型、查询参数与路由常量
⚠️ App 直连、登记绑定、解绑、换绑四条链路已于 2026-09-21 在华为 DBR-W10（Android 12） 加一台数显检具上实测通过，实测记录见第 9 节；界面截图仍待补。
1. 名词术语表
| 术语 | 说明 |
|---|---|
| 检具 | 卡尺、千分尺、内径表等测量器具，先在工装管理「检具台账」中登记 |
| 蓝牙配对 | 检具与平板之间的系统级蓝牙连接，在平板的系统蓝牙设置里完成 |
| 登记绑定 | 把扫描到的蓝牙设备与台账中的一把检具建立一对一关系，系统据此把测量数据记到该检具号 |
| 换绑 | 保留绑定关系，只把蓝牙设备换成另一台 |
| 解绑 | 解除检具与蓝牙设备的关系，解绑后测量数据不再记该检具号 |
2. 前置条件
- 平板已安装并登录 BayesMES App（安卓端）。
- 检具已在 Web 端「工装管理 → 检具管理」登记，状态为正常。
- 检具已切到 Bluetooth Keyboard（键盘）模式。其它模式无法向页面发送数据。
- 平板的系统蓝牙已打开。
3. 功能入口
| 入口 | 路径 |
|---|---|
| 设置 → 设备管理 →「蓝牙检具」 | mes/pages/tooling/gauge/bluetooth |
| 质检工作台 → 底部「检具」→「搜索蓝牙检具」 | 同上（跳转时带上当前选用检具，便于预填） |
4. 权限说明
| 操作 | 权限 | 默认归属 |
|---|---|---|
| 查看配对与绑定日志 | tooling:gauge:view | 按既有角色分配 |
| 登记绑定 | tooling:gauge:bluetooth-bind | 默认授予系统管理员，可按角色授予 |
| 换绑、解绑 | tooling:gauge:bluetooth-rebind | 默认不授予任何角色，仅超级管理员 |
换绑与解绑是特殊权限。超级管理员在 Web「系统管理 → 角色管理」中编辑目标角色，勾选 检具管理 - 蓝牙换绑解绑 后保存，被授权的角色在 App 上才看得到「换绑」「解绑」按钮。 未授权时页面提示「换绑需超级管理员授权」。
5. 操作步骤
5.1 搜索附近的蓝牙检具
- 打开检具电源，进入 App「蓝牙检具」页面，点「扫描设备」。
- 页面列出附近设备，显示设备名、设备标识与信号强度。广播里带键盘服务的设备会标「键盘型检具」。
- 扫描 10 秒后自动停止。未发现设备时页面显示「未发现蓝牙设备」，确认检具已开机并在附近后重试。
5.2 连接检具（App 直连）
- 在目标检具那一行点「连接」。
- 连接成功后页面顶部「检具连接」卡片显示「已连接」，并自动读取设备标识与数据源，显示「已订阅」和数据源编号。
- 若提示「这台检具没有可订阅的数据特征」，说明该检具不支持直连收数，改用 5.6 的键盘模式登记。
直连由 App 主动连接检具，能读到设备唯一标识（安卓上是 MAC 地址），绑定关系因此是确定的， 多台检具同时连接时也能区分读数来源。信号弱于 -100 dBm 时容易掉线，把检具挪近平板即可； 掉线是能被探测到的，界面会退回「未连接」。
5.3 登记绑定
- 保持检具处于已连接状态，在「发现设备」列表里点该设备的「登记绑定」。
- 弹层顶部显示当前连接的设备与数据源。没连上时主按钮不可用并提示「请先连接检具」—— 这是有意设计，不允许只凭扫描结果就把设备挂到检具上。
- 在检具列表中选择要绑定的检具。只能选台账里已存在、且还没有蓝牙配对的检具；已配对的灰显并提示「已绑定其它配对」。
- 提交后提示登记成功，该检具成为工作台的当前选用检具；数据源随绑定一起固化，下次测量按固化数据源直接订阅。
- 重新进入质检工作台的「检具绑定与状态」，对应检具行显示「已配对蓝牙」。
一把检具只能有一个蓝牙配对，一个蓝牙设备也只能挂一把检具。重复登记会被拒绝并给出具体原因。
5.4 换绑（需特殊权限）
- 在「发现设备」或「已登记配对」里找到要换绑的记录，点「换绑」。
- 选择换绑后的设备，填写「换绑原因」（必填）。
- 提交后绑定关系更新，换绑次数累加，操作写入绑定日志。
换绑只更换蓝牙设备，不更换检具。要换检具，请先解绑再重新登记。
5.5 解绑（需特殊权限）
- 在目标记录上点「解绑」。
- 填写「解绑原因」（必填）并确认。
- 绑定关系解除。解绑不影响平板系统蓝牙里已完成的配对，只是测量数据不再记该检具号。
- 解绑后同一把检具可以随时重新登记绑定，不会因为有过历史绑定而被挡住。
5.6 键盘模式登记（备选）
检具连不上、或提示「没有可订阅的数据特征」时使用：
- 检具切到 Bluetooth Keyboard（键盘）模式，在平板系统蓝牙设置里完成配对。
- 回到「蓝牙检具」页面，扫描找到该设备后点「以键盘模式登记」。
- 键盘模式下 App 不能主动连接检具，读不到设备唯一标识，多台检具同时连接时也无法区分读数来源； 连接状态只能以"是否收到 DATA 键读数"判断，页面会显示「信号正常 / 暂无新数据 / 等待 DATA 信号」， 不会显示"已断开"。
5.6 查看绑定日志
在「已登记配对」列表中打开某把检具的日志，可以看到每次绑定、换绑、解绑的时间、动作、 新旧设备、操作人与原因。
6. 异常处理
| 现象 | 处理 |
|---|---|
| 提示「当前端不支持蓝牙扫描，请在安卓 App 中使用」 | 本功能只在安卓 App 可用，请改用平板上的 App |
| 提示「蓝牙未开启，请先在系统设置里打开蓝牙」 | 打开平板系统蓝牙后重试 |
| 扫描不到检具 | 确认检具已开机且处于键盘模式；确认已在系统蓝牙中配对过（部分系统不再列出已配对设备） |
| 提示「检具 X 已绑定蓝牙设备 Y」 | 该检具已有配对，需走换绑；没有换绑权限时联系超级管理员 |
| 提示「该蓝牙设备已绑定检具 Z」 | 该设备已挂在另一把检具上，先解除原绑定再登记 |
| 换绑或解绑按钮不可点 | 当前账号没有 tooling:gauge:bluetooth-rebind 权限，请联系超级管理员授权 |
| 工作台显示「暂无新数据」 | 检具休眠，长按检具 DATA 键回连；这不代表连接断开 |
7. 关键业务关联
- 工作台的测量数据按格记录检具号，换检具前先暂存，避免历史读数被记到新检具名下。
- 检具蓝牙配对状态与「能不能收到数据」是两件事：绑定只决定测量值记到哪个检具号，不影响能否收数。
- 检具台账本身的登记、校准、借用归还仍在 Web 端「工装管理 → 检具管理」办理。
8. 待确认问题清单
- 本 SOP 各步骤截图待补，截图需脱敏。
- iOS 端是否纳入支持范围待定：iOS 上已配对的 HID 设备通常不再出现在扫描结果里， 且同一台检具在不同 iPad 上会拿到不同的应用内标识。
- 扫码枪式的"一键登记"未做，现场仍是逐台扫描后点连接登记。
9. 实测记录（2026-09-21）
环境：华为 DBR-W10 / Android 12；检具为一台数显量具，广播名 AIMA-7252E3， MAC F1:22:33:72:52:E3，信号约 -105 dBm。
| 环节 | 实测结果 |
|---|---|
| 扫描 | 列表出现 6 台设备，该检具被正确标为「键盘型检具」 |
| 连接 | 连接成功，读到设备唯一标识 |
| 探测 | 8 个服务 / 21 个特征，自动选中可订阅数据源 |
| 订阅 | 显示「已订阅」 |
| 登记绑定 | 绑定落库，连接方式记为「App 直连」，绑定时间与绑定人完整 |
| 未连接时绑定 | 主按钮不可用并提示「请先连接检具」，服务端同样拒绝 |
| 解绑 | 成功；解绑后同一把检具重新绑定成功 |
| 换绑 | 换设备后检具台账不变，换绑次数累加，日志记录新旧设备与原因 |
| 换绑/解绑原因 | 不填时返回「请填写换绑原因，换绑会留痕」 |
现场注意事项：检具信号弱于 -100 dBm 时连接容易掉；掉线后界面会退回「未连接」， 这时要先把检具挪近再重新连接，然后才允许登记绑定。