Merge branch 'doc/mac_doc_update_esp32p4' into 'master'

fix(doc): Update MAC-address related documentation for ESP32-P4

Closes IDFGH-17141

See merge request espressif/esp-idf!45933
This commit is contained in:
Konstantin Kondrashov
2026-03-11 03:31:14 +02:00
3 changed files with 34 additions and 5 deletions
@@ -10,9 +10,8 @@ choice ESP32P4_UNIVERSAL_MAC_ADDRESSES
If the number of universal MAC addresses is one, only Ethernet interface receives a universally
administered MAC address. It's generated by adding 0 to the base MAC address.
When using the default (Espressif-assigned) base MAC address, either setting can be used. When using
a custom universal MAC address range, the correct setting will depend on the allocation of MAC
addresses in this range.
On ESP32-P4 this value is fixed to one, because only Ethernet receives a universally administered
MAC address.
config ESP32P4_UNIVERSAL_MAC_ADDRESSES_ONE
bool "One"
@@ -39,7 +39,22 @@ To fetch the MAC address for a specific network interface (e.g., Wi-Fi, Bluetoot
In ESP-IDF, the MAC addresses for the various network interfaces are calculated from a single **base MAC address**. By default, the Espressif base MAC address is used. This base MAC address is pre-programmed into the {IDF_TARGET_NAME} eFuse in the factory during production.
.. only:: not esp32s2
.. only:: esp32p4
.. list-table::
:widths: 20 80
:header-rows: 1
* - Interface
- MAC Address (1 universally administered, default)
* - Ethernet
- base_mac
.. note::
On ESP32-P4, :ref:`CONFIG_{IDF_TARGET_CFG_PREFIX}_UNIVERSAL_MAC_ADDRESSES` is fixed to one universally administered MAC address.
.. only:: (not esp32s2) and (not esp32p4)
.. list-table::
:widths: 20 40 40
@@ -39,7 +39,22 @@ MAC 地址
在 ESP-IDF 中,各个网络接口的 MAC 地址是根据单个 **基准 MAC 地址 (Base MAC address)** 计算出来的。默认情况下使用乐鑫指定的基准 MAC 地址,该基准地址在产品生产过程中已预烧录至 {IDF_TARGET_NAME} eFuse。
.. only:: not esp32s2
.. only:: esp32p4
.. list-table::
:widths: 20 80
:header-rows: 1
* - 接口
- MAC 地址(一个默认的通用管理地址)
* - 以太网
- base_mac
.. note::
在 ESP32-P4 上,:ref:`CONFIG_{IDF_TARGET_CFG_PREFIX}_UNIVERSAL_MAC_ADDRESSES` 固定为单个通用管理型 MAC 地址。
.. only:: (not esp32s2) and (not esp32p4)
.. list-table::
:widths: 20 40 40