Batocera Wi-Fi无线网络连接设置教程-一起DIY吧

本文详细介绍 Batocera 如何连接 Wi-Fi 网络。虽然以太网连接更稳定，但 Wi-Fi 对于不方便布线的场景非常实用。

为什么要连接 Wi-Fi？

连接网络后可以解锁更多功能：

系统更新与下载
网络共享传输游戏
Web 管理界面
AI 游戏翻译
游戏封面刮削
联网对战 (Netplay)

开启 Wi-Fi

进入 主菜单 (MAIN MENU)
选择 网络设置 (NETWORK SETTINGS)
启用 ENABLE WIFI
等待片刻让 Wi-Fi 模块启动并扫描网络
部分设备可能需要重启才能生效

连接 Wi-Fi 网络

Wi-Fi 开启后，会显示可用的网络列表：

从列表中选择你的 Wi-Fi 网络 (SSID)
输入密码
确认连接

连接成功后，屏幕右上角会显示 Wi-Fi 图标。

手动输入 SSID

如果你的网络不显示，可以手动输入：

点击 INPUT MANUALLY
注意 SSID 区分大小写
密码中的特殊字符需要用反斜杠转义，例如：
密码 `special?characters@*` 应输入为 `special\?characters\@\*`

命令行操作 Wi-Fi

通过 SSH 或本地终端可以执行以下命令：

batocera-wifi start              # 开启所有 Wi-Fi 模块
batocera-wifi scanlist           # 列出所有可用的 Wi-Fi
batocera-wifi list               # 列出已保存的 Wi-Fi 配置
batocera-wifi enable <SSID> <密码>  # 连接到指定 Wi-Fi 并保存
batocera-wifi disable            # 关闭所有 Wi-Fi 模块

故障排查

Wi-Fi 无法连接

启用 Wi-Fi 后需要等待片刻，甚至可能需要重启系统
可能需要特定的驱动程序，参考下文「手动添加驱动」

找不到自己的 SSID

设备可能不支持路由器使用的信道
Raspberry Pi 等设备不支持 2.4GHz 的第 13 信道
可以在 batocera.conf 中修改国家代码：
`wifi.country=CN`（中国）

Wi-Fi 速度慢/卡顿

对于联网对战等延迟敏感的操作，强烈建议使用有线网络。如果必须使用 Wi-Fi：

关闭附近其他 Wi-Fi 设备
远离微波炉、发动机等干扰源
避免使用 USB 3.0 设备（会造成 2.4GHz 干扰）
确保设备和路由器之间无障碍
尝试使用 5GHz Wi-Fi 代替 2.4GHz

手动添加驱动程序（进阶）

如果 Wi-Fi 设备提示缺少固件文件：

通过 SSH 连接或本地终端检查 `dmesg` 输出
将固件文件放入 `/lib/firmware/rtlwifi/`
运行 `batocera-save-overlay` 保存
成功后可以向开发者反馈，以便在下一版本中添加

Raspberry Pi 4 禁用自带 Wi-Fi

如果在树莓派 4 上使用 USB Wi-Fi 网卡，可以禁用自带 Wi-Fi 以节省资源：

在 `/boot/config.txt` 中添加：

dtoverlay=disable-wifi