esp_wifi_set_mac() function

Set MAC address of WiFi station, soft-AP or NAN interface. @attention 1. This API can only be called when the interface is disabled @attention 2. Above mentioned interfaces have different MAC addresses, do not set them to be the same. @attention 3. The bit 0 of the first byte of MAC address can not be 1. For example, the MAC address can set to be "1a:XX:XX:XX:XX:XX", but can not be "15:XX:XX:XX:XX:XX".

Syntax

Show:

Summary

Declaration

from esp_wifi.h:859

esp_err_t esp_wifi_set_mac(wifi_interface_t ifx, const uint8_t mac[6]);

Arguments

Argument

Declared as

Description

ifx

wifi_interface_t

interface

mac

const uint8_t[6]

the MAC address

Return value

- ESP_OK: succeed - ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init - ESP_ERR_INVALID_ARG: invalid argument - ESP_ERR_WIFI_IF: invalid interface - ESP_ERR_WIFI_MAC: invalid mac address - ESP_ERR_WIFI_MODE: WiFi mode is wrong - others: refer to error codes in esp_err.h

Examples

esp_wifi_set_mac() is referenced by 1 libraries and example projects:

References

from examples

esp_wifi_set_mac() function

Syntax

Arguments

Return value

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle