蓝牙手柄手动设置-一起DIY吧

📖 本文由 Batocera 官方 Wiki 翻译整理，内容可能随版本更新而变化。

手动连接蓝牙手柄操作指南

如果自动搜索无法连接你的蓝牙手柄，别担心，我们可以通过后台命令行手动进行配对。这就像是放下了“自动导航”，改用“手动驾驶”来确保设备精准对接。

第一阶段：检查蓝牙开关

在开始操作前，我们需要确认系统的蓝牙功能已经处于“待命”状态。

第一步：打开配置文件
访问并打开你的 system/Batocera.conf 配置文件。
第二步：核对配置代码
检查文件中是否存在 controllers.bluetooth.enabled=1 这行代码。
第三步：激活代码
确保这行代码前面没有 # 号（即没有被注释掉）。如果找不到这行代码，请手动将其添加进去。

【提示】：此操作仅用于激活软件开关。如果你的蓝牙适配器（Dongle）本身与 Linux 内核或 Batocera 驱动不兼容，这个设置也无法让它起死回生。

第二阶段：进入蓝牙控制台

我们需要直接与系统的“通讯中心”对话。

第一步：建立远程连接
通过 SSH 远程连接（Secure Shell）或者在桌面模式下打开终端窗口（Xterm）。
第二步：启动控制程序
在命令行输入 bluetoothctl 并按下回车键（Enter）。

第三阶段：执行配对指令

进入蓝牙管理模式后，请依次输入以下指令，每输入一行都要按一次回车键确认：

agent on（开启代理，准备处理配对请求）
default-agent（设置默认代理）
power on（开启蓝牙电源）
scan on（开始扫描周边的信号）

生活化类比：这套动作就像是交警在处理路况前的准备工作——先穿上制服（agent on），带上哨子（default-agent），打开信号灯（power on），最后带上望远镜观察四周（scan on）。

第四阶段：手柄配对

关键步骤：开启手柄配对模式
现在，请让你的手柄进入配对状态（Pairing mode）。

【注意】：每款手柄开启配对模式的方法大不相同（例如 PS4 手柄通常是同时按住 Share 和 PS 键），请参考你手柄的使用说明书。

成功操作示例

当你正确执行上述指令后，你会在屏幕上看到类似下面的反馈信息，这代表系统已经准备好接收信号了：

[root@Batocera /userdata/system]# bluetoothctl
Agent registered
[bluetooth]# agent on
Agent is already registered
[bluetooth]# default-agent
Default agent request successful
[bluetooth]# power on

蓝牙手柄手动配对：识别与连接篇

在上一步开启了蓝牙扫描功能后，系统就会开始在空气中“搜寻”你的手柄信号。接下来，我们将通过识别设备的唯一身份，完成最后的精准对接。

第一阶段：寻找你的手柄

输入 scan on 后，屏幕上会跳出一串复杂的代码。请屏息凝神，寻找那个带有你手柄名称的条目：

Changing power on succeeded
[bluetooth]# scan on
Discovery started
[CHG] Controller 43:45:C0:00:1F:AC Discovering: yes
[NEW] Device E4:17:D8:C2:0B:0E 8BitDo M30 Modkit

生活化类比：这就像是在茫茫人海中找人。E4:17:D8:C2:0B:0E 是它的MAC地址（MAC address），相当于手柄的“身份证号”；而后面的 8BitDo M30 Modkit 则是它的“名字”。名字可能会重名，但身份证号是全球唯一的。

【提示】：如果你在屏幕上刷不出任何设备信息，请移步至“故障排除（Troubleshooting）”页面的蓝牙章节寻求帮助。

第二阶段：正式建立连接

一旦锁定了手柄的“身份证号”（以本例中的 E4:17:D8:C2:0B:0E 为例），我们就可以通过以下“三部曲”完成连接。

