290
edits
Changes
Jump to navigation
Jump to search
Line 24:
Line 24: − + Line 44:
Line 44: − + − + − + − + − + − + − + − + − + − + Line 70:
Line 70: − + − + − + − + − + − + − + − + − − [4.0.0+] Connect now takes an additional 4-bytes of input. − − [5.0.0+] Cmd24 now returns a total of 0x58-bytes of output instead of 0x5C. − − [7.0.0+] Input/output for cmds 27/28 were swapped, perhaps these cmds were swapped? Line 132:
Line 126: + + Line 151:
Line 147: − + Line 246:
Line 242: − + − + Line 253:
Line 249: − + Line 262:
Line 258: − + − + − + − + − + − + − + − + − + − + − + − + − + + + Line 299:
Line 297: − + − + − + − + Line 317:
Line 315: − + − + Line 339:
Line 337: − Unofficial name. − − + − + − + Line 358:
Line 354: − + Line 365:
Line 361: − + Line 372:
Line 368: − + − + Line 379:
Line 375: − + − + Line 386:
Line 382: − + Line 393:
Line 389: − + − + Line 400:
Line 396: − + − + Line 407:
Line 403: − + − Unofficial name. − Line 862:
Line 856: − + Line 915:
Line 909: − + − Unofficial name. − Line 1,003:
Line 995: − Unofficial name. − Line 1,114:
Line 1,104: − + − + Line 1,125:
Line 1,115: + + + + + + + + Line 1,144:
Line 1,142: − Unofficial name. − Line 1,159:
Line 1,155: − + Line 1,183:
Line 1,179: − + − + Line 1,197:
Line 1,193: − + − + − + Line 1,217:
Line 1,213: − Unofficial name. − Line 1,230:
Line 1,224: − + Line 1,253:
Line 1,247: − + − Unofficial name. − Line 1,641:
Line 1,633: − +
no edit summary
| 7 || [[#Disconnect|Disconnect]]
| 7 || [[#Disconnect|Disconnect]]
|-
|-
| 8 || [[#GetSystemEvent|GetSystemEvent]]
| 8 || [[#GetConnectionEvent|GetConnectionEvent]]
|-
|-
| 9 || [[#GetConnectionStatus|GetConnectionStatus]]
| 9 || [[#GetConnectionStatus|GetConnectionStatus]]
| 17 || [[#ConnectWithWps|ConnectWithWps]]
| 17 || [[#ConnectWithWps|ConnectWithWps]]
|-
|-
| 18 || [3.0.0+]
| 18 || [3.0.0+] [[#GetWakeupReason|GetWakeupReason]]
|-
|-
| 19 || [3.0.0+]
| 19 || [3.0.0+] [[#SetTcpSessionInformation|SetTcpSessionInformation]]
|-
|-
| 20 || [3.0.0+]
| 20 || [3.0.0+] [[#RemoveTcpSessionInformation|RemoveTcpSessionInformation]]
|-
|-
| 21 || [3.0.0+]
| 21 || [3.0.0+] [[#GetWakeupReasonRaw|GetWakeupReasonRaw]]
|-
|-
| 22 || [3.0.0+]
| 22 || [3.0.0+] [[#SetWakeupReasonRaw|SetWakeupReasonRaw]]
|-
|-
| 23 || [3.0.0+]
| 23 || [3.0.0+] [[#EnableWowlFeatures|EnableWowlFeatures]]
|-
|-
| 24 || [3.0.0+]
| 24 || [3.0.0+] [[#GetWowlStats|GetWowlStats]]
|-
|-
| 25 || [3.0.0+]
| 25 || [3.0.0+] [[#ClearWowlStats|ClearWowlStats]]
|-
|-
| 26 || [4.0.0+]
| 26 || [4.0.0+] [[#EmulateDriverInitFail|EmulateDriverInitFail]]
|-
|-
| 27 || [4.0.0+]
| 27 || [4.0.0+] [[#GetAllowedChannels|GetAllowedChannels]]
|-
|-
| 28 || [5.0.0+] [[#InitializeWlan|InitializeWlan]]
| 28 || [5.0.0+] [[#InitializeWlan|InitializeWlan]]
| 30 || [8.0.0+] [[#SetWowlDelayedWakeTime|SetWowlDelayedWakeTime]]
| 30 || [8.0.0+] [[#SetWowlDelayedWakeTime|SetWowlDelayedWakeTime]]
|-
|-
| 31 || [11.0.0+]
| 31 || [11.0.0+] [[#StartConcurrentCommunication|StartConcurrentCommunication]]
|-
|-
| 32 || [11.0.0+]
| 32 || [11.0.0+] [[#StopConcurrentCommunication|StopConcurrentCommunication]]
|-
|-
| 33 || [11.0.0+]
| 33 || [11.0.0+] [[#SendConcurrentData|SendConcurrentData]]
|-
|-
| 34 || [11.0.0+]
| 34 || [11.0.0+] [[#RecvConcurrentData|RecvConcurrentData]]
|-
|-
| 35 || [11.0.0+]
| 35 || [11.0.0+] [[#CancelRecvConcurrentData|CancelRecvConcurrentData]]
|-
|-
| 36 || [11.0.0+]
| 36 || [11.0.0+] [[#SetConcurrentCycle|SetConcurrentCycle]]
|-
|-
| 37 || [11.0.0+]
| 37 || [11.0.0+] [[#SetConcurrentDataRate|SetConcurrentDataRate]]
|-
|-
| 38 || [13.0.0+] [[#SetDfrts|SetDfrts]]
| 38 || [13.0.0+] [[#SetPowerSaveMode|SetPowerSaveMode]]
|}
|}
== OpenMode ==
== OpenMode ==
== Connect ==
== Connect ==
Takes an input [[#ConnectParam]]. No output.
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.
Sends command messages 0xA (SetWlanInterfaceUpDown), 0x11 (SetBeaconLostTimeout) and 0x20 (JoinNetworkSta) to the state machine.
This is used by [[Network_Interface_services|nifm]].
This is used by [[Network_Interface_services|nifm]].
== GetSystemEvent ==
== GetConnectionEvent ==
Takes an input u32 '''SystemEventType'''. Returns an output Event handle.
Takes an input u32 '''SystemEventType'''. Returns an output Event handle.
This is not used on retail.
This is not used on retail.
== Cmd18 ==
== GetWakeupReason ==
No input, returns an output u32.
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.
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.
This is not used on retail.
== Cmd19 ==
== SetTcpSessionInformation ==
Takes an input [[#MacAddress]], three input u16s '''SrcPort''', '''DstPort''' and '''Unk0''', and three input u32s '''SrcIp''', '''DstIp''' and '''Unk1'''. No output.
Takes an input [[#MacAddress]], three input u16s '''SrcPort''', '''DstPort''' and '''Unk0''', and three input u32s '''SrcIp''', '''DstIp''' and '''Unk1'''. No output.
This is used by [[Network_Interface_services|nifm]].
This is used by [[Network_Interface_services|nifm]].
== Cmd20 ==
== RemoveTcpSessionInformation ==
No input/output.
No input/output.
This clears the state set by [[#Cmd19]].
This clears the state set by [[#SetTcpSessionInformation]].
This is not used on retail.
This is not used on retail.
== Cmd21 ==
== GetWakeupReasonRaw ==
No input, returns an output u32.
No input. Returns an output u32.
Same as [[#Cmd18]] except the value from the request is returned directly, without calling the vfunc.
Same as [[#GetWakeupReason]] except the value from the request is returned directly, without calling the vfunc.
This is not used on retail.
This is not used on retail.
== Cmd22 ==
== SetWakeupReasonRaw ==
Takes an input u32, no output.
Takes an input u32. No output.
Same as [[#Cmd21]] 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 [[#Cmd19|"wowl"]].
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 [[#SetTcpSessionInformation|"wowl"]].
This is not used on retail.
This is not used on retail.
== Cmd23 ==
== EnableWowlFeatures ==
Takes an input u32, no output.
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 [[#Cmd19]].
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.
This is not used on retail.
== Cmd24 ==
== GetWowlStats ==
No input, returns a [[#WakeUpStats]] and a [[#SleepStats]].
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.
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.
This is not used on retail.
This is not used on retail.
== Cmd25 ==
== ClearWowlStats ==
Takes two input bools, no output.
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.
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 [[#Cmd24]], likewise with the second request and the second state struct from [[#Cmd24]].
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.
This is not used on retail.
== Cmd26 ==
== EmulateDriverInitFail ==
No input/output.
No input/output.
This is not used on retail.
This is not used on retail.
== Cmd27 ==
== GetAllowedChannels ==
Takes a type-0xA output buffer containing an array of 2-byte entries, returns an output u32 total_out.
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 memcpys data from state into the output buffer, clamped to a maximum of 0x40 entries (nifm hard-codes the count to 0x26).
== SetWowlDelayedWakeTime ==
== SetWowlDelayedWakeTime ==
Takes an input s32 '''WowlDelayedWakeTime'''. No output.
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 [[#Cmd19]], which [[#Cmd19]] doesn't write), then this returns 0.
'''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.
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 [[#Cmd19]].
This is used by wlan during RequestSleep from the same code using the state set by [[#SetTcpSessionInformation]].
This cmd is used by [[Network_Interface_services|nifm]] with a value from state, prior to using RequestSleep.
This cmd is used by [[Network_Interface_services|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:
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 [[#Cmd19|TCP]] connection is RST.
* This is only used when the [[#SetTcpSessionInformation|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.
** '''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.
** -1 will skip scheduling that timer, hence waking the system is disabled when RST is received.
* Frames where the TCP flags do not match ACK will immediately wake the system, + other wake cause(s).
* Frames where the TCP flags do not match ACK will immediately wake the system, + other wake cause(s).
== Cmd31 ==
== StartConcurrentCommunication ==
No input/output.
No input/output.
This is not used on retail.
This is not used on retail.
== Cmd32 ==
== StopConcurrentCommunication ==
No input/output.
No input/output.
This is not used on retail.
This is not used on retail.
== Cmd33 ==
== SendConcurrentData ==
Takes an input [[#MacAddress]] and a type-0x5 input buffer, no output.
Takes an input [[#MacAddress]] and a type-0x5 input buffer. No output.
Stubbed, just returns an error.
Stubbed, just returns an error.
This is not used on retail.
This is not used on retail.
== Cmd34 ==
== RecvConcurrentData ==
Takes a type-0x6 output buffer and returns a total of 0x10-bytes.
Takes a type-0x6 output buffer. Returns a total of 0x10-bytes.
Stubbed, just returns an error.
Stubbed, just returns an error.
This is not used on retail.
This is not used on retail.
== Cmd35 ==
== CancelRecvConcurrentData ==
No input/output.
No input/output.
This is not used on retail.
This is not used on retail.
== Cmd36 ==
== SetConcurrentCycle ==
Takes two input u64s, no output.
Takes two input u64s. No output.
Stubbed, just returns an error.
Stubbed, just returns an error.
This is not used on retail.
This is not used on retail.
== Cmd37 ==
== SetConcurrentDataRate ==
Takes an input u32, no output.
Takes an input u32. No output.
Stubbed, just returns an error.
Stubbed, just returns an error.
This is not used on retail.
This is not used on retail.
== SetDfrts ==
== SetPowerSaveMode ==
Takes an input u32 '''Mode'''. No output.
Takes an input u32 '''Mode'''. No output.
| 11 || [[#EnableSharedMemory|EnableSharedMemory]]
| 11 || [[#EnableSharedMemory|EnableSharedMemory]]
|-
|-
| 12 || [6.0.0+] [[#SetMulticastList|SetMulticastList]]
| 12 || [6.0.0+] [[#SetMulticastFilter|SetMulticastFilter]]
|}
|}
[15.0.0+] Stubbed. Returns 0.
[15.0.0+] Stubbed. Returns 0.
== SetMulticastList ==
== SetMulticastFilter ==
Takes an input [[#MulticastList]]. No output.
Takes an input [[#MulticastList]]. No output.
== CreateWirelessCommunicationService ==
== CreateWirelessCommunicationService ==
No input. Returns an [[#IWirelessCommunicationService]].
No input. Returns an [[#IWirelessCommunicationService]].
| 106 ||
| 106 ||
|-
|-
| 107 || [[#SetMulticastList|SetMulticastList]]
| 107 || [[#SetMulticastFilter|SetMulticastFilter]]
|-
|-
| 108 || [[#SetDfrts|SetDfrts]]
| 108 || [[#SetPowerSaveMode|SetPowerSaveMode]]
|-
|-
| 110 ||
| 110 ||
|-
|-
| 113 ||
| 113 ||
|-
| 200 || [17.0.0+]
|-
| 201 || [17.0.0+]
|-
| 202 || [17.0.0+]
|-
| 203 || [17.0.0+]
|}
|}
== CreatePrivateWirelessCommunicationService ==
== CreatePrivateWirelessCommunicationService ==
No input. Returns an [[#IPrivateWirelessCommunicationService]].
No input. Returns an [[#IPrivateWirelessCommunicationService]].
| 0 || [[#GetFwVersion|GetFwVersion]]
| 0 || [[#GetFwVersion|GetFwVersion]]
|-
|-
| 1 || [[#ChangeRxAntenna|ChangeRxAntenna]]
| 1 || [15.0.0-16.1.0] [[#ChangeRxAntenna|ChangeRxAntenna]]
|-
|-
| 2 ||
| 2 ||
| 12 ||
| 12 ||
|-
|-
| 13 || SwitchTsfTimerFunctionOn
| 13 || EnableTsfTimerFunction
|-
|-
| 14 || SwitchTsfTimerFunctionOff
| 14 || DisableTsfTimerFunction
|-
|-
| 15 || [[#GetDeltaTimeBetweenSystemAndTsf|GetDeltaTimeBetweenSystemAndTsf]]
| 15 || [[#GetDeltaTimeBetweenSystemAndTsf|GetDeltaTimeBetweenSystemAndTsf]]
| 19 ||
| 19 ||
|-
|-
| 20 ||
| 20 || [15.0.0-16.1.0]
|-
|-
| 21 ||
| 21 || [15.0.0-16.1.0]
|-
|-
| 22 ||
| 22 || [15.0.0-16.1.0]
|}
|}
== CreateDriverService ==
== CreateDriverService ==
No input. Returns an [[#ISfDriverService]].
No input. Returns an [[#ISfDriverService]].
! Cmd || Name
! Cmd || Name
|-
|-
| 0 || [[#CreateNetworkInterfaceService]]
| 0 || [[#OpenNetworkInterface]]
|-
|-
| 128 ||
| 128 ||
|}
|}
=== CreateNetworkInterfaceService ===
=== OpenNetworkInterface ===
Takes a type-0x21 input buffer. Returns an [[#ISfNetworkInterfaceService]].
Takes a type-0x21 input buffer. Returns an [[#ISfNetworkInterfaceService]].
| [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
| [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-16.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
| [14.0.0-18.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
|}
|}