固件操作系统嵌入式调试器【免费下载链接】Luma3DSNintendo 3DS Custom Firmware项目地址https://gitcode.com/gh_mirrors/lu/Luma3DS点击查看免费下载导读本文围绕 sysmodules/loader/README.md 展开系统讲解 Luma3DS 中对 3DS 原生loader系统模块的开源重实现它不仅是官方 loader 的替代品更是 Luma3DS 所有进程级补丁区域自由启动、IPS/BPS 补丁、LayeredFS、locale 模拟、系统模块替换与 3DSX 自制软件加载的落点。读完本文你将掌握 loader 的职责边界与命令接口、SD 卡补丁目录的完整布局、其补丁流水线的实现原理以及如何独立构建并用填充数据将其装配为可替换的 NCCH 模块。一、Loader 是什么一个为补丁而生的系统模块在 3DS 的系统软件栈中loader是内核启动的初始进程KIP之一负责把非 KIP 的进程从存储介质NAND/SD读取到内存并创建为可运行进程。Luma3DS 项目将其整体重写为开源的 sysmodules/loader核心动机在文档中写得很直白This is an open source implementation of 3DSloadersystem module -- with additional features. The current aim of the project is to provide a nice entry point for patching 3DS modules.即loader 是修补 3DS 模块的最佳切入点。因为所有普通进程的代码都要经过 loader 之手被读入内存只要在代码被装载之后、进程启动之前插入处理逻辑就能以统一的方式改造任意可执行体。在主仓库 README.md 的组件说明中同样强调loader 承担从存储加载非 KIP 进程的职责所有进程补丁都在这里完成这也是游戏 modding 功能的基础同时它还是处理 3DSX 自制软件加载的系统模块。与官方 loader 相比该重实现最显著的增量能力是SDMCSD 卡读取支持——官方 loader 并不具备该能力因此补丁可以自由地从 SD 卡加载而不必把补丁固话进系统固件。二、进程加载的主流程与命令接口loader 以服务端进程形式运行对外暴露两个服务定义在 main.cstatic const ServiceManagerServiceEntry services[] { { Loader, 2, loaderHandleCommands, false }, { hb:ldr, 2, hbldrHandleCommands, true }, { NULL }, };Loader标准 loader 服务处理进程注册、加载等核心命令hb:ldr自制软件加载服务用于 3DSX 加载详见第五节。服务命令的完整分派实现在 loader.c 的loaderHandleCommands中命令 ID名称作用0x01LoadProcess按 program handle 加载进程返回进程句柄0x02RegisterProgram注册程序含 title/update 两份 FS_ProgramInfo返回 program handle0x03UnregisterProgram注销程序0x04GetProgramInfo查询程序 ExHeader 信息0x100DisableNextGamePatch自定义标记下一次游戏启动跳过补丁0x101ControlApplicationMemoryModeOverride自定义查询/设置应用内存模式O3DS/N3DS覆盖0x102GetLastApplicationProgramInfo自定义获取最近一次应用加载的 ExHeader 信息其中 0x100-0x102 三个命令是官方 loader 没有的自定义扩展体现出重实现 附加能力的定位。例如ControlApplicationMemoryModeOverrideloader.c 中的位域结构允许在 ExHeader 之外强制指定 O3DS/N3DS 的内存模式用于运行某些对内存布局敏感的应用。RegisterProgram还承担着系统模块替换的检测逻辑loader.c当被注册的 title 属于系统模块titleId 32 0x00040130且配置开启了加载外部 FIRM 与模块时loader 会优先尝试在 SD 卡/luma/sysmodules/titleId.cxi打开对应的 CXI 文件只有文件不存在时才回落到PXIPM_RegisterProgram走官方路径。三、补丁流水线从装载到启动之间的改造LoadProcessImplloader.c展现了完整的加载动作解析 ExHeader 中的 CodeSet 信息 → 计算各段text/rodata/data大小并按 4KB 对齐 → 分配进程内存 →loadCode读入代码 → 可选 LZSS 解压 →patchCode执行补丁 →svcCreateCodeSetsvcCreateProcess创建进程。3.1 代码的三种来源loadCodeloader.c按优先级尝试来自替换用 CXI若程序以sysmodule CXI cookie形式被注册0xEEEE000000000000掩码见 loader.c直接读入替换 CXI 的代码段并跳过补丁来自 SD 卡的 code.bin当配置开启PATCHGAMES时先尝试loadTitleCodeSection读取/luma/titles/titleID/code.bin必须是解密且解压过的二进制代码见 patcher.c系统模块则额外要求同时开启LOADEXTFIRMSANDMODULES来自原始存储上述途径都未命中时从存储中的 CXI 读取.code段使用ARCHIVE_SAVEDATA_AND_CONTENT2并对压缩代码执行 LZSS 解压。3.2 内置补丁区域自由与系统级修正patchCodepatcher.c内置了大量针对特定 title 的硬编码补丁均在代码装载后、进程启动前以字节模式匹配memsearch方式改写指令典型的包括Home Menumenu区域自由补丁跳过 SMDH 区域校验、手册区域校验并移除 DS 烧录卡白名单检查——这正是文档 Roadmap 中patchmenuto skip region checks and have region free game launching directly from the home menu的实现落地patcher.c。针对不同固件版本progVer还有版本判定逻辑防止旧版本上补丁不匹配MSET 版本字符串补丁配合/luma/customversion_*.txt自定义系统设置中的版本显示patcher.c默认显示 Sys/Emu2 等支持 UTF-8→UTF-16 转换、BOM 处理与最长 19 字符限制NS 补丁禁用外区卡带更新实现卡带区域自由、N3DS CPU 时钟与 L2 缓存设置补丁等patcher.cCFG禁用 SecureInfo 签名检查并使用SecureInfo_Cpatcher.cRO禁用 CRR0 签名与 CRO0/CRR0 哈希校验patcher.cDLP区域检查补丁patcher.cDSP签名检查补丁patcher.c。补丁失败时会调用svcBreak(USERBREAK_ASSERT)触发断言patcher.c便于在开发期定位问题。3.3 外部补丁IPS 与 BPS除了内置补丁loader 支持从 SD 卡加载两种格式的外部补丁IPS由applyCodeIpsPatchpatcher.c解析支持标准的 PATCH 头、EOF 结束标记以及 RLE 重复字节记录BPS由 bps_patcher.cpp 实现采用可变长度整数编码与 CRC32 校验见文件头部的crc32实现文件头路径同样按 titleID 组织。3.4 LayeredFS 与 locale 模拟LayeredFS当/luma/titles/titleID/romfs目录存在时patchLayeredFspatcher.c会在已装载的代码中动态定位 FS 模块的fsMountArchive、fsRegisterArchive、fsTryOpenFile、fsOpenFileDirectly、fsUnMountArchive五个函数通过特征指令模式匹配 函数起始点回溯见findLayeredFsSymbols随后注入 romfs 重定向 payload把 ROMFS 打开路径重写到 SD 卡目录。它还会探测更新 ROMFS 的挂载名ro2:/rom2:/rex:/patch:/ext:/rom:并对 Mario Kart 7 这类特例使用隔离的pat1挂载点避免误匹配locale 模拟loadTitleLocaleConfigpatcher.c解析/luma/titles/titleID/locale.txt支持region language country stateID四段式格式如EUR IT并内置了完整的区域JPN/USA/EUR/AUS/CHN/KOR/TWN、语言、国家代码映射表解析结果通过svcKernelSetState(0x10001, ...)提交给内核扩展实现按游戏覆盖语言与区域。补丁的应用顺序与开关在 patcher.c 中清晰可见系统模块的外部补丁需要LOADEXTFIRMSANDMODULES应用/小程序的外部补丁需要PATCHGAMES且受nextGamePatchDisabled开关控制该开关正是被第三节提到的自定义命令 0x100 置位。两个配置位的含义与 arm9/data/config_template.ini 中enable_external_firm_and_modules、enable_game_patching一一对应。四、SD 卡补丁目录布局速查综合 patcher.c、bps_patcher.cpp 与 loader.c 中的路径常量loader 识别的补丁文件组织如下titleID为大写十六进制 16 位 title ID路径用途/luma/titles/titleID/code.ipsIPS 格式代码补丁/luma/titles/titleID/code.bpsBPS 格式代码补丁/luma/titles/titleID/code.bin直接替换整个代码段解密、解压后的二进制/luma/titles/titleID/exheader.bin替换 ExHeader 信息须为解密后的 ExHeader/luma/titles/titleID/locale.txtlocale 模拟如EUR IT/luma/titles/titleID/romfs/LayeredFS 资源重定向目录/luma/sysmodules/titleID.ips系统模块 IPS 补丁/luma/sysmodules/titleID.bps系统模块 BPS 补丁/luma/sysmodules/titleID.cxi完整替换系统模块的 CXI 文件/luma/customversion_sys.txt等系统设置中的自定义版本字符串sys/emu/emu2/emu3/emu4 五种 NAND 对应文件实际存放于 SD 卡还是 NAND 由运行模式决定openLumaFile在 SD 模式使用ARCHIVE_SDMC否则回退到ARCHIVE_NAND_RWpatcher.c。五、3DSX 自制软件加载hb:ldr除官方 loader 职责外loader 还接管了 3DSX 自制软件的加载这是 Luma3DS 对 homebrew 的一等公民支持的重要一环。相关实现在 hbldr.c 与 3dsx.chb:ldr服务支持两个命令hbldr.cSetTarget命令 2设置要加载的 3DSX 文件路径UTF-8→UTF-16 转换最长PATH_MAX与SetArgv命令 3设置 argv 缓冲默认加载目标为sdmc:/boot.3dsxhbldr.c3DSX 解析由 3dsx.c 的Ldr_Get3dsxSize/Ldr_CodesetFrom3dsx完成校验魔数、按 4KB 对齐三个段、预留一页空间并通过Ldr_CodesetFrom3dsx把 3DSX 转成 CodeSet 后调用svcCreateProcess创建进程hbldr.c由于自制软件没有真正的 ExHeaderhbldrPatchExHeaderInfohbldr.c会伪造一份 ExHeader填入依赖系统模块列表NATIVE_FIRM 与 SAFE_FIRM 两套依赖表按最佳启动顺序扁平化排列、内核能力描述符含 DSP RAM/VRAM 映射、全部 SVC 访问、APPLICATIONmemtype 等、服务访问列表34 个服务9.6 以下固件裁剪为 32 个以及资源限制3DSX 加载所使用的 title ID 由共享配置中的hbldr_3dsx_tid决定luma_shared_config.h默认值为000400000D921E00见 sysmodules/loader/Makefile 的HBLDR_DEFAULT_3DSX_TID对应 arm9/data/config_template.ini 中的hbldr_3dsx_titleid配置项。六、构建方法原文档给出的构建要求为可用的 3DS 构建环境 较新的 devkitARM、ctrulib 与 makerom若构建过程报错多半是工具链版本过旧。当前仓库的 sysmodules/loader/Makefile 进一步明确了细节依赖DEVKITARM环境变量未设置直接报错退出编译参数-marcharmv6k -mtunempcore -mfloat-abihard -mtpsoft默认-O2 -fomit-frame-pointer并开启-Wall -Wextra -Werror目标产物为.cximakerom -f ncch -rsf rsf -nocodepadding -o loader.cxi -elf loader.elfsysmodules/loader/Makefile其中 NCCH 布局由 loader.rsf 描述UniqueId0x13、仅开放fs:LDR服务、文件系统权限DirectSdmcCtrNandRw、启用 ExeFS 代码压缩支持两个可选构建变量BUILD_FOR_EXPLOIT_DEV1关闭补丁相关配置用于漏洞开发与BUILD_FOR_GDB1-O0并链接-lctrud便于 GDB 调试。在完整 Luma3DS 工程中loader 并不单独成 FIRM顶层 Makefile 会先构建sysmodules其中包含 loader再通过firmtool build boot.firm -D sysmodules/sysmodules.bin ...把各组件打包成单个boot.firm。七、作为独立 NCCH 替换官方 loader 的装配步骤原文档明确指出当时项目尚未支持 FIRM 构建因此需要手工几步完成替换下面按文档步骤展开并补充可操作细节补齐 NCCH 尺寸官方 loader 在解密 FIRM 中的 NCCH 尺寸是固定的替换用的 NCCH 必须与之完全相同才能掉包。文档给出的做法是给 NCCH 添加填充垃圾数据通过反复调整填充的 size 值直到生成的 NCCH 与解密 FIRM 中的原件尺寸完全一致。其原始文档附有一份添加 junk data的补丁示例思路即是在构建产物末尾追加填充区替换进解密 FIRM将尺寸对齐后的 NCCH 覆盖写入解密 FIRM 中原 loader 所在的位置设法启动把修改后的 FIRM 通过支持加载自定义 FIRM 的引导方式文档示例为 ReiNAND启动即可生效。需要说明的是该手工流程主要适用于 loader 作为独立模块的早期使用场景在如今的完整 Luma3DS 中loader 已作为sysmodules子组件被直接编入boot.firm见顶层 Makefile无需再手工装配。八、在 Luma3DS 中的集成位置与配置开关loader 的行为由两个关键配置位驱动它们通过loadCFWInfomain.c从内核扩展读取PATCHGAMES对应 patcher.h 中的enum singleOptions配置项enable_game_patching开启游戏补丁功能包括 locale 模拟、IPS 补丁、LayeredFS 等LOADEXTFIRMSANDMODULES配置项enable_external_firm_and_modules开启从 SD 卡加载外部 FIRM 与系统模块替换。值得注意的是对于系统模块类 title上述两个开关存在叠加约束loadCode中外部代码加载对系统模块要求同时开启PATCHGAMES与LOADEXTFIRMSANDMODULES而对普通应用只需PATCHGAMESloader.c。这一设计避免了用户无意中通过 SD 卡替换系统模块引入不稳定性。结语从进程加载到补丁注入再到 3DSX 自制软件入口Luma3DS 的 loader 重实现把装载与改造两个阶段无缝衔接成为整个自定义固件体系中最关键的代码注入点内置补丁解决区域自由与系统级修正IPS/BPS 与code.bin提供用户可扩展的补丁通道LayeredFS 与 locale 模拟支撑游戏 modding而 sysmodule CXI 替换则让社区得以完整重写任意系统模块。理解 loader 的补丁流水线与目录约定是深入 Luma3DS 源码与开发 3DS 补丁的必修课。赞分享固件操作系统嵌入式调试器【免费下载链接】Luma3DSNintendo 3DS Custom Firmware项目地址https://gitcode.com/gh_mirrors/lu/Luma3DS点击查看免费下载相关推荐Atmosphere boot2 系统模块解析Horizon 启动编排器的重实现与 SD 卡自定义系统模块加载机制Atmosphere boot2 系统模块解析Horizon 启动编排器的重实现与 SD 卡自定义系统模块加载机制 本文围绕 Atmosphere大气层开固件操作系统嵌入式Atmosphère 的 ro 系统模块深度解析NRO 动态库加载、NRR 签名校验与 SD 卡 IPS 补丁机制Atmosphère 的 ro 系统模块深度解析NRO 动态库加载、NRR 签名校验与 SD 卡 IPS 补丁机制 导读 本文基于 Atmosphère 稳定固件操作系统嵌入式Luma3DS补丁系统终极指南从零开始为3DS编写和应用系统补丁Luma3DS是任天堂3DS设备最强大的自定义固件CFW之一其核心功能就是通过 补丁系统 来修改和增强原生系统功能。通过补丁Luma3DS能够绕过签名验固件操作系统嵌入式调试器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
固件操作系统嵌入式调试器【免费下载链接】Luma3DSNintendo 3DS Custom Firmware项目地址https://gitcode.com/gh_mirrors/lu/Luma3DS点击查看免费下载导读本文围绕 sysmodules/loader/README.md 展开系统讲解 Luma3DS 中对 3DS 原生loader系统模块的开源重实现它不仅是官方 loader 的替代品更是 Luma3DS 所有进程级补丁区域自由启动、IPS/BPS 补丁、LayeredFS、locale 模拟、系统模块替换与 3DSX 自制软件加载的落点。读完本文你将掌握 loader 的职责边界与命令接口、SD 卡补丁目录的完整布局、其补丁流水线的实现原理以及如何独立构建并用填充数据将其装配为可替换的 NCCH 模块。一、Loader 是什么一个为补丁而生的系统模块在 3DS 的系统软件栈中loader是内核启动的初始进程KIP之一负责把非 KIP 的进程从存储介质NAND/SD读取到内存并创建为可运行进程。Luma3DS 项目将其整体重写为开源的 sysmodules/loader核心动机在文档中写得很直白This is an open source implementation of 3DSloadersystem module -- with additional features. The current aim of the project is to provide a nice entry point for patching 3DS modules.即loader 是修补 3DS 模块的最佳切入点。因为所有普通进程的代码都要经过 loader 之手被读入内存只要在代码被装载之后、进程启动之前插入处理逻辑就能以统一的方式改造任意可执行体。在主仓库 README.md 的组件说明中同样强调loader 承担从存储加载非 KIP 进程的职责所有进程补丁都在这里完成这也是游戏 modding 功能的基础同时它还是处理 3DSX 自制软件加载的系统模块。与官方 loader 相比该重实现最显著的增量能力是SDMCSD 卡读取支持——官方 loader 并不具备该能力因此补丁可以自由地从 SD 卡加载而不必把补丁固话进系统固件。二、进程加载的主流程与命令接口loader 以服务端进程形式运行对外暴露两个服务定义在 main.cstatic const ServiceManagerServiceEntry services[] { { Loader, 2, loaderHandleCommands, false }, { hb:ldr, 2, hbldrHandleCommands, true }, { NULL }, };Loader标准 loader 服务处理进程注册、加载等核心命令hb:ldr自制软件加载服务用于 3DSX 加载详见第五节。服务命令的完整分派实现在 loader.c 的loaderHandleCommands中命令 ID名称作用0x01LoadProcess按 program handle 加载进程返回进程句柄0x02RegisterProgram注册程序含 title/update 两份 FS_ProgramInfo返回 program handle0x03UnregisterProgram注销程序0x04GetProgramInfo查询程序 ExHeader 信息0x100DisableNextGamePatch自定义标记下一次游戏启动跳过补丁0x101ControlApplicationMemoryModeOverride自定义查询/设置应用内存模式O3DS/N3DS覆盖0x102GetLastApplicationProgramInfo自定义获取最近一次应用加载的 ExHeader 信息其中 0x100-0x102 三个命令是官方 loader 没有的自定义扩展体现出重实现 附加能力的定位。例如ControlApplicationMemoryModeOverrideloader.c 中的位域结构允许在 ExHeader 之外强制指定 O3DS/N3DS 的内存模式用于运行某些对内存布局敏感的应用。RegisterProgram还承担着系统模块替换的检测逻辑loader.c当被注册的 title 属于系统模块titleId 32 0x00040130且配置开启了加载外部 FIRM 与模块时loader 会优先尝试在 SD 卡/luma/sysmodules/titleId.cxi打开对应的 CXI 文件只有文件不存在时才回落到PXIPM_RegisterProgram走官方路径。三、补丁流水线从装载到启动之间的改造LoadProcessImplloader.c展现了完整的加载动作解析 ExHeader 中的 CodeSet 信息 → 计算各段text/rodata/data大小并按 4KB 对齐 → 分配进程内存 →loadCode读入代码 → 可选 LZSS 解压 →patchCode执行补丁 →svcCreateCodeSetsvcCreateProcess创建进程。3.1 代码的三种来源loadCodeloader.c按优先级尝试来自替换用 CXI若程序以sysmodule CXI cookie形式被注册0xEEEE000000000000掩码见 loader.c直接读入替换 CXI 的代码段并跳过补丁来自 SD 卡的 code.bin当配置开启PATCHGAMES时先尝试loadTitleCodeSection读取/luma/titles/titleID/code.bin必须是解密且解压过的二进制代码见 patcher.c系统模块则额外要求同时开启LOADEXTFIRMSANDMODULES来自原始存储上述途径都未命中时从存储中的 CXI 读取.code段使用ARCHIVE_SAVEDATA_AND_CONTENT2并对压缩代码执行 LZSS 解压。3.2 内置补丁区域自由与系统级修正patchCodepatcher.c内置了大量针对特定 title 的硬编码补丁均在代码装载后、进程启动前以字节模式匹配memsearch方式改写指令典型的包括Home Menumenu区域自由补丁跳过 SMDH 区域校验、手册区域校验并移除 DS 烧录卡白名单检查——这正是文档 Roadmap 中patchmenuto skip region checks and have region free game launching directly from the home menu的实现落地patcher.c。针对不同固件版本progVer还有版本判定逻辑防止旧版本上补丁不匹配MSET 版本字符串补丁配合/luma/customversion_*.txt自定义系统设置中的版本显示patcher.c默认显示 Sys/Emu2 等支持 UTF-8→UTF-16 转换、BOM 处理与最长 19 字符限制NS 补丁禁用外区卡带更新实现卡带区域自由、N3DS CPU 时钟与 L2 缓存设置补丁等patcher.cCFG禁用 SecureInfo 签名检查并使用SecureInfo_Cpatcher.cRO禁用 CRR0 签名与 CRO0/CRR0 哈希校验patcher.cDLP区域检查补丁patcher.cDSP签名检查补丁patcher.c。补丁失败时会调用svcBreak(USERBREAK_ASSERT)触发断言patcher.c便于在开发期定位问题。3.3 外部补丁IPS 与 BPS除了内置补丁loader 支持从 SD 卡加载两种格式的外部补丁IPS由applyCodeIpsPatchpatcher.c解析支持标准的 PATCH 头、EOF 结束标记以及 RLE 重复字节记录BPS由 bps_patcher.cpp 实现采用可变长度整数编码与 CRC32 校验见文件头部的crc32实现文件头路径同样按 titleID 组织。3.4 LayeredFS 与 locale 模拟LayeredFS当/luma/titles/titleID/romfs目录存在时patchLayeredFspatcher.c会在已装载的代码中动态定位 FS 模块的fsMountArchive、fsRegisterArchive、fsTryOpenFile、fsOpenFileDirectly、fsUnMountArchive五个函数通过特征指令模式匹配 函数起始点回溯见findLayeredFsSymbols随后注入 romfs 重定向 payload把 ROMFS 打开路径重写到 SD 卡目录。它还会探测更新 ROMFS 的挂载名ro2:/rom2:/rex:/patch:/ext:/rom:并对 Mario Kart 7 这类特例使用隔离的pat1挂载点避免误匹配locale 模拟loadTitleLocaleConfigpatcher.c解析/luma/titles/titleID/locale.txt支持region language country stateID四段式格式如EUR IT并内置了完整的区域JPN/USA/EUR/AUS/CHN/KOR/TWN、语言、国家代码映射表解析结果通过svcKernelSetState(0x10001, ...)提交给内核扩展实现按游戏覆盖语言与区域。补丁的应用顺序与开关在 patcher.c 中清晰可见系统模块的外部补丁需要LOADEXTFIRMSANDMODULES应用/小程序的外部补丁需要PATCHGAMES且受nextGamePatchDisabled开关控制该开关正是被第三节提到的自定义命令 0x100 置位。两个配置位的含义与 arm9/data/config_template.ini 中enable_external_firm_and_modules、enable_game_patching一一对应。四、SD 卡补丁目录布局速查综合 patcher.c、bps_patcher.cpp 与 loader.c 中的路径常量loader 识别的补丁文件组织如下titleID为大写十六进制 16 位 title ID路径用途/luma/titles/titleID/code.ipsIPS 格式代码补丁/luma/titles/titleID/code.bpsBPS 格式代码补丁/luma/titles/titleID/code.bin直接替换整个代码段解密、解压后的二进制/luma/titles/titleID/exheader.bin替换 ExHeader 信息须为解密后的 ExHeader/luma/titles/titleID/locale.txtlocale 模拟如EUR IT/luma/titles/titleID/romfs/LayeredFS 资源重定向目录/luma/sysmodules/titleID.ips系统模块 IPS 补丁/luma/sysmodules/titleID.bps系统模块 BPS 补丁/luma/sysmodules/titleID.cxi完整替换系统模块的 CXI 文件/luma/customversion_sys.txt等系统设置中的自定义版本字符串sys/emu/emu2/emu3/emu4 五种 NAND 对应文件实际存放于 SD 卡还是 NAND 由运行模式决定openLumaFile在 SD 模式使用ARCHIVE_SDMC否则回退到ARCHIVE_NAND_RWpatcher.c。五、3DSX 自制软件加载hb:ldr除官方 loader 职责外loader 还接管了 3DSX 自制软件的加载这是 Luma3DS 对 homebrew 的一等公民支持的重要一环。相关实现在 hbldr.c 与 3dsx.chb:ldr服务支持两个命令hbldr.cSetTarget命令 2设置要加载的 3DSX 文件路径UTF-8→UTF-16 转换最长PATH_MAX与SetArgv命令 3设置 argv 缓冲默认加载目标为sdmc:/boot.3dsxhbldr.c3DSX 解析由 3dsx.c 的Ldr_Get3dsxSize/Ldr_CodesetFrom3dsx完成校验魔数、按 4KB 对齐三个段、预留一页空间并通过Ldr_CodesetFrom3dsx把 3DSX 转成 CodeSet 后调用svcCreateProcess创建进程hbldr.c由于自制软件没有真正的 ExHeaderhbldrPatchExHeaderInfohbldr.c会伪造一份 ExHeader填入依赖系统模块列表NATIVE_FIRM 与 SAFE_FIRM 两套依赖表按最佳启动顺序扁平化排列、内核能力描述符含 DSP RAM/VRAM 映射、全部 SVC 访问、APPLICATIONmemtype 等、服务访问列表34 个服务9.6 以下固件裁剪为 32 个以及资源限制3DSX 加载所使用的 title ID 由共享配置中的hbldr_3dsx_tid决定luma_shared_config.h默认值为000400000D921E00见 sysmodules/loader/Makefile 的HBLDR_DEFAULT_3DSX_TID对应 arm9/data/config_template.ini 中的hbldr_3dsx_titleid配置项。六、构建方法原文档给出的构建要求为可用的 3DS 构建环境 较新的 devkitARM、ctrulib 与 makerom若构建过程报错多半是工具链版本过旧。当前仓库的 sysmodules/loader/Makefile 进一步明确了细节依赖DEVKITARM环境变量未设置直接报错退出编译参数-marcharmv6k -mtunempcore -mfloat-abihard -mtpsoft默认-O2 -fomit-frame-pointer并开启-Wall -Wextra -Werror目标产物为.cximakerom -f ncch -rsf rsf -nocodepadding -o loader.cxi -elf loader.elfsysmodules/loader/Makefile其中 NCCH 布局由 loader.rsf 描述UniqueId0x13、仅开放fs:LDR服务、文件系统权限DirectSdmcCtrNandRw、启用 ExeFS 代码压缩支持两个可选构建变量BUILD_FOR_EXPLOIT_DEV1关闭补丁相关配置用于漏洞开发与BUILD_FOR_GDB1-O0并链接-lctrud便于 GDB 调试。在完整 Luma3DS 工程中loader 并不单独成 FIRM顶层 Makefile 会先构建sysmodules其中包含 loader再通过firmtool build boot.firm -D sysmodules/sysmodules.bin ...把各组件打包成单个boot.firm。七、作为独立 NCCH 替换官方 loader 的装配步骤原文档明确指出当时项目尚未支持 FIRM 构建因此需要手工几步完成替换下面按文档步骤展开并补充可操作细节补齐 NCCH 尺寸官方 loader 在解密 FIRM 中的 NCCH 尺寸是固定的替换用的 NCCH 必须与之完全相同才能掉包。文档给出的做法是给 NCCH 添加填充垃圾数据通过反复调整填充的 size 值直到生成的 NCCH 与解密 FIRM 中的原件尺寸完全一致。其原始文档附有一份添加 junk data的补丁示例思路即是在构建产物末尾追加填充区替换进解密 FIRM将尺寸对齐后的 NCCH 覆盖写入解密 FIRM 中原 loader 所在的位置设法启动把修改后的 FIRM 通过支持加载自定义 FIRM 的引导方式文档示例为 ReiNAND启动即可生效。需要说明的是该手工流程主要适用于 loader 作为独立模块的早期使用场景在如今的完整 Luma3DS 中loader 已作为sysmodules子组件被直接编入boot.firm见顶层 Makefile无需再手工装配。八、在 Luma3DS 中的集成位置与配置开关loader 的行为由两个关键配置位驱动它们通过loadCFWInfomain.c从内核扩展读取PATCHGAMES对应 patcher.h 中的enum singleOptions配置项enable_game_patching开启游戏补丁功能包括 locale 模拟、IPS 补丁、LayeredFS 等LOADEXTFIRMSANDMODULES配置项enable_external_firm_and_modules开启从 SD 卡加载外部 FIRM 与系统模块替换。值得注意的是对于系统模块类 title上述两个开关存在叠加约束loadCode中外部代码加载对系统模块要求同时开启PATCHGAMES与LOADEXTFIRMSANDMODULES而对普通应用只需PATCHGAMESloader.c。这一设计避免了用户无意中通过 SD 卡替换系统模块引入不稳定性。结语从进程加载到补丁注入再到 3DSX 自制软件入口Luma3DS 的 loader 重实现把装载与改造两个阶段无缝衔接成为整个自定义固件体系中最关键的代码注入点内置补丁解决区域自由与系统级修正IPS/BPS 与code.bin提供用户可扩展的补丁通道LayeredFS 与 locale 模拟支撑游戏 modding而 sysmodule CXI 替换则让社区得以完整重写任意系统模块。理解 loader 的补丁流水线与目录约定是深入 Luma3DS 源码与开发 3DS 补丁的必修课。赞分享固件操作系统嵌入式调试器【免费下载链接】Luma3DSNintendo 3DS Custom Firmware项目地址https://gitcode.com/gh_mirrors/lu/Luma3DS点击查看免费下载相关推荐Atmosphere boot2 系统模块解析Horizon 启动编排器的重实现与 SD 卡自定义系统模块加载机制Atmosphere boot2 系统模块解析Horizon 启动编排器的重实现与 SD 卡自定义系统模块加载机制 本文围绕 Atmosphere大气层开固件操作系统嵌入式Atmosphère 的 ro 系统模块深度解析NRO 动态库加载、NRR 签名校验与 SD 卡 IPS 补丁机制Atmosphère 的 ro 系统模块深度解析NRO 动态库加载、NRR 签名校验与 SD 卡 IPS 补丁机制 导读 本文基于 Atmosphère 稳定固件操作系统嵌入式Luma3DS补丁系统终极指南从零开始为3DS编写和应用系统补丁Luma3DS是任天堂3DS设备最强大的自定义固件CFW之一其核心功能就是通过 补丁系统 来修改和增强原生系统功能。通过补丁Luma3DS能够绕过签名验固件操作系统嵌入式调试器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
