|
|
| 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://flowcode.co.uk/download
| |
| − | | |
| − | 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]]
| |
| − | | |
| − | Select – I accept the agreement and click Next
| |
| − | | |
| − | [[File:ESP32_Setup2.png]]
| |
| − | | |
| − | If you have a different version of Python installed, then I would recommend sicking with 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]]
| |
| − | | |
| − | 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]]
| |
| − | | |
| − | Select which ESP-IDF to install, we recommend the lowest version as the higher versions have not been tested.
| |
| − | | |
| − | At the time of writing 5.1 (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]]
| |
| − | | |
| − | 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]]
| |
| − | | |
| − | Select addition tasks, recommend keeping all options checked and click Next.
| |
| − | | |
| − | [[File:ESP32_Setup7.png]]
| |
| − | | |
| − | On the confirmation screen check the paths are correct and click Install
| |
| − | | |
| − | [[File:ESP32_Setup8.png]]
| |
| − | | |
| − | During the installation process you may get some of the following pop-ups appearing
| |
| − | | |
| − | Click Yes to allow Git to be installed
| |
| − | | |
| − | [[File:ESP32_Setup9.png]]
| |
| − | | |
| − | Click Yes to allow Windows PowerShell to be installed
| |
| − | | |
| − | [[File:ESP32_Setup10.png]]
| |
| − | | |
| − | Installation complete
| |
| − | | |
| − | You do not need to run the ESP-IDF command prompt as we will be invoking this from Flowcode:
| |
| − | | |
| − | [[File:ESP32_Setup11.png]]
| |
| − | | |
| − | A PC reboot may be required after installation has been completed.
| |
| − | | |
| − | '''Setting up Flowcode for use with the ESP32 toolchain'''
| |
| − | | |
| − | Copy the location of the esp-idf (e.g. C:\esp-idf) into the
| |
| − | | |
| − | Global Settings > Locations tab.
| |
| − | | |
| − | Or if you have a project loaded
| |
| − | | |
| − | File > Global Settings > Locations tab:
| |
| − | | |
| − | [[File:ESP32_Setup12.png]]
| |
| − | | |
| − | Click OK
| |
| − | | |
| − | '''Flowcode ESP32 Projects'''
| |
| − | | |
| − | When you create a new Flowcode ESP32 project the first time you compile a folder will be created in
| |
| − | the Flowcode project directory with the same name as the Flowcde project file.
| |
| − | | |
| − | The folder contains all the standard build output for an ESP32 project.
| |
| − | | |
| − | The first compilation of a project will take a while to complete – around 5 minutes as all of the ESP32
| |
| − | libraries are pulled in from the ESP-IDF and compiled one by one. After the initial compilation
| |
| − | subsequent compilations will be much faster.
| |
| − | | |
| − | Inside the folder is a file called sdkconfig, this file is a text file that contains the configuration for the
| |
| − | ESP32 device.
| |
| − | | |
| − | Any changes to this file will automatically trigger another extended compilation.
| |
| − | | |
| − | If you connect your ESP board before running Flowcode then the boards COM port will appear in the Flowcode project options.
| |
| − | | |
| − | This will need to be selected and correct for the Compile to Chip menu option to function correctly.
| |
| − | | |
| − | [[File:ESP32_Setup13.png]]
| |
| − | | |
| − | ==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 2022
| |
| − | Python 3
| |
| − | Git
| |
| − | | |
| − | '''Installing ARM GCC Compiler'''
| |
| − | | |
| − | Download the Windows Installer from:
| |
| − | | |
| − | https://developer.arm.com/downloads/-/gnu-rm
| |
| − | | |
| − | [[File:Pico_Toolchain1.png]]
| |
| − | | |
| − | 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]]
| |
| − | | |
| − | | |
| − | 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]]
| |
| − | | |
| − | A PC reboot is recommended after installing CMake.
| |
| − | | |
| − | '''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]]
| |
| − | | |
| − | 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]]
| |
| − | | |
| − | Ensure that it’s installed 'for all users' and add Python 3.9 to the system PATH:
| |
| − | | |
| − | [[File:Pico_Toolchain6.png]]
| |
| − | | |
| − | Disable the MAX_PATH length limit when prompted at the end of the Python installation:
| |
| − | | |
| − | [[File:Pico_Toolchain7.png]]
| |
| − | | |
| − | '''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]]
| |
| − | | |
| − | Ensure you tick the checkbox to allow Git to be used from third-party tools:
| |
| − | | |
| − | [[File:Pico_Toolchain9.png]]
| |
| − | | |
| − | Don't select any NEW! options, leave options as default.
| |
| − | Select "Checkout as is, commit as-is":
| |
| − | | |
| − | [[File:Pico_Toolchain10.png]]
| |
| − | | |
| − | Select "Use Windows' default console window":
| |
| − | | |
| − | [[File:Pico_Toolchain11.png]]
| |
| − | | |
| − | Leave all the defaults Ticked
| |
| − | | |
| − | Check "Enable experimental support for pseudo consoles" during the installation process:
| |
| − | | |
| − | [[File:Pico_Toolchain12.png]]
| |
| − | | |
| − | '''Installing the Pico SDK'''
| |
| − | | |
| − | Use Git to download the Pico SDK to a location on your PC.
| |
| − | | |
| − | For example, install to your user Downloads directory:
| |
| − | | |
| − | ''C:\Users\YourName\Downloads\pico-sdk''
| |
| − | | |
| − | Run a command prompt (type "cmd" at the start search box) and run the following commands:
| |
| − | ''cd Downloads''
| |
| − | | |
| − | ''git clone -b master https://github.com/raspberrypi/pico-sdk.git''
| |
| − | | |
| − | ''cd pico-sdk''
| |
| − | | |
| − | ''git submodule update --init''
| |
| − | | |
| − | '''Setting up Flowcode for use with the Pico toolchain'''
| |
| − | Copy the location of the Pico sdk (e.g. C:\Users\YourName\Downloads\pico-sdk) into the
| |
| − | | |
| − | Global Settings > Locations tab or if you have a project loaded
| |
| − | | |
| − | File > Global Settings > Locations tab:
| |
| − | | |
| − | [[File:Pico_Toolchain13.png]]
| |
| − | | |
| − | '''Programming The Pico'''
| |
| − | | |
| − | The Pico is a free target device.
| |
| − | | |
| − | Run Flowcode & Select ''New Project''
| |
| − | | |
| − | Either right-click on any target & select ''Search...'' and enter ''pico'', then select ''Find Next'':
| |
| − | | |
| − | [[File:Pico_Toolchain14.png]]
| |
| − | | |
| − | Or Go to the Free targets section, expand ''Free targets'' and scroll down and select ''Raspberry_Pi_Pico''
| |
| − | | |
| − | Select ''New <Raspberry_Pi_Pico> Embedded Project:
| |
| − | | |
| − | [[File:Pico_Toolchain15.png]]
| |
| − | | |
| − | | |
| − | '''Sending Your First Program'''
| |
| − | | |
| − | Before sending your flowchart to the Pico, you must first enable boot mode.
| |
| | | | |
| − | To do that, make sure the pico is not connected to your PC.
| + | Click the approriate link below ofr detailed instructions for spacific compiler toolchains. |
| | | | |
| − | Hold the ''BOOTSEL'' down and plug the Pico into your PC.
| |
| | | | |
| − | If you hear the USB connected sound and you also get a popup like this:
| + | [[ESP32 Toolchain]] |
| | | | |
| − | [[File:Pico_Toolchain16.png]] | + | [[Pico Toolchain]] |
| | | | |
| − | Then your Pico is ready to be programmed.
| + | [[Using a new version of XC8]] |
