1 # This file includes the operations with eFuses for ESP32-S3 chip
54 def add_commands(subparsers, efuses):  argument
55     add_common_commands(subparsers, efuses)
66         choices=efuses.BLOCKS_FOR_KEYS,
80     for _ in efuses.BLOCKS_FOR_KEYS:
87             choices=efuses.BLOCKS_FOR_KEYS,
117         choices=efuses.BLOCKS_FOR_KEYS,
131     for _ in efuses.BLOCKS_FOR_KEYS:
138             choices=efuses.BLOCKS_FOR_KEYS,
172         type=fields.base_fields.CheckArgValue(efuses, "CUSTOM_MAC"),
179 def burn_custom_mac(esp, efuses, args):  argument
180     efuses["CUSTOM_MAC"].save(args.mac)
181     if not efuses.burn_all(check_batch_mode=True):
183     get_custom_mac(esp, efuses, args)
187 def get_custom_mac(esp, efuses, args):  argument
188     print("Custom MAC Address: {}".format(efuses["CUSTOM_MAC"].get()))
191 def set_flash_voltage(esp, efuses, args):  argument
192     sdio_force = efuses["VDD_SPI_FORCE"]
193     sdio_tieh = efuses["VDD_SPI_TIEH"]
194     sdio_reg = efuses["VDD_SPI_XPD"]
196     # check efuses aren't burned in a way which makes this impossible
217         "The following efuses are burned: VDD_SPI_FORCE, VDD_SPI_XPD.\n"
222         "The following efuses are burned: VDD_SPI_FORCE, VDD_SPI_XPD, VDD_SPI_TIEH."
231     if not efuses.burn_all(check_batch_mode=True):
236 def adc_info(esp, efuses, args):  argument
239     if efuses["BLK_VERSION_MAJOR"].get() == 1:
240         print("Temperature Sensor Calibration = {}C".format(efuses["TEMP_CALIB"].get()))
241         print("ADC OCode        = ", efuses["OCODE"].get())
243         print("INIT_CODE_ATTEN0 = ", efuses["ADC1_INIT_CODE_ATTEN0"].get())
244         print("INIT_CODE_ATTEN1 = ", efuses["ADC1_INIT_CODE_ATTEN1"].get())
245         print("INIT_CODE_ATTEN2 = ", efuses["ADC1_INIT_CODE_ATTEN2"].get())
246         print("INIT_CODE_ATTEN3 = ", efuses["ADC1_INIT_CODE_ATTEN3"].get())
247         print("CAL_VOL_ATTEN0   = ", efuses["ADC1_CAL_VOL_ATTEN0"].get())
248         print("CAL_VOL_ATTEN1   = ", efuses["ADC1_CAL_VOL_ATTEN1"].get())
249         print("CAL_VOL_ATTEN2   = ", efuses["ADC1_CAL_VOL_ATTEN2"].get())
250         print("CAL_VOL_ATTEN3   = ", efuses["ADC1_CAL_VOL_ATTEN3"].get())
252         print("INIT_CODE_ATTEN0 = ", efuses["ADC2_INIT_CODE_ATTEN0"].get())
253         print("INIT_CODE_ATTEN1 = ", efuses["ADC2_INIT_CODE_ATTEN1"].get())
254         print("INIT_CODE_ATTEN2 = ", efuses["ADC2_INIT_CODE_ATTEN2"].get())
255         print("INIT_CODE_ATTEN3 = ", efuses["ADC2_INIT_CODE_ATTEN3"].get())
256         print("CAL_VOL_ATTEN0   = ", efuses["ADC2_CAL_VOL_ATTEN0"].get())
257         print("CAL_VOL_ATTEN1   = ", efuses["ADC2_CAL_VOL_ATTEN1"].get())
258         print("CAL_VOL_ATTEN2   = ", efuses["ADC2_CAL_VOL_ATTEN2"].get())
260         print("BLK_VERSION_MAJOR = ", efuses["BLK_VERSION_MAJOR"].get_meaning())
277 def get_next_key_block(efuses, current_key_block, block_name_list):  argument
278     key_blocks = [b for b in efuses.blocks if b.key_purpose_name]
288         key_purpose_block = efuses[block.key_purpose_name]
295 def split_512_bit_key(efuses, block_name_list, datafile_list, keypurpose_list):  argument
299     block_num = efuses.get_index_block_by_name(block_name)
300     block = efuses.blocks[block_num]
308     key_block_2 = get_next_key_block(efuses, block, block_name_list)
325 def burn_key(esp, efuses, args, digest=None):  argument
332     efuses.force_write_always = args.force_write_always
343         split_512_bit_key(efuses, block_name_list, datafile_list, keypurpose_list)
360         for block in efuses.blocks:
362                 efuse = efuses[block.name]
367         block_num = efuses.get_index_block_by_name(block_name)
368         block = efuses.blocks[block_num]
377         if efuses[block.key_purpose_name].need_reverse(keypurpose):
395         if efuses[block.key_purpose_name].need_rd_protect(keypurpose):
406         if efuses[block.key_purpose_name].get() != keypurpose:
407             if efuses[block.key_purpose_name].is_writeable():
412                         efuses[block.key_purpose_name].get(),
416                 efuses[block.key_purpose_name].save(keypurpose)
426             if efuses[block.key_purpose_name].is_writeable():
431             efuses[block.key_purpose_name].disable_write()
447     if not efuses.burn_all(check_batch_mode=True):
452 def burn_key_digest(esp, efuses, args):  argument
462         for block in efuses.blocks:
464                 efuse = efuses[block.name]
475     burn_key(esp, efuses, args, digest=digest_list)
478 def espefuse(esp, efuses, args, command):  argument
481     add_commands(subparsers, efuses)
500     operation_func(esp, efuses, cmd_line_args)
503 def execute_scripts(esp, efuses, args):  argument
504     efuses.batch_mode_cnt += 1
514         for block in efuses.blocks:
518     efuses.batch_mode_cnt -= 1
519     if not efuses.burn_all(check_batch_mode=True):