PPSSPP GameShare 实验
本分支尝试在主机 Switch 2 上运行一个独立的 PPSSPP guest,并将其串流到原版 GameShare 客户端。它不是镜像控制器,也不是在主机模拟器中添加第二个 PSP 控制器。编译和主机测试并不能证明主机上可运行,也不能证明双游戏性能可接受。
可用的单实例检查点是 switch2-single-instance-working(commit 1c3b38a)。其确切测试过的 NRO、包以及匹配的调试 ELF 仍位于 dist-switch2/checkpoints/switch2-single-instance-working/ 下。
构建与安装
sh Tools/build-switch2-gameshare.sh
python3 Tools/deploy-switch2.py 192.168.1.182 --experimental-gameshare
为第二条命令打开 FTPD。传输成功即被接受,无需通过下载进行验证。该实验安装为 PPSSPP GameShare,位于 sdmc:/switch/ppsspp-switch2-gameshare/ppsspp-switch2-gameshare.nro。它不会改动可用的 ppsspp-switch2 NRO 及其设置/存档。常规的 Tools/build-switch2.sh 会选择 GameShare OFF。两个构建共用构建缓存,但打包时会拒绝原生/实验模式不匹配的情况。
通过与 Moonlight SDK 示例所用的同一个支持 GameShare 的原生 title override 启动。未知通用 title override 能否授予所需的 GameShare 上下文。如果另一个 title 锁定了配置文件切换,SDK 会在可用时使用该次启动所选的 Nintendo 配置文件。主机日志会区分缺失的启动配置文件与后续的 StreamPlay 或匹配错误。在主机的主菜单或暂停菜单中选择 GameShare(实验性),然后从客户端的系统 GameShare 界面加入。客户端应看到自己的 PPSSPP 菜单,并显示一条仅 guest 可见的启动消息,然后浏览 sdmc:/switch/ppsspp-switch2/games。两个浏览器都可以访问 SD 卡游戏;不会将任何游戏文件复制到包中。
选择相同的 GameShare 操作以停止共享。guest 在会话之间暂停,保留其独立的模拟器状态。退出 guest 的 PPSSPP 会结束该 guest 实例;在创建另一个实例之前重新启动应用程序。完成后正常退出主机。如果真正的清理失败并报告资源被保留,请从 HOME 关闭整个托管 title,而不是返回 hbmenu。SDK 明确要求这样做,以应对不确定的原生所有权。
隔离与渲染
该构建将第二个 PPSSPP 前端/核心链接到一个可重定位对象中,并重命名所有已定义的核心拥有的全局符号和 ELF COMDAT 组签名。仅导出八个纯数据 C 入口点。审计要求具有不同的 Config、memory-base 和 core-state 符号;主机还会在启动前比较它们的运行时地址。SDK/OS/C++ 运行时入口点保持共享。两个模拟器拥有独立的核心、UI、文件系统状态、JIT 注册表、Vulkan 上下文以及设置/记忆棒目录。它们共享同一个 OS 进程,因此任一副本中的致命错误仍可能影响整个应用。
主机保持其 1920x1080 输出和 120 Hz 请求。guest 使用 PPSSPP 现有的离屏 Vulkan 路径,分辨率为 1280x720,呈现目标为 60 fps。回读回调将已完成的 RGBA 帧传输到最新帧邮箱;专用呈现器将它们上传到单独的 native VI2 guest 层。这第一条路径增加了 CPU 回读/重排成本;不声称零拷贝。
文章标题:在一台 Switch 2 上运行两个 PSP 模拟器,并通过 GameShare 共享其中一个
正文: GameShare SDK 取自 Moonlight-Switch 的研究工作树。Switch/GameShare/sdk-provenance.json 记录了源修订版本和文件哈希。其 MIT 许可证和逐文件 ISC 声明予以保留。SDK 中固定的 CPU 控制台上传器已禁用。客户机渲染器借用静态链接的 OunceVK 驱动程序的 GSV 主会话和工作会话,并使用其已注册的 VM。它拥有客户机镜像后备、注册和客户端。适配器在 libounce 调用边界跟踪驱动程序占用的槽位,并为客户机范围退役预留一个空闲槽位。每个 GameShare 会话复用预留槽位的完成事件,该事件随 Vulkan 驱动程序的 GPU 一起关闭。它不访问 OunceVK 的内部结构体。在 Vulkan 拆除之前退役客户机镜像。硬件上的共存和复用仍需验证。
SDK 拥有匹配、原生托管、控制器读取以及独立的 VI2 显示/层。渲染器退役在原生 Finalize 之前运行;层关闭在其后运行。不确定的呈现或释放/退役失败会保留后备并阻止普通卸载。客户机控件永远不会进入主机模拟器。过期/断开的快照变为中立状态。
存储、音频和当前限制
主机设置/存档使用 ppsspp-switch2-gameshare/config/ppsspp;客户机设置/存档使用 ppsspp-switch2-gameshare/guest/config/ppsspp。现有可用应用的内存棒不会被复用。客户机原生文本输入小程序被禁用,因为其到远程屏幕的路由尚未实现。
PPSSPP 将客户机模拟器的 PCM 发送到原生每客户机队列,并让主机模拟器保持正常的 AudOut。参见恢复的音频约定。控制台测试确认了直接音频构建中客户端播放可听。
本地 PSP 多人游戏
启动 GameShare 并从客户端加入。在两个屏幕上打开同一游戏,然后进入其本地无线或 Ad Hoc 模式。在任一台主机上创建大厅,然后在另一台上查找。如果主机在配对前已初始化多人游戏,请重启该游戏一次以选择本地路由。
GameShare 托管期间,PPSSPP 在 IPv4 回环端口 27314 和 27315 上运行其内置发现服务和 aemu_postoffice 数据包中继。两个核心使用其现有的、独立配置的 PSP MAC 地址自动使用私有路由。客户机仍运行在主机 Switch 2 上,因此游戏数据包留在该主机上。该路由不使用公共中继、Wi-Fi IP 地址或 UPnP 映射,也不会更改任一核心保存的网络设置。停止 GameShare 会关闭监听器。已在游戏大厅中的游戏可能需要在 GameShare 重启后离开并重新进入多人游戏。
用户报告在第一个回环构建中 Tekken 会话成功。后续构建保留每个核心的原始 MAC 地址,并通过了十项配对桌面测试。该保留存档的版本标记为 switch2-gameshare-multiplayer-baseline(提交 0699365)。其 NRO、ZIP 和调试 ELF 位于 dist-switch2-gameshare/checkpoints/multiplayer-baseline/。较早的控制台运行使用了临时 MAC 构建。
诊断和验证
主机 boot.log、ppsspp.log、native-exit.bin 和 native-fault.bin 位于实验应用目录中。客户机写入 guest/ppsspp.log。具有有效头的原生故障/退出记录在下次启动时保留为 .previous。故障后重新启动前请保留诊断信息。
python3 Switch/tests/run.py
python3 Switch/tests/run_gameshare.py
python3 Switch/GameShare/sdk/tests/native/run.py
python3 Switch/GameShare/sdk/tests/guest_input/run.py
python3 Switch/GameShare/sdk/tests/guest_display/run.py
git diff --check
文章标题:在一台 Switch 2 上运行两个 PSP 模拟器,并通过 GameShare 共享其中一个
正文: 实际源码 sanitizer 测试覆盖原生 guest 映像扇区位置、部分创建、成功退役、保留的不确定呈现以及释放/范围超时。SDK 测试覆盖原生生命周期/取消、控制器解析/新鲜度和显示所有权。它们不模拟 GPU、原生标题权限、GameShare 无线电行为或主机性能。CPU、GPU、线程和关停回归风险需要真机测试;序列化的 PSP 状态布局未改变。
初始主机验证(2026-11-19)
双核 AArch64 NRO 和 ZIP 已构建并验证。符号审计发现 27,173 个被重命名的核心自有符号和八个 guest ABI 导出。全部 28 个 SDK 原生生命周期场景、输入解析/新鲜度套件和显示生命周期套件在 ASan/UBSan 下通过。六个实际源码映像所有者场景通过(干净、部分创建、不确定呈现、释放超时、范围退役超时和注销失败)。现有 JIT 发布和专用 worker 测试也通过。
主机回归套件:102 个 C++ 单元测试通过;527 个已执行的单实例 PSP 用例和十个配对中继场景通过。十一个配对 P2P 用例因现有缺失的 127.0.0.2 主机环回别名仍未运行,导致聚合运行器处于失败状态。没有已执行的回归测试失败。真机双实例渲染、配对、guest 控制/音频和持续性能仍需要物理验证。
首次真机启动调查(2026-11-19)
最初的实验构建在 PPSSPP 菜单之前产生系统错误。其启动日志到达显示配置;原生故障/退出记录保持为空。单独可用的单实例安装未改变。在真机上尚未到达配对和第二个模拟器。
SDK bridge 作为 C++20 与 C++17 前端分开编译。Vulkan 初始化前后的启动检查点通过原生刷新直接写入 startup-stage.bin。它的四个小端 64 位字分别是 magic 0x3254475350505350、阶段编号、记录器地址和系统 tick。阶段 1–4 覆盖诊断、显示配置、图形对象构造和错误字符串构造;阶段 10 和 11 括住 InitAPI 的初始字符串赋值。阶段 20 和 21 括住 NativeInit,22 在窗口设置之前。诊断启动标记为 comdat-isolation。原生退出记录器还包装 svcBreak(kind 6,原因在高 32 位,低 32 位为可读的四字节细节)。
最终 ELF 显示链接器将必需的 host 字符串构造函数调用变成了空操作。GCC 为构造函数组使用了本地 C5 签名。仅重命名全局符号让 guest 组保留了该签名,导致链接器丢弃了 host 副本。现在构建除全局符号审计外,还会重命名并检查全部 7,351 个 guest COMDAT 组。修正后 ELF 的反汇编确认 host 启动调用自己的字符串构造函数,且 guest 构造函数具有不同地址。
真机打开了修正后的构建并启动了 host 游戏。第一次 GameShare 尝试时,VI2 到达渲染器钩子,第二次 GSV GPU 打开在此失败,错误码为 0x200F3。guest 模拟器独立到达离屏 Vulkan 初始化。修订后的上传器使用现有驱动会话。host 还在终止状态后加入 SDK 线程,然后再询问原生资源是否保留,因此仅线程完成不再强制标题重启。需要在硬件上确认配对、guest 帧和停止/重启。
在一台 Switch 2 上运行两个 PSP 模拟器,并通过 GameShare 共享其中一个
共享会话构建与客户端配对成功,SDK 完成了清理。客户端仍保持黑屏,因为 PPSSPP 拒绝了来自客户机离屏 Vulkan 呈现的读回,在任何帧能够到达上传器之前。离屏呈现现在声明了其传输源能力。复制操作会等待颜色附件写入完成,并跳过没有获取到图像的帧。一次本地 MoltenVK 运行将连续三帧离屏画面清除为不同颜色,并验证了每一个返回的 RGBA 字节。客户端呈现和独立输入仍需要主机验证。
主机确认,主机端和客户端都能看到并控制各自的 PPSSPP 画面。两路模拟器音频流都能从主机端听到。主机确认的 NRO、匹配的 ELF 和安装记录保存在 dist-switch2-gameshare/checkpoints/dual-screen-controls/ 下。
在 AudOut 和 Audren 两种情况下,客户端在独立显示会话中都没有声音。Audren 测试启动日志确认应用混音使用了 Audren,客户机收到了帧,SDK 清理也已完成。启动器 NRO 已使用保存的 SD 卡副本恢复为主机确认的双屏构建。渲染器试验记录在提交 c5a8716 中。
在双屏检查点,两款游戏都通过主机端运行。SDK 暴露了一个应用级镜像标志和设备音量配置。
直接客户机音频调查
已发布的 SDK 导出了独立的 PCM 写入器和按客户机区分的队列计数器。可复用的 Moonlight SDK 及其 PPSSPP 副本现在暴露了一个 PCM 回调。对原生工作线程的测试覆盖了恢复出的命令布局、部分写入后未写入的尾部,以及一个失败后仍保持视频和输入运行的音频命令。
2026 年 11 月 19 日,主机测试确认 GameShare 客户端有声音。可工作的构建标记为 switch2-gameshare-guest-audio-working(提交 50cd977)。实际安装的 NRO、SD 卡包、匹配的 ELF、SDK 归档和构建记录保存在 dist-switch2-gameshare/checkpoints/guest-audio-working/ 下。如需在主机上回滚,请将该 NRO 重新安装为 /switch/ppsspp-switch2-gameshare/ppsspp-switch2-gameshare.nro。