https://www.3dbrew.org/w/api.php?action=feedcontributions&feedformat=atom&user=ElementW 3dbrew - User contributions [en] 2026-05-12T21:17:43Z User contributions MediaWiki 1.43.1 https://www.3dbrew.org/w/index.php?title=MP:RecvDataFrame&diff=23715 MP:RecvDataFrame 2025-12-29T17:00:04Z <p>ElementW: Use Template:IPC/RequestHeader</p> <hr /> <div>=Request=<br /> {{IPC/Request}}<br /> {{IPC/RequestHeader|0x0011|2|0}}<br /> {{IPC/RequestEntry|Size}}<br /> {{IPC/RequestEntry|u32 nodeID}}<br /> {{IPC/RequestEnd}}<br /> <br /> {{IPC/RequestStaticBuffers}}<br /> {{#vardefine:ipc_offset|0}}<br /> {{IPC/TranslateStaticBuffer|Output buffer address|0}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Response=<br /> {{IPC/Request}}<br /> {{#vardefine:ipc_offset|0}}<br /> {{IPC/RequestEntry|Header code}}<br /> {{IPC/RequestEntry|Result code}}<br /> {{IPC/TranslateStaticBuffer|Output data pointer|0}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Description=<br /> This loads a data frame from a ring-buffer in memory for the specified nodeID, the actual size it uses is fixed to 0x2BC-bytes.</div> ElementW https://www.3dbrew.org/w/index.php?title=FSDir:Read&diff=23317 FSDir:Read 2025-03-01T16:37:36Z <p>ElementW: Convert to IPC templates</p> <hr /> <div>=Request=<br /> {{IPC/Request}}<br /> {{IPC/RequestHeader|0x0801|1|2}}<br /> {{IPC/RequestEntry|[[Filesystem_services#DirectoryEntry|Entry]] Count}}<br /> {{IPC/MapPointerW|[[Filesystem_services#DirectoryEntry|Entry]] Output Pointer|(Entry Count × 0x228)}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Response=<br /> {{IPC/Request}}<br /> {{#vardefine:ipc_offset|0}}<br /> {{IPC/RequestHeader|0x0801|2|0}}<br /> {{IPC/RequestEntry|Result code}}<br /> {{IPC/RequestEntry|Actual Entry Count}}<br /> {{IPC/RequestEnd}}</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/MapPointerRW&diff=23316 Template:IPC/MapPointerRW 2025-03-01T16:36:46Z <p>ElementW: Add ability to set expected buffer size with 2nd template param</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor|0x0000000e {{!}} (size &lt;nowiki&gt;&lt;&lt;&lt;/nowiki&gt; 4)}} for mapping a {{#if:{{{2|}}}|{{{2}}} byte&lt;nowiki&gt; &lt;/nowiki&gt;|}}[[IPC#Buffer_Mapping_Translation|read/write buffer]] in the target process''|descstyle=border-bottom-style:dashed}}<br /> {{IPC/RequestEntry|{{{1}}}|descstyle=border-top-style:none}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> {{Documentation}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/MapPointerR&diff=23315 Template:IPC/MapPointerR 2025-03-01T16:36:15Z <p>ElementW: Add ability to set expected buffer size with 2nd template param</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor|0x0000000a {{!}} (size &lt;nowiki&gt;&lt;&lt;&lt;/nowiki&gt; 4)}} for mapping a {{#if:{{{2|}}}|{{{2}}} byte&lt;nowiki&gt; &lt;/nowiki&gt;|}}[[IPC#Buffer_Mapping_Translation|read-only buffer]] in the target process''|descstyle=border-bottom-style:dashed}}<br /> {{IPC/RequestEntry|{{{1}}}|descstyle=border-top-style:none}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/MapPointerW&diff=23314 Template:IPC/MapPointerW 2025-03-01T16:35:52Z <p>ElementW: Add ability to set expected buffer size with 2nd template param</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor|0x0000000c {{!}} (size &lt;nowiki&gt;&lt;&lt;&lt;/nowiki&gt; 4)}} for mapping a {{#if:{{{2|}}}|{{{2}}} byte&lt;nowiki&gt; &lt;/nowiki&gt;|}}[[IPC#Buffer_Mapping_Translation|write-only buffer]] in the target process''|descstyle=border-bottom-style:dashed}}<br /> {{IPC/RequestEntry|{{{1}}}|descstyle=border-top-style:none}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> {{Documentation}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/MapPointerW/sandbox&diff=23313 Template:IPC/MapPointerW/sandbox 2025-03-01T16:30:31Z <p>ElementW: spacing</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor|0x0000000c {{!}} (size &lt;nowiki&gt;&lt;&lt;&lt;/nowiki&gt; 4)}} for mapping a {{#if:{{{2|}}}|{{{2}}} byte&lt;nowiki&gt; &lt;/nowiki&gt;|}}[[IPC#Buffer_Mapping_Translation|write-only buffer]] in the target process''|descstyle=border-bottom-style:dashed}}<br /> {{IPC/RequestEntry|{{{1}}}|descstyle=border-top-style:none}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/MapPointerW/sandbox&diff=23312 Template:IPC/MapPointerW/sandbox 2025-03-01T16:25:05Z <p>ElementW: Byte count specifier testing</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor|0x0000000c {{!}} (size &lt;nowiki&gt;&lt;&lt;&lt;/nowiki&gt; 4)}} for mapping a {{#if:{{{2|}}}|{{{2}}} byte |}}[[IPC#Buffer_Mapping_Translation|write-only buffer]] in the target process''|descstyle=border-bottom-style:dashed}}<br /> {{IPC/RequestEntry|{{{1}}}|descstyle=border-top-style:none}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/CopyHandle&diff=23309 Template:IPC/CopyHandle 2025-02-09T14:37:48Z <p>ElementW: Dashed bottom border style for use with Template:IPC/CopyHandleEntry</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;{{IPC/RequestEntry|''{{Tooltip|Descriptor| &lt;nowiki&gt;0x00000000 | ((&lt;/nowiki&gt;{{{1|num_handles}}}&lt;nowiki&gt;-1)&lt;&lt;26)&lt;/nowiki&gt; }} for copying {{{1|num_handles}}} handle{{#ifexpr:{{{1|0}}}=1||s}}''|descstyle=border-bottom-style:dashed}}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]&lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:Documentation&diff=22764 Template:Documentation 2024-09-22T16:47:57Z <p>ElementW: Remove SVG image since wiki is broken with them</p> <hr /> <div>&lt;div class=&quot;template-documentation&quot;&gt;&lt;!--<br /> <br /> These are the literal class definitions in common.css:<br /> <br /> /* For template documentation */<br /> .template-documentation {<br /> clear: both;<br /> margin: 1em 0 0 0;<br /> border: 1px solid #aaa; <br /> background-color: #ecfcf4; <br /> padding: 5px;<br /> }<br /> <br /> <br /> --&gt;{{#ifeq:{{{heading|μ}}}|&lt;!--**DEFINED BUT EMPTY**--&gt;<br /> |&lt;!--**NOTHING**--&gt;<br /> |&lt;div style=&quot;padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex&quot;&gt;{{#ifeq:{{{content|μ}}}|μ<br /> |&lt;span class=&quot;editsection plainlinks&quot; id=&quot;doc_editlinks&quot;&gt;{{#ifexist: {{{1|{{Documentation/docname}}}}}<br /> |&lt;!--** /doc EXISTS** --&gt;[[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit}} edit]]<br /> |&lt;!--**/doc DOESN'T EXIST**--&gt;[[{{fullurl:{{{1|{{Documentation/docname }}}}}|action=edit&amp;preload=Template:Documentation/preload}} create]]<br /> }}&lt;/span&gt;<br /> }} &lt;span style=&quot;{{#if:{{{heading-style|}}}|{{{heading-style}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|font-weight: bold; font-size: 125%|font-size: 150%}}}}&quot;&gt;{{#if:{{{heading|}}}|{{{heading}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|Template documentation|Documentation}}}}&lt;/span&gt;&lt;/div&gt;<br /> }}&lt;!--<br /> <br /> --&gt;&lt;div id=&quot;template_doc_page_transcluded&quot; class=&quot;dablink plainlinks&quot;&gt;&lt;!--<br /> --&gt;{{#ifexist: {{{1|{{Documentation/docname}}}}}<br /> |&lt;!--**/doc EXISTS**--&gt;This documentation is transcluded from [[{{{1|{{Documentation/docname}}}}}]]. &lt;small style=&quot;font-style: normal&quot;&gt;([{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit}} edit] &amp;#124; [{{fullurl:{{{1|{{Documentation/docname}}}}}|action=history}} history])&lt;/small&gt;&lt;br /&gt;<br /> }}&lt;!--<br /> <br /> --&gt;{{#switch: {{SUBPAGENAME}}<br /> |sandbox|testcases=&lt;!--**DO NOT SHOW THESE LINKS ON THE SANDBOX/TESTCASES PAGES**--&gt;<br /> |#default=<br /> {{#switch: {{SUBJECTSPACE}}<br /> |{{ns:template}}<br /> |{{ns:user}}=<br /> {{#ifexist: {{FULLPAGENAME}}/sandbox<br /> |This template has a [[/sandbox|sandbox]] &lt;small style=&quot;font-style: normal&quot;&gt;([{{fullurl:{{ #rel2abs: /sandbox }}|action=edit}} edit])&lt;/small&gt; &lt;!--<br /> --&gt;{{#ifexist: {{FULLPAGENAME}}/testcases<br /> |and [[/testcases|testcases]] &lt;small style=&quot;font-style: normal&quot;&gt;([{{fullurl:{{ #rel2abs: /testcases }}|action=edit}} edit])&lt;/small&gt;}} for editors to experiment.<br /> |{{#ifexist: {{FULLPAGENAME}}/testcases<br /> |This template has [[/testcases|testcases]] &lt;small style=&quot;font-style: normal&quot;&gt;([{{fullurl:{{ #rel2abs: /testcases }}|action=edit}} edit])&lt;/small&gt; for editors to experiment.}}<br /> }}}}}}<br /> &lt;/div&gt;<br /> {{#if:{{{content|}}}|{{{content}}}|{{#ifexist:{{{1|{{Documentation/docname}}}}} | {{ {{{1|{{Documentation/docname}}}}} }} }}}}<br /> &lt;/div&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=File:Template-info.svg&diff=22763 File:Template-info.svg 2024-09-20T12:07:12Z <p>ElementW: See [https://commons.wikimedia.org/wiki/File:Template-info.svg commons:File:Template-info.svg]</p> <hr /> <div>== Summary ==<br /> See [https://commons.wikimedia.org/wiki/File:Template-info.svg commons:File:Template-info.svg]</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:ServiceCmdHeaderShort&diff=22762 Template:ServiceCmdHeaderShort 2024-09-20T11:51:03Z <p>ElementW: Created page with &quot;&lt;abbr title=&quot;Command {{{1}}} with {{{2}}} raw parameter and {{{3}}} translate words&quot;&gt;{{{1}}}&lt;span style=&quot;opacity:0.8&quot;&gt;{{ #vardefine:headerlow|{{#expr:{{{3}}}+({{{2}}}*64)}}}}{...&quot;</p> <hr /> <div>&lt;abbr title=&quot;Command {{{1}}} with {{{2}}} raw parameter and {{{3}}} translate words&quot;&gt;{{{1}}}&lt;span style=&quot;opacity:0.8&quot;&gt;{{<br /> #vardefine:headerlow|{{#expr:{{{3}}}+({{{2}}}*64)}}}}{{<br /> #vardefine:looppow|12}}{{#while:<br /> | {{#ifexpr: {{#var:looppow}} &gt;= 0 | true }}<br /> | {{#switch: {{#expr:trunc({{#var:headerlow}}/(2^{{#var:looppow}})) mod 16}}<br /> | 0 = 0<br /> | 1 = 1<br /> | 2 = 2<br /> | 3 = 3<br /> | 4 = 4<br /> | 5 = 5<br /> | 6 = 6<br /> | 7 = 7<br /> | 8 = 8<br /> | 9 = 9<br /> | 10 = A<br /> | 11 = B<br /> | 12 = C<br /> | 13 = D<br /> | 14 = E<br /> | 15 = F<br /> | #default = ?<br /> }}{{#vardefine:looppow|{{#expr:{{#var:looppow}}-4}}}}<br /> }}&lt;/span&gt;&lt;/abbr&gt;&lt;noinclude&gt;<br /> {{Documentation}}<br /> &lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/RequestHeader&diff=22761 Template:IPC/RequestHeader 2024-09-20T11:49:59Z <p>ElementW: Transclude documentation</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;|-<br /> | {{#var:ipc_offset_prefix}}{{#var:ipc_offset}}{{#vardefine:ipc_offset|{{#expr: {{#var:ipc_offset}} + 1}}}}<br /> | <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot; style=&quot;margin:0.2em 0&quot;<br /> |-<br /> ! Header<br /> | {{{1}}}&lt;span style=&quot;opacity:0.8&quot;&gt;{{<br /> #vardefine:headerlow|{{#expr:{{{3}}}+({{{2}}}*64)}}}}{{<br /> #vardefine:looppow|12}}{{#while:<br /> | {{#ifexpr: {{#var:looppow}} &gt;= 0 | true }}<br /> | {{#switch: {{#expr:trunc({{#var:headerlow}}/(2^{{#var:looppow}})) mod 16}}<br /> | 0 = 0<br /> | 1 = 1<br /> | 2 = 2<br /> | 3 = 3<br /> | 4 = 4<br /> | 5 = 5<br /> | 6 = 6<br /> | 7 = 7<br /> | 8 = 8<br /> | 9 = 9<br /> | 10 = A<br /> | 11 = B<br /> | 12 = C<br /> | 13 = D<br /> | 14 = E<br /> | 15 = F<br /> | #default = ?<br /> }}{{#vardefine:looppow|{{#expr:{{#var:looppow}}-4}}}}<br /> }}&lt;/span&gt;<br /> ! &lt;abbr title=&quot;Command ID&quot;&gt;Cmd&lt;/abbr&gt;<br /> | {{{1}}}<br /> ! &lt;abbr title=&quot;Number of raw parameter words&quot;&gt;Param&lt;/abbr&gt;<br /> | {{{2}}}<br /> ! &lt;abbr title=&quot;Number of words in the translate section of the message&quot;&gt;Xlat&lt;/abbr&gt;<br /> | {{{3}}}<br /> |}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> {{Documentation}}<br /> [[Category:IPC message contents templates]]<br /> &lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/RequestHeader&diff=22760 Template:IPC/RequestHeader 2024-09-20T11:41:11Z <p>ElementW: Shade the part of header code derived from param &amp; xlat count</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;|-<br /> | {{#var:ipc_offset_prefix}}{{#var:ipc_offset}}{{#vardefine:ipc_offset|{{#expr: {{#var:ipc_offset}} + 1}}}}<br /> | <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot; style=&quot;margin:0.2em 0&quot;<br /> |-<br /> ! Header<br /> | {{{1}}}&lt;span style=&quot;opacity:0.8&quot;&gt;{{<br /> #vardefine:headerlow|{{#expr:{{{3}}}+({{{2}}}*64)}}}}{{<br /> #vardefine:looppow|12}}{{#while:<br /> | {{#ifexpr: {{#var:looppow}} &gt;= 0 | true }}<br /> | {{#switch: {{#expr:trunc({{#var:headerlow}}/(2^{{#var:looppow}})) mod 16}}<br /> | 0 = 0<br /> | 1 = 1<br /> | 2 = 2<br /> | 3 = 3<br /> | 4 = 4<br /> | 5 = 5<br /> | 6 = 6<br /> | 7 = 7<br /> | 8 = 8<br /> | 9 = 9<br /> | 10 = A<br /> | 11 = B<br /> | 12 = C<br /> | 13 = D<br /> | 14 = E<br /> | 15 = F<br /> | #default = ?<br /> }}{{#vardefine:looppow|{{#expr:{{#var:looppow}}-4}}}}<br /> }}&lt;/span&gt;<br /> ! &lt;abbr title=&quot;Command ID&quot;&gt;Cmd&lt;/abbr&gt;<br /> | {{{1}}}<br /> ! &lt;abbr title=&quot;Number of raw parameter words&quot;&gt;Param&lt;/abbr&gt;<br /> | {{{2}}}<br /> ! &lt;abbr title=&quot;Number of words in the translate section of the message&quot;&gt;Xlat&lt;/abbr&gt;<br /> | {{{3}}}<br /> |}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]<br /> &lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=FS:OpenFile&diff=22759 FS:OpenFile 2024-09-20T08:54:06Z <p>ElementW: Add categories</p> <hr /> <div>=Request=<br /> {{IPC/Request|Request}}<br /> {{IPC/RequestHeader|0x0802|7|2}}<br /> {{IPC/RequestEntry|Transaction (usually 0)}}<br /> {{IPC/RequestEntryRange|2|u64, Archive Handle}}<br /> {{IPC/RequestEntry|[[Filesystem_services#PathType|Path Type]]}}<br /> {{IPC/RequestEntry|Path Size (including null-terminator)}}<br /> {{IPC/RequestEntry|[[Filesystem_services#OpenFlags|Open Flags]]}}<br /> {{IPC/RequestEntry|[[Filesystem_services#Attributes|Attributes]] (usually 0)}}<br /> {{IPC/TranslateStaticBuffer|Path Data Pointer|0}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Response=<br /> {{IPC/Request|Response}}<br /> {{IPC/RequestHeader|0x0802|1|2}}<br /> {{IPC/RequestEntry|Result code}}<br /> {{IPC/MoveHandle|1}}<br /> {{IPC/MoveHandleEntry|File client session handle}}<br /> {{IPC/RequestEnd}}<br /> <br /> [[Category:fs:USER commands]]<br /> [[Category:fs:LDR commands]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Camera_Services&diff=22757 Camera Services 2024-09-19T06:09:37Z <p>ElementW: Add anchors</p> <hr /> <div>__TOC__<br /> {{Anchor|CAMC}}{{Anchor|cam:c}}<br /> ==cam:c (PORT_REG) ==<br /> Same as [[#cam:u_.28PORT_USER.29|cam:u]]<br /> <br /> {{Anchor|CAMS}}{{Anchor|cam:s}}<br /> ==cam:s (PORT_CAL) ==<br /> Same as [[#cam:u_.28PORT_USER.29|cam:u]]<br /> <br /> {{Anchor|CAMQ}}{{Anchor|cam:q}}<br /> ==cam:q (PORT_QTM) ==<br /> This was added with New3DS.<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | [[CAMU:StartCapture|StartCapture]]<br /> |-<br /> | 0x00020040<br /> | [[CAMU:StopCapture|StopCapture]]<br /> |-<br /> | 0x0003004?<br /> | [[CAMU:IsBusy|IsBusy]]<br /> |-<br /> | 0x00040040<br /> | [[CAMU:ClearBuffer|ClearBuffer]]<br /> |-<br /> | 0x0005004?<br /> | [[CAMU:GetVsyncInterruptEvent|GetVsyncInterruptEvent]]<br /> |-<br /> | 0x0006004?<br /> | [[CAMU:GetBufferErrorInterruptEvent|GetBufferErrorInterruptEvent]]<br /> |-<br /> | 0x0007????<br /> | [[CAMU:StartRecieving|StartRecieving]]<br /> |-<br /> | 0x00080040<br /> | [[CAMU:IsFinishedRecieving|IsFinishedRecieving]]<br /> |-<br /> | 0x00090100<br /> | [[CAMU:SetTransferLines|SetTransferLines]]<br /> |-<br /> | 0x000A008?<br /> | [[CAMU:GetMaxLines|GetMaxLines]]<br /> |-<br /> | 0x000B0100<br /> | [[CAMU:SetTransferBytes|SetTransferBytes]]<br /> |-<br /> | 0x000C004?<br /> | [[CAMU:GetTransferBytes|GetTransferBytes]]<br /> |-<br /> | 0x000D008?<br /> | [[CAMU:GetMaxBytes|GetMaxBytes]]<br /> |-<br /> | 0x000E0080<br /> | [[CAMU:SetTrimming|SetTrimming]]<br /> |-<br /> | 0x000F004?<br /> | [[CAMU:IsTrimming|IsTrimming]]<br /> |-<br /> | 0x00100140<br /> | [[CAMU:SetTrimmingParams|SetTrimmingParams]]<br /> |-<br /> | 0x0011????<br /> | [[CAMU:GetTrimmingParams|GetTrimmingParams]]<br /> |-<br /> | 0x00120140<br /> | [[CAMU:SetTrimmingParamsCenter|SetTrimmingParamsCenter]]<br /> |-<br /> | 0x00130040<br /> | [[CAMU:Activate|Activate]]<br /> |-<br /> | 0x00140080<br /> | [[CAMU:SwitchContext|SwitchContext]]<br /> |-<br /> | 0x00150080<br /> | [[CAMU:SetExposure|SetExposure]]<br /> |-<br /> | 0x00160080<br /> | [[CAMU:SetWhiteBalance|SetWhiteBalance]]<br /> |-<br /> | 0x00170080<br /> | [[CAMU:SetSharpness|SetSharpness]]<br /> |-<br /> | 0x00180080<br /> | [[CAMU:SetAutoExposure|SetAutoExposure]]<br /> |-<br /> | 0x0019004?<br /> | [[CAMU:IsAutoExposure|IsAutoExposure]]<br /> |-<br /> | 0x001A0080<br /> | [[CAMU:SetAutoWhiteBalance|SetAutoWhiteBalance]]<br /> |-<br /> | 0x001B004?<br /> | [[CAMU:IsAutoWhiteBalance|IsAutoWhiteBalance]]<br /> |-<br /> | 0x001C00C0<br /> | [[CAMU:FlipImage|FlipImage]]<br /> |-<br /> | 0x001D020?<br /> | [[CAMU:SetDetailSize|SetDetailSize]]<br /> |-<br /> | 0x001E00C0<br /> | [[CAMU:SetSize|SetSize]]<br /> |-<br /> | 0x001F0080<br /> | [[CAMU:SetFrameRate|SetFrameRate]]<br /> |-<br /> | 0x00200080<br /> | [[CAMU:SetPhotoMode|SetPhotoMode]]<br /> |-<br /> | 0x002100C0<br /> | [[CAMU:SetEffect|SetEffect]]<br /> |-<br /> | 0x00220080<br /> | [[CAMU:SetContrast|SetContrast]]<br /> |-<br /> | 0x00230080<br /> | [[CAMU:SetLensCorrection|SetLensCorrection]]<br /> |-<br /> | 0x002400C0<br /> | [[CAMU:SetOutputFormat|SetOutputFormat]]<br /> |-<br /> | 0x0025014?<br /> | [[CAMU:SetAutoExposureWindow|SetAutoExposureWindow]]<br /> |-<br /> | 0x0026014?<br /> | [[CAMU:SetAutoWhiteBalanceWindow|SetAutoWhiteBalanceWindow]]<br /> |-<br /> | 0x00270080<br /> | [[CAMU:SetNoiseFilter|SetNoiseFilter]]<br /> |-<br /> | 0x00280080<br /> | [[CAMU:SyncronizeVsyncTiming|SyncronizeVsyncTiming]]<br /> |-<br /> | 0x0029????<br /> | [[CAMU:GetLatestVsyncTiming|GetLatestVsyncTiming]]<br /> |-<br /> | 0x002A????<br /> | [[CAMU:GetStereoCallibrationData|GetStereoCallibrationData]]<br /> |-<br /> | 0x002B????<br /> | [[CAMU:SetPackageParameterWithoutContext|SetPackageParameterWithoutContext]]<br /> |-<br /> | 0x002C0080<br /> | [[CAMU:SetPackageParameterWithContext|SetPackageParameterWithContext]]<br /> |-<br /> | 0x002D????<br /> | [[CAMU:SetPackageParameterWithContextDetail|SetPackageParameterWithContextDetail]]<br /> |-<br /> | 0x002E???<br /> | [[CAMU:GetSuitableY2RStandardCoeffecient|GetSuitableY2RStandardCoeffecient]]<br /> |-<br /> | 0x002F<br /> | [[CAMU:PlayShutterSoundWithWave|PlayShutterSoundWithWave]]<br /> |-<br /> | 0x0030????<br /> | [[CAMU:PlayShutterSound|GetShutterSound]]<br /> |-<br /> | 0x0031000?<br /> | [[CAMU:DriverInitailize|DriverInitialize]]<br /> |-<br /> | 0x0032000?<br /> | [[CAMU:DriverFinalize|DriverFinalize]]<br /> |-<br /> | 0x0033000?<br /> | [[CAMU:GetActivatedCamera|GetActivatedCamera]]<br /> |-<br /> | 0x0034000?<br /> | [[CAMU:GetSleepCamera|GetSleepCamera]]<br /> |-<br /> | 0x00350040<br /> | [[CAMU:SetSleepCamera|SetSleepCamera]]<br /> |-<br /> | 0x00360040<br /> | [[CAMU:SetBrightnessSyncronization|SetBrightnessSyncronization]]<br /> |-<br /> | 0x0037004?<br /> | ???<br /> |-<br /> | 0x0038000?<br /> | ???<br /> |-<br /> | 0x0039004?<br /> | ???<br /> |-<br /> | 0x003A0080<br /> | ???<br /> |-<br /> | 0x003B004?<br /> | ???<br /> |-<br /> | 0x003C0080<br /> | ???<br /> |-<br /> | 0x003D000?<br /> | ???<br /> |-<br /> | 0x003E0000<br /> | ???<br /> |}<br /> <br /> Most commands are same as cam:u, although, with different command headers since some commands which are available in cam:u do not exist in cam:q<br /> <br /> {{Anchor|CAMU}}{{Anchor|cam:u}}<br /> ==cam:u (PORT_USER)==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | [[CAMU:StartCapture|StartCapture]]<br /> |-<br /> | 0x00020040<br /> | [[CAMU:StopCapture|StopCapture]]<br /> |-<br /> | 0x00030040<br /> | [[CAMU:IsBusy|IsBusy]]<br /> |-<br /> | 0x00040040<br /> | [[CAMU:ClearBuffer|ClearBuffer]]<br /> |-<br /> | 0x00050040<br /> | [[CAMU:GetVsyncInterruptEvent|GetVsyncInterruptEvent]]<br /> |-<br /> | 0x00060040<br /> | [[CAMU:GetBufferErrorInterruptEvent|GetBufferErrorInterruptEvent]]<br /> |-<br /> | 0x00070102<br /> | [[CAMU:SetReceiving|SetReceiving]]<br /> |-<br /> | 0x00080040<br /> | [[CAMU:IsFinishedReceiving|IsFinishedReceiving]]<br /> |-<br /> | 0x00090100<br /> | [[CAMU:SetTransferLines|SetTransferLines]]<br /> |-<br /> | 0x000A0080<br /> | [[CAMU:GetMaxLines|GetMaxLines]]<br /> |-<br /> | 0x000B0100<br /> | [[CAMU:SetTransferBytes|SetTransferBytes]]<br /> |-<br /> | 0x000C0040<br /> | [[CAMU:GetTransferBytes|GetTransferBytes]]<br /> |-<br /> | 0x000D0080<br /> | [[CAMU:GetMaxBytes|GetMaxBytes]]<br /> |-<br /> | 0x000E0080<br /> | [[CAMU:SetTrimming|SetTrimming]]<br /> |-<br /> | 0x000F0040<br /> | [[CAMU:IsTrimming|IsTrimming]]<br /> |-<br /> | 0x00100140<br /> | [[CAMU:SetTrimmingParams|SetTrimmingParams]]<br /> |-<br /> | 0x00110040<br /> | [[CAMU:GetTrimmingParams|GetTrimmingParams]]<br /> |-<br /> | 0x00120140<br /> | [[CAMU:SetTrimmingParamsCenter|SetTrimmingParamsCenter]]<br /> |-<br /> | 0x00130040<br /> | [[CAMU:Activate|Activate]]<br /> |-<br /> | 0x00140080<br /> | [[CAMU:SwitchContext|SwitchContext]]<br /> |-<br /> | 0x00150080<br /> | [[CAMU:SetExposure|SetExposure]]<br /> |-<br /> | 0x00160080<br /> | [[CAMU:SetWhiteBalance|SetWhiteBalance]]<br /> |-<br /> | 0x00170080<br /> | [[CAMU:SetWhiteBalanceWithoutBaseUp|SetWhiteBalanceWithoutBaseUp]]<br /> |-<br /> | 0x00180080<br /> | [[CAMU:SetSharpness|SetSharpness]]<br /> |-<br /> | 0x00190080<br /> | [[CAMU:SetAutoExposure|SetAutoExposure]]<br /> |-<br /> | 0x001A0040<br /> | [[CAMU:IsAutoExposure|IsAutoExposure]]<br /> |-<br /> | 0x001B0080<br /> | [[CAMU:SetAutoWhiteBalance|SetAutoWhiteBalance]]<br /> |-<br /> | 0x001C0040<br /> | [[CAMU:IsAutoWhiteBalance|IsAutoWhiteBalance]]<br /> |-<br /> | 0x001D00C0<br /> | [[CAMU:FlipImage|FlipImage]]<br /> |-<br /> | 0x001E0200<br /> | [[CAMU:SetDetailSize|SetDetailSize]]<br /> |-<br /> | 0x001F00C0<br /> | [[CAMU:SetSize|SetSize]]<br /> |-<br /> | 0x00200080<br /> | [[CAMU:SetFrameRate|SetFrameRate]]<br /> |-<br /> | 0x00210080<br /> | [[CAMU:SetPhotoMode|SetPhotoMode]]<br /> |-<br /> | 0x002200C0<br /> | [[CAMU:SetEffect|SetEffect]]<br /> |-<br /> | 0x00230080<br /> | [[CAMU:SetContrast|SetContrast]]<br /> |-<br /> | 0x00240080<br /> | [[CAMU:SetLensCorrection|SetLensCorrection]]<br /> |-<br /> | 0x002500C0<br /> | [[CAMU:SetOutputFormat|SetOutputFormat]]<br /> |-<br /> | 0x00260140<br /> | [[CAMU:SetAutoExposureWindow|SetAutoExposureWindow]]<br /> |-<br /> | 0x00270140<br /> | [[CAMU:SetAutoWhiteBalanceWindow|SetAutoWhiteBalanceWindow]]<br /> |-<br /> | 0x00280080<br /> | [[CAMU:SetNoiseFilter|SetNoiseFilter]]<br /> |-<br /> | 0x00290080<br /> | [[CAMU:SynchronizeVsyncTiming|SynchronizeVsyncTiming]]<br /> |-<br /> | 0x002A0080<br /> | [[CAMU:GetLatestVsyncTiming|GetLatestVsyncTiming]]<br /> |-<br /> | 0x002B0000<br /> | [[CAMU:GetStereoCameraCalibrationData|GetStereoCameraCalibrationData]]<br /> |-<br /> | 0x002C0400<br /> | [[CAMU:SetStereoCameraCalibrationData|SetStereoCameraCalibrationData]]<br /> |-<br /> | 0x002D00C0<br /> | [[CAMU:WriteRegisterI2c|WriteRegisterI2c]]<br /> |-<br /> | 0x002E00C0<br /> | [[CAMU:WriteMcuVariableI2c|WriteMcuVariableI2c]]<br /> |-<br /> | 0x002F0080<br /> | [[CAMU:ReadRegisterI2cExclusive|ReadRegisterI2cExclusive]]<br /> |-<br /> | 0x00300080<br /> | [[CAMU:ReadMcuVariableI2cExclusive|ReadMcuVariableI2cExclusive]]<br /> |-<br /> | 0x00310180<br /> | [[CAMU:SetImageQualityCalibrationData|SetImageQualityCalibrationData]]<br /> |-<br /> | 0x00320000<br /> | [[CAMU:GetImageQualityCalibrationData|GetImageQualityCalibrationData]]<br /> |-<br /> | 0x003302C0<br /> | [[CAMU:SetPackageParameterWithoutContext|SetPackageParameterWithoutContext]]<br /> |-<br /> | 0x00340140<br /> | [[CAMU:SetPackageParameterWithContext|SetPackageParameterWithContext]]<br /> |-<br /> | 0x003501C0<br /> | [[CAMU:SetPackageParameterWithContextDetail|SetPackageParameterWithContextDetail]]<br /> |-<br /> | 0x00360000<br /> | [[CAMU:GetSuitableY2rStandardCoefficient|GetSuitableY2rStandardCoefficient]]<br /> |-<br /> | 0x00370202<br /> | [[CAMU:PlayShutterSoundWithWave|PlayShutterSoundWithWave]]<br /> |-<br /> | 0x00380040<br /> | [[CAMU:PlayShutterSound|PlayShutterSound]]<br /> |-<br /> | 0x00390000<br /> | [[CAMU:DriverInitialize|DriverInitialize]]<br /> |-<br /> | 0x003A0000<br /> | [[CAMU:DriverFinalize|DriverFinalize]]<br /> |-<br /> | 0x003B0000<br /> | [[CAMU:GetActivatedCamera|GetActivatedCamera]]<br /> |-<br /> | 0x003C0000<br /> | [[CAMU:GetSleepCamera|GetSleepCamera]]<br /> |-<br /> | 0x003D0040<br /> | [[CAMU:SetSleepCamera|SetSleepCamera]]<br /> |-<br /> | 0x003E0040<br /> | [[CAMU:SetBrightnessSynchronization|SetBrightnessSynchronization]]<br /> |-<br /> | 0x003F0040<br /> | Stubbed, always returns 0<br /> |-<br /> | 0x004000C0<br /> | ???<br /> |-<br /> | 0x00410040<br /> | Stubbed, returns D8A053EA if flag is not 1<br /> |-<br /> | 0x00420040<br /> | ???<br /> |-<br /> | 0x00430000<br /> | Stubbed, returns D8A053EA if flag is not 1<br /> |-<br /> | 0x00440000<br /> | Stubbed, returns D8A053EA if flag is not 1<br /> |}<br /> <br /> ===Port===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | PORT_NONE<br /> | 0x0<br /> |-<br /> | PORT_CAM1<br /> | 0x1 &lt;&lt; 0x0<br /> |-<br /> | PORT_CAM2<br /> | 0x1 &lt;&lt; 0x1<br /> |-<br /> | PORT_BOTH<br /> | PORT_CAM1 &lt;nowiki&gt;|&lt;/nowiki&gt; PORT_CAM2<br /> |}<br /> <br /> ===CameraSelect===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | SELECT_NONE<br /> | 0x0<br /> |-<br /> | SELECT_OUT1<br /> | 0x1 &lt;&lt; 0x0<br /> |-<br /> | SELECT_IN1 <br /> | 0x1 &lt;&lt; 0x1<br /> |-<br /> | SELECT_OUT2<br /> | 0x1 &lt;&lt; 0x2<br /> |-<br /> | SELECT_IN1_OUT1 <br /> | SELECT_OUT1 &lt;nowiki&gt;|&lt;/nowiki&gt; SELECT_IN1<br /> |-<br /> | SELECT_OUT1_OUT2<br /> | SELECT_OUT1 &lt;nowiki&gt;|&lt;/nowiki&gt; SELECT_OUT2<br /> |-<br /> | SELECT_IN1_OUT2 <br /> | SELECT_IN1 &lt;nowiki&gt;|&lt;/nowiki&gt; SELECT_OUT2<br /> |-<br /> | SELECT_ALL <br /> | SELECT_OUT1 &lt;nowiki&gt;|&lt;/nowiki&gt; SELECT_IN1 &lt;nowiki&gt;|&lt;/nowiki&gt; SELECT_OUT2<br /> |}<br /> <br /> ===Context===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | CONTEXT_NONE<br /> | 0x0<br /> |-<br /> | CONTEXT_A <br /> | 0x1 &lt;&lt; 0x0<br /> |-<br /> | CONTEXT_B <br /> | 0x1 &lt;&lt; 0x1<br /> |-<br /> | CONTEXT_BOTH<br /> | CONTEXT_A &lt;nowiki&gt;|&lt;/nowiki&gt; CONTEXT_B<br /> |}<br /> <br /> ===Flip===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | FLIP_NONE <br /> | 0x0<br /> |-<br /> | FLIP_HORIZONTAL<br /> | 0x1<br /> |-<br /> | FLIP_VERTICAL <br /> | 0x2<br /> |-<br /> | FLIP_REVERSE <br /> | 0x3<br /> |}<br /> <br /> ===Size===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | SIZE_VGA <br /> | 0x0<br /> |-<br /> | SIZE_QVGA <br /> | 0x1<br /> |-<br /> | SIZE_QQVGA <br /> | 0x2<br /> |-<br /> | SIZE_CIF <br /> | 0x3<br /> |-<br /> | SIZE_QCIF <br /> | 0x4<br /> |-<br /> | SIZE_DS_LCD <br /> | 0x5<br /> |-<br /> | SIZE_DS_LCDx4 <br /> | 0x6<br /> |-<br /> | SIZE_CTR_TOP_LCD<br /> | 0x7<br /> |-<br /> | SIZE_CTR_BOTTOM_LCD<br /> | SIZE_QVGA<br /> |}<br /> <br /> ===FrameRate===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | FRAME_RATE_15 <br /> | 0x0<br /> |-<br /> | FRAME_RATE_15_TO_5 <br /> | 0x1<br /> |-<br /> | FRAME_RATE_15_TO_2 <br /> | 0x2<br /> |-<br /> | FRAME_RATE_10 <br /> | 0x3<br /> |-<br /> | FRAME_RATE_8_5 <br /> | 0x4<br /> |-<br /> | FRAME_RATE_5 <br /> | 0x5<br /> |-<br /> | FRAME_RATE_20 <br /> | 0x6<br /> |-<br /> | FRAME_RATE_20_TO_5 <br /> | 0x7<br /> |-<br /> | FRAME_RATE_30 <br /> | 0x8<br /> |-<br /> | FRAME_RATE_30_TO_5 <br /> | 0x9<br /> |-<br /> | FRAME_RATE_15_TO_10<br /> | 0xA<br /> |-<br /> | FRAME_RATE_20_TO_10<br /> | 0xB<br /> |-<br /> | FRAME_RATE_30_TO_10<br /> | 0xC<br /> |}<br /> <br /> ===WhiteBalance===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | WHITE_BALANCE_AUTO <br /> | 0x0<br /> |-<br /> | WHITE_BALANCE_3200K<br /> | 0x1<br /> |-<br /> | WHITE_BALANCE_4150K<br /> | 0x2<br /> |-<br /> | WHITE_BALANCE_5200K<br /> | 0x3<br /> |-<br /> | WHITE_BALANCE_6000K<br /> | 0x4<br /> |-<br /> | WHITE_BALANCE_7000K<br /> | 0x5<br /> |-<br /> | WHITE_BALANCE_MAX <br /> | 0x6<br /> |-<br /> | WHITE_BALANCE_NORMAL <br /> | WHITE_BALANCE_AUTO<br /> |-<br /> | WHITE_BALANCE_TUNGSTEN <br /> | WHITE_BALANCE_3200K<br /> |-<br /> | WHITE_BALANCE_WHITE_FLUORESCENT_LIGHT<br /> | WHITE_BALANCE_4150K<br /> |-<br /> | WHITE_BALANCE_DAYLIGHT <br /> | WHITE_BALANCE_5200K<br /> |-<br /> | WHITE_BALANCE_CLOUDY <br /> | WHITE_BALANCE_6000K<br /> |-<br /> | WHITE_BALANCE_HORIZON <br /> | WHITE_BALANCE_6000K<br /> |-<br /> | WHITE_BALANCE_SHADE <br /> | WHITE_BALANCE_7000K<br /> |}<br /> <br /> ===PhotoMode===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | PHOTO_MODE_NORMAL <br /> | 0x0<br /> |-<br /> | PHOTO_MODE_PORTRAIT <br /> | 0x1<br /> |-<br /> | PHOTO_MODE_LANDSCAPE<br /> | 0x2<br /> |-<br /> | PHOTO_MODE_NIGHTVIEW<br /> | 0x3<br /> |-<br /> | PHOTO_MODE_LETTER <br /> | 0x4<br /> |}<br /> <br /> ===Effect===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | EFFECT_NONE <br /> | 0x0<br /> |-<br /> | EFFECT_MONO <br /> | 0x1<br /> |-<br /> | EFFECT_SEPIA <br /> | 0x2<br /> |-<br /> | EFFECT_NEGATIVE<br /> | 0x3<br /> |-<br /> | EFFECT_NEGAFILM<br /> | 0x4<br /> |-<br /> | EFFECT_SEPIA01 <br /> | 0x5<br /> |}<br /> <br /> ===Contrast===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | CONTRAST_PATTERN_01<br /> | 0x0<br /> |-<br /> | CONTRAST_PATTERN_02<br /> | 0x1<br /> |-<br /> | CONTRAST_PATTERN_03<br /> | 0x2<br /> |-<br /> | CONTRAST_PATTERN_04<br /> | 0x3<br /> |-<br /> | CONTRAST_PATTERN_05<br /> | 0x4<br /> |-<br /> | CONTRAST_PATTERN_06<br /> | 0x5<br /> |-<br /> | CONTRAST_PATTERN_07<br /> | 0x6<br /> |-<br /> | CONTRAST_PATTERN_08<br /> | 0x7<br /> |-<br /> | CONTRAST_PATTERN_09<br /> | 0x8<br /> |-<br /> | CONTRAST_PATTERN_10<br /> | 0x9<br /> |-<br /> | CONTRAST_PATTERN_11<br /> | 0xA<br /> |-<br /> | CONTRAST_LOW <br /> | CONTRAST_PATTERN_05<br /> |-<br /> | CONTRAST_NORMAL<br /> | CONTRAST_PATTERN_06<br /> |-<br /> | CONTRAST_HIGH <br /> | CONTRAST_PATTERN_07<br /> |}<br /> <br /> ===LensCorrection===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | LENS_CORRECTION_OFF <br /> | 0x0<br /> |-<br /> | LENS_CORRECTION_ON_70<br /> | 0x1<br /> |-<br /> | LENS_CORRECTION_ON_90<br /> | 0x2<br /> |-<br /> | LENS_CORRECTION_DARK <br /> | LENS_CORRECTION_OFF<br /> |-<br /> | LENS_CORRECTION_NORMAL<br /> | LENS_CORRECTION_ON_70<br /> |-<br /> | LENS_CORRECTION_BRIGHT<br /> | LENS_CORRECTION_ON_90<br /> |}<br /> <br /> ===OutputFormat===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | OUTPUT_YUV_422<br /> | 0x0<br /> |-<br /> | OUTPUT_RGB_565<br /> | 0x1<br /> |}<br /> <br /> ===ShutterSoundType===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | SHUTTER_SOUND_TYPE_NORMAL <br /> | 0x0<br /> |-<br /> | SHUTTER_SOUND_TYPE_MOVIE <br /> | 0x1<br /> |-<br /> | SHUTTER_SOUND_TYPE_MOVIE_END<br /> | 0x2<br /> |}<br /> <br /> ===ImageQualityCalibrationData===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | s16<br /> | aeBaseTarget<br /> |-<br /> | s16<br /> | kRL<br /> |-<br /> | s16<br /> | kGL<br /> |-<br /> | s16<br /> | kBL<br /> |-<br /> | s16<br /> | ccmPosition<br /> |-<br /> | u16<br /> | awbCcmL9Right<br /> |-<br /> | u16<br /> | awbCcmL9Left<br /> |-<br /> | u16<br /> | awbCcmL10Right<br /> |-<br /> | u16<br /> | awbCcmL10Left<br /> |-<br /> | u16<br /> | awbX0Right<br /> |-<br /> | u16<br /> | awbX0Left<br /> |}<br /> <br /> ===StereoCameraCalibrationData===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | bool<br /> | isValidRotationXY<br /> |-<br /> | bool[3]<br /> | reservedFlag<br /> |-<br /> | float<br /> | scale<br /> |-<br /> | float<br /> | rotationZ<br /> |-<br /> | float<br /> | translationX<br /> |-<br /> | float<br /> | translationY<br /> |-<br /> | float<br /> | rotationX<br /> |-<br /> | float<br /> | rotationY<br /> |-<br /> | float<br /> | angleOfViewRight<br /> |-<br /> | float<br /> | angleOfViewLeft<br /> |-<br /> | float<br /> | distanceToChart<br /> |-<br /> | float<br /> | distanceCameras<br /> |-<br /> | s16<br /> | imageWidth<br /> |-<br /> | s16<br /> | imageHeight<br /> |-<br /> | u8[16]<br /> | reserved<br /> |}<br /> <br /> ===PackageParameterCameraSelect===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u8<br /> | [[Camera_Services#CameraSelect|CameraSelect]] camera<br /> |-<br /> | s8<br /> | exposure<br /> |-<br /> | u8<br /> | [[Camera_Services#WhiteBalance|WhiteBalance]] whiteBalance<br /> |-<br /> | s8<br /> | sharpness<br /> |-<br /> | bool<br /> | autoExposureOn<br /> |-<br /> | bool<br /> | autoWhiteBalanceOn<br /> |-<br /> | u8<br /> | [[Camera_Services#FrameRate|FrameRate]] frameRate<br /> |-<br /> | u8<br /> | [[Camera_Services#PhotoMode|PhotoMode]] photoMode<br /> |-<br /> | u8<br /> | contrast<br /> |-<br /> | u8<br /> | [[Camera_Services#LensCorrection|LensCorrection]] lensCorrection<br /> |-<br /> | bool<br /> | noiseFilterOn<br /> |-<br /> | u8<br /> | padding<br /> |-<br /> | s16<br /> | autoExposureWindowX<br /> |-<br /> | s16<br /> | autoExposureWindowY<br /> |-<br /> | s16<br /> | autoExposureWindowWidth<br /> |-<br /> | s16<br /> | autoExposureWindowHeight<br /> |-<br /> | s16<br /> | autoWhiteBalanceWindowX<br /> |-<br /> | s16<br /> | autoWhiteBalanceWindowY<br /> |-<br /> | s16<br /> | autoWhiteBalanceWindowWidth<br /> |-<br /> | s16<br /> | autoWhiteBalanceWindowHeight<br /> |}<br /> <br /> ===PackageParameterContext===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u8<br /> | [[Camera_Services#CameraSelect|CameraSelect]] camera<br /> |-<br /> | u8<br /> | [[Camera_Services#Context|Context]] context<br /> |-<br /> | u8<br /> | [[Camera_Services#Flip|Flip]] flip<br /> |-<br /> | u8<br /> | [[Camera_Services#Effect|Effect]] effect<br /> |-<br /> | u8<br /> | [[Camera_Services#Size|Size]] size<br /> |}<br /> <br /> ===PackageParameterContextDetail===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u8<br /> | [[Camera_Services#CameraSelect|CameraSelect]] camera<br /> |-<br /> | u8<br /> | [[Camera_Services#Context|Context]] context<br /> |-<br /> | u8<br /> | [[Camera_Services#Flip|Flip]] flip<br /> |-<br /> | u8<br /> | [[Camera_Services#Effect|Effect]] effect<br /> |-<br /> | s16<br /> | width<br /> |-<br /> | s16<br /> | height<br /> |-<br /> | s16<br /> | cropX0<br /> |-<br /> | s16<br /> | cropY0<br /> |-<br /> | s16<br /> | cropX1<br /> |-<br /> | s16<br /> | cropY1<br /> |}<br /> <br /> {{Anchor|Y2R}}{{Anchor|Y2RU}}{{Anchor|y2r:u}}<br /> == y2r:u ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | [[Y2R:SetInputFormat|SetInputFormat]]<br /> |-<br /> | 0x00020000<br /> | [[Y2R:GetInputFormat|GetInputFormat]]<br /> |-<br /> | 0x00030040<br /> | [[Y2R:SetOutputFormat|SetOutputFormat]]<br /> |-<br /> | 0x00040000<br /> | [[Y2R:GetOutputFormat|GetOutputFormat]]<br /> |-<br /> | 0x00050040<br /> | [[Y2R:SetRotation|SetRotation]]<br /> |-<br /> | 0x00060000<br /> | [[Y2R:GetRotation|GetRotation]]<br /> |-<br /> | 0x00070040<br /> | [[Y2R:SetBlockAlignment|SetBlockAlignment]]<br /> |-<br /> | 0x00080000<br /> | [[Y2R:GetBlockAlignment|GetBlockAlignment]]<br /> |-<br /> | 0x00090040<br /> | [[Y2R:SetSpacialDithering|SetSpacialDithering]]<br /> |-<br /> | 0x000A0000<br /> | [[Y2R:GetSpacialDithering|GetSpacialDithering]]<br /> |-<br /> | 0x000B0040<br /> | [[Y2R:SetTemporalDithering|SetTemporalDithering]]<br /> |-<br /> | 0x000C0000<br /> | [[Y2R:GetTemporalDithering|GetTemporalDithering]]<br /> |-<br /> | 0x000D0040<br /> | [[Y2R:SetTransferEndInterrupt|SetTransferEndInterrupt]]<br /> |-<br /> | 0x000E0000<br /> | [[Y2R:GetTransferEndInterrupt|GetTransferEndInterrupt]]<br /> |-<br /> | 0x000F0000<br /> | [[Y2R:GetTransferEndEvent|GetTransferEndEvent]]<br /> |-<br /> | 0x00100102<br /> | [[Y2R:SetSendingY|SetSendingY]]<br /> |-<br /> | 0x00110102<br /> | [[Y2R:SetSendingU|SetSendingU]]<br /> |-<br /> | 0x00120102<br /> | [[Y2R:SetSendingV|SetSendingV]]<br /> |-<br /> | 0x00130102<br /> | [[Y2R:SetSendingYuv|SetSendingYuv]]<br /> |-<br /> | 0x00140000<br /> | [[Y2R:IsFinishedSendingYuv|IsFinishedSendingYuv]]<br /> |-<br /> | 0x00150000<br /> | [[Y2R:IsFinishedSendingY|IsFinishedSendingY]]<br /> |-<br /> | 0x00160000<br /> | [[Y2R:IsFinishedSendingU|IsFinishedSendingU]]<br /> |-<br /> | 0x00170000<br /> | [[Y2R:IsFinishedSendingV|IsFinishedSendingV]]<br /> |-<br /> | 0x00180102<br /> | [[Y2R:SetReceiving|SetReceiving]]<br /> |-<br /> | 0x00190000<br /> | [[Y2R:IsFinishedReceiving|IsFinishedReceiving]]<br /> |-<br /> | 0x001A0040<br /> | [[Y2R:SetInputLineWidth|SetInputLineWidth]]<br /> |-<br /> | 0x001B0000<br /> | [[Y2R:GetInputLineWidth|GetInputLineWidth]]<br /> |-<br /> | 0x001C0040<br /> | [[Y2R:SetInputLines|SetInputLines]]<br /> |-<br /> | 0x001D0000<br /> | [[Y2R:GetInputLines|GetInputLines]]<br /> |-<br /> | 0x001E0100<br /> | [[Y2R:SetCoefficientParams|SetCoefficientParams]]<br /> |-<br /> | 0x001F0000<br /> | [[Y2R:GetCoefficientParams|GetCoefficientParams]]<br /> |-<br /> | 0x00200040<br /> | [[Y2R:SetStandardCoefficient|SetStandardCoefficient]]<br /> |-<br /> | 0x00210040<br /> | [[Y2R:GetStandardCoefficientParams|GetStandardCoefficientParams]]<br /> |-<br /> | 0x00220040<br /> | [[Y2R:SetAlpha|SetAlpha]]<br /> |-<br /> | 0x00230000<br /> | [[Y2R:GetAlpha|GetAlpha]]<br /> |-<br /> | 0x00240200<br /> | [[Y2R:SetDitheringWeightParams|SetDitheringWeightParams]]<br /> |-<br /> | 0x00250000<br /> | [[Y2R:GetDitheringWeightParams|GetDitheringWeightParams]]<br /> |-<br /> | 0x00260000<br /> | [[Y2R:StartConversion|StartConversion]]<br /> |-<br /> | 0x00270000<br /> | [[Y2R:StopConversion|StopConversion]]<br /> |-<br /> | 0x00280000<br /> | [[Y2R:IsBusyConversion|IsBusyConversion]]<br /> |-<br /> | 0x002901C0<br /> | [[Y2R:SetPackageParameter|SetPackageParameter]]<br /> |-<br /> | 0x002A0000<br /> | [[Y2R:PingProcess|PingProcess]]<br /> |-<br /> | 0x002B0000<br /> | [[Y2R:DriverInitialize|DriverInitialize]]<br /> |-<br /> | 0x002C0000<br /> | [[Y2R:DriverFinalize|DriverFinalize]]<br /> |-<br /> | 0x002D0000<br /> | [[Y2R:GetPackageParameter|GetPackageParameter]]<br /> |}<br /> <br /> ===InputFormat===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | INPUT_YUV422_INDIV_8<br /> | 0x0<br /> |-<br /> | INPUT_YUV420_INDIV_8<br /> | 0x1<br /> |-<br /> | INPUT_YUV422_INDIV_16<br /> | 0x2<br /> |-<br /> | INPUT_YUV420_INDIV_16<br /> | 0x3<br /> |-<br /> | INPUT_YUV422_BATCH<br /> | 0x4<br /> |}<br /> <br /> ===OutputFormat===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | OUTPUT_RGB_32<br /> | 0x0<br /> |-<br /> | OUTPUT_RGB_24<br /> | 0x1<br /> |-<br /> | OUTPUT_RGB_16_555<br /> | 0x2<br /> |-<br /> | OUTPUT_RGB_16_565<br /> | 0x3<br /> |}<br /> <br /> ===Rotation===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | ROTATION_NONE<br /> | 0x0<br /> |-<br /> | ROTATION_CLOCKWISE_90<br /> | 0x1<br /> |-<br /> | ROTATION_CLOCKWISE_180<br /> | 0x2<br /> |-<br /> | ROTATION_CLOCKWISE_270<br /> | 0x3<br /> |}<br /> <br /> ===BlockAlignment===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> ! Description<br /> |-<br /> | BLOCK_LINE<br /> | 0x0<br /> | Output buffer's pixels are arranged linearly. Used when outputting to the framebuffer.<br /> |-<br /> | BLOCK_8_BY_8<br /> | 0x1<br /> | Output buffer's pixels are morton swizzled. Used when outputting to a GPU texture.<br /> |}<br /> <br /> ===CoefficientParams===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u16<br /> | Y_A<br /> |-<br /> | u16<br /> | R_V<br /> |-<br /> | u16<br /> | G_V<br /> |-<br /> | u16<br /> | G_U<br /> |-<br /> | u16<br /> | B_U<br /> |-<br /> | u16<br /> | R_Offset<br /> |-<br /> | u16<br /> | G_Offset<br /> |-<br /> | u16<br /> | B_Offset<br /> |}<br /> <br /> ===StandardCoefficient===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | COEFFICIENT_ITU_R_BT_601<br /> | 0x0<br /> |-<br /> | COEFFICIENT_ITU_R_BT_709<br /> | 0x1<br /> |-<br /> | COEFFICIENT_ITU_R_BT_601_SCALING<br /> | 0x2<br /> |-<br /> | COEFFICIENT_ITU_R_BT_709_SCALING<br /> | 0x3<br /> |}<br /> <br /> ===DitheringWeightParams===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u16<br /> | w0_xEven_yEven<br /> |-<br /> | u16<br /> | w0_xOdd_yEven<br /> |-<br /> | u16<br /> | w0_xEven_yOdd<br /> |-<br /> | u16<br /> | w0_xOdd_yOdd<br /> |-<br /> | u16<br /> | w1_xEven_yEven<br /> |-<br /> | u16<br /> | w1_xOdd_yEven<br /> |-<br /> | u16<br /> | w1_xEven_yOdd<br /> |-<br /> | u16<br /> | w1_xOdd_yOdd<br /> |-<br /> | u16<br /> | w2_xEven_yEven<br /> |-<br /> | u16<br /> | w2_xOdd_yEven<br /> |-<br /> | u16<br /> | w2_xEven_yOdd<br /> |-<br /> | u16<br /> | w2_xOdd_yOdd<br /> |-<br /> | u16<br /> | w3_xEven_yEven<br /> |-<br /> | u16<br /> | w3_xOdd_yEven<br /> |-<br /> | u16<br /> | w3_xEven_yOdd<br /> |-<br /> | u16<br /> | w3_xOdd_yOdd<br /> |}<br /> <br /> ===PackageParameter===<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> ! Type<br /> ! Field<br /> |-<br /> | u8<br /> | [[Camera_Services#InputFormat|InputFormat]] inputFormat<br /> |-<br /> | u8<br /> | [[Camera_Services#OutputFormat_2|OutputFormat]] outputFormat<br /> |-<br /> | u8<br /> | [[Camera_Services#Rotation|Rotation]] rotation<br /> |-<br /> | u8<br /> | [[Camera_Services#BlockAlignment|BlockAlignment]] blockAlignment<br /> |-<br /> | s16<br /> | inputLineWidth<br /> |-<br /> | s16<br /> | inputLines<br /> |-<br /> | u8<br /> | [[Camera_Services#StandardCoefficient|StandardCoefficient]] standardCoefficient<br /> |-<br /> | u8<br /> | padding<br /> |-<br /> | s16<br /> | alpha<br /> |}<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Csnd:SND&diff=22756 Csnd:SND 2024-09-19T05:58:15Z <p>ElementW: Redirected page to CSND Services#csnd:SND</p> <hr /> <div>#REDIRECT [[CSND_Services#csnd:SND]]</div> ElementW https://www.3dbrew.org/w/index.php?title=IPC_Command_Structure&diff=22755 IPC Command Structure 2024-09-19T05:51:37Z <p>ElementW: Redirect to message structure subsection</p> <hr /> <div>#REDIRECT [[IPC#Message_Structure]]</div> ElementW https://www.3dbrew.org/w/index.php?title=CSND_Services&diff=22754 CSND Services 2024-09-19T05:50:06Z <p>ElementW: Add anchors</p> <hr /> <div>The CSND service talks to the DSP using the DSP FIFO to negotiate what CSND channels are allocated to the DSP, and this seems to be channels 0-7 (usually). The rest are dedicated to CSND services.<br /> <br /> {{Anchor|CSND}}{{Anchor|csnd:SND}}<br /> = CSND service &quot;csnd:SND&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010140<br /> | [[CSND:Initialize|Initialize]]<br /> |-<br /> | 0x00020000<br /> | [[CSND:Shutdown|Shutdown]]<br /> |-<br /> | 0x00030040<br /> | [[CSND:ExecuteCommands|ExecuteCommands]]<br /> |-<br /> | 0x00040080<br /> | [[CSND:PlaySoundDirectly|PlaySoundDirectly]]<br /> |-<br /> | 0x00050000<br /> | [[CSND:AcquireSoundChannels|AcquireSoundChannels]]<br /> |-<br /> | 0x00060000<br /> | [[CSND:ReleaseSoundChannels|ReleaseSoundChannels]]<br /> |-<br /> | 0x00070000<br /> | [[CSND:AcquireCapUnit|AcquireCapUnit]]<br /> |-<br /> | 0x00080040<br /> | [[CSND:ReleaseCapUnit|ReleaseCapUnit]]<br /> |-<br /> | 0x00090082<br /> | [[CSND:FlushDataCache|FlushDataCache]]<br /> |-<br /> | 0x000A0082<br /> | [[CSND:StoreDataCache|StoreDataCache]]<br /> |-<br /> | 0x000B0082<br /> | [[CSND:InvalidateDataCache|InvalidateDataCache]]<br /> |-<br /> | 0x000C0000<br /> | [[CSND:Reset|Reset]]<br /> |}<br /> <br /> A maximum of 4 service sessions can be opened at the same time for this service.<br /> <br /> For cache operations addresses must be in 0x14000000-0x1C000000 range. Starting with [[8.0.0-18]] addresses in the range 0x30000000-0x40000000 are also allowed.<br /> <br /> This service is normally used for playing [[BCWAV|CWAVs]]. The audio data must be located in the 0x14000000 virtual memory region, since CSND requires the physical address for playing the audio.<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=APT:U&diff=22753 APT:U 2024-09-19T05:48:53Z <p>ElementW: Redirected page to NS and APT Services#APT:U</p> <hr /> <div>#REDIRECT [[NS_and_APT Services#APT:U]]</div> ElementW https://www.3dbrew.org/w/index.php?title=APT:S&diff=22752 APT:S 2024-09-19T05:48:03Z <p>ElementW: Redirected page to NS and APT Services#APT:S</p> <hr /> <div>#REDIRECT [[NS_and_APT Services#APT:S]]</div> ElementW https://www.3dbrew.org/w/index.php?title=APT:A&diff=22751 APT:A 2024-09-19T05:47:38Z <p>ElementW: Redirected page to NS and APT Services#APT:A</p> <hr /> <div>#REDIRECT [[NS_and_APT Services#APT:A]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:IPC/RequestHeader&diff=22750 Template:IPC/RequestHeader 2024-09-18T17:18:34Z <p>ElementW: Merge full header code in the subtable</p> <hr /> <div>&lt;noinclude&gt;<br /> {{IPC/Request|ipc_offset_prefix=n&amp;nbsp;+&amp;nbsp;}}<br /> &lt;/noinclude&gt;|-<br /> | {{#var:ipc_offset_prefix}}{{#var:ipc_offset}}{{#vardefine:ipc_offset|{{#expr: {{#var:ipc_offset}} + 1}}}}<br /> | <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot; style=&quot;margin:0.2em 0&quot;<br /> |-<br /> ! Header<br /> | {{{1}}}{{<br /> #vardefine:headerlow|{{#expr:{{{3}}}+({{{2}}}*64)}}}}{{<br /> #vardefine:looppow|12}}{{#while:<br /> | {{#ifexpr: {{#var:looppow}} &gt;= 0 | true }}<br /> | {{#switch: {{#expr:trunc({{#var:headerlow}}/(2^{{#var:looppow}})) mod 16}}<br /> | 0 = 0<br /> | 1 = 1<br /> | 2 = 2<br /> | 3 = 3<br /> | 4 = 4<br /> | 5 = 5<br /> | 6 = 6<br /> | 7 = 7<br /> | 8 = 8<br /> | 9 = 9<br /> | 10 = A<br /> | 11 = B<br /> | 12 = C<br /> | 13 = D<br /> | 14 = E<br /> | 15 = F<br /> | #default = ?<br /> }}{{#vardefine:looppow|{{#expr:{{#var:looppow}}-4}}}}<br /> }}<br /> ! &lt;abbr title=&quot;Command ID&quot;&gt;Cmd&lt;/abbr&gt;<br /> | {{{1}}}<br /> ! &lt;abbr title=&quot;Number of raw parameter words&quot;&gt;Param&lt;/abbr&gt;<br /> | {{{2}}}<br /> ! &lt;abbr title=&quot;Number of words in the translate section of the message&quot;&gt;Xlat&lt;/abbr&gt;<br /> | {{{3}}}<br /> |}&lt;noinclude&gt;<br /> {{IPC/RequestEnd}}<br /> [[Category:IPC message contents templates]]<br /> &lt;/noinclude&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Ndm:u&diff=22749 Ndm:u 2024-09-18T16:42:18Z <p>ElementW: Redirected page to NDM Services#ndm:u</p> <hr /> <div>#REDIRECT [[NDM_Services#ndm:u]]</div> ElementW https://www.3dbrew.org/w/index.php?title=NDM_Services&diff=22748 NDM Services 2024-09-18T16:04:17Z <p>ElementW: Add anchors</p> <hr /> <div>__TOC__<br /> {{Anchor|NDMU}}{{Anchor|ndm:u}}<br /> = NDM service &quot;ndm:u&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010042<br /> | [[NDMU:EnterExclusiveState|EnterExclusiveState]]<br /> |-<br /> | 0x00020002<br /> | [[NDMU:LeaveExclusiveState|LeaveExclusiveState]]<br /> |-<br /> | 0x00030000<br /> | [[NDMU:QueryExclusiveMode|QueryExclusiveMode]]<br /> |-<br /> | 0x00040002<br /> | [[NDMU:LockState|LockState]]<br /> |-<br /> | 0x00050002<br /> | [[NDMU:UnlockState|UnlockState]]<br /> |-<br /> | 0x00060040<br /> | [[NDMU:SuspendDaemons|SuspendDaemons]]<br /> |-<br /> | 0x00070040<br /> | [[NDMU:ResumeDaemons|ResumeDaemons]]<br /> |-<br /> | 0x00080040<br /> | [[NDMU:SuspendScheduler|SuspendScheduler]]<br /> |-<br /> | 0x00090000<br /> | [[NDMU:ResumeScheduler|ResumeScheduler]]<br /> |-<br /> | 0x000A0000<br /> | [[NDMU:GetCurrentState|GetCurrentState]]<br /> |-<br /> | 0x000B0000<br /> | [[NDMU:GetTargetState|GetTargetState]]<br /> |-<br /> | 0x000C0000<br /> | Stubbed. (Not implemented)<br /> |-<br /> | 0x000D0040<br /> | [[NDMU:QueryStatus|QueryStatus]]<br /> |-<br /> | 0x000E0040<br /> | [[NDMU:GetDaemonDisableCount|GetDaemonDisableCount]]<br /> |-<br /> | 0x000F0000<br /> | [[NDMU:GetSchedulerDisableCount|GetSchedulerDisableCount]]<br /> |-<br /> | 0x00100040<br /> | [[NDMU:SetScanInterval|SetScanInterval]]<br /> |-<br /> | 0x00110000<br /> | [[NDMU:GetScanInterval|GetScanInterval]]<br /> |-<br /> | 0x00120040<br /> | [[NDMU:SetRetryInterval|SetRetryInterval]]<br /> |-<br /> | 0x00130000<br /> | [[NDMU:GetRetryInterval|GetRetryInterval]]<br /> |-<br /> | 0x00140040<br /> | [[NDMU:OverrideDefaultDaemons|OverrideDefaultDaemons]]<br /> |-<br /> | 0x00150000<br /> | [[NDMU:ResetDefaultDaemons|ResetDefaultDaemons]]<br /> |-<br /> | 0x00160000<br /> | [[NDMU:GetDefaultDaemons|GetDefaultDaemons]]<br /> |-<br /> | 0x00170000<br /> | [[NDMU:ClearHalfAwakeMacFilter|ClearHalfAwakeMacFilter]]<br /> |}<br /> <br /> '''enum ExclusiveState'''<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | EXCLUSIVE_STATE_NONE<br /> | 0<br /> |-<br /> | EXCLUSIVE_STATE_INFRASTRUCTURE<br /> | 1<br /> |-<br /> | EXCLUSIVE_STATE_LOCAL_COMMUNICATIONS<br /> | 2<br /> |-<br /> | EXCLUSIVE_STATE_STREETPASS<br /> | 3<br /> |-<br /> | EXCLUSIVE_STATE_STREETPASS_DATA<br /> | 4<br /> |}<br /> <br /> '''enum Daemon'''<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | DAEMON_CEC<br /> | 0<br /> |-<br /> | DAEMON_BOSS<br /> | 1<br /> |-<br /> | DAEMON_NIM<br /> | 2<br /> |-<br /> | DAEMON_FRIENDS<br /> | 3<br /> |}<br /> <br /> '''enum DaemonMask'''<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | DAEMON_MASK_CEC<br /> | 1 &lt;&lt; DAEMON_CEC<br /> |-<br /> | DAEMON_MASK_BOSS<br /> | 1 &lt;&lt; DAEMON_BOSS<br /> |-<br /> | DAEMON_MASK_NIM<br /> | 1 &lt;&lt; DAEMON_NIM<br /> |-<br /> | DAEMON_MASK_FRIENDS<br /> | 1 &lt;&lt; DAEMON_FRIENDS<br /> |}<br /> <br /> '''enum DaemonStatus'''<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | DAEMON_STATUS_BUSY<br /> | 0<br /> |-<br /> | DAEMON_STATUS_IDLE<br /> | 1<br /> |-<br /> | DAEMON_STATUS_SUSPENDING<br /> | 2<br /> |-<br /> | DAEMON_STATUS_SUSPENDED<br /> | 3<br /> |}<br /> <br /> '''enum State'''<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Enum<br /> ! Value<br /> |-<br /> | STATE_INITIAL<br /> | 0<br /> |-<br /> | STATE_SUSPENDED<br /> | 1<br /> |-<br /> | STATE_INFRASTRUCTURE_CONNECTING<br /> | 2<br /> |-<br /> | STATE_INFRASTRUCTURE_CONNECTED<br /> | 3<br /> |-<br /> | STATE_INFRASTRUCTURE_WORKING<br /> | 4<br /> |-<br /> | STATE_INFRASTRUCTURE_SUSPENDING<br /> | 5<br /> |-<br /> | STATE_INFRASTRUCTURE_FORCE_SUSPENDING<br /> | 6<br /> |-<br /> | STATE_INFRASTRUCTURE_DISCONNECTING<br /> | 7<br /> |-<br /> | STATE_INFRASTRUCTURE_FORCE_DISCONNECTING<br /> | 8<br /> |-<br /> | STATE_CEC_WORKING<br /> | 9<br /> |-<br /> | STATE_CEC_FORCE_SUSPENDING<br /> | 10<br /> |-<br /> | STATE_CEC_SUSPENDING<br /> | 11<br /> |}<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Ns:c&diff=22747 Ns:c 2024-09-18T15:03:05Z <p>ElementW: Redirected page to NS and APT Services#ns:c</p> <hr /> <div>#REDIRECT [[NS_and_APT_Services#ns:c]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Ns:p&diff=22746 Ns:p 2024-09-18T15:01:47Z <p>ElementW: Redirected page to NS and APT Services#ns:p</p> <hr /> <div>#REDIRECT [[NS_and_APT_Services#ns:p]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Ns:s&diff=22745 Ns:s 2024-09-18T15:01:30Z <p>ElementW: Redirected page to NS and APT Services#ns:s</p> <hr /> <div>#REDIRECT [[NS_and_APT_Services#ns:s]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:ServiceCall&diff=22744 Template:ServiceCall 2024-09-18T10:47:00Z <p>ElementW: Created page with &quot;&lt;span style=&quot;font-family:monospace&quot;&gt;:{{{1}}}&lt;/span&gt;&quot;</p> <hr /> <div>&lt;span style=&quot;font-family:monospace&quot;&gt;[[:{{{1}}}]]&lt;/span&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Ldr:ro&diff=22743 Ldr:ro 2024-09-18T10:43:44Z <p>ElementW: Redirected page to RO Services#ldr:ro</p> <hr /> <div>#REDIRECT [[RO_Services#ldr:ro]]</div> ElementW https://www.3dbrew.org/w/index.php?title=NS_and_APT_Services&diff=22742 NS and APT Services 2024-09-18T10:42:20Z <p>ElementW: Add anchors</p> <hr /> <div>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.<br /> <br /> NS will not trigger the [[ErrDisp|fatal-error]] screen when launching the regular/alternate menu fails.<br /> <br /> Like home menu NS is constantly running while the system is in 3DS-mode. When attempting to return to home-menu when the home-menu process isn't running(like when the process terminated/crashed), NS will trigger a [[ErrDisp|fatal]] error.<br /> <br /> = Alternate menu =<br /> When launching the regular menu fails, NS will then attempt to launch the alternate menu. This title could be used as a recovery process, however it's normally not used after the factory.<br /> <br /> At the factory for all 3DS systems, [[3DS Development Unit GUI#Test Menu|Test Menu]] is installed with this TID. On retail this title is eventually deleted during [[Factory Setup]].<br /> <br /> = Auto-boot =<br /> After [[PMApp:GetFIRMLaunchParams|loading]] [[FIRM]] params and prior to launching [[ErrDisp]]/Home Menu, NS handles auto-booting titles. The same code called by [[APT:Reboot]] is used for launching FIRM here. When the [[Configuration_Memory|UPDATEFLAG]] is set, NS will launch SAFE_MODE_FIRM with the application titleID set to the [[System_Settings#System_Updater|System Updater]] titleID for this region. When the UPDATEFLAG is not set, NS can auto-boot the following titles as well if [[Configuration_Memory|0x1FF80016]] bit0 is set.<br /> <br /> When bit1 and bit2 are value zero in [[Configuration_Memory|0x1FF80016]], NS will [[NSS:LaunchFIRM|launch]] the title specified by the [[FIRM]] parameters if the title-info is set. This FIRM launch is done after launching [[ErrDisp]] and Home Menu. Otherwise when [[Configuration_Memory|0x1FF80016]] is value 2 and the output u8 from [[PTM|PTMSYSM]] command 0x08140000 is value 0, NS will boot the title specified from the TWL TLNC block from FIRMparams+0x300. This is the same TLNC block which DSi titles wrote to RAM+0x300 for launching other titles via the launcher title. When handling the TLNC block, NS will boot the 3DS System Settings title when the TLNC titleID is the DSi System Settings titleID(the region field in the TLNC TID is not checked/used). When the TLNC titleID is not System Settings, NS will convert the input DSi titleID-high to the 3DS TWL titleID-high(tidhigh = (TLNCtidhigh &amp; 0x7FFF) | 0x48000), then launch TWL_FIRM to run the title. NS does not support launching from gamecard via TLNC.<br /> <br /> = NS Workaround =<br /> A &quot;ns_workaround&quot; was [[5.1.0-11|added]] in NS to workaround the flaw added with [[5.0.0-11]]. When NS is loading before launching any ARM11 processes and certain [[Configuration Memory]] fields are set, NS will launch [[Application_Manager_Services|AM]] then use command [[AM:InstallNATIVEFIRM]]. NS will then execute the code called by [[APT:StartNewestHomeMenu]], the code related to APT:PrepareToStartNewestHomeMenu is not executed here.<br /> <br /> 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]].<br /> <br /> {{Anchor|NSS}}{{Anchor|ns:s}}<br /> = NS Service &quot;ns:s&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Description<br /> |-<br /> | 0x000100C0<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:LaunchFIRM|LaunchFIRM]]<br /> |-<br /> | 0x000200C0<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:LaunchTitle|LaunchTitle]]<br /> |-<br /> | 0x00030000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:TerminateApplication|TerminateApplication]]<br /> |-<br /> | 0x00040040<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:TerminateProcess|TerminateProcess]]<br /> |-<br /> | 0x000500C0<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:LaunchApplicationFIRM|LaunchApplicationFIRM]]<br /> |-<br /> | 0x00060042<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:SetWirelessRebootInfo|SetWirelessRebootInfo]]<br /> |-<br /> | 0x00070042<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:CardUpdateInitialize|CardUpdateInitialize]]<br /> |-<br /> | 0x00080000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:CardUpdateShutdown|CardUpdateShutdown]]<br /> |-<br /> | 0x00090000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | Gamecard system update related.<br /> |-<br /> | 0x000A0000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | Gamecard system update related.<br /> |-<br /> | 0x000B0000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | Gamecard system update related.<br /> |-<br /> | 0x000C0000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | Gamecard system update related.<br /> |-<br /> | 0x000D0140<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:SetTWLBannerHMAC|SetTWLBannerHMAC]]<br /> |-<br /> | 0x000E0000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:ShutdownAsync|ShutdownAsync]]<br /> |-<br /> | 0x000F0000<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | This calls [[APT:AppletUtility]] with fixed input params.<br /> |-<br /> | 0x00100180<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:RebootSystem|RebootSystem]]<br /> |-<br /> | 0x00110100<br /> | [[1.0.0-0]] - [[2.0.0-2]]<br /> | [[NSS:TerminateTitle|TerminateTitle]]<br /> |-<br /> | 0x001200C0<br /> | ?<br /> | [[NSS:SetApplicationCpuTimeLimit|SetApplicationCpuTimeLimit]]<br /> |-<br /> | 0x00130000<br /> | ?<br /> | ?<br /> |-<br /> | 0x00140042<br /> | ?<br /> | ?<br /> |-<br /> | 0x00150140<br /> | ?<br /> | [[NSS:LaunchApplication|LaunchApplication]]<br /> |-<br /> | 0x00160000<br /> | [[8.0.0-18]]<br /> | [[NSS:RebootSystemClean|RebootSystemClean]]<br /> |}<br /> <br /> The maximum sessions that can be used with this service is two, therefore only two processes can use this service at the same time.<br /> <br /> {{Anchor|NSP}}{{Anchor|ns:p}}<br /> =NS Power Service &quot;ns:p&quot;=<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | [[NSP:RebootSystem|RebootSystem]]<br /> |-<br /> | 0x00020000<br /> | [[NSS:ShutdownAsync|ShutdownAsync]]<br /> |}<br /> <br /> This was added with [[3.0.0-5]]. The PTM sysmodule connects to this service, and syncs whenever [[PTM|ptm:s GetShellState()]] changes.<br /> <br /> {{Anchor|NSC}}{{Anchor|ns:c}}<br /> =NS Service &quot;ns:c&quot;=<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010100<br /> | [[NSC:LockSpecialContent|LockSpecialContent]]<br /> |-<br /> | 0x00020100<br /> | [[NSC:UnlockSpecialContent|UnlockSpecialContent]]<br /> |}<br /> <br /> 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.<br /> <br /> {{Anchor|APT}}{{Anchor|APTU}}{{Anchor|APT:U}}{{Anchor|APTS}}{{Anchor|APT:S}}<br /> =APT Services=<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Accessible with APT:U<br /> ! Accessible with APT:A<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetLockHandle|GetLockHandle]]<br /> |-<br /> | 0x00020080<br /> | <br /> | See [[APT:Initialize|here]].<br /> | See [[APT:Initialize|here]].<br /> | [[APT:Initialize|Initialize]]<br /> |-<br /> | 0x00030040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:Enable|Enable]]<br /> |-<br /> | 0x00040040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:Finalize|Finalize]]<br /> |-<br /> | 0x00050040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetAppletManInfo|GetAppletManInfo]]<br /> |-<br /> | 0x00060040<br /> | <br /> | Yes (AppID != 0x300)<br /> | Yes<br /> | [[APT:GetAppletInfo|GetAppletInfo]]<br /> |-<br /> | 0x00070000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetLastSignaledAppletId|GetLastSignaledAppletId]]<br /> |-<br /> | 0x00080000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CountRegisteredApplet|CountRegisteredApplet]]<br /> |-<br /> | 0x00090040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:IsRegistered|IsRegistered]]<br /> |-<br /> | 0x000A0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetAttribute|GetAttribute]]<br /> |-<br /> | 0x000B0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:InquireNotification|InquireNotification]]<br /> |-<br /> | 0x000C0104<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SendParameter|SendParameter]]<br /> |-<br /> | 0x000D0080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:ReceiveParameter|ReceiveParameter]]<br /> |-<br /> | 0x000E0080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GlanceParameter|GlanceParameter]]<br /> |-<br /> | 0x000F0100<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CancelParameter|CancelParameter]]<br /> |-<br /> | 0x001000C2<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:DebugFunc|DebugFunc]]<br /> |-<br /> | 0x001100C0<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:MapProgramIdForDebug|MapProgramIdForDebug]]<br /> |-<br /> | 0x00120040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SetHomeMenuAppletIdForDebug|SetHomeMenuAppletIdForDebug]]<br /> |-<br /> | 0x00130000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetPreparationState|GetPreparationState]]<br /> |-<br /> | 0x00140040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SetPreparationState|SetPreparationState]]<br /> |-<br /> | 0x00150140<br /> | <br /> | No<br /> | No<br /> | [[APT:PrepareToStartApplication|PrepareToStartApplication]]<br /> |-<br /> | 0x00160040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PreloadLibraryApplet|PreloadLibraryApplet]]<br /> |-<br /> | 0x00170040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:FinishPreloadingLibraryApplet|FinishPreloadingLibraryApplet]]<br /> |-<br /> | 0x00180040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToStartLibraryApplet|PrepareToStartLibraryApplet]]<br /> |-<br /> | 0x00190040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToStartSystemApplet|PrepareToStartSystemApplet]]<br /> |-<br /> | 0x001A0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToStartNewestHomeMenu|PrepareToStartNewestHomeMenu]]<br /> |-<br /> | 0x001B00C4<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StartApplication|StartApplication]]<br /> |-<br /> | 0x001C0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:WakeupApplication|WakeupApplication]]<br /> |-<br /> | 0x001D0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CancelApplication|CancelApplication]]<br /> |-<br /> | 0x001E0084<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StartLibraryApplet|StartLibraryApplet]]<br /> |-<br /> | 0x001F0084<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StartSystemApplet|StartSystemApplet]]<br /> |-<br /> | 0x00200044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StartNewestHomeMenu|StartNewestHomeMenu]]<br /> |-<br /> | 0x00210000<br /> | <br /> | No<br /> | No<br /> | [[APT:OrderToCloseApplication|OrderToCloseApplication]]<br /> |-<br /> | 0x00220040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToCloseApplication|PrepareToCloseApplication]]<br /> |-<br /> | 0x00230040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToJumpToApplication|PrepareToJumpToApplication]]<br /> |-<br /> | 0x00240044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:JumpToApplication|JumpToApplication]]<br /> |-<br /> | 0x002500C0<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToCloseLibraryApplet|PrepareToCloseLibraryApplet]]<br /> |-<br /> | 0x00260000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToCloseSystemApplet|PrepareToCloseSystemApplet]]<br /> |-<br /> | 0x00270044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CloseApplication|CloseApplication]]<br /> |-<br /> | 0x00280044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CloseLibraryApplet|CloseLibraryApplet]]<br /> |-<br /> | 0x00290044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CloseSystemApplet|CloseSystemApplet]]<br /> |-<br /> | 0x002A0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:OrderToCloseSystemApplet|OrderToCloseSystemApplet]]<br /> |-<br /> | 0x002B0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToJumpToHomeMenu|PrepareToJumpToHomeMenu]]<br /> |-<br /> | 0x002C0044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:JumpToHomeMenu|JumpToHomeMenu]]<br /> |-<br /> | 0x002D0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToLeaveHomeMenu|PrepareToLeaveHomeMenu]]<br /> |-<br /> | 0x002E0044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:LeaveHomeMenu|LeaveHomeMenu]]<br /> |-<br /> | 0x002F0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToLeaveResidentApplet|PrepareToLeaveResidentApplet]]<br /> |-<br /> | 0x00300044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:LeaveResidentApplet|LeaveResidentApplet]]<br /> |-<br /> | 0x00310100<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToDoApplicationJump|PrepareToDoApplicationJump]]<br /> |-<br /> | 0x00320084<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:DoApplicationJump|DoApplicationJump]]<br /> |-<br /> | 0x00330000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetProgramIdOnApplicationJump|GetProgramIdOnApplicationJump]]<br /> |-<br /> | 0x00340084<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SendDeliverArg|SendDeliverArg]]<br /> |-<br /> | 0x00350080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:ReceiveDeliverArg|ReceiveDeliverArg]]<br /> |-<br /> | 0x00360040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:LoadSysMenuArg|LoadSysMenuArg]]<br /> |-<br /> | 0x00370042<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StoreSysMenuArg|StoreSysMenuArg]]<br /> |-<br /> | 0x00380040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PreloadResidentApplet|PreloadResidentApplet]]<br /> |-<br /> | 0x00390040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:PrepareToStartResidentApplet|PrepareToStartResidentApplet]]<br /> |-<br /> | 0x003A0044<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:StartResidentApplet|StartResidentApplet]]<br /> |-<br /> | 0x003B0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:CancelLibraryApplet|CancelLibraryApplet]]<br /> |-<br /> | 0x003C0042<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SendDspSleep|SendDspSleep]]<br /> |-<br /> | 0x003D0042<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SendDspWakeUp|SendDspWakeUp]]<br /> |-<br /> | 0x003E0080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:ReplySleepQuery|ReplySleepQuery]]<br /> |-<br /> | 0x003F0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:ReplySleepNotificationComplete|ReplySleepNotificationComplete]]<br /> |-<br /> | 0x00400042<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SendCaptureBufferInfo|SendCaptureBufferInfo]]<br /> |-<br /> | 0x00410040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:ReceiveCaptureBufferInfo|ReceiveCaptureBufferInfo]]<br /> |-<br /> | 0x00420080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SleepSystem|SleepSystem]]<br /> |-<br /> | 0x00430040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:NotifyToWait|NotifyToWait]]<br /> |-<br /> | 0x00440000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetSharedFont|GetSharedFont]]<br /> |-<br /> | 0x00450040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetWirelessRebootInfo|GetWirelessRebootInfo]]<br /> |-<br /> | 0x00460104<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:Wrap|Wrap]]<br /> |-<br /> | 0x00470104<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:Unwrap|Unwrap]]<br /> |-<br /> | 0x00480100<br /> | <br /> | No<br /> | No<br /> | [[APT:GetProgramInfo|GetProgramInfo]]<br /> |-<br /> | 0x00490180<br /> | <br /> | No<br /> | No<br /> | [[APT:Reboot|Reboot]]<br /> |-<br /> | 0x004A0040<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetCaptureInfo|GetCaptureInfo]]<br /> |-<br /> | 0x004B00C2<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:AppletUtility|AppletUtility]]<br /> |-<br /> | 0x004C0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:SetFatalErrDispMode|SetFatalErrDispMode]]<br /> |-<br /> | 0x004D0080<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:GetAppletProgramInfo|GetAppletProgramInfo]]<br /> |-<br /> | 0x004E0000<br /> | <br /> | Yes<br /> | Yes<br /> | [[APT:HardwareResetAsync|HardwareResetAsync]]<br /> |-<br /> | 0x004F0080<br /> | [[2.2.0-X]]<br /> | Yes<br /> | Yes<br /> | [[APT:SetApplicationCpuTimeLimit|SetApplicationCpuTimeLimit]]<br /> |-<br /> | 0x00500040<br /> | [[2.2.0-X]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetApplicationCpuTimeLimit|GetApplicationCpuTimeLimit]]<br /> |-<br /> | 0x00510080<br /> | [[3.0.0-5]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetStartupArgument|GetStartupArgument]]<br /> |-<br /> | 0x00520104<br /> | [[4.0.0-7]]<br /> | Yes<br /> | Yes<br /> | [[APT:Wrap1|Wrap1]]<br /> |-<br /> | 0x00530104<br /> | [[4.0.0-7]]<br /> | Yes<br /> | Yes<br /> | [[APT:Unwrap1|Unwrap1]]<br /> |-<br /> | 0x00540040<br /> | [[5.0.0-11]]<br /> | Yes<br /> | Yes<br /> | Takes an unknown parameter, outputs a result code and media type.<br /> |-<br /> | 0x00550040<br /> | [[7.0.0-13]]<br /> | Yes<br /> | Yes<br /> | [[APT:SetScreenCapturePostPermission|SetScreenCapturePostPermission]]<br /> |-<br /> | 0x00560000<br /> | [[7.0.0-13]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetScreenCapturePostPermission|GetScreenCapturePostPermission]]<br /> |-<br /> | 0x00570044<br /> | [[7.0.0-13]]<br /> | Yes<br /> | Yes<br /> | [[APT:WakeupApplication2|WakeupApplication2]]<br /> |-<br /> | 0x00580002<br /> | [[7.0.0-13]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetProgramID|GetProgramID]]<br /> |-<br /> | 0x01010000<br /> | [[8.0.0-18]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetTargetPlatform|GetTargetPlatform]]<br /> |-<br /> | 0x01020000<br /> | [[8.0.0-18]]<br /> | Yes<br /> | Yes<br /> | [[APT:CheckNew3DS|CheckNew3DS]]<br /> |-<br /> | 0x01030000<br /> | [[8.0.0-18]]<br /> | Yes<br /> | Yes<br /> | [[APT:GetApplicationRunningMode|GetApplicationRunningMode]]<br /> |-<br /> | 0x01040000<br /> | [[8.0.0-18]]<br /> | Yes<br /> | Yes<br /> | [[APT:IsStandardMemoryLayout|IsStandardMemoryLayout]]<br /> |-<br /> | 0x01050100<br /> | [[10.4.0-29]]<br /> | Yes<br /> | Yes<br /> | [[APT:IsTitleAllowed|IsTitleAllowed]]<br /> |}<br /> <br /> These &quot;APT:U&quot; and &quot;APT:S&quot; NS services can handle launching titles/&quot;applets&quot;, these services handle signaling for home/power button as well. Only one session for either APT service can be open at a time, normally processes close the service handle immediately once finished using the service. The commands for APT:U and APT:S are exactly the same, however certain commands are only accessible with APT:S(NS module will call [[SVC|svcBreak]] when the command isn't accessible).<br /> <br /> Applets returning to home-menu first use commands APT:PrepareToJumpToHomeMenu and APT:JumpToHomeMenu, followed by these commands to launch home-menu: [[APT:PrepareToStartSystemApplet]] and [[APT:StartSystemApplet]]. [[APT:PrepareToStartSystemApplet]] and [[APT:StartSystemApplet]] are also used for launching the [[Internet Browser]], the camera applet, etc.<br /> <br /> Processes launch applications via home-menu, not directly with [[APT:PrepareToStartApplication]] and [[APT:StartApplication]]. Regular applications can't directly launch applications since [[APT:StartApplication]] launches the process without terminating the currently running application.<br /> <br /> APT:PrepareToDoApplicationJump and APT:DoApplicationJump are used by applications, for launching native/&lt;non-NATIVE_FIRM&gt; applications. These commands notify Home Menu that title launching needs done, Home Menu does the actual title launching via NS commands.<br /> <br /> == AppletAttr ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Bits<br /> ! Description<br /> |-<br /> | 0-2<br /> | [[NS_and_APT_Services#AppletPos|AppletPos]]<br /> |-<br /> | 3<br /> | Manually Acquire/Release GPU Rights<br /> |-<br /> | 4<br /> | Manually Acquire/Release DSP Rights<br /> |-<br /> | 5<br /> | ?<br /> |}<br /> <br /> == DisplayBufferMode ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | FORMAT_R8G8B8A8<br /> |-<br /> | 1<br /> | FORMAT_R8G8B8<br /> |-<br /> | 2<br /> | FORMAT_R5G6B5<br /> |-<br /> | 3<br /> | FORMAT_R5G5B5A1<br /> |-<br /> | 4<br /> | FORMAT_R4G4B4A4<br /> |-<br /> | 0xFFFFFFFF<br /> | FORMAT_UNIMPORTABLE<br /> |}<br /> <br /> This is the same mapping as used for the [[GPU/External_Registers#Framebuffer_color_formats|GPU framebuffer color formats]].<br /> <br /> == AppletPos ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | -1<br /> | POS_NONE<br /> |-<br /> | 0<br /> | POS_APP<br /> |-<br /> | 1<br /> | POS_APPLIB<br /> |-<br /> | 2<br /> | POS_SYS<br /> |-<br /> | 3<br /> | POS_SYSLIB<br /> |-<br /> | 4<br /> | POS_RESIDENT<br /> |}<br /> <br /> == QueryReply ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | REPLY_REJECT<br /> |-<br /> | 1<br /> | REPLY_ACCEPT<br /> |-<br /> | 2<br /> | REPLY_LATER<br /> |}<br /> <br /> == Notification ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | NOTIFICATION_NONE<br /> |-<br /> | 1<br /> | NOTIFICATION_HOME_BUTTON_1<br /> |-<br /> | 2<br /> | NOTIFICATION_HOME_BUTTON_2<br /> |-<br /> | 3<br /> | NOTIFICATION_SLEEP_QUERY<br /> |-<br /> | 4<br /> | NOTIFICATION_SLEEP_CANCELED_BY_OPEN<br /> |-<br /> | 5<br /> | NOTIFICATION_SLEEP_ACCEPTED<br /> |-<br /> | 6<br /> | NOTIFICATION_SLEEP_AWAKE<br /> |-<br /> | 7<br /> | NOTIFICATION_SHUTDOWN<br /> |-<br /> | 8<br /> | NOTIFICATION_POWER_BUTTON_CLICK<br /> |-<br /> | 9<br /> | NOTIFICATION_POWER_BUTTON_CLEAR<br /> |-<br /> | 10<br /> | NOTIFICATION_TRY_SLEEP<br /> |-<br /> | 11<br /> | NOTIFICATION_ORDER_TO_CLOSE<br /> |}<br /> <br /> == Command ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | COMMAND_NONE<br /> |-<br /> | 1<br /> | COMMAND_WAKEUP<br /> |-<br /> | 2<br /> | COMMAND_REQUEST<br /> |-<br /> | 3<br /> | COMMAND_RESPONSE<br /> |-<br /> | 4<br /> | COMMAND_EXIT<br /> |-<br /> | 5<br /> | COMMAND_MESSAGE<br /> |-<br /> | 6<br /> | COMMAND_HOME_BUTTON_SINGLE<br /> |-<br /> | 7<br /> | COMMAND_HOME_BUTTON_DOUBLE<br /> |-<br /> | 8<br /> | COMMAND_DSP_SLEEP<br /> |-<br /> | 9<br /> | COMMAND_DSP_WAKEUP<br /> |-<br /> | 10<br /> | COMMAND_WAKEUP_BY_EXIT<br /> |-<br /> | 11<br /> | COMMAND_WAKEUP_BY_PAUSE<br /> |-<br /> | 12<br /> | COMMAND_WAKEUP_BY_CANCEL<br /> |-<br /> | 13<br /> | COMMAND_WAKEUP_BY_CANCELALL<br /> |-<br /> | 14<br /> | COMMAND_WAKEUP_BY_POWER_BUTTON_CLICK<br /> |-<br /> | 15<br /> | COMMAND_WAKEUP_TO_JUMP_HOME<br /> |-<br /> | 16<br /> | COMMAND_REQUEST_FOR_SYS_APPLET<br /> |-<br /> | 17<br /> | COMMAND_WAKEUP_TO_LAUNCH_APPLICATION<br /> |-<br /> | 0x41<br /> | Unknown. [[APT:ReceiveParameter|Received]] by Home Menu during boot when the Home Menu process doesn't terminate properly(svcExitProcess/crash).<br /> |}<br /> <br /> == AppletPreparationState ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | NO_PREPARATION<br /> |-<br /> | 1<br /> | PREPARED_TO_LAUNCH_APP<br /> |-<br /> | 2<br /> | PREPARED_TO_CLOSE_APP<br /> |-<br /> | 3<br /> | PREPARED_TO_FORCE_TO_CLOSE_APP<br /> |-<br /> | 4<br /> | PREPARED_TO_PRELOAD_APPLIB<br /> |-<br /> | 5<br /> | PREPARED_TO_LAUNCH_APPLIB<br /> |-<br /> | 6<br /> | PREPARED_TO_CLOSE_APPLIB<br /> |-<br /> | 7<br /> | PREPARED_TO_LAUNCH_SYS<br /> |-<br /> | 8<br /> | PREPARED_TO_CLOSE_SYS<br /> |-<br /> | 9<br /> | PREPARED_TO_PRELOAD_SYSLIB<br /> |-<br /> | 10<br /> | PREPARED_TO_LAUNCH_SYSLIB<br /> |-<br /> | 11<br /> | PREPARED_TO_CLOSE_SYSLIB<br /> |-<br /> | 12<br /> | PREPARED_TO_LAUNCH_RESIDENT<br /> |-<br /> | 13<br /> | PREPARED_TO_LEAVE_RESIDENT<br /> |-<br /> | 14<br /> | PREPARED_TO_DO_HOMEMENU<br /> |-<br /> | 15<br /> | PREPARED_TO_LEAVE_HOMEMENU<br /> |-<br /> | 16<br /> | PREPARED_TO_START_RESIDENT<br /> |-<br /> | 17<br /> | PREPARED_TO_DO_APP_JUMP<br /> |-<br /> | 18<br /> | PREPARED_TO_FORCE_TO_CLOSE_SYS<br /> |-<br /> | 19<br /> | PREPARED_TO_LAUNCH_OTHER_SYS<br /> |-<br /> | 20<br /> | PREPARED_TO_JUMP_TO_APP<br /> |}<br /> <br /> == StartupArgumentType ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | STARTUP_ARGUMENT_TYPE_OTHER_APP<br /> |-<br /> | 1<br /> | STARTUP_ARGUMENT_TYPE_RESTART<br /> |-<br /> | 2<br /> | STARTUP_ARGUMENT_TYPE_OTHER_MEDIA<br /> |}<br /> <br /> == CaptureBufferInfo ==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Size<br /> ! Description<br /> |-<br /> | 0x0<br /> | 0x4<br /> | u32, Size<br /> |-<br /> | 0x4<br /> | 0x1<br /> | u8, 3D (0 = not 3D, 1 = 3D)<br /> |-<br /> | 0x5<br /> | 0x3<br /> | Reserved<br /> |-<br /> | 0x8<br /> | 0x4<br /> | Main Screen Left Offset<br /> |-<br /> | 0xC<br /> | 0x4<br /> | Main Screen Right Offset<br /> |-<br /> | 0x10<br /> | 0x4<br /> | Main Screen [[NS_and_APT_Services#DisplayBufferMode|DisplayBufferMode]]<br /> |-<br /> | 0x14<br /> | 0x4<br /> | Sub Screen Left Offset<br /> |-<br /> | 0x18<br /> | 0x4<br /> | Sub Screen Right Offset<br /> |-<br /> | 0x1C<br /> | 0x4<br /> | Sub Screen [[NS_and_APT_Services#DisplayBufferMode|DisplayBufferMode]]<br /> |}<br /> <br /> ==WirelessRebootInfo==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Size<br /> ! Description<br /> |-<br /> | 0x0<br /> | 0x6<br /> | Host MAC address.<br /> |-<br /> | 0x6<br /> | 0x9<br /> | WirelessRebootPassphrase<br /> |-<br /> | 0xF<br /> | 0x1<br /> | Uninitialized<br /> |}<br /> <br /> 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]].<br /> <br /> {{Anchor|APTA}}{{Anchor|APT:A}}<br /> =&quot;APT:A&quot; Service=<br /> This was added with [[7.0.0-13|7.0.0-X]]. Official apps built with the CTRSDK for system-version &gt;=[[7.0.0-13|7.0.0-X]] normally use the &quot;APT:A&quot; service instead of &quot;APT:U&quot;. Those processes also have &quot;APT:A&quot; instead of &quot;APT:U&quot; in the service-access-control. Unlike APT:U, APT:A can call [[APT:GetAppletInfo]] with applet ID 0x300.<br /> <br /> =Applets=<br /> NS module does not verify that the input appID for the APT service cmds are correct for that type of command. For example, a process-launch of a SystemApplet via LibraryApplet commands works fine(minus the launched-process side of APT probably).<br /> <br /> ==System Applets==<br /> On Old3DS there could only be one applet here(Home Menu, Internet Browser, Friend-List, etc) with programID-high 00040030 running at a time. On Old3DS when directly launching one of these 00040030 applets with Home Menu, the Home Menu process will terminate once the process is launched. On Old3DS when returning to Home Menu from that launched process, the Home Menu process is launched again.<br /> <br /> On New3DS the Home Menu process is still running/in-memory, while another system-applet is running. On New3DS it appears that the Home Menu process is terminated+relaunched, when another system-applet terminated without exiting with APT properly.<br /> <br /> ==Library Applets==<br /> Library applets can be launched by applications and regular applets. These library applets render to the screen(s) when running, etc. For example, this includes swkbd for text input. See the below appIDs in the 0x2XX range, the actual appID used is 0x4XX however.<br /> <br /> Input data can be sent to the library applet via the NS [[APT:SendParameter|parameter]] buffer, and/or with shared-memory with a shared-mem handle sent to the library applet. Output data from the library applet can be received by [[APT:ReceiveParameter]], the library applet can also use the specified shared-mem for output too.<br /> <br /> =AppIDs=<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! AppID<br /> ! Description<br /> |-<br /> | 0x101<br /> | [[Home Menu]] (menu)<br /> |-<br /> | 0x103<br /> | Alternate Menu<br /> |-<br /> | 0x110<br /> | Camera applet ([[Camera Applet|CtrApp]])<br /> |-<br /> | 0x112<br /> | Friends List applet ([[Friend List|friend]])<br /> |-<br /> | 0x113<br /> | Game Notes applet (Cherry)<br /> |-<br /> | 0x114<br /> | [[Internet Browser]] (spider/SKATER)<br /> |-<br /> | 0x115<br /> | Instruction Manual applet<br /> |-<br /> | 0x116<br /> | [[Notifications]] applet (newslist)<br /> |-<br /> | 0x117<br /> | Miiverse applet (olv)<br /> |-<br /> | 0x118<br /> | [[Miiverse]] posting applet (solv3)<br /> |-<br /> | 0x119<br /> | Amiibo settings (cabinet)<br /> |-<br /> | 0x201<br /> | Software Keyboard (swkbd) (?)<br /> |-<br /> | 0x202<br /> | [[Mii Selector]] (appletEd) (?)<br /> |-<br /> | 0x204<br /> | Photo Selector (PNOTE_AP) (?)<br /> |-<br /> | 0x205<br /> | Sound Selector (SNOTE_AP) (?)<br /> |-<br /> | 0x206<br /> | Error Display ([[ErrDisp|error]]) (?)<br /> |-<br /> | 0x207<br /> | eShop applet ([[EShop#NS_eShop_application_parameters|mint]]) (?)<br /> |-<br /> | 0x208<br /> | Circle Pad Pro Calibrator ([[Extrapad_Applet|extrapad]]) (?)<br /> |-<br /> | 0x209<br /> | Notepad (memolib) (?)<br /> |-<br /> | 0x300<br /> | Application<br /> |-<br /> | 0x301<br /> | eShop (tiger)<br /> |-<br /> | 0x401<br /> | Software Keyboard (swkbd)<br /> |-<br /> | 0x402<br /> | Mii Selector (appletEd)<br /> |-<br /> | 0x404<br /> | Photo Selector (PNOTE_AP)<br /> |-<br /> | 0x405<br /> | Sound Selector (SNOTE_AP)<br /> |-<br /> | 0x406<br /> | Error Display (error)<br /> |-<br /> | 0x407<br /> | eShop applet (mint)<br /> |-<br /> | 0x408<br /> | Circle Pad Pro Calibrator ([[Extrapad_Applet|extrapad]])<br /> |-<br /> | 0x409<br /> | Notepad (memolib)<br /> |-<br /> | 0xF10<br /> | ProgramID: 0004003000008900.<br /> |-<br /> | 0xF11<br /> | ProgramID: 000400000FFFFD00.<br /> |-<br /> | 0xF12<br /> | ProgramID: 000400000FFFFC00.<br /> |-<br /> | 0xF13<br /> | ProgramID: 000400000FFFFB00.<br /> |-<br /> | 0xF14<br /> | ProgramID: 000400000FFFF900.<br /> |-<br /> | 0xF15<br /> | ProgramID: 000400000FFFF800.<br /> |-<br /> | 0xF16<br /> | ProgramID: 000400000FFFF700.<br /> |-<br /> | 0xF17<br /> | ProgramID: 000400000FFFF600.<br /> |-<br /> | 0xF18<br /> | ProgramID: 000400000FFFF500.<br /> |}<br /> <br /> These AppIDs are all for NAND titles, except for 0x300. AppIDs in the 0x1XX range are applets(programID-high 00040030), and the AppIDs in the 0x2XX range are &quot;system libraries&quot;(programID-high 00040030). The 0xFXX AppID range is for development NAND applications, these are not available for retail.<br /> <br /> Note that at some point the total AppID entry count was changed from 28 to 27.<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Services_API&diff=22741 Services API 2024-09-18T10:31:21Z <p>ElementW: Replace service links with new Template:Service</p> <hr /> <div>Nintendo provides application developers with an API, which communicate with certain services. Services, in this sense, are [[Title_list#00040130_-_System_Modules|system processes running in the background]] which wait for incoming requests. When a process wants to communicate with a service, it first needs to get a handle to the named service, and then it can communicate with the service via interprocess communication. Each service has a name up to 8 characters, for example {{Service|nim:u}}.<br /> <br /> Handles for services are retrieved from the [[Services|service manager port]], &lt;code&gt;srv:&lt;/code&gt;. Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC.<br /> <br /> For a description of how commands and arguments are passed to services, see [[IPC Command Structure]].<br /> <br /> List of services (grouped by the process which provides them):<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Old3ds<br /> ! Services<br /> ! Service names<br /> ! scope=&quot;col&quot; width=&quot;200&quot; | Notes<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Filesystem services‎]]<br /> | {{Service|fs:USER}}, {{Service|fs:LDR}}, {{Service|fs:REG}}<br /> | USER: normal applications and system modules, LDR: loader, REG: register<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Process Services‎]]<br /> | {{Service|ps:ps}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[PXI Services‎]]<br /> | {{Service|PxiFS0}}, {{Service|PxiFS1}}, {{Service|PxiFSB}}, {{Service|PxiFSR}}, {{Service|PxiPM}}, {{Service|pxi:am9}}, {{Service|pxi:dev}}, {{Service|pxi:mc}}, {{Service|pxi:ps9}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Application Manager Services]]<br /> | {{Service|am:app}}, {{Service|am:net}}, {{Service|am:u}}, {{Service|am:sys}}, {{Service|am:pipe}}<br /> | app: am for applications, net: network installation ([[NIM_Services|nim]]), u: local installation, sys: am for system titles, pipe: not an actual port (internally used to represent the [[Application_Manager_Services#File_service|FSFile-like interface]])<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Process Manager Services]]<br /> | {{Service|pm:app}}, {{Service|pm:dbg}}<br /> | app: launching titles, dbg: launching titles with debugging enabled<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[NIM Services]]<br /> | {{Service|nim:aoc}}, {{Service|nim:ndm}}, {{Service|nim:s}}, {{Service|nim:u}}<br /> | aoc: DLC, ndm: for [[NDM Services|ndm]], s: for eShop, u: for updater<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Config Services]]<br /> | {{Service|cfg:u}}, {{Service|cfg:s}}, {{Service|cfg:i}}, {{Service|cfg:nor}}<br /> | u: for user, s: for system, i: for initialization/formatting, nor: accesses wifi SPI flash<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[NS|NS and APT Services]]<br /> | {{Service|ns:s}}, {{Service|ns:p}}, {{Service|ns:c}}, {{Service|APT:A}}, {{Service|APT:S}}, {{Service|APT:U}}<br /> | ns:s: for system, ns:p: power (shutdown/reboot), ns:c: ?, APT:A: application, APT:S: system, APT:U: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[RO Services]]<br /> | {{Service|ldr:ro}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[NDM Services]]<br /> | {{Service|ndm:u}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[CSND Services]]<br /> | {{Service|csnd:SND}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Camera Services]]<br /> | {{Service|cam:u}}, {{Service|y2r:u}}, {{Service|cam:s}}, {{Service|cam:c}}, {{Service|cam:q}} (New3DS only)<br /> | <br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Codec Services]]<br /> | {{Service|cdc:HID}}, {{Service|cdc:MIC}}, {{Service|cdc:CSN}}, {{Service|cdc:DSP}}, {{Service|cdc:LGY}}, {{Service|cdc:CHK}}<br /> | HID: human interface device, MIC: microphone, CSN: for [[CSND_Services|csnd]]?, DSP: for [[DSP_Services|dsp]]?, LGY: legacy (some kind of backwards compat?), CHK: ?<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[DLP Services]]<br /> | {{Service|dlp:CLNT}}, {{Service|dlp:FKCL}}, {{Service|dlp:SRVR}}<br /> | CLNT: client, FKCL: fake client, SRVR: server<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[DSP Services]]<br /> | {{Service|dsp::DSP}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[GSP Services]]<br /> | {{Service|gsp::Lcd}}, {{Service|gsp::Gpu}}<br /> | Lcd: LCD control, Gpu: GPU control<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[BOSS Services]]<br /> | {{Service|boss:U}}, {{Service|boss:P}}, {{Service|boss:M}}<br /> | U: user, P: privileged, M: for [[NDM Services|ndm]]<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[CECD Services]]<br /> | {{Service|cecd:u}}, {{Service|cecd:s}}, {{Service|cecd:ndm}}<br /> | u: user, s: system, ndm: for [[NDM Services|ndm]]<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[IR Services]]<br /> | {{Service|ir:u}}, {{Service|ir:USER}}, {{Service|ir:rst}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[I2C Services]]<br /> | {{Service|i2c::MCU}}, {{Service|i2c::CAM}}, {{Service|i2c::LCD}}, {{Service|i2c::DEB}}, {{Service|i2c::HID}}, {{Service|i2c::IR}}, {{Service|i2c::EEP}}, {{Service|i2c::NFC}}, {{Service|i2c::QTM}}<br /> | <br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[GPIO Services]]<br /> | {{Service|gpio:CDC}}, {{Service|gpio:MCU}}, {{Service|gpio:HID}}, {{Service|gpio:NWM}}, {{Service|gpio:IR}}, {{Service|gpio:NFC}}, {{Service|gpio:QTM}}<br /> | <br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[HID Services]]<br /> | {{Service|hid:NFC}}, {{Service|hid:QTM}}, {{Service|hid:SPVR}}, {{Service|hid:USER}}<br /> | NFC: near-field communication (amiibo), QTM: head tracking device (related to [[QTM_Services|QTM Services]])?, SPVR: system privileged?<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[PTM Services]]<br /> | {{Service|ptm:gets}}, {{Service|ptm:play}}, {{Service|ptm:s}}, {{Service|ptm:sets}}, {{Service|ptm:sysm}}, {{Service|ptm:u}}<br /> | gets: get system time, play: play history, s: system, sets: set system time, sysm: system menu (homemenu/testmenu), u: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[NWM Services]]<br /> | {{Service|nwm::CEC}}, {{Service|nwm::EXT}}, {{Service|nwm::INF}}, {{Service|nwm::SAP}}, {{Service|nwm::SOC}}, {{Service|nwm::TST}}, {{Service|nwm::UDS}}<br /> | CEC: streetpass, EXT: ?, INF: infrastructure, SAP: ?, SOC: socket, UDS: local WLAN, TST: ?<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[HTTP Services]]<br /> | {{Service|http:C}}<br /> | C: connection<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[SSL Services]]<br /> | {{Service|ssl:C}}<br /> | C: connection<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Socket Services]]<br /> | {{Service|soc:P}}, {{Service|soc:U}}<br /> | P: privileged, U: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[AC Services]]<br /> | {{Service|ac:i}}, {{Service|ac:u}}<br /> | i: internal, u: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Friend Services]]<br /> | {{Service|frd:a}}, {{Service|frd:n}}, {{Service|frd:u}}<br /> | a: admin, n: for [[NDM Services|ndm]], u: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[News Services]]<br /> | {{Service|news:s}}, {{Service|news:u}}<br /> | s: system, u:user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[PDN Services]]<br /> | {{Service|pdn:s}}, {{Service|pdn:d}}, {{Service|pdn:i}}, {{Service|pdn:g}}, {{Service|pdn:c}}<br /> | <br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[SPI Services]]<br /> | {{Service|SPI::NOR}}, {{Service|SPI::CD2}}, {{Service|SPI::CS2}}, {{Service|SPI::CS3}}, {{Service|SPI::DEF}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[Loader Services]]<br /> | {{Service|Loader}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[MCU Services]]<br /> | {{Service|mcu::CAM}}, {{Service|mcu::GPU}}, {{Service|mcu::HID}}, {{Service|mcu::RTC}}, {{Service|mcu::SND}}, {{Service|mcu::NWM}}, {{Service|mcu::HWC}}, {{Service|mcu::PLS}}, {{Service|mcu::CDC}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[MIC Services]]<br /> | {{Service|mic:u}}<br /> |<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[ACT Services]]<br /> | {{Service|act:a}}, {{Service|act:u}}<br /> | a: admin, u: user<br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[MP Services]]<br /> | {{Service|mp:u}}<br /> | <br /> |-<br /> | style=&quot;background: green&quot; | Yes<br /> | [[NFC Services]]<br /> | {{Service|nfc:dev}}, {{Service|nfc:m}}, {{Service|nfc:p}}, {{Service|nfc:r}}, {{Service|nfc:s}}, {{Service|nfc:u}}<br /> | dev: developer, m: ? p: passthrough?, r: raw?, s: system, u: user<br /> |-<br /> | style=&quot;background: red&quot; | No<br /> | [[MVD Services]]<br /> | <br /> |<br /> |-<br /> | style=&quot;background: red&quot; | No<br /> | [[QTM Services]]<br /> | <br /> |<br /> |}<br /> <br /> List of PXI services:<br /> * [[Filesystem services PXI]]<br /> * [[Process Services PXI]]<br /> * [[Application Manager Services PXI]]<br /> * [[Process Manager Services PXI]]<br /> * [[Development Services PXI]]<br /> * [[Gamecard Services PXI]]<br /> * [[Legacy FIRM PXI]] (TWL_FIRM/AGB_FIRM)<br /> <br /> List of ports:<br /> * [[ErrDisp]]<br /> * [[Services]]<br /> <br /> <br /> See [[Error codes]].</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:Service&diff=22740 Template:Service 2024-09-18T10:19:43Z <p>ElementW: Prevent &quot;news:*&quot; service links from breaking</p> <hr /> <div>&lt;span style=&quot;font-family:monospace&quot;&gt;[[:{{{1}}}]]&lt;/span&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Template:Service&diff=22739 Template:Service 2024-09-18T10:16:37Z <p>ElementW: Created page with &quot;&lt;span style=&quot;font-family:monospace&quot;&gt;{{{1}}}&lt;/span&gt;&quot;</p> <hr /> <div>&lt;span style=&quot;font-family:monospace&quot;&gt;[[{{{1}}}]]&lt;/span&gt;</div> ElementW https://www.3dbrew.org/w/index.php?title=Cfg:nor&diff=22738 Cfg:nor 2024-09-18T09:58:30Z <p>ElementW: Redirected page to Config Services#cfg:nor</p> <hr /> <div>#REDIRECT [[Config_Services#cfg:nor]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Cfg:i&diff=22737 Cfg:i 2024-09-18T09:57:22Z <p>ElementW: Redirected page to Config Services#cfg:i</p> <hr /> <div>#REDIRECT [[Config_Services#cfg:i]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Cfg:s&diff=22736 Cfg:s 2024-09-18T09:57:06Z <p>ElementW: Redirected page to Config Services#cfg:s</p> <hr /> <div>#REDIRECT [[Config_Services#cfg:s]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Cfg:u&diff=22735 Cfg:u 2024-09-18T09:56:09Z <p>ElementW: Redirected page to Config Services#cfg:u</p> <hr /> <div>#REDIRECT [[Config_Services#cfg:u]]</div> ElementW https://www.3dbrew.org/w/index.php?title=SRV:RegisterService&diff=22734 SRV:RegisterService 2024-09-18T09:54:28Z <p>ElementW: Convert to IPC templates</p> <hr /> <div>=Request=<br /> {{IPC/Request|Request}}<br /> {{IPC/RequestHeader|0x0003|4|0}}<br /> {{IPC/RequestEntryRange|2|8-byte UTF-8 service name}}<br /> {{IPC/RequestEntry|Name length}}<br /> {{IPC/RequestEntry|Maximum sessions}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Response=<br /> {{IPC/Request|Response}}<br /> {{IPC/RequestHeader|0x0003|1|2}}<br /> {{IPC/RequestEntry|Result code}}<br /> {{IPC/MoveHandle|1}}<br /> {{IPC/MoveHandleEntry|&lt;code&gt;Handle&lt;[[KServerPort]]&gt;&lt;/code&gt; which will receive incoming connections to the service.}}<br /> {{IPC/RequestEnd}}<br /> <br /> This function registers a new service which can be accessed using [[SRV:GetServiceHandle]]. The service manager will create a new client-server port pair, registering the [[KPort|client endpoint]] under the given name, and returning the [[KServerPort|server endpoint]] for the service to listen on for incoming connections.</div> ElementW https://www.3dbrew.org/w/index.php?title=GSPGPU:WriteHWRegsWithMask&diff=22733 GSPGPU:WriteHWRegsWithMask 2024-09-18T09:50:30Z <p>ElementW: Fix reponse section saying &quot;request&quot;</p> <hr /> <div>=Request=<br /> {{IPC/Request|Request}}<br /> {{IPC/RequestHeader|0x0002|2|4}}<br /> {{IPC/RequestEntry|[[GPU]] address based at 0x1EB00000, must be word-aligned}}<br /> {{IPC/RequestEntry|&lt;nowiki&gt;Size, must be &lt;=0x80 and word-aligned&lt;/nowiki&gt;}}<br /> {{IPC/TranslateStaticBuffer|Data pointer|0}}<br /> {{IPC/TranslateStaticBuffer|Mask data pointer|1}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Response=<br /> {{IPC/Request|Response}}<br /> {{IPC/RequestHeader|0x0002|2|0}}<br /> {{IPC/RequestEntry|Header code}}<br /> {{IPC/RequestEntry|Result code}}<br /> {{IPC/RequestEnd}}<br /> <br /> =Description=<br /> The GPU register offset must be &lt;0x420000. GPU register = (register &amp; ~maskword) | (data &amp; maskword).</div> ElementW https://www.3dbrew.org/w/index.php?title=Nim:u&diff=22732 Nim:u 2024-09-18T09:40:33Z <p>ElementW: Redirected page to NIM Services#nim:u</p> <hr /> <div>#REDIRECT [[NIM_Services#nim:u]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Nim:s&diff=22731 Nim:s 2024-09-18T09:39:58Z <p>ElementW: Redirected page to NIM Services#nim:s</p> <hr /> <div>#REDIRECT [[NIM_Services#nim:s]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Nim:ndm&diff=22730 Nim:ndm 2024-09-18T09:39:33Z <p>ElementW: Redirected page to NIM Services#nim:ndm</p> <hr /> <div>#REDIRECT [[NIM_Services#nim:ndm]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Nim:aoc&diff=22729 Nim:aoc 2024-09-18T09:39:06Z <p>ElementW: Redirected page to NIM Services#nim:aoc</p> <hr /> <div>#REDIRECT [[NIM_Services#nim:aoc]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Pm:dbg&diff=22728 Pm:dbg 2024-09-18T09:37:12Z <p>ElementW: Redirected page to Process Manager Services#pm:dbg</p> <hr /> <div>#REDIRECT [[Process_Manager_Services#pm:dbg]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Pm:app&diff=22727 Pm:app 2024-09-18T09:36:48Z <p>ElementW: Redirected page to Process Manager Services#pm:app</p> <hr /> <div>#REDIRECT [[Process_Manager_Services#pm:app]]</div> ElementW https://www.3dbrew.org/w/index.php?title=RO_Services&diff=22726 RO Services 2024-09-18T09:35:04Z <p>ElementW: Add anchors</p> <hr /> <div>{{Anchor|RO}}{{Anchor|ldr:ro}}<br /> = RO service &quot;ldr:ro&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Description<br /> |-<br /> | 0x000100C2<br /> | [[2.0.0-2]]<br /> | [[RO:Initialize|Initialize]]<br /> |-<br /> | 0x00020082<br /> | [[2.0.0-2]]<br /> | [[RO:LoadCRR|LoadCRR]]<br /> |-<br /> | 0x00030042<br /> | [[2.0.0-2]]<br /> | [[RO:UnloadCRR|UnloadCRR]]<br /> |-<br /> | 0x000402C2<br /> | [[2.0.0-2]]<br /> | [[RO:LoadExeCRO|LoadCRO]]<br /> |-<br /> | 0x000500C2<br /> | [[2.0.0-2]]<br /> | [[RO:UnloadCRO|UnloadCRO]]<br /> |-<br /> | 0x00060042<br /> | [[2.0.0-2]]<br /> | [[RO:LinkCRO|LinkCRO]]<br /> |-<br /> | 0x00070042<br /> | [[2.0.0-2]]<br /> | [[RO:UnlinkCRO|UnlinkCRO]]<br /> |-<br /> | 0x00080042<br /> | [[2.0.0-2]]<br /> | [[RO:Shutdown|Shutdown]]<br /> |-<br /> | 0x000902C2<br /> | [[7.2.0-17]]<br /> | [[RO:LoadExeCRO|LoadCRO_New]]<br /> |}<br /> The mapadress used in these services is calculated by the user-process like so: when inputaddr is &lt;0x08000000, the address used is the same one from inputaddr. Otherwise, the address is: mapvaddr = inputaddr - (0x08000000 - &lt;main-process .text address + .text, .rodata, .data, and .bss size aligned to pagesize&gt;). This service API is used for CTR &quot;DLLs&quot;/shared libraries: [[CRO0|CRO]].<br /> <br /> = Error Codes =<br /> {| class=&quot;wikitable&quot; border =&quot;1&quot;<br /> |-<br /> !Error Code<br /> !Description<br /> |-<br /> | D9012FF1<br /> | Address is misaligned<br /> |-<br /> | E0A12FF9<br /> | Service is already Initialized<br /> |-<br /> | E1612FF7<br /> | Provided Kernel Handle is invalid<br /> |-<br /> |}<br /> = Version history =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Version<br /> ! Changes<br /> |-<br /> | v0<br /> | Initial version.<br /> |-<br /> | v1024<br /> | Removed access for SVC's: 5,7,D,E,10.<br /> <br /> Cmd5 now sets the last segment in the CRO binary to R-X when it's done.<br /> <br /> Maybe more.<br /> |-<br /> | v2049<br /> | No changes.<br /> |-<br /> | v3074<br /> | Added cmd9.<br /> |-<br /> | v4096<br /> | No changes.<br /> |-<br /> | [[9.0.0-20|v5120]]<br /> | No actual changes, just a rebuild with latest CTRSDK(only the CTRSDK version values in .code for [[ErrDisp]] were updated).<br /> |}<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Config_Services&diff=22725 Config Services 2024-09-18T09:33:40Z <p>ElementW: Add anchors</p> <hr /> <div>__TOC__<br /> {{Anchor|Cfg}}{{Anchor|CfgU}}{{Anchor|CFG}}{{Anchor|CFGU}}{{Anchor|cfg:u}}<br /> = Config service &quot;cfg:u&quot; =<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Description<br /> |-<br /> | 0x00010082<br /> | <br /> | [[CfgS:GetConfigInfoBlk2|GetConfigInfoBlk2]]/GetConfig<br /> |-<br /> | 0x00020000<br /> | <br /> | [[Cfg:SecureInfoGetRegion|SecureInfoGetRegion]]/GetRegion<br /> |-<br /> | 0x00030040<br /> | <br /> | [[Cfg:GenHashConsoleUnique|GenHashConsoleUnique]]/GetTransferableId<br /> |-<br /> | 0x00040000<br /> | [[3.0.0-5]]<br /> | [[Cfg:GetRegionCanadaUSA|GetRegionCanadaUSA]]/IsCoppacsSupported<br /> |-<br /> | 0x00050000<br /> | [[5.0.0-11]]<br /> | [[Cfg:GetSystemModel|GetSystemModel]]<br /> |-<br /> | 0x00060000<br /> | [[6.0.0-11]]<br /> | [[Cfg:GetModelNintendo2DS|GetModelNintendo2DS]]<br /> |-<br /> | 0x00070040<br /> | [[7.0.0-13]]<br /> | (u8 val) This writes the input u8 to the first byte in the config-block for blkID [[Config_Savegame|0x00160000]].<br /> |-<br /> | 0x00080080<br /> | [[7.0.0-13]]<br /> | [[Cfg:TranslateCountryInfo|TranslateCountryInfo]]<br /> |-<br /> | 0x00090040<br /> | [[7.0.0-13]]<br /> | [[Cfg:GetCountryCodeString|GetCountryCodeString]]<br /> |-<br /> | 0x000A0040<br /> | [[7.0.0-13]]<br /> | [[Cfg:GetCountryCodeID|GetCountryCodeID]]<br /> |-<br /> | 0x000B0000<br /> | [[9.3.0-21|9.3.0-X]]<br /> | IsFangateSupported<br /> |}<br /> <br /> {{Anchor|CfgS}}{{Anchor|CFGS}}{{Anchor|cfg:s}}<br /> = Config service &quot;cfg:s&quot; =<br /> cfg:s contains all the commands in [[#cfg:u|cfg:u]], in addition to the following:<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Description<br /> |-<br /> | 0x04010082<br /> | <br /> | [[CfgS:GetConfigInfoBlk8|GetConfigInfoBlk8]]<br /> |-<br /> | 0x04020082<br /> | <br /> | [[CfgS:SetConfigInfoBlk4|SetConfigInfoBlk4]]<br /> |-<br /> | 0x04030000<br /> | <br /> | [[Cfg:UpdateConfigNANDSavegame|UpdateConfigNANDSavegame]]<br /> |-<br /> | 0x04040042<br /> | <br /> | [[Cfg:GetLocalFriendCodeSeedData|GetLocalFriendCodeSeedData]]<br /> |-<br /> | 0x04050000<br /> | <br /> | [[CfgS:GetLocalFriendCodeSeed|GetLocalFriendCodeSeed]]<br /> |-<br /> | 0x04060000<br /> | <br /> | [[Cfg:SecureInfoGetRegion|SecureInfoGetRegion]]<br /> |-<br /> | 0x04070000<br /> | <br /> | [[CfgS:SecureInfoGetByte101|SecureInfoGetByte101]]<br /> |-<br /> | 0x04080042<br /> | <br /> | [[CfgS:SecureInfoGetSerialNo|SecureInfoGetSerialNo]]<br /> |-<br /> | 0x04090000<br /> | <br /> | [[Cfg:UpdateConfigBlk00040003|UpdateConfigBlk00040003]]<br /> |-<br /> | 0x040A0000<br /> | ?<br /> | ?<br /> |-<br /> | 0x040B0000<br /> | ?<br /> | ?<br /> |-<br /> | 0x040C0000<br /> | ?<br /> | ?<br /> |-<br /> | 0x040D0040<br /> | <br /> | SetUUIDClockSequence<br /> |-<br /> | 0x040E0000<br /> | <br /> | GetUUIDClockSequence<br /> |-<br /> | 0x040F0000<br /> | <br /> | [[CfgS:ClearParentalControls|ClearParentalControls]]<br /> |}<br /> <br /> CfgS command 0x04060000(SecureInfoGetRegion) is used by NIM module to determine the SOAP RegionId, when sending SOAP requests. See [[Nandrw/sys/SecureInfo_A|here]].<br /> <br /> {{Anchor|CfgI}}{{Anchor|CFGI}}{{Anchor|cfg:i}}<br /> = Config service &quot;cfg:i&quot; =<br /> cfg:i contains all the commands in [[#cfg:u|cfg:u]] and [[#cfg:s|cfg:s]], in addition to the following:<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Available since system version<br /> ! Description<br /> |-<br /> | 0x08010082<br /> | <br /> | [[CfgS:GetConfigInfoBlk8|GetConfigInfoBlk8]]<br /> |-<br /> | 0x08020082<br /> | <br /> | [[CfgS:SetConfigInfoBlk4|SetConfigInfoBlk4]]<br /> |-<br /> | 0x08030000<br /> | <br /> | [[Cfg:UpdateConfigNANDSavegame|UpdateConfigNANDSavegame]]<br /> |-<br /> | 0x080400C2<br /> | <br /> | [[CfgI:CreateConfigInfoBlk|CreateConfigInfoBlk]]<br /> |-<br /> | 0x08050000<br /> | <br /> | [[CfgI:DeleteConfigNANDSavefile|DeleteConfigNANDSavefile]]<br /> |-<br /> | 0x08060000<br /> | <br /> | [[CfgI:FormatConfig|FormatConfig]]<br /> |-<br /> | 0x08070000<br /> | <br /> | This basically just returns result-code value 0x0, due to code this eventually executes being NOPed out.<br /> |-<br /> | 0x08080000<br /> | <br /> | This updates the config blocks for blkIDs 0x0 and 0x20000. In certain cases this may call the code for [[CfgI:FormatConfig|FormatConfig]].<br /> |-<br /> | 0x08090000<br /> | <br /> | This updates the config block for blkID 0x60000.<br /> |-<br /> | 0x080A0000<br /> | <br /> | ResetAnalogStickCalibrationParam? This updates the config block for blkID 0x00040001.<br /> |-<br /> | 0x080B0082<br /> | <br /> | [[CfgI:SetGetLocalFriendCodeSeedData|SetGetLocalFriendCodeSeedData]]<br /> |-<br /> | 0x080C0042<br /> | <br /> | [[CfgI:SetLocalFriendCodeSeedSignature|SetLocalFriendCodeSeedSignature]]<br /> |-<br /> | 0x080D0000<br /> | <br /> | [[CfgI:DeleteCreateNANDLocalFriendCodeSeed|DeleteCreateNANDLocalFriendCodeSeed]]<br /> |-<br /> | 0x080E0000<br /> | <br /> | [[CfgI:VerifySigLocalFriendCodeSeed|VerifySigLocalFriendCodeSeed]] <br /> |-<br /> | 0x080F0042<br /> | <br /> | [[Cfg:GetLocalFriendCodeSeedData|GetLocalFriendCodeSeedData]]<br /> |-<br /> | 0x08100000<br /> | <br /> | [[CfgS:GetLocalFriendCodeSeed|GetLocalFriendCodeSeed]]<br /> |-<br /> | 0x08110084<br /> | <br /> | [[CfgI:SetSecureInfo|SetSecureInfo]]<br /> |-<br /> | 0x08120000<br /> | <br /> | [[CfgI:DeleteCreateNANDSecureInfo|DeleteCreateNANDSecureInfo]]<br /> |-<br /> | 0x08130000<br /> | <br /> | [[CfgI:VerifySigSecureInfo|VerifySigSecureInfo]]<br /> |-<br /> | 0x08140042<br /> | <br /> | [[CfgI:SecureInfoGetData|SecureInfoGetData]]<br /> |-<br /> | 0x08150042<br /> | <br /> | [[CfgI:SecureInfoGetSignature|SecureInfoGetSignature]]<br /> |-<br /> | 0x08160000<br /> | <br /> | [[Cfg:SecureInfoGetRegion|SecureInfoGetRegion]]<br /> |-<br /> | 0x08170000<br /> | <br /> | [[CfgS:SecureInfoGetByte101|SecureInfoGetByte101]]<br /> |-<br /> | 0x08180042<br /> | <br /> | [[CfgS:SecureInfoGetSerialNo|SecureInfoGetSerialNo]]<br /> |-<br /> | 0x0819....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081A....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081B....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081C....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081D....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081E....<br /> | ?<br /> | ?<br /> |-<br /> | 0x081F....<br /> | ?<br /> | ?<br /> |-<br /> | 0x0820....<br /> | ?<br /> | ?<br /> |}<br /> <br /> {{Anchor|CfgNor}}{{Anchor|CFGNOR}}{{Anchor|cfg:nor}}<br /> = Config NVRAM service &quot;cfg:nor&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | [[CfgNor:Initialize|Initialize]]<br /> |-<br /> | 0x00020000<br /> | [[CfgNor:Shutdown|Shutdown]]<br /> |-<br /> | 0x00030040<br /> | (u8 flag) Writes the input flag to state. Uses SPI service command [[SPI_Services|EnableSpiBus]].<br /> |-<br /> | 0x00040000<br /> | Writes the u8 from the state written by 0x00030040 to cmdreply[2].<br /> |-<br /> | 0x00050082<br /> | [[CfgNor:ReadData|ReadData]]<br /> |-<br /> | 0x00060082<br /> | [[CfgNor:WriteData|WriteData]]<br /> |-<br /> | 0x00070000<br /> | This just uses the WREN command.<br /> |-<br /> | 0x00080000<br /> | This just uses the WRDI command.<br /> |-<br /> | 0x00090000<br /> | [[CfgNor:ReadIdentification|ReadIdentification]]<br /> |-<br /> | 0x000A0000<br /> | This waits for the WIP bit in the status register to clear(wait for writing to finish).<br /> |-<br /> | 0x000B0000<br /> | This waits for the WEL bit in the status register to become set(write enabled).<br /> |-<br /> | 0x000C0000<br /> | This writes the value of the WIP bit in the status register to u8 cmdreply[2].<br /> |-<br /> | 0x000D0000<br /> | This writes the value of the WIP bit in the status register to u8 cmdreply[2].<br /> |-<br /> | 0x000E0000<br /> | [[CfgNor:ReadStatusRegister|ReadStatusRegister]]<br /> |-<br /> | 0x000F0082<br /> | [[CfgNor:ReadDataOther|ReadDataOther]]<br /> |-<br /> | 0x00100082<br /> | [[CfgNor:WriteDataOther|WriteDataOther]]<br /> |-<br /> | 0x00110040<br /> | (u32 offset) Uses command WREN then waits for WEL to become enabled. Sends command 0xDB to SPI followed by the specified flash offset.<br /> |-<br /> | 0x00120040<br /> | (u32 offset) Identical to 0x00110040 except this uses SPI-command 0xD8 instead(&quot;block erase&quot;).<br /> |-<br /> | 0x00130000<br /> | This uses SPI command 0xB9 for &quot;Deep power down&quot;.<br /> |-<br /> | 0x00140000<br /> | This uses SPI command 0xAB for &quot;Release from deep power down&quot;.<br /> |}<br /> This is an interface for the [[SPI::NOR]] service, for accessing the Wifi NVRAM/SPI Flash.<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=NIM_Services&diff=22724 NIM Services 2024-09-18T09:29:25Z <p>ElementW: Add anchors</p> <hr /> <div>__TOC__<br /> {{Anchor|NIMU}}{{Anchor|nim:u}}<br /> = NIM updater service &quot;nim:u&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010000<br /> | [[NIMU:StartNetworkUpdate|StartNetworkUpdate]]<br /> |-<br /> | 0x00020000<br /> | [[NIMU:GetProgress|GetProgress]]<br /> |-<br /> | 0x00030000<br /> | [[NIMU:Cancel|Cancel]]<br /> |-<br /> | 0x00040000<br /> | [[NIMU:CommitSystemTitles|CommitSystemTitles]]<br /> |-<br /> | 0x00050000<br /> | [[NIMU:GetBackgroundEventForMenu|GetBackgroundEventForMenu]]<br /> |-<br /> | 0x00060000<br /> | [[NIMU:GetBackgroundEventForNews|GetBackgroundEventForNews]]<br /> |-<br /> | 0x00070000<br /> | [[NIMU:FormatSaveData|FormatSaveData]]<br /> |-<br /> | 0x00080000<br /> | [[NIMU:GetCustomerSupportCode|GetCustomerSupportCode]]<br /> |-<br /> | 0x00090000<br /> | [[NIMU:IsCommittableAllSystemTitles|IsCommittableAllSystemTitles]]<br /> |-<br /> | 0x000A0000<br /> | [[NIMU:GetBackgroundProgress|GetBackgroundProgress]]<br /> |-<br /> | 0x000B0000<br /> | [[NIMU:GetSavedHash|GetSavedHash]]<br /> |-<br /> | 0x000C0082<br /> | [[NIMU:UnregisterTask|UnregisterTask]]<br /> |-<br /> | 0x000D0080<br /> | [[NIMU:IsRegistered|IsRegistered]]<br /> |-<br /> | 0x000E0080<br /> | [[NIMU:FindTaskInfo|FindTaskInfo]]<br /> |-<br /> | 0x000F0042<br /> | [[NIMU:GetTaskInfos|GetTaskInfos]]<br /> |-<br /> | 0x00100000<br /> | [[NIMU:DeleteUnmanagedContexts|DeleteUnmanagedContexts]]<br /> |-<br /> | 0x00110000<br /> | [[NIMU:UpdateAutoTitleDownloadTasksAsync|UpdateAutoTitleDownloadTasksAsync]]<br /> |-<br /> | 0x00120000<br /> | [[NIMU:StartPendingAutoTitleDownloadTasksAsync|StartPendingAutoTitleDownloadTasksAsync]]<br /> |-<br /> | 0x00130000<br /> | [[NIMU:GetAsyncResult|GetAsyncResult]]<br /> |-<br /> | 0x00140000<br /> | [[NIMU:CancelAsyncCall|CancelAsyncCall]]<br /> |-<br /> | 0x00150000<br /> | [[NIMU:IsPendingAutoTitleDownloadTasks|IsPendingAutoTitleDownloadTasks]]<br /> |-<br /> | 0x00160000<br /> | [[NIMU:GetNumAutoTitleDownloadTasks|GetNumAutoTitleDownloadTasks]]<br /> |-<br /> | 0x00170042<br /> | [[NIMU:GetAutoTitleDownloadTaskInfos|GetAutoTitleDownloadTaskInfos]]<br /> |-<br /> | 0x00180080<br /> | [[NIMU:CancelAutoTitleDownloadTask|CancelAutoTitleDownloadTask]]<br /> |-<br /> | 0x00190002<br /> | [[NIMU:SetAutoDbgDat|SetAutoDbgDat]]<br /> |-<br /> | 0x001A0002<br /> | [[NIMU:GetAutoDbgDat|GetAutoDbgDat]]<br /> |-<br /> | 0x001B0042<br /> | [[NIMU:SetDbgTasks|SetDbgTasks]]<br /> |-<br /> | 0x001C0042<br /> | [[NIMU:GetDbgTasks|GetDbgTasks]]<br /> |-<br /> | 0x001D0000<br /> | [[NIMU:DeleteDbgData|DeleteDbgData]]<br /> |-<br /> | 0x001E0042<br /> | [[NIMU:SetTslXml|SetTslXml]]<br /> |-<br /> | 0x001F0000<br /> | [[NIMU:GetTslXmlSize|GetTslXmlSize]]<br /> |-<br /> | 0x00200042<br /> | [[NIMU:GetTslXml|GetTslXml]]<br /> |-<br /> | 0x00210000<br /> | [[NIMU:DeleteTslXml|DeleteTslXml]]<br /> |-<br /> | 0x00220042<br /> | [[NIMU:SetDtlXml|SetDtlXml]]<br /> |-<br /> | 0x00230000<br /> | [[NIMU:GetDtlXmlSize|GetDtlXmlSize]]<br /> |-<br /> | 0x00240042<br /> | [[NIMU:GetDtlXml|GetDtlXml]]<br /> |-<br /> | 0x00250000<br /> | [[NIMU:UpdateAccountStatus|UpdateAccountStatus]]<br /> |-<br /> | 0x00260180<br /> | [[NIMU:StartTitleDownload|StartTitleDownload]]<br /> |-<br /> | 0x00270000<br /> | [[NIMU:StopTitleDownload|StopTitleDownload]]<br /> |-<br /> | 0x00280000<br /> | [[NIMU:GetTitleDownloadProgress|GetTitleDownloadProgress]]<br /> |-<br /> | 0x00290246<br /> | [[NIMU:RegisterTask|RegisterTask]]<br /> |-<br /> | 0x002A0000<br /> | [[NIMU:IsSystemUpdateAvailable|IsSystemUpdateAvailable]]<br /> |-<br /> | 0x002B0000<br /> | ? (Response: 0 = 0x002B0040, 1 = Result Code)<br /> |-<br /> | 0x002C0000<br /> | [[NIMU:UpdateTickets|UpdateTickets]]<br /> |-<br /> | 0x002D00C0<br /> | [[NIMU:DownloadTitleSeedAsync|DownloadTitleSeedAsync]]<br /> |-<br /> | 0x002E0000<br /> | [[NIMU:DownloadMissingTitleSeedsAsync|DownloadMissingTitleSeedsAsync]]<br /> |-<br /> |}<br /> <br /> {{Anchor|NIMS}}{{Anchor|nim:s}}<br /> = NIM shop service &quot;nim:s&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010200<br /> | [[NIMS:StartDownloadSimple|StartDownloadSimple]]<br /> |-<br /> | 0x00020000<br /> | [[NIMS:CancelDownload|CancelDownload]]<br /> |-<br /> | 0x00030000<br /> | [[NIMS:GetProgress|GetProgress]]<br /> |-<br /> | 0x00050082<br /> | [[NIMS:UnregisterTask|UnregisterTask]]<br /> |-<br /> | 0x00060080<br /> | [[NIMS:IsTaskRegistered|IsTaskRegistered]]<br /> |-<br /> | 0x00070080<br /> | GetTaskInfoFromTitleId<br /> |-<br /> | 0x00080042<br /> | GetTaskList<br /> |-<br /> | 0x0009xxxx<br /> | Returns 0xE0C0D3F4, not implemented.<br /> |-<br /> | 0x000A0000<br /> | [[NIMS:CheckSysupdateAvailableSOAP|CheckSysupdateAvailableSOAP]]<br /> |-<br /> | 0x000B0084<br /> | [[NIMS:SetAttribute|SetAttribute]]<br /> |-<br /> | 0x000C0082<br /> | SetAttributeInt32<br /> |-<br /> | 0x000D0082<br /> | Connect<br /> |-<br /> | 0x000E0000<br /> | UnregisterSOAP, aka soap account delete<br /> |-<br /> | 0x000F0042<br /> | SetCountrySOAP, change effective country registry<br /> |-<br /> | 0x00100080<br /> | Returns 0xE0C0D3F4, not implemented, reads for an int64 in IPC.<br /> |-<br /> | 0x001100C4<br /> | Returns 0xE0C0D3F4, not implemented, reads for IPC parameters.<br /> |-<br /> | 0x00120084<br /> | SetExternalAccountSOAP<br /> |-<br /> | 0x00130042<br /> | DeleteExternalAccountSOAP<br /> |-<br /> | 0x00140000<br /> | DeleteSavedCardSOAP<br /> |-<br /> | 0x00150082<br /> | ListCashReplenishAmountsSOAP<br /> |-<br /> | 0x0016020A<br /> | [[NIMS:ListTitles|ListTitles]]<br /> |-<br /> | 0x0017020A<br /> | ListContentSetsExSOAP<br /> |-<br /> | 0x0018020A<br /> | ListItemsSOAP<br /> |-<br /> | 0x0019028C<br /> | ListContentSetGroupsSOAP<br /> |-<br /> | 0x001E0104<br /> | GetTaxesSOAP<br /> |-<br /> | 0x001F0106<br /> | GetTaxLocationSOAP<br /> |-<br /> | 0x00220080<br /> | AccountDeleteTitleETicketsSOAP. The SOAP request is sent only after the ticket for the specified titleID has been successfully deleted.<br /> |-<br /> | 0x00290000<br /> | [[NIMS:AccountCheckBalanceSOAP|AccountCheckBalanceSOAP]]<br /> |-<br /> | 0x002D0042<br /> | [[NIMS:DownloadTickets|DownloadTickets]]<br /> |-<br /> | 0x0036xxxx<br /> | Returns 0xE0C0D3F4, not implemented.<br /> |-<br /> | 0x003C0002<br /> | [[NIMS:RegisterSelf|RegisterSelf]]<br /> |-<br /> | 0x003F0000<br /> | GetInitializeResult. Checks whether nim is properly initialized or not. If it is not, the result code returned is non-zero.<br /> |-<br /> | 0x00420240<br /> | [[NIMS:StartDownload|StartDownload]]<br /> |-<br /> | 0x00550246<br /> | [[NIMS:RegisterTask|RegisterTask]]<br /> |-<br /> | 0x00570082<br /> | [[NIMS:ConnectNoTicketDownload|ConnectNoTicketDownload]]<br /> |-<br /> | 0x005B0000<br /> | DeleteInitAccSavedData<br /> |-<br /> | 0x005C0000<br /> | DeleteAccountSavedData<br /> |-<br /> | 0x005F00C0<br /> | DownloadTitleSeed<br /> |}<br /> <br /> {{Anchor|NIMAOC}}{{Anchor|nim:aoc}}<br /> = NIM server service &quot;nim:aoc&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00030042<br /> | SetApplicationId<br /> |-<br /> | 0x00040042<br /> | SetTin<br /> |-<br /> | 0x000902D0<br /> | ListContentSetsEx<br /> |-<br /> | 0x00180000<br /> | GetBalance<br /> |-<br /> | 0x001D0000<br /> | GetCustomerSupportCode<br /> |-<br /> | 0x00210000<br /> | Initialize<br /> |-<br /> | 0x00240282<br /> | CalculateContentsRequiredSize<br /> |-<br /> | 0x00250000<br /> | RefreshServerTime<br /> |}<br /> <br /> {{Anchor|NIMNDM}}{{Anchor|nim:ndm}}<br /> = NIM service &quot;nim:ndm&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010000<br /> | GetDaemonEventHandle<br /> |-<br /> | 0x00020000<br /> | Does nothing, always returns 0<br /> |-<br /> | 0x00030000<br /> | SetDaemonToWorkingState<br /> |-<br /> | 0x00040040<br /> | SetDaemonToSuspendedState<br /> |-<br /> | 0x00050000<br /> | GetDaemonState<br /> |-<br /> |}<br /> <br /> = kagiya server =<br /> The nim system module communicates with a server called kagiya (kagiya-ctr.cdn.nintendo.net or kagiya-dev-ctr.cdn.nintendo.net for development units). It provides the 9.6 crypto seed in binary form for any given title ID under (HTTPS) kagiya-ctr.cdn.nintendo.net/title/0x%16llx/ext_key?country=%s, where %16llx is the title ID and %s is a country code as used in the [[EShop|eShop]].<br /> <br /> =New3DS=<br /> NIM module only uses [[PTMSYSM:CheckNew3DS|CheckNew3DS]] for determining what heap sizes to use, in two functions. One is for the size of the 0x08000000 vmem heap, the other is probably for some buffer allocated on that heap. The New3DS version of these sizes are 0x1C000-bytes larger than the Old3DS sizes here.<br /> <br /> =HTTPS requests=<br /> <br /> ==Trusted RootCAs==<br /> During startup NIM-module creates two RootCertChains with [[HTTP_Services|HTTPC]]. Both of these only contain the same [[HTTPC:RootCertChainAddDefaultCert|default]] cert with ID 0x3. The first RootCertChain is used with NetUpdateSOAP. Requests such as the &quot;notifications.json&quot; page don't use these RootCertChains(in this case just [[HTTPC:AddDefaultCert|default]] certID 0xB is used).<br /> <br /> ==SOAP==<br /> <br /> ===NetUpdateSOAP===<br /> There are exactly 3 types of network SOAP requests used with [https://nus.c.shop.nintendowifi.net/nus/services/NetUpdateSOAP NetUpdateSOAP] by NIM module, described below. This URL contained in NIM module itself is only used with GetSystemTitleHash. The other requests use an identical URL loaded from an ECommerceSOAP response instead.<br /> <br /> See also [https://github.com/yellows8/ninupdates here].<br /> <br /> ====GetSystemUpdate====<br /> Returns the current sysupdate title-listing. This also contains the SystemTitleHash returned by GetSystemTitleHash.<br /> <br /> ====GetSystemTitleHash====<br /> Returns the current SystemTitleHash for the current sysupdate title-listing.<br /> <br /> ====GetSystemCommonETicket====<br /> Returns the Base64-encoded cetk for each specified TitleId entry.<br /> <br /> This is only used when installing new titles. This means with CDN system-updates, tickets are never installed except when a title is being installed for the first time. For example, a system on the latest system-version that was only ever updated via CDN has the same NATIVE_FIRM ticket installed from the factory.<br /> <br /> =Sysupdate checking process=<br /> This section describes the process used when checking whether a sysupdate is required.<br /> <br /> First the GetSystemTitleHash SOAP request is done. Then the SystemTitleHash in savedata hash.dat is compared with the received one. If they match and the SystemTitleHash flag is set to value 0x03, it will immediately return that no sysupdate is required. Otherwise it will start the GetSystemUpdate SOAP request handling.<br /> <br /> The GetSystemUpdate SOAP request contains a titlelist of all NAND system-titles. For GetSystemUpdate response parsing, it compares each SOAP title_entry with the NAND system titlelist. If a SOAP titleID isn't found in the NAND titlelist, this means NAND is missing a new title and hence a sysupdate is required for installing that title. If a NAND title_entry-version is less than the SOAP title_entry-version, this means the title needs updated and hence a sysupdate is required.<br /> <br /> At least one &lt;TitleVersion&gt; entry with valid data in the GetSystemUpdate response is required.<br /> <br /> The titleIDs sent in the GetSystemUpdate SOAP request are decimal, while the titleIDs in the response are hex.<br /> <br /> =NIM [[System_SaveData]]=<br /> ==hash.dat==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Size<br /> ! Description<br /> |-<br /> | 0x60<br /> | 0x1<br /> | u8 flag used with the SystemTitleHash. 0x01 = latest sysupdate isn't installed as of last SOAP requests, 0x03 = latest sysupdate is installed as of last SOAP requests.<br /> |-<br /> | 0x61<br /> | 0x21<br /> | ASCII hex SystemTitleHash, including NUL-terminator. This is the latest SystemTitleHash which NIM module received from SOAP.<br /> |}<br /> <br /> =Types=<br /> <br /> ==SystemUpdateProgress==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x00<br /> | 0x01<br /> | [[#SystemUpdateState|System Update State]]<br /> |-<br /> | 0x01<br /> | 0x03<br /> | Padding<br /> |-<br /> | 0x04<br /> | 0x04<br /> | Last Operation Result Code<br /> |-<br /> | 0x08<br /> | 0x08<br /> | Current Title Downloaded Bytes<br /> |-<br /> | 0x10<br /> | 0x08<br /> | Current Title Total Bytes<br /> |-<br /> | 0x18<br /> | 0x08<br /> | Titles Downloaded<br /> |-<br /> | 0x20<br /> | 0x08<br /> | Titles Total<br /> |}<br /> <br /> ==SystemUpdateState==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | Not Initialized<br /> |-<br /> | 1<br /> | Starting System Update<br /> |-<br /> | 2<br /> | Fetching System Hash and Account Status<br /> |-<br /> | 3<br /> | Installing New Tickets<br /> |-<br /> | 4<br /> | Installing Titles<br /> |-<br /> | 5<br /> | Update Complete<br /> |-<br /> | 6<br /> | Failed - System Updates Disabled (Dev Units Only)<br /> |-<br /> | 7<br /> | ? (Only for background updates)<br /> |-<br /> | 8<br /> | ? (Only for background updates)<br /> |}<br /> <br /> ==TitleDownloadProgress==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x00<br /> | 0x01<br /> | [[#TitleDownloadState|Title Download State]]<br /> |-<br /> | 0x01<br /> | 0x03<br /> | Padding<br /> |-<br /> | 0x04<br /> | 0x04<br /> | Last Operation Result Code<br /> |-<br /> | 0x08<br /> | 0x08<br /> | Downloaded Bytes<br /> |-<br /> | 0x10<br /> | 0x08<br /> | Total Bytes<br /> |}<br /> <br /> ==TitleDownloadState==<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | Not Initialized<br /> |-<br /> | 1<br /> | Starting Title Download<br /> |-<br /> | 2<br /> | Downloading and Installing TMD<br /> |-<br /> | 3<br /> | Committing TMD<br /> |-<br /> | 4<br /> | Downloading and Installing Contents<br /> |-<br /> | 5<br /> | Contents Installed<br /> |-<br /> | 6<br /> | [[AM:CommitImportPrograms|Committing Titles]]<br /> |-<br /> | 7<br /> | Finished<br /> |-<br /> | 8<br /> | ? (Unknown error regarding title version?)<br /> |-<br /> | 9<br /> | ? (Creating the .ctx file (or error doing so)?)<br /> |-<br /> | 10<br /> | Background Download Failed<br /> |}<br /> <br /> ==TitleDownloadConfig==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x00<br /> | 0x08<br /> | Title ID<br /> |-<br /> | 0x08<br /> | 0x04<br /> | Title version<br /> |-<br /> | 0x0C<br /> | 0x04<br /> | Unknown (always 0?)<br /> |-<br /> | 0x10<br /> | 0x01<br /> | Age Rating (for HOME Menu parental controls)<br /> |-<br /> | 0x11<br /> | 0x01<br /> | [[Filesystem_services#MediaType|Media Type]]<br /> |-<br /> | 0x12<br /> | 0x02<br /> | Padding<br /> |-<br /> | 0x14<br /> | 0x04<br /> | Unknown (always 0?)<br /> |}<br /> <br /> ==BackgroundTitleDownloadConfig==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x000<br /> | 0x018<br /> | [[#TitleDownloadConfig|Title Download Config]]<br /> |-<br /> | 0x018<br /> | 0x001<br /> | Unknown<br /> |-<br /> | 0x019<br /> | 0x001<br /> | Unknown<br /> |-<br /> | 0x01A<br /> | 0x006<br /> | Padding<br /> |-<br /> | 0x020<br /> | 0x008<br /> | Requester Title ID<br /> |-<br /> | 0x028<br /> | 0x090<br /> | Title Name (UTF-16)<br /> |-<br /> | 0x0B8<br /> | 0x002<br /> | Title Name Forced NUL Terminator (always 0)<br /> |-<br /> | 0x0BA<br /> | 0x048<br /> | Developer Name (UTF-16)<br /> |-<br /> | 0x102<br /> | 0x002<br /> | Developer Name Forced NUL Terminator (always 0)<br /> |}<br /> <br /> ==BackgroundTitleDownloadTaskInfo==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x000<br /> | 0x104<br /> | [[#BackgroundTitleDownloadConfig|Background Title Download Config]]<br /> |-<br /> | 0x104<br /> | 0x004<br /> | Padding<br /> |-<br /> | 0x108<br /> | 0x018<br /> | [[#TitleDownloadProgress|Title Download Progress]]<br /> |}<br /> <br /> ==AutoTitleDownloadTaskInfo==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x000<br /> | 0x008<br /> | Task ID<br /> |-<br /> | 0x008<br /> | 0x008<br /> | Title ID<br /> |-<br /> | 0x010<br /> | 0x004<br /> | Title Version<br /> |-<br /> | 0x014<br /> | 0x014<br /> | Unknown<br /> |-<br /> | 0x028<br /> | 0x008<br /> | Required Storage Space<br /> |-<br /> | 0x030<br /> | 0x004<br /> | Last Operation Result code<br /> |-<br /> | 0x034<br /> | 0x004<br /> | Last Operation Customer Support Code<br /> |-<br /> | 0x038<br /> | 0x090<br /> | Title Name (UTF-16)<br /> |-<br /> | 0x0C8<br /> | 0x002<br /> | Title Name Forced NUL Terminator (always 0)<br /> |-<br /> | 0x0CA<br /> | 0x048<br /> | Developer Name (UTF-16)<br /> |-<br /> | 0x112<br /> | 0x002<br /> | Developer Name Forced NUL Terminator (always 0)<br /> |-<br /> | 0x114<br /> | 0x024<br /> | Unknown<br /> |}<br /> <br /> ==InstallationMode==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Value<br /> ! Description<br /> |-<br /> | 0<br /> | Initial Installation<br /> |-<br /> | 1<br /> | Unknown<br /> |-<br /> | 2<br /> | Unknown<br /> |-<br /> | 3<br /> | Re-installation<br /> |}<br /> <br /> ==Autodbg==<br /> <br /> Despite this being for debug purposes, it's used in retail if present.<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Offset<br /> ! Length<br /> ! Description<br /> |-<br /> | 0x000<br /> | 0x004<br /> | Debug flags<br /> |-<br /> | 0x004<br /> | 0x004<br /> | Number of debug tasks in dbgtasks.dat<br /> |-<br /> | 0x008<br /> | 0x100<br /> | Debug URL dst.xml override<br /> |}<br /> <br /> ===Autodbg flag bits===<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Bit<br /> ! Description<br /> |-<br /> | 0<br /> | Use the tasks stored in dbgtasks.dat<br /> |-<br /> | 1<br /> | Use provided debug dtl.xml URL override<br /> |-<br /> | 2<br /> | Disable the download of dtl.xml<br /> |-<br /> | 3<br /> | Skip connecting to SOAP EC and download ETickets with a false success result during TSL processing<br /> |-<br /> | 4<br /> | Fake assume always ticket is present during TSL task condition processing<br /> |-<br /> | 5<br /> | Skip NPNS notification fetch for auto title downloads with a false success result<br /> |}<br /> <br /> =Error Results=<br /> <br /> ==NIM Results==<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Result<br /> ! Description<br /> |-<br /> | 0xE0E0D001<br /> | Non-null terminated string on IPC parameter for given length.<br /> |-<br /> | 0xD960D003<br /> | SOAP EC/NUP manager internal error number translation of unhandled values or -4199.<br /> |-<br /> | 0xD960D004<br /> | Unexpected/invalid state enums. (generic)<br /> |-<br /> | 0xC820D005<br /> | Invalid state under one title install manager.<br /> |-<br /> | 0xD8A0D006<br /> | Error state enum value. (generic)<br /> |-<br /> | 0xC920D008<br /> | When content downloading, HTTP Status was not 200 or 206 when connecting, and when status is 206, the Content-Range values failed sanity check.<br /> |-<br /> | 0xC920D009<br /> | Mismatch system title hash with server system title hash.<br /> |-<br /> | 0xC960D00C<br /> | Failed to convert country enum value in CFG save block 0xB0000 to country ISO 3166-1 Alpha-2 code.<br /> |-<br /> | 0xC960D00D<br /> | CFG didn't reply any serial number or dummy serial number &quot;000000000000000&quot; was given.<br /> |-<br /> | 0xC860D00E<br /> | Max total size exceeded for system update pending titles. (128 MiB)<br /> |-<br /> | 0xC880D00F<br /> | *to be filled*<br /> |-<br /> | 0xC8E0D011<br /> | Bad condition, title id for purpose or size under one title install manager.<br /> |-<br /> | 0xC960D012<br /> | Invalid .dat or less than expected size of buffer length read from .dat save files during raw data load.<br /> |-<br /> | 0xC960D013<br /> | Daemon service is suspended.<br /> |-<br /> | 0xC8A0D014<br /> | *to be filled*<br /> |-<br /> | 0xC960D015<br /> | Version mismatch for reinstall condition.<br /> |-<br /> | 0xC960D016<br /> | Used in a few contexts where length does not match expected or the limit. Example, seed data size from HTTP is not 16 bytes.<br /> |-<br /> | 0xC920D017<br /> | SetIVSData will not perform, conditions are not adequate to set IVS. In Service Standby mode or not registered successfully in IAS.<br /> |-<br /> | 0xC920D019<br /> | Certain EC connect flows disallowed to continue while IVS is waiting to be synced from servers. System Transfer has previously occurred and IVS is pending.<br /> |-<br /> | 0xC920D01A<br /> | For nim:s IPC cmd id 0x40, IVS not flagged for synchronization on target console on EC connect after system transfer.<br /> |-<br /> | 0xC960D01B<br /> | Failed to convert language enum value in CFG save block 0xA0002 to language ISO 639-1 code.<br /> |-<br /> | 0xE0E0D01C<br /> | Invalid installation mode for some IPC contexts.<br /> |-<br /> | 0xE0C0D01E<br /> | May be either:<br /> * Trying to set autodbg or dbgtasks with too many tasks on nim:u IPC cmd ids 0x19 and 0x1B, respectively.<br /> * Non debug ENVINFO when calling debug version of get balance nim:s IPC cmd id 0x56.<br /> * A boolean parameter for nim:s IPC cmd id 0x58 was set false.<br /> |-<br /> | 0xD860D020<br /> | May be either:<br /> * Result translation of 0xC860D06E if returned by the early attributes filter handler.<br /> * If the internal Work-only heap fails to initialize with buffer length lesser than 32 bytes. This buffer is given over IPC.<br /> |-<br /> | 0xC860D021<br /> | Task manager has run out of task slots.<br /> |-<br /> | 0xC920D022<br /> | Buffer size too small for ticket length on nim:aoc IPC cmd id 0x1B.<br /> |-<br /> | 0xD880D023<br /> | When Account Id missing for nim:aoc IPC cmd id 0x1B and 0x20 or when Account Id or Token are missing for nim:s IPC cmd id 0x53.<br /> |-<br /> | 0xD860D024<br /> | Failed to initialize Data Heap using buffer given over IPC.<br /> |-<br /> | 0xD920D025<br /> | SOAP reply implied that Service Standby mode is enabled. Certain EC flows cancelled.<br /> |-<br /> | 0xC8A0D026<br /> | May be either:<br /> * Result translation, NIM ran into NPNS result 0xD8A15C06 or NIM result 0xD960D02B.<br /> * System updates pending while trying to SOAP EC connect with ETicket download while processing auto downloads.<br /> |-<br /> | 0xC8A0D027<br /> | This occurs under certain code paths.<br /> &lt;ol&gt;<br /> &lt;li&gt;Result translation of result error from:&lt;/li&gt;<br /> &lt;ul&gt;&lt;li&gt;HTTP module&lt;/li&gt;&lt;/ul&gt;<br /> &lt;ul&gt;&lt;li&gt;SSL module&lt;/li&gt;&lt;/ul&gt;<br /> &lt;ul&gt;&lt;li&gt;NIM module if description is between 100 to 299 (inclusive), 200 descriptions to fit the reserved range of the SOAP manager internal error range of -4000 to -4199 &lt;/li&gt;&lt;/ul&gt;<br /> &lt;li&gt;Unexpected HTTP status, followed up also by generating error integer with 54400 + http status, result value used as a 005-xxxx error&lt;/li&gt;<br /> &lt;/ol&gt;<br /> |-<br /> | 0xD960D028<br /> | Generic XML parsing error. Not related to SOAP XML.<br /> |-<br /> | 0xD960D029<br /> | XML processor stub function called. Not related to SOAP XML.<br /> |-<br /> | 0xD960D02A<br /> | Generic XML data processing error: bad length or insufficient memory. Not related to SOAP XML.<br /> |-<br /> | 0xD960D02B<br /> | Result translation of 0xD960D028.<br /> |-<br /> | 0xD960D02C<br /> | Auto download programmed max task count exceeded trying to add more to list. (64)<br /> |-<br /> | 0xD960D02D<br /> | tsl.xml or tsl.xml.tmp couldn't be opened. FS result translation of description between 100 and 179, inclusive.<br /> |-<br /> | 0xD960D02E<br /> | During tsl.xml task condition check. Still unclear, type of task check<br /> |-<br /> | 0xD960D030<br /> | During tsl.xml task condition check. Ticket missing for title when expected. Will not occur with autodbg flag bit 4 set.<br /> |-<br /> | 0xD960D031<br /> | During tsl.xml task condition check. Title already installed when not overwrite mode.<br /> |-<br /> | 0xD960D032<br /> | During tsl.xml task condition check. Task for title already exists with same or higher version in task.dat.<br /> |-<br /> | 0xD960D033<br /> | During tsl.xml task condition check. Task for title already exists in task.dat.<br /> |-<br /> | 0xD8E0D034<br /> | During tsl.xml task condition check. Unexpected task title type.<br /> |-<br /> | 0xD960D035<br /> | During tsl.xml task condition check. Tsl.xml task will not be processed while max programmed maximum for tasks pending in task.dat is equal or exceeded. (10)<br /> |-<br /> | 0xD960D037<br /> | Failed to load saved dtl.xml with result error of FS with description between 100 and 179, inclusive.<br /> |-<br /> | 0xD960D038<br /> | During tsl.xml task condition check. Not enough space for target SDMC user title.<br /> |-<br /> | 0xD8A0D03A<br /> | No valid NPNS X-Device-Token was available while trying to fetch it from CFG save block 0xF0006.<br /> |-<br /> | 0xD940D03B<br /> | Selected tsl.xml task was cancelled with nim:u IPC cmd id 0x18.<br /> |-<br /> | 0xD960D03C<br /> | Result translation for 0xD960D028 while trying to read XML. Not related to SOAP XML.<br /> |-<br /> | 0xD8A0D03D<br /> | During tsl.xml task condition check. SDMC not inserted or non-writable for SDMC title. (bad media status)<br /> |-<br /> | 0xD960D03E<br /> | During tsl.xml task condition check. Not enough space for target TWL user title.<br /> |-<br /> | 0xD940D03F<br /> | NPNS notification url is not HTTPS.<br /> |-<br /> | 0xD940D040<br /> | NIM ran into NPNS result 0xD8A15C07. Result translation.<br /> |-<br /> | 0xD860D041<br /> | During tsl.xml task condition check. Pending task count of task.dat and installed SDMC user title count exceed programmed max. (300)<br /> |-<br /> | 0xD860D042<br /> | During tsl.xml task condition check. Pending task count of task.dat and installed TWL user title count exceed programmed max. (40)<br /> |-<br /> | 0xD880D043<br /> | HTTP 404 while fetching title crypto seed from kagiya.<br /> |-<br /> | 0xD880D044<br /> | HTTP 503 while fetching title crypto seed from kagiya.<br /> |-<br /> | 0xC960D065<br /> | SOAP EC/NUP manager internal error number translation of value -4001<br /> |-<br /> | 0xE0C0D066<br /> | SOAP EC/NUP manager internal error number translation of value -4002<br /> |-<br /> | 0xE0E0D068<br /> | SOAP EC/NUP manager internal error number translation of value -4004<br /> |-<br /> | 0xC860D069<br /> | SOAP EC/NUP manager internal error number translation of value -4005<br /> |-<br /> | 0xC880D06A<br /> | SOAP EC/NUP manager internal error number translation of value -4006<br /> |-<br /> | 0xC8A0D06B<br /> | SOAP EC/NUP manager internal error number translation of value -4007<br /> |-<br /> | 0xC8A0D06C<br /> | SOAP EC/NUP manager internal error number translation of value -4008<br /> |-<br /> | 0xC860D06E<br /> | SOAP EC/NUP manager internal error number translation of value -4010<br /> |-<br /> | 0xC920D073<br /> | SOAP EC/NUP manager internal error number translation of value -4015<br /> |-<br /> | 0xC900D075<br /> | SOAP EC/NUP manager internal error number translation of value -4017<br /> |-<br /> | 0xC860D076<br /> | SOAP EC/NUP manager internal error number translation of value -4018<br /> |-<br /> | 0xC920D077<br /> | SOAP EC/NUP manager internal error number translation of value -4019<br /> |-<br /> | 0xC900D084<br /> | SOAP EC/NUP manager internal error number translation of value -4032<br /> |-<br /> | 0xC900D085<br /> | SOAP EC/NUP manager internal error number translation of value -4033<br /> |-<br /> | 0xC920D086<br /> | SOAP EC/NUP manager internal error number translation of value -4034<br /> |-<br /> | 0xC920D08A<br /> | SOAP EC/NUP manager internal error number translation of value -4038<br /> |-<br /> | 0xC900D08B<br /> | SOAP EC/NUP manager internal error number translation of value -4039<br /> |-<br /> | 0xC920D08C<br /> | SOAP EC/NUP manager internal error number translation of value -4040<br /> |-<br /> | 0xE0A0D08D<br /> | SOAP EC/NUP manager internal error number translation of value -4041<br /> |-<br /> | 0xC920D08F<br /> | SOAP EC/NUP manager internal error number translation of value -4043<br /> |-<br /> | 0xC920D095<br /> | SOAP EC/NUP manager internal error number translation of value -4049<br /> |-<br /> | 0xE0E0D099<br /> | SOAP EC/NUP manager internal error number translation of value -4053<br /> |-<br /> | 0xC900D09F<br /> | SOAP EC/NUP manager internal error number translation of value -4059<br /> |-<br /> | 0xE100D0A0<br /> | SOAP EC/NUP manager internal error number translation of value -4060<br /> |-<br /> | 0xE100D0A1<br /> | SOAP EC/NUP manager internal error number translation of value -4061<br /> |-<br /> | 0xC920D0A4<br /> | SOAP EC/NUP manager internal error number translation of value -4064<br /> |-<br /> | 0xC920D0A7<br /> | SOAP EC/NUP manager internal error number translation of value -4067<br /> |-<br /> | 0xC920D0A8<br /> | SOAP EC/NUP manager internal error number translation of value -4068<br /> |-<br /> | 0xE0A0D0A9<br /> | SOAP EC/NUP manager internal error number translation of value -4069<br /> |-<br /> | 0xC920D0AD<br /> | SOAP EC/NUP manager internal error number translation of value -4073<br /> |-<br /> | 0xC920D0B1<br /> | SOAP EC/NUP manager internal error number translation of value -4077<br /> |-<br /> | 0xC920D0B3<br /> | SOAP EC/NUP manager internal error number translation of value -4079<br /> |-<br /> | 0xC920D0B5<br /> | SOAP EC/NUP manager internal error number translation of value -4081<br /> |}<br /> <br /> ==NPNS Results==<br /> <br /> NPNS has a module number for results, but no module exists, but can be at least in part found inside NIM.<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Result<br /> ! Description<br /> |-<br /> | 0xC9215C00<br /> | Result translation, HTTP result 0xD8A0A018.<br /> |-<br /> | 0xD8615C01<br /> | Allocation error, insufficient memory.<br /> |-<br /> | 0xD8A15C02<br /> | HTTP non 2xx, json message processing, default error code switch result error.<br /> |-<br /> | 0xD8A15C03<br /> | JSON processing errors.<br /> |-<br /> | 0xD8A15C04<br /> | Notifications array bigger than expected.<br /> |-<br /> | 0xD8A15C05<br /> | HTTP Empty body response.<br /> |-<br /> | 0xD8A15C06<br /> | HTTP non 2xx, json message processing, error code 1003 given in json body.<br /> |-<br /> | 0xD8A15C07<br /> | HTTP non 2xx, json message processing, error code 1000 given in json body.<br /> |-<br /> | 0xD8A15C08<br /> | HTTP non 2xx, json message processing, error code 1004 given in json body.<br /> |}<br /> <br /> ==Other Results==<br /> <br /> Any other result that is not given by other modules as a response, but found internally in NIM.<br /> <br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Result<br /> ! Module value<br /> ! Description<br /> |-<br /> | 0xD8600801<br /> | Util (2)<br /> | Encoding errors. In NIM, if error while encoding base64 for X-Authentication-Key or X-Authentication-Data HTTP parameters.<br /> |}<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=PXI_Services&diff=22723 PXI Services 2024-09-18T09:27:17Z <p>ElementW: Add to Category:Services</p> <hr /> <div>= PXI Services =<br /> The 'pxi' sysmodule contains the following services:<br /> *[[Filesystem services PXI|PxiFS0]]<br /> *[[Filesystem services PXI|PxiFS1]]<br /> *[[Filesystem services PXI|PxiFSB]]<br /> *[[Filesystem services PXI|PxiFSR]]<br /> *[[Process Manager Services PXI|PxiPM]]<br /> *[[Application Manager Services PXI|pxi:am9]]<br /> *[[Gamecard Services PXI|pxi:dev]]<br /> *[[Development Services PXI|pxi:mc]]<br /> *[[Process Services PXI|pxi:ps9]]<br /> <br /> Each of these services has up to 4 static IPC buffers of size 0x1000. When any of these service ports are sync:d, the IPC cmdbuf (TLS+0x80+) is sent over [[PXI_Registers|PXI]] to the ARM9.<br /> <br /> Each PXI service can only have one session open for it at a time.<br /> <br /> = Protocol =<br /> The communication protocol for normal PXI commands is documented below. The size of cmd_buf is calculated from the cmd_hdr. With newer FIRM the total size for command header + buffer must be at most 0x40 words, otherwise Process9 will panic.<br /> <br /> The PXI protocol is bidirectional - both processors can host a PXI service for a given pxi_id. In practice, Process9 hosts all but one of the services (pxi_11 is hosted by pxi-module instead). Each pxi_id corresponds to a PXI command-handler(called from threads) which handles the actual command processing. With newer FIRM the pxi_id must be in a certain range.<br /> <br /> There's a dedicated Process9 thread for receiving data from PXI(in newer FIRM this is the main-thread), once it finishes receiving a request it copies the cmd_buf into a buffer for the corresponding pxi_id then signals an event so that the cmd-handler thread can process it. Once a cmd-handler thread finishes processing a command, the thread itself then sends the response over PXI. This means that multiple commands for different pxiIDs can be be handled at the same time, even when one cmd-handler completely hangs/etc for example.<br /> <br /> Process9 will execute [[SVC|svcBreak]] when it receives a PXI command with a pxi_id where another command with that same pxi_id is still being processed by the command-handler(this won't happen with commands sent by the ARM11 PXI-module, since it waits for the command reply before sending another command request for that same pxi_id).<br /> <br /> =PXI service &quot;pxi_11&quot;=<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010040<br /> | PublishToSubscriber - this exposes [[Services|&quot;srv:&quot; notifications]] to the Process9-side using [[SRV:PublishToSubscriber]] (with flags=1), to allow sending card-insert notifications etc. directly to ARM11.<br /> |}<br /> <br /> ==Request==<br /> A11-&gt;A9 (u32) pxi_id<br /> A11-&gt;A9 (u32) cmd_hdr<br /> A11-&gt;A9 (u32[]) cmd_buf<br /> <br /> ==Response==<br /> A9-&gt;A11 (u32) pxi_id<br /> A9-&gt;A11 (u32) cmd_hdr<br /> A9-&gt;A11 (u32[]) cmd_buf<br /> <br /> ==pxi_id==<br /> 0 = pxi_mc<br /> 1 = pxi_fs<br /> 2 = pxi_fs<br /> 3 = pxi_fs<br /> 4 = pxi_fs<br /> 5 = pxi_pm<br /> 6 = pxi_dev<br /> 7 = pxi_am<br /> 8 = pxi_ps<br /> 9 = pxi_11<br /> <br /> [[Category:Services]]</div> ElementW https://www.3dbrew.org/w/index.php?title=Process_Manager_Services&diff=22722 Process Manager Services 2024-09-18T09:26:43Z <p>ElementW: Add anchors, add to Category:Services</p> <hr /> <div>{{Anchor|PMApp}}{{Anchor|PMAPP}}{{Anchor|pm:app}}<br /> = Process Manager app service &quot;pm:app&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010140<br /> | [[PMApp:LaunchTitle|LaunchTitle]]<br /> |-<br /> | 0x00020082<br /> | [[PMApp:LaunchFIRM|LaunchFIRM]]<br /> |-<br /> | 0x00030080<br /> | [[PMApp:TerminateApplication|TerminateApplication]]<br /> |-<br /> | 0x00040100<br /> | [[PMApp:TerminateTitle|TerminateTitle]]<br /> |-<br /> | 0x000500C0<br /> | [[PMApp:TerminateProcess|TerminateProcess]]<br /> |-<br /> | 0x00060082<br /> | [[PMApp:PrepareForReboot|PrepareForReboot]]<br /> |-<br /> | 0x00070042<br /> | [[PMApp:GetFIRMLaunchParams|GetFIRMLaunchParams]]<br /> |-<br /> | 0x00080100<br /> | [[PMApp:GetTitleExheaderFlags|GetTitleExheaderFlags]]<br /> |-<br /> | 0x00090042<br /> | [[PMApp:SetFIRMLaunchParams|SetFIRMLaunchParams]]<br /> |-<br /> | 0x000A0140<br /> | [[PMApp:SetAppResourceLimit|SetAppResourceLimit]]<br /> |-<br /> | 0x000B0140<br /> | [[PMApp:GetAppResourceLimit|GetAppResourceLimit]]<br /> |-<br /> | 0x000C0080<br /> | [[PMApp:UnregisterProcess|UnregisterProcess]]<br /> |-<br /> | 0x000D0240<br /> | [[PMApp:LaunchTitleUpdate|LaunchTitleUpdate]]<br /> |}<br /> <br /> {{Anchor|PMDbg}}{{Anchor|PMDBG}}{{Anchor|pm:dbg}}<br /> = Process Manager debug service &quot;pm:dbg&quot; =<br /> {| class=&quot;wikitable&quot; border=&quot;1&quot;<br /> |-<br /> ! Command Header<br /> ! Description<br /> |-<br /> | 0x00010140<br /> | [[PMDbg:LaunchAppDebug|LaunchAppDebug]]<br /> |-<br /> | 0x00020140<br /> | [[PMDbg:LaunchApp|LaunchApp]]<br /> |-<br /> | 0x00030000<br /> | [[PMDbg:RunQueuedProcess|RunQueuedProcess]]<br /> |}<br /> <br /> A maximum of three sessions can be open with both of these services combined, therefore only three processes can use either of these services at once.<br /> <br /> [[Category:Services]]</div> ElementW