Switching ESP-IDF Versions in Espressif-IDE

Kondal Kolipaka
2 min readDec 20, 2022

--

Espressif-IDE is an Integrated Development Environment(IDE) based on Eclipse CDT for developing IoT Applications using the ESP-IDF framework using espressif chips.

As a user, you often come across a use case where you need to deal with multiple ESP-IDF versions and you probably want to switch between them during your app development.

This could be achieved in Espressif-IDE.

  1. Go to Espressif Menu
  2. Select the Download and Configure ESP-IDF menu option
  3. Select the required ESP-IDF version to switch.
  4. Choose the directory where you would like to like keep the newly downloaded esp-idf-xxx version
  5. Click Finish

Once the download process is completed, it will ask you if you would like to install the supported toolchain for the newly selected esp-idf version

If you choose to click “Yes”, It will prompt a dialog for confirmation with the ESP-IDF path and other settings, upon confirmation it will install the required toolset and configure the ESP-IDF with a new version.

One more step to go!

As the project earlier was built with a different version of ESP-IDF and it will have ESP-IDF version-specific CMake configuration output files and this needs to be cleaned up.

This could be done through ESP-IDF: Project Full Clean command. You can find this option on the right of a project.

As mentioned here — Running this command will delete the entire “build” directory contents. This includes all CMake configuration output. The next time the project is built, CMake will configure it from scratch. Note that this option recursively deletes all files in the build directory, so use it with care. The project configuration is not deleted here.

Once you’re done with the project full clean, your project is now ready to build with the new ESP-IDF Version.

Now click on the Build icon to get started with the Build.

If you’re switching the ESP-IDF version which is already downloaded choose the “Use an existing ESP-IDF directory from the file system” option in the Download and Configure ESP-IDF wizard and the rest of the process is the same as mentioned above.

Switching ESP-IDF Versions in Espressif-IDE
ESP-IDF: Project Full Clean

Thank you!!

--

--