Skip to content

Commit da83053

Browse files
committed
Draft, in progress
1 parent 8feefc3 commit da83053

11 files changed

+44
-44
lines changed

articles/iot-hub/TOC.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@
235235
- name: Use Azure portal
236236
displayName: create IoT Hub, register device, message routing, delete IoT hub
237237
href: iot-hub-create-through-portal.md
238-
- name: Use Azure IoT Tools for VS Code
238+
- name: Use the Azure IoT Hub extension for Visual Studio Code
239239
displayName: create IoT Hub, register device, message routing, delete IoT hub
240240
href: iot-hub-create-use-iot-toolkit.md
241241
- name: Use Azure PowerShell
@@ -457,9 +457,9 @@
457457
href: iot-hub-raspberry-pi-kit-c-get-started.md
458458
- name: Extended IoT scenarios
459459
items:
460-
- name: Messaging with Azure IoT Tools for VS Code
460+
- name: Messaging with the Azure IoT Hub extension for Visual Studio Code
461461
href: iot-hub-vscode-iot-toolkit-cloud-device-messaging.md
462-
- name: Device management with Azure IoT Tools for VS Code
462+
- name: Device management with the Azure IoT Hub extension for Visual Studio Code
463463
href: iot-hub-device-management-iot-toolkit.md
464464
- name: Device management with IoT extension for Azure CLI
465465
href: iot-hub-device-management-iot-extension-azure-cli-2-0.md
@@ -630,8 +630,8 @@
630630
href: iot-hub-customer-data-requests.md
631631
- name: Azure Roadmap
632632
href: https://azure.microsoft.com/roadmap/?category=iot
633-
- name: Azure IoT Tools
634-
displayName: VS Code, Visual Studio Code, toolkit, azure-iot-toolkit, Azure loT Device Workbench
633+
- name: Azure IoT Hub extension for Visual Studio Code
634+
displayName: VS Code, Visual Studio Code, toolkit, azure-iot-toolkit
635635
href: https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit
636636
- name: Azure IoT Explorer tool
637637
displayName: azure-iot-explorer, Plug and Play

articles/iot-hub/iot-hub-create-use-iot-toolkit.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ The following steps show how to create an IoT Hub without an IoT Project in Visu
5555

5656
## Create an IoT hub and device in an existing IoT project
5757

58-
The following steps show how to create an IoT Hub and register a device to the hub within an existing IoT project in Visual Studio (VS) Code.
58+
The following steps show how to create an IoT hub and register a device to the hub within an existing IoT project in Visual Studio (VS) Code.
5959

6060
This method allows you to provision in Visual Studio Code without leaving your development environment.
6161

@@ -74,37 +74,37 @@ This method allows you to provision in Visual Studio Code without leaving your d
7474

7575
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-resource-group.png" alt-text="A screenshot that shows how to choose a resource group or create a new one in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-resource-group.png":::
7676

77-
1. In the resource group you specified, follow the prompts to select an existing IoT Hub or create a new Azure IoT Hub.
77+
1. In the resource group you specified, follow the prompts to select an existing IoT hub or create a new Azure IoT hub.
7878

79-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png" alt-text="A screenshot that shows the first prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png":::
79+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png" alt-text="A screenshot that shows the first prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png":::
8080

81-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png" alt-text="A screenshot that shows the second prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png":::
81+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png" alt-text="A screenshot that shows the second prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png":::
8282

83-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png" alt-text="A screenshot that shows the third prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png":::
83+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png" alt-text="A screenshot that shows the third prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png":::
8484

85-
1. In the output window, you see the Azure IoT Hub provisioned.
85+
1. In the output window, you see the Azure IoT hub provisioned.
8686

8787
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png" alt-text="A screenshot that shows the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png":::
8888

89-
1. Select or create a new IoT Hub Device in the Azure IoT Hub you provisioned.
89+
1. Select or create a new IoT device in the Azure IoT hub you provisioned.
9090

91-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png" alt-text="A screenshot that shows the fourth prompt in choosing an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png":::
91+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png" alt-text="A screenshot that shows the fourth prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png":::
9292

93-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-device.png" alt-text="A screenshot that shows an example of an existing IoT Hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-device.png":::
93+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-device.png" alt-text="A screenshot that shows an example of an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-device.png":::
9494

95-
1. Now you have an Azure IoT Hub provisioned and a device created in it. The device connection string is saved in VS Code.
95+
1. Now you have an Azure IoT hub provisioned and a device created in it. The device connection string is saved in VS Code.
9696

97-
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT Hub details in the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
97+
:::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT hub details in the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
9898

9999
> [!TIP]
100100
> To delete a device from your IoT hub, use the `Azure IoT Hub: Delete Device` option from the Command Palette. There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-an-iot-hub).
101101
102102
## Next steps
103103

104-
Now that you've deployed an IoT hub using the Azure IoT Tools for Visual Studio Code, explore these articles:
104+
Now that you've deployed an IoT hub using the Azure IoT Hub extension for Visual Studio Code, explore these articles:
105105

106-
- [Use the Azure IoT Tools for Visual Studio Code to send and receive messages between your device and an IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
106+
- [Use the Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and an IoT hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
107107

108-
- [Use the Azure IoT Tools for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
108+
- [Use the Azure IoT Hub extension for Visual Studio Code for Azure IoT Hub device management](iot-hub-device-management-iot-toolkit.md)
109109

110-
- [See the Azure IoT Hub for Visual Studio Code wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki).
110+
- [See the Azure IoT Hub extension for Visual Studio Code wiki page](https://github.com/microsoft/vscode-azure-iot-toolkit/wiki).

articles/iot-hub/iot-hub-device-management-iot-toolkit.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Azure IoT device management with Azure IoT Tools for VSCode
3-
description: Use the Azure IoT Tools for Visual Studio Code for Azure IoT Hub device management, featuring the Direct methods and the Twin's desired properties management options.
2+
title: Azure IoT device management with the Azure IoT Hub extension for VSCode
3+
description: Use the Azure IoT Hub extension for Visual Studio Code for Azure IoT Hub device management, featuring the Direct methods and the Twin's desired properties management options.
44
author: formulahendry
55

66
ms.author: junhan
@@ -9,11 +9,11 @@ ms.topic: how-to
99
ms.date: 01/04/2019
1010
---
1111

12-
# Use Azure IoT Tools for Visual Studio Code for Azure IoT Hub device management
12+
# Use the Azure IoT Hub extension for Visual Studio Code for Azure IoT Hub device management
1313

1414
![End-to-end diagram](media/iot-hub-get-started-e2e-diagram/2.png)
1515

16-
In this article, you learn how to use Azure IoT Tools for Visual Studio Code with various management options on your development machine. [Azure IoT Hub for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
16+
In this article, you learn how to use the [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) with various management options on your development machine. The IoT Hub extension is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
1717

1818
[!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
1919

@@ -35,7 +35,7 @@ Device twins are JSON documents that store device state information (metadata, c
3535
* An active Azure subscription.
3636
* An Azure IoT hub under your subscription.
3737
* [Visual Studio Code](https://code.visualstudio.com/)
38-
* [Azure IoT Hub for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or copy this URL and paste it into a browser window:`vscode:extension/vsciot-vscode.azure-iot-toolkit`.
38+
* [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or copy this URL and paste it into a browser window:`vscode:extension/vsciot-vscode.azure-iot-toolkit`.
3939

4040
## Sign in to access your IoT hub
4141

@@ -49,7 +49,7 @@ Device twins are JSON documents that store device state information (metadata, c
4949

5050
5. The device list will be shown in **Azure IoT Hub Devices** tab in a few seconds.
5151

52-
> [!Note]
52+
> [!NOTE]
5353
> You can also complete the set up by choosing **Set IoT Hub Connection String**. Enter the **iothubowner** policy connection string for the IoT hub that your IoT device connects to in the pop-up window.
5454
5555
## Direct methods
@@ -86,6 +86,6 @@ To send a message from your IoT hub to your device, follow these steps:
8686

8787
## Next steps
8888

89-
You've learned how to use Azure IoT Hub for Visual Studio Code with various management options.
89+
You've learned how to use the Azure IoT Hub extension for Visual Studio Code with various management options.
9090

9191
[!INCLUDE [iot-hub-get-started-next-steps](../../includes/iot-hub-get-started-next-steps.md)]

articles/iot-hub/iot-hub-distributed-tracing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -206,9 +206,9 @@ To change the percentage of messages to be traced from the cloud, you must updat
206206
207207
1. (Optional) Change the sampling rate to a different value, and observe the change in frequency that messages include `tracestate` in the application properties.
208208
209-
### Update by using Azure IoT Hub for Visual Studio Code
209+
### Update by using the Azure IoT Hub extension for Visual Studio Code
210210
211-
1. With Visual Studio Code installed, install the latest version of [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) for Visual Studio Code.
211+
1. With Visual Studio Code installed, install the latest version of the [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit).
212212
213213
1. Open Visual Studio Code, and go to the **Explorer** tab and the **Azure IoT Hub** section.
214214

articles/iot-hub/iot-hub-mqtt-support.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,9 +118,9 @@ If a device can't use the device SDKs, it can still connect to the public device
118118
119119
For more information about how to generate SAS tokens, see the [Use SAS tokens as a device](iot-hub-dev-guide-sas.md#use-sas-tokens-as-a-device) section of [Control access to IoT Hub using Shared Access Signatures](iot-hub-dev-guide-sas.md).
120120

121-
You can also use the cross-platform Azure IoT Tools for Visual Studio Code or the CLI extension command [az iot hub generate-sas-token](/cli/azure/iot/hub#az-iot-hub-generate-sas-token) to quickly generate a SAS token. You can then copy and paste the SAS token into your own code for testing purposes.
121+
You can also use the cross-platform [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or the CLI extension command [az iot hub generate-sas-token](/cli/azure/iot/hub#az-iot-hub-generate-sas-token) to quickly generate a SAS token. You can then copy and paste the SAS token into your own code for testing purposes.
122122

123-
### For Azure IoT Tools
123+
### Using the Azure IoT Hub extension for Visual Studio Code
124124

125125
1. Expand the **AZURE IOT HUB DEVICES** tab in the bottom left corner of Visual Studio Code.
126126

articles/iot-hub/iot-hub-raspberry-pi-kit-c-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,7 @@ You should see the following output that shows the sensor data and the messages
225225

226226
## Read the messages received by your hub
227227

228-
One way to monitor messages received by your IoT hub from your device is to use the Azure IoT Tools for Visual Studio Code. To learn more, see [Use Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
228+
One way to monitor messages received by your IoT hub from your device is to use the Azure IoT Hub extension for Visual Studio Code. To learn more, see [Use the Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
229229

230230
For more ways to process data sent by your device, continue on to the next section.
231231

articles/iot-hub/iot-hub-raspberry-pi-kit-node-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ You should see the following output that shows the sensor data and the messages
249249

250250
## Read the messages received by your hub
251251

252-
One way to monitor messages received by your IoT hub from your device is to use the Azure IoT Tools for Visual Studio Code. To learn more, see [Use Azure IoT Tools for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
252+
One way to monitor messages received by your IoT hub from your device is to use the Azure IoT Hub extension for Visual Studio Code. To learn more, see [Use the Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
253253

254254
For more ways to process data sent by your device, continue on to the next section.
255255

articles/iot-hub/iot-hub-raspberry-pi-web-simulator-get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ You should see the following output that shows the sensor data and the messages
9797

9898
## Read the messages received by your hub
9999

100-
One way to monitor messages received by your IoT hub from the simulated device is to use the Azure IoT Tools for Visual Studio Code. To learn more, see [Use Azure IoT Tools for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
100+
One way to monitor messages received by your IoT hub from the simulated device is to use the Azure IoT Hub extension for Visual Studio Code. To learn more, see [Use the Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and IoT Hub](iot-hub-vscode-iot-toolkit-cloud-device-messaging.md).
101101

102102
For more ways to process data sent by your device, continue on to the next section.
103103

articles/iot-hub/iot-hub-vscode-iot-toolkit-cloud-device-messaging.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Use Azure IoT Tools for VSCode to manage IoT Hub messaging
3-
description: Learn how to use Azure IoT Tools for Visual Studio Code to monitor device to cloud messages and send cloud to device messages in Azure IoT Hub.
2+
title: Use the Azure IoT Hub extension for Visual Studio Code to manage IoT Hub messaging
3+
description: Learn how to use the Azure IoT Hub extension for Visual Studio Code to monitor device to cloud messages and send cloud to device messages in Azure IoT Hub.
44
author: formulahendry
55

66
ms.author: junhan
@@ -10,13 +10,13 @@ ms.date: 01/18/2019
1010
ms.custom: ['Role: Cloud Development']
1111
---
1212

13-
# Use Azure IoT Tools for Visual Studio Code to send and receive messages between your device and IoT Hub
13+
# Use the Azure IoT Hub extension for Visual Studio Code to send and receive messages between your device and IoT Hub
1414

1515
![End-to-end diagram](./media/iot-hub-vscode-iot-toolkit-cloud-device-messaging/e-to-e-diagram.png)
1616

17-
In this article, you learn how to use Azure IoT Tools for Visual Studio Code to monitor device-to-cloud messages and to send cloud-to-device messages. Device-to-cloud messages could be sensor data that your device collects and then sends to your IoT hub. Cloud-to-device messages could be commands that your IoT hub sends to your device to blink an LED that is connected to your device.
17+
In this article, you learn how to use the Azure IoT Hub extension for Visual Studio Code to monitor device-to-cloud messages and to send cloud-to-device messages. Device-to-cloud messages could be sensor data that your device collects and then sends to your IoT hub. Cloud-to-device messages could be commands that your IoT hub sends to your device to blink an LED that is connected to your device.
1818

19-
[Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. This article focuses on how to use Azure IoT Tools for Visual Studio Code to send and receive messages between your device and your IoT hub.
19+
The [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) is a useful extension that makes IoT Hub management and IoT application development easier. This article focuses on how to use the extension to send and receive messages between your device and your IoT hub.
2020

2121
[!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-partial.md)]
2222

@@ -28,7 +28,7 @@ In this article, you learn how to use Azure IoT Tools for Visual Studio Code to
2828

2929
* [Visual Studio Code](https://code.visualstudio.com/)
3030

31-
* [Azure IoT Tools for VS Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or copy and paste this URL into a browser window: `vscode:extension/vsciot-vscode.azure-iot-toolkit`
31+
* [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or copy and paste this URL into a browser window: `vscode:extension/vsciot-vscode.azure-iot-toolkit`
3232

3333
## Sign in to access your IoT hub
3434

@@ -42,7 +42,7 @@ In this article, you learn how to use Azure IoT Tools for Visual Studio Code to
4242

4343
5. The device list will be shown in **Azure IoT Hub Devices** tab in a few seconds.
4444

45-
> [!Note]
45+
> [!NOTE]
4646
> You can also complete the set up by choosing **Set IoT Hub Connection String**. Enter the **iothubowner** policy connection string for the IoT hub that your IoT device connects to in the pop-up window.
4747
4848
## Monitor device-to-cloud messages

0 commit comments

Comments
 (0)