Configure Secure Link Layer. More...

#include <sl_wfx_general_api.h>

Public Attributes
uint8_t	encr_bmp [SL_WFX_ENCR_BMP_SIZE]
	Encryption bitmap.

uint32_t	disable_session_key_protection
	Force the firmware to authorize the use of the same session key during a complete power cycle, even very long. NOT RECOMMENDED.

Detailed Description

Configure Secure Link Layer.

This API can be used to:

Set/update the Secure Link encryption bitmap
Disable Session Key Protection

About the Session Key protection: SecureLink underlying encryption algorithm is AES CCM. This algorithm is using an internal Nonce counter incremented each time a message is encrypted/decrypted. This counter is not supposed to go beyond a given limit to guarantee AES CCM security properties. This is why Host Driver is responsible for renegotiating the session key once the message counter is approaching the limit. Disabling the Session Key protection will disable the check performed by the firmware that the Nonce counter is crossing the limit, allowing Host Driver to use the same session key during the same power cycle, even during a very long time. This behavior is not recommended.

To disable the protection, a given magic word (SL_WFX_SESSION_KEY_PROTECTION_DISABLE_MAGIC) must be provided as DisableSessionKeyProtection parameter value. Any other value will let the protection set.

Note: When SecureLink is activated, SL Configure API must be called right after the key exchange. Issuing another command instead will result in an error.; It is not recommended to call this API a second time during the same power cycle.

The documentation for this struct was generated from the following file:

/build/modules/rtos/modules/drivers/wifi/sl_wf200/thirdparty/wfx-fullMAC-driver/wfx_fmac_driver/firmware/sl_wfx_general_api.h

Public Attributes

Detailed Description