{"id":3843,"date":"2018-03-26T13:50:13","date_gmt":"2018-03-26T20:50:13","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=3843"},"modified":"2021-09-23T17:16:38","modified_gmt":"2021-09-24T00:16:38","slug":"switching-advanced-esp-idf-projects-between-different-idf-versions","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/esp32\/esp-idf\/multiple\/","title":{"rendered":"Switching Advanced ESP-IDF Projects Between Different IDF Versions"},"content":{"rendered":"

This tutorial shows how to install several independent ESP-IDF checkouts into your ESP32 toolchain and switch the advanced ESP-IDF projects between those IDF versions. We will create a basic project\u00a0based on the ESP-IDF 3.0 release and\u00a0show how to switch it to the experimental master branch of ESP-IDF from github.<\/p>\n

Before you begin, install VisualGDB 5.4 or later.<\/p>\n

    \n
  1. Start Visual Studio and open the Advanced ESP-IDF Project Wizard:\"01-prj\"<\/a><\/li>\n
  2. On the first page of the wizard select “Create a new project” and click “Next”: \"02-create\"<\/a><\/li>\n
  3. On the next page select your ESP32 toolchain. VisualGDB will display the list of ESP-IDF checkouts\u00a0installed into that toolchain.\u00a0Select the default checkout and click “Next”:
    \n    \"03-v3\"<\/a><\/li>\n
  4. As\u00a0different ESP-IDF versions may not be 100%\u00a0compatible with each other, we will\u00a0use the most basic “blink” project to\u00a0demonstrate switching between IDF versions. Select it on the “Project Sample” page and click “Next”:\"04-blink\"<\/a><\/li>\n
  5. Finally select the debugging settings that match your project and click “Finish” to create it.\"05-debug\"<\/a><\/li>\n
  6. VisualGDB will create a basic project. Note that the project itself doesn’t include a copy of ESP-IDF and only includes the following files:
    \n\n\n\n\n\n\n\n
    File<\/td>\nDescription<\/td>\n<\/tr>\n
    Makefile<\/td>\nProject-level\u00a0Make file\u00a0defining project name and other options.<\/td>\n<\/tr>\n
    <project>.vgdbproj<\/td>\nVisualGDB project file containing\u00a0debugging settings, basic build settings and the list of configurations.<\/td>\n<\/tr>\n
    sdkconfig-<configuration><\/td>\nPer-configuration sdkconfig files. They will be created first time you open the corresponding configuration of the project.<\/td>\n<\/tr>\n
    main\\component.mk<\/td>\nConfiguration file for the main project component.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    \"06-files\"<\/a><\/li>\n

  7. Note that the ESP-IDF path is not\u00a0stored in any of the project-specific Makefiles. Instead VisualGDB will locate and substitute it dynamically when you open or build the project:\"07-prj\"<\/a><\/li>\n
  8. Now we will show how to change the\u00a0ESP-IDF version. Open VisualGDB Project Properties on the first page, select “Build Directory” -> “Clone an ESP-IDF release”:\"08-clone\"<\/a><\/li>\n
  9. Pick the version you want to clone (VisualGDB will automatically load the list of release tags from the github repository) and click OK:\"09-runclone\"<\/a><\/li>\n
  10. VisualGDB will automatically launch git and create a recursive checkout of ESP-IDF and all related libraries:\"10-progress\"<\/a><\/li>\n
  11. Once the checkout is complete, you will be able to select it in VisualGDB Project Properties or in the\u00a0ESP-IDF project wizard:\"11-master\"<\/a><\/li>\n
  12. Build the project again. Note how VisualGDB now\u00a0sets IDF_PATH to match the new checkout\u00a0location:\"12-buildmaster\"<\/a><\/li>\n
  13. Once VisualGDB updates the code model, Solution Explorer will switch to showing files from the new ESP-IDF checkout as well:
    \n<\/a>     \"13-built\"<\/a>You can always switch the checkout back and forth via VisualGDB Project Properties. As long as it is present in your toolchain directory, you don’t need to\u00a0re-clone it each time.<\/li>\n
  14. VisualGDB doesn’t hardcode the absolute path of the checkout in the project properties file. Instead it\u00a0stores the git branch name and the subdirectory in the toolchain folder (in case multiple copies of the same branch are checked out to different locations):\"14-refs\"<\/a>If you open the same project on another machine, VisualGDB will first try locating a checkout by both version and subdirectory, and if\u00a0none is found, will fall back to using version only.<\/li>\n
  15. The list of ESP-IDF checkouts is stored in the <toolchain directory>\\IDFCheckouts.xml file. If you decide to\u00a0work on a private fork of ESP-IDF, ensure you distribute the same\u00a0checkout (and the corresponding IDFCheckouts.xml file) to all your development machines:\"15-checkouts\"<\/a><\/li>\n
  16. You can delete the checkouts you don’t need anymore directly from\u00a0the checkout selector in VisualGDB Project Properties and the ESP-IDF project wizard:\"16-delete\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

    This tutorial shows how to install several independent ESP-IDF checkouts into your ESP32 toolchain and switch the advanced ESP-IDF projects<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[142],"tags":[160,138],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3843"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=3843"}],"version-history":[{"count":5,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3843\/revisions"}],"predecessor-version":[{"id":7509,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3843\/revisions\/7509"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=3843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=3843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=3843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}