From 476bbe695cdb478bb9a76ca41a3e92a76eb789d6 Mon Sep 17 00:00:00 2001 From: rmc Date: Fri, 24 Nov 2023 02:21:31 -0500 Subject: [PATCH] Write maketad page better than Nintendo --- dsidev/man/maketad.html | 53 ++++++++++++++++++++++++++++++------ dsidev/twlnmenu.html | 2 +- dsidev/twlsystemupdater.html | 2 +- 3 files changed, 46 insertions(+), 11 deletions(-) diff --git a/dsidev/man/maketad.html b/dsidev/man/maketad.html index 61998b7..62129de 100644 --- a/dsidev/man/maketad.html +++ b/dsidev/man/maketad.html @@ -37,6 +37,9 @@ TD,TH{

maketad

+

+NOTE: This is an edited version of the official README. +

Description

　maketad is a tool for generating TAD files (.tad) from the specified SRL file. TAD files are used to import applications into the system memory.

@@ -45,10 +48,41 @@ TAD files for TWL that are created with this tool can only be imported into TWL development kits. The TWL-SDK environment cannot be used to create TAD files that can run on retail TWL hardware.

+

Downloads

-openssl for cygwin version 0.9.8b-1 or later is required in order to use maketad. +Standard maketad application. These create TAD files to be imported to development hardware through TwlNmenu. Output TADs will be encrypted with the Wii debug key (A1604A6A7123B529AE8BEC32C816FCAA). +

+ +

+Updater maketad application. These create TAD files to be used when compiling Twl SystemUpdater. Output TADs are encrypted with an unknown key and so they cannot be decrypted. +

+ +

+Dependancies for maketad. +

+ +

+Additional tools. These are not required, but are recommended for working with TAD files. +

-

Using the Tool

Start Command

% maketad [OPTION]... SRLFILE [-o outputFile]

@@ -67,12 +101,12 @@ Returns 0 when execution completes normally.
The following are possible reasons for the function to fail.

Revision History

-2023/11/21 Added download links, the -s option, changed dependancy information, and listed maketad_updater.
+2023/11/24 Added download links, changed dependancy information, and listed maketad_updater + split_tad_console.
+2023/11/21 Added the -s option
2009/11/10 Added Return Values.
-2008/10/16 Added the -n option. Added information about openssl.
+2008/10/16 Added the -n option. Added information about openssl.
2008/09/16 Added information about ROM operations on development hardware/mass production hardware.
2008/04/25 Standardized terminology related to the NAND application version.
2008/03/19 Made descriptions compliant with the terminology.
diff --git a/dsidev/twlnmenu.html b/dsidev/twlnmenu.html index f27d804..e7a89c5 100755 --- a/dsidev/twlnmenu.html +++ b/dsidev/twlnmenu.html @@ -8,7 +8,7 @@ TwlNmenu is a title manager similar to DevMenu for 3DS. TwlNmenu can install pro

TADs are essentially SRLs (NDS ROMs) that have been packaged into an installable format. TAD files can be created with - maketad.exe + maketad.exe , from the TwlSDK (TwlSDK/tools/bin/maketad.exe). Only apps that are installed to the 00030004 folder are able to be converted to TAD

Note: DO NOT install TADs on a retail DSi.

Attempting to do so will just result in a -2011 error, due to the TAD being unsigned. Resigning the TAD will not work as TwlNmenu protects against this (error code 7). Additionally, TwlNmenu will OVERWRITE WHAT IT'S TRYING TO INSTALL, so if it fails, your apps may be deleted.

How can I safely run a TAD?

To run a TAD on retail hardware, you have to decrypt it and extract the SRL. You can use this python script to do so. Usage is python3 decrypt_tad.py [path to file].tad
Rename the SRL to NDS, and it should work in emulators or on real hardware.

Screenshots:

diff --git a/dsidev/twlsystemupdater.html b/dsidev/twlsystemupdater.html index 460c021..214b351 100755 --- a/dsidev/twlsystemupdater.html +++ b/dsidev/twlsystemupdater.html @@ -29,7 +29,7 @@ These are TADs that are common between both the IS-TWL-DEBUGGER and panda units. - TwlNmenu (optional install)

The SystemUpdater chooses whether to install from the debuggeror standalone folder based off of the RAM size. 16 MB is TWL CONSOLE (panda and IS-TWL-CAPTURE), while 32 MB is IS_TWL_DEBUGGER.
- Source: RGD

-All the TAD files in NitroFS have been created with maketad_updater, a modified version of maketad. This uses a different key to encrypt the TADs (normally the Wii dev key is used), so the only way to get the decrypted SRLs is by running the SystemUpdater and then extracting the contents from NAND. +All the TAD files in NitroFS have been created with maketad_updater, a modified version of maketad. This uses a different key to encrypt the TADs (normally the Wii dev key is used), so the only way to get the decrypted SRLs is by running the SystemUpdater and then extracting the contents from NAND.

Additional ".nand" file

There another file in NitroFS called menu_launcher.nand (found in NitroFS/data/common/). Judging from the menu-launcher source code in TwlIPL (TwlIPL/trunk/build/nandfirm/menu-launcher/), this appears to be the stage2 bootloader. The .nand file has a version number at the bottom showing that it is SDK 2435, IPL 8325. This is the same as every retail DSi.

Changelog