Quick start: Workbench
Installation
Windows
- Download the Windows installer (.exe file).
- Double-click on the .exe file to begin installation.
- Continue with the instructions for all operating systems, below.
- Windows 7, 8, or 10 is required.
NOTE: due to limitations with the local compiler's build system, usernames (or paths) with spaces cannot be supported at this time
Mac
- Download the Mac installer (.zip file)
- Double-click on the .zip file to extract it.
- Double-click on the Particle Workbench Installer to begin installation.
- Continue with the instructions for all operating systems, below.
- Mac OS 10.12.0 (Sierra) or newer is required
NOTE: If you are running Mac OS 10.15 (Catalina), please use Safari to download and unpack the installer .zip
file (settings) - unpacking with the default Archive utility will not work
Linux
- Download the Linux installer (.AppImage file)
- Right-click on the .AppImage file and select the Allow executing file as program option. Alternatively, use the
chmod a+x
command to enable execution of the .AppImage file.
- Double-click on the .AppImage to begin installation.
- Continue with the instructions for all operating systems, below.
- You will be prompted to authenticate as the super user up to 4 times during installation, for /usr/bin/apt and /bin/readlink:
- Ubuntu Linux (or other Debian-style distribution) is required to use the installer.
- If you are having difficulties, there are additional tips in the FAQ.
All Operating Systems
After clicking through the first two screens, you'll reach the first option. It is not necessary to install the Azure IoT toolkit.
Finally, when you reach the end of the install, both progress bars will reach 100% and the Next button will be enabled. You do need to click Next, otherwise you'll stay in that screen forever.
When prompted, be sure to click Install when asked to Please install workbench dependencies.
VS Code already installed
If you already have VS Code installed, you can add in the Particle workbench extension.
Open the VisualStudio Marketplace in your web browser.
Click the green Install button and allow it to be opened in Visual Studio Code.
- Within Visual Studio code, click the green Install button to confirm the installation.
- Note that there will be a small confirmation window that pops up in the lower right corner of the window. Make sure you confirm the installation there.
The core installation will take a few minutes. There's an indicator at the top of the extensions panel that shows the install is still in progress. When complete, you'll be prompted to reload. Click the Reload Now button.
After reload, some more components will be installed and you will be prompted to install the Particle Local Compiler. This is recommended.
Create a project
To create your first project, you'll start with the Command Palette.
The Command Palette provides access to many commands such as open files, search for symbols, and see a quick outline of a file, all using the same interactive window. It can be invoked via cmd+shift+p
on Mac OS or ctrl+shift+p
on Linux and Windows.
In the Command Palette select Particle: Create New Project. The matching is very flexible - you don't have to type that whole thing in or scroll through the list. You could just type project and that would typically be the first match.
A small popup window will appear in the lower right corner of the window. It's easy to miss if you're not expecting it. Use the Open button to select the parent directory.
For example, if you had a directory named "Projects" in your "Documents" directory where you kept your Workbench projects, you'd select Projects.
Then you'll be prompted for the name of your project. This will create a new directory within the directory you just selected. Your project files will be in that directory.
Your first project workspace should look something like this:
Compile a project
Before you can build in the cloud (the way Particle Web IDE and Particle CLI normally build), you need to select the device you wish to build for.
From the Command Palette select Particle: Configure Project for Device.
Then the device OS version you'd like to build for:
Then the type of device to you'd like to build for:
And finally the name or device ID of the device you want to flash to. You can leave this blank if you're going to flash by USB, or just want to test building.
To compile your program and download the binary, open the Command Palette and select Particle: Cloud Compile. To compile your program in the cloud and flash it to the selected device over-the-air, select Particle: Cloud Flash.
Migrate from the Web IDE
For larger projects, development teams, and products, we recommend Particle Workbench instead of the Web IDE. If you are currently using the Web IDE and want to migrate to using Workbench, you can use the Web IDE Export Tool to export your projects for use with Workbench.
Learn More
You can learn more about Workbench features in the Particle Workbench Tutorial.