IoT Utility

Integrate PlatformIO into Visual Studio Code on top of PlatformIO Core. Cross-platform Build System without external dependencies to the OS software: 550+ embedded boards, 25+ development platforms, 15+ frameworks. Arduino and ARM mbed compatible.

Atmel AVR & SAM, Espressif 8266 & 32, Freescale Kinetis, Intel ARC32, Lattice iCE40, Microchip PIC32, Nordic nRF51, NXP LPC, Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, ARM mbed, libOpenCM3, ESP8266, etc.

What's New in v0.3.0

Discover devices connected via Ethernet, Wi-Fi and USB: Press F1 and then select/type IoT Utility: Discover Device. (Make sure you have installed device-discovery-cli)

	IP Address    MAC Address       Type                                    Host Name

	10.172.14.69  08:00:27:d7:27:ef raspberrypi (Raspberry Pi)              raspberrypi
	10.172.15.84  00:15:5d:0f:9d:01 tessel (Tessel 2)                       tessel2
	10.172.14.219 00:0c:29:35:fa:9f huzzah (Adafruit HUZZAH ESP8266)
	10.172.15.98  78:2b:cb:b5:1c:9c ?

Note

If you want to build IoT projects connected to an IoT cloud service. You could take a look at aka.ms/azure.iot for Microsoft Azure IoT projects and resources.

If you are already using Azure IoT services, you could use Azure IoT Toolkit extension for better development experience.

Features

• Build PlatformIO project specified in Project Configuration File platformio.ini
• Upload firmware to devices specified in Project Configuration File platformio.ini
• Open Serial Monitor
• Set baud rate for Serial Monitor
• Search for library in PlatformIO Library Registry
• Install library from PlatformIO Library Registry
• Quick way to open PlatformIO Terminal
• Automatically or manually add Include Path to c_cpp_properties.json for C/C++ extension
• Combined Build, Upload and Open Serial Monitor with one command
• Discover devices connected via Ethernet, Wi-Fi and USB

Prerequisites

• Install PlatformIO Core

Setup

• Use existing project

  If you have an existing PlatformIO project, open the project folder directly in VS Code

• Create new project

  In terminal, run platformio init --board <your_board_identifier> to initialize a new PlatformIO project, then open the project folder in VS Code. Refer to User Guide for platformio init command. For how to find Board Identifier, you could refer to this.

Usage

• Build PlatformIO project: Use shortcut Ctrl+Alt+B, or press F1 and then select/type PlatformIO: Build, or right click the Text Editor and then click PlatformIO: Build in context menu

• Upload firmware to devices: Use shortcut Ctrl+Alt+U, or press F1 and then select/type PlatformIO: Upload, or right click the Text Editor and then click PlatformIO: Upload in context menu

• Open Serial Monitor: Use shortcut Ctrl+Alt+S, or press F1 and then select/type PlatformIO: Open Serial Monitor, or right click the Text Editor and then click PlatformIO: Open Serial Monitor in context menu

• Search for library: Click the Library item in the Status Bar at the bottom, or press F1 and then select/type PlatformIO: Search Library, then type the query to search for library. Refer to the User Guide for the query syntax.

• Install library: Click the Download icon in the Status Bar at the bottom, or press F1 and then select/type PlatformIO: Install Library, then type library id or name to install. Refer to the User Guide for the detailed usage.

• Quick way to open PlatformIO Terminal: Click the Terminal icon in the Status Bar at the bottom, or press F1 and then select/type PlatformIO: Open Terminal

• Add Include Path to c_cpp_properties.json for C/C++ extension: Press F1 and then select/type PlatformIO: Add Include Path to Settings. Wait for some seconds, then the PlatformIO libraries will be automatically added into Include Path of c_cpp_properties.json. (Note: Do not modify c_cpp_properties.json manually since the c_cpp_properties.json will be fully regenerated and your manual changes will be lost.)

• Combined Build, Upload and Open Serial Monitor with one command: Click the Right Arrow icon in the Status Bar at the bottom, or use shortcut Ctrl+Alt+A, or press F1 and then select/type PlatformIO: Build, Upload and Open Serial Monitor. Build, Upload and Open Serial Monitor will be run one by one.

• Discover devices connected via Ethernet, Wi-Fi and USB: Press F1 and then select/type IoT Utility: Discover Device. (Make sure you have installed device-discovery-cli)

	IP Address    MAC Address       Type                                    Host Name

	10.172.14.69  08:00:27:d7:27:ef raspberrypi (Raspberry Pi)              raspberrypi
	10.172.15.84  00:15:5d:0f:9d:01 tessel (Tessel 2)                       tessel2
	10.172.14.219 00:0c:29:35:fa:9f huzzah (Adafruit HUZZAH ESP8266)
	10.172.15.98  78:2b:cb:b5:1c:9c ?

Settings

• platformio.baudRate: Set baud rate for Serial Monitor. (Default is 9600)
• platformio.showHelpInfo: Whether to show help info when opening PlatformIO Terminal. (Default is true)
• platformio.autoUpdateIncludes: Whether to add Include Path to c_cpp_properties.json automatically. (Default is true)

Telemetry data

By default, anonymous telemetry data collection is turned on to understand user behavior to improve this extension. To disable it, update the settings.json as below:

{
    "platformio.enableTelemetry": false
}

Change Log

See Change Log here

Issues

Currently, the extension is in the very initial phase. If you find any bug or have any suggestion/feature request, please join the chat on Gitter or submit the issues to the GitHub Repo.

Contributions

Contributions are warmly welcome! Please follow the Contribution Guide to setup development environment.