NS and APT Services - Revision history

ElementW: Add anchors

2024-09-18T10:42:20Z

Add anchors

← Older revision		Revision as of 14:42, 18 September 2024
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.		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 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]].

			{{Anchor\|NSS}}{{Anchor\|ns:s}}
	= NS Service "ns:s" =		= NS Service "ns:s" =
	{\| class="wikitable" border="1"		{\| 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.		The maximum sessions that can be used with this service is two, therefore only two processes can use this service at the same time.

			{{Anchor\|NSP}}{{Anchor\|ns:p}}
	=NS Power Service "ns:p"=		=NS Power Service "ns:p"=
	{\| class="wikitable" border="1"		{\| 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.		This was added with [[3.0.0-5]]. The PTM sysmodule connects to this service, and syncs whenever [[PTM\|ptm:s GetShellState()]] changes.

			{{Anchor\|NSC}}{{Anchor\|ns:c}}
	=NS Service "ns:c"=		=NS Service "ns:c"=
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 149:		Line 151:
	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.		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.

			{{Anchor\|APT}}{{Anchor\|APTU}}{{Anchor\|APT:U}}{{Anchor\|APTS}}{{Anchor\|APT:S}}
	=APT Services=		=APT Services=
	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 1,071:		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]].		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]].

			{{Anchor\|APTA}}{{Anchor\|APT:A}}
	="APT:A" Service=		="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. Unlike APT:U, APT:A can call [[APT:GetAppletInfo]] with applet ID 0x300.		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.
Line 1,211:		Line 1,215:

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

			[[Category:Services]]

Steveice10: /* "APT:A" Service */

2023-07-23T20:37:55Z

"APT:A" Service

← Older revision		Revision as of 00:37, 24 July 2023
Line 1,072:		Line 1,072:

	="APT:A" Service=		="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=		=Applets=

Steveice10: /* APT Services */

2023-07-23T20:36:34Z

APT Services

← Older revision		Revision as of 00:36, 24 July 2023
Line 660:		Line 660:
	\| Yes		\| Yes
	\| Yes		\| Yes
	\| ?		\| Takes an unknown parameter, outputs a result code and media type.
	\|-		\|-
	\| 0x00550040		\| 0x00550040

Steveice10: /* APT Services */

2023-07-23T20:30:58Z

APT Services

Show changes

Steveice10: /* APT Services */

2023-07-23T20:28:33Z

APT Services

← Older revision		Revision as of 00:28, 24 July 2023
Line 154:		Line 154:
	! Command Header		! Command Header
	! Available since system version		! Available since system version
	! Accessible with APT:U		! Accessible with APT:U / APT:A
	! Description		! Description
	\|-		\|-
Line 184:		Line 184:
	\| 0x00060040		\| 0x00060040
	\|		\|
	\| Yes, ~~for~~ AppID != 0x300		\| Yes, unless using APT:U and AppID == 0x300
	\| [[APT:GetAppletInfo\|GetAppletInfo]]		\| [[APT:GetAppletInfo\|GetAppletInfo]]
	\|-		\|-

Steveice10: /* APT Services */

2023-07-23T06:27:17Z

APT Services

← Older revision		Revision as of 10:27, 23 July 2023
Line 580:		Line 580:
	\| [[7.0.0-13]]		\| [[7.0.0-13]]
	\| Yes		\| Yes
	\| [[APT:~~SetScreencapPostPermission~~\|~~SetScreencapPostPermission~~]]		\| [[APT:SetScreenCapturePostPermission\|SetScreenCapturePostPermission]]
	\|-		\|-
	\| 0x00560000		\| 0x00560000
	\| [[7.0.0-13]]		\| [[7.0.0-13]]
	\| Yes		\| Yes
	\| [[APT:~~GetScreencapPostPermission~~\|~~GetScreencapPostPermission~~]]		\| [[APT:GetScreenCapturePostPermission\|GetScreenCapturePostPermission]]
	\|-		\|-
	\| 0x00570044		\| 0x00570044

