Difference between revisions of "NSS:LaunchApplicationFIRM"

From 3dbrew
Jump to navigation Jump to search
 
(2 intermediate revisions by one other user not shown)
Line 8: Line 8:
 
| Header code [0x000500C0]
 
| Header code [0x000500C0]
 
|-
 
|-
| 1
+
| 1-2
| TitleID lower word
+
| u64, Title ID
|-
 
| 2
 
| TitleID upper word
 
 
|-
 
|-
 
| 3
 
| 3
Line 34: Line 31:
 
This triggers a FIRM [[PMApp:LaunchFIRMSetParams|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.
 
This triggers a FIRM [[PMApp:LaunchFIRMSetParams|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 this FIRM doesn't use 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.
+
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 [[PMApp:GetTitleProgramID|programID-low]]. Therefore the CTR title specified here must be a [[FIRM]] title.
+
See [[APT:GetProgramInfo|here]] for how the FIRM programID-low is determined.

Latest revision as of 04:14, 20 January 2016

Request[edit]

Index Word Description
0 Header code [0x000500C0]
1-2 u64, Title ID
3 Flags

Response[edit]

Index Word Description
0 Header code
1 Result code

Description[edit]

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.

See here for how the FIRM programID-low is determined.