Network Component  Version 7.11.0
MDK Middleware for IPv4 and IPv6 Networking
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
NetWiFi: WiFi Interface

Events generated by the Network - WiFi Interface functions. More...

Functions

__STATIC_INLINE void EvrNetWiFi_InitInterface (void)
 Event on WiFi interface initialize (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_DriverInitFailed (void)
 Event on WiFi failed to initialize the driver (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SetBypassModeFailed (void)
 Event on WiFi failed to activate bypass mode (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_GetMacAddressFailed (void)
 Event on WiFi driver get MAC address failed (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_DriverMacAddress (const uint8_t *mac_addr)
 Event on WiFi driver provided MAC address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_MacAddressConfigError (void)
 Event on WiFi MAC address configuration error (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SetMacAddressFailed (void)
 Event on WiFi driver failed to set MAC address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip4ConfigError (void)
 Event on WiFi IPv4 configuration error (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip6ConfigError (void)
 Event on WiFi IPv6 configuration error (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_ThreadCreateFailed (void)
 Event on WiFi thread create failed (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_GetOptionInvalidParameter (void)
 Event on WiFi get_option invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SetOptionInvalidParameter (void)
 Event on WiFi set_option invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SetMacAddress (const uint8_t *mac_addr)
 Event on WiFi set interface MAC address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4Address (const uint8_t *ip4_addr)
 Event on WiFi set interface IPv4 address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4SubnetMask (const uint8_t *net_mask)
 Event on WiFi set interface IPv4 subnet mask (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4DefaultGateway (const uint8_t *ip4_addr)
 Event on WiFi set interface IPv4 default gateway (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4PrimaryDNS (const uint8_t *ip4_addr)
 Event on WiFi set interface primary DNS server (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4SecondaryDNS (const uint8_t *ip4_addr)
 Event on WiFi set interface secondary DNS server (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp4Mtu (uint16_t mtu)
 Event on WiFi set interface MTU (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp6Address (const uint8_t *ip6_addr)
 Event on WiFi set interface IPv6 static address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp6DefaultGateway (const uint8_t *ip6_addr)
 Event on WiFi set interface IPv6 default gateway (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp6PrimaryDNS (const uint8_t *ip6_addr)
 Event on WiFi set interface primary DNS server (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp6SecondaryDNS (const uint8_t *ip6_addr)
 Event on WiFi set interface secondary DNS server (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_SetIp6PrefixLength (uint8_t pref_len)
 Event on WiFi set interface IPv6 subnet prefix length (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_Scan (uint32_t max_num)
 Event on WiFi scan wireless networks (API) More...
 
__STATIC_INLINE void EvrNetWiFi_ScanWrongMode (uint32_t mode)
 Event on WiFi scan in wrong mode (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_ScanInvalidParameter (void)
 Event on WiFi scan invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_ScanComplete (uint32_t num)
 Event on WiFi scan wireless networks complete (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_GetOption (uint32_t opt)
 Event on WiFi get driver option (API) More...
 
__STATIC_INLINE void EvrNetWiFi_SetOption (uint32_t opt)
 Event on WiFi set driver option (API) More...
 
__STATIC_INLINE void EvrNetWiFi_Activate (uint32_t mode)
 Event on WiFi interface activate (API) More...
 
__STATIC_INLINE void EvrNetWiFi_ActivateInvalidParameter (void)
 Event on WiFi activate invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_Deactivate (uint32_t mode)
 Event on WiFi interface deactivate (API) More...
 
__STATIC_INLINE void EvrNetWiFi_DeactivateInvalidParam (void)
 Event on WiFi deactivate invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_GetNetInfo (void)
 Event on WiFi get network information (API) More...
 
__STATIC_INLINE void EvrNetWiFi_GetNetInfoWrongMode (uint32_t mode)
 Event on WiFi get network information in wrong mode (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_GetNetInfoInvalidParam (void)
 Event on WiFi get network information invalid parameter (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SendFrame (uint32_t length, uint8_t ip_version)
 Event on WiFi send frame (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_NotConnected (void)
 Event on WiFi station not connected (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_SendDataTooLarge (uint32_t length, uint32_t max_length)
 Event on WiFi send payload too large error (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip4LocalAddressUndefined (void)
 Event on WiFi local IPv4 address undefined (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip4MacAddressUnresolved (const uint8_t *ip4_addr)
 Event on WiFi MAC address unresolved (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_EnqueueFrame (uint32_t ca_entry, uint32_t length)
 Event on enqueued WiFi frame for unresolved MAC address (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip6LocalAddressUndefined (void)
 Event on WiFi local IPv6 address undefined (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip6MacAddressUnresolved (const uint8_t *ip6_addr)
 Event on WiFi MAC address unresolved (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_InvalidIpVersion (uint8_t ip_version)
 Event on WiFi invalid IP version (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_ShowFrameHeader (const void *eth_header)
 Event on WiFi display send/receive frame header (Detail) More...
 
__STATIC_INLINE void EvrNetWiFi_LinkStateChange (uint32_t state)
 Event on WiFi connection state change (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_ReceiveFrame (uint32_t length)
 Event on WiFi receive frame (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip4Disabled (void)
 Event on WiFi receive IPv4 disabled (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_Ip6Disabled (void)
 Event on WiFi receive IPv6 disabled (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_ProtocolUnknown (uint16_t protocol)
 Event on WiFi receive protocol unknown (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_OutputLowLevel (uint32_t length)
 Event on WiFi output frame (Op) More...
 
__STATIC_INLINE void EvrNetWiFi_TxQueueOverflow (void)
 Event on WiFi output queue overflow (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_OutputNoMemory (void)
 Event on WIFI output out of memory (Error) More...
 
__STATIC_INLINE void EvrNetWiFi_UninitInterface (void)
 Event on WiFi interface de-initialize (Op) More...
 

Description

Events generated by the Network - WiFi Interface functions.

The Network WiFi Interface functions generate events that inform about events in the WiFi interface and help in troubleshooting.

WiFi Interface uses bypass or transparent mode. In this mode, the ethernet frames are exchanged.

Function Documentation

__STATIC_INLINE void EvrNetWiFi_Activate ( uint32_t  mode)

Event on WiFi interface activate (API)

Parameters
modeWiFi interface mode
  • 0: Station
  • 1: Access Point

The event Activate is created when the function netWiFi_Activate is executed.

Value in the Event Recorder shows:

  • mode: WiFi interface operating mode (Station, AP).
__STATIC_INLINE void EvrNetWiFi_ActivateInvalidParameter ( void  )

Event on WiFi activate invalid parameter (Error)

The event ActivateInvalidParameter is created when invalid input parameter is provided for the netWiFi_Activate function.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_Deactivate ( uint32_t  mode)

Event on WiFi interface deactivate (API)

Parameters
modeWiFi interface mode
  • 0: Station
  • 1: Access Point

The event Deactivate is created when the function netWiFi_Deactivate is executed.

Value in the Event Recorder shows:

  • mode: WiFi interface operating mode (Station, AP).
__STATIC_INLINE void EvrNetWiFi_DeactivateInvalidParam ( void  )

Event on WiFi deactivate invalid parameter (Error)

The event DeactivateInvalidParam is created when invalid input parameter is provided for the netWiFi_Deactivate function.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_DriverInitFailed ( void  )

Event on WiFi failed to initialize the driver (Error)

The event DriverInitFailed is created when the WiFi interface fails to initialize and turn on the WiFi driver due to an internal error in the WiFi driver. The event is generated when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • driver
__STATIC_INLINE void EvrNetWiFi_DriverMacAddress ( const uint8_t *  mac_addr)

Event on WiFi driver provided MAC address (Op)

Parameters
mac_addrpointer to MAC address

The event DriverMacAddress is created when the MAC address for the WiFi interface is available in the driver. The MAC address is read-only and can not be changed from the user application. The event is generated when the function netInitialize is executed.

Value in the Event Recorder shows:

  • mac: MAC address retrieved from the driver.
__STATIC_INLINE void EvrNetWiFi_EnqueueFrame ( uint32_t  ca_entry,
uint32_t  length 
)

Event on enqueued WiFi frame for unresolved MAC address (Op)

Parameters
ca_entrycache entry identifier
lengthframe length in bytes

The event EnqueueFrame is created when the internal send_frame function wants to send the frame to the local network, but the destination MAC address is not resolved. The ARP or NDP address resolver starts and enqueues the frame. When the address resolver completes, enqueued frames are sent to resolved destination MAC address.

Value in the Event Recorder shows:

  • ca_entry: ARP/NDP cache entry identifier.
  • len: length of the queued frame in bytes.
__STATIC_INLINE void EvrNetWiFi_GetMacAddressFailed ( void  )

Event on WiFi driver get MAC address failed (Error)

The event GetMacAddressFailed is created when the the WiFi interface failed to retrieve the MAC address while the WiFi interface is initializing. The MAC address is available in the WiFi module, but can not be retrieved. The event is generated when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • driver
__STATIC_INLINE void EvrNetWiFi_GetNetInfo ( void  )

Event on WiFi get network information (API)

The event GetNetInfo is created when the function netWiFi_GetNetInfo is executed.

Value in the Event Recorder shows:

  • driver
__STATIC_INLINE void EvrNetWiFi_GetNetInfoInvalidParam ( void  )

Event on WiFi get network information invalid parameter (Error)

The event GetNetInfoInvalidParam is created when invalid input parameter is provided for the netWiFi_GetNetInfo function.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_GetNetInfoWrongMode ( uint32_t  mode)

Event on WiFi get network information in wrong mode (Error)

Parameters
modeWiFi interface mode
  • 0: Station
  • 1: Access Point

The event GetNetInfoWrongMode is created when the function netWiFi_GetNetInfo is executed in WiFi Access Point mode.

Value in the Event Recorder shows:

  • mode: WiFi interface operating mode (Station, AP).
__STATIC_INLINE void EvrNetWiFi_GetOption ( uint32_t  opt)

Event on WiFi get driver option (API)

Parameters
optWiFi driver option to get

The event GetOption is created when the function netWiFi_GetOption is executed.

Value in the Event Recorder shows:

  • opt: option to retrieve from the WiFi driver.
__STATIC_INLINE void EvrNetWiFi_GetOptionInvalidParameter ( void  )

Event on WiFi get_option invalid parameter (Error)

The event GetOptionInvalidParameter is created, when invalid input parameter is provided for the internal get_option function. This happens when the function netIF_GetOption for the WiFi interface or the control function of the driver netWiFi_GetOption is executed.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_InitInterface ( void  )

Event on WiFi interface initialize (Op)

The event InitInterface is created when the WiFi interface is initialized, that is, when the function netInitialize is executed.

Value in the Event Recorder shows:

  • wifi: WiFi interface name.
__STATIC_INLINE void EvrNetWiFi_InvalidIpVersion ( uint8_t  ip_version)

Event on WiFi invalid IP version (Error)

Parameters
ip_versioninvalid IP protocol version value
  • 0: IPv4
  • 1: IPv6

The event InvalidIpVersion is created when the internal send_frame function wants to send the frame, but the requested Internet Protocol version is not recognized. This might happen when the requested IP protocol version is IPv6, but the Network Component library that is used supports IPv4 only.

Value in the Event Recorder shows:

  • ver: requested IP protocol version.
__STATIC_INLINE void EvrNetWiFi_Ip4ConfigError ( void  )

Event on WiFi IPv4 configuration error (Error)

The event Ip4ConfigError is created when an error is found in IPv4 configuration for the WiFi interface.

The error is in one of the following configurations:

  • IP Address
  • Subnet mask
  • Default Gateway
  • Primary DNS Server
  • Secondary DNS Server

The event is created when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • ip4
__STATIC_INLINE void EvrNetWiFi_Ip4Disabled ( void  )

Event on WiFi receive IPv4 disabled (Op)

The event Ip4Disabled is created when the network library receives the WiFi frame with protocol type ARP or IPv4, but IPv4 protocol is disabled in the WiFi interface configuration.

Value in the Event Recorder shows:

  • discard
__STATIC_INLINE void EvrNetWiFi_Ip4LocalAddressUndefined ( void  )

Event on WiFi local IPv4 address undefined (Error)

The event Ip4LocalAddressUndefined is created when the internal send_frame function wants to send the unicast frame, but the local IP address is not valid. This usually happens when the DHCP client does not yet assign the IP address.

Value in the Event Recorder shows:

  • addr: 0.0.0.0 (undefined address).
__STATIC_INLINE void EvrNetWiFi_Ip4MacAddressUnresolved ( const uint8_t *  ip4_addr)

Event on WiFi MAC address unresolved (Error)

Parameters
ip4_addrpointer to IPv4 destination address

The event Ip4MacAddressUnresolved is created when the internal send_frame function wants to send the frame, but the destination MAC address is not resolved. This usually happens when the destination IP address is external and the gateway is not reachable.

Value in the Event Recorder shows:

  • dst_addr: destination IPv4 address to send to.
__STATIC_INLINE void EvrNetWiFi_Ip6ConfigError ( void  )

Event on WiFi IPv6 configuration error (Error)

The event Ip6ConfigError is created when an error is found in IPv6 configuration for the WiFi interface.

The error is in one of the following configurations:

  • IPv6 Address
  • Default Gateway
  • Primary DNS Server
  • Secondary DNS Server

The event is created when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • ip6
__STATIC_INLINE void EvrNetWiFi_Ip6Disabled ( void  )

Event on WiFi receive IPv6 disabled (Op)

The event Ip6Disabled is created when the network library receives the WiFi frame with protocol type IPv6, but IPv6 protocol is disabled in the WiFi interface configuration.

Value in the Event Recorder shows:

  • discard
__STATIC_INLINE void EvrNetWiFi_Ip6LocalAddressUndefined ( void  )

Event on WiFi local IPv6 address undefined (Error)

The event Ip6LocalAddressUndefined is created when the internal send_frame function wants to send the unicast frame, but the local IPv6 address is not valid. This usually happens when the DHCPv6 client does not yet assign the IPv6 address.

Value in the Event Recorder shows:

  • addr: 0:0:0:0:0:0:0:0 (undefined address).
__STATIC_INLINE void EvrNetWiFi_Ip6MacAddressUnresolved ( const uint8_t *  ip6_addr)

Event on WiFi MAC address unresolved (Error)

Parameters
ip6_addrpointer to IPv6 destination address

The event Ip6MacAddressUnresolved is created when the internal send_frame function wants to send the frame, but the destination MAC address is not resolved. This happens when the Neighbor Discovery is in progress for the on-link destination IPv6 address or when the gateway is not reachable for external IPv6 address.

Value in the Event Recorder shows:

  • dst_addr: destination IPv6 address to send to.
__STATIC_INLINE void EvrNetWiFi_LinkStateChange ( uint32_t  state)

Event on WiFi connection state change (Op)

Parameters
statewireless station connection state
  • 0: disconnected
  • 1: connected to Access Point

The event LinkStateChange is created when the network library detects a change in the state of the WiFi connection that is connected or disconnected.

Value in the Event Recorder shows:

  • wifi: connection state (Connected, Disconnected).
__STATIC_INLINE void EvrNetWiFi_MacAddressConfigError ( void  )

Event on WiFi MAC address configuration error (Error)

The event MacAddressConfigError is created when an error is found in the WiFi MAC configuration while the WiFi interface is initializing. The event is generated when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_NotConnected ( void  )

Event on WiFi station not connected (Error)

The event NotConnected is created when the network library wants to send the frame on the WiFi interface, but the wireless station is not connected.

Value in the Event Recorder shows:

  • no-link
__STATIC_INLINE void EvrNetWiFi_OutputLowLevel ( uint32_t  length)

Event on WiFi output frame (Op)

Parameters
lengthframe length in bytes

The event OutputLowLevel is created when the WiFi interface wants to pass a frame to the WiFi driver.

Value in the Event Recorder shows:

  • len: length of the frame in bytes.
__STATIC_INLINE void EvrNetWiFi_OutputNoMemory ( void  )

Event on WIFI output out of memory (Error)

The event OutputNoMemory is created when the network library wants to pass the frame to the WiFi interface, but the available memory is exhausted. Therefore, the frame is not sent.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_ProtocolUnknown ( uint16_t  protocol)

Event on WiFi receive protocol unknown (Op)

Parameters
protocolunknown ethernet protocol type

The event ProtocolUnknown is created when the network library receives a WiFi frame, but the received ethernet protocol type is not recognized.

Value in the Event Recorder shows:

  • proto: received ethernet protocol type.
__STATIC_INLINE void EvrNetWiFi_ReceiveFrame ( uint32_t  length)

Event on WiFi receive frame (Op)

Parameters
lengthframe length in bytes

The event ReceiveFrame is created when the network library receives the WiFi frame.

Value in the Event Recorder shows:

  • len: length of the received WiFi frame in bytes.
__STATIC_INLINE void EvrNetWiFi_Scan ( uint32_t  max_num)

Event on WiFi scan wireless networks (API)

Parameters
max_nummaximum number of networks to scan

The event Scan is created when the function netWiFi_Scan is executed.

Value in the Event Recorder shows:

  • max: maximum number of wireless networks to scan.
__STATIC_INLINE void EvrNetWiFi_ScanComplete ( uint32_t  num)

Event on WiFi scan wireless networks complete (Op)

Parameters
numnumber of wireless networks found

The event ScanComplete is created when execution the function netWiFi_Scan is complete.

Value in the Event Recorder shows:

  • num: number of available wireless networks found.
__STATIC_INLINE void EvrNetWiFi_ScanInvalidParameter ( void  )

Event on WiFi scan invalid parameter (Error)

The event ScanInvalidParameter is created when invalid input parameter is provided for the netWiFi_Scan function.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_ScanWrongMode ( uint32_t  mode)

Event on WiFi scan in wrong mode (Error)

Parameters
modeWiFi interface mode
  • 0: Station
  • 1: Access Point

The event ScanWrongMode is created when the function netWiFi_Scan is executed in WiFi Access Point mode.

Value in the Event Recorder shows:

  • mode: WiFi interface operating mode (Station, AP).
__STATIC_INLINE void EvrNetWiFi_SendDataTooLarge ( uint32_t  length,
uint32_t  max_length 
)

Event on WiFi send payload too large error (Error)

Parameters
lengthdata length in bytes
max_lengthmaximum length of data in bytes

The event SendDataTooLarge is created when the length of the data to send is larger than the WiFi MTU (1500 bytes).

Value in the Event Recorder shows:

  • len: length of the data to send in bytes.
  • max: maximum allowed data length in bytes.
__STATIC_INLINE void EvrNetWiFi_SendFrame ( uint32_t  length,
uint8_t  ip_version 
)

Event on WiFi send frame (Op)

Parameters
lengthframe length in bytes
ip_versioninternet protocol version
  • 0: IPv4
  • 1: IPv6

The event SendFrame is created when the ethernet frame header is constructed for the frame and the data is sent to the WiFi driver.

Value in the Event Recorder shows:

  • len: length of the ethernet frame payload.
  • ver: IP protocol version (IPv4, IPv6).
__STATIC_INLINE void EvrNetWiFi_SetBypassModeFailed ( void  )

Event on WiFi failed to activate bypass mode (Error)

The event SetBypassModeFailed is created when the WiFi interface failed to initialize the WiFi driver in bypass mode, because the requested features are not supported in the driver. The event is generated when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • driver
__STATIC_INLINE void EvrNetWiFi_SetIp4Address ( const uint8_t *  ip4_addr)

Event on WiFi set interface IPv4 address (Op)

Parameters
ip4_addrpointer to IPv4 address

The event SetIp4Address is created when the static IPv4 address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • ip: static IPv4 address to be set.
__STATIC_INLINE void EvrNetWiFi_SetIp4DefaultGateway ( const uint8_t *  ip4_addr)

Event on WiFi set interface IPv4 default gateway (Op)

Parameters
ip4_addrpointer to IPv4 address of a gateway

The event SetIp4DefaultGateway is created when IPv4 default gateway address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • gw: IPv4 address of default gateway.
__STATIC_INLINE void EvrNetWiFi_SetIp4Mtu ( uint16_t  mtu)

Event on WiFi set interface MTU (Op)

Parameters
mtumaximum transmission unit
  • 0: fragmentation disabled
Remarks
MTU is limited in the range from 576 to 1500 bytes.

The event SetIp4Mtu is created when the Maximum Transmission Unit is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • mtu: IPv4 MTU to be set.
__STATIC_INLINE void EvrNetWiFi_SetIp4PrimaryDNS ( const uint8_t *  ip4_addr)

Event on WiFi set interface primary DNS server (Op)

Parameters
ip4_addrpointer to IPv4 address of a DNS server

The event SetIp4PrimaryDNS is created when IPv4 primary DNS server address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • pri_dns: IPv4 address of the primary DNS server.
__STATIC_INLINE void EvrNetWiFi_SetIp4SecondaryDNS ( const uint8_t *  ip4_addr)

Event on WiFi set interface secondary DNS server (Op)

Parameters
ip4_addrpointer to IPv4 address of a DNS server

The event SetIp4SecondaryDNS is created when IPv4 secondary DNS server address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • sec_dns: IPv4 address of the secondary DNS server.
__STATIC_INLINE void EvrNetWiFi_SetIp4SubnetMask ( const uint8_t *  net_mask)

Event on WiFi set interface IPv4 subnet mask (Op)

Parameters
net_maskpointer to IPv4 subnet mask

The event SetIp4SubnetMask is created when IPv4 subnet mask is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • mask: IPv4 subnet mask to be set.
__STATIC_INLINE void EvrNetWiFi_SetIp6Address ( const uint8_t *  ip6_addr)

Event on WiFi set interface IPv6 static address (Op)

Parameters
ip6_addrpointer to IPv6 address

The event SetIp6Address is created when the static IPv6 address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • ip: static IPv6 address to be set.
__STATIC_INLINE void EvrNetWiFi_SetIp6DefaultGateway ( const uint8_t *  ip6_addr)

Event on WiFi set interface IPv6 default gateway (Op)

Parameters
ip6_addrpointer to IPv6 address of a gateway

The event SetIp6DefaultGateway is created when IPv6 default gateway address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • gw: IPv6 address of default gateway.
__STATIC_INLINE void EvrNetWiFi_SetIp6PrefixLength ( uint8_t  pref_len)

Event on WiFi set interface IPv6 subnet prefix length (Op)

Parameters
pref_lensubnet prefix length

The event SetIp6PrefixLength is created when the IPv6 subnet prefix length is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • pref_len: IPv6 prefix length to be set.
__STATIC_INLINE void EvrNetWiFi_SetIp6PrimaryDNS ( const uint8_t *  ip6_addr)

Event on WiFi set interface primary DNS server (Op)

Parameters
ip6_addrpointer to IPv6 address of a DNS server

The event SetIp6PrimaryDNS is created when IPv6 primary DNS server address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • pri_dns: IPv6 address of the primary DNS server.
__STATIC_INLINE void EvrNetWiFi_SetIp6SecondaryDNS ( const uint8_t *  ip6_addr)

Event on WiFi set interface secondary DNS server (Op)

Parameters
ip6_addrpointer to IPv6 address of a DNS server

The event SetIp6SecondaryDNS is created when IPv6 secondary DNS server address is set for the WiFi interface. This happens when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • sec_dns: IPv6 address of the secondary DNS server.
__STATIC_INLINE void EvrNetWiFi_SetMacAddress ( const uint8_t *  mac_addr)

Event on WiFi set interface MAC address (Op)

Parameters
mac_addrpointer to MAC address

The event SetMacAddress is created when the MAC address for the WiFi interface is set in the driver. This happens when the WiFi interface is initialized or when the function netIF_SetOption for the WiFi interface is executed.

Value in the Event Recorder shows:

  • mac: MAC address to be set.
__STATIC_INLINE void EvrNetWiFi_SetMacAddressFailed ( void  )

Event on WiFi driver failed to set MAC address (Op)

The event SetMacAddressFailed is created when the WiFi interface failed to set the MAC address while the WiFi interface is initializing. The MAC address that is configured in the WiFi configuration can not be set up in the WiFi module. The event is generated when the function netInitialize is executed and is a critical failure.

Value in the Event Recorder shows:

  • driver
__STATIC_INLINE void EvrNetWiFi_SetOption ( uint32_t  opt)

Event on WiFi set driver option (API)

Parameters
optWiFi driver option to set

The event SetOption is created when the function netWiFi_SetOption is executed.

Value in the Event Recorder shows:

  • opt: option to set in the WiFi driver.
__STATIC_INLINE void EvrNetWiFi_SetOptionInvalidParameter ( void  )

Event on WiFi set_option invalid parameter (Error)

The event SetOptionInvalidParameter is created, when invalid input parameter is provided for the internal set_option function. This happens when the function netIF_SetOption for the WiFi interface or the control function of the driver netWiFi_SetOption is executed.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_ShowFrameHeader ( const void *  eth_header)

Event on WiFi display send/receive frame header (Detail)

Parameters
eth_headerpointer to ethernet frame header of 14 bytes
  • DstAddr (6 bytes)
  • SrcAddr (6 bytes)
  • Protocol (2 bytes)

The event ShowFrameHeader is created when the network library wants to display detailed information about the ethernet header.

Value in the Event Recorder shows:

  • dst: destination MAC address.
  • src: source MAC address.
  • proto: protocol type (ARP, IPv4, IPv6).
__STATIC_INLINE void EvrNetWiFi_ThreadCreateFailed ( void  )

Event on WiFi thread create failed (Error)

The event ThreadCreateFailed is generated, if the function netInitialize failed to create the WiFi interface thread.

Value in the Event Recorder shows:

  • thread: netWiFi_Thread.
__STATIC_INLINE void EvrNetWiFi_TxQueueOverflow ( void  )

Event on WiFi output queue overflow (Error)

The event TxQueueOverflow is created when the network library wants to pass the frame to the WiFi interface, but the interface transmit queue is filled. Therefore, the frame is not sent.

Value in the Event Recorder shows:

  • error
__STATIC_INLINE void EvrNetWiFi_UninitInterface ( void  )

Event on WiFi interface de-initialize (Op)

The event UninitInterface is created when the function netUninitialize is executed.

Value in the Event Recorder shows:

  • wifi: WiFi interface name.