第一步：发起配对（Pair）
输入 pair E4:17:D8:C2:0B:0E 并回车。这相当于向手柄发送“交友申请”。
第二步：建立连接（Connect）
输入 connect E4:17:D8:C2:0B:0E 并回车。这相当于双方正式“握手”建立连接。
第三步：赋予信任（Trust）
输入 trust E4:17:D8:C2:0B:0E 并回车。这相当于把手柄存入“白名单”，下次开机时它就能自动连接，无需再次手动操作。

【注意】：在输入每一条指令后，请耐心等待几秒钟，给系统一点“反应时间”，确保当前步骤处理成功后再继续下一步。

操作成功的反馈参考

如果一切顺利，当你执行“配对”指令时，你会看到类似下面的信息，特别是最后那句令人振奋的 Pairing successful：

[bluetooth]# pair E4:17:D8:C2:0B:0E
Attempting to pair with E4:17:D8:C2:0B:0E
[CHG] Device E4:17:D8:C2:0B:0E Connected: yes
...
[CHG] Device E4:17:D8:C2:0B:0E Paired: yes
Pairing successful

[bluetooth]# connect E4:17:D8:C2:0B:0E
Attempting to connect to E4:17:D8:C2:0B:0E

至此，你的手柄已经成功与 Batocera 建立了深厚的“革命友谊”！

蓝牙手柄手动配对：授权与多适配器管理

即使是在手动连接的过程中，系统有时也会像“安保人员”一样弹出一些询问。别担心，这只是为了确保连接的安全。

第一阶段：通过安全验证

在执行连接指令时，你可能会遇到需要手动确认的环节：

第一步：处理连接报错
如果你看到 Failed to connect: org.bluez.Error.Failed，通常是因为手柄响应超时，可以尝试重新执行 connect 指令。
第二步：进行服务授权
当系统询问 Authorize service (yes/no): 时，请果断输入 yes 并回车。
第三步：确立信任关系
最后输入 trust 指令，看到 Changing trust succeeded 后，你的手柄就正式拥有了“免检通行证”。

Authorize service (yes/no): yes
[8BitDo M30 Modkit]# trust E4:17:D8:C2:0B:0E
[CHG] Device E4:17:D8:C2:0B:0E Trusted: yes
Changing E4:17:D8:C2:0B:0E trust succeeded

常用蓝牙管理小技巧

在蓝牙控制台中，你可以使用以下几个“简短有力”的指令来打理你的设备列表：

查看已配对列表：输入 devices。这就像查看你的“好友名单”，确认哪些设备已经配置妥当。
删除单个设备：输入 remove [MAC地址]。如果你想和某个旧手柄“断绝关系”，用这个指令即可。
授权与PIN码：当系统在后台处理进度或要求 PIN 码时，根据提示输入 yes 或对应的数字。

进阶：如何管理多个蓝牙适配器？

如果你的机器（比如树莓派 4）既带内置蓝牙，又插了一个 USB 蓝牙接收器，你就拥有了多个蓝牙适配器（Bluetooth adapters）。

生活化类比：这就像你的电脑有两个“耳朵”。如果你觉得左耳（内置蓝牙）听力不好，想换成右耳（USB 接收器）来听手柄的信号，你就需要先搞清楚谁是谁。

第一步：列出所有适配器
输入 hcitool dev。系统会展示所有的适配器编号（如 hci0, hci1）。
第二步：确认正在使用的设备
当你进入 bluetoothctl 并开启扫描时，系统会提示当前是哪个控制器在工作。

# hcitool dev
Devices:
hci1    90:80:62:00:88:00  # 这是一个外接 USB 蓝牙模块
hci0    DC:A6:32:04:10:7F  # 这是树莓派 4 自带的蓝牙

# bluetoothctl
[bluetooth]# scan on
Discovery started
[CHG] Controller 90:80:62:00:88:00 Discovering: yes # 确认正在使用 hci1 进行扫描

【注意】如果系统自动配对了你不想要的设备怎么办？

有时候 Batocera 表现得过于“热情”，会自动连接一些你并不打算用来玩游戏的蓝牙设备。如果遇到这种情况，请参考下一章节关于禁用特定设备自动配对的方法。

