From 690256b98201da6c62bf17e05f4a640d36f05ce5 Mon Sep 17 00:00:00 2001
From: Konstantin Kondrashov <konstantin@espressif.com>
Date: Tue, 17 Feb 2026 16:21:38 +0200
Subject: [PATCH 1/2] fix(doc): Update MAC-address related documentation for
 ESP32-P4

Closes https://github.com/espressif/esp-idf/issues/18159
---
 .../esp_hw_support/port/esp32p4/Kconfig.mac     |  5 ++---
 .../en/api-reference/system/misc_system_api.rst | 17 ++++++++++++++++-
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/components/esp_hw_support/port/esp32p4/Kconfig.mac b/components/esp_hw_support/port/esp32p4/Kconfig.mac
index f998e2a5f6..4a66253788 100644
--- a/components/esp_hw_support/port/esp32p4/Kconfig.mac
+++ b/components/esp_hw_support/port/esp32p4/Kconfig.mac
@@ -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"
diff --git a/docs/en/api-reference/system/misc_system_api.rst b/docs/en/api-reference/system/misc_system_api.rst
index 1b0475966a..b9c7a7405d 100644
--- a/docs/en/api-reference/system/misc_system_api.rst
+++ b/docs/en/api-reference/system/misc_system_api.rst
@@ -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

From e8618a531b6dd760d544a641161c636c4d92a368 Mon Sep 17 00:00:00 2001
From: Shen Mengjing <shenmengjing@espressif.com>
Date: Tue, 24 Feb 2026 19:08:36 +0800
Subject: [PATCH 2/2] docs: Update CN translation for misc_system_api.rst

---
 .../api-reference/system/misc_system_api.rst    | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/zh_CN/api-reference/system/misc_system_api.rst b/docs/zh_CN/api-reference/system/misc_system_api.rst
index 90c6fbd71e..ae03920f99 100644
--- a/docs/zh_CN/api-reference/system/misc_system_api.rst
+++ b/docs/zh_CN/api-reference/system/misc_system_api.rst
@@ -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