NS and APT Services: Difference between revisions

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.

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"

| 0x00060042

| [[1.0.0-0]] - [[2.0.0-2]]

|-

| 0x00070042

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

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

|-

|-

| 0x00010040

|-

| 0x00020000

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"=

=APT Services=

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

!  Available since system version

!  Accessible with APT:U

!  Description

|-

| 0x00010040

|  

| Yes

| [[APT:GetLockHandle|GetLockHandle]]

| 0x00020080

|  

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

| [[APT:Initialize|Initialize]]

| 0x00030040

|  

| Yes

| [[APT:Enable|Enable]]

| 0x00040040

|  

| Yes

| [[APT:Finalize|Finalize]]

| 0x00050040

|  

| Yes

| [[APT:GetAppletManInfo|GetAppletManInfo]]

| 0x00060040

|  

| Yes

| [[APT:GetAppletInfo|GetAppletInfo]]

| 0x00070000

|  

| Yes

| [[APT:GetLastSignaledAppletId|GetLastSignaledAppletId]]

| 0x00080000

|  

| Yes

| [[APT:CountRegisteredApplet|CountRegisteredApplet]]

| 0x00090040

|  

| Yes

| [[APT:IsRegistered|IsRegistered]]

| 0x000A0040

|  

| Yes

| [[APT:GetAttribute|GetAttribute]]

| 0x000B0040

|  

| Yes

| [[APT:InquireNotification|InquireNotification]]

| 0x000C0104

|  

| Yes

| [[APT:SendParameter|SendParameter]]

| 0x000D0080

|  

| Yes

| [[APT:ReceiveParameter|ReceiveParameter]]

| 0x000E0080

|  

| Yes

| [[APT:GlanceParameter|GlanceParameter]]

| 0x000F0100

|  

| Yes

| [[APT:CancelParameter|CancelParameter]]

| 0x001000C2

|  

| Yes

| [[APT:DebugFunc|DebugFunc]]

| 0x001100C0

|  

| Yes

| [[APT:MapProgramIdForDebug|MapProgramIdForDebug]]

| 0x00120040

|  

| Yes

| [[APT:SetHomeMenuAppletIdForDebug|SetHomeMenuAppletIdForDebug]]

| 0x00130000

|  

| Yes

| [[APT:GetPreparationState|GetPreparationState]]

| 0x00140040

|  

| Yes

| [[APT:SetPreparationState|SetPreparationState]]

| 0x00150140

|  

| No

| [[APT:PrepareToStartApplication|PrepareToStartApplication]]

| 0x00160040

|  

| Yes

| [[APT:PreloadLibraryApplet|PreloadLibraryApplet]]

| 0x00170040

|  

| Yes

| [[APT:FinishPreloadingLibraryApplet|FinishPreloadingLibraryApplet]]

| 0x00180040

|  

| Yes

| [[APT:PrepareToStartLibraryApplet|PrepareToStartLibraryApplet]]

| 0x00190040

|  

| Yes

| [[APT:PrepareToStartSystemApplet|PrepareToStartSystemApplet]]

| 0x001A0000

|  

| Yes

| [[APT:PrepareToStartNewestHomeMenu|PrepareToStartNewestHomeMenu]]

| 0x001B00C4

|  

| Yes

| [[APT:StartApplication|StartApplication]]

| 0x001C0000

|  

| Yes

| [[APT:WakeupApplication|WakeupApplication]]

| 0x001D0000

|  

| Yes

| [[APT:CancelApplication|CancelApplication]]

| 0x001E0084

|  

| Yes

| [[APT:StartLibraryApplet|StartLibraryApplet]]

| 0x001F0084

|  

| Yes

| [[APT:StartSystemApplet|StartSystemApplet]]

| 0x00200044

|  

| Yes

| [[APT:StartNewestHomeMenu|StartNewestHomeMenu]]

| 0x00210000

|  

| No

| [[APT:OrderToCloseApplication|OrderToCloseApplication]]

| 0x00220040

|  

| Yes

| [[APT:PrepareToCloseApplication|PrepareToCloseApplication]]

| 0x00230040

|  

| Yes

| [[APT:PrepareToJumpToApplication|PrepareToJumpToApplication]]

| 0x00240044

|  

| Yes

| [[APT:JumpToApplication|JumpToApplication]]

| 0x002500C0

|  

| Yes

| [[APT:PrepareToCloseLibraryApplet|PrepareToCloseLibraryApplet]]

| 0x00260000

|  

| Yes

| [[APT:PrepareToCloseSystemApplet|PrepareToCloseSystemApplet]]

| 0x00270044

|  

| Yes

| [[APT:CloseApplication|CloseApplication]]

| 0x00280044

|  

| Yes

| [[APT:CloseLibraryApplet|CloseLibraryApplet]]

| 0x00290044

|  

| Yes

| [[APT:CloseSystemApplet|CloseSystemApplet]]

| 0x002A0000

|  

| Yes

| [[APT:OrderToCloseSystemApplet|OrderToCloseSystemApplet]]

| 0x002B0000

|  

| Yes

| [[APT:PrepareToJumpToHomeMenu|PrepareToJumpToHomeMenu]]

| 0x002C0044

|  

| Yes

| [[APT:JumpToHomeMenu|JumpToHomeMenu]]

| 0x002D0000

|  

| Yes

| [[APT:PrepareToLeaveHomeMenu|PrepareToLeaveHomeMenu]]

| 0x002E0044

|  

| Yes

| [[APT:LeaveHomeMenu|LeaveHomeMenu]]

| 0x002F0040

|  

| Yes

| [[APT:PrepareToLeaveResidentApplet|PrepareToLeaveResidentApplet]]

