Azure IoT Hub extension for Visual Studio Code

azure-iot azure-iot-edge azure-iothub azure-iot-toolkit iot vscode-extension

Перейти к файлу

formulahendry 767014eab2 Add filters and defaultUri for dialog options		2017-11-08 14:15:43 +08:00
.vscode	Add unit test (#2 )	2017-08-16 10:27:41 +08:00
images	Select IoT Hub with Azure login (#18 )	2017-09-29 16:24:21 +08:00
resources	Show different icon for connected devices	2017-06-23 17:16:12 +08:00
snippets	Code snippet for Direct Methods	2017-03-13 14:13:30 +08:00
src	Add filters and defaultUri for dialog options	2017-11-08 14:15:43 +08:00
test	Select IoT Hub with Azure login (#18 )	2017-09-29 16:24:21 +08:00
.gitignore	Update image path in README	2017-08-21 12:58:53 +08:00
.travis.yml	Select IoT Hub with Azure login (#18 )	2017-09-29 16:24:21 +08:00
.vscodeignore	JavaScript code snippet to send/monitor D2C message	2017-03-06 15:10:54 +08:00
CHANGELOG.md	Bump version to 0.3.0	2017-10-17 15:29:01 +08:00
CONTRIBUTING.md	Add CONTRIBUTING.md	2017-03-02 20:14:47 +08:00
README.md	Improvement (#19 )	2017-10-17 11:37:10 +08:00
appveyor.yml	Fix CI failure due to azure-iothub breaking change	2017-03-01 22:34:19 +08:00
logo.png	Change logo folder	2017-03-06 15:21:15 +08:00
package-lock.json	Make Edge device deployment work	2017-11-08 14:15:43 +08:00
package.json	Handle Linux shell on Windows and sudo on Linux	2017-11-08 14:15:43 +08:00
tsconfig.json	Send/monitor message for Event Hub (#1 )	2017-02-27 17:13:31 +08:00
tslint.json	Update version to 0.2.1, update BI, handle devices with X.509 cert (#9 )	2017-08-24 14:40:05 +08:00

README.md

Azure IoT Toolkit

Interact with Azure IoT Hub, IoT Device Management, IoT Hub Code Snippets.

Device Explorer

Device management
- List devices
- Get device info
- Create device
- Delete device
Interact with Azure IoT Hub
- Send D2C message to IoT Hub
- Monitor IoT Hub D2C message
- Send C2D message to device
- Monitor C2D message from IoT Hub
- Invoke Direct Method
- Get/update Device Twin

Prerequisites

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

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

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>).

The device list will be shown.

NOTE: You could also go to File > Preferences > Settings (Code > Preferences > Settings on Mac), update the config of azure-iot-toolkit.iotHubConnectionString to change your IoT Hub Connection String.

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.

Click "Select IoT Hub" in context menu.

If you have not signed in to Azure, a pop-up will show to let you sign in to Azure.
After you sign in, your Azure Subscription list will be shown, then select an Azure Subscription.
Your IoT Hub list will be shown, then select an IoT Hub.
The device list will be shown.

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

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 Connection String:

{
    "azure-iot-toolkit.iotHubConnectionString": "HostName=<my-hub>.azure-devices.net;SharedAccessKeyName=<my-policy>;SharedAccessKey=<my-policy-key>"
}

Device Connection String:

{
    "azure-iot-toolkit.deviceConnectionString": "HostName=<my-hub>.azure-devices.net;DeviceId=<known-device-id>;SharedAccessKey=<known-device-key>"
}

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

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

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 Connection String Input Box on startup (default is true):

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

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

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