You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -112,42 +111,35 @@ For adding beta and nightly builds, you can use the following update site urls.
112
111
<aname="InstallTools"></a>
113
112
# Installing ESP-IDF
114
113
115
-
To install ESP-IDF directly from the Eclipse:
114
+
>With release of the beata 3.0 all the old installation flows for the ESP-IDF are now closed. We will be moving forward with this approach from next stable release.
116
115
117
-
1. Go to `Espressif` > `Download and Configure ESP-IDF`.
118
-
1. From the `Download ESP-IDF` section, choose ESP-IDF version and directory to download.
119
-
1. Click on `Finish`.
120
-
121
-
To configure an existing ESP-IDF:
116
+
Please follow the instructions bleow for installing ESP-IDF in the Espressif IDE.
122
117
123
-
1. Go to `Espressif` > `Download and Configure ESP-IDF`.
124
-
1. Check `Use an existing ESP-IDF directory from the file system`.
125
-
1. Choose an existing ESP-IDF directory from the file system.
126
-
1. Click on `Finish`.
127
-
128
-
This will download a specified ESP-IDF version and configure `IDF_PATH` in the Eclipse CDT build environment variables.
118
+
1. Go to `Espressif` > `ESP-IDF Manager`. The following editor will open
From the screen shown above you can choose an already downloaded ESP-IDF Directory or you can select and download directly from the given dialog. The `Git` and `Python` must be installed and if it is configured in system PATH it will be preloaded in the given view. If not you can Browse to the directory and select the proper executables.
131
124
132
-
# Installing ESP-IDF Tools
125
+
1. Click on `Finish` which will be enabled after all the paths and executables are properly configured.
133
126
134
-
ESP-IDF requires the installation of several prerequisite tools to build firmware for the ESP32. These tools include Python, Git, cross-compilers, the menuconfig tool, CMake, and Ninja build tools.
127
+
> **Note** Please note that the python executable is not the one from the virtual environment created from the installation of the ESP-IDF via other means like from CLI. If you are selecting an already installed ESP-IDF directory IDE will automatically pick up the python once you have installed the tools.
128
+
To configure an existing ESP-IDF:
135
129
136
-
Follow the below instructions to get started.
130
+
After you have clicked `Finish` you will see the progress on console for the tools getting installed. Once the installation is done and this is the very first set of ESP-IDF installed in the IDE it will be activated as well and you will see a similar entry in the editor for ESP-IDF Manager
1. Provide `Git` and `Python` executable locations if they are not auto-detected.
141
-
1. Click on `Install Tools` to proceed with the installation process. Check the Console for the installation details.
142
-
1. Installation might take a while if you're doing it for the first time since it has to download and install `xtensa-esp32-elf`, `esp32ulp-elf`, Cmake, `openocd-esp32` and Ninja tools.
133
+
You can add as many version of ESP-IDF as you want but only one of the version can be set active and that will be used to compile and index projects in your workspace. This new feature can help you in swithcing between versions in the workspace easily.
143
134
144
-
> **Note:** Ensure that you perform this step even if you have already installed the necessary tools. This step sets the IDF_PATH, PATH, OPENOCD_SCRIPTS, and IDF_PYTHON_ENV_PATH in the Eclipse CDT build environment based on the idf_tools.py export command.
135
+
Lets take a look at how the multiple versions will look like. You have to follow the same steps as done previously to add another ESP-IDF version to the IDE.
To activate any specific version simply click on the radio button next to it in the `Active` column.
147
139
148
-
ESP-IDF Directory selection dialog:
140
+
The refresh button in last column for the active ESP-IDF version can be used to reload any changes in the directory you made.
149
141
150
-

142
+
> **Note** Please note that you can not delete an active ESP-IDF Version you need to activate another version before deleting that.
151
143
152
144
<aname="NewProjectUsingDefault"></a>
153
145
# Create a new Project
@@ -256,24 +248,6 @@ To learn more about the debug configuration, please refer to <a href="https://gi
256
248
257
249

258
250
259
-
<aname="InstallToolsWizard"></a>
260
-
# Tools Installation Wizard
261
-
262
-
You can use the Tools Installation Wizard to manage the tools installation via a wizard. The advantage of this method over the existing installation is that you can easily manage the whole flow via the wizard and install the tools in ESP-IDF framework that you only need.<br/>
1. The wizard will start and you can select the location for the Git and Python, if they are already present on the system PATH or registry the tools will be populated. After selection, you can click `Next`.
1. Next page will let you select the folder for existing ESP-IDF or you can also select from the drop down list to download the available versions. You can also select master from the list to clone the master for ESP-IDF from GitHub.
1. After you select `Next` you will see the list of all the available tools in the selected ESP-IDF version, this page lets you select only the recommended tools or you can select the tools you want to. You can also filter out the tools via the filter text box or based on the target. The wizard page is the last page and will Install and Download if necessary all the selected tools required. After you have installed all the tools you can finish the wizard and start creating projects.
0 commit comments