Changes

1,198 bytes added , 14:42, 18 September 2024

m

Add anchors

Line 1: Line 1: −

~~[[Category:Services]]~~

The NS ('''N'''intendo User Interface '''S'''hell) system module is the first module launched from a CTR-NAND title after the [[FIRM]] processes are loaded (also see [[Bootloader]]). This module is launched by the pm process, with the titleID loaded from NS state(hard-coded TID initialized during applet TID-array initialization). NS first launches [[ErrDisp]], then the menu. On retail the menu TID is loaded from NS state, while on dev/debug the menu TID is loaded from [[Config_Savegame|config]]. On dev-units if the menu TID block doesn't exist in [[Config_Savegame|config]], NS will attempt to launch the alternate menu instead. The TID of the launched menu is then written to [[Configuration Memory|ACTIVEMENUTID]]. NS uses [[PMApp:LaunchTitle|pm:app]] to launch titles.

Line 21: Line 20:

NS will only execute this code-path when [[Configuration Memory|0x1FF80016]] is value zero, when KERNEL_VERSIONMAJOR is value 2, and when KERNEL_VERSIONMINOR is less than 35. Therefore, this code-path is only executed when the running NATIVE_FIRM version is prior to [[5.0.0-11]].

+

= NS Service "ns:s" =

