webMAN-MOD 的 Reload XMB 详解:XMB 缓存刷新机制、安装配置与源码级实现原理

原创2026-10-14 18:25:081,335 阅读
文章标签:嵌入式后端网络

webMAN-MOD 的 Reload XMB 详解:XMB 缓存刷新机制、安装配置与源码级实现原理

Reload XMB 是 webMAN-MOD 生态中一个"极简但关键"的 PS3 辅助应用:它的全部职责就是加载后立刻返回 XMB,从而迫使 VSH 从内存中卸载并重新加载,让 XMB 上缓存的 XML 菜单与图片按需重建。本文以仓库中 Projects/reloadxmb/README.md 为主体,结合 source/main.c、Makefile 以及 webMAN-MOD 主程序的命令处理与配置源码,系统讲解 Reload XMB 的安装、触发方式、工作原理、源码实现与备选方案。

一、Reload XMB 是什么

Reload XMB(全称 Reload XMB Application)是一个用于刷新 XMB(XrossMediaBar,PS3 的十字媒体栏)上缓存 XML 内容的简单应用。当 webMAN-MOD 扫描了新的游戏、更新了游戏列表或修改了自定义 XMB 条目后,XMB 上仍显示的是旧缓存数据,此时就需要触发一次 XMB 重载,让系统重新读取并渲染菜单。

它的核心思路非常直接:作为一个标准游戏应用被加载,然后在加载完成后立刻返回 XMB。在应用退出回到 XMB 的过程中,VSH(Virtual Shell,XMB 的主进程)会从内存中被卸载并重新加载,之前缓存在内存中的所有 XML 菜单和图片随之被清空,并在之后按需重新生成——这样就完成了一次"干净"的 XMB 刷新。

该应用由 aldostools 负责编码与实现,DeViL303 提供概念与 XMBML 研究,源码中标注的作者还包括 kozarovv 与 berion(见 source/main.c)。

二、安装方式

Reload XMB 有两种安装途径:

  1. 随 webMAN-MOD 自动安装:这是最常用的方式。webMAN MOD 的安装器或更新器(installer / updater)会自动将 RELOADXMB 应用安装到 PS3 内置硬盘,无需用户手动操作。安装位置固定为 /dev_hdd0/game/RELOADXMB,该路径在 webMAN-MOD 主程序源码中被定义为 RELOADXMB_DIR(见 include/init/paths.h)。

  2. 作为独立应用手动安装:如果你不打算使用 webMAN-MOD,也可以把编译好的 PKG(EP0001-RELOADXMB_00-0000000000000000.pkg)当作一个独立应用安装,并在 /setup.ps3 中将 Home 设置指向 /dev_hdd0/game/RELOADXMB,然后确认并保存设置。

提示:独立使用场景下,"Home 指向游戏目录"本质上是让 PS3 在 XMB 上启用 ★ PlayStation(app_home/PS3_GAME)入口,这正是 Reload XMB 能被当作"游戏"加载的前置条件(详见下文"前置要求")。

三、触发方式

Reload XMB 在 webMAN-MOD 中有两条主要触发路径:

1. 从 webMAN Setup 菜单触发

当用户在 XMB 的 webMAN Setup 菜单中选择 Reload XML & XMB 选项时,会调用 RELOADXMB 应用完成刷新。这是最符合用户直觉的触发方式——刷新 XML 与重载 XMB 被设计为一步完成。

2. 通过网页命令 /reloadxmb.ps3 触发

webMAN-MOD 内嵌的网页服务器提供命令接口 /reloadxmb.ps3。该命令会挂载(mount)RELOADXMB 应用,并从 app_home/PS3_GAME(即 ★ PlayStation 入口)执行它。