解决蓝牙乱连问题：精准配对指南

有些蓝牙设备（比如现在的“智能”电视）不守规矩，它们会一直处于“配对模式”。因为 Batocera 系统非常热情，会自动尝试连接任何在附近招手的配对信号，这就可能导致你的游戏机莫名其妙地连上了客厅的电视。

生活化类比：这就像是一个过于热心的“相亲达人”，只要在路上看到有人招手，就以为是在等自己，非要上去打个招呼。为了不认错人，我们需要给这位达人戴上一副“过滤眼镜”，让他只看手柄，或者只看耳机。

方案一：开启“手柄专用”配对模式

如果你只想连接游戏手柄，而不希望被邻居的电视干扰，可以强制系统只寻找控制器。

第一步：准备手柄
将你的手柄切换到配对模式（Pairing mode）。
第二步：运行过滤指令
输入以下指令并回车：

Batocera-bluetooth trust-pad

第三步：等待系统筛选
此时系统会开启“精密筛选”，在后台逐一解析并拒绝非手柄类的设备。这个过程可能需要一点时间，请耐心等待。
第四步：自动完成配对
一旦识别到手柄，系统就会自动完成连接。

操作成功后的反馈如下：

[root@RPI3-Batocera /userdata/system]# Batocera-bluetooth trust-pad Pairing 8BitDo M30 gamepad... Trusting 8BitDo M30 gamepad... [root@RPI3-Batocera /userdata/system]#

现在，你的手柄就可以在 Batocera 中正常使用了。

方案二：开启“音频设备专用”配对模式

同理，如果你只想连接蓝牙耳机或音箱，可以使用以下指令，让系统只对音频设备“点头”：

操作方法：
在终端输入以下指令：

Batocera-bluetooth trust-audio

进阶：设备黑名单（Blacklisting）

【提示】：从 Batocera v33 版本开始，如果你遇到了死缠烂打的干扰设备，还可以参考后续的“黑名单（Blacklisting）”教程，将特定设备彻底屏蔽。

蓝牙黑名单与增强型连接工具使用指南

【注意】本章节关于“黑名单”的手动操作仅适用于 Batocera v33 版本。在更高版本中，该功能已被上一章介绍的 trust-pad 模式（精准配对模式）所取代。

如果你的机器附近有一个总是在散发信号、试图强行连接的“流氓设备”（比如隔壁邻居的智能电视），你可以通过黑名单（Blacklist）功能彻底屏蔽它。

生活化类比：这就像是在你的游戏机门口贴了一张“谢绝入内”的名单。即使对方一直敲门（发送配对信号），系统也会根据名单直接视而不见。

1. 管理你的黑名单

如果你确定要屏蔽某个特定的设备，请按照以下步骤操作：

第一步：获取设备信息
你需要知道对方的设备地址（Device address，通常是 MAC 地址）和设备名称（Device name）。
第二步：将设备拉黑
通过 SSH 远程连接（Secure Shell）进入后台，运行以下指令：

Batocera-bluetooth blacklist <设备地址> <设备名称>

第三步：查看已拉黑列表
如果你想核对目前名单上都有谁，输入：

Batocera-bluetooth list_blacklistable

第四步：移出黑名单
如果你误伤了某个设备，想给它“平反”，输入：

Batocera-bluetooth unblacklist <设备地址>

2. 使用 Batocera-bluetooth 增强工具

系统内置了一个专门处理蓝牙事务的小管家——Batocera-bluetooth，它可以帮你更高效地管理连接。

常用指令	功能说明
Batocera-bluetooth list	列出清单：打印出当前所有已信任并保存的蓝牙设备列表。
Batocera-bluetooth trust	随机配对：扫描并信任一个新的设备。这就像“抽盲盒”，系统会随机选一个信号进行信任。
Batocera-bluetooth trust-pad	手柄专连：开启雷达，专门搜寻并连接游戏手柄，自动过滤非游戏设备。