{| class="wikitable" border="1"

Line 119: Line 119:

The maximum sessions that can be used with this service is two, therefore only two processes can use this service at the same time.

+

=NS Power Service "ns:p"=

{| class="wikitable" border="1"

Line 134: Line 135:

This was added with [[3.0.0-5]]. The PTM sysmodule connects to this service, and syncs whenever [[PTM|ptm:s GetShellState()]] changes.

+

=NS Service "ns:c"=

{| class="wikitable" border="1"

Line 141: Line 143:

|-

| 0x00010100

−

| ?

+

| [[NSC:LockSpecialContent|LockSpecialContent]]

|-

| 0x00020100

−

| ?

+

| [[NSC:UnlockSpecialContent|UnlockSpecialContent]]

|}

−

This was added with [[5.0.0-11]], ~~it's unknown what this~~ is ~~used for~~.

+

This was added with [[5.0.0-11]]. It is used by the Instruction Manual applet, and is likely related to triggering SD/Game Card removal errors when ejecting the media the manual is stored on.

+

=APT Services=

{| class="wikitable" border="1"

Line 155: Line 158:

! Available since system version

! Accessible with APT:U

+

! Accessible with APT:A

! Description

|-

| 0x00010040

|

+

| Yes

| [[APT:GetLockHandle|GetLockHandle]]

Line 164: Line 169:

| 0x00020080

|

+

| See [[APT:Initialize|here]].

| [[APT:Initialize|Initialize]]

Line 169: Line 175:

| 0x00030040

|

+

| Yes

| [[APT:Enable|Enable]]

Line 174: Line 181:

| 0x00040040

|

+

| Yes

| [[APT:Finalize|Finalize]]

Line 179: Line 187:

| 0x00050040

|

+

| Yes

| [[APT:GetAppletManInfo|GetAppletManInfo]]

Line 184: Line 193:

| 0x00060040

|

+

| Yes (AppID != 0x300)

| Yes

| [[APT:GetAppletInfo|GetAppletInfo]]

Line 189: Line 199:

| 0x00070000

|

+

| Yes

| [[APT:GetLastSignaledAppletId|GetLastSignaledAppletId]]

Line 194: Line 205:

| 0x00080000

|

+

| Yes

| [[APT:CountRegisteredApplet|CountRegisteredApplet]]

Line 199: Line 211:

| 0x00090040

|

+

| Yes

| [[APT:IsRegistered|IsRegistered]]

Line 204: Line 217:

| 0x000A0040

|

+

| Yes

| [[APT:GetAttribute|GetAttribute]]

Line 209: Line 223:

| 0x000B0040

|

+

| Yes

| [[APT:InquireNotification|InquireNotification]]

Line 214: Line 229:

| 0x000C0104

|

+

| Yes

| [[APT:SendParameter|SendParameter]]

Line 219: Line 235:

| 0x000D0080

|

+

| Yes

| [[APT:ReceiveParameter|ReceiveParameter]]

Line 224: Line 241:

| 0x000E0080

|

+

| Yes

| [[APT:GlanceParameter|GlanceParameter]]

Line 229: Line 247:

| 0x000F0100

|

+

| Yes

| [[APT:CancelParameter|CancelParameter]]

Line 234: Line 253:

| 0x001000C2

|

+

| Yes

| [[APT:DebugFunc|DebugFunc]]

Line 239: Line 259:

| 0x001100C0

|

+

| Yes

| [[APT:MapProgramIdForDebug|MapProgramIdForDebug]]

Line 244: Line 265:

| 0x00120040

|

+

| Yes

| [[APT:SetHomeMenuAppletIdForDebug|SetHomeMenuAppletIdForDebug]]

Line 249: Line 271:

| 0x00130000

|

+

| Yes

| [[APT:GetPreparationState|GetPreparationState]]

Line 254: Line 277:

| 0x00140040

|

+

| Yes

| [[APT:SetPreparationState|SetPreparationState]]

Line 259: Line 283:

| 0x00150140

|

+

| No

| [[APT:PrepareToStartApplication|PrepareToStartApplication]]

Line 264: Line 289:

| 0x00160040

|

+

| Yes

| [[APT:PreloadLibraryApplet|PreloadLibraryApplet]]

Line 269: Line 295:

| 0x00170040

|

+

| Yes

| [[APT:FinishPreloadingLibraryApplet|FinishPreloadingLibraryApplet]]

Line 274: Line 301:

| 0x00180040

|

+

| Yes

| [[APT:PrepareToStartLibraryApplet|PrepareToStartLibraryApplet]]

Line 279: Line 307:

| 0x00190040

|

+

| Yes

| [[APT:PrepareToStartSystemApplet|PrepareToStartSystemApplet]]

Line 284: Line 313:

| 0x001A0000

|

+

| Yes

| [[APT:PrepareToStartNewestHomeMenu|PrepareToStartNewestHomeMenu]]

Line 289: Line 319:

| 0x001B00C4

|

+

| Yes

| [[APT:StartApplication|StartApplication]]

Line 294: Line 325:

| 0x001C0000

|

+

| Yes

| [[APT:WakeupApplication|WakeupApplication]]

Line 299: Line 331:

| 0x001D0000

|

+

| Yes

| [[APT:CancelApplication|CancelApplication]]

Line 304: Line 337:

| 0x001E0084

|

+

| Yes

| [[APT:StartLibraryApplet|StartLibraryApplet]]

Line 309: Line 343:

| 0x001F0084

|

+

| Yes

| [[APT:StartSystemApplet|StartSystemApplet]]

Line 314: Line 349:

| 0x00200044

|

+

| Yes

| [[APT:StartNewestHomeMenu|StartNewestHomeMenu]]

Line 319: Line 355:

| 0x00210000

|

+

| No

| [[APT:OrderToCloseApplication|OrderToCloseApplication]]

Line 324: Line 361:

| 0x00220040

|

+

| Yes

| [[APT:PrepareToCloseApplication|PrepareToCloseApplication]]

Line 329: Line 367:

| 0x00230040

|

+

| Yes

| [[APT:PrepareToJumpToApplication|PrepareToJumpToApplication]]

Line 334: Line 373:

| 0x00240044

|

+

| Yes

| [[APT:JumpToApplication|JumpToApplication]]

Line 339: Line 379:

| 0x002500C0

|

+

| Yes

| [[APT:PrepareToCloseLibraryApplet|PrepareToCloseLibraryApplet]]

Line 344: Line 385:

| 0x00260000

|

+

| Yes

| [[APT:PrepareToCloseSystemApplet|PrepareToCloseSystemApplet]]

Line 349: Line 391:

| 0x00270044

|

+

| Yes

| [[APT:CloseApplication|CloseApplication]]

Line 354: Line 397:

| 0x00280044

|

+

| Yes

| [[APT:CloseLibraryApplet|CloseLibraryApplet]]

Line 359: Line 403:

| 0x00290044

|

+

| Yes

| [[APT:CloseSystemApplet|CloseSystemApplet]]

Line 364: Line 409:

| 0x002A0000

|

+

| Yes

| [[APT:OrderToCloseSystemApplet|OrderToCloseSystemApplet]]

Line 369: Line 415:

| 0x002B0000

|

+

| Yes

| [[APT:PrepareToJumpToHomeMenu|PrepareToJumpToHomeMenu]]

Line 374: Line 421:

| 0x002C0044

|

+

| Yes

| [[APT:JumpToHomeMenu|JumpToHomeMenu]]

Line 379: Line 427:

| 0x002D0000

|

+

| Yes

| [[APT:PrepareToLeaveHomeMenu|PrepareToLeaveHomeMenu]]

Line 384: Line 433:

| 0x002E0044

|

+

| Yes

| [[APT:LeaveHomeMenu|LeaveHomeMenu]]

Line 389: Line 439:

| 0x002F0040

|

+

| Yes

| [[APT:PrepareToLeaveResidentApplet|PrepareToLeaveResidentApplet]]

Line 394: Line 445:

| 0x00300044

|

+

| Yes

| [[APT:LeaveResidentApplet|LeaveResidentApplet]]

Line 399: Line 451:

| 0x00310100

|

+

| Yes

| [[APT:PrepareToDoApplicationJump|PrepareToDoApplicationJump]]

Line 404: Line 457:

| 0x00320084

|

+

| Yes

| [[APT:DoApplicationJump|DoApplicationJump]]

Line 409: Line 463:

| 0x00330000

|

+

| Yes

| [[APT:GetProgramIdOnApplicationJump|GetProgramIdOnApplicationJump]]

Line 414: Line 469:

| 0x00340084

|

+

| Yes

| [[APT:SendDeliverArg|SendDeliverArg]]

Line 419: Line 475:

| 0x00350080

|

+

| Yes

| [[APT:ReceiveDeliverArg|ReceiveDeliverArg]]

Line 424: Line 481:

| 0x00360040

|

+

| Yes

| [[APT:LoadSysMenuArg|LoadSysMenuArg]]

Line 429: Line 487:

| 0x00370042

|

+

| Yes

| [[APT:StoreSysMenuArg|StoreSysMenuArg]]

Line 434: Line 493:

| 0x00380040

|

+

| Yes

| [[APT:PreloadResidentApplet|PreloadResidentApplet]]

Line 439: Line 499:

| 0x00390040

|

+

| Yes

| [[APT:PrepareToStartResidentApplet|PrepareToStartResidentApplet]]

Line 444: Line 505:

| 0x003A0044

|

+

| Yes

| [[APT:StartResidentApplet|StartResidentApplet]]

Line 449: Line 511:

| 0x003B0040

|

+

| Yes

| [[APT:CancelLibraryApplet|CancelLibraryApplet]]

Line 454: Line 517:

| 0x003C0042

|

+

| Yes

| [[APT:SendDspSleep|SendDspSleep]]

Line 459: Line 523:

| 0x003D0042

|

+

| Yes

| [[APT:SendDspWakeUp|SendDspWakeUp]]

Line 464: Line 529:

| 0x003E0080

|

+

| Yes

| [[APT:ReplySleepQuery|ReplySleepQuery]]

Line 469: Line 535:

| 0x003F0040

|

+

| Yes

| [[APT:ReplySleepNotificationComplete|ReplySleepNotificationComplete]]

Line 474: Line 541:

| 0x00400042

|

+

| Yes

| [[APT:SendCaptureBufferInfo|SendCaptureBufferInfo]]

Line 479: Line 547:

| 0x00410040

|

+

| Yes

| [[APT:ReceiveCaptureBufferInfo|ReceiveCaptureBufferInfo]]

Line 484: Line 553:

| 0x00420080

|

+

| Yes

| [[APT:SleepSystem|SleepSystem]]

Line 489: Line 559:

| 0x00430040

|

+

| Yes

| [[APT:NotifyToWait|NotifyToWait]]

Line 494: Line 565:

| 0x00440000

|

+

| Yes

| [[APT:GetSharedFont|GetSharedFont]]

Line 499: Line 571:

| 0x00450040

|

+

| Yes

| [[APT:GetWirelessRebootInfo|GetWirelessRebootInfo]]

Line 504: Line 577:

| 0x00460104

|

+

| Yes

| [[APT:Wrap|Wrap]]

Line 509: Line 583:

| 0x00470104

|

+

| Yes

| [[APT:Unwrap|Unwrap]]

Line 514: Line 589:

| 0x00480100

|

+

| No

| [[APT:GetProgramInfo|GetProgramInfo]]

Line 519: Line 595:

| 0x00490180

|

+

| No

| [[APT:Reboot|Reboot]]

Line 524: Line 601:

| 0x004A0040

|

+

| Yes

| [[APT:GetCaptureInfo|GetCaptureInfo]]

Line 529: Line 607:

| 0x004B00C2

|

+

| Yes

| [[APT:AppletUtility|AppletUtility]]

Line 534: Line 613:

| 0x004C0000

|

+

| Yes

| [[APT:SetFatalErrDispMode|SetFatalErrDispMode]]

Line 539: Line 619:

| 0x004D0080

|

+

| Yes

| [[APT:GetAppletProgramInfo|GetAppletProgramInfo]]

Line 544: Line 625:

| 0x004E0000

|

+

| Yes

| [[APT:HardwareResetAsync|HardwareResetAsync]]

Line 549: Line 631:

| 0x004F0080

| [[2.2.0-X]]

+

| Yes

| [[APT:SetApplicationCpuTimeLimit|SetApplicationCpuTimeLimit]]

Line 554: Line 637:

| 0x00500040

| [[2.2.0-X]]

+

| Yes

| [[APT:GetApplicationCpuTimeLimit|GetApplicationCpuTimeLimit]]

Line 559: Line 643:

| 0x00510080

| [[3.0.0-5]]

+

| Yes

| [[APT:GetStartupArgument|GetStartupArgument]]

Line 564: Line 649:

| 0x00520104

| [[4.0.0-7]]

+

| Yes

| [[APT:Wrap1|Wrap1]]

Line 569: Line 655:

| 0x00530104

| [[4.0.0-7]]

+

| Yes

| [[APT:Unwrap1|Unwrap1]]

Line 574: Line 661:

| 0x00540040

| [[5.0.0-11]]

−

| ?

+

| Yes

−

| ?

+

| Yes

+

| Takes an unknown parameter, outputs a result code and media type.

|-

| 0x00550040

| [[7.0.0-13]]

| Yes

−

| ~~This writes the input u8 to a NS state field.~~

+

| Yes

+

| [[APT:SetScreenCapturePostPermission|SetScreenCapturePostPermission]]

|-

| 0x00560000

| [[7.0.0-13]]

| Yes

−

| [[APT:~~GetScreencapPostPermission~~|~~GetScreencapPostPermission~~]]

+

| Yes

+

| [[APT:GetScreenCapturePostPermission|GetScreenCapturePostPermission]]

|-

| 0x00570044

| [[7.0.0-13]]

−

| ?

+

| Yes

+

| Yes

| [[APT:WakeupApplication2|WakeupApplication2]]

|-

| 0x00580002

| [[7.0.0-13]]

+

| Yes

| [[APT:GetProgramID|GetProgramID]]

Line 600: Line 692:

| [[8.0.0-18]]

| Yes

−

| [[APT:~~CheckNew3DSApp~~|~~CheckNew3DSApp~~]]

+

| Yes

+

| [[APT:GetTargetPlatform|GetTargetPlatform]]

|-

| 0x01020000

| [[8.0.0-18]]

+

| Yes

| [[APT:CheckNew3DS|CheckNew3DS]]

Line 610: Line 704:

| [[8.0.0-18]]

| Yes

−

| ~~This writes an output u8 to cmdreply~~[2]~~, the value is determined by checking various NS internal state + whether this is a New3DS.~~

+

| Yes

−

~~The normal output seems to be value 0x2. Forcing this value to 0x1 causes New3DS HID usage(via ir:USER) in Smash Bros to be disabled.~~

+

| [[APT:GetApplicationRunningMode|GetApplicationRunningMode]]

|-

| 0x01040000

| [[8.0.0-18]]

−

| ?

+

| Yes

+

| Yes

| [[APT:IsStandardMemoryLayout|IsStandardMemoryLayout]]

|-

| 0x01050100

| [[10.4.0-29]]

−

| ?

+

| Yes

+

| Yes

| [[APT:IsTitleAllowed|IsTitleAllowed]]

|}

Line 670: Line 766:

|-

| 4

−

| ~~FORAMT_R4G4B4A4~~

+

| FORMAT_R4G4B4A4

|-

| 0xFFFFFFFF

Line 821: Line 917:

| 17

| COMMAND_WAKEUP_TO_LAUNCH_APPLICATION

+

|-

+

| 0x41

+

| Unknown. [[APT:ReceiveParameter|Received]] by Home Menu during boot when the Home Menu process doesn't terminate properly(svcExitProcess/crash).

|}

Line 975: Line 1,074:

This is [[NSS:SetWirelessRebootInfo|setup]] by the dlplay system-application, before launching the DLP-child which can then use [[APT:GetWirelessRebootInfo]]. The MAC address and passphrase is used for connecting to the host by the DLP-child. See also [[DLP_Services|here]].

+

="APT:A" Service=

−

This was added with [[7.0.0-13|7.0.0-X]]. Official apps built with the CTRSDK for system-version >=[[7.0.0-13|7.0.0-X]] normally use the "APT:A" service instead of "APT:U". Those processes also have "APT:A" instead of "APT:U" in the service-access-control. ~~It's unknown whether there's anything which is only accessible via "~~APT:A".

+

This was added with [[7.0.0-13|7.0.0-X]]. Official apps built with the CTRSDK for system-version >=[[7.0.0-13|7.0.0-X]] normally use the "APT:A" service instead of "APT:U". Those processes also have "APT:A" instead of "APT:U" in the service-access-control. Unlike APT:U, APT:A can call [[APT:GetAppletInfo]] with applet ID 0x300.

=Applets=

Line 998: Line 1,098:

|-

| 0x101

−

| Home Menu (menu)

+

| [[Home Menu]] (menu)

|-

| 0x103

Line 1,004: Line 1,104:

|-

| 0x110

−

| Camera applet (CtrApp)

+

| Camera applet ([[Camera Applet|CtrApp]])

|-

| 0x112

−

| Friends List applet (friend)

+

| Friends List applet ([[Friend List|friend]])

|-

| 0x113

Line 1,019: Line 1,119:

|-

| 0x116

−

| Notifications applet (newslist)

+

| [[Notifications]] applet (newslist)

|-

| 0x117

Line 1,025: Line 1,125:

|-

| 0x118

−

| Miiverse posting applet (solv3)

+

| [[Miiverse]] posting applet (solv3)

|-

| 0x119

Line 1,034: Line 1,134:

|-

| 0x202

−

| Mii Selector (appletEd) (?)

+

| [[Mii Selector]] (appletEd) (?)

|-

| 0x204

Line 1,043: Line 1,143:

|-

| 0x206

−

| Error Display (error) (?)

+

| Error Display ([[ErrDisp|error]]) (?)

|-

| 0x207

−

| eShop applet (mint) (?)

+

| eShop applet ([[EShop#NS_eShop_application_parameters|mint]]) (?)

|-

| 0x208

Line 1,115: Line 1,215:

Note that at some point the total AppID entry count was changed from 28 to 27.

+

[[Category:Services]]

ElementW

164

edits

Changes

NS and APT Services (edit)

Revision as of 14:42, 18 September 2024