HiBean Documentation

English

中文

English

中文

Appearance

macOS: Connect SPP (Classic Bluetooth Serial) Devices in HiBean ​

If your device uses SPP (Serial Port Profile) over Classic Bluetooth (RFCOMM), this guide walks you through the macOS setup and the HiBean binding flow.

On macOS, HiBean supports direct SPP connection: scan, bind, and connect inside HiBean. If pairing is required, HiBean will show pairing prompts based on macOS system callbacks.

In One Minute (TL;DR) ​

  1. Make sure Bluetooth is enabled on macOS and HiBean is allowed to use Bluetooth.
  2. Put your device into discoverable/pairing mode (critical).
  3. Open HiBean → Devices → + and select your device brand/model.
  4. Select your device from the list to bind; if pairing prompts appear, enter the PIN / confirm the number.

If HiBean shows an empty list, the most common cause is that the device is not currently discoverable (or needs to be removed and paired again).

Important: What “Scan” Means on macOS ​

On macOS, HiBean’s Classic Bluetooth (SPP) list is built from a nearby inquiry scan, not from the macOS “paired devices” list.

That means:

  • Even if the device is already paired in macOS, it may not show up in HiBean if it’s not advertising / not discoverable right now.
  • When binding or updating the Bluetooth identifier, put the device back into discoverable/pairing mode and scan again.

Before You Start (Two Checks) ​

  1. Is the device supported by HiBean?

    • Check the “Add device” list in HiBean. If the brand/model isn’t listed, the current version can’t connect to it yet.

  2. Is the device really SPP?

    • Check the manual or vendor description for: SPP, Serial Port, Bluetooth Serial.

Step 1: Bluetooth & Permissions (One-Time) ​

  1. Open System Settings → Bluetooth and make sure Bluetooth is on.
  2. If macOS asks for Bluetooth permission when launching HiBean, choose Allow.
  3. If you previously denied it, go to System Settings → Privacy & Security → Bluetooth and enable HiBean.

Step 2: Put the Device into Discoverable/Pairing Mode ​

How to enter pairing mode depends on the device. General tips:

  • Power on the device and enable pairing/discoverable mode (often indicated by a blinking LED).
  • Keep the device close to the Mac (within 1–2 meters).
  • Make sure the device is not connected to another phone/tablet/app at the same time.

Step 3: Bind & Connect in HiBean (macOS) ​

  1. Open HiBean on macOS.
  2. Go to Devices → click +.
  3. Choose the correct device category, then pick the brand/model.
  4. Wait for your device to appear, then select it to finish binding.
  5. HiBean will connect automatically after binding.

Pairing Prompts (Common Cases) ​

During binding, you may see one of the following:

  1. PIN code request

    • Enter the PIN from the manual (common defaults are 0000 or 1234).

  2. Numeric confirmation

    • Confirm the number matches what’s shown on the device/system.

  3. “Enter the passkey on the device”

    • Follow the prompt and enter the passkey on the device side.

Troubleshooting (Most Common Cases) ​

HiBean shows an empty list / can’t find the device ​

  • Make sure the device is currently discoverable/pairing (most common on macOS).
  • Toggle Bluetooth off/on and scan again.
  • Restart the device, then restart HiBean.
  • If it was paired before, remove it in System Settings → Bluetooth, then pair again.
  • Ensure the device isn’t connected to another host/app.

Pairing succeeded, but connection fails / disconnects ​

  • Close other tools that might be using the device (serial monitors, debugging tools, etc.).
  • Move the device closer and avoid interference (USB3 devices, routers, etc.).
  • Removing and pairing again often improves stability.

The device is paired in macOS, but still not visible in HiBean ​

This is expected in some setups: HiBean relies on a nearby inquiry scan and may not be able to list macOS paired devices reliably. Put the device back into discoverable/pairing mode and scan again.