Nintendo Switch Brew

Changes

Network Interface services (view source)

Revision as of 19:23, 22 March 2022

3,434 bytes added ,  19:23, 22 March 2022
→‎IRequest
Line 30: Line 30:  
| 1 || [[#GetClientId]] ||
 
| 1 || [[#GetClientId]] ||
 
|-
 
|-
−
| 2 || CreateScanRequest || Returns an [[#IScanRequest]].
+
| 2 || [[#CreateScanRequest]] ||
 
|-
 
|-
−
| 4 || CreateRequest || Returns an [[#IRequest]].
+
| 4 || [[#CreateRequest]] ||
 
|-
 
|-
 
| 5 || [[#GetCurrentNetworkProfile]] ||
 
| 5 || [[#GetCurrentNetworkProfile]] ||
Line 40: Line 40:  
| 7 || EnumerateNetworkProfiles ||
 
| 7 || EnumerateNetworkProfiles ||
 
|-
 
|-
−
| 8 || GetNetworkProfile ||
+
| 8 || [[#GetNetworkProfile]] ||
 
|-
 
|-
−
| 9 || SetNetworkProfile ||
+
| 9 || [[#SetNetworkProfile]] ||
 
|-
 
|-
 
| 10 || RemoveNetworkProfile ||
 
| 10 || RemoveNetworkProfile ||
Line 48: Line 48:  
| 11 || GetScanDataOld ([1.0.0-3.0.2] GetScanData) ||
 
| 11 || GetScanDataOld ([1.0.0-3.0.2] GetScanData) ||
 
|-
 
|-
−
| 12 || GetCurrentIpAddress ||
+
| 12 || [[#GetCurrentIpAddress]] ||
 
|-
 
|-
 
| 13 || GetCurrentAccessPointOld ([1.0.0-3.0.2] GetCurrentAccessPoint) ||
 
| 13 || GetCurrentAccessPointOld ([1.0.0-3.0.2] GetCurrentAccessPoint) ||
Line 54: Line 54:  
| 14 || CreateTemporaryNetworkProfile || Returns an [[#INetworkProfile]].
 
| 14 || CreateTemporaryNetworkProfile || Returns an [[#INetworkProfile]].
 
|-
 
|-
−
| 15 || GetCurrentIpConfigInfo ||
+
| 15 || [[#GetCurrentIpConfigInfo]] ||
 
|-
 
|-
 
| 16 || SetWirelessCommunicationEnabled ||
 
| 16 || SetWirelessCommunicationEnabled ||
Line 117: Line 117:     
The wrapper for this with official sw will return 0 when any errors occur (wrapper returns [[#ClientId]] not Result).
 
The wrapper for this with official sw will return 0 when any errors occur (wrapper returns [[#ClientId]] not Result).
 +
 +
=== CreateScanRequest ===
 +
No input, returns an output [[#IScanRequest]].
 +
 +
=== CreateRequest ===
 +
Takes an input s32 "nn::nifm::RequirementPreset", returns an output [[#IRequest]].
 +
 +
sdknso loads the s32 from "nn::nifm::RequestParameters", which has hard-coded value 0x2.
    
=== GetCurrentNetworkProfile ===
 
=== GetCurrentNetworkProfile ===
Line 122: Line 130:     
sdknso converts the output to [[#NetworkProfileData]].
 
sdknso converts the output to [[#NetworkProfileData]].
 +
 +
=== GetNetworkProfile ===
 +
Takes an input "nn::util::Uuid" (same Uuid from [[#SfNetworkProfileData]]) and a type-0x1A output buffer containing a [[#SfNetworkProfileData]].
 +
 +
sdknso converts the output to [[#NetworkProfileData]].
 +
 +
=== SetNetworkProfile ===
 +
Takes a type-0x19 input buffer containing a [[#SfNetworkProfileData]] and returns an output "nn::util::Uuid".
 +
 +
sdknso converts the input to [[#SfNetworkProfileData]], which is then passed to the cmd.
 +
 +
This is only available with nifm:a.
 +
 +
=== GetCurrentIpAddress ===
 +
No input, returns an output [[#IpV4Address]].
 +
 +
=== GetCurrentIpConfigInfo ===
 +
No input, returns an output [[#IpAddressSetting]] and a [[#DnsSetting]].
    
=== IsAnyInternetRequestAccepted ===
 
=== IsAnyInternetRequestAccepted ===
Line 147: Line 173:     
=== IRequest ===
 
=== IRequest ===
−
This is "nn::nifm::detail::IRequest". This represents an application or sysmodule's request to bring a network up.
+
This is "nn::nifm::detail::IRequest".
 +
 
 +
This represents an application or sysmodule's request to bring a network up.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 193: Line 221:  
| 20 || GetRevision
 
| 20 || GetRevision
 
|-
 
|-
−
| 21 || GetAppletInfo
+
| 21 || [[#GetAppletInfo]]
 
|-
 
|-
 
| 22 || GetAdditionalInfo
 
| 22 || GetAdditionalInfo
Line 208: Line 236:  
|-
 
|-
 
! Number || Description
 
! Number || Description
 +
|-
 +
| 0 || Set by sdknso when the cmd returns an error.
 
|-  
 
|-  
 
| 1 || Not yet submitted or error
 
| 1 || Not yet submitted or error
 
|-
 
|-
−
| 2 || Pending (sdk calls this OnHold)
+
| 2 || Pending (sdknso calls this OnHold)
 
|-
 
|-
−
| 3 || Connected
+
| 3 || Connected (sdknso calls this Available)
 +
|-
 +
| 5 ||
 
|}
 
|}
    
==== GetResult ====
 
==== GetResult ====
 +
No input/output.
 +
 
If the request enters state 1, this command can be used to determine why. It responds with the nice networking error codes that there are support pages for.
 
If the request enters state 1, this command can be used to determine why. It responds with the nice networking error codes that there are support pages for.
    
==== GetSystemEventReadableHandles ====
 
==== GetSystemEventReadableHandles ====
−
Returns two event handles. The first one signals when the RequestState changes.
+
No input, returns two Event handles. The first one signals when the RequestState changes.
 +
 
 +
This is used immediately after [[#CreateRequest]].
 +
 
 +
sdknso uses EventClearMode=1 for the first Event, for the second Event this can be user-specified or a default value of 1.
    
==== Cancel ====
 
==== Cancel ====
 +
No input/output.
 +
 
Cancels the request to bring the network up.
 
Cancels the request to bring the network up.
    
==== Submit ====
 
==== Submit ====
 +
No input/output.
 +
 
Submits the request to bring the network up. Call this after configuring the request.
 
Submits the request to bring the network up. Call this after configuring the request.
   Line 261: Line 303:     
[3.0.0+] Returns an additional 4-bytes of output.
 
[3.0.0+] Returns an additional 4-bytes of output.
 +
 +
==== GetAppletInfo ====
 +
Takes an input u32, a type-0x6 output buffer, and 3 output u32s.
 +
 +
sdknso uses the output from this to launch a LibraryApplet.
 +
 +
The input u32 is set to the output from <code>nn::applet::GetExpectedThemeColorForSystem()</code>.
 +
 +
The output u32s are: [[Applet_Manager_services#AppletId|AppletId]], [[Applet_Manager_services#LibraryAppletMode|LibraryAppletMode]], out_size.
 +
 +
sdknso uses size 0x1000 for the buffer.
 +
 +
The out_size is the total data size written to the output buffer. The buffer contains an array of: {s32 size} {data with the specified size}, with size==-1 indicating that the end of the array was reached. The data from here is pushed as applet input storage.
 +
 +
The returned AppletId is one of the following: error, wifiWebAuth, or netConnect.
    
=== INetworkProfile ===
 
=== INetworkProfile ===
Line 290: Line 347:  
| 0x0 || 0xC2 || [[#IpSettingData]]
 
| 0x0 || 0xC2 || [[#IpSettingData]]
 
|-
 
|-
−
| 0xC2 || 0x10 ||  
+
| 0xC2 || 0x10 || "nn::util::Uuid"
 
|-
 
|-
−
| 0xD2 || 0x40 || NUL-terminated string
+
| 0xD2 || 0x40 || NUL-terminated Network Name string
 
|-
 
|-
 
| 0x112 || 0x1 ||  
 
| 0x112 || 0x1 ||  
Line 302: Line 359:  
| 0x115 || 0x1 ||  
 
| 0x115 || 0x1 ||  
 
|-
 
|-
−
| 0x116 || 0x66 || [[#SfWirelessSettingData]]
+
| 0x116 || 0x65 || [[#SfWirelessSettingData]]
 +
|-
 +
| 0x17B || 0x1 || Padding
 
|}
 
|}
   Line 314: Line 373:  
! Description
 
! Description
 
|-
 
|-
−
| 0x0 || 0x10 ||  
+
| 0x0 || 0x10 || "nn::util::Uuid"
 
|-
 
|-
−
| 0x10 || 0x40 || NUL-terminated string
+
| 0x10 || 0x40 || NUL-terminated Network Name string
 
|-
 
|-
 
| 0x50 || 0x4 ||  
 
| 0x50 || 0x4 ||  
Line 334: Line 393:     
= SfWirelessSettingData =
 
= SfWirelessSettingData =
−
This is a 0x66-byte struct. This is converted to/from [[#WirelessSettingData]] during the [[#NetworkProfileData]] conversion.
+
This is a 0x65-byte struct. This is converted to/from [[#WirelessSettingData]] during the [[#NetworkProfileData]] conversion.
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Line 344: Line 403:  
| 0x0 || 0x1 || SSID length (Clamped to max len 0x20 during [[#NetworkProfileData]] conversion)
 
| 0x0 || 0x1 || SSID length (Clamped to max len 0x20 during [[#NetworkProfileData]] conversion)
 
|-
 
|-
−
| 0x1 || 0x21 || NUL-terminated SSID string
+
| 0x1 || 0x20 || SSID string
 +
|-
 +
| 0x21 || 0x1 ||
 
|-
 
|-
 
| 0x22 || 0x1 ||  
 
| 0x22 || 0x1 ||  
Line 350: Line 411:  
| 0x23 || 0x1 ||  
 
| 0x23 || 0x1 ||  
 
|-
 
|-
−
| 0x24 || 0x1 || Passphrase length?
+
| 0x24 || 0x41 || Passphrase
−
|-
  −
| 0x25 || 0x41 || Passphrase
   
|}
 
|}
   Line 374: Line 433:  
| 0x24 || 0x4 ||  
 
| 0x24 || 0x4 ||  
 
|-
 
|-
−
| 0x28 || 0x4 || Passphrase length?
+
| 0x28 || 0x4 ||  
 
|-
 
|-
 
| 0x2C || 0x41 || Passphrase
 
| 0x2C || 0x41 || Passphrase
Line 390: Line 449:  
! Description
 
! Description
 
|-
 
|-
−
| 0x0 || 0xE ||  
+
| 0x0 || 0xD || [[#IpAddressSetting]]
−
|-
  −
| 0xE || 0x4 || Primary DNS server IPv4 address
   
|-
 
|-
−
| 0x12 || 0x4 || Secondary DNS server IPv4 address
+
| 0xD || 0x9 || [[#DnsSetting]]
 
|-
 
|-
 
| 0x16 || 0xAA || [[#ProxySetting]]
 
| 0x16 || 0xAA || [[#ProxySetting]]
Line 410: Line 467:  
! Description
 
! Description
 
|-
 
|-
−
| 0x0 || 0x1 ||  
+
| 0x0 || 0x1 || Enables using the proxy when set.
 
|-
 
|-
 
| 0x1 || 0x1 || Padding
 
| 0x1 || 0x1 || Padding
Line 416: Line 473:  
| 0x2 || 0x2 || Port
 
| 0x2 || 0x2 || Port
 
|-
 
|-
−
| 0x4 || ? || Server string
+
| 0x4 || 0x64 || Server string, NUL-terminated.
 +
|-
 +
| 0x68 || 0x1 || Enables auto-authentication when set, which uses the following two strings.
 +
|-
 +
| 0x69 || 0x20 || User string, NUL-terminated.
 +
|-
 +
| 0x89 || 0x20 || Password string, NUL-terminated.
 +
|-
 +
| 0xA9 || 0x1 || Padding
 +
|}
 +
 
 +
= IpV4Address =
 +
This is "nn::nifm::IpV4Address". This is a 0x4-byte struct.
 +
 
 +
sdknso copies this into <code>struct in_addr</code>.
 +
 
 +
= IpAddressSetting =
 +
This is "nn::nifm::IpAddressSetting". This is a 0xD-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset
 +
! Size
 +
! Description
 +
|-
 +
| 0x0 || 0x1 || Whether this setting is automatic. Ignored by [[#GetCurrentIpConfigInfo]].
 +
|-
 +
| 0x1 || 0x4 || Copied to an output <code>struct in_addr</code> by sdknso. Same as the output from [[#GetCurrentIpAddress]].
 +
|-
 +
| 0x5 || 0x4 || Copied to an output <code>struct in_addr</code> by sdknso. Subnet Mask.
 +
|-
 +
| 0x9 || 0x4 || Copied to an output <code>struct in_addr</code> by sdknso. Gateway.
 +
|}
 +
 
 +
= DnsSetting =
 +
This is "nn::nifm::DnsSetting". This is a 0x9-byte struct.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset
 +
! Size
 +
! Description
 +
|-
 +
| 0x0 || 0x1 || Whether this setting is automatic. Ignored by [[#GetCurrentIpConfigInfo]].
 +
|-
 +
| 0x1 || 0x4 || Copied to an output <code>struct in_addr</code> by sdknso. Primary DNS server.
 +
|-
 +
| 0x5 || 0x4 || Copied to an output <code>struct in_addr</code> by sdknso. Secondary DNS server.
 
|}
 
|}
    
[[Category:Services]]
 
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/9052...11602"