Nintendo Switch Brew - User contributions [en]

Main Page/OtherSites

2025-05-29T20:18:21Z

Mha:

{{Main page box|Other Nintendo Homebrew Sites|:OtherSites}}
<div style="margin: -.3em -1em -1em -1em;">
{| width="100%" bgcolor="#fff" border="0" cellpadding="2px" cellspacing="2px" style="margin:auto;"
|- valign="top" align="center" style="background: #F5FAFF;"
| [https://wiibrew.org WiiBrew] {{·}} [https://wiiubrew.org WiiUBrew] {{·}} [https://dsibrew.org DSiBrew] {{·}} [https://www.3dbrew.org 3DBrew] {{·}} [https://switchbrew.org SwitchBrew] {{·}} [https://switch2brew.org Switch2Brew] {{·}} [http://iquebrew.org iQueBrew]

|}
</div>
{{box-footer-empty}}

Template:·

2025-05-29T20:17:40Z

Mha: Created page with "<includeonly><span style="font-weight:bold;"> ·</span> </includeonly><noinclude> {{Documentation}}  </noinclude>"

<includeonly><span style="font-weight:bold;"> ·</span> </includeonly><noinclude>
{{Documentation}}

</noinclude>

Main Page/OtherSites

2025-05-29T20:16:54Z

Mha:

{{Main page box|Other Nintendo Homebrew Sites|:OtherSites}}
<div style="margin: -.3em -1em -1em -1em;">
{| width="100%" bgcolor="#fff" border="0" cellpadding="2px" cellspacing="2px" style="margin:auto;"
|- valign="top" align="left" style="background: #F5FAFF;"
| [https://wiibrew.org WiiBrew] {{·}} [https://wiiubrew.org WiiUBrew] {{·}} [https://dsibrew.org DSiBrew] {{·}} [https://www.3dbrew.org 3DBrew] {{·}} [https://switchbrew.org SwitchBrew] {{·}} [https://switch2brew.org Switch2Brew] {{·}} [http://iquebrew.org iQueBrew]

|}
</div>
{{box-footer-empty}}

MediaWiki:Cookiewarning-ok-label

2022-06-07T20:32:43Z

Mha: Created page with "I CONSENT"

I CONSENT

MediaWiki:Cookiewarning-info

2022-06-07T20:31:29Z

Mha: Created page with "By entering this site you need to consent to the use of cookies and their functional use according to this privacy policy. Cookies help us to provide the functional services o..."

By entering this site you need to consent to the use of cookies and their functional use according to this privacy policy. Cookies help us to provide the functional services of the website. Kindly read the below message of use and consent to the use.

The following cookies are stored and shared when accessing this website:
- Internal cookies for the MediaWiki site. This is used for user authentication and article modifications.
- Third-party cookies from Google providing services for Google AdSense and Google Analytics

We will never use data collected outside of the above scope.

FirmwareNews

2020-01-04T12:56:18Z

Mha:

As of this writing, the latest firmware is '''[[9.1.0]]'''.

See [[Version Table]].

FirmwareNews

2020-01-04T12:56:11Z

Mha:

As of this writing, the latest firmware is '''[[9.1.0]]'''.

See [[Version Table]].

Test

2.1.0

2019-12-29T14:54:47Z

Mha:

The 2.1.0 system update was released on March 27, 2017. This update was released for all regions.

Security flaws fixed: yes.

==Change-log==
This is the [http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 official changelog] from Nintendo regarding this update:

'''Improvements Included in Version 2.1.0'''
*General system stability improvements to enhance the user's experience

==System Titles==
Exactly the following [[Title_list|titles]] were updated:
* The following sysmodules were updated:
** nifm
** ptm
** hid
** wlan
** nvservices
** nvnflinger
** ns
** am
** nim
** erpt
** pctl
** eupld
** fatal
** creport (See [[Creport|here]] for changes)
* The only updated 01000000000008XX titles are: [[Internet_Browser|shareddata]], 0100000000000816, FIRM-packages(see below), and [[System_Version_Title]].
* The only updated 01000000000010XX titles are: "System applet"(qlaunch), 0100000000001008, 010000000000100A, [[Internet_Browser|ShopN]], 010000000000100F, [[Internet_Browser|Whitelisted-applet]], and [[Internet_Browser|WifiWebAuthApplet]].

===[[Internet_Browser|Browser]]===
A browser vuln was [[Switch_Userland_Flaws|fixed]], see also [[Internet_Browser|here]] for v2.1 browser details.

===[[Title_list|FIRM]] Packages===
The only changes in titles 0100000000000819 and 010000000000081A was that "/nx/package2" in the FS were updated. 010000000000081B firm was also updated.

819:

Kernel was not changed.

Sysmodules:
* All 3 codebin sections in the following sysmodules were updated: boot, FS, Loader, and NCM. Offset of the RW section for FS increased by 0x1000.
* For ProcessMana and sm, only the RO section changed. The only change was the builid hash at the very end of the section, following the "GNU" string.
* spl wasn't updated.
** Loader: Only changes in .text was a rebuild with latest SDK, now has the same additional IPC cmd code as NS(see below).
** boot: .text now has latest SDK changes + various other changes.

====FS-module====
There were two changes with [[Filesystem_services#IDeviceOperator|IDeviceOperator]] commands:
* Code eventually executed for cmd216 was updated. Instead of directly writing to the output struct which is then copied to final output later, a tmpbuf is used which is then copied to the output struct. The 0x10-byte output struct is cleared at the start, and the only u16s copied to output struct from tmpbuf when successful are: +0, +4, +8, +14, and +12.
* New command 217 was [[Filesystem_services#IDeviceOperator|added]].
* See also below SDK section.

Rest of the changes:
* HFS0 error handling was updated.
* The error returned in one case for a certain func was changed.
* Code was moved into a separate func, which is now called by the func which was using that code. Similar-ish code in a different func was removed.
* A certain func no longer writes an error to stack.
* Various memwrite/memclear changes.
* Various u16 counters are now incremented in some cases.
* In a certain func an u32 field is now incremented at _this+16 in some cases.
* Minor other change(s).

===SDK===
Every system-title with this system-version which uses FS now has IPC code for using the new IDeviceOperator cmd, including FS-module itself.

===[[qlaunch]]===
...

RomFS:
* "/message/{dirname}/option.msbt.szs": Updated
* "/message/{dirname}/setting.msbt.szs": Updated

diff --git a/{...}/0100000000001000/v65796/message_USen_option.msbt.szs.decom_wstrs b/{...}/0100000000001000/v131162/message_USen_option.msbt.szs.decom_wstrs
index 53fe4b3..3a97770 100644
--- a/{...}/0100000000001000/v65796/message_USen_option.msbt.szs.decom_wstrs
+++ b/{...}/0100000000001000/v131162/message_USen_option.msbt.szs.decom_wstrs
@@ -20,7 +20,7 @@ Archive Software
Data for this software will be deleted to free storage space. After this, only save data and the icon on the HOME Menu will remain.
Data for this software will be deleted to free storage space. After this, only save data and the icon on the HOME Menu will remain. You can redownload the data to use the software again.
Delete Software
-The software and icon on the HOME Menu will be deleted. You can redownload the software from Nintendo eShop. Remaining user data can be deleted from Manage Save Data/Screenshots in Data Management.
+Save data will not be deleted.
This software will now be deleted.
Deleted software and downloadable content can be redownloaded from Nintendo eShop.
The software icon will be removed from

diff --git a/{...}/0100000000001000/v65796/message_USen_setting.msbt.szs.decom_wstrs b/{...}/0100000000001000/v131162/message_USen_setting.msbt.szs.decom_wstrs
index e0a50f7..d419d95 100644
--- a/{...}/0100000000001000/v65796/message_USen_setting.msbt.szs.decom_wstrs
+++ b/{...}/0100000000001000/v131162/message_USen_setting.msbt.szs.decom_wstrs
@@ -123,7 +123,8 @@ Check for Corrupt Data
Archive Software
The software will be deleted to free storage space. You can redownload the software by selecting the icon on the HOME Menu. Remaining user data can be deleted from Manage Save Data/Screenshots in Data Management.
Delete Software
-The software and icon on the HOME Menu will be deleted. You can redownload the software from Nintendo eShop. Remaining user data can be deleted from Manage Save Data/Screenshots in Data Management.
+The software and icon on the HOME Menu will be deleted to manage storage space. Digital software can be redownloaded from the Nintendo eShop. Other user data for the game, such as save data or screenshots, will not be deleted and can be managed in System Settings
+ Data Management.
Archive
Archive this software?
Only the software icon on the HOME Menu will remain. You can use the software again by redownloading the data.

=== Application crashes ===
As documented [[Creport|here]], a fatal-error is no longer thrown when applications crash. Instead, [[qlaunch]] displays an error message, without requiring a reboot. It appears [[2.0.0]] qlaunch already had the message string for this, which is: "The software was closed because an error occurred."

===erpt===
...

The following strings were added to the codebin: "GameCardInsertionCount", "GameCardRemovalCount", and "GameCardAsicInitializeCount".

===[[NV_services|nvservices]]-sysmodule===
Only 1 func was changed: L_30f20, which is at L_30f20 in prev ver.

Strings containing paths were changed. For example, "'''D:/Home/teamcity/work/hr'''/3rdparty/hos-ddk-minimal/ddk/Programs/Chris/Include\nn/spl/spl_Api.h" is now "'''C:/dvs/git/dirty/git-master_hos'''/3rdparty/hos-ddk-minimal/ddk/Programs/Chris/Include\nn/spl/spl_Api.h".

Also, "'''D:/Home/teamcity/work/hr'''/hos/services/src/libs/nnmem/mem_StandardAllocator.cpp" is now "'''C:/dvs/git/dirty/git-master_hos'''/hos/services/src/libs/nnmem/mem_StandardAllocator.cpp", etc.

===[[NS_Services|NS]]-sysmodule===
The NS-sysmodule was updated. 4 new funcs were added and 29 funcs were updated.

The ASLR'd codebin base(rtld+0) for the below addrs is 0x6f0c00000. For "prev ver" it's 0x5381800000.

L_6f0c26f84
new func.
called via vtable funcptr.
return L_6f0c2814c(inx0+8, inx1, w2=0xd9) & 0xffffffff;

L_6f0c2814c
inx0=_this inx1=0x40-byte outbuf copied from cmdreply inw2=cmdid
new func.
Sends an ipc cmd, service unknown.
only called by L_6f0c26f84.

L_6f0c373f4
updated, prev ver @ L_5381837284.
For the func call executed from the first branch(L_6f0c377e8()), x1 and x2 are now set: x1 = *(0x6f0d9d000+0xfc0)+0x90, x2 = 0x6f0d44000+0xb36("ncm")

L_6f0c377e8
updated, prev ver @ L_5381837640.
Basically, instead of hard-coded inputs for various stuff, code now loads those using the additional input params.

L_6f0c378b4
updated, prev ver @ L_538183771c.
ipc related func.
After the first func call, instead of "if(inx0==0 || ret^1)return;" this now just does "if(ret==0)return;" and "objptr = *(inx0+32);" afterwards.
The code at the end was replaced with code for calling a vtable funcptr from the objptr.

L_6f0c379fc
updated, prev ver @ L_5381837874.
Instead of writing 0 to sp8, this now writes *(inx0+32) there.

L_6f0c37a94
updated, prev ver @ L_5381837904.
Same change as L_6f0c379fc.

L_6f0c37bf8
updated, prev ver @ L_5381837a60.
Loads stuff from input instead of hard-coding basically.

{3 funcs with same changes as elsewhere}

L_6f0c3a5f8
updated, prev ver @ L_538183a480.
Calls a different func and calls another func.

L_6f0c3b644
updated, prev ver @ L_538183b494.
Error-related(?) code changed.

L_6f0c400dc
updated, prev ver @ L_538183ff24.
A bunch of func calls were added after the bne.

L_6f0c47590
updated, prev ver @ L_5381847394.
An additional check was added at 6f0c47748.
Some code at the end of the func was adjusted.

L_6f0c49848
updated, prev ver @ L_5381849650.
Some sort of error(?) parsing func.

L_6f0c51f44
updated, prev ver @ L_5381851d2c.
w7 passed to L_6f0c3a83c() with both calls is now value 7 instead of 0.
This also now calls L_6f0c3af70() when the retval from the previous func-call is zero.

{3 error(?) parsing funcs which were updated}

L_6f0c593ac
updated, prev ver @ L_5381859114.
Code was added inbetween the last func-call and the memwrite after that.

L_6f0c5a528
updated, prev ver @ L_538185a254
Code was added at 0x6f0c5a6d4(prev 0x538185a400): L_6f0c67938(inx0+0xf0, 0, 0); u8 *(inx0+0x110) = 0;

L_6f0c60d60
updated, prev ver @ L_5381860a78.
Updated for the additional argument passed to [[creport]].
Code was updated starting at 0x6f0c61190(prev 0x5381860ea8). An additional param is passed to the snprintf call as well.
Some code was added at the end before the last branch.

L_6f0c61ebc
updated, prev ver @ L_5381861b5c.
Code was added at 0x6f0c61f24(prev 0x5381861bc4).

L_6f0cf7914
new func.
called via vtable funcptr.

L_6f0cf7948
new func.
called via vtable funcptr.

L_6f0cf7d24
updated, prev ver @ L_53818f7940.
Code was added at 0x6f0cf7ec4(prev 0x53818f7b00). "L_6f0c6798c(x21); w28 = u8 *(x19+0xf0); L_6f0c67a78(x21); <branch if w28!=0> if(u16 *(x26+16) <= x22)<branch to assert>"
The code at 0x6f0cf7fac(prev 0x53818f7bc8) now sets w8 to 0x15 instead of 0x13(likewise for the same instruction after the branch).
...

L_6f0cf8190
updated, prev ver @ L_53818f7d2c.
Some flag is determined differently now.

L_6f0cf92d8
updated, prev ver @ L_53818f8e7c.
Added a call to L_6f0c67984 after the memwrite.

{3 funcs with the same changes as L_6f0cf92d8}

{{NavboxVersions}}

2.1.0

2019-12-29T14:54:38Z

Mha:

9.1.0

2019-12-28T17:28:09Z

Mha:

The Switch 9.1.0 system update was released on December 4, 2019. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[https://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/kw/nintendo%20switch%20system%20update Official] ALL change-log:
* General system stability improvements to enhance the user's experience, including a solution for the following:
*
* Resolved an issue where the color animation was not displaying correctly when attaching a Joy-Con controller to the Nintendo Switch console.
*

See the [https://www.nintendoswitch.com.cn/support/system_update/index.html official] China changelog for the China-specific changelog.

===BootImagePackage===
All files in RomFS were updated.

====Secure Monitor====
Secure Monitor was updated.

* System register configuration now sets CPUACTLR_EL1.
** This sets CPUACTLR_EL1 to the same value as in [[Kernel_Loader#KernelLdr_MapInitialIdentityMapping|KernelLdr]], previously this code only configured CPUECTLR_EL1.

====Warmboot====
* The firmware revision magic was changed from 0x16B to 0x18C.

<check back for more diffs later>

====FIRM Sysmodules====
FIRM sysmodules were updated. Specific diffs available below:

=====[[Filesystem services|FS]]=====
The only difference is that nn::crypto::VerifyRsa2048PssSha256 now memsets the decrypted signature buffer to zero after extracting the hash.

=====[[Loader services|Loader]]=====
The only difference besides GNU build hash update is that the Anti-Downgrade arrays were updated to the new title versions.

==System Titles==
The following was updated:
* All applets.
* Sysmodules: [[BCAT_services|bcat]], [[Friend_services|friends]], [[Network_Interface_services|nifm]], [[Sockets_services|bsdsockets]], [[HID_services|hid]], [[WLAN_services|wlan]], [[LDN_services|ldn]], [[Account_services|account]], [[NS_Services|ns]], [[NFC_services|nfc]], [[Applet_Manager_services|am]], [[NIM_services|nim]], [[Error_Report_services|erpt]], [[creport]], [[RO_services|ro]], [[Migration_services|migration]], [[OLSC_services|olsc]], and [[NGCT_services|ngct]].
* SystemData (besides the sysver SystemData): ErrorMessage, BrowserDll, Help, SharedFont, LocalNews, Eula, FirmwareDebugSettings, all BootImagePackages, PlatformConfigIcosa, PlatformConfigCopper, PlatformConfigHoag, PlatformConfigIcosaMariko, and NgWordT.

See [[Services_API]] for the new lp2p:m service.

NPDM changes:
* migration: Now has access to srepo:u.
* The following now have access to the new lp2p:m service: qlaunch, LibraryAppletCabinet, LibraryAppletController, LibraryAppletNetConnect, LibraryAppletPlayerSelect, LibraryAppletMiiEdit, all web-applets except for LibraryAppletOfflineWeb, OverlayApplet, and LibraryAppletMyPage.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=12-04-19_07-05-11&sys=hac]

{{NavboxVersions}}

[[Category:System versions]]

9.1.0

2019-12-28T17:25:52Z

Mha:

3.0.1

2019-12-28T17:17:21Z

Mha:

The Switch 3.0.1 system update was released on July 31, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''General system stability improvements to enhance the user's experience, including:'''
* Addressed an issue in which the remaining battery charge can't be displayed accurately
** If the system's battery power display suddenly increases or decreases, it will gradually improve by [http://en-americas-support.nintendo.com/app/answers/detail/a_id/27111 following these steps].

==System Titles==
Exactly the following was updated:
* Every sysmodule.
* Every web-applet.
* Sysupdate titlelisting-title, browser "shareddata:/", [[System Version Title]], and all FIRM packages.

All sysmodules were rebuilt, where the only change was the hashid following the "GNU" string, however some sysmodules have additional changes.
* Some sysmodules have strings containing "D:\'''h'''ome\teamcity\work\sdk\Externals\{...}" changed to "D:\'''H'''ome\teamcity\work\sdk\Externals\{...}".
* Build timestamp in wlan-sysmodule was updated.

Actual updated sysmodules:
* nvservices
* pcv
* account
* nim
* pctl
* npns
* eupld

The only changes for npns and account: The <nowiki>"https://dauth-%.ndas.srv.nintendo.net/v1/device_auth_token"</nowiki> URL was changed to <nowiki>"https://dauth-%.ndas.srv.nintendo.net/{hex string}/device_auth_token"</nowiki>.

The above new URL was added(not replacing any URL in .(ro)data) to nim, + code changes. A "device_auth_token" string in nim was removed.

As of October 19, 2017, manually accessing the above new URL with the proper post-data works fine, however accessing the old URL returns the following: <code>{"errors":[{"code":"0007","message":"System update is required."}]}</code>
Hence, all sysmodules using the old URL would throw a sysupdate-required error.

===FIRM packages===
819:

Everything under RomFS was updated.

Kernel wasn't updated.

The following firm-sysmodules were updated: FS, boot, and sm. The remaining modules(Loader, NCM, ProcessMana, and spl) were rebuilt: hashid following "GNU" string was updated.

====[[Filesystem_services|FS]]====
Basically all code changes are related to the new [[NCA_Format|NCA]] crypto. Key-init function was updated due to the new NCA crypto. Various keyindex values were updated due to the new NCA crypto, for non-NCA and NCA code. A function which returned ncahdr_x206("Crypto Type") was replaced with a branch to the new <get-final-cryptotype> function described [[NCA_Format|here]](equivalent to similar changes elsewhere).

====boot====
Updated 1 func and added a new func:
* Added a call to <new func>. w1 value passed to L_381c(prev ver L_37d4) is now the output of <mask>, instead of fixed to 0x1.

==Internet Browser==
All webapplets were updated, vulnerabilities were fixed. 803/buildinfo/buildinfo.dat contains the following:
r:14938
p:NX64
v:Release
d:2017-07-11 17:51
n:0.6.10

==Keys==
The bootloader [[BCT#bootloader0_info|version]] was changed from 2 to 3.

New keydata was introduced for NCA content, see [[NCA_Format|here]].

New keydata was introduced for [[BCAT_Content_Container| BCAT containers]] for indexes 0x10 to 0x1F.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=07-31-17_08-05-16&sys=hac]

{{NavboxVersions}}

3.0.1

2019-12-28T17:14:38Z

Mha:

3.0.1

2019-12-28T17:14:01Z

Mha:

3.0.1

2019-12-28T17:13:07Z

Mha:

3.0.1

2019-12-28T17:12:49Z

Mha:

3.0.1

2019-12-28T17:09:42Z

Mha:

3.0.1

2019-12-28T17:08:10Z

Mha:

3.0.1

2019-12-28T17:07:04Z

Mha:

3.0.1

2019-12-28T16:55:52Z

Mha:

3.0.1

2019-12-28T16:44:41Z

Mha:

3.0.1

2019-12-28T16:36:01Z

Mha:

3.0.1

2019-12-28T16:28:59Z

Mha:

3.0.1

2019-12-28T16:24:09Z

Mha:

3.0.1

2019-12-28T16:21:21Z

Mha:

3.0.1

2019-12-28T16:17:46Z

Mha:

3.0.1

2019-12-28T16:16:25Z

Mha:

3.0.1

2019-12-28T16:09:15Z

Mha:

3.0.1

2019-12-28T16:05:12Z

Mha:

BCAT services

2019-07-29T19:22:22Z

Mha:

BCAT (Background Content Asymmetric synchronized delivery and Transmission) encompasses a set of content download/upload related services.

= bcat:a, bcat:m, bcat:u, bcat:s =
These are "nn::bcat::detail::ipc::IServiceCreator".

These were added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || CreateBcatService || Takes an input u64 ProcessId, returns an [[#IBcatService]]
|-
| 1 || CreateDeliveryCacheStorageService || Takes an input u64 ProcessId, returns an [[#IDeliveryCacheStorageService]]
|-
| 2 || CreateDeliveryCacheStorageServiceWithApplicationId || Takes an input u64 TitleId, returns an [[#IDeliveryCacheStorageService]]
|-
| [2.0.0-2.3.0] 3 || CreateDeliveryCacheProgressService || Takes an input u64 ProcessId, returns an [[#IDeliveryCacheProgressService]]
|-
| [2.0.0-2.3.0] 4 || CreateDeliveryCacheProgressServiceWithApplicationId || Takes an input u64 TitleId, returns an [[#IDeliveryCacheProgressService]]
|}

Equivalent to 3DS BOSS(SpotPass). See [[BCAT_Content_Container|here]] for BCAT-content-container.

== IBcatService ==
This is "nn::bcat::detail::ipc::IBcatService".

This was added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 10100 || [[#RequestSyncDeliveryCache]]
|-
| 10101 || [5.0.0+] RequestSyncDeliveryCacheWithDirectoryName
|-
| 10200 || [5.0.0+] CancelSyncDeliveryCacheRequest
|-
| 20100 || [[#RequestSyncDeliveryCacheWithApplicationId]]
|-
| 20101 || [5.0.0+] RequestSyncDeliveryCacheWithApplicationIdAndDirectoryName
|-
| 20300 || [8.0.0+] [[#GetDeliveryCacheStorageUpdateNotifier]]
|-
| 20301 || [8.0.0+] [[#RequestSuspendDeliveryTask]]
|-
| 30100 || SetPassphrase
|-
| [2.0.0-2.3.0] 30101 ||
|-
| [2.0.0-2.3.0] 30102 ||
|-
| 30200 || [3.0.0+] RegisterDeliveryTask
|-
| 30201 || [3.0.0+] UnregisterDeliveryTask
|-
| 30202 || [3.0.0+] BlockDeliveryTask
|-
| 30203 || [3.0.0+] UnblockDeliveryTask
|-
| 30300 || [8.0.0+] RegisterSystemApplicationDeliveryTasks
|-
| 90100 || GetDeliveryTaskList
|-
| 90200 || [[#GetDeliveryList]]
|-
| 90201 || [3.0.0+] ClearDeliveryCacheStorage
|-
| 90202 || [8.0.0+] ClearDeliveryTaskSubscriptionStatus
|-
| 90300 || [3.0.0+] GetPushNotificationLog
|}

=== RequestSyncDeliveryCache ===
No input/output.

[3.0.0+] Now returns an [[#IDeliveryCacheProgressService]].

=== RequestSyncDeliveryCacheWithApplicationId ===
Takes a total of 8-bytes of input, no output.

[3.0.0+] Now takes an additional 8-bytes of input, and returns an [[#IDeliveryCacheProgressService]].

=== GetDeliveryCacheStorageUpdateNotifier ===
Takes a total of 8-bytes of input, returns an [[#INotifierService]].

=== RequestSuspendDeliveryTask ===
Takes a total of 8-bytes of input, returns an [[#IDeliveryTaskSuspensionService]].

=== GetDeliveryList ===
Takes a type-0x6 output buffer, returns a total of 4-bytes of output.

[3.0.0+] Now takes a total of 8-bytes of input, and returns an additional 4-bytes of output.

=== IDeliveryCacheProgressService ===
This is "nn::bcat::detail::ipc::IDeliveryCacheProgressService".

This was added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetEvent
|-
| 1 || GetImpl
|}

== IDeliveryCacheStorageService ==
This is "nn::bcat::detail::ipc::IDeliveryCacheStorageService".

This was added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || CreateFileService
|-
| 1 || CreateDirectoryService
|-
| 10 || EnumerateDeliveryCacheDirectory
|}

=== IDeliveryCacheFileService ===
This is "nn::bcat::detail::ipc::IDeliveryCacheFileService".

This was added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || Open
|-
| 1 || Read
|-
| 2 || GetSize
|-
| 3 || GetDigest
|}

=== IDeliveryCacheDirectoryService ===
This is "nn::bcat::detail::ipc::IDeliveryCacheDirectoryService".

This was added with [2.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || Open
|-
| 1 || Read
|-
| 2 || GetCount
|}

=== INotifierService ===
This is "nn::bcat::detail::ipc::INotifierService".

Added with [8.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetEvent ||
|}

=== IDeliveryTaskSuspensionService ===
This is "nn::bcat::detail::ipc::IDeliveryTaskSuspensionService".

Added with [8.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetEvent ||
|}

= <nowiki>news:a, news:c, news:m, news:p, news:v</nowiki> =
These are <nowiki>"nn::news::detail::ipc::IServiceCreator"</nowiki>.

On [1.0.0] these are <nowiki>"nn::news::detail::ipc::INewsService"</nowiki>, see [[#INewsService]].

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || || No input, returns an [[#INewsService]].
|-
| 1 || || No input, returns an [[#INewlyArrivedEventHolder]].
|-
| 2 || || No input, returns an [[#INewsDataService]].
|-
| 3 || || No input, returns an [[#INewsDatabaseService]].
|-
| 4 || || No input, returns an [[#IOverwriteEventHolder]].
|}

== INewsService ==
This is <nowiki>"nn::news::detail::ipc::INewsService"</nowiki>.

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 10100 ||
|-
| 20100 ||
|-
| 30100 ||
|-
| 30101 || [3.0.0+]
|-
| 30110 || [6.0.0+]
|-
| 30200 ||
|-
| 30201 || [8.0.0+]
|-
| 30300 ||
|-
| 30400 || [3.0.0+]
|-
| 30500 || [8.0.0+] ? (Takes a total of 8-bytes of input, a handle, and a type-0x9 input buffer, returns an [[#IUnknown2]])
|-
| [1.0.0] 30900 || (No input, returns an [[#INewlyArrivedEventHolder]])
|-
| [1.0.0] 30901 || (No input, returns an [[#INewsDataService]])
|-
| [1.0.0] 30902 || (No input, returns an [[#INewsDatabaseService]])
|-
| 40100 ||
|-
| 40101 || [3.0.0+]
|-
| 40200 ||
|-
| 40201 ||
|-
| 90100 ||
|}

== INewlyArrivedEventHolder ==
This is <nowiki>"nn::news::detail::ipc::INewlyArrivedEventHolder"</nowiki>.

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 ||
|}

== INewsDataService ==
This is <nowiki>"nn::news::detail::ipc::INewsDataService"</nowiki>.

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 ||
|-
| 1 ||
|-
| 2 ||
|-
| 3 ||
|-
| 1001 || [6.0.0+]
|}

== INewsDatabaseService ==
This is <nowiki>"nn::news::detail::ipc::INewsDatabaseService"</nowiki>.

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 ||
|-
| 1 ||
|-
| 2 ||
|-
| 3 ||
|-
| 4 ||
|-
| 5 ||
|-
| 1000 || [6.0.0+]
|}

== IOverwriteEventHolder ==
This is <nowiki>"nn::news::detail::ipc::IOverwriteEventHolder"</nowiki>.

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 ||
|}

== IUnknown2 ==
This was added with [8.0.0+].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 ||
|-
| 1 ||
|-
| 2 ||
|-
| 3 ||
|}

= prepo:a, prepo:a2, prepo:m, prepo:u, prepo:s =
These are "nn::prepo::detail::ipc::IPrepoService".

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 10100 || SaveReportOld ([1.0.0-5.1.0] SaveReport)
|-
| 10101 || SaveReportWithUserOld ([1.0.0-5.1.0] SaveReportWithUser)
|-
| 10102 || [6.0.0+] SaveReport
|-
| 10103 || [6.0.0+] SaveReportWithUser
|-
| 10200 || RequestImmediateTransmission
|-
| 10300 || GetTransmissionStatus
|-
| 20100 || SaveSystemReport
|-
| 20101 || SaveSystemReportWithUser
|-
| 20200 || [4.0.0+] SetOperationMode
|-
| 30100 || ClearStorage
|-
| 30200 || [6.0.0+] ClearStatistics
|-
| 30300 || [6.0.0+] GetStorageUsage
|-
| 30400 || [6.0.0+] GetStatistics
|-
| 30401 || [6.0.0+] GetThroughputHistory
|-
| 30500 || [6.0.0+] GetLastUploadError
|-
| 40100 || [2.0.0+] IsUserAgreementCheckEnabled
|-
| 40101 || [2.0.0+] SetUserAgreementCheckEnabled
|-
| 90100 || [6.0.0+] ReadAllReportFiles ([1.0.0-5.1.0] GetStorageUsage)
|-
| [1.0.0] 90101 ||
|-
| [1.0.0] 90102 ||
|-
| [5.0.0-5.1.0] 90200 || GetStatistics
|-
| [5.0.0-5.1.0] 90201 || GetThroughputHistory
|-
| [5.0.0-5.1.0] 90300 || GetLastUploadError
|}

== Data reporting ==
The "Play Report" (prepo) service uploads system and user information to a cloud server.
This includes the following fields:
sys_info
data
application_id
event_id
operation_mode
lc_recorded_at (followed by a timestamp)
nc_recorded_at (followed by a timestamp)
nsa_id
os_version

And the contents of the following file:
is_user_agreement_check_enabled.bin

All the information is periodically uploaded to the following URL:<br>
* <nowiki>https://receive-%.dg.srv.nintendo.net/post</nowiki>

It also checks the validity of the device's authentication token using the following URL:<br>
* <nowiki>https://dauth-%.ndas.srv.nintendo.net/v1/device_auth_token</nowiki>

[[Category:Services]]

BCAT services

2019-07-29T19:22:00Z

Mha:

BCAT services

2019-07-29T19:20:44Z

Mha:

BCAT services

2019-07-29T19:20:19Z

Mha:

Applet Manager services

2018-10-10T03:57:16Z

Mha: p-sam's edit

AM (Applet Manager) provides services for interacting with system applets while abstracting several aspects of power and operation management.

Contains multiple raw images, with at least the following: "NN_OMM_CHARGING_BIN_{begin|end}"(charging icon), low-battery icon, and the Nintendo Switch logo displayed during system boot.

= appletAE =
This is "nn::am::service::IAllSystemAppletProxiesService".

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 100 || OpenSystemAppletProxy || Returns an [[#ISystemAppletProxy]].
|-
| 200 || OpenLibraryAppletProxyOld ([1.0.0-2.3.0] OpenLibraryAppletProxy) || Returns an [[#ILibraryAppletProxy]].
|-
| 201 || [3.0.0+] [[#OpenLibraryAppletProxy]] || Returns an [[#ILibraryAppletProxy]].
|-
| 300 || OpenOverlayAppletProxy || Returns an [[#IOverlayAppletProxy]].
|-
| 350 || OpenSystemApplicationProxy || Returns an [[#IApplicationProxy]].
|-
| 400 || CreateSelfLibraryAppletCreatorForDevelop || Returns an [[#ILibraryAppletCreator]].
|}

All of these commands except [[#OpenLibraryAppletProxy]] take the same input as [[#OpenApplicationProxy]], with the same user-process retry-loop as [[#OpenApplicationProxy]]. These Open*Proxy commands (including appletOE) doesn't seem to usable from processes which aren't actual applets (such as sysmodules), at least for applet-types which aren't already in use.

This service is used by all system non-regular-applications.

The 01000000000010XX system [[Title_list|titles]] use the following applet types(above Open{type}Proxy commands):
* "qlaunch": SystemApplet
* "overlay": OverlayApplet
* "starter": SystemApplication
* "maintenance": SystemApplet
* All others: LibraryApplet

== OpenLibraryAppletProxy ==
Returns an [[#ILibraryAppletProxy]].

Takes a [[IPC_Marshalling|reserved]] input u64(official user-processes use hard-coded value 0), a PID,a process copy-handle(cur-proc handle alias), and an 0x80-byte type-0x15 input buffer '''AppletAttribute'''.

Official user-processes use the same retry loop with this as the other Open*Proxy commands.

== ISystemAppletProxy ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
| 20 || GetHomeMenuFunctions || Returns an [[#IHomeMenuFunctions]].
|-
| 21 || GetGlobalStateController || Returns an [[#IGlobalStateController]].
|-
| 22 || GetApplicationCreator || Returns an [[#IApplicationCreator]].
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|-
|}

=== IHomeMenuFunctions ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 10 || RequestToGetForeground ||
|-
| 11 || LockForeground ||
|-
| 12 || UnlockForeground ||
|-
| 20 || PopFromGeneralChannel || Returns an [[#IStorage]].
|-
| 21 || GetPopFromGeneralChannelEvent ||
|-
| 30 || GetHomeButtonWriterLockAccessor || Returns an [[#ILockAccessor]].
|-
| 31 || [2.0.0+] GetWriterLockAccessorEx || Returns an [[#ILockAccessor]].
|-
|}

==== ILockAccessor ====
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 1 || TryLock
|-
| 2 || Unlock
|-
| 3 || GetEvent
|}

=== IGlobalStateController ===
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || RequestToEnterSleep
|-
| 1 || EnterSleep
|-
| 2 || StartSleepSequence
|-
| 3 || StartShutdownSequence
|-
| 4 || StartRebootSequence
|-
| 10 || LoadAndApplyIdlePolicySettings
|-
| 11 || [2.0.0+] NotifyCecSettingsChanged
|-
| 12 || [2.0.0+] SetDefaultHomeButtonLongPressTime
|-
| 13 || [2.0.0+] UpdateDefaultDisplayResolution
|-
| 14 || [2.0.0+] ShouldSleepOnBoot
|-
| 15 || [4.0.0+] GetHdcpAuthenticationFailedEvent
|}

=== IApplicationCreator ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || CreateApplication || Returns an [[#IApplicationAccessor]].
|-
| 1 || PopLaunchRequestedApplication || Returns an [[#IApplicationAccessor]].
|-
| 10 || CreateSystemApplication || Returns an [[#IApplicationAccessor]].
|-
| 100 || PopFloatingApplicationForDevelopment || Returns an [[#IApplicationAccessor]].
|}

==== IApplicationAccessor ====
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetAppletStateChangedEvent ||
|-
| 1 || IsCompleted ||
|-
| 10 || Start ||
|-
| 20 || RequestExit ||
|-
| 25 || Terminate ||
|-
| 30 || GetResult ||
|-
| 101 || RequestForApplicationToGetForeground ||
|-
| 110 || TerminateAllLibraryApplets ||
|-
| 111 || AreAnyLibraryAppletsLeft ||
|-
| 112 || GetCurrentLibraryApplet || Returns an [[#IAppletAccessor]].
|-
| 120 || GetApplicationId ||
|-
| 121 || PushLaunchParameter || Takes an [[#IStorage]].
|-
| 122 || GetApplicationControlProperty ||
|-
| 123 || [2.0.0+] GetApplicationLaunchProperty ||
|}

===== IAppletAccessor =====
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetAppletStateChangedEvent
|-
| 1 || IsCompleted
|-
| 10 || Start
|-
| 20 || RequestExit
|-
| 25 || Terminate
|-
| 30 || GetResult
|}

== ILibraryAppletProxy ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
| 20 || GetLibraryAppletSelfAccessor || Returns an [[#ILibraryAppletSelfAccessor]].
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|-
|}

=== ILibraryAppletSelfAccessor ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || PopInData || Returns an [[#IStorage]].
|-
| 1 || PushOutData || Takes an [[#IStorage]].
|-
| 2 || PopInteractiveInData || Returns an [[#IStorage]].
|-
| 3 || PushInteractiveOutData || Takes an [[#IStorage]].
|-
| 5 || GetPopInDataEvent ||
|-
| 6 || GetPopInteractiveInDataEvent ||
|-
| 10 || [[#ExitProcessAndReturn]] ||
|-
| 11 || [[#GetLibraryAppletInfo]] ||
|-
| 12 || GetMainAppletIdentityInfo ||
|-
| 13 || CanUseApplicationCore ||
|-
| 14 || GetCallerAppletIdentityInfo ||
|-
| 15 || [2.0.0+] GetMainAppletApplicationControlProperty ||
|-
| 16 || [2.0.0+] GetMainAppletStorageId ||
|-
| 17 || [2.0.0+] GetCallerAppletIdentityInfoStack ||
|-
| 18 || [4.0.0+] GetNextReturnDestinationAppletIdentityInfo ||
|-
| 19 || [4.0.0+] GetDesirableKeyboardLayout ||
|-
| 20 || PopExtraStorage || Returns an [[#IStorage]].
|-
| 25 || GetPopExtraStorageEvent ||
|-
| 30 || UnpopInData || Takes an [[#IStorage]].
|-
| 31 || UnpopExtraStorage || Takes an [[#IStorage]].
|-
| 40 || [2.0.0+] GetIndirectLayerProducerHandle ||
|-
| 50 || [2.0.0+] ReportVisibleError ||
|-
| 51 || [4.0.0+] ReportVisibleErrorWithErrorContext ||
|-
| 60 || [4.0.0+] [[#GetMainAppletApplicationDesiredLanguage]] ||
|-
| 90 || [5.0.0+] CreateApplicationAndPushAndRequestToLaunch ||
|-
| 100 || [4.0.0+] CreateGameMovieTrimmer ||
|}

==== ExitProcessAndReturn ====
No input/output.

Exits the LibraryApplet and returns to running the title which launched this LibraryApplet ([[qlaunch]] for example).

==== GetLibraryAppletInfo ====
No input. Returns an u64 LibraryAppletInfo: +0 u32 is [[#AppletId]], +4 u32 is [[#LibraryAppletMode]].

==== GetMainAppletApplicationDesiredLanguage ====
No input, returns an output [[Settings_services#LanguageCode|LanguageCode]].

== IOverlayAppletProxy ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
| 20 || GetOverlayFunctions || Returns an [[#IOverlayFunctions]].
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|}

=== IOverlayFunctions ===
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || BeginToWatchShortHomeButtonMessage
|-
| 1 || EndToWatchShortHomeButtonMessage
|-
| 2 || GetApplicationIdForLogo
|-
| 3 || SetGpuTimeSliceBoost
|-
| 4 || [2.0.0+] SetAutoSleepTimeAndDimmingTimeEnabled
|-
| 5 || [2.0.0+] TerminateApplicationAndSetReason
|-
| 6 || [2.0.0+] SetScreenShotPermissionGlobally
|}

== IApplicationProxy ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
| 20 || GetApplicationFunctions || Returns an [[#IApplicationFunctions]].
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|}

=== IApplicationFunctions ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 1 || PopLaunchParameter || Returns an [[#IStorage]].
|-
| 10 || CreateApplicationAndPushAndRequestToStart || Takes an [[#IStorage]].
|-
| 11 || [2.0.0+] CreateApplicationAndPushAndRequestToStartForQuest || Takes an [[#IStorage]].
|-
| 12 || [4.0.0+] CreateApplicationAndRequestToStart ||
|-
| 13 || [4.0.0+] CreateApplicationAndRequestToStartForQuest ||
|-
| 20 || EnsureSaveData ||
|-
| 21 || [[#GetDesiredLanguage]] ||
|-
| 22 || [[#SetTerminateResult]] ||
|-
| 23 || GetDisplayVersion ||
|-
| 24 || [2.0.0+] GetLaunchStorageInfoForDebug ||
|-
| 25 || [2.0.0+] ExtendSaveData ||
|-
| 26 || [2.0.0+] GetSaveDataSize ||
|-
| 27 || [5.0.0+] CreateCacheStorage ||
|-
| 30 || BeginBlockingHomeButtonShortAndLongPressed ||
|-
| 31 || EndBlockingHomeButtonShortAndLongPressed ||
|-
| 32 || [[#BeginBlockingHomeButton]] ||
|-
| 33 || EndBlockingHomeButton ||
|-
| 40 || [[#NotifyRunning]] ||
|-
| 50 || [2.0.0+] GetPseudoDeviceId ||
|-
| 60 || [2.0.0+] SetMediaPlaybackStateForApplication ||
|-
| 65 || [3.0.0+] IsGamePlayRecordingSupported ||
|-
| 66 || [3.0.0+] [[#InitializeGamePlayRecording]] ||
|-
| 67 || [3.0.0+] [[#SetGamePlayRecordingState]] ||
|-
| 68 || [4.0.0+] RequestFlushGamePlayingMovieForDebug ||
|-
| 70 || [3.0.0+] RequestToShutdown ||
|-
| 71 || [3.0.0+] RequestToReboot ||
|-
| 80 || [4.0.0+] ExitAndRequestToShowThanksMessage ||
|-
| 90 || [4.0.0+] EnableApplicationCrashReport ||
|-
| 100 || [5.0.0+] InitializeApplicationCopyrightFrameBuffer ||
|-
| 101 || [5.0.0+] SetApplicationCopyrightImage ||
|-
| 102 || [5.0.0+] SetApplicationCopyrightVisibility ||
|-
| 110 || [5.0.0+] QueryApplicationPlayStatistics ||
|-
| 120 || [5.0.0+] ExecuteProgram ||
|-
| 121 || [5.0.0+] ClearUserChannel ||
|-
| 122 || [5.0.0+] UnpopToUserChannel ||
|-
| 500 || [5.0.0+] StartContinuousRecordingFlushForDebug ||
|-
| 1000 || [5.0.0+] CreateMovieMaker ||
|-
| 1001 || [5.0.0+] [[#PrepareForJit]] ||
|}

The BOTW game uses this GamePlayRecording functionality from the main-nso "nninitStartup" function, with size 0x6000000(96MiB). The official GamePlayRecording-enable code does the following(this will panic on any failure):
* [[SVC|Creates]] TransferMemory using the input buffer and size, with permissions=0.
* Uses [[#InitializeGamePlayRecording]] with the TransferMemory.
* Closes the TransferMemory handle, + TransferMemory cleanup.
* Uses [[#SetGamePlayRecordingState]] with value 0x1.
This GamePlayRecording functionality presumably enables the video-recording usable starting with [[4.0.0]].

==== GetDesiredLanguage ====
No input, returns an output [[Settings_services#LanguageCode|LanguageCode]].

==== SetTerminateResult ====
Takes an input u32 '''Result''', no output.

For example, in some cases official apps use this with [[Error_codes|error]] 0x2A2 then uses svcBreak.

==== BeginBlockingHomeButton ====
Takes an input s64 nanoseconds, no output. The input nanoseconds can be zero.

==== NotifyRunning ====
Takes no input. Returns an output u8, which is ignored by official user-processes.

==== InitializeGamePlayRecording ====
Takes a TransferMemory handle and an u64 for the size of the TransferMemory.

==== SetGamePlayRecordingState ====
Takes an input u32.

==== PrepareForJit ====
Takes no input. Launches title 010000000000003B (currently not present on retail systems) if some context variable is set.

== ILibraryAppletCreator ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || CreateLibraryApplet || Returns an [[#ILibraryAppletAccessor]].
|-
| 1 || TerminateAllLibraryApplets ||
|-
| 2 || AreAnyLibraryAppletsLeft ||
|-
| 10 || CreateStorage || Returns an [[#IStorage]].
|-
| 11 || CreateTransferMemoryStorage || Returns an [[#IStorage]].
|-
| 12 || [2.0.0+] CreateHandleStorage || Returns an [[#IStorage]].
|}

=== ILibraryAppletAccessor ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetAppletStateChangedEvent ||
|-
| 1 || IsCompleted ||
|-
| 10 || Start ||
|-
| 20 || RequestExit ||
|-
| 25 || Terminate ||
|-
| 30 || GetResult ||
|-
| 50 || SetOutOfFocusApplicationSuspendingEnabled ||
|-
| 100 || PushInData || Takes an [[#IStorage]].
|-
| 101 || PopOutData || Returns an [[#IStorage]].
|-
| 102 || PushExtraStorage || Takes an [[#IStorage]].
|-
| 103 || PushInteractiveInData || Takes an [[#IStorage]].
|-
| 104 || PopInteractiveOutData || Returns an [[#IStorage]].
|-
| 105 || GetPopOutDataEvent ||
|-
| 106 || GetPopInteractiveOutDataEvent ||
|-
| 110 || NeedsToExitProcess ||
|-
| 120 || GetLibraryAppletInfo ||
|-
| 150 || RequestForAppletToGetForeground ||
|-
| 160 || [2.0.0+] GetIndirectLayerConsumerHandle ||
|}

== ICommonStateGetter ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#GetEventHandle]] ||
|-
| 1 || [[#ReceiveMessage]] ||
|-
| 2 || GetThisAppletKind ||
|-
| 3 || AllowToEnterSleep ||
|-
| 4 || DisallowToEnterSleep ||
|-
| 5 || [[#GetOperationMode]] ||
|-
| 6 || [[#GetPerformanceMode]] ||
|-
| 7 || GetCradleStatus ||
|-
| 8 || GetBootMode ||
|-
| 9 || [[#GetCurrentFocusState]] ||
|-
| 10 || RequestToAcquireSleepLock ||
|-
| 11 || ReleaseSleepLock ||
|-
| 12 || ReleaseSleepLockTransiently ||
|-
| 13 || GetAcquiredSleepLockEvent ||
|-
| 20 || PushToGeneralChannel || Takes an [[#IStorage]].
|-
| 30 || GetHomeButtonReaderLockAccessor || Returns an [[#ILockAccessor]].
|-
| 31 || [2.0.0+] GetReaderLockAccessorEx || Returns an [[#ILockAccessor]].
|-
| 40 || [2.0.0+] GetCradleFwVersion ||
|-
| 50 || [3.0.0+] IsVrModeEnabled ||
|-
| 51 || [3.0.0+] [[#SetVrModeEnabled]] ||
|-
| 52 || [4.0.0+] SetLcdBacklighOffEnabled ||
|-
| 55 || [3.0.0+] IsInControllerFirmwareUpdateSection ||
|-
| 60 || [3.0.0+] GetDefaultDisplayResolution ||
|-
| 61 || [3.0.0+] GetDefaultDisplayResolutionChangeEvent ||
|-
| 62 || [4.0.0+] GetHdcpAuthenticationState ||
|-
| 63 || [4.0.0+] GetHdcpAuthenticationStateChangeEvent ||
|-
| 64 || [5.0.0+] SetTvPowerStateMatchingMode ||
|}

Officially notification messages are handled by the application itself, not sdk-nso in ExeFS. Official apps call code in sdk-nso which basically uses svcWaitSynchronization with the event from [[#GetEventHandle]] to check whether a message is available, then if so it uses [[#ReceiveMessage]]. The actual handling for message IDs is done in the app itself(see [[#NotificationMessage]]).

=== GetEventHandle ===
No input. Returns an output event handle. This is signalled when a message is available with [[#ReceiveMessage]].

=== ReceiveMessage ===
No input. Returns an output u32. Error 0x680 indicates no message is available.

=== GetOperationMode ===
No input. Returns an output u8 for the current [[#OperationMode]].

=== GetPerformanceMode ===
No input. Returns an output u32 for the current PerformanceMode.

=== GetCurrentFocusState ===
No input. Returns an output u8:

* 1: In focus.
* 2/3: Out of focus(running in "background").

=== SetVrModeEnabled ===
Takes an input u8 bool flag. No output.

Updates internal AM state fields. If the new state doesn't match the previous state, this uses the [[Backlight_services]] {Disable/Enable}VrMode command depending on whether flag={disable/enable}.

When the VrMode is set to true, the console shows a screen rendered like vr asking the user to move his face away and hit the 'close' button. When this button is pressed, the console resets the vrMode to false.

== ISelfController ==
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || [[#Exit]]
|-
| 1 || [[#LockExit]]
|-
| 2 || [[#UnlockExit]]
|-
| 3 || [2.0.0+] [[#EnterFatalSection]]
|-
| 4 || [2.0.0+] [[#LeaveFatalSection]]
|-
| 9 || GetLibraryAppletLaunchableEvent
|-
| 10 || [[#SetScreenShotPermission]]
|-
| 11 || [[#SetOperationModeChangedNotification]]
|-
| 12 || [[#SetPerformanceModeChangedNotification]]
|-
| 13 || [[#SetFocusHandlingMode]]
|-
| 14 || SetRestartMessageEnabled
|-
| 15 || [2.0.0+] [[#SetScreenShotAppletIdentityInfo]]
|-
| 16 || [2.0.0+] [[#SetOutOfFocusSuspendingEnabled]]
|-
| 17 || [3.0.0+] SetControllerFirmwareUpdateSection
|-
| 18 || [3.0.0+] SetRequiresCaptureButtonShortPressedMessage
|-
| 19 || [3.0.0+] [[#SetScreenShotImageOrientation]]
|-
| 20 || [4.0.0+] SetDesirableKeyboardLayout
|-
| 40 || [[#CreateManagedDisplayLayer]]
|-
| 41 || [4.0.0+] IsSystemBufferSharingEnabled
|-
| 42 || [4.0.0+] GetSystemSharedLayerHandle
|-
| 50 || SetHandlesRequestToDisplay
|-
| 51 || ApproveToDisplay
|-
| 60 || OverrideAutoSleepTimeAndDimmingTime
|-
| 61 || SetMediaPlaybackState
|-
| 62 || SetIdleTimeDetectionExtension
|-
| 63 || GetIdleTimeDetectionExtension
|-
| 64 || SetInputDetectionSourceSet
|-
| 65 || [2.0.0+] ReportUserIsActive
|-
| 66 || [3.0.0+] GetCurrentIlluminance
|-
| 67 || [3.0.0+] IsIlluminanceAvailable
|-
| 68 || [4.0.0+] SetAutoSleepDisabled
|-
| 69 || [4.0.0+] IsAutoSleepDisabled
|-
| 70 || [5.0.0+] ReportMultimediaError
|-
| 80 || [5.0.0+] SetWirelessPriorityMode
|}

=== Exit ===
No input/output.

=== LockExit ===
No input/output.

Locks exit process of pressing X to close in HOME Menu for an application or HOME button for an applet. When locked, it will show the "waiting for software to be closed dialog" until UnlockExit is called.

=== UnlockExit ===
No input/output.

Unlocks exit process, if LockExit was previously used.

=== EnterFatalSection ===
No input/output.

=== LeaveFatalSection ===
No input/output.

=== SetScreenShotPermission ===
Takes an input s32. No output.

Controls whether screenshot-capture is allowed. 0 = disable, 1 = enable, 2 = unknown.

=== SetOperationModeChangedNotification ===
Takes an input u8 bool flag. No output.

=== SetPerformanceModeChangedNotification ===
Takes an input u8 bool flag. No output.

=== SetFocusHandlingMode ===
Takes 3 input u8s with each field located immediately after the previous u8, these are bool flags. No output.

=== SetScreenShotAppletIdentityInfo ===
Takes an input 0x10-byte struct AppletIdentityInfo. No output.

=== SetOutOfFocusSuspendingEnabled ===
Takes an input u8(bool flag). No output.

=== SetScreenShotImageOrientation ===
Takes an input s32. No output.

=== CreateManagedDisplayLayer ===
Returns an output u64 LayerId which is then used by the user-process with [[Display_services#OpenLayer]].

== IWindowController ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || CreateWindow || Returns an IWindow object.
|-
| 1 || [[#GetAppletResourceUserId]] ||
|-
| 10 || [[#AcquireForegroundRights]] ||
|-
| 11 || ReleaseForegroundRights ||
|-
| 12 || RejectToChangeIntoBackground ||
|}

=== GetAppletResourceUserId ===
Returns an output u64: [[#AppletResourceUserId]].

=== AcquireForegroundRights ===
No input/output.

== IAudioController ==
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || SetExpectedMasterVolume
|-
| 1 || GetMainAppletExpectedMasterVolume
|-
| 2 || GetLibraryAppletExpectedMasterVolume
|-
| 3 || ChangeMainAppletMasterVolume
|-
| 4 || SetTransparentVolumeRate
|}

== IDisplayController ==
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetLastForegroundCaptureImage
|-
| 1 || UpdateLastForegroundCaptureImage
|-
| 2 || GetLastApplicationCaptureImage
|-
| 3 || GetCallerAppletCaptureImage
|-
| 4 || UpdateCallerAppletCaptureImage
|-
| 5 || GetLastForegroundCaptureImageEx
|-
| 6 || GetLastApplicationCaptureImageEx
|-
| 7 || GetCallerAppletCaptureImageEx
|-
| 8 || [2.0.0+] TakeScreenShotOfOwnLayer
|-
| 9 || [5.0.0+] CopyBetweenCaptureBuffers
|-
| 10 || AcquireLastApplicationCaptureBuffer
|-
| 11 || ReleaseLastApplicationCaptureBuffer
|-
| 12 || AcquireLastForegroundCaptureBuffer
|-
| 13 || ReleaseLastForegroundCaptureBuffer
|-
| 14 || AcquireCallerAppletCaptureBuffer
|-
| 15 || ReleaseCallerAppletCaptureBuffer
|-
| 16 || AcquireLastApplicationCaptureBufferEx
|-
| 17 || AcquireLastForegroundCaptureBufferEx
|-
| 18 || AcquireCallerAppletCaptureBufferEx
|-
| 20 || [2.0.0+] ClearCaptureBuffer
|-
| 21 || [2.0.0+] ClearAppletTransitionBuffer
|-
| 22 || [4.0.0+] AcquireLastApplicationCaptureSharedBuffer
|-
| 23 || [4.0.0+] ReleaseLastApplicationCaptureSharedBuffer
|-
| 24 || [4.0.0+] AcquireLastForegroundCaptureSharedBuffer
|-
| 25 || [4.0.0+] ReleaseLastForegroundCaptureSharedBuffer
|-
| 26 || [4.0.0+] AcquireCallerAppletCaptureSharedBuffer
|-
| 27 || [4.0.0+] ReleaseCallerAppletCaptureSharedBuffer
|}

== ILibraryAppletCreator==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || CreateLibraryApplet || Returns a [[#ILibraryAppletAccessor]].
|-
| 1 || TerminateAllLibraryApplets ||
|-
| 2 || AreAnyLibraryAppletsLeft ||
|-
| 10 || CreateStorage || Returns an [[#IStorage]].
|-
| 11 || CreateTransferMemoryStorage || Returns an [[#|IStorage]].
|-
| 12 || [2.0.0+] CreateHandleStorage || Returns an [[#IStorage]].
|}

== IProcessWindingController ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#GetLaunchReason]] ||
|-
| 11 || OpenCallingLibraryApplet || Returns an [[#ILibraryAppletAccessor]].
|-
| 21 || PushContext || Takes an [[#IStorage]].
|-
| 22 || PopContext || Returns an [[#IStorage]].
|-
| 23 || CancelWindingReservation ||
|-
| 30 || WindAndDoReserved ||
|-
| 40 || ReserveToStartAndWaitAndUnwindThis || Returns an [[#ILibraryAppletAccessor]].
|-
| 41 || [4.0.0+] ReserveToStartAndWait ||
|}

=== GetLaunchReason ===
No input. Returns an u32 AppletProcessLaunchReason.

Used by LibraryApplets.

== IDebugFunctions ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || NotifyMessageToHomeMenuForDebug ||
|-
| 1 || OpenMainApplication || Returns an [[#IApplicationAccessor]].
|-
| 10 || EmulateButtonEvent ||
|-
| 20 || InvalidateTransitionLayer ||
|}

== IStorage ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || Open || No input. Returns an [[#IStorageAccessor]].
|-
| 1 || OpenTransferStorage || No input. Returns an [[#ITransferStorageAccessor]].
|}

Commands which take an IStorage as input use an unknown input u32 for that.

== IStorageAccessor ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetSize || No input. Returns an s64.
|-
| 10 || Write || Takes an input s64 and a type-0x21 input buffer.
|-
| 11 || Read || Takes an input s64 and a type-0x22 output buffer.
|}

== ITransferStorageAccessor ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetSize || No input. Returns an output s64.
|-
| 1 || GetHandle || No input. Returns an output u64 and handle.
|}

= appletOE =
This is "nn::am::service::IApplicationProxyService".

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#OpenApplicationProxy]] ||
|}

This is used by all regular-applications, including [[flog]] and "Retail Interactive Display Menu". Only one session can be open for this service at a time.

== OpenApplicationProxy ==
Returns an [[#IApplicationProxy]]. See [[#appletAE]].

Takes a [[IPC_Marshalling|reserved]] input u64(official user-processes use hard-coded value 0), a PID, and a process copy-handle(cur-proc handle alias).

On failure, official user-processes will retry using this command in a loop while the retval is 0x19280, with svcSleepThread(10000000) being called first.

= idle:sys =
This is "nn::idle::detail::IPolicyManagerSystem"

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetAutoPowerDownEvent
|-
| 1 || [1.0.0-3.0.2]
|-
| 2 || [1.0.0-3.0.2]
|-
| 3 ||
|-
| 4 ||
|-
| 5 ||
|}

= omm =
This is "nn::omm::detail::IOperationModeManager"

Operation Mode Manager (OMM) is a service responsible for arbitrating the operation changes between docked and handheld modes.
Besides [[PTM_services]], this is the only service that interacts with the [[Dock]] through [[USB_services|usb:pd*]].

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetOperationMode
|-
| 1 || GetOperationModeChangeEvent
|-
| 2 || EnableAudioVisual
|-
| 3 || DisableAudioVisual
|-
| 4 || EnterSleepAndWait
|-
| 5 || GetCradleStatus
|-
| 6 || FadeInDisplay
|-
| 7 || FadeOutDisplay
|-
| 8 || [2.0.0+]
|-
| 9 || [2.0.0+]
|-
| 10 || [3.0.0+]
|-
| 11 || [3.0.0+]
|-
| 12 || [3.0.0+]
|-
| 13 || [3.0.0+]
|-
| 14 || [3.0.0+]
|-
| 15 || [4.0.0+]
|-
| 16 || [4.0.0+]
|-
| 17 || [4.0.0+]
|-
| 18 || [4.0.0+]
|-
| 19 || [4.0.0+]
|-
| 20 || [4.0.0+]
|-
| 21 || [4.0.0+]
|-
| 22 || [4.0.0+]
|-
| 23 || [4.0.0+]
|}

= spsm =
This is "nn::spsm::detail::IPowerStateInterface".

{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || GetState
|-
| 1 || SleepSystemAndWaitAwake
|-
| 2 ||
|-
| 3 ||
|-
| 4 || GetNotificationMessageEventHandle
|-
| 5 ||
|-
| 6 ||
|-
| 7 ||
|-
| 8 || AnalyzePerformanceLogForLastSleepWakeSequence
|-
| 9 || ChangeHomeButtonLongPressingTime
|-
| 10 ||
|-
| 11 || [1.0.0-3.0.2]
|}

= Enums =
=== AppletId ===
{| class="wikitable" border="1"
|-
! ID
! Title-id
! Description
|-
| 0x02
| 010000000000100C
| "overlayDisp"
|-
| 0x03
| 0100000000001000
| "qlaunch"
|-
| 0x04
| 0100000000001012
| "starter"
|-
| 0x0A
| 0100000000001001
| "auth"
|-
| 0x0B
| 0100000000001002
| "cabinet"
|-
| 0x0C
| 0100000000001003
| "controller"
|-
| 0x0D
| 0100000000001004
| "dataErase"
|-
| 0x0E
| 0100000000001005
| "error"
|-
| 0x0F
| 0100000000001006
| "netConnect"
|-
| 0x10
| 0100000000001007
| "playerSelect"
|-
| 0x11
| 0100000000001008
| "swkbd"
|-
| 0x12
| 0100000000001009
| "miiEdit"
|-
| 0x13
| 010000000000100A
| "LibAppletWeb" [[Internet_Browser#010000000000100A|WebApplet]] applet
|-
| 0x14
| 010000000000100B
| "LibAppletShop" [[Internet_Browser#ShopN|ShopN]] applet
|-
| 0x15
| 010000000000100D
| "photoViewer"
|-
| 0x16
| 010000000000100E
|
|-
| 0x17
| 010000000000100F
| "LibAppletOff" [[Internet_Browser#Offline_Applet|Offline]] applet
|-
| 0x18
| 0100000000001010
| "LibAppletLns" [[Internet_Browser#Whitelisted_Applets|Whitelisted]] applet
|-
| 0x19
| 0100000000001011
| "LibAppletAuth" [[Internet_Browser#WifiWebAuthApplet|WifiWebAuth]] applet
|-
| 0x1A
| 0100000000001013
| "myPage"
|-
|}

=== LibraryAppletMode ===
{| class="wikitable" border="1"
|-
! ID
! Description
|-
| 0x0
| AllForeground
|-
|}

=== ShimKind ===
This is from strings and code in the [[Internet_Browser| web-applets]].

This indicates the type of web-applet.

{| class="wikitable" border="1"
|-
! shimKind value
! Description
|-
| 2
| LoginApplet
|-
| 4
| ShareApplet
|-
| 5
| WebApplet
|-
| 6
| WifiWebAuthApplet
|-
| 7
| LobbyApplet
|}

=== NotificationMessage ===
{| class="wikitable" border="1"
|-
! ID
! Description
|-
| 0xF || [[#GetCurrentFocusState|FocusState]] changed
|-
| 0x10 || ?
|-
| 0x1E || OperationMode changed
|-
| 0x1F || PerformanceMode changed
|}

=== OperationMode ===
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0 || Handheld
|-
| 1 || Docked
|}

= AppletResourceUserId =
This u64 is officially called "nn::applet::AppletResourceUserId". Used by a number of non-AM services.

[[Category:Services]]