Nintendo Switch Brew

Changes

Glue services (view source)

Revision as of 20:20, 8 October 2024

8,634 bytes added ,  20:20, 8 October 2024
no edit summary
Line 4: Line 4:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [[#GetApplicationLaunchProperty|GetApplicationLaunchProperty]]
 +
|-
 +
| 1 || [10.0.0+] [[#GetApplicationControlProperty|GetApplicationControlProperty]] ([1.0.0-9.2.0] [[#GetApplicationLaunchPropertyWithApplicationId|GetApplicationLaunchPropertyWithApplicationId]])
 +
|-
 +
| 2 || [10.0.0+] [[#GetApplicationProcessProperty|GetApplicationProcessProperty]] ([1.0.0-9.2.0] [[#GetApplicationControlProperty|GetApplicationControlProperty]])
 +
|-
 +
| 3 || [10.0.0+] [[#GetApplicationInstanceId|GetApplicationInstanceId]] ([1.0.0-9.2.0] [[#GetApplicationControlPropertyWithApplicationId|GetApplicationControlPropertyWithApplicationId]])
 
|-
 
|-
−
| 0 || GetApplicationLaunchProperty || Takes an input u64 ProcessId, returns an [[#ApplicationLaunchProperty]]
+
| 4 || [10.0.0+] [[#GetApplicationInstanceUnregistrationNotifier|GetApplicationInstanceUnregistrationNotifier]]
 
|-
 
|-
−
| 1 || GetApplicationLaunchPropertyWithApplicationId || Takes an input u64 TitleId, returns an [[#ApplicationLaunchProperty]]
+
| 5 || [10.0.0+] [[#ListApplicationInstanceId|ListApplicationInstanceId]]
 
|-
 
|-
−
| 2 || GetApplicationControlProperty || Takes an input u64 ProcessId, returns a type-0x16 buffer filled with the contents of [[NACP_Format|control.nacp]]
+
| 6 || [10.0.0+] [[#GetMicroApplicationInstanceId|GetMicroApplicationInstanceId]]
 
|-
 
|-
−
| 3 || GetApplicationControlPropertyWithApplicationId || Takes an input u64 TitleId, returns a type-0x16 buffer filled with the contents of [[NACP_Format|control.nacp]]
+
| 7 || [10.0.0+] [[#GetApplicationCertificate|GetApplicationCertificate]]
 
|-
 
|-
−
| 9998 || [9.0.0+] GetPreomiaApplicationLaunchProperty ||
+
| 9998 || [9.0.0-9.2.0] [[#GetPreomiaApplicationLaunchProperty|GetPreomiaApplicationLaunchProperty]]
 
|-
 
|-
−
| 9999 || [9.0.0+] GetPreomiaApplicationControlProperty ||
+
| 9999 || [9.0.0-9.2.0] [[#GetPreomiaApplicationControlProperty|GetPreomiaApplicationControlProperty]]
 
|}
 
|}
 +
 +
== GetApplicationLaunchProperty ==
 +
Takes an input u64 ProcessId. Returns an [[#ApplicationLaunchProperty]].
 +
 +
[10.0.0+] Now takes an input [[#ApplicationInstanceId]] instead of ProcessId.
 +
 +
== GetApplicationLaunchPropertyWithApplicationId ==
 +
Takes an input u64 ApplicationId. Returns an [[#ApplicationLaunchProperty]].
 +
 +
== GetApplicationControlProperty ==
 +
Takes an input u64 ProcessId and a type-0x16 output buffer containing an [[NACP|ApplicationControlProperty]]. No output.
 +
 +
[10.0.0+] Now takes an input [[#ApplicationInstanceId]] instead of ProcessId.
 +
 +
== GetApplicationControlPropertyWithApplicationId ==
 +
Takes an input u64 ApplicationId and a type-0x16 output buffer containing an [[NACP|ApplicationControlProperty]]. No output.
 +
 +
== GetApplicationProcessProperty ==
 +
Takes an input [[#ApplicationInstanceId]]. Returns an [[#ApplicationProcessProperty]].
 +
 +
== GetApplicationInstanceId ==
 +
Takes an input u64 ProcessId. Returns an [[#ApplicationInstanceId]].
 +
 +
== GetApplicationInstanceUnregistrationNotifier ==
 +
No input. Returns an [[#IUnregistrationNotifier]].
 +
 +
== ListApplicationInstanceId ==
 +
Takes a type-0x6 output buffer containing an array of [[#ApplicationInstanceId]]. Returns an s32 '''Count'''.
 +
 +
== GetMicroApplicationInstanceId ==
 +
Same as [[#GetApplicationInstanceId]].
 +
 +
== GetApplicationCertificate ==
 +
Takes an input [[#ApplicationInstanceId]] and a type-0x16 output buffer containing an [[#ApplicationCertificate]]. No output.
 +
 +
== GetPreomiaApplicationLaunchProperty ==
 +
Same as [[#GetApplicationLaunchProperty]].
 +
 +
== GetPreomiaApplicationControlProperty ==
 +
Same as [[#GetApplicationControlProperty]].
 +
 +
== IUnregistrationNotifier ==
 +
This is "nn::arp::detail::IUnregistrationNotifier".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || [[#GetReadableHandle|GetReadableHandle]]
 +
|}
 +
 +
=== GetReadableHandle ===
 +
No input. Returns an output readable Event handle.
    
= arp:w =
 
= arp:w =
Line 24: Line 85:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [[#AcquireRegistrar|AcquireRegistrar]]
 +
|-
 +
| 1 || [10.0.0+] [[#UnregisterApplicationInstance|UnregisterApplicationInstance]] ([1.0.0-9.2.0] DeleteProperties)
 +
|-
 +
| 2 || [15.0.0+] [[#AcquireApplicationProcessPropertyUpdater|AcquireApplicationProcessPropertyUpdater]] ([10.0.0-14.1.2] [[#AcquireUpdater|AcquireUpdater]])
 
|-
 
|-
−
| 0 || AcquireRegistrar || Returns an [[#IRegistrar]]
+
| 3 || [15.0.0+] [[#AcquireApplicationCertificateUpdater|AcquireApplicationCertificateUpdater]]
 
|-
 
|-
−
| 1 || DeleteProperties || Takes an input u64 unknown
+
| 4 || [19.0.0+] [[#RegisterApplicationControlProperty|RegisterApplicationControlProperty]]
 
|}
 
|}
 +
 +
== AcquireRegistrar ==
 +
No input. Returns an [[#IRegistrar]].
 +
 +
== UnregisterApplicationInstance ==
 +
Takes an input [[#ApplicationInstanceId]]. No output.
 +
 +
== AcquireUpdater ==
 +
Takes an input [[#ApplicationInstanceId]]. Returns an [[#IUpdater]].
 +
 +
== AcquireApplicationProcessPropertyUpdater ==
 +
Takes an input [[#ApplicationInstanceId]]. Returns an [[#IUpdater]].
 +
 +
== AcquireApplicationCertificateUpdater ==
 +
Takes an input [[#ApplicationInstanceId]]. Returns an [[#IUpdater]].
 +
 +
== RegisterApplicationControlProperty ==
 +
Takes a type-0x15 input buffer containing an [[NACP|ApplicationControlProperty]] and an input [[#ApplicationInstanceId]]. No output.
    
== IRegistrar ==
 
== IRegistrar ==
Line 36: Line 121:  
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [[#Issue|Issue]]
 +
|-
 +
| 1 || [[#SetApplicationLaunchProperty|SetApplicationLaunchProperty]]
 +
|-
 +
| 2 || [1.0.0-18.1.0] [[#SetApplicationControlProperty|SetApplicationControlProperty]]
 +
|}
 +
 
 +
=== Issue ===
 +
No input. Returns an output [[#ApplicationInstanceId]].
 +
 
 +
=== SetApplicationLaunchProperty ===
 +
Takes an input [[#ApplicationLaunchProperty]]. No output.
 +
 
 +
=== SetApplicationControlProperty ===
 +
Takes a type-0x15 input buffer containing an [[NACP|ApplicationControlProperty]]. No output.
 +
 
 +
== IUpdater ==
 +
This is "nn::arp::detail::IUpdater".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || [[#Issue_2|Issue]]
 
|-
 
|-
−
| 0 || Issue || Takes an input u64 unknown
+
| 1 || [[#SetApplicationProcessProperty|SetApplicationProcessProperty]]
 
|-
 
|-
−
| 1 || SetApplicationLaunchProperty || Takes an input [[#ApplicationLaunchProperty]]
+
| 2 || [[#DeleteApplicationProcessProperty|DeleteApplicationProcessProperty]]
 
|-
 
|-
−
| 2 || SetApplicationControlProperty || Takes an input type-0x15 buffer filled with the contents of [[NACP_Format|control.nacp]]
+
| 3 || [[#SetApplicationCertificate|SetApplicationCertificate]]
 
|}
 
|}
 +
 +
=== Issue ===
 +
No input/output.
 +
 +
=== SetApplicationProcessProperty ===
 +
Takes an input u64 ProcessId and an input [[#ApplicationProcessProperty]]. No output.
 +
 +
=== DeleteApplicationProcessProperty ===
 +
No input/output.
 +
 +
=== SetApplicationCertificate ===
 +
Takes a type-0x15 input buffer containing an [[#ApplicationCertificate]]. No output.
    
= bgtc:t =
 
= bgtc:t =
 +
This is "nn::bgtc::ITaskService".
 +
 +
[11.0.0+] This is "nn::bgtc::ITaskServiceRoot".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 100 || [[#CreateTaskService]]
 +
|}
 +
 +
== CreateTaskService ==
 +
No input. Returns an [[#ITaskService]].
 +
 +
== ITaskService ==
 
This is "nn::bgtc::ITaskService".
 
This is "nn::bgtc::ITaskService".
   Line 74: Line 211:  
| 15 || SchedulePeriodicTask
 
| 15 || SchedulePeriodicTask
 
|-
 
|-
−
| 16 || [9.0.0+]
+
| 16 || [9.0.0+] ScheduleStrictTask
 
|-
 
|-
 
| 101 || [3.0.0+] GetOperationMode
 
| 101 || [3.0.0+] GetOperationMode
Line 81: Line 218:  
|-
 
|-
 
| 103 || [3.0.0+] WillStayHalfAwakeInsteadSleep
 
| 103 || [3.0.0+] WillStayHalfAwakeInsteadSleep
 +
|-
 +
| 200 || [12.0.0+] EnableStayHalfAwake
 
|}
 
|}
   Line 100: Line 239:  
| 5 || [3.0.0+] SetIsUsingSleepUnsupportedDevices
 
| 5 || [3.0.0+] SetIsUsingSleepUnsupportedDevices
 
|}
 
|}
 +
 +
[10.0.0+] NotifyEnteringHalfAwake now takes 1-byte of input.
    
= time:a, time:r, time:u =
 
= time:a, time:r, time:u =
Line 153: Line 294:  
|-
 
|-
 
| 501 || [4.0.0+] CalculateSpanBetween ||  
 
| 501 || [4.0.0+] CalculateSpanBetween ||  
 +
|-
 +
| 600 || [19.0.0+] GetInitialLaunchEndTime ||
 
|}
 
|}
   Line 424: Line 567:     
= notif:s =
 
= notif:s =
−
This is "nn::notification::server::INotificationServicesForSystem".
+
This is "nn::notification::server::INotificationServices".
    
This was added with [9.0.0+].
 
This was added with [9.0.0+].
Line 442: Line 585:  
| 540 || [[#DeleteAlarmSetting]]
 
| 540 || [[#DeleteAlarmSetting]]
 
|-
 
|-
−
| 1000 ||  
+
| 1000 || [[#GetNotificationCount]]
 
|-
 
|-
−
| 1010 || [[#ListNotifications]]
+
| 1010 || ListNotifications
 
|-
 
|-
−
| 1020 || [[#DeleteNotification]]
+
| 1020 || DeleteNotification
 
|-
 
|-
−
| 1030 || [[#ClearNotifications]]
+
| 1030 || ClearNotifications
 
|-
 
|-
−
| 1040 || [[#OpenNotificationSystemEventAccessor]]
+
| 1040 || [[#GetNotificationSendingNotifier]]
 
|-
 
|-
−
| 1500 || [[#SetPresentationSetting]]
+
| 1500 || SetNotificationPresentationSetting
 
|-
 
|-
−
| 1510 || [[#GetPresentationSetting]]
+
| 1510 || GetNotificationPresentationSetting
 
|-
 
|-
 
| 2000 || [[#GetAlarmSetting]]
 
| 2000 || [[#GetAlarmSetting]]
 
|-
 
|-
−
| 2001 ||
+
| 2001 || GetAlarmSettingWithApplicationParameter
 +
|-
 +
| 2010 || [[#SetAlarmSettingIsMuted]]
 
|-
 
|-
−
| 2010 || [[#MuteAlarmSetting]]
+
| 2020 || [[#IsAlarmSettingDeletable]]
 
|-
 
|-
−
| 2020 || [[#IsAlarmSettingReady]]
+
| 8000 || RegisterAppletResourceUserId
 
|-
 
|-
−
| 8000 ||
+
| 8010 || UnregisterAppletResourceUserId
 
|-
 
|-
−
| 8010 ||
+
| 8999 || [10.0.0+] GetCurrentTime
 
|-
 
|-
−
| 9000 || [[#GetNextAlarm]]
+
| 9000 || [[#GetAlarmSettingNextNotificationTime]]
 
|}
 
|}
   −
== Cmd1000 ==
+
== GetNotificationCount ==
−
No input, returns a total of 4-bytes of output.
+
No input. Returns a total of 4-bytes of output.
   −
== ListNotifications ==
+
== GetNotificationSendingNotifier ==
−
Unofficial name.
+
No input. Returns an output [[#INotificationSystemEventAccessor]].
   −
== DeleteNotification ==
+
== INotificationSystemEventAccessor ==
−
Unofficial name.
+
This is "nn::notification::server::INotificationSystemEventAccessor".
   −
== ClearNotifications ==
+
This was added with [9.0.0+].
−
Unofficial name.
     −
No input/output.
+
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || GetSystemEvent
 +
|}
 +
 
 +
== GetAlarmSetting ==
 +
Takes an input [[#AlarmSettingId]]. Returns an [[#AlarmSetting]].
 +
 
 +
== SetAlarmSettingIsMuted ==
 +
Takes an input [[#AlarmSettingId]] and a bool. No output.
 +
 
 +
== IsAlarmSettingDeletable ==
 +
Takes an input [[#AlarmSettingId]]. Returns a bool.
 +
 
 +
== GetAlarmSettingNextNotificationTime ==
 +
Takes an input [[#AlarmSettingId]]. Returns an u8 '''IsAlarmScheduled''' and a [[Glue_services#PosixTime|PosixTime]] for the next scheduled alarm.
 +
 
 +
= ectx:w =
 +
This is "nn::err::context::IWriterForSystem".
 +
 
 +
This was added with [11.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || [[#CreateContextRegistrar]]
 +
|-
 +
| 1 || CommitContext
 +
|-
 +
| 2 || RemoveContext
 +
|}
 +
 
 +
== CreateContextRegistrar ==
 +
No input. Returns an [[#IContextRegistrar]].
 +
 
 +
== IContextRegistrar ==
 +
This is "nn::err::context::IContextRegistrar".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || Complete
 +
|}
 +
 
 +
= ectx:r =
 +
This is "nn::err::context::IReaderForSystem".
 +
 
 +
This was added with [11.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || GetContextInfo
 +
|-
 +
| 1 || PullContext
 +
|-
 +
| 2 || ListContextDescriptorWithResultForDebug
 +
|}
 +
 
 +
= ectx:aw =
 +
This is "nn::err::context::IWriterForApplication".
 +
 
 +
This was added with [11.0.0+].  
   −
== OpenNotificationSystemEventAccessor ==
+
{| class="wikitable" border="1"
−
Unofficial name.
+
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || [[#CreateContextRegistrar]]
 +
|-
 +
| 1 || CommitContext
 +
|}
   −
No input, returns an output [[#INotificationSystemEventAccessor]].
+
= pl:u =
 +
This is "nn::pl::sharedresource::detail::IPlatformSharedResourceManager".
   −
== INotificationSystemEventAccessor ==
+
This was added with [16.0.0+].
−
This is "nn::notification::server::INotificationSystemEventAccessor".
     −
This was added with [9.0.0+].
+
This has max_sessions 5.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 499: Line 716:  
! Cmd || Name
 
! Cmd || Name
 
|-
 
|-
−
| 0 ||  
+
| 0 || [[#RequestLoad]]
 +
|-
 +
| 1 || [[#GetLoadState]]
 +
|-
 +
| 2 || [[#GetSize]]
 +
|-
 +
| 3 || [[#GetSharedMemoryAddressOffset]]
 +
|-
 +
| 4 || [[#GetSharedMemoryNativeHandle]]
 +
|-
 +
| 5 || [[#GetSharedFontInOrderOfPriority]]
 +
|-
 +
| 6 || GetSharedFontInOrderOfPriorityForSystem
 +
|}
 +
 
 +
== RequestLoad ==
 +
Takes a [[#SharedFontType]] (uint32), no output.
 +
 
 +
== GetLoadState ==
 +
Takes a [[#SharedFontType]] (uint32), returns the [[#LoadState]] (uint32).
 +
 
 +
=== LoadState ===
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value || Description
 +
|-
 +
| 0x00 || Loading
 +
|-
 +
| 0x01 || Loaded
 
|}
 
|}
   −
Cmd0: no input, returns an output handle.
+
== GetSize ==
 +
Takes a [[#SharedFontType]] (uint32), returns the Font Size (uint32).
   −
== SetPresentationSetting ==
+
== GetSharedMemoryAddressOffset ==
−
Unofficial name.
+
Takes a [[#SharedFontType]] (uint32), returns the offset (uint32) to the Font Address.
   −
== GetPresentationSetting ==
+
== GetSharedMemoryNativeHandle ==
−
Unofficial name.
+
No input, returns an output SharedMemory handle.
   −
== GetAlarmSetting ==
+
User-processes map this SharedMemory with size=0x1100000 and permissions=R--.
−
Unofficial name.
     −
Takes an input [[#AlarmSettingId]]. Returns an [[#AlarmSetting]].
+
Font data is TTF, located at the offset returned by [[#GetSharedMemoryAddressOffset]].
   −
== MuteAlarmSetting ==
+
== GetSharedFontInOrderOfPriority ==
−
Unofficial name.
+
Takes an input u64 [[Settings_services#LanguageCode|LanguageCode]] and 3 type-0x6 output buffers, returns an output u8 and u32. The u8 is a bool to specify if the fonts are loaded or not and the u32 is the font count.
 +
The first buffer contains a list of [[#SharedFontType|Shared font types]], the second buffer contains the font offsets and the final buffer contains the font sizes.
 +
The buffers are an array of u32s which specify information about a specific font. Buffer1[n] is related to Buffer2[n] and Buffer3[n].
 +
Example: Font index 0s offset is at Buffer2[0], size is at Buffer3[0].
 +
The fonts are relative to the shared memory created by [[#GetSharedFontSharedMemoryHandle]]
   −
Takes an input [[#AlarmSettingId]] and a bool.
+
== SharedFontType ==
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value || Description
 +
|-
 +
| 0x00 || Japan, US and Europe (Standard)
 +
|-
 +
| 0x01 || Chinese Simplified
 +
|-
 +
| 0x02 || Extended Chinese Simplified
 +
|-
 +
| 0x03 || Chinese Traditional
 +
|-
 +
| 0x04 || Korean (Hangul)
 +
|-
 +
| 0x05 || Nintendo Extended
 +
|}
   −
== IsAlarmSettingReady ==
+
* Nintendo Extended: Contains Nintendo-specific characters, including HID buttons, HID controller styles, applet icons, Wii(U) icons,  etc.
−
Unofficial name.
     −
Takes an input [[#AlarmSettingId]]. Returns a bool.
+
= ApplicationInstanceId =
 +
This is "nn::arp::ApplicationInstanceId".
 +
 
 +
This is an u64 ID bound to an application instance.  
   −
== GetNextAlarm ==
+
= ApplicationKind =
−
Unofficial name.
+
This is "nn::arp::ApplicationKind".
   −
Takes an input [[#AlarmSettingId]]. Returns an u8 '''IsAlarmScheduled''' and a [[Glue_services#PosixTime|PosixTime]] for the next scheduled alarm.
+
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Application
 +
|-
 +
| 1 || MicroApplication
 +
|}
    
= ApplicationLaunchProperty =
 
= ApplicationLaunchProperty =
−
Total size is 0x10 bytes.
+
This is "nn::arp::ApplicationLaunchProperty".
 +
 
 +
This is a 0x10-byte struct.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 541: Line 818:  
| 0x00
 
| 0x00
 
| 0x08
 
| 0x08
−
| Title ID
+
| [[NCM_services#ProgramId|Id]]
 
|-
 
|-
 
| 0x08
 
| 0x08
Line 549: Line 826:  
| 0x0C
 
| 0x0C
 
| 0x01
 
| 0x01
−
| Base Game [[Filesystem_services#StorageId|Storage Id]]
+
| [[Filesystem_services#StorageId|Storage]]
 
|-
 
|-
 
| 0x0D
 
| 0x0D
 
| 0x01
 
| 0x01
−
| Update [[Filesystem_services#StorageId|Storage Id]]
+
| [[Filesystem_services#StorageId|PatchStorage]]
 
|-
 
|-
 
| 0x0E
 
| 0x0E
−
| 0x02
+
| 0x01
−
| Padding
+
| [[#ApplicationKind|Kind]]
 +
|-
 +
| 0x0F
 +
| 0x01
 +
| Reserved
 
|}
 
|}
 +
 +
= ApplicationProcessProperty =
 +
This is "nn::arp::ApplicationProcessProperty".
 +
 +
This is a 0x1-byte struct.
 +
 +
[17.0.0+] This is a 0x10-byte struct.
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset
 +
! Size
 +
! Description
 +
|-
 +
| 0x00
 +
| 0x01
 +
| ProgramIndex
 +
|-
 +
| 0x01
 +
| 0x0F
 +
|
 +
|}
 +
 +
= ApplicationCertificate =
 +
This is "nn::arp::ApplicationCertificate".
 +
 +
This is a 0x528-byte struct.
    
= AlarmSettingId =
 
= AlarmSettingId =
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/8696...12991"