Module esp32c3_hal::efuse
source · Expand description
Reading of eFuses (ESP32-C3)
Overview
The efuse
module provides functionality for reading eFuse data
from the ESP32-C3
chip, allowing access to various chip-specific
information such as :
- MAC address
- core count
- CPU frequency
- chip type
and more. It is useful for retrieving chip-specific configuration and identification data during runtime.
The Efuse
struct represents the eFuse peripheral and is responsible for
reading various eFuse fields and values.
Example
Read chip’s MAC address from the eFuse storage.
let mac_address = Efuse::get_mac_address();
writeln!(
serial_tx,
"MAC: {:#X}:{:#X}:{:#X}:{:#X}:{:#X}:{:#X}",
mac_address[0],
mac_address[1],
mac_address[2],
mac_address[3],
mac_address[4],
mac_address[5]
);
Structs
- The bit field for get access to efuse data
Constants
[]
ADC1 calibration voltage at atten0[]
ADC1 calibration voltage at atten1[]
ADC1 calibration voltage at atten2[]
ADC1 calibration voltage at atten3[]
ADC1 init code at atten0[]
ADC1 init code at atten1[]
ADC1 init code at atten2[]
ADC1 init code at atten3[]
BLK_VERSION_MAJOR of BLOCK2 {0: “No calibration”; 1: “With calibration”}[]
BLK_VERSION_MINOR[]
BLOCK1 digital dbias when hvt[]
Disables check of blk version major[]
Disables check of wafer version major[DIS_LEGACY_SPI_BOOT]
Disable direct boot mode[]
Set this bit to disable Icache in download mode (boot_mode[3:0]
is 0; 1; 2; 3; 6; 7)[]
Set this bit to disable flash encryption when in download boot modes[]
Set this bit to disable download mode (boot_mode[3:0]
= 0; 1; 2; 3; 6; 7)[]
Set this bit to disable the function that forces chip into download mode[]
Set this bit to disable Icache[]
Set this bit to disable JTAG in the hard way. JTAG is disabled permanently[DIS_CAN]
Set this bit to disable CAN function[]
Set this bit to disable function of usb switch to jtag in module of usb device[DIS_USB_DEVICE]
USB-Serial-JTAG {0: “Enable”; 1: “Disable”}[DIS_USB_DOWNLOAD_MODE]
Disable UART download mode through USB-Serial-JTAG[UART_PRINT_CHANNEL]
USB printing {0: “Enable”; 1: “Disable”}[]
Set this bit to enable secure UART download mode[]
Use BLOCK0 to check error record registers {0: “without check”; 1: “with check”}[]
Configures flash waiting time after power-up; in unit of ms. If the value is less than 15; the waiting time is the configurable value; Otherwise; the waiting time is twice the configurable value[]
Set this bit to force ROM code to send a resume command during SPI boot[]
Set this bit to enable selection between usb_to_jtag and pad_to_jtag through strapping gpio10 when both reg_dis_usb_jtag and reg_dis_pad_jtag are equal to 0[BLOCK_KEY0]
Key0 or user data[BLOCK_KEY1]
Key1 or user data[BLOCK_KEY2]
Key2 or user data[BLOCK_KEY3]
Key3 or user data[BLOCK_KEY4]
Key4 or user data[BLOCK_KEY5]
Key5 or user data[KEY0_PURPOSE]
Purpose of Key0[KEY1_PURPOSE]
Purpose of Key1[KEY2_PURPOSE]
Purpose of Key2[KEY3_PURPOSE]
Purpose of Key3[KEY4_PURPOSE]
Purpose of Key4[KEY5_PURPOSE]
Purpose of Key5[]
BLOCK1 K_DIG_LDO[]
BLOCK1 K_RTC_LDO[MAC_FACTORY]
MAC address[]
ADC OCode[]
Optional unique 128-bit ID[]
Package version[]
Disable reading from BlOCK4-10[RD_DIS.KEY0]
rd_dis of BLOCK_KEY0[RD_DIS.KEY1]
rd_dis of BLOCK_KEY1[RD_DIS.KEY2]
rd_dis of BLOCK_KEY2[RD_DIS.KEY3]
rd_dis of BLOCK_KEY3[RD_DIS.KEY4]
rd_dis of BLOCK_KEY4[RD_DIS.KEY5]
rd_dis of BLOCK_KEY5[RD_DIS.SYS_DATA_PART2]
rd_dis of BLOCK_SYS_DATA2[]
Set this bit to enable revoking aggressive secure boot[]
Set this bit to enable secure boot[]
Revoke 1st secure boot key[]
Revoke 2nd secure boot key[]
Revoke 3rd secure boot key[]
Secure version (used by ESP-IDF anti-rollback feature)[]
Set these bits to disable JTAG in the soft way (odd number 1 means disable ). JTAG can be enabled in HMAC module[]
Enables flash encryption when 1 or 3 bits are set and disables otherwise {0: “Disable”; 1: “Enable”; 3: “Disable”; 7: “Enable”}[]
SPI PAD CLK[]
SPI PAD CS[]
SPI PAD D(D0)[]
SPI PAD D4[]
SPI PAD D5[]
SPI PAD D6[]
SPI PAD D7[]
SPI PAD DQS[]
SPI PAD HD(D3)[]
SPI PAD Q(D1)[]
SPI PAD WP(D2)[BLOCK_SYS_DATA2]
System data part 2 (reserved)[]
Temperature calibration data[]
BLOCK1 pvt threshold when hvt[]
Set the default UARTboot message output mode {0: “Enable”; 1: “Enable when GPIO8 is low at reset”; 2: “Enable when GPIO8 is high at reset”; 3: “Disable”}[]
Set this bit to exchange USB D+ and D- pins[BLOCK_USR_DATA]
User data[MAC_CUSTOM CUSTOM_MAC]
Custom MAC address[]
Set this bit to vdd spi pin function as gpio[]
BLOCK1 voltage of digital dbias20[]
BLOCK1 voltage of rtc dbias20[]
WAFER_VERSION_MAJOR[]
WAFER_VERSION_MINOR most significant bit[]
WAFER_VERSION_MINOR least significant bits[]
RTC watchdog timeout threshold; in unit of slow clock cycle {0: “40000”; 1: “80000”; 2: “160000”; 3: “320000”}[]
Disable programming of individual eFuses[]
wr_dis of ADC1_CAL_VOL_ATTEN0[]
wr_dis of ADC1_CAL_VOL_ATTEN1[]
wr_dis of ADC1_CAL_VOL_ATTEN2[]
wr_dis of ADC1_CAL_VOL_ATTEN3[]
wr_dis of ADC1_INIT_CODE_ATTEN0[]
wr_dis of ADC1_INIT_CODE_ATTEN1[]
wr_dis of ADC1_INIT_CODE_ATTEN2[]
wr_dis of ADC1_INIT_CODE_ATTEN3[]
wr_dis of BLOCK1[]
wr_dis of BLK_VERSION_MAJOR[]
wr_dis of BLK_VERSION_MINOR[WR_DIS.KEY0]
wr_dis of BLOCK_KEY0[WR_DIS.KEY1]
wr_dis of BLOCK_KEY1[WR_DIS.KEY2]
wr_dis of BLOCK_KEY2[WR_DIS.KEY3]
wr_dis of BLOCK_KEY3[WR_DIS.KEY4]
wr_dis of BLOCK_KEY4[WR_DIS.KEY5]
wr_dis of BLOCK_KEY5[WR_DIS.SYS_DATA_PART2]
wr_dis of BLOCK_SYS_DATA2[WR_DIS.USER_DATA]
wr_dis of BLOCK_USR_DATA[WR_DIS.MAC_CUSTOM WR_DIS.USER_DATA_MAC_CUSTOM]
wr_dis of CUSTOM_MAC[]
wr_dis of DIG_DBIAS_HVT[]
wr_dis of DISABLE_BLK_VERSION_MAJOR[]
wr_dis of DISABLE_WAFER_VERSION_MAJOR[WR_DIS.DIS_LEGACY_SPI_BOOT]
wr_dis of DIS_DIRECT_BOOT[]
wr_dis of DIS_DOWNLOAD_ICACHE[]
wr_dis of DIS_DOWNLOAD_MANUAL_ENCRYPT[]
wr_dis of DIS_DOWNLOAD_MODE[]
wr_dis of DIS_FORCE_DOWNLOAD[]
wr_dis of DIS_ICACHE[]
wr_dis of DIS_PAD_JTAG[WR_DIS.DIS_CAN]
wr_dis of DIS_TWAI[]
wr_dis of DIS_USB_JTAG[WR_DIS.DIS_USB_DEVICE]
wr_dis of DIS_USB_SERIAL_JTAG[WR_DIS.DIS_USB_DOWNLOAD_MODE]
wr_dis of DIS_USB_SERIAL_JTAG_DOWNLOAD_MODE[WR_DIS.UART_PRINT_CHANNEL]
wr_dis of DIS_USB_SERIAL_JTAG_ROM_PRINT[]
wr_dis of ENABLE_SECURITY_DOWNLOAD[]
wr_dis of ERR_RST_ENABLE[]
wr_dis of FLASH_TPUW[]
wr_dis of FORCE_SEND_RESUME[]
wr_dis of JTAG_SEL_ENABLE[WR_DIS.KEY0_PURPOSE]
wr_dis of KEY_PURPOSE_0[WR_DIS.KEY1_PURPOSE]
wr_dis of KEY_PURPOSE_1[WR_DIS.KEY2_PURPOSE]
wr_dis of KEY_PURPOSE_2[WR_DIS.KEY3_PURPOSE]
wr_dis of KEY_PURPOSE_3[WR_DIS.KEY4_PURPOSE]
wr_dis of KEY_PURPOSE_4[WR_DIS.KEY5_PURPOSE]
wr_dis of KEY_PURPOSE_5[]
wr_dis of K_DIG_LDO[]
wr_dis of K_RTC_LDO[WR_DIS.MAC_FACTORY]
wr_dis of MAC[]
wr_dis of OCODE[]
wr_dis of OPTIONAL_UNIQUE_ID[]
wr_dis of PKG_VERSION[]
wr_dis of RD_DIS[]
wr_dis of SECURE_BOOT_AGGRESSIVE_REVOKE[]
wr_dis of SECURE_BOOT_EN[]
wr_dis of SECURE_BOOT_KEY_REVOKE0[]
wr_dis of SECURE_BOOT_KEY_REVOKE1[]
wr_dis of SECURE_BOOT_KEY_REVOKE2[]
wr_dis of SECURE_VERSION[]
wr_dis of SOFT_DIS_JTAG[]
wr_dis of SPI_BOOT_CRYPT_CNT[]
wr_dis of SPI_PAD_CONFIG_CLK[]
wr_dis of SPI_PAD_CONFIG_CS[]
wr_dis of SPI_PAD_CONFIG_D[]
wr_dis of SPI_PAD_CONFIG_D4[]
wr_dis of SPI_PAD_CONFIG_D5[]
wr_dis of SPI_PAD_CONFIG_D6[]
wr_dis of SPI_PAD_CONFIG_D7[]
wr_dis of SPI_PAD_CONFIG_DQS[]
wr_dis of SPI_PAD_CONFIG_HD[]
wr_dis of SPI_PAD_CONFIG_Q[]
wr_dis of SPI_PAD_CONFIG_WP[]
wr_dis of BLOCK2[]
wr_dis of TEMP_CALIB[]
wr_dis of THRES_HVT[]
wr_dis of UART_PRINT_CONTROL[]
wr_dis of USB_EXCHG_PINS[]
wr_dis of VDD_SPI_AS_GPIO[]
wr_dis of V_DIG_DBIAS20[]
wr_dis of V_RTC_DBIAS20[]
wr_dis of WAFER_VERSION_MAJOR[]
wr_dis of WAFER_VERSION_MINOR_HI[]
wr_dis of WAFER_VERSION_MINOR_LO[]
wr_dis of WDT_DELAY_SEL