NSS:LaunchApplicationFIRM

From 3dbrew
Revision as of 03:57, 7 May 2013 by Yellows8 (talk | contribs)
Jump to navigation Jump to search

Request

Index Word Description
0 Header code [0x000500C0]
1 TitleID lower word
2 TitleID upper word
3 Flags

Response

Index Word Description
0 Header code
1 Result code

Description

This triggers a FIRM launch, where the title run by this FIRM is specified with the input titleID. The FIRM titleID-low is determined by the input application titleID. When the input TID is all-zero, the application is launched from the gamecard by the launched FIRM.

Flags bit0 is set when launching a FIRM which requires an application title-info structure to be specified via FIRM parameters. Otherwise when not specifying FIRM parameters, bit0 is clear. When flags bit1 is clear, NS will check certain Configuration Memory fields and will return an error if these checks fail. This Configuration Memory field checks seems to always pass on retail however.

When the input titleID is a TWL title, the TWL_FIRM titleID-low is used for launching FIRM, it's unknown how GBA VC titles are handled here. For CTR titles, the FIRM titleID-low is loaded from the input title's exheader programID-low. Therefore the CTR title specified here must be a FIRM title.