WLAN services

wlan:inf

This is "nn::wlan::detail::IInfraManager".

This service no longer exists in [15.0.0+].

Cmd	Name
0	OpenMode
1	CloseMode
2	GetMacAddress
3	StartScan
4	StopScan
5	Connect
6	CancelConnect
7	Disconnect
8	GetConnectionEvent
9	GetConnectionStatus
10	GetState
11	GetScanResult
12	GetRssi
13	ChangeRxAntenna
14	GetFwVersion
15	RequestSleep
16	RequestWakeUp
17	ConnectWithWps
18	[3.0.0+] GetWakeupReason
19	[3.0.0+] SetTcpSessionInformation
20	[3.0.0+] RemoveTcpSessionInformation
21	[3.0.0+] GetWakeupReasonRaw
22	[3.0.0+] SetWakeupReasonRaw
23	[3.0.0+] EnableWowlFeatures
24	[3.0.0+] GetWowlStats
25	[3.0.0+] ClearWowlStats
26	[4.0.0+] EmulateDriverInitFail
27	[4.0.0+] GetAllowedChannels
28	[5.0.0+] InitializeWlan
29	[7.0.0+] FinalizeWlan
30	[8.0.0+] SetWowlDelayedWakeTime
31	[11.0.0+] StartConcurrentCommunication
32	[11.0.0+] StopConcurrentCommunication
33	[11.0.0+] SendConcurrentData
34	[11.0.0+] RecvConcurrentData
35	[11.0.0+] CancelRecvConcurrentData
36	[11.0.0+] SetConcurrentCycle
37	[11.0.0+] SetConcurrentDataRate
38	[13.0.0+] SetPowerSaveMode

OpenMode

No input/output.

Sends command message 0x99 to the state machine.

This is used by nifm.

CloseMode

No input/output.

Sends command message 0x9A to the state machine.

This is used by nifm.

GetMacAddress

No input. Returns an output #MacAddress.

Sends command message 0x18 (GetMacAddress) to the state machine.

This is used by nifm.

StartScan

Takes a type-0x15 input buffer buffer containing a #ScanRequest. No output.

[15.0.0+] Now takes a type-0x19 input buffer instead of a type-0x15 input buffer.

Sends command messages 0xA (SetWlanInterfaceUpDown) and 0x14 (ScanRequest) to the state machine.

This is used by nifm.

StopScan

No input/output.

Sends command message 0x16 (CancelScan) to the state machine.

This is used by nifm.

Connect

Takes an input #ConnectParam. No output.

[4.0.0+] Now takes an additional 4-bytes of input.

Sends command messages 0xA (SetWlanInterfaceUpDown), 0x11 (SetBeaconLostTimeout) and 0x20 (JoinNetworkSta) to the state machine.

This is used by nifm.

CancelConnect

No input/output.

Sends command message 0x23 (CancelJoinNetwork) to the state machine.

This is used by nifm.

Disconnect

No input/output.

Sends command message 0x24 (DisconnectRequest) to the state machine.

This is used by nifm.

GetConnectionEvent

Takes an input u32 SystemEventType. Returns an output Event handle.

This is used by nifm.

GetConnectionStatus

No input. Returns an output #ConnectionStatus.

Sends command message 0x80 (GetState) to the state machine, to check current state. Then this copies data from state to output (unrelated to message 0x80).

This is used by nifm.

GetState

No input. Returns an output #State.

Sends command message 0x80 (GetState) to the state machine.

This is used by nifm.

GetScanResult

Takes a type-0x6 output buffer containing a #ScanResult. No output.

Sends command message 0x15 (BssInfoListGet) to the state machine.

This is used by nifm.

GetRssi

No input. Returns an output u32 Rssi.

Sends command message 0x2E (GetRssi) to the state machine.

This is used by nifm.

ChangeRxAntenna

Takes an input u32. No output.

Sends command message 0x30 (SetRxChain) to the state machine.

The input value must be 1-3.

The message handler calls two vfuncs. The first vfunc uses the input u32 directly to configure "rxchain". The second vfunc configures "btc_params" with data determined using the input value.

This is not used on retail.

GetFwVersion

Takes a type-0xA output buffer containing a #FwVersion. No output.

Sends command message 0x33 (GetFwVersion) to the state machine. The handler validates state, then gets the value for config "ver".

This is not used on retail.

RequestSleep

No input/output.

[15.0.0+] This had various changes.

Sends command messages 0x24 (DisconnectRequest), 0x34 (RequestSleep), 0x3D and 0x3E to the state machine.

First message GetState is sent, if state is 0x3 it does the following:

• Sends message 0x3D. If successful and the output u8 is 0, this then does the following:
  • Uses GetState to check for state 0x2/0x3. On success message DisconnectRequest is sent. If state is invalid or the command message failed, this will Abort.
  • Uses GetState to check for state 0x1/0x2/0xA. On success message 0x9A with param=0 is sent. If state is invalid or the command message failed, this will Abort.

Then message RequestSleep is sent. If the Result is not 0x146B (including success), it returns the Result. Otherwise when the Result is that value, it does the following:

