table of contents
other versions
- testing 2.5.1+dfsg-3
- stretch-backports 2.1+dfsg1-2~bpo9+1
- unstable 2.6+dfsg-1
ESPEFUSE(1) | User Commands | ESPEFUSE(1) |
NAME¶
espefuse - ESP32 efuse get/set toolDESCRIPTION¶
usage: espefuse [OPTION] COMMANDcommand arguments:¶
- Run espefuse {command} -h for additional help
- dump
- Dump raw hex values of all efuses
- summary
- Print human-readable summary of efuse values
- burn_efuse
- Burn the efuse with the specified name
- read_protect_efuse
- Disable readback for the efuse with the specified name
- write_protect_efuse
- Disable writing to the efuse with the specified name
- burn_key
- Burn a 256-bit AES key to EFUSE BLK1,BLK2 or BLK3 (flash_encryption, secure_boot).
- set_flash_voltage
- Permanently set the internal flash voltage regulator to either 1.8V, 3.3V or OFF. This means GPIO12 can be high or low at reset without changing the flash voltage.
optional arguments:¶
- -h, --help
- show this help message and exit
- --port PORT, -p PORT
- Serial port device
- --before {default_reset,no_reset,esp32r1}
- What to do before connecting to the chip
- --do-not-confirm
- Do not pause for confirmation before permanently writing efuses. Use with caution.
EXAMPLES¶
Flash Espressif AT v1.4 firmware to an ESP-12S board:- esptool write_flash --flash_mode dio --flash_size 4MB-c1 0x00 boot_v1.7.bin 0x1000 at/1024+1024/user1.2048.new.5.bin 0xfe000 blank.bin 0x3fc000 esp_init_data_default.bin 0x3fe000 blank.bin
Display ESP32 efuse state summary:
- espefuse --port /dev/ttyUSB0 summary
Generate a flash encryption key:
- espsecure generate_flash_encryption_key key.bin
Burn the key to the device (WARNING: one time only operation):
- espefuse --port /dev/ttyUSB1 burn_key flash_encryption key.bin
Encrypt flash data:
- espsecure encrypt_flash_data --keyfile key.bin --address 0x10000 -o my-app-encrypted.bin my-app.bin
AUTHOR¶
esptool.py was started by Fredrik Ahlberg as an unofficial community project, currently maintained by Angus Gratton and supported by Espressif Systems (Shanghai) PTE LTD. This manual page was generated by Milan Kupcevic <milan@debian.org> for the Debian project and can be used by others.REPORTING BUGS¶
Review: <https://github.com/espressif/esptool/#troubleshooting>Known issues: <https://github.com/espressif/esptool/issues>
Report new issues at: <https://github.com/espressif/esptool/issues/new>
COPYRIGHT¶
Copyright © 2014-2016 Fredrik Ahlberg, Angus Gratton, Espressif Systems (Shanghai) PTE LTD, other contributors as noted. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.SEE ALSO¶
esptool(1), espefuse(1), espsecure(1)April 2018 | esptool.py 2.1 |