3. 进阶探索

关于随机配对（trust）：
该指令会尝试扫描并信任一个随机选中的设备。
【提示】正如文档所言，这个操作带有一定的随机性，建议仅在常规配对失效时作为尝试手段。
关于手柄专连（trust-pad）：
这是目前最推荐的连接方式。它会 methodically（有条不紊地）在后台解析周边信号，自动通过或拒绝设备。

生活化类比：trust-pad 就像是一个专业的保镖，他在门口会仔细检查每个人的证件。只有拿着“游戏手柄证”的人才能进场，像电视、手机、微波炉这些拿着“其他证件”的都会被挡在门外。

【提示】由于部分高级功能仍在进一步的调查与测试中（Needs further investigation），建议在操作前备份你的重要配置文件。

蓝牙连接工具（Batocera-bluetooth）进阶操作指南

如果你觉得图形界面的蓝牙设置不够灵活，Batocera 提供了一套强大的命令行工具。通过这些指令，你可以像“蓝牙指挥官”一样，精确控制每一个设备的连接与权限。

1. 设备连接与内存管理

这些指令负责处理设备与系统之间的“信任关系”以及内存中的存储状态：

指令名称	功能说明
Batocera-bluetooth trust-audio	音频专连：开启雷达，专门搜寻并信任蓝牙耳机或音箱。
Batocera-bluetooth starttrust	开启信任流程：启动后台的自动信任扫描任务。
Batocera-bluetooth stoptrust	停止信任流程：立刻关闭正在运行的自动信任任务。
Batocera-bluetooth remove <设备地址>	彻底移除：从信任名单中删掉指定设备，并清空其在内存中的连接记录。
Batocera-bluetooth save	保存修改：将当前新建立的信任关系正式写入系统内存（防止重启后失效）。
Batocera-bluetooth restore	恢复配置：撤销那些还没保存的信任操作，从内存中恢复之前的稳定状态。
Batocera-bluetooth live_devices	实时雷达：列出当前周边所有正处于配对模式（Pairing mode）的设备。

生活化类比：save 和 restore 就像是游戏的“存档”与“读档”。当你新连上一个手柄后，记得“存档”（save）；如果你刚才的操作搞乱了连接，可以随时“读档”（restore）回到之前的正常状态。

2. 黑名单管理（仅适用于 v33 版本）

针对特定版本中那些干扰正常连接的“不速之客”，你可以通过黑名单（Blacklist）指令来拦截它们。

第一步：查看拦截名单
使用以下指令列出目前被你关进“小黑屋”的所有设备：
Batocera-bluetooth list_blacklistable
第二步：执行拉黑操作
如果你发现某个设备（如邻居的电视）总是干扰你，输入设备地址和名称来封锁它：
Batocera-bluetooth blacklist <设备地址> <设备名称>
第三步：解除封锁
如果你改变了主意，想把某个设备从黑名单中放出来，输入：
Batocera-bluetooth unblacklist <设备地址>

配置流程建议

当你要添加一个新设备并希望长期使用时，建议按照以下“操作三部曲”进行：

第一步：寻找设备
利用 live_devices 确认你的手柄或耳机已经成功进入配对状态。
第二步：建立信任
根据设备类型使用 trust-pad（手柄）或 trust-audio（耳机）进行精准配对。
第三步：永久存档
一旦连接成功，务必输入 Batocera-bluetooth save。

【注意】：在使用 remove 或 unblacklist 指令时，请确保输入的设备地址（通常是一串如 AA:BB:CC:DD:EE:FF 的 MAC 地址）完全准确，否则指令将无法生效。

【提示】：如果你的系统是比 v33 更高的版本，虽然黑名单指令可能依然存在，但系统通常推荐使用更智能的 trust-pad 过滤机制来替代手动屏蔽。

原文: 蓝牙手柄手动设置 • 翻译: DIY8 Bot

文章版权归作者所有，未经允许请勿转载。