Status Monitor Overlay帧率监控内幕SaltyNX共享内存与MAGIC签名扫描技术全揭秘【免费下载链接】Status-Monitor-OverlayMonitor many stats of Nintendo Switch hardware项目地址: https://gitcode.com/gh_mirrors/st/Status-Monitor-Overlay你是否想知道 Switch 上的帧率监控覆盖层 Status Monitor Overlay 是如何做到零侵入读取游戏 FPS 的这个项目专为任天堂 Switch 打造的实时硬件监控覆盖层Tesla 自制软件能显示帧率、CPU/GPU 频率、内存占用与电池状态。它的帧率功能并不修改任何游戏代码而是依赖 SaltyNX 系统模块提供的共享内存块再用一个 4 字节 MAGIC 签名在内存中寻宝定位数据。本文带你完整看懂这套帧率监控内幕与签名扫描技术。 一句话原理游戏写入监控只读传统做法是往游戏里注入插件来统计帧数但 Status Monitor Overlay 选择了一条更轻量的路SaltyNX一个运行在游戏与系统渲染层之间的 sysmodule负责拦截渲染 API 调用把每帧统计写入一块共享内存Status Monitor Overlay只做一件事把这块内存映射进自己的地址空间然后读取里面的数据。两者之间没有任何线程通信开销——游戏进程写监控进程读共享内存是唯一的信箱。这也是官方 FAQ 中声称对游戏性能影响可忽略不计的原因监控几乎全部运行在 Core #3 上刷新率设为 1 FPS 时其他核心占用低于 0.005%。 第一步连接 SaltySD 命名端口拿内存句柄一切从连接系统命名端口SaltySD开始。相关实现集中在 SaltyNX.h其连接函数SaltySD_Connect()会最多重试 200 次每次间隔 1ms直到拿到会话句柄为止。拿到句柄后监控程序发出两条关键指令均为 IPC 命令命令cmd_id作用SaltySD_GetSharedMemoryHandle7取回共享内存块的句柄SaltySD_GetDisplayRefreshRate10读取当前显示刷新率用于 Full 模式的 PFPS 对比整个过程封装在 Utils.hpp 的LoadSharedMemoryAndRefreshRate()中先取句柄和刷新率再用shmemLoadRemoteshmemMap把远端内存页4KB0x1000映射到本地。映射成功后SharedMemoryUsed标志被置位——这就是后续所有帧率功能的总开关。 值得注意的细节每条 IPC 命令的报文头部都携带魔数校验请求方向用SFCI_MAGIC0x49434653字节序即 SFIC响应方向用SFCO_MAGICSFCO定义见 ipc.h。这相当于给每次通话加了防伪戳防止把无关数据误当响应解析。 第二步MAGIC 签名扫描——在一块内存里猜出数据位置问题在于SaltyNX 把帧率数据放在 4KB 共享内存的哪个偏移处不同版本的 SaltyNX 布局可能不同监控程序不会硬编码地址而是用一个精妙的签名扫描数据块NxFpsSharedBlock的第一个字段是MAGIC合法值必须是0x465053按字节看正是 SPF 三个字母。扫描逻辑非常朴素——从内存起点开始每 4 字节检查一次if (NxFps - MAGIC 0x465053) { return; // 找到了 } else search_offset 4;这段扫描代码位于 Utils.hpp 的searchSharedMemoryBlock()最多遍历 0x1000 字节。找到的NxFpsSharedBlock结构共174 字节源码用static_assert锁死大小防止编译期错位里面装着字段含义FPS/FPSavg当前帧率 / 平均帧率帧时间平均法FPSlocked/FPSmode游戏是否锁帧、锁帧模式FPSticks[10]最近 10 帧的帧时间记录renderCalls[8]/viewportCalls[8]传给 GPU 的渲染分辨率与视口调用统计frameNumber全局帧序号判断游戏是否还在出帧readSpeedPerSecond游戏每秒读取速度MiB/sdisplaySync掌机/底座模式同步状态这套设计的妙处在于向后兼容即使 SaltyNX 升级导致数据块整体偏移只要 SPF 签名还在扫描就能重新定位——签名即契约偏移无关紧要。 第三步如何判断游戏正在运行光找到结构体还不够监控还需要确认游戏确实活着。这里用了两个小把戏pluginActive乒乓信号监控程序先把pluginActive置false睡 100 毫秒后再检查——如果它被游戏侧改回了true说明 SaltyNX 插件正在活动游戏在运行逻辑见CheckIfGameRunning()。frameNumber帧序号帧序号持续推进 画面在刷新若游戏卡顿或暂停帧序号不动FPS 图模式就保持旧图不更新。另外FPS 1234、FPSavg 254这类不可能的数值被当作哨兵值界面上显示n/dno data表示未安装 SaltyNX 或游戏未启动。 四种显示模式数据如何变成画面拿到共享内存数据后展示层由 source/modes/ 下的几个组件完成FPS CounterFPS_Counter.hpp只显示一个数字的平均帧率以 31Hz 刷新并对垂直同步信号支持触摸或体感摇动手柄拖动位置FPS GraphFPS_Graph.hpp平均帧率曲线图背景叠加实时值。若平均帧率落在 ±0.05 的舍入误差内例如 30 FPS 目标落在 29.95~30.04 区间曲线段会变为绿色落在半刷新率区间则为其他配色Full / Mini把 FPS 作为可选条目混入完整硬件面板。Full 模式还会额外显示PFPS每秒推送到屏幕的帧数与计算 FPS 互为印证以及两个最可能的内部渲染分辨率Game Resolutions直接读取renderCalls/viewportCalls统计展示 Depth 纹理与 Viewport 两条通道捕获到的分辨率候选列表。各模式的字段格式与解释详见 docs/modes.md。⚙️ 使用前提与常见问题要让帧率功能生效需满足已安装Tesla 环境1.2.3与SaltyNX建议 1.8.1旧版会导致多个 sysmodule 同时访问 SD 卡时卡死使用作者的 SaltyNX fork 才能看到 PFPS、分辨率与读取速度配置文件模板见 config/status-monitor/config.ini.template刷新率、字体大小、颜色均可在 docs/config.md 中查到的选项里自定义。常见坑开 Full/Mini 模式时 Core #3 飙到 100% 直至崩溃通常是nifm ctest补丁、行为异常的自制 sysmodule或签名补丁 副机 联网的组合所致——详见 README 的 Troubleshooting 章节。 总结这套架构值得借鉴Status Monitor Overlay 的帧率监控内幕本质上是一个教科书级的旁路观测设计共享内存 句柄传递跨进程数据交换零轮询成本写方与读方完全解耦MAGIC 签名扫描用 SPF0x465053这种自描述魔数替代硬编码地址天然抗版本漂移哨兵值 乒乓信号用不可能的数值和一次翻转握手优雅处理无数据状态IPC 双魔数SFCI/SFCO请求与响应各自带防伪签名通信健壮可靠。这些技巧不仅适用于 Switch 自制开发对任何需要无侵入监控第三方进程的场景都是可复用的思路。核心源码入口连接与内存获取见 SaltyNX.h数据结构与扫描见 Utils.hpp展示逻辑见 source/modes/。【免费下载链接】Status-Monitor-OverlayMonitor many stats of Nintendo Switch hardware项目地址: https://gitcode.com/gh_mirrors/st/Status-Monitor-Overlay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Status Monitor Overlay帧率监控内幕：SaltyNX共享内存与MAGIC签名扫描技术全揭秘
Status Monitor Overlay帧率监控内幕SaltyNX共享内存与MAGIC签名扫描技术全揭秘【免费下载链接】Status-Monitor-OverlayMonitor many stats of Nintendo Switch hardware项目地址: https://gitcode.com/gh_mirrors/st/Status-Monitor-Overlay你是否想知道 Switch 上的帧率监控覆盖层 Status Monitor Overlay 是如何做到零侵入读取游戏 FPS 的这个项目专为任天堂 Switch 打造的实时硬件监控覆盖层Tesla 自制软件能显示帧率、CPU/GPU 频率、内存占用与电池状态。它的帧率功能并不修改任何游戏代码而是依赖 SaltyNX 系统模块提供的共享内存块再用一个 4 字节 MAGIC 签名在内存中寻宝定位数据。本文带你完整看懂这套帧率监控内幕与签名扫描技术。 一句话原理游戏写入监控只读传统做法是往游戏里注入插件来统计帧数但 Status Monitor Overlay 选择了一条更轻量的路SaltyNX一个运行在游戏与系统渲染层之间的 sysmodule负责拦截渲染 API 调用把每帧统计写入一块共享内存Status Monitor Overlay只做一件事把这块内存映射进自己的地址空间然后读取里面的数据。两者之间没有任何线程通信开销——游戏进程写监控进程读共享内存是唯一的信箱。这也是官方 FAQ 中声称对游戏性能影响可忽略不计的原因监控几乎全部运行在 Core #3 上刷新率设为 1 FPS 时其他核心占用低于 0.005%。 第一步连接 SaltySD 命名端口拿内存句柄一切从连接系统命名端口SaltySD开始。相关实现集中在 SaltyNX.h其连接函数SaltySD_Connect()会最多重试 200 次每次间隔 1ms直到拿到会话句柄为止。拿到句柄后监控程序发出两条关键指令均为 IPC 命令命令cmd_id作用SaltySD_GetSharedMemoryHandle7取回共享内存块的句柄SaltySD_GetDisplayRefreshRate10读取当前显示刷新率用于 Full 模式的 PFPS 对比整个过程封装在 Utils.hpp 的LoadSharedMemoryAndRefreshRate()中先取句柄和刷新率再用shmemLoadRemoteshmemMap把远端内存页4KB0x1000映射到本地。映射成功后SharedMemoryUsed标志被置位——这就是后续所有帧率功能的总开关。 值得注意的细节每条 IPC 命令的报文头部都携带魔数校验请求方向用SFCI_MAGIC0x49434653字节序即 SFIC响应方向用SFCO_MAGICSFCO定义见 ipc.h。这相当于给每次通话加了防伪戳防止把无关数据误当响应解析。 第二步MAGIC 签名扫描——在一块内存里猜出数据位置问题在于SaltyNX 把帧率数据放在 4KB 共享内存的哪个偏移处不同版本的 SaltyNX 布局可能不同监控程序不会硬编码地址而是用一个精妙的签名扫描数据块NxFpsSharedBlock的第一个字段是MAGIC合法值必须是0x465053按字节看正是 SPF 三个字母。扫描逻辑非常朴素——从内存起点开始每 4 字节检查一次if (NxFps - MAGIC 0x465053) { return; // 找到了 } else search_offset 4;这段扫描代码位于 Utils.hpp 的searchSharedMemoryBlock()最多遍历 0x1000 字节。找到的NxFpsSharedBlock结构共174 字节源码用static_assert锁死大小防止编译期错位里面装着字段含义FPS/FPSavg当前帧率 / 平均帧率帧时间平均法FPSlocked/FPSmode游戏是否锁帧、锁帧模式FPSticks[10]最近 10 帧的帧时间记录renderCalls[8]/viewportCalls[8]传给 GPU 的渲染分辨率与视口调用统计frameNumber全局帧序号判断游戏是否还在出帧readSpeedPerSecond游戏每秒读取速度MiB/sdisplaySync掌机/底座模式同步状态这套设计的妙处在于向后兼容即使 SaltyNX 升级导致数据块整体偏移只要 SPF 签名还在扫描就能重新定位——签名即契约偏移无关紧要。 第三步如何判断游戏正在运行光找到结构体还不够监控还需要确认游戏确实活着。这里用了两个小把戏pluginActive乒乓信号监控程序先把pluginActive置false睡 100 毫秒后再检查——如果它被游戏侧改回了true说明 SaltyNX 插件正在活动游戏在运行逻辑见CheckIfGameRunning()。frameNumber帧序号帧序号持续推进 画面在刷新若游戏卡顿或暂停帧序号不动FPS 图模式就保持旧图不更新。另外FPS 1234、FPSavg 254这类不可能的数值被当作哨兵值界面上显示n/dno data表示未安装 SaltyNX 或游戏未启动。 四种显示模式数据如何变成画面拿到共享内存数据后展示层由 source/modes/ 下的几个组件完成FPS CounterFPS_Counter.hpp只显示一个数字的平均帧率以 31Hz 刷新并对垂直同步信号支持触摸或体感摇动手柄拖动位置FPS GraphFPS_Graph.hpp平均帧率曲线图背景叠加实时值。若平均帧率落在 ±0.05 的舍入误差内例如 30 FPS 目标落在 29.95~30.04 区间曲线段会变为绿色落在半刷新率区间则为其他配色Full / Mini把 FPS 作为可选条目混入完整硬件面板。Full 模式还会额外显示PFPS每秒推送到屏幕的帧数与计算 FPS 互为印证以及两个最可能的内部渲染分辨率Game Resolutions直接读取renderCalls/viewportCalls统计展示 Depth 纹理与 Viewport 两条通道捕获到的分辨率候选列表。各模式的字段格式与解释详见 docs/modes.md。⚙️ 使用前提与常见问题要让帧率功能生效需满足已安装Tesla 环境1.2.3与SaltyNX建议 1.8.1旧版会导致多个 sysmodule 同时访问 SD 卡时卡死使用作者的 SaltyNX fork 才能看到 PFPS、分辨率与读取速度配置文件模板见 config/status-monitor/config.ini.template刷新率、字体大小、颜色均可在 docs/config.md 中查到的选项里自定义。常见坑开 Full/Mini 模式时 Core #3 飙到 100% 直至崩溃通常是nifm ctest补丁、行为异常的自制 sysmodule或签名补丁 副机 联网的组合所致——详见 README 的 Troubleshooting 章节。 总结这套架构值得借鉴Status Monitor Overlay 的帧率监控内幕本质上是一个教科书级的旁路观测设计共享内存 句柄传递跨进程数据交换零轮询成本写方与读方完全解耦MAGIC 签名扫描用 SPF0x465053这种自描述魔数替代硬编码地址天然抗版本漂移哨兵值 乒乓信号用不可能的数值和一次翻转握手优雅处理无数据状态IPC 双魔数SFCI/SFCO请求与响应各自带防伪签名通信健壮可靠。这些技巧不仅适用于 Switch 自制开发对任何需要无侵入监控第三方进程的场景都是可复用的思路。核心源码入口连接与内存获取见 SaltyNX.h数据结构与扫描见 Utils.hpp展示逻辑见 source/modes/。【免费下载链接】Status-Monitor-OverlayMonitor many stats of Nintendo Switch hardware项目地址: https://gitcode.com/gh_mirrors/st/Status-Monitor-Overlay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考