Manual Installation

We suggest you use the installation package to install everything automatically. If you have problems on using the one-click install experience, follow these steps to manually install tools and packages for DevKit development.

Windows

Step 1. Install Azure CLI 2.0 MSI

Follow the official guide to install Azure CLI 2.0 with MSI:

Download and run MSI for the Windows command line from: https://aka.ms/InstallAzureCliWindows

Step 2. Install Arduino IDE

The Visual Studio Code Arduino extension relies on the Arduino IDE. Download and install the Arduino IDE for Windows. Make sure you download the Windows Installer version.

Step 3. Install Visual Studio Code

Download and install Visual Studio Code for Windows. This is the primary development tool for building DevKit IoT applications.

Step 4. Download the latest package

  1. Download Windows Installer to install Node.js.

  2. Download the .zip file that contains required task scripts for DevKit development in VS Code.

Download

Locate the .zip and extract it to your Windows user folder (C:\Users\[your name]). Then launch Command Prompt (cmd) and run the following commands to configure:

  cd C:\Users\[your name]\azure-board-cli

  npm install

Step 5. Install the VS Code extension for Arduino

You can install Azure Marketplace extensions directly in Visual Studio Code. Select the extensions icon in the left pane, search for Arduino, and then select Install:

installation-extensions

Step 6. Install the DevKit board package

Add the DevKit board by using Board Manager in Visual Studio Code.

  1. Use Ctrl+Shift+P to open the command palette, type Arduino, and then find and select Arduino: Board Manager.

  2. Select Additional URLs at the lower right. installation-additional-urls

  3. In the settings.json file, add a line at the bottom of the USER SETTINGS pane and save.
     "arduino.additionalUrls": "https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json"
    

    installation-settings-json

  4. In Board Manager, search for az3166 and install the latest version. installation-az3166

ST-Link/V2 driver is required to communicate with the DevKit.

  1. Download the driver from STMicro product page.

  2. Extract the .zip file and double click stlink_winusb_install.bat to install: installation-st-link

You now have all the necessary tools and packages installed for Windows.

macOS

Step 1. Install Azure CLI 2.0

Follow the official guide to install Azure CLI 2.0. We recommend install with Homebrew:

  1. If you don’t have it already, install Homebrew by following the Homebrew installation instructions.

  2. If you have previously installed the CLI manually, follow the manual uninstall instructions.

  3. Update your local Homebrew repositories.
      brew update
    
  4. Install the azure-cli package.
      brew install azure-cli
    

Step 2. Install Arduino IDE

The Visual Studio Code Arduino extension relies on the Arduino IDE.

  1. Download the Arduino IDE for macOS.

  2. Extract downloaded .zip file.

  3. Drag and drop Arduino.app into Applications folder to install.

Step 3. Install Visual Studio Code

Download and install Visual Studio Code for macOS. This is the primary development tool for building DevKit IoT applications.

Step 4. Download the latest package

  1. Install Node.js. You can use popular macOS package manager Homebrew or pre-built installer to install it.

  2. Download the .zip file that contains required task scripts for DevKit development in VS Code.

Download

Locate the .zip file and extract it. Then start the Terminal app and run the following commands:

a. Move extracted folder to your macOS user folder:

  mv [.zip extracted folder]/azure-board-cli ~/. ; cd ~/azure-board-cli

b. Install npm packages:

  npm install

Step 5. Install the VS Code extension for Arduino

You can install Azure Marketplace extensions directly in Visual Studio Code.

  1. Select the extensions icon in the left pane, search for Arduino, and then select Install: installation-extensions

  2. Open Preference > Settings, add a line within the USER SETTINGS pane and save:

      "arduino.path": "/Applications"
    

Note: Make sure the Arduino path is set the right location you have installed your Arduino IDE.

Step 6. Install the DevKit board package

Add the DevKit board by using Board Manager in Visual Studio Code.

  1. Use Cmd+Shift+P to open the command palette, type Arduino, and then find and select Arduino: Board Manager.

  2. Select Additional URLs at the lower right. installation-additional-urls

  3. In the settings.json file, add a line within the USER SETTINGS pane and save:
     "arduino.additionalUrls": "https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json"
    

    installation-settings-json

  4. In Board Manager, search for az3166 and install the latest version. installation-az3166

You now have all the necessary tools and packages installed for macOS.

Next Steps

You are all set! It’s time to build your first IoT application by following instructions in Projects Catalog.