This extension allows you to import ESP32 flash images into Ghidra. It can load either a full flash image with the bootloader and application or just the application part.
In both cases, the image will be fully loaded into Ghidra with the correct address offsets and annotations. Additionally, the extension will load the ESP32 peripherals and their registers from the SVD files provided by Espressif. The ROM code for the associated ESP32 chip will also be loaded into Ghidra, so the code can be properly analyzed.
It also includes several SVD-related scripts
- ESP32
- ESP32-S2
- ESP32-C3
- Download the latest release from the releases page
- Extract the zip file, it contains the actual extension zip file
- In Ghidra, go to
File -> Install Extensions... - Select the + icon in the top right corner
- Select the downloaded zip file and click OK
- Done! Restart Ghidra and you should be able to load ESP32 flash images
The extension can be built using gradle.
The following commands will build the extension and store it in the dist/ directory.
Please adjust the installation directory to your Ghidra directory
# For Flatpak installations:
# GHIDRA_INSTALL_DIR=/var/lib/flatpak/app/org.ghidra_sre.Ghidra/current/active/files/lib/ghidra
export GHIDRA_INSTALL_DIR=/opt/ghidra/
gradleNow you can install the extension as described above just select the zip file in the dist/ directory.
This project currently has all rights reserved to the respective commit authors.
We are working on getting the necessary permissions to release this project under an open source license.
- Espressif SVD files (/data/svd): Licensed under Apache 2.0.
- ESP32 ROM files (/data/*.elf): Licensed under Apache 2.0., ROMs contain additional third-party-libraries, see here.