Skip to content

Commit

Permalink
updated readme and some minor fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
alirana01 committed Sep 14, 2023
1 parent a1d1bb8 commit 49b12c7
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 11 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -646,6 +646,7 @@ else if (environment.containsKey("Path"))
}

stringBuilder.append(Messages.MissingToolsValidationMessage_B);
stringBuilder.append(System.lineSeparator());
stringBuilder.append(Messages.MissingToolsValidationLink);

manageToolsInstallationWizardPage.getShell().getDisplay().asyncExec(() -> {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -109,4 +109,4 @@ FilterTargetBoxToolTip=Filter the tools based on the target selection of ESP chi
ShowAvailableVersionsOnlyToolTip=Shows the versions that are available already and downloaded. The versions should be in the espressif home directory to be visible with this.
MissingToolsValidationMessage_A=Following required tools are missing:
MissingToolsValidationMessage_B=Please visit the Link below to see configuration for these tools
MissingToolsValidationLink=
MissingToolsValidationLink=https://github.com/espressif/idf-eclipse-plugin/blob/master/docs/MissingToolsManualPathUpdateGuide.md
21 changes: 11 additions & 10 deletions docs/MissingToolsManualPathUpdateGuide.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Installing Missing Tools and Updating Path

Some tools are required as mandatory for the IDF and must be installed manually on Linux and MAC for windows the tools installation in the IDF-Eclipse Plugin takes care of them. Please vist [this](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html) link to first install them respective to your platform.
Some tools are required as mandatory for the IDF and must be installed manually or must be selected when you are using the tools installation wizard on Linux and MAC and only selected recommended tools for windows these tools installation are mandatory and are selected with recommended tools.

Once you have installed the required tools you can move to the next step.
The `PATH` in the IDE is independent of the system's `PATH` variable so we need to configure it.<br/>

We will be using CMake as an example but you need to make sure to follow the steps below for all the tools you have installed from the previous link.
If you have these tools already present on your system you can skip the first step and continue from the second step.
1. In case you want to manually install these tools to the system first please vist [this](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html) link to install them respective to your platform.

Run the following command to find out the install location of the tools
*Once you have installed the required tools you can move to the next step.
The `PATH` in the IDE is independent of the system's `PATH` variable so we need to configure it.<br/>*
*We will be using CMake as an example but you need to make sure to follow the steps below for all the tools you have installed from the previous link.*

For CMake `which cmake` This will output the path to the directory where the CMake is installed. If you dont get the path it could mean a trouble with the path in your terminal or installation please consult the documentation again for the installation and correct configuration of the PATH for your system. Your output may look something like this
2. Run the following command to find out the install location of the tools. For CMake `which cmake` This will output the path to the directory where the CMake is installed. If you dont get the path it could mean a trouble with the path in your terminal or installation please consult the documentation again for the installation and correct configuration of the PATH for your system. Your output may look something like this
<br/>
`/opt/homebrew/bin/cmake`
<br/>
Expand All @@ -18,18 +18,19 @@ We need to copy the path for the directory in which the CMake is present. So the

Once that is copied you can head over to the IDE.

- Open Eclipse Settings and Go to `C/C++ -> Build -> Environment`. You will see these variables if you have installed the tools.
3. Open Settings and Go to `C/C++ -> Build -> Environment`. You will see these variables if you have installed the tools.
![](images/ToolsValidation/EnvSettings.png)

<br/>

- Select the `PATH` variable and click `Edit...`<br/>
4. Select the `PATH` variable and click `Edit...`<br/>
![](images/ToolsValidation/PathVarEdit.png)

- Now paste the path that we previously copeid `/opt/homebrew/bin` at the start of the current path and place a colon `:` after that. Your original `PATH` value will always come after the path you have copied. It should look something like this. <br/>
5. Now paste the path that we previously copeid `/opt/homebrew/bin` at the start of the current path and place a colon `:` after that. Your original `PATH` value will always come after the path you have copied. It should look something like this. <br/>
![](images/ToolsValidation/PathVarEdited.png)
<br/>


Now as stated previously this was only for cmake you need to find the install locations of the other required tools and add them in the same way to the `PATH`. After you have done that you can click `OK` and then click `Apply and Close`.

Once you have configured these correctly you should be able to build the projects.

0 comments on commit 49b12c7

Please sign in to comment.