Feature/esp efuse support

Documentation/platforms/risc-v/esp32c3/boards/esp32c3-generic/index.rst

@@ -142,6 +142,43 @@ disables the NuttShell to get the best possible score.
 .. note:: As the NSH is disabled, the application will start as soon as the
   system is turned on.
 
+efuse
+-----
+
+This configuration demonstrates the use of the eFuse driver. It can be accessed
+through the ``/dev/efuse`` device file.
+Virtual eFuse mode can be used by enabling `CONFIG_ESPRESSIF_EFUSE_VIRTUAL`
+option to prevent possible damages on chip.
+
+The following snippet demonstrates how to read MAC address:
+
+.. code-block:: C
+
+   int fd;
+   int ret;
+   uint8_t mac[6];
+   struct efuse_param_s param;
+   struct efuse_desc_s mac_addr =
+   {
+     .bit_offset = 1,
+     .bit_count = 48
+   };
+
+   const efuse_desc_t* desc[] =
+   {
+       &mac_addr,
+       NULL
+   };
+   param.field = desc;
+   param.size = 48;
+   param.data = mac;
+
+   fd = open("/dev/efuse", O_RDONLY);
+   ret = ioctl(fd, EFUSEIOC_READ_FIELD, &param);
+
+To find offset and count variables for related eFuse,
+please refer to Espressif's Technical Reference Manuals.
+
 gpio
 ----
 

Documentation/platforms/risc-v/esp32c3/index.rst

@@ -291,7 +291,7 @@ Bluetooth    No
 CAN/TWAI     Yes
 CDC Console  Yes    Rev.3
 DMA          Yes
-eFuse        No
+eFuse        Yes    Also virtual mode supported
 GPIO         Yes
 I2C          Yes
 LED_PWM      Yes

Documentation/platforms/risc-v/esp32c6/boards/esp32c6-devkitc/index.rst

@@ -125,6 +125,43 @@ disables the NuttShell to get the best possible score.
 .. note:: As the NSH is disabled, the application will start as soon as the
   system is turned on.
 
+efuse
+-----
+
+This configuration demonstrates the use of the eFuse driver. It can be accessed
+through the ``/dev/efuse`` device file.
+Virtual eFuse mode can be used by enabling `CONFIG_ESPRESSIF_EFUSE_VIRTUAL`
+option to prevent possible damages on chip.
+
+The following snippet demonstrates how to read MAC address:
+
+.. code-block:: C
+
+   int fd;
+   int ret;
+   uint8_t mac[6];
+   struct efuse_param_s param;
+   struct efuse_desc_s mac_addr =
+   {
+     .bit_offset = 1,
+     .bit_count = 48
+   };
+
+   const efuse_desc_t* desc[] =
+   {
+       &mac_addr,
+       NULL
+   };
+   param.field = desc;
+   param.size = 48;
+   param.data = mac;
+
+   fd = open("/dev/efuse", O_RDONLY);
+   ret = ioctl(fd, EFUSEIOC_READ_FIELD, &param);
+
+To find offset and count variables for related eFuse,
+please refer to Espressif's Technical Reference Manuals.
+
 gpio
 ----
 

Documentation/platforms/risc-v/esp32c6/boards/esp32c6-devkitm/index.rst

@@ -109,6 +109,43 @@ disables the NuttShell to get the best possible score.
 .. note:: As the NSH is disabled, the application will start as soon as the
   system is turned on.
 
+efuse
+-----
+
+This configuration demonstrates the use of the eFuse driver. It can be accessed
+through the ``/dev/efuse`` device file.
+Virtual eFuse mode can be used by enabling `CONFIG_ESPRESSIF_EFUSE_VIRTUAL`
+option to prevent possible damages on chip.
+
+The following snippet demonstrates how to read MAC address:
+
+.. code-block:: C
+
+   int fd;
+   int ret;
+   uint8_t mac[6];
+   struct efuse_param_s param;
+   struct efuse_desc_s mac_addr =
+   {
+     .bit_offset = 1,
+     .bit_count = 48
+   };
+
+   const efuse_desc_t* desc[] =
+   {
+       &mac_addr,
+       NULL
+   };
+   param.field = desc;
+   param.size = 48;
+   param.data = mac;
+
+   fd = open("/dev/efuse", O_RDONLY);
+   ret = ioctl(fd, EFUSEIOC_READ_FIELD, &param);
+
+To find offset and count variables for related eFuse,
+please refer to Espressif's Technical Reference Manuals.
+
 gpio
 ----
 