| 0x00300044

|  

| Yes

| [[APT:LeaveResidentApplet|LeaveResidentApplet]]

| 0x00310100

|  

| Yes

| [[APT:PrepareToDoApplicationJump|PrepareToDoApplicationJump]]

| 0x00320084

|  

| Yes

| [[APT:DoApplicationJump|DoApplicationJump]]

| 0x00330000

|  

| Yes

| [[APT:GetProgramIdOnApplicationJump|GetProgramIdOnApplicationJump]]

| 0x00340084

|  

| Yes

| [[APT:SendDeliverArg|SendDeliverArg]]

| 0x00350080

|  

| Yes

| [[APT:ReceiveDeliverArg|ReceiveDeliverArg]]

| 0x00360040

|  

| Yes

| [[APT:LoadSysMenuArg|LoadSysMenuArg]]

| 0x00370042

|  

| Yes

| [[APT:StoreSysMenuArg|StoreSysMenuArg]]

| 0x00380040

|  

| Yes

| [[APT:PreloadResidentApplet|PreloadResidentApplet]]

| 0x00390040

|  

| Yes

| [[APT:PrepareToStartResidentApplet|PrepareToStartResidentApplet]]

| 0x003A0044

|  

| Yes

| [[APT:StartResidentApplet|StartResidentApplet]]

| 0x003B0040

|  

| Yes

| [[APT:CancelLibraryApplet|CancelLibraryApplet]]

| 0x003C0042

|  

| Yes

| [[APT:SendDspSleep|SendDspSleep]]

| 0x003D0042

|  

| Yes

| [[APT:SendDspWakeUp|SendDspWakeUp]]

| 0x003E0080

|  

| Yes

| [[APT:ReplySleepQuery|ReplySleepQuery]]

| 0x003F0040

|  

| Yes

| [[APT:ReplySleepNotificationComplete|ReplySleepNotificationComplete]]

| 0x00400042

|  

| Yes

| [[APT:SendCaptureBufferInfo|SendCaptureBufferInfo]]

| 0x00410040

|  

| Yes

| [[APT:ReceiveCaptureBufferInfo|ReceiveCaptureBufferInfo]]

| 0x00420080

|  

| Yes

| [[APT:SleepSystem|SleepSystem]]

| 0x00430040

|  

| Yes

| [[APT:NotifyToWait|NotifyToWait]]

| 0x00440000

|  

| Yes

| [[APT:GetSharedFont|GetSharedFont]]

| 0x00450040

|  

| Yes

| [[APT:GetWirelessRebootInfo|GetWirelessRebootInfo]]

| 0x00460104

|  

| Yes

| [[APT:Wrap|Wrap]]

| 0x00470104

|  

| Yes

| [[APT:Unwrap|Unwrap]]

| 0x00480100

|  

| No

| [[APT:GetProgramInfo|GetProgramInfo]]

| 0x00490180

|  

| No

| [[APT:Reboot|Reboot]]

| 0x004A0040

|  

| Yes

| [[APT:GetCaptureInfo|GetCaptureInfo]]

| 0x004B00C2

|  

| Yes

| [[APT:AppletUtility|AppletUtility]]

| 0x004C0000

|  

| Yes

| [[APT:SetFatalErrDispMode|SetFatalErrDispMode]]

| 0x004D0080

|  

| Yes

| [[APT:GetAppletProgramInfo|GetAppletProgramInfo]]

| 0x004E0000

|  

| Yes

| [[APT:HardwareResetAsync|HardwareResetAsync]]

| 0x004F0080

| [[2.2.0-X]]

| Yes

| [[APT:SetApplicationCpuTimeLimit|SetApplicationCpuTimeLimit]]

| 0x00500040

| [[2.2.0-X]]

| Yes

| [[APT:GetApplicationCpuTimeLimit|GetApplicationCpuTimeLimit]]

| 0x00510080

| [[3.0.0-5]]

| Yes

| [[APT:GetStartupArgument|GetStartupArgument]]

| 0x00520104

| [[4.0.0-7]]

| Yes

| [[APT:Wrap1|Wrap1]]

| 0x00530104

| [[4.0.0-7]]

| Yes

| [[APT:Unwrap1|Unwrap1]]

| 0x00540040

| [[5.0.0-11]]

|-

| 0x00550040

| [[7.0.0-13]]

| Yes

|-

| 0x00560000

| [[7.0.0-13]]

| Yes

|-

| 0x00570044

| [[7.0.0-13]]

|-

| 0x00580002

| [[7.0.0-13]]

| Yes

| [[APT:GetProgramID|GetProgramID]]

| [[8.0.0-18]]

| Yes

|-

| 0x01020000

| [[8.0.0-18]]

| Yes

| [[APT:CheckNew3DS|CheckNew3DS]]

| [[8.0.0-18]]

| Yes

|-

| 0x01040000

| [[8.0.0-18]]

| [[APT:IsStandardMemoryLayout|IsStandardMemoryLayout]]

|-

| 0x01050100

| [[10.4.0-29]]

| [[APT:IsTitleAllowed|IsTitleAllowed]]

|}

|-

| 4

|-

| 0xFFFFFFFF

| 17

| COMMAND_WAKEUP_TO_LAUNCH_APPLICATION

|}

|}

="APT:A" Service=

=Applets=

|-

| 0x101

|-

| 0x103

|-

| 0x110

|-

| 0x112

|-

| 0x113

|-

| 0x116

|-

| 0x117

|-

| 0x118

|-

| 0x119

|-

| 0x202

|-

| 0x204

|-

| 0x206

|-

| 0x207

|-

| 0x208

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