Add embedded features to guides (#345)

gcampbell-msft · web-flow · commit 47f7d780cab1 · 2022-07-26T08:42:54.000-04:00
* add tool windows to gsg

* updating getting started guides in order to include embedded tools and link to public docs

* remove unused images

* remove images

* fix names

* fix names

* update links

* changes based on PR comments
diff --git a/MXChip/AZ3166/VS.md b/MXChip/AZ3166/VS.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio to build, flash, and debug with the **MXChip AZ3166 IoT DevKit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#create-the-cloud-components).
 
-1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#add-configuration).
+1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -83,6 +83,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio's Embedded Tooling
+
+Visual Studio now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio).
+
+> If you can't find these tools, ensure that you have the `Linux and embedded development with C++` workload and the `Embedded and IoT tools` component installed on your Visual Studio instance.
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/MXChip/AZ3166/vscode.md b/MXChip/AZ3166/vscode.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio Code to build, flash, and debug with the **MXChip AZ3166 IoT DevKit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#create-the-cloud-components).
 
-1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-mxchip-az3166#add-configuration).
+1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-mxchip-az3166#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -144,6 +144,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio Code's Embedded Tooling
+
+Visual Studio Code now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio-code), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio-code), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio-code).
+
+> Note that if you don't see the aforementioned tooling, ensure that you have the extensions installed, [Embedded Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-embedded-tools) and [Serial Monitor](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-serial-monitor)
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/NXP/MIMXRT1060-EVK/VS.md b/NXP/MIMXRT1060-EVK/VS.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio to build, flash, and debug with the **NXP MIMXRT1060-EVK Evaluation Kit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#create-the-cloud-components).
 
-1.	[Configure Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#add-configuration).
+1.	[Configure Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -89,6 +89,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio's Embedded Tooling
+
+Visual Studio now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio).
+
+> If you can't find these tools, ensure that you have the `Linux and embedded development with C++` workload and the `Embedded and IoT tools` component installed on your Visual Studio instance.
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/NXP/MIMXRT1060-EVK/vscode.md b/NXP/MIMXRT1060-EVK/vscode.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio Code to build, flash, and debug with the **NXP MIMXRT1060-EVK Evaluation Kit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#create-the-cloud-components).
 
-1.	[Configure Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#add-configuration).
+1.	[Configure Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-nxp-mimxrt1060-evk#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -146,6 +146,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio Code's Embedded Tooling
+
+Visual Studio Code now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio-code), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio-code), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio-code).
+
+> Note that if you don't see the aforementioned tooling, ensure that you have the extensions installed, [Embedded Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-embedded-tools) and [Serial Monitor](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-serial-monitor)
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/STMicroelectronics/B-L475E-IOT01A/VS.md b/STMicroelectronics/B-L475E-IOT01A/VS.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio to build, flash, and debug with the **STMicroelectronics B-L475E-IOT01A Discovery Kit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#create-the-cloud-components).
 
-1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#add-configuration).
+1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -70,11 +70,11 @@ This section shows how to configure your development environment with the new `v
     "C:\Program Files\Microsoft Visual Studio\2022\Preview\Common7\IDE\devenv"
 
 1. Ensure that both the Configure Preset and the Build Preset are set to "arm-gcc-cortex-m4"
-    
+
     ![configuration-choice](../../docs/media/vs-preset-configuration-m4.png)
 
 1. Ensure that the "Launch" target is selected as the Debug Target.
-    
+
     ![debug-target-choice](../../docs/media/vs-debug-target-stm32l4.png)
 
 1. Press `F5` to start debugging the application.
@@ -83,6 +83,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio's Embedded Tooling
+
+Visual Studio now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio).
+
+> If you can't find these tools, ensure that you have the `Linux and embedded development with C++` workload and the `Embedded and IoT tools` component installed on your Visual Studio instance.
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/STMicroelectronics/B-L475E-IOT01A/vscode.md b/STMicroelectronics/B-L475E-IOT01A/vscode.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio Code to build, flash, and debug with the **STMicroelectronics B-L475E-IOT01A Discovery Kit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#create-the-cloud-components).
 
-1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l475e#add-configuration).
+1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l475e#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -144,6 +144,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio Code's Embedded Tooling
+
+Visual Studio Code now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170).
+
+> Note that if you don't see the aforementioned tooling, ensure that you have the extensions installed, [Embedded Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-embedded-tools) and [Serial Monitor](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-serial-monitor)
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/STMicroelectronics/B-L4S5I-IOT01A/VS.md b/STMicroelectronics/B-L4S5I-IOT01A/VS.md
@@ -2,13 +2,13 @@
 
 This guide describes how to use Visual Studio to build, flash, and debug with the **STMicroelectronics B-L4S5I-IOT01A Discovery Kit**.
 
-This is a companion to the [Quickstart Guide](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l4s5i). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
+This is a companion to the [Quickstart Guide](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l4s5i). Please ensure you have completed the following steps of the Quickstart Guide before continuing.
 
-1.	[Clone the repo for the quickstart](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#clone-the-repo-for-the-quickstart).
+1.	[Clone the repo for the quickstart](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#clone-the-repo-for-the-quickstart).
 
-1.	[Create the cloud components](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#create-the-cloud-components).
+1.	[Create the cloud components](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#create-the-cloud-components).
 
-1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/en-us/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#add-configuration).
+1.	[Configure Wi-Fi and Azure IoT connection settings](https://docs.microsoft.com/azure/iot-develop/quickstart-devkit-stm-b-l4s5i#add-configuration).
 
  _*Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.*_
 
@@ -83,6 +83,12 @@ This section shows how to configure your development environment with the new `v
 
 1. Press `F5` to resume execution. The debugger is now running and connected the device.
 
+## Using Visual Studio's Embedded Tooling
+
+Visual Studio now supports additional tooling to help embedded programmers debug their applications: a [Peripheral Viewer](https://docs.microsoft.com/cpp/embedded/peripheral-view?view=msvc-170&tabs=visual-studio), a [RTOS Viewer](https://docs.microsoft.com/cpp/embedded/rtos-view?view=msvc-170&tabs=visual-studio), and a [Serial Monitor](https://docs.microsoft.com/cpp/embedded/serial-monitor?view=msvc-170&tabs=visual-studio).
+
+> If you can't find these tools, ensure that you have the `Linux and embedded development with C++` workload and the `Embedded and IoT tools` component installed on your Visual Studio instance.
+
 ## Restoring Your Development Environment
 
 `vcpkg-ce` only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:
diff --git a/STMicroelectronics/B-L4S5I-IOT01A/vscode.md b/STMicroelectronics/B-L4S5I-IOT01A/vscode.md