Documentation/platforms/risc-v/esp32c6/index.rst

@@ -278,7 +278,7 @@ Bluetooth        No
 CAN/TWAI         Yes
 DMA              Yes
 ECC              No
-eFuse            No
+eFuse            Yes
 GPIO             Yes
 HMAC             No
 I2C              Yes

Documentation/platforms/risc-v/esp32h2/boards/esp32h2-devkit/index.rst

@@ -108,6 +108,43 @@ disables the NuttShell to get the best possible score.
 .. note:: As the NSH is disabled, the application will start as soon as the
   system is turned on.
 
+efuse
+-----
+
+This configuration demonstrates the use of the eFuse driver. It can be accessed
+through the ``/dev/efuse`` device file.
+Virtual eFuse mode can be used by enabling `CONFIG_ESPRESSIF_EFUSE_VIRTUAL`
+option to prevent possible damages on chip.
+
+The following snippet demonstrates how to read MAC address:
+
+.. code-block:: C
+
+   int fd;
+   int ret;
+   uint8_t mac[6];
+   struct efuse_param_s param;
+   struct efuse_desc_s mac_addr =
+   {
+     .bit_offset = 1,
+     .bit_count = 48
+   };
+
+   const efuse_desc_t* desc[] =
+   {
+       &mac_addr,
+       NULL
+   };
+   param.field = desc;
+   param.size = 48;
+   param.data = mac;
+
+   fd = open("/dev/efuse", O_RDONLY);
+   ret = ioctl(fd, EFUSEIOC_READ_FIELD, &param);
+
+To find offset and count variables for related eFuse,
+please refer to Espressif's Technical Reference Manuals.
+
 gpio
 ----
 

Documentation/platforms/risc-v/esp32h2/index.rst

@@ -278,7 +278,7 @@ Bluetooth        No
 CAN/TWAI         Yes
 DMA              Yes
 ECC              No
-eFuse            No
+eFuse            Yes
 GPIO             Yes
 HMAC             No
 I2C              Yes

arch/risc-v/src/common/espressif/Kconfig

@@ -389,6 +389,19 @@ config ESPRESSIF_DMA
 	default n
 	select ARCH_DMA
 
+config ESPRESSIF_EFUSE
+	bool "EFUSE support"
+	default n
+	---help---
+		Enable efuse support.
+
+config ESPRESSIF_EFUSE_VIRTUAL
+	bool "Virtual EFUSE support"
+	depends on ESPRESSIF_EFUSE
+	default n
+	---help---
+		Enable virtual efuse support to simulate eFuse operations in RAM, changes will be reverted each reboot
+
 config ESPRESSIF_HR_TIMER
 	bool
 	default RTC_DRIVER

arch/risc-v/src/common/espressif/Make.defs

@@ -73,6 +73,10 @@ ifeq ($(CONFIG_ESPRESSIF_DMA),y)
 	CHIP_CSRCS += esp_dma.c
 endif
 
+ifeq ($(CONFIG_ESPRESSIF_EFUSE),y)
+	CHIP_CSRCS += esp_efuse.c
+endif
+
 ifeq ($(CONFIG_ESPRESSIF_TWAI),y)
 	CHIP_CSRCS += esp_twai.c
 endif
@@ -152,7 +156,7 @@ endif
 
 ESP_HAL_3RDPARTY_REPO   = esp-hal-3rdparty
 ifndef ESP_HAL_3RDPARTY_VERSION
-	ESP_HAL_3RDPARTY_VERSION = e3899a2324c8e326db20f99f208e890fdd7a5b92
+	ESP_HAL_3RDPARTY_VERSION = 87ccbf88b6fd490dae1993524e70f51bb2ea181d
 endif
 
 ifndef ESP_HAL_3RDPARTY_URL