Steveice10: Two commands from FE Fates

2023-07-23T05:19:38Z

Two commands from FE Fates

← Older revision		Revision as of 09:19, 23 July 2023
Line 600:		Line 600:
	\| [[8.0.0-18]]		\| [[8.0.0-18]]
	\| Yes		\| Yes
	\| [[APT:~~CheckNew3DSApp~~\|~~CheckNew3DSApp~~]]		\| [[APT:GetTargetPlatform\|GetTargetPlatform]]
	\|-		\|-
	\| 0x01020000		\| 0x01020000
Line 610:		Line 610:
	\| [[8.0.0-18]]		\| [[8.0.0-18]]
	\| Yes		\| Yes
	\| ~~This writes an output u8 to cmdreply~~[2]~~, the value is determined by checking various NS internal state + whether this is a New3DS.~~		\| [[APT:GetApplicationRunningMode\|GetApplicationRunningMode]]
	~~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.~~
	\|-		\|-
	\| 0x01040000		\| 0x01040000

Steveice10: /* NS Service "ns:c" */

2023-04-02T16:33:02Z

NS Service "ns:c"

← Older revision		Revision as of 20:33, 2 April 2023
Line 141:		Line 141:
	\|-		\|-
	\| 0x00010100		\| 0x00010100
	\| ?		\| [[NSC:LockSpecialContent\|LockSpecialContent]]
	\|-		\|-
	\| 0x00020100		\| 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.

	~~Both functions take a [[Filesystem_services#MediaType\|MediaType]], Title ID~~, and ~~[[Filesystem_services#SpecialContentType\|SpecialContentType]] as inputs. Command 1 does update title~~ related ~~checks, stores~~ the ~~info in a structure, and increments counters based on~~ media ~~types. Command 2 checks~~ the stored ~~data against the provided parameters, and clears data from the structure and decrements counters if they match. Both call (as of writing) unknown FS commands in the 0x870 range~~.

	=APT Services=		=APT Services=

Steveice10: /* NS Service "ns:c" */

2023-04-02T16:08:03Z

NS Service "ns:c"

← Older revision		Revision as of 20:08, 2 April 2023
Line 149:		Line 149:
	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's unknown what this is used for.

	Both functions take a [[MediaType\|~~Filesystem_services#~~MediaType]], Title ID, and [[SpecialContentType\|~~Filesystem_services#~~SpecialContentType]] as inputs. Command 1 does update title related checks, stores the info in a structure, and increments counters based on media types. Command 2 checks the stored data against the provided parameters, and clears data from the structure and decrements counters if they match. Both call (as of writing) unknown FS commands in the 0x870 range.		Both functions take a [[Filesystem_services#MediaType\|MediaType]], Title ID, and [[Filesystem_services#SpecialContentType\|SpecialContentType]] as inputs. Command 1 does update title related checks, stores the info in a structure, and increments counters based on media types. Command 2 checks the stored data against the provided parameters, and clears data from the structure and decrements counters if they match. Both call (as of writing) unknown FS commands in the 0x870 range.

	=APT Services=		=APT Services=

Steveice10: /* NS Service "ns:c" */

2023-04-02T16:07:45Z

NS Service "ns:c"

← Older revision		Revision as of 20:07, 2 April 2023
Line 148:		Line 148:

	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's unknown what this is used for.

			Both functions take a [[MediaType\|Filesystem_services#MediaType]], Title ID, and [[SpecialContentType\|Filesystem_services#SpecialContentType]] as inputs. Command 1 does update title related checks, stores the info in a structure, and increments counters based on media types. Command 2 checks the stored data against the provided parameters, and clears data from the structure and decrements counters if they match. Both call (as of writing) unknown FS commands in the 0x870 range.

	=APT Services=		=APT Services=