命令处理逻辑位于 include/cmd/reloadxmb.h:当请求路径匹配 /reloadxmb.ps3 且当前没有正在进行的 XML 刷新(refreshing_xml == 0)时,调用 reload_xmb(param<a href="https://link.gitcode.com/i/790fe7df03d5f06b8c695576a71d5634" target="_blank">14]) 执行重载,随后把响应重定向回 /index.ps3(webMAN 的首页)。该命令处理文件由 [include/www/www_client.h 在客户端请求流程中引入,同时被 include/www/www_admin.h 列入管理命令集合。

另外,在执行完 XML 刷新(如 prepISO 扫描后)时,若检测到 RELOADXMB 应用已安装且 app_home 已在 XMB 上启用,页面会额外输出一个指向 /reloadxmb.ps3 的"Refresh XMB"链接,方便用户一键继续重载 XMB(见 include/cmd/refresh.h)。

四、前置要求

要让 Reload XMB 正常工作,PS3 必须满足一个关键条件:

★ app_home/PS3_GAME(aka ★ PlayStation)必须已在 category_game.xml 中启用,即 XMB 的 Game 栏(Game column)中要能看到 ★ PlayStation 入口。

原因在于:RELOADXMB 是作为一个"游戏应用"被加载执行的。webMAN-MOD 挂载该应用后,需要通过 app_home/PS3_GAME 这个虚拟光盘入口把应用"启动"起来。如果该入口未在 XMB 菜单中启用,应用将无法以游戏方式被拉起。

在 webMAN-MOD 主程序中,这个前置条件被显式检查:is_app_home_onxmb() 用于确认 app_home 是否在 XMB 上可见,只有通过检查才会走 RELOADXMB 应用路径(见 include/init/vsh.h)。

五、工作原理

5.1 应用本体:加载即返回

Reload XMB 的应用本体极简到令人印象深刻。完整源码如下(source/main.c):

// Reload XMB - Simply returns to XMB to reload it
// 2019 by DeViL303, kozarovv, berion

int main()
{
	return 0;
}

main() 函数不做任何业务操作,直接返回 0。当这个"游戏"被加载后立即退出返回 XMB,而正是在这一进一出之间,PS3 的系统行为完成了对 XMB 的刷新。

5.2 刷新过程:VSH 卸载与重载

RELOADXMB 之所以能达到刷新效果,依赖的是 PS3 的系统机制:

  1. 应用从 app_home/PS3_GAME 被加载启动;
  2. 应用立即退出,流程回到 XMB;
  3. 在此过程中,VSH 从内存中被卸载,然后在应用退出时被重新加载;
  4. 之前缓存的所有 XML 菜单和图片全部从内存中释放;
  5. XMB 返回后按需重新读取、重新渲染这些菜单与图片——刷新完成。

也就是说,Reload XMB 本身并没有"清理缓存"的代码,它只是借用了 VSH 进程生命周期中"应用加载→退出→VSH 重建"这一天然机制,让 XMB 在重建过程中丢弃旧缓存。

5.3 主程序侧的启动实现

webMAN-MOD 主程序中 reload_xmb() 函数负责真正把 RELOADXMB 应用启动起来,其实现逻辑(见 include/init/vsh.h)可概括为:

COBRA 模式(#ifdef COBRA_ONLY 分支):

  • 仅当当前位于 XMB 且用户已登录(IS_ON_XMB && USER_LOGGEDIN)时才执行;
  • 优先走应用路径:若 /dev_hdd0/game/RELOADXMB 目录存在(is_app_dir(_HDD0_GAME_DIR, "RELOADXMB"))且 app_home 在 XMB 可见,则通过 set_app_home(RELOADXMB_DIR) 把 app_home 指向该目录后启动;
  • 兜底路径:若存在 RELOAD_XMB.ISO(路径定义为 WM_RES_PATH "/RELOAD_XMB.ISO",见 include/init/paths.h),则通过 mount_game(RELOADXMB_ISO, 0) 以静默方式挂载镜像;
  • 挂载成功后调用 patch_gameboot(0)(不应用任何 gameboot 补丁)并 launch_disc(true) 启动。

非 COBRA 模式(#else 分支):

  • 先检查 L2 键:按住 L2 可取消本次 XMB 重载(if(is_pressed(CELL_PAD_CTRL_L2)) return;);
  • 若检测到 /dev_hdd0/game/RELOADXMB 存在,则通过 XMB 命令序列 close_all_list + focus_category network + focus_segment_index -1 切换到网络栏,并调用 explore_exec_push(0, false) 从 app_home 启动。

5.4 三种重载方法:rx 配置项

主程序并不总是使用 RELOADXMB 应用,它提供了三种可配置的 XMB 重载方法,由配置项 reloadxmb 控制(见 include/init/wm_config.h):

值 含义 说明
0 logout 方法 使用用户注销/重新登录的方式重载 XMB(默认值)
1 logout + 聚焦 webMAN Games 注销重登后把焦点移到 webMAN Games 分类
2 RELOADXMB 应用 使用 RELOADXMB 应用完成重载(推荐的新默认方法)

在 include/setup.h 中,webMAN Setup 页面将其渲染为名为 rx 的下拉选择框(Reload XMB: Default / Logout + Focus wMM / RELOADXMB),用户可直接在 XMB 上切换;参数解析处(include/setup.h)使用 get_valuen(param, "rx=", 0, 2) 读取 URL 参数 rx=,取值范围 0~2,默认 0。

logout 方法的实际执行逻辑(reload_by_logout(),见 include/init/vsh.h)通过 exec_xmb_command 系列命令模拟用户操作:关闭列表 → 聚焦用户分类 → 按下确认键注销 → 再次确认 → 执行 exec_push 重新登录;若选择"聚焦 webMAN Games",则额外等待后把焦点切到 game 分类的 xmb_app3 分段。

而 RELOADXMB 应用路径的启用条件是:配置值为 2,或"未显式指定应用且系统只有一个用户目录"((webman_config->reloadxmb == 2) || (!use_app && has_one_user_dir())),此时强制改用 RELOADXMB 应用(见 include/init/vsh.h 与 include/init/vsh.h)。

六、构建方式

仓库提供了完整的 PSL1GHT 工具链构建工程,开发者可以自行编译:

  • Makefile:定义目标 TARGET = reloadxmb、APPID = RELOADXMB、CONTENTID = EP0001-RELOADXMB_00-0000000000000000,链接 -lio(PS3 I/O 库),并通过 SCETOOL_FLAGS 配置 SELF 签名标志(--self-ctrl-flags 与 --self-cap-flags)。构建前需先设置环境变量 PSL1GHT,并确保 PSL1GHT 的 ppu_rules 可用(Makefile)。
  • Make_PKG.bat:Windows 批处理脚本,设置 PS3SDK=/c/PSDK3v2、PSL1GHT、PS3DEV 等环境后执行 make pkg,产出 EP0001-RELOADXMB_00-0000000000000000.pkg,并清理中间的 .elf / .self / build 目录。
  • Make_Clean.bat:执行 make clean 清理构建产物。
  • pkgfiles/:PKG 打包所需的 PARAM.SFO 与 ICON0.PNG 资源。

构建产物形态:make 生成 reloadxmb.elf → reloadxmb.self(SELF 可执行文件,可经 ps3load 直接加载运行,对应 Makefile 中的 run 目标)→ make pkg 最终打包为可安装的 PKG。

七、备选方案:不装应用也能刷新 XMB

如果不想使用 RELOADXMB 应用,README 还给出了四种等效的 XMB 刷新替代方案:

  1. 执行 prepISO:扫描 USB 设备上的内容,刷新 XML 并重载 XMB。这是 webMAN-MOD 附带的完整"扫描 + 刷新 + 重载"一体化方案;
  2. 加载任意其他自制软件、游戏或应用后再返回 XMB:利用同样的"应用进出 → VSH 重建"机制;
  3. 启动 PSP Remote Play 后按 O 键退出回到 XMB:Remote Play 会话的进入/退出同样会触发 XMB 重建;
  4. 直接重启 PS3 系统:最彻底、最慢的兜底方式。

这些方案在原理上完全一致——本质都是"让 VSH 经历一次完整的卸载与重载生命周期"。

八、总结

Reload XMB 是"以最小代码实现最大系统行为"的典型范例:一个 return 0 的应用,借助 PS3 的 VSH 生命周期机制,完成了 XMB 缓存菜单与图片的彻底刷新。在 webMAN-MOD 的完整工作流中,它与 prepISO 扫描、/reloadxmb.ps3 网页命令、webMAN Setup 菜单的 rx 配置(logout / logout+focus / RELOADXMB 三种方法)共同构成了"内容更新 → XML 重建 → XMB 重载"的闭环,是 PS3 上修改 XMB 外观与游戏列表后让改动即时生效的关键一环。

登录后查看全文
webMAN-MOD