• Sends message 0x3E.
  • Uses GetState to check for state 0x2/0x3. On success message DisconnectRequest is sent. If state is invalid or the command message failed, this will Abort.
  • Uses GetState to check for state 0x1/0x2/0xA. On success message 0x9A with param=0 is sent. If state is invalid or the command message failed, this will Abort.
  • Then this cmpl impl func will return the Result from calling itself.

This is used by nifm.

RequestWakeUp

No input/output.

[15.0.0+] This had various changes.

Sends command messages 0x1 (InitalizeWlanDriver), 0x24 (DisconnectRequest), 0x35 (RequestWakeUp), 0x3E, 0x80 (GetState) and 0x81 (GetStateBeforeSleep) to the state machine.

First message GetState is sent, returning 0 if state is 0xC, or throwing error if it isn't 0xA. Then message RequestWakeUp is sent, if successful then message 0x3E is sent and 0 is returned.

If RequestWakeUp fails it will immediately return the Result, unless the Result is one of the following:

• 0xE86B (normal non-wowl codepath was previously used during RequestSleep): Sends message InitalizeWlanDriver, returning a Result on failure. Then message GetStateBeforeSleep is sent. If the output state is 0x1, it returns 0. If not 0x2 or the second output field is non-zero, it will Abort. Uses GetState to verify the state is valid, returning the Result from that on failure. Otherwise this will return the Result from sending command request 0x99 with param=0.
• 0xE66B: Sends message 0x3E. Uses GetState to verify the state is valid, when valid then message DisconnectRequest is sent. If state-validation/DisconnectRequest failed this will Abort, otherwise this then returns 0.

This is used by nifm.

ConnectWithWps

Takes a type-0x9 input buffer containing a #WpsPin and two input u32s WpsMethod and BeaconLostTimeout. No output.

Sends command messages 0xA (SetWlanInterfaceUpDown), 0x11 (SetBeaconLostTimeout) and 0x21 (JoinNetworkStaWithWps) to the state machine.

This is not used on retail.

GetWakeupReason

No input. Returns an output u32.

Sends command message 0x80 (GetState) to the state machine, to check current state. Sends command message 0x36 to the state machine to get a value from state, which is then passed to a vfunc call. That func checks bits in the input to determine what value to return, which is then written to the output u32.

This is not used on retail.

SetTcpSessionInformation

Takes an input #MacAddress, three input u16s SrcPort, DstPort and Unk0, and three input u32s SrcIp, DstIp and Unk1. No output.

This copies the input data into state, and sets a flag in state. The input is written into state with the following structure: #MacAddress, SrcIp, DstIp, SrcPort, DstPort, Unk1, Unk0.

This data is used during RequestSleep if a state field is set for using it (the codepath using this will throw an error if this data was not set). This data is cleared afterwards unless sleep was successfully entered with wowl. This is also cleared during RequestWakeUp. This is used for configuring various config related to wowl/tcpka/etc (wake-on-WLAN/TCP keep-alive). Note that an error is thrown if "wowl_activate" isn't set but sysmodule-side doesn't do so - this seems to be set automatically at some point.

This is used by nifm.

RemoveTcpSessionInformation

No input/output.

This clears the state set by #SetTcpSessionInformation.

This is not used on retail.

GetWakeupReasonRaw

No input. Returns an output u32.

Same as #GetWakeupReason except the value from the request is returned directly, without calling the vfunc.

This is not used on retail.

SetWakeupReasonRaw

Takes an input u32. No output.

Same as #GetWakeupReasonRaw except this uses message 0x37 with the input u32. This is handled by writing the u32 into a global field (default value is 0xBC), which is used during configuration for "wowl".

This is not used on retail.

EnableWowlFeatures

Takes an input u32. No output.

Sends command message 0x38 to the state machine. This is handled by writing the input value into a global flags field. The default value is 0x3 (all flag bits set). These flag bits are checked during the RequestSleep code handling the state for #SetTcpSessionInformation.

This is not used on retail.

GetWowlStats

No input. Returns a #WakeUpStats and a #SleepStats.

[5.0.0+] Now returns a total of 0x58-bytes of output instead of 0x5C.

Sends command message 0x39 to the state machine, with 0x20-bytes from the output being copied to the first output struct. Sends command message 0x3A to the state machine, with 0x38-bytes from the output being copied to the second output struct.

These requests get data from state.

This is not used on retail.

ClearWowlStats

Takes two input bools. No output.

When the first bool flag is set, sends command message 0x3B to the state machine. When the second bool flag is set, sends command message 0x3C to the state machine. Then 0 is returned.

Both requests are handled by clearing various data in state. The first request clears the first state struct returned by #GetWowlStats, likewise with the second request and the second state struct from #GetWowlStats.

This is not used on retail.

EmulateDriverInitFail

No input/output.

This sends a request which sets a global flag.

This flag is eventually checked by code which runs via RequestSleep, and in one case with wlan:dtc cmd19 (also used by requests done by nnMain/RequestWakeUp).

This is not used on retail.

GetAllowedChannels

Takes a type-0xA output buffer containing an array of 2-byte entries. Returns an output u32 total_out.

This memcpys data from state into the output buffer, clamped to a maximum of 0x40 entries (nifm hard-codes the count to 0x26).

This is used by nifm.

