本文介绍如何在 Batocera 中手动配对蓝牙手柄，包括详细的命令操作步骤。

前提条件

确保 controllers.bluetooth.enabled=1 在 system/batocera.conf 中已启用。

通过 SSH 连接

1. 建立 SSH 连接或打开 Xterm
2. 输入 bluetoothctl 进入蓝牙控制

配对步骤

第一步：启用蓝牙

agent on
default-agent
power on
scan on

第二步：让手柄进入配对模式

不同手柄进入配对模式的方式不同，请参考手柄说明书。

第三步：配对连接

pair XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX
trust XX:XX:XX:XX:XX:XX

将 XX 替换为你的手柄 MAC 地址。

第四步：验证

devices

常用命令

• devices – 列出已配对设备
• remove XX:XX:XX:XX:XX:XX – 移除设备
• hcitool dev – 查看蓝牙适配器

自动配对

仅配对手柄

batocera-bluetooth trust-pad

仅配对音频设备

batocera-bluetooth trust-audio

黑名单

如果某个设备（如智能电视）总是自动配对：

batocera-bluetooth blacklist <MAC地址> <设备名>

查看可黑名单设备

batocera-bluetooth list_blacklistable

取消黑名单

batocera-bluetooth unblacklist <MAC地址>

其他命令

batocera-bluetooth list          # 列出已信任设备
batocera-bluetooth remove <MAC>   # 移除设备
batocera-bluetooth save           # 保存配置
batocera-bluetooth restore       # 恢复配置
batocera-bluetooth live_devices  # 列出附近配对中设备

参考来源： Batocera 官方 Wiki – Bluetooth Manual Setup