esp_mac.h File Reference

ESP-IDF MAC-address-type compatibility for the esp-hosted port. More...

#include <stdint.h>

Include dependency graph for esp_mac.h:

Go to the source code of this file.

Enumerations
enum	esp_mac_type_t : uint8_t {   ESP_MAC_WIFI_STA = 0U ,   ESP_MAC_WIFI_SOFTAP = 1U ,   ESP_MAC_BT = 2U ,   ESP_MAC_ETH = 3U ,   ESP_MAC_IEEE802154 = 4U ,   ESP_MAC_BASE = 5U ,   ESP_MAC_EFUSE_FACTORY = 6U ,   ESP_MAC_EFUSE_CUSTOM = 7U ,   ESP_MAC_EFUSE_EXT = 8U }
	Which of the co-processor's MAC addresses an operation refers to. More...

Detailed Description

ESP-IDF MAC-address-type compatibility for the esp-hosted port.

Tag

[Ring 4 / PORT] {World: NS}

host/esp_hosted_misc.h declares three entry points that read and write the co-processor's interface MAC addresses, and each takes an esp_mac_type_t saying which of the C6's several addresses is meant. That type is an ESP-IDF one, so it is supplied here.

The values are not incidental: they cross the SPI link inside RPC requests and are interpreted by the co-processor firmware, which is built from ESP-IDF v5.5.4. Renumbering them would compile cleanly and then address the wrong interface on the far end, so the upstream ordering is reproduced exactly.

Copyright

Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since

0.1.0

Definition in file esp_mac.h.

Enumeration Type Documentation

esp_mac_type_t

enum esp_mac_type_t : uint8_t

Which of the co-processor's MAC addresses an operation refers to.

The ESP32-C6 derives several interface addresses from one base address in efuse. The enumerator spellings and ordering are fixed by ESP-IDF and are what the co-processor firmware decodes, so they do not follow the project's k_ prefix convention.

Invariant

The ordering matches ESP-IDF v5.5.4, which is the version the co-processor image is built from.

Example:

uint8_t mac[6] = {};
(void)esp_hosted_iface_mac_addr_get(mac, sizeof(mac), ESP_MAC_WIFI_STA);

See also

esp_hosted_iface_mac_addr_get

Since

0.1.0

Enumerator
ESP_MAC_WIFI_STA	Wi-Fi station interface.
ESP_MAC_WIFI_SOFTAP	Wi-Fi soft access-point interface.
ESP_MAC_BT	Bluetooth interface.
ESP_MAC_ETH	Wired Ethernet interface.
ESP_MAC_IEEE802154	802.15.4 radio, an EUI-64.
ESP_MAC_BASE	The efuse base address.
ESP_MAC_EFUSE_FACTORY	Factory-programmed address.
ESP_MAC_EFUSE_CUSTOM	Customer-programmed address.
ESP_MAC_EFUSE_EXT	Extension address block.

Definition at line 51 of file esp_mac.h.