|
|
(12 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
| + | __TOC__ |
| + | |
| ==Compiler Toolchain== | | ==Compiler Toolchain== |
| | | |
Line 15: |
Line 17: |
| | | |
| | | |
− | ==ESP32 Toolchain== | + | ==Instructions for specific toolchains== |
− | | |
− | The ESP32 toolchain includes a lot more extras and so we have used the standard Espresif installer as that does all the extra functionality for you.
| |
− | | |
− | The only downside to this is you have to manually point Flowcode at the toolchain.
| |
− | | |
− | | |
− | The toolchain can be downloaded from here: [https://dl.espressif.com/dl/esp-idf-tools-setup-2.3.exe Espressif ESP32 IDF Toolchain]
| |
− | | |
− | Please report any problems or issues on the Flowcode user forum.
| |
− | | |
− | | |
− | Installation
| |
− | | |
− | Once the download has finished run the installation file.
| |
− | [[File:ESP32_Setup1.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Select – I accept the agreement and click Next
| |
− | [[File:ESP32_Setup2.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | If you have Python already installed then you can select your version of Python.
| |
− | | |
− | Otherwise, select Install Python 3.7
| |
− | | |
− | ''<span style="color:red;">Please note some versions of Python may cause the installer to fail, if this happens then try again and use the supplied version 3.7</span>''
| |
− | | |
− | If you have Git already installed then you can select your version of Git.
| |
− | | |
− | Otherwise select Install Git
| |
− | [[File:ESP32_Setup3.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | If you have an ESP-IDF already downloaded then you can select your version of ESP-IDF.
| |
− | | |
− | Otherwise, select Download ESP-IDF
| |
− | [[File:ESP32_Setup4.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Select which ESP-IDF to install, we recommend the lowest version as the higher versions have not been tested.
| |
− | | |
− | At the time of writing 4.2 (Release branch is OK to use)
| |
− | | |
− | Install to a location on your system with no spaces in the path.
| |
− | | |
− | For example C:\esp-idf
| |
− | [[File:ESP32_Setup5.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Select a location for the ESP-IDF Tools to be installed, again use a path that contains no spaces
| |
− | | |
− | For example C:\esp-idf-tools
| |
− | [[File:ESP32_Setup6.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Select addition tasks, recommend keeping all options checked and click Next.
| |
− | [[File:ESP32_Setup7.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | A PC reboot may be required after installation has been completed.
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | ==Pico Toolchain==
| |
− | Note: Using Raspberry Pi Pico with Windows 7 or 8 is not officially supported.
| |
− | To build Pico projects you will need to install the following tools:
| |
− | ARM GCC compiler
| |
− | CMake
| |
− | Build Tools for Visual Studio 2019
| |
− | Python 3
| |
− | Git
| |
− | | |
− | '''Installing ARM GCC Compiler'''
| |
− | Download the Windows Installer from:
| |
− | https://developer.arm.com/downloads/-/gnu-rm
| |
− | | |
− | [[File:Pico_Toolchain1.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | During installation, you should tick the box to register the path to the ARM compiler as an
| |
− | environment variable in the Windows shell:
| |
− | [[File:Pico_Toolchain2.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | The command prompt that the installation opened can be closed.
| |
− | | |
− | '''Installing CMake'''
| |
− | | |
− | Download the Windows CMake3.20.5 Installer from: https://cmake.org/files/v3.20/
| |
− | | |
− | | |
− | During the installation add CMake to the system PATH for all users:
| |
− | [[File:Pico_Toolchain3.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | '''Installing Build Tools for Visual Studio 2022'''
| |
− | | |
− | Download the Windows Installer from:
| |
− | | |
− | https://aka.ms/vs/17/release/vs_BuildTools.exe
| |
− | | |
− | | |
− | When prompted by the Build Tools for Visual Studio installer you need to install the C++ build
| |
− | tools only.
| |
− | | |
− | You must install the full "Windows 10 SDK" package and leave the path as the default value:
| |
− | [[File:Pico_Toolchain4.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | At around 21% completed its takes a little while to continue.
| |
− | | |
− | This is normal
| |
− | | |
− | | |
− | ''Installing Python 3''
| |
− | | |
− | ''<span style="color:red;">If you already have Python 3 installed on your PC (for example if you have already installed the ESP toolchain) skip this section and do not re-install Python.</span>''
| |
− | | |
− | Download Windows Installer from: https://www.python.org/downloads/windows/
| |
− | | |
− | Look for version 3.9.6:
| |
− | [[File:Pico_Toolchain5.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Ensure that it’s installed 'for all users' and add Python 3.9 to the system PATH:
| |
− | [[File:Pico_Toolchain6.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | Disable the MAX_PATH length limit when prompted at the end of the Python installation:
| |
− | [[File:Pico_Toolchain7.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | ''Installing Git''
| |
− | | |
− | Download the Windows Installer from: https://git-scm.com/download/win
| |
− | | |
− | When installing Git you should have Only show new options unselected.
| |
− | | |
− | There is no need to change any default setting for all the checkboxes
| |
− | | |
− | Ensure that you change the default editor away from vim, for example if you have notepad++:
| |
− | [[File:Pico_Toolchain8.png|left]]
| |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
− | | |
| | | |
| + | Click the approriate link below ofr detailed instructions for spacific compiler toolchains. |
| | | |
| | | |
| + | [[ESP32 Toolchain]] |
| | | |
| + | [[Pico Toolchain]] |
| | | |
− | Ensure you tick the checkbox to allow Git to be used from third-party tools:
| + | [[Using a new version of XC8]] |
− | [[File:Pico_Toolchain9.png|left]] | |