Chapter 7
ESP-IDF Versions
The ESP-IDF GitHub repository is updated regularly, especially the master branch where new development takes
place.
For production use, there are also stable releases available.
7.1 Releases
The documentation for the current stable release version can always be found at this URL:
https://docs.espressif.com/projects/esp-idf/en/stable/
Documentation for the latest version (master branch) can always be found at this URL:
https://docs.espressif.com/projects/esp-idf/en/latest/
The full history of releases can be found on the GitHub repository Releases page. There you can find release notes,
links to each version of the documentation, and instructions for obtaining each version.
7.2 Which Version Should I Start With?
• For production purposes, use the current stable version. Stable versions have been manually tested, and are
updated with “bugfix releases”which fix bugs without changing other functionality (see Versioning Scheme
for more details). Every stable release version can be found on the Releases page.
• For prototyping, experimentation or for developing new ESP-IDF features, use the latest version (master branch
in Git). The latest version in the master branch has all the latest features and has passed automated testing, but
has not been completely manually tested (“bleeding edge”).
• If a required feature is not yet available in a stable release, but you do not want to use the master branch, it is
possible to check out a pre-release version or a release branch. It is recommended to start from a stable version
and then follow the instructions for Updating to a Pre-Release Version or Updating to a Release Branch.
See Updating ESP-IDF if you already have a local copy of ESP-IDF and wish to update it.
7.3 Versioning Scheme
ESP-IDF uses Semantic Versioning. This means that:
• Major Releases, like v3.0, add new functionality and may change functionality. This includes removing
deprecated functionality.
1587
To Next Page
Loading...
Need help?
General