Skip to content

Latest commit

 

History

History
49 lines (38 loc) · 2.94 KB

README.md

File metadata and controls

49 lines (38 loc) · 2.94 KB

gamepad-agent

一个纯 Go 实现的游戏手柄网络转发工具(实际上用的库并不纯)。

目前仅支持将 PC 端任意手柄转发给 Nintendo Switch,Switch 端依赖于 mumumusucpi-joystick 项目。

硬件方面

你需要准备:

  • 1 台放在底座上或是外接了 USB HUB 的 Nintendo Switch
  • 1 个树莓派 Zero W,用于转发手柄操作给 Switch
  • 1 台连接好手柄的 PC,用于接收手柄操作并转发给树莓派
  • 2 根 USB-A 转 Micro-USB 的线,一根用于给树莓派供电,一根用于将树莓派连接到 Switch 上
  • 1 张 Micro SD 卡,用于给树莓派作为系统盘
  • 1 个 5V 1A 或 5V 2A 的电源适配器,用于给树莓派供电(通常手机充电器就符合要求)

注意:树莓派 Zero 的普通版不带 WIFI 和蓝牙,只有 W 版和 WH 版才带。WH 和 W 的区别在于多了个 GPIO 排针,本项目中不需要用到 GPIO。

注意:PC 连接手柄时可以使用蓝牙连接也可以使用 USB 连接,但更推荐你使用 USB 连接。毕竟非内网环境使用的话,转发本身存在一定延迟,会导致体验下降。

注意:转发设备并不是一定要用树莓派 Zero W,其他支持 OTG 功能的开发板理论上也是可以的,只是有可能会需要自行编译一下 pi-joystick 和 gamepad-agent。

使用方法

客户端(PC):

  1. 下载或自行编译 客户端设备对应系统和架构版本的 gamepad-agent
  2. 解压下载到的压缩包,进入解压出来的 gamepad-agent 目录下
  3. 按照 example_config 中的样例配好配置文件,将配置文件中的 type 值设为 client
  4. 在连接好手柄的状态下运行 gamepad-agent 启动客户端

服务端(树莓派):

  1. 下载或自行编译 服务端设备对应系统和架构版本的 gamepad-agent
  2. 在树莓派上解压好下载到的压缩包,进入解压出来的 gamepad-agent 目录下
  3. 执行 sudo insmod js-audio.ko,装载 pi-joystick
  4. 把你的配置文件放进这个目录下,将配置文件中的 type 值设为 server
  5. 执行 chmod +x gamepad-agent 给服务端文件添加执行权限
  6. 执行 ./gamepad-agent 启动服务端

双端启动好了之后,不出意外的话,你在 PC 上连接的手柄进行操作时,Switch 上就会收到对应的映射后的操作了。

样例配置

目前已经有了 ds4 手柄和 xbox360 手柄的映射配置,可以直接使用。在使用 moonlight 进行云游戏时,无论 moonlight 客户端设备使用的时什么手柄,都 可以直接使用 xbox360 手柄的映射配置。

原理

读取本机手柄状态 -> 转换为 Switch 的通信协议 -> 通过 UDP 发送到树莓派 Zero W -> 树莓派模拟成 USB HID 设备并将收到的 data 发给 Switch -> Switch 将树莓派当成 Pro 手柄,正常进行操作

TODO

  • 服务端支持Switch蓝牙连接
  • 完全的 USB 转发或蓝牙转发