microsoft / vscode-azure-iot-toolkit

Azure IoT Hub extension for Visual Studio Code
https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit
Other
73 stars 58 forks source link
azure-iot azure-iot-edge azure-iot-toolkit azure-iothub iot vscode-extension

Azure IoT Hub

Join the chat at https://gitter.im/Microsoft/azure-iot-toolkit Marketplace Version

Overview

Interact with Azure IoT Hub, IoT Device Management, IoT Edge Management, IoT Hub Device Simulation, IoT Hub Code Generation and IoT Hub Device Provisioning Service.

Device Explorer

The Wiki page includes a comprehensive getting started guide as well as detailed usage instructions of the following features:

Prerequisites

  1. In Explorer of VS Code, click "Azure IoT Hub" in the bottom left corner.

    Click Device Explorer

  2. Click "Set IoT Hub Connection String" in context menu.

    Set Connection String

  3. An input box will pop up, then enter your IoT Hub Connection String (It is one-time configuration, and please make sure it is IoT Hub Connection String not Device Connection String. The format is HostName=<my-hub>.azure-devices.net;SharedAccessKeyName=<my-policy>;SharedAccessKey=<my-policy-key>).

    Enter Connection String

  4. The devices list will be shown.

    Device Explorer

Sign in to Azure

Instead of copying and pasting to set IoT Hub Connection String, you could sign in to Azure to select IoT Hub from your Azure Subscription.

  1. Click "Select IoT Hub" in context menu.

    Select IoT Hub

  2. If you have not signed in to Azure, a pop-up will show to let you sign in to Azure.

  3. After you sign in, your Azure Subscription list will be shown, then select an Azure Subscription.

  4. Your IoT Hub list will be shown, then select an IoT Hub.

  5. The devices and endpoints list will be shown.

    IoT Hub Explorer

Device Provisioning Service Explorer

  1. Open "Azure" view on the Activity Bar, and expand "IOT HUB DEVICE PROVISIONING SERVICE".

DPS Explorer

  1. If you're not signed in, click "Sign in to Azure..." to sign in.

  2. Expand one subscription to start exploring your device provisioning services.

Code Generation

Code Generation

Code Snippets

Trigger Content
iotSendD2CMessage Send D2C message to IoT Hub
iotMonitorD2CMessage Monitor D2C message for IoT Hub
iotSendC2DMessage Send C2D message to device
iotMonitorC2DMessage Monitor C2D message from IoT Hub
iotCallDirectMethods Send direct methods to device
iotReceiveDirectMethods Receive direct methods from IoT Hub

Snippet

After code snippet is created, you need to install corresponding npm package (e.g. azure-iot-device-mqtt) to run the code snippet. If you want to 'Run Code' directly, you need to install Code Runner.

Configuration

IoT Hub Consumer Group (default is "$Default"):

{
    "azure-iot-toolkit.iotHubConsumerGroup": "$Default"
}

The time span (in minutes) of monitoring D2C message before current time (default is 0):

{
    "azure-iot-toolkit.monitorD2CBeforeNowInMinutes": 0
}

Whether to show verbose info when monitoring messages (default is false):

{
    "azure-iot-toolkit.showVerboseMessage": false
}

Whether to stringify device-to-cloud messages (default is false):

{ 
    "azure-iot-toolkit.iotHubD2CMessageStringify": false
}

Whether to show IoT Hub info when IoT Hub Connection String is not set (default is true):

{ 
    "azure-iot-toolkit.showIoTHubInfo": true
}

Whether to enable auto refresh of tree view (default is false):

{ 
    "azure-iot-toolkit.treeViewAutoRefreshEnable": false
}

Time interval in seconds for tree view auto refresh, auto refresh has to be enabled for it to work. (default is 60):

{ 
    "azure-iot-toolkit.treeViewAutoRefreshIntervalInSeconds": 60
}

Resources

❤️ Contributors

Thanks to all the contributors!

Data/Telemetry

This project collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. If you don’t wish to send usage data to Microsoft, you can set the telemetry.enableTelemetry setting to false. Learn more in our FAQ.