HiBean 文档

中文

English

中文

English

Appearance

macOS 上连接 SPP 设备：经典蓝牙直连与配对（HiBean） ​

如果你手上的设备使用 SPP（经典蓝牙串口 / RFCOMM），本指南将介绍如何在 macOS 上把它连接到 HiBean。

在 macOS 上，HiBean 支持 经典蓝牙（SPP）直连：在 HiBean 中完成扫描、绑定与连接；如设备需要配对，HiBean 会按系统回调弹出配对提示。

相关文档索引（建议先看） ​

1 分钟结论（先看这个） ​

  1. 确认 macOS 已开启蓝牙，并允许 HiBean 使用蓝牙权限。
  2. 让设备进入“可被发现/可配对”状态（非常关键）。
  3. 打开 HiBean → 设备 → +，选择你的设备品牌/型号。
  4. 在列表中选择你的设备并完成绑定；如弹出配对提示，按提示输入 PIN/确认数字。

如果 HiBean “扫描不到/列表为空”，优先怀疑：设备没有处于“可被发现/可配对”状态，或需要“忘记设备后重新配对”。

重要：macOS 上 HiBean 的“扫描”是什么？ ​

在 macOS 上，HiBean 的经典蓝牙（SPP）设备列表来自 附近扫描（inquiry），并不是“系统已配对设备列表”。

这意味着：

  • 即使设备在 macOS 系统里显示“已配对”，如果它当前不再广播/不可被发现，HiBean 里也可能看不到它。
  • 需要绑定/更新蓝牙标识符时，请优先让设备重新进入“可被发现/可配对”状态，再回到 HiBean 扫描。

开始前的两个确认点 ​

  1. 设备是否受 HiBean 支持

    • 请以 HiBean 的“添加设备”列表为准：如果列表中没有对应品牌/型号，当前版本暂不支持连接。

  2. 设备是否为 SPP（经典蓝牙串口）

    • 以设备说明书/厂商描述为准，常见关键词：SPP、Serial Port、Bluetooth Serial、串口蓝牙。

第一步：确认蓝牙与权限（一次性） ​

  1. 打开 系统设置 → 蓝牙，确保蓝牙已开启。
  2. 如首次打开 HiBean 时弹出“蓝牙权限”提示，请选择 允许。
  3. 若之前点过“不允许”，可在 系统设置 → 隐私与安全性 → 蓝牙 中，开启 HiBean 的开关。

第二步：让设备进入可配对/可发现状态（每次绑定都建议确认） ​

不同设备进入配对模式的方法不同，请以说明书为准。通用建议：

  • 打开设备电源并进入配对模式（通常会有指示灯闪烁）。
  • 设备尽量靠近电脑（建议 1–2 米内）。
  • 确保设备没有同时连接到手机/平板或其他软件（同一时间通常只能被一个主机稳定占用）。

第三步：在 HiBean（macOS）中绑定并连接 ​

  1. 打开 HiBean macOS 客户端。
  2. 进入 设备 页面，点击右上角 +。
  3. 选择你要连接的设备类别（烘焙机/配件等），再选择对应的品牌/型号。
  4. 等待列表出现你的设备，点击完成绑定。
  5. 绑定完成后，HiBean 会自动连接。

配对提示怎么处理（macOS 常见三种情况） ​

在绑定过程中，如果设备需要配对，HiBean 可能会出现以下提示：

  1. 要求输入配对码（PIN）

    • 按说明书输入 PIN（常见默认码为 0000 或 1234）。
    • 不确定 PIN 时建议先查说明书/厂商文档。

  2. 数字确认（确认两端显示的数字一致）

    • 设备端/系统可能会显示一串数字，HiBean 会提示你确认是否一致。
    • 一致则选择确认；不一致选择取消并重新配对。

  3. 提示“请在设备端输入配对码”

    • 这通常表示需要你在设备端输入一个 passkey，请按提示在设备端完成输入。

常见问题排查（按出现概率排序） ​

1）HiBean 扫不到设备 / 列表为空 ​

  • 确认设备正处于“可被发现/可配对”状态（这是 macOS 上最常见原因）。
  • 关闭再打开 macOS 蓝牙开关，重试扫描。
  • 重启设备，再重启 HiBean。
  • 若你之前在系统里配对过该设备：在 系统设置 → 蓝牙 中对设备选择 忽略/移除，然后重新配对再试。
  • 确认设备没有同时连接到手机/平板或其他软件。

2）配对成功，但连接失败/容易断开 ​

  • 确保没有其它工具在占用设备（串口工具、调试工具等）。
  • 设备与电脑保持距离更近，避开干扰源（USB3 设备、路由器等）。
  • 先“忽略/移除设备”，再重新配对通常能显著改善成功率。

3）设备在系统里显示已配对，但 HiBean 里还是找不到 ​

这是 macOS 上的常见现象：HiBean 的列表来自“附近扫描”，不一定能读取系统的“已配对列表”。请让设备重新进入“可被发现/可配对”状态后再扫描。