InitializeWlan

No input/output.

Sends command message 0x1 (InitalizeWlanDriver) to the state machine.

This is not used on retail.

FinalizeWlan

No input/output.

Sends command message 0x2 (FinalizeWlanDriver) to the state machine.

This is not used on retail.

SetWowlDelayedWakeTime

Takes an input s32 WowlDelayedWakeTime. No output.

WowlDelayedWakeTime must be <=0xE10 (3600) and >= -1. This value is written into state (last field in the state struct also used by #SetTcpSessionInformation, which #SetTcpSessionInformation doesn't write), then this returns 0.

The user-process code using this cmd also has the above bounds check.

This is used by wlan during RequestSleep from the same code using the state set by #SetTcpSessionInformation.

This cmd is used by nifm with a value from state, prior to using RequestSleep.

If wificore gets to the point of actually using this for TCP-keep-alive, then it does the following:

• This is only used when the TCP connection is RST.
  • WowlDelayedWakeTime is the time in seconds to schedule a timer which will wake the system. 0 will schedule it for immediately.
  • -1 will skip scheduling that timer, hence waking the system is disabled when RST is received.
  • The wificore also supports -3 for immediately waking the system from the frame-handler, however wlan-sysmodule doesn't allow that.
• Frames where the TCP flags do not match ACK will immediately wake the system, + other wake cause(s).

StartConcurrentCommunication

No input/output.

Stubbed, just returns an error.

This is not used on retail.

StopConcurrentCommunication

No input/output.

Stubbed, just returns an error.

This is not used on retail.

SendConcurrentData

Takes an input #MacAddress and a type-0x5 input buffer. No output.

Stubbed, just returns an error.

This is not used on retail.

RecvConcurrentData

Takes a type-0x6 output buffer. Returns a total of 0x10-bytes.

Stubbed, just returns an error.

This is not used on retail.

CancelRecvConcurrentData

No input/output.

Stubbed, just returns an error.

This is not used on retail.

SetConcurrentCycle

Takes two input u64s. No output.

Stubbed, just returns an error.

This is not used on retail.

SetConcurrentDataRate

Takes an input u32. No output.

Stubbed, just returns an error.

This is not used on retail.

SetPowerSaveMode

Takes an input u32 Mode. No output.

[15.0.0+] Now takes an input u8 instead of an input u32.

Mode must be 0 or 1.

Sends command message 0x32 to the state machine.

The state machine then handles this by issuing the WLC_SET_VAR ioctl for the "pm2_sleep_ret_ext" variable. Mode is used to select between 2 sets of hardcoded parameters as follows:

 struct wl_pm2_sleep_ret_ext {
   u8 logic;
   u8 PAD;
   u16 low_ms;
   u16 high_ms;
   u16 rx_pkts_threshold;
   u16 tx_pkts_threshold;
   u16 txrx_pkts_threshold;
   u32 rx_bytes_threshold;
   u32 tx_bytes_threshold;
   u32 txrx_bytes_threshold;
 };
 
 wl_pm2_sleep_ret_ext args = {0};
 
 if (mode == 0) {
   args.logic = 2;
   args.low_ms = 2000;
   args.high_ms = 5000;
   args.rx_pkts_threshold = 10;
 } else if (mode == 1) {
   args.logic = 2;
   args.low_ms = 200;
   args.high_ms = 800;
   args.rx_pkts_threshold = 10;
 }

Afterwards, the WLC_SET_PM ioctl is issued with the argument value 2 (PM2).

This is used by nifm.

wlan:lcl

This is "nn::wlan::detail::ILocalManager".

This service no longer exists in [15.0.0+].

Cmd	Name
0	[9.0.0+] OpenMode ([1.0.0-8.1.0] OpenMasterMode)
1	[9.0.0+] CloseMode ([1.0.0-8.1.0] CloseMasterMode)
2	[9.0.0+] GetMacAddress ([1.0.0-8.1.0] OpenClientMode)
3	[9.0.0+] CreateBss ([1.0.0-8.1.0] CloseClientMode)
4	[9.0.0+] DestroyBss ([1.0.0-8.1.0] OpenSpectatorMode)
5	[9.0.0+] StartScan ([1.0.0-8.1.0] CloseSpectatorMode)
6	[9.0.0+] StopScan ([1.0.0-8.1.0] GetMacAddress)
7	[9.0.0+] Connect ([1.0.0-8.1.0] CreateBss)
8	[9.0.0+] CancelConnect ([1.0.0-8.1.0] DestroyBss)
9	[9.0.0+] Join ([1.0.0-8.1.0] StartScan)
10	[9.0.0+] CancelJoin ([1.0.0-8.1.0] StopScan)
11	[9.0.0+] Disconnect ([1.0.0-8.1.0] Connect)
12	[9.0.0+] SetBeaconLostCount ([1.0.0-8.1.0] CancelConnect)
13	[9.0.0+] GetSystemEvent ([1.0.0-8.1.0] Join)
14	[9.0.0+] GetConnectionStatus ([1.0.0-8.1.0] CancelJoin)
15	[9.0.0+] GetClientStatus ([1.0.0-8.1.0] Disconnect)
16	[9.0.0+] GetBssIndicationEvent ([1.0.0-8.1.0] SetBeaconLostCount)
17	[9.0.0+] GetBssIndicationInfo ([1.0.0-8.1.0] GetSystemEvent)
18	[9.0.0+] GetState ([1.0.0-8.1.0] GetConnectionStatus)
19	[9.0.0+] GetAllowedChannels ([1.0.0-8.1.0] GetClientStatus)
20	[9.0.0+] AddIe ([1.0.0-8.1.0] GetBssIndicationEvent)
21	[9.0.0+] DeleteIe ([1.0.0-8.1.0] GetBssIndicationInfo)
22	[9.0.0+] PutFrameRaw ([1.0.0-8.1.0] GetState)
23	[9.0.0+] CancelGetFrame ([1.0.0-8.1.0] GetAllowedChannels)
24	[9.0.0+] CreateRxEntry ([1.0.0-8.1.0] AddIe)
25	[9.0.0+] DeleteRxEntry ([1.0.0-8.1.0] DeleteIe)
26	[9.0.0+] AddEthertypeToRxEntry ([1.0.0-8.1.0] PutFrameRaw)
27	[9.0.0+] DeleteEthertypeFromRxEntry ([1.0.0-8.1.0] CancelGetFrame)
28	[9.0.0+] AddMatchingDataToRxEntry ([1.0.0-8.1.0] CreateRxEntry)
29	[9.0.0+] RemoveMatchingDataFromRxEntry ([1.0.0-8.1.0] DeleteRxEntry)
30	[9.0.0+] GetScanResult ([1.0.0-8.1.0] AddEthertypeToRxEntry)
31	[9.0.0+] PutActionFrameOneShot ([1.0.0-8.1.0] DeleteEthertypeFromRxEntry)
32	[9.0.0+] SetActionFrameWithBeacon ([1.0.0-8.1.0] AddMatchingDataToRxEntry)
33	[9.0.0+] CancelActionFrameWithBeacon ([1.0.0-8.1.0] RemoveMatchingDataFromRxEntry)
34	[9.0.0+] CreateRxEntryForActionFrame ([1.0.0-8.1.0] GetScanResult)
35	[9.0.0+] DeleteRxEntryForActionFrame ([1.0.0-8.1.0] PutActionFrameOneShot)
36	[9.0.0+] AddSubtypeToRxEntryForActionFrame ([1.0.0-8.1.0] SetActionFrameWithBeacon)
37	[9.0.0+] DeleteSubtypeFromRxEntryForActionFrame ([1.0.0-8.1.0] CancelActionFrameWithBeacon)
38	[9.0.0+] CancelGetActionFrame ([1.0.0-8.1.0] CreateRxEntryForActionFrame)
39	[9.0.0+] GetRssi ([1.0.0-8.1.0] DeleteRxEntryForActionFrame)
40	[9.0.0+] SetMaxAssociationNumber ([1.0.0-8.1.0] AddSubtypeToRxEntryForActionFrame)
41	[9.0.0+] ([1.0.0-8.1.0] DeleteSubtypeFromRxEntryForActionFrame)
42	[9.0.0+] ([1.0.0-8.1.0] CancelGetActionFrame)
43	[9.0.0+] ([1.0.0-8.1.0] GetRssi)
44	[9.0.0+] ([1.0.0-8.1.0] SetMaxAssociationNumber)
45	[9.0.0+] ([4.0.0-8.1.0])
46	[9.0.0+] ([4.0.0-8.1.0])
47	[9.0.0+] ([4.0.0-8.1.0])
48	[10.0.0+] ([4.0.0-8.1.0])
49	[13.0.0+] ([6.0.0-8.1.0])
50	[13.0.0+] ([6.0.0-8.1.0])
51	[13.0.0+] ([8.0.0-8.1.0])
52	([8.0.0-8.1.0])

[5.0.0+] GetAllowedChannels now returns a total of 4-bytes of output instead of 0x50, and now takes a type-0xA output buffer.

[10.0.0+] Cmd46 now takes a total of 1-byte of input instead of 6-bytes, while cmd47 now takes a total of 6-bytes of input instead of 1-byte.

OpenMasterMode

No input/output.

Sends command message 0x7 to the state machine.

CloseMasterMode

No input/output.

Sends command message 0x5 to the state machine.

OpenClientMode

No input/output.

Sends command message 0x8 to the state machine.

CloseClientMode

No input/output.

Sends command message 0x5 to the state machine.

OpenSpectatorMode

No input/output.

Sends command message 0x9 to the state machine.

CloseSpectatorMode

No input/output.

Sends command message 0x5 to the state machine.

OpenMode

Takes an input u32 Mode. No output.

CloseMode

Takes an input u32 Mode. No output.

GetMacAddress

No input. Returns an output #MacAddress.

Sends command message 0x18 (GetMacAddress) to the state machine.

CreateBss

Takes an input #Bss. No output.

Sends command messages 0xA (SetWlanInterfaceUpDown) and 0x1E (CreateAp) to the state machine.

DestroyBss

No input/output.

Sends command message 0x1F (DestroyAp) to the state machine.

StartScan

Takes a type-0x15 input buffer buffer containing a #ScanRequest. No output.

Sends command messages 0xA (SetWlanInterfaceUpDown) and 0x14 (ScanRequest) to the state machine.

StopScan

No input/output.

Sends command message 0x16 (CancelScan) to the state machine.

Connect

Takes an input #ConnectParam. No output.

Sends command messages 0xA (SetWlanInterfaceUpDown), 0x11 (SetBeaconLostTimeout), 0xF (SetStaticAesMode) and 0x20 (JoinNetworkSta) to the state machine.

CancelConnect

No input/output.

Sends command message 0x23 (CancelJoinNetwork) to the state machine.

Join

Takes an input #ConnectParam. No output.

Sends command messages 0xA (SetWlanInterfaceUpDown), 0x11 (SetBeaconLostTimeout), 0xF (SetStaticAesMode) and 0x22 (JoinNetworkSpectator) to the state machine.

CancelJoin

No input/output.

Sends command message 0x23 (CancelJoinNetwork) to the state machine.

Disconnect

Takes an input u32 Argument and an input #MacAddress. No output.

Sends command message 0x25 (DeauthRequest) to the state machine.

SetBeaconLostCount

Takes an input u32 BeaconLostCount. No output.

GetSystemEvent

Takes an input u32 SystemEventType. Returns an output Event handle.

GetConnectionStatus

No input. Returns an output #ConnectionStatus.

Sends command message 0x80 (GetState) to the state machine, to check current state. Then this copies data from state to output (unrelated to message 0x80).

GetClientStatus

Takes a type-0x16 output buffer containing a #ClientStatus. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

GetBssIndicationEvent

No input. Returns an output Event handle.

GetBssIndicationInfo

Takes a type-0x16 output buffer. No output.

GetState

No input. Returns an output #State.

Sends command message 0x80 (GetState) to the state machine.

GetAllowedChannels

Takes a type-0xA output buffer. Returns an output u32 AllowedChannelsCount.

AddIe

Takes a type-0x5 input buffer and an input u32 ManagementFrameType. Returns an output u32 Ie.

Sends command message 0x28 (AddIe) to the state machine.

DeleteIe

Takes an input u32 Ie. No output.

Sends command message 0x29 (DeleteIe) to the state machine.

PutFrameRaw

Takes a type-0x5 input buffer. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

CancelGetFrame

Takes an input u32 RxId. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

CreateRxEntry

Takes a type-0x9 input buffer and an input u32 Capacity. Returns an output u32 RxId.

DeleteRxEntry

Takes an input u32 RxId. No output.

AddEthertypeToRxEntry

Takes an input u32 RxId and an input u32 Protocol. No output.

DeleteEthertypeFromRxEntry

Takes an input u16 Protocol. Returns an output u32.

AddMatchingDataToRxEntry

Takes a type-0x19 input buffer and an input u32 RxId. No output.

[15.0.0+] Now takes a total of 0x1C-bytes of input.

Sends command message 0x2A (AddMatchingDataInfoToRxEntry) to the state machine.

RemoveMatchingDataFromRxEntry

Takes a type-0x19 input buffer and an input u32 RxId. No output.

[15.0.0+] Now takes a total of 0x1C-bytes of input.

Sends command message 0x2B (RemoveMatchingDataFromRxEntry) to the state machine.

GetScanResult

Takes a type-0x19 input buffer and a type-0x6 output buffer containing a #ScanResult. No output.

Sends command message 0x15 (BssInfoListGet) to the state machine.

PutActionFrameOneShot

Takes a type-0x5 input buffer, an input #MacAddress and two u32s Channel and DwellTime. No output.

Sends command message 0xA (SetWlanInterfaceUpDown) to the state machine.

SetActionFrameWithBeacon

Takes a type-0x5 input buffer. No output.

[15.0.0+] Now takes a type-0x21 input buffer instead of a type-0x5 input buffer.

Sends command message 0x2C (SetActionFrameWithBeacon) to the state machine.

CancelActionFrameWithBeacon

No input/output.

Sends command message 0x2D (CancelActionFrameWithBeacon) to the state machine.

CreateRxEntryForActionFrame

Takes a type-0x9 input buffer and an input u32 Capacity. Returns an output u32 RxId.

DeleteRxEntryForActionFrame

Takes an input u32 RxId. No output.

AddSubtypeToRxEntryForActionFrame

Takes an input u32 RxId and an input u32 Subtype. No output.

DeleteSubtypeFromRxEntryForActionFrame

Takes an input u32 Subtype. Returns an output u32.

CancelGetActionFrame

Takes an input u32 RxId. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

GetRssi

No input. Returns an output u32 Rssi.

Sends command message 0x2E (GetRssi) to the state machine.

SetMaxAssociationNumber

Takes an input u32 MaxAssociationNumber. No output.

Sends command message 0x31 (SetMaxAssociationNumber) to the state machine.

wlan:lg

This is "nn::wlan::detail::ILocalGetFrame".

This service no longer exists in [15.0.0+].

Cmd	Name
0	GetFrameRaw

GetFrameRaw

Takes a type-0x6 output buffer and an input u32 RxId. Returns an output u32 FrameSize.

Sends command message 0x80 (GetState) to the state machine, to check current state.

wlan:lga

This is "nn::wlan::detail::ILocalGetActionFrame".

This service no longer exists in [15.0.0+].

Cmd	Name
0	GetActionFrame

GetActionFrame

Takes a type-0x6 output buffer and an input u32 RxId. Returns an output #MacAddress and an output u32 ActionFrame.

[5.0.0+] Now takes another input u32 and returns another output u32.

wlan:sg

This is "nn::wlan::detail::ISocketGetFrame".

This service no longer exists in [15.0.0+].

Cmd	Name
0	GetFrameRaw

GetFrameRaw

Takes a type-0x6 output buffer and an input u32 RxId. Returns an output u32 FrameSize.

wlan:soc

This is "nn::wlan::detail::ISocketManager".

This service no longer exists in [15.0.0+].

Cmd	Name
0	PutFrameRaw
1	CancelGetFrame
2	CreateRxEntry
3	DeleteRxEntry
4	AddEthertypeToRxEntry
5	DeleteEthertypeFromRxEntry
6	GetMacAddress
7	SwitchTsfTimerFunction
8	GetDeltaTimeBetweenSystemAndTsf
9	RegisterSharedMemory
10	UnregisterSharedMemory
11	EnableSharedMemory
12	[6.0.0+] SetMulticastFilter

PutFrameRaw

Takes a type-0x5 input buffer. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

CancelGetFrame

Takes an input u32 RxId. No output.

Sends command message 0x80 (GetState) to the state machine, to check current state.

CreateRxEntry

Takes a type-0x9 input buffer and an input u32 Capacity. Returns an output u32 RxId.

DeleteRxEntry

Takes an input u32 RxId. No output.

AddEthertypeToRxEntry

Takes an input u32 RxId and an input u32 Protocol. No output.

DeleteEthertypeFromRxEntry

Takes an input u16 Protocol. Returns an output u32.

GetMacAddress

No input. Returns an output #MacAddress.

Sends command message 0x18 (GetMacAddress) to the state machine.

SwitchTsfTimerFunction

Takes an input bool. No output.

Sends command message 0x2F (SetTsfTimerEventmask) to the state machine.

GetDeltaTimeBetweenSystemAndTsf

No input. Returns an u64 DeltaTimeBetweenSystemAndTsf.

RegisterSharedMemory

Takes an input SharedMemory handle, an u32 SharedMemorySize and four input Event handles RxPacketEventHandle, TxPacketEventHandle, RxCbufEventHandle and TxCbufEventHandle. No output.

[15.0.0+] Stubbed. Returns 0.

UnregisterSharedMemory

No input/output.

[15.0.0+] Stubbed. Returns 0.

EnableSharedMemory

No input/output.

[15.0.0+] Stubbed. Returns 0.

SetMulticastFilter

Takes an input #MulticastList. No output.

wlan:dtc

This is "nn::wlan::detail::IDetectManager".

This was added with [6.0.0+].

This service no longer exists in [15.0.0+].

Cmd	Name
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

[7.0.0+] Cmd14 now takes an input u8.

wlan

This is "nn::wlan::detail::IGeneralServiceCreator".

This was added with [15.0.0+].

Cmd	Name
0	#CreateWirelessCommunicationService

CreateWirelessCommunicationService

No input. Returns an #IWirelessCommunicationService.

IWirelessCommunicationService

This is "nn::wlan::detail::IWirelessCommunicationService".

This was added with [15.0.0+].

Cmd	Name
0
1
10
11
12
13
14
20
21
30
31
32
33	GetMacAddress
40
41
42
43	CreateRxEntry
44	DeleteRxEntry
45	AddEthertypeToRxEntry
46	DeleteEthertypeFromRxEntry
47	AddMatchingDataToRxEntry
48	RemoveMatchingDataFromRxEntry
50	AddIe
51	DeleteIe
60	StartScan
61	StopScan
62	GetBssIndicationEvent
63	GetScanResult
70	RegisterSharedMemory
71	UnregisterSharedMemory
72	EnableSharedMemory
80	RequestSleep
81	RequestWakeUp
90
91
92
93
94
95	SetActionFrameWithBeacon
96	CancelActionFrameWithBeacon
97	SetMaxAssociationNumber
98
100
101
102
103
104
105
106
107	SetMulticastFilter
108	SetPowerSaveMode
109	[19.0.0+]
110
111
112
113
120	[19.0.0+]
200	[17.0.0+]
201	[17.0.0+]
202	[17.0.0+]
203	[17.0.0+]
204	[19.0.0+]

Cmd90

Takes a type-0x19 input buffer containing a 0x84-byte struct. Returns a total of 0x32-bytes of output.

[19.0.0+] The struct size is now 0x80-bytes.

Cmd100

Takes a total of 0x80-bytes of input. No output.

[19.0.0+] Takes a total of 0x7C-bytes of input. No output.

wlan:p

This is "nn::wlan::detail::IPrivateServiceCreator".

This was added with [15.0.0+].

As of [15.0.0] nothing has access to this service on retail (and hence #IPrivateWirelessCommunicationService isn't usable either).

Cmd	Name
0	#CreateWirelessCommunicationService
1	#CreatePrivateWirelessCommunicationService

CreatePrivateWirelessCommunicationService

No input. Returns an #IPrivateWirelessCommunicationService.

IPrivateWirelessCommunicationService

This is "nn::wlan::detail::IPrivateWirelessCommunicationService".

This was added with [15.0.0+].

Cmd	Name
0	GetFwVersion
1	[15.0.0-16.1.0] ChangeRxAntenna
2	[[#ScanWithScanTime|ScanWithScanTime]
3	GetWakeupReasonRaw
4	SetWakeupReasonRaw
5	EnableWowlFeatures
6	GetWowlStats
7	ClearWowlStats
8	EmulateDriverInitFail
9	GetChannelStats
10	SetCalibrationTriggerOnScan
11	SetMacAddress
12	CreateBssNoChannelLimit
13	EnableTsfTimerFunction
14	DisableTsfTimerFunction
15	GetDeltaTimeBetweenSystemAndTsf
16	InitializeWlanProcess
17	FinalizeWlanProcess
18	ExecWpaCommand
19	SwitchWlanDevice
20	[15.0.0-16.1.0]
21	[15.0.0-16.1.0]
22	[15.0.0-16.1.0]

ScanWithScanTime

Takes 4-bytes of input and a type-0x19 input buffer containing a 0x1F8-byte struct. No output.

[19.0.0+] The struct size is now 0x9A-bytes.

CreateBssNoChannelLimit

Takes a type-0x19 input buffer containing a 0x84-byte struct. Returns a total of 0x32-bytes of output.

[19.0.0+] The struct size is now 0x80-bytes.

wlan:nd

This is "nn::anif::detail::ISfDriverServiceCreator".

This was added with [15.0.0+].

Cmd	Name
0	#CreateDriverService

CreateDriverService

No input. Returns an #ISfDriverService.

ISfDriverService

This is "nn::anif::detail::ISfDriverService".

This was added with [15.0.0+].

Cmd	Name
0	#OpenNetworkInterface
128	GetDriverInfo
129	GetNetworkInterfaceList
130	GetStateChangedEvent
131	GetNetworkInterfaceListUpdatedEvent
384	Ioctl
385	IoctlRead
386	IoctlWrite
387	IoctlReadWrite
388	IoctlSetHandle
389	IoctlGetHandle

OpenNetworkInterface

Takes a type-0x21 input buffer. Returns an #ISfNetworkInterfaceService.

ISfNetworkInterfaceService

This is "nn::anif::detail::ISfNetworkInterfaceService".

This was added with [15.0.0+].

Cmd	Name
0	Duplicate
1	BringUp
2	BringDown
3	StartCommunication
4	StopCommunication
5	CreateSharedMemory
6	DestroySharedMemory
128	GetNetworkInterfaceInfo
129	GetStateChangedEvent
130	GetRxQueue
131	GetTxQueue
256	SetMacAddress
257	SetMru
258	SetMtu
259	SetFeatures
260	SetMulticastFilter
261	SetRxBufferSize
262	SetTxBufferSize
384	Ioctl
385	IoctlRead
386	IoctlWrite
387	IoctlReadWrite
388	IoctlSetHandle
389	IoctlGetHandle

Ssid

This is "nn::wlan::Ssid". This is a 0x22-byte struct.

Offset	Size	Description
0x0	0x1	Length
0x1	0x20	Ssid
0x21	0x1	Reserved

MacAddress

This is a 0x6-byte struct with 1-byte alignment.

ConnectParam

This is a 0x80-byte struct.

Offset	Size	Description
0x0	0x22	Ssid
0x22	0x6	Bssid
0x28	0x1
0x29	0x1	Reserved
0x2A	0x2	Channel
0x2C	0x4	PrivacyMode
0x30	0x4	GroupPrivacyMode
0x34	0x4	KeyIdx
0x38	0x40	SecurityKey
0x78	0x4	Reserved
0x7C	0x4	BeaconLostTimeout

ConnectionStatus

This is a 0x3C-byte struct.

Offset	Size	Description
0x0	0x4	ConnectionState
0x4	0x4
0x8	0x2	Channel
0xA	0x6	Bssid
0x10	0x22	Ssid
0x32	0x2
0x34	0x2
0x36	0x2
0x38	0x2
0x3A	0x2	Reserved

ClientStatus

This is a 0xE4-byte struct.

ScanRequest

This is a 0x1B8-byte struct.

[19.0.0+] This is a 0x9A-byte struct (previously 0x1F8-bytes).

Offset	Size	Description
0x0	0x4	ScanType
0x4	0x2 * 38
0x50	0x1
0x51	0x3	Reserved
0x54	0x4	ChannelScanTime
0x58	0x4	HomeChannelTime
0x5C	0x22 * 10	Array of Ssid
0x1B0	0x1	SsidCount
0x1B1	0x6	Bssid
0x1B7	0x1	Reserved

ScanResult

Offset	Size	Description
0x0	0x4	ScanBufferCapacity
0x4	0x4	BssInfoSize
0x8	0x4	BssInfoCount
0xC	Variable	Array of #BssInfo

Bss

This is a 0x80-byte struct.

[4.0.0+] This is a 0x84-byte struct.

BssInfo

This is a 0x58-byte struct.

ConnectionState

This is "nn::wlan::ConnectionState".

Value	Description
0	None
1	Idle
2	Connected
3	Scanning
4	Connecting
5	CancelingScan
6	Disconnecting

State

Value	Description
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

WpsPin

This is a 0x8-byte string.

MulticastList

This is a 0x31-byte struct.

Offset	Size	Description
0x0	0x1	Count
0x1	0x30	Array of #MacAddress

WakeUpStats

This is a 0x20-byte struct.

This is updated during RequestWakeUp. The fields starting with offset +0x4 are updated when handling wowl, which counter is updated depends on the value of iovar "tcpka_wake_cause".

Offset	Size	Description
0x0	0x4	Number of normal non-wowl wakeups. Also incremented during wowl handling if the output from the func using "tcpka_wake_cause" is 0.
0x4	0x4
0x8	0x4
0xC	0x4
0x10	0x4
0x14	0x4
0x18	0x4
0x1C	0x4	Number of wowl wakeups where the cause is unrecognized.

SleepStats

This is a 0x38-byte struct.

During RequestWakeUp when handling wowl, this data in state is updated by adding each field with the corresponding field from iovar "sleep_stats_get".

Offset	Size	Description
0x0	0x4
0x4	0x4
0x8	0x4
0xC	0x4
0x10	0x4
0x14	0x4
0x18	0x4
0x1C	0x4
0x20	0x4
0x24	0x4
0x28	0x4
0x2C	0x4
0x30	0x4
0x34	0x4

FwVersion

This is a 0x100-byte string.

System Version	Firmware String
[1.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-aoe Version: 7.35.252.58 CRC: f592f3bf Date: Tue 2016-10-04 23:54:54 PDT Ucode Ver: 1020.221 FWID: 01-5ec2fbfd
[2.0.0-2.2.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe Version: 7.35.64.1 CRC: 301f7804 Date: Fri 2017-02-17 01:03:01 PST Ucode Ver: 1020.223 FWID: 01-82d1f902
[3.0.0-3.0.2]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe Version: 7.35.252.70 CRC: f3b554fd Date: Thu 2017-05-04 19:04:04 PDT Ucode Ver: 1020.223 FWID: 01-5d27fda5
[4.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe Version: 7.35.252.75 (r666384) CRC: 58f59a6f Date: Wed 2017-08-16 22:27:11 PDT Ucode Ver: 1020.223
[5.0.0-5.1.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe Version: 7.78.1.1 (r683984) CRC: 6a10caf9 Date: Wed 2018-02-21 21:43:01 PST Ucode Ver: 1020.223 FWID 01-ae4e196d
[6.0.0-6.2.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.84 (r692035) CRC: 937bcfc9 Date: Tue 2018-06-19 19:36:54 PDT Ucode Ver: 1020.225 FWID 01-71fd007e
[7.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.87 (r708450) CRC: 5f41af12 Date: Thu 2018-10-25 19:11:47 PDT Ucode Ver: 1020.226 FWID 01-377c0939
[8.0.0-8.1.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.90 (r711053) CRC: 30dcf8a5 Date: Thu 2019-02-28 18:12:24 PST Ucode Ver: 1020.226 FWID 01-e691490c
[9.0.0-9.1.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.93 (r717555) CRC: d8363dad Date: Mon 2019-07-01 23:43:14 PDT Ucode Ver: 1020.228 FWID 01-c90a462
[10.0.0-10.1.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.96 (r723441) CRC: f6823c05 Date: Tue 2019-11-19 22:31:29 PST Ucode Ver: 1020.228 FWID 01-a1b7e0a4
[11.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.99 (r725630) CRC: 320007b0 Date: Mon 2020-05-25 19:51:18 PDT Ucode Ver: 1020.228 FWID 01-822b442d
[12.0.0-13.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.104 (r728022) CRC: f0b454ec Date: Wed 2021-02-24 04:39:25 PST Ucode Ver: 1020.228 FWID 01-fbba058
[14.0.0-19.0.0]	4356a3-roml/pcie-ag-msgbuf-splitrx-pktctx-keepalive-sr-proptxstatus-ampduhostreorder-dlystat-rxdesens-clm_4356a3_ntd-noclminc-ntdds3-btcdyn-trfmgmt-pspretend-btafh-pktfilter-wowlpf-gtkoe-aoe-tcpkaoe-aloe Version: 7.35.252.108 (c216b7c) CRC: 1be69227 Date: Sun 2021-08-29 19:24:39 PDT Ucode Ver: 1020.228 FWID 01-65333037

• [2.0.0+] Besides the version update, added "gtkoe" to the string.
• [3.0.0+] Besides the version update, added "tcpkaoe" to the string.
• [6.0.0+] Besides the version update, added "clm_4356a3_ntd" to the string.
• [7.0.0+] Besides the version update, added "noclminc" to the string.

Notes

Originally wlan-sysmodule had a func called from nnMain which (among other things) handled configuring GPIO WifiReset (uses commands SetDirection and SetValue with input value 1), when not disabled by a system-setting. This GPIO functionality was removed from wlan with [7.0.0+], it was redundant since pcie already had code handling that GPIO as well.