Repo sync for protected CLA branch (#4061)

* add initial doc stubs

* Initial docs push, contains stubs for some files and a stub for a landing page

* update some links

* add more cards and links to the Hub page

* fix error

* remove monikor's so it's easy to test, fix rtos-view.md path

* fix link

* add more to the sidebar

* update peripheral view by consolidating to the table, change things to objects in rtos-view

* add tabs

* forgot to end tabbed section

* fix items after adding tabs

* update h1

* slightly fix some wording

* add link from C++ and C workloads, features, and libraries to embedded hub

* move into own directory so that the url is better

* fix some warnings

* remove next steps that pointed to linux items

* prefer tabbed view vs table

* attempt to add moniker

* attempt highest moniker in range

* assign to a specific version

* push again to get new build

* add '=' sign to try and test it

* add metadata for msvc-170

* add moniker range for index.yml

* remove inline moniker since we only need it on the files themselves

* Follow up 4221 Acrolinx score for TN035

* Fix heading style

* Update  C++-specific template info

* Fix links to raw and rendered markdown

* Edit pass for house style

* add 'while debugging' for peripheral-view

* Fix table issue, stray punctuation

Co-authored-by: Garrett Campbell <[email protected]>
Co-authored-by: Colin Robertson <[email protected]>
Co-authored-by: Bryan Gold <[email protected]>
Co-authored-by: Alma Jenks <[email protected]>

Author: 5 people

docs/embedded/download-and-install-the-embedded-tooling.md

@@ -0,0 +1,59 @@
+---
+title: "Install the Embedded tooling in Visual Studio and Visual Studio Code"
+description: "How to download and install the Embedded tooling in Visual Studio and Visual Studio Code."
+ms.date: "07/12/2022"
+ms.custom: intro-installation
+author: gcampbell-msft
+ms.author: gcampbell
+monikerRange: '>=msvc-170'
+---
+
+# Download and install the Embedded tooling
+
+# [Visual Studio](#tab/visual-studio)
+
+In Visual Studio 2022 and later versions, you can use the Visual Studio IDE on Windows to edit and debug embedded projects. Use tools such as the [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects.
+
+To use the embedded development tools in Visual Studio, you must install the required **Linux and embedded development with C++** workload.
+
+## To install the Linux and embedded development with C++ workload
+
+1. Enter "Visual Studio Installer" in the Windows search box:
+
+   ![Screenshot showing the Windows search box.](../linux/media/visual-studio-installer-search.png)
+
+1. Open the Visual Studio Installer. In Visual Studio Installer, choose **Modify** next to your installation of Visual Studio, and then select the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux and embedded development with C++** workload.
+
+   ![Screenshot showing the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png)
+
+1. Choose **Modify** to continue with the installation.
+
+When installation completes, you're ready to use Visual Studio for embedded development.
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+## Install the Embedded extensions in Visual Studio Code
+
+Microsoft provides an extension to Visual Studio Code that lets you use embedded tools such as a [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and a [Serial Monitor](./serial-monitor.md). Now you can use Microsoft tools to help debug your Linux-based embedded applications.
+
+## To install the embedded extensions for Visual Studio Code
+
+1. Enter "Visual Studio Code" in the Windows search box:
+
+    ![Search-Visual-Studio-Code](media/windows-search-vscode.png)
+
+1. Open Visual Studio Code. In Visual Studio Code, open the **Extensions Pane**.
+
+    ![Visual Studio Code Extensions Pane](media/extensions-pane.png)
+
+1. Search for and install the [Embedded Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-embedded-tools) extension.
+
+    ![Embedded Tools extension](media/embedded-tools-extension.png)
+
+1. Search for and install the [Serial Monitor](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-serial-monitor) extension.
+
+    ![Serial Monitor extension](media/serial-monitor-extension.png)
+
+When installation completes, you're ready to use Visual Studio Code for embedded development.
+
+---

docs/embedded/index.yml

@@ -0,0 +1,59 @@
+### YamlMime:Landing
+title: Embedded development with C++ | Create and debug embedded applications # < 60 chars
+summary: Use Embedded tooling in Visual Studio 2022 and later to create and debug applications for Embedded. # < 160 chars
+
+metadata:
+  title: Embedded development with C++
+  description: Learn how to use Embedded tooling in Visual Studio and Visual Studio Code to create and debug applications for Linux.
+  ms.topic: landing-page
+  author: gcampbell-msft
+  ms.author: gcampbell
+  ms.date: 07/12/2022
+  ms.custom: intro-landing-hub
+  monikerRange: '>=msvc-170'
+
+# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
+
+landingContent:
+# Cards and links should be based on top customer tasks or top subjects
+# Start card title with a verb
+
+  # Card
+  - title: Build and debug embedded projects in Visual Studio and Visual Studio Code
+    linkLists:
+      - linkListType: get-started
+        links:
+          - text: Download the Embedded workload in Visual Studio and Visual Studio Code
+            url: download-and-install-the-embedded-tooling.md
+      - linkListType: how-to-guide
+        links:
+          - text: Getting started guides
+            url: https://github.com/azure-rtos/getting-started
+      - linkListType: tutorial
+        links:
+          - text: Embedded Software Development in Visual Studio
+            url: https://devblogs.microsoft.com/cppblog/visual-studio-embedded-development/
+          - text: Embedded Software Development in Visual Studio Code
+            url: https://devblogs.microsoft.com/cppblog/vscode-embedded-development/
+      - linkListType: whats-new
+        links:
+          - text: Zephyr support in Visual Studio and Visual Studio Code
+            url: https://devblogs.microsoft.com/cppblog/serial-and-zephyr-support/
+
+  - title: Embedded Tooling in Visual Studio and Visual Studio Code
+    linkLists: 
+      - linkListType: reference
+        links:
+          - text: Peripheral Viewer
+            url: ./peripheral-view.md
+          - text: RTOS Viewer
+            url: ./rtos-view.md
+          - text: Serial Monitor
+            url: ./serial-monitor.md
+
+  - title: More embedded tools
+    linkLists:
+      - linkListType: whats-new
+        links:
+          - text: Bootstrap your development environment
+            url: https://devblogs.microsoft.com/cppblog/vcpkg-artifacts/

docs/embedded/media/embedded-tools-extension.png

@@ -0,0 +1,32 @@
+---
+title: "Peripheral View"
+ms.date: "07/12/2022"
+description: "Peripheral View that allows users to view and manipulate peripherals."
+author: gcampbell-msft
+ms.author: gcampbell
+monikerRange: '>=msvc-170'
+---
+# Peripheral View
+
+## Overview
+
+The Peripheral View allows embedded developers to view and manipulate registers and peripherals defined in SVD (System View Description) files while debugging.
+
+# [Visual Studio](#tab/visual-studio)
+
+![Peripheral View in VS](media/peripheral-viewer.png)
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+![Peripheral View in Visual Studio Code](media/peripheral-viewer-vscode.png)
+
+---
+
+## Capabilities
+
+| Capability | Description | Instructions | Keyboard shortcuts |
+|--|--|--|--|
+| Navigate peripherals | Navigate the peripheral tree view by collapsing and expanding components in the tree view. | Scroll to view all of the peripherals. Select the caret on each item to expand or collapse the view. | Use the **Up** or **Down** arrow keys to scroll. Use the **Left** and **Right** arrow keys to expand or collapse the view. |
+| Edit peripheral values | Modify writeable peripheral values. | Select the peripheral value to edit. Use the **Enter** key to submit that value. | Use the **F2** key to edit, **Esc** to cancel editing, and **Enter** to submit edits. |
+| Access memory | View the memory locations of peripherals. | Select the linked memory addresses to view. | Use **Tab** to select the link, and **Enter** to navigate to the link. |
+| Pin peripherals | Pin important peripherals to the top of the view. | Select the pin icon to pin or unpin peripherals. | Use **Tab** to select the pin icon, and **Enter** to pin or unpin it. |

docs/embedded/media/extensions-pane.png

@@ -0,0 +1,53 @@
+---
+title: "RTOS Object Views"
+ms.date: "07/12/2022"
+description: "RTOS View that allows users to view RTOS data of their application."
+author: gcampbell-msft
+ms.author: gcampbell
+monikerRange: '>=msvc-170'
+---
+# RTOS (Real time operating system) Object View
+
+## Overview
+
+The RTOS Object View allows users to view various components of an RTOS while debugging their application.
+
+# [Visual Studio](#tab/visual-studio)
+
+![RTOS View in VS](media/rtos-threads.png)
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+![RTOS View in VSCode](media/rtos-threads-vscode.png)
+
+---
+
+## Supported RTOSes and their supported object types
+
+- ThreadX
+  - All of the types listed in **Available object types**
+- FreeRTOS
+  - Threads
+  - Queues
+- Zephyr
+  - All of the types listed in **Available object types**
+
+### Available object types
+
+- Block Pools
+- Byte Pools
+- Event Flag Groups
+- Mutexes
+- Queues
+- Semaphores
+- Threads
+- Timers
+
+## Usage
+
+Use the RTOS Object View to:
+
+- Access memory locations of various objects.
+- Access thread variables or various objects in the Watch view.
+
+Use the arrow keys to select objects within the view. Use the **Enter** key to navigate to the linked content.

docs/embedded/media/linux-and-embedded-workload.png

@@ -0,0 +1,40 @@
+---
+title: "Serial Monitor"
+ms.date: "07/12/2022"
+description: "Serial Monitor allows users to configure, monitor, and communicate with serial ports."
+author: gcampbell-msft
+ms.author: gcampbell
+monikerRange: '>=msvc-170'
+---
+# Serial Monitor
+
+## Overview
+
+The Serial Monitor allows users to configure, monitor, and communicate with serial ports.
+
+# [Visual Studio](#tab/visual-studio)
+
+![Serial Monitor in VS](media/serial-monitor.png)
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+![Serial Monitor in VSCode](media/serial-monitor-vscode.png)
+
+---
+
+## Capabilities
+
+- **Monitor a serial port**: Choose the **Start Monitoring** or **Stop Monitoring** button to control whether to monitor data coming from the port.
+- **Send data to a serial port**: Enter text into the text field at the bottom of the view. Use the **Enter** key or choose the **Send Message** button to send the data.
+- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field.
+- **Configure Serial Monitor and port connection settings**: See the following table to learn about the settings that the Serial Monitor provides.
+
+## Configurable settings
+
+| Settings | Description | Usage | Available options |
+|--|--|--|--|
+| **Port** | Ports that are actively connected to a device | Use the **Port** dropdown | Serial port compatible devices connected to the machine |
+| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 |
+| **Line ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown | None, LF, CR, CRLF |
+| **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off |
+| **Auto-scroll** | Whether to auto-scroll new content that comes from the connected port | Use the **auto-scroll** toggle button | On/Off |

docs/embedded/media/peripheral-viewer-vscode.png

@@ -0,0 +1,25 @@
+items: 
+- name: Embedded development with Visual Studio and Visual Studio code
+  href: ./index.yml
+- name: Download and install the Embedded Tools
+  href: download-and-install-the-embedded-tooling.md
+- name: Getting started guides
+  href: https://github.com/azure-rtos/getting-started
+- name: Build and debug embedded projects
+  items:
+    - name: Embedded Software Development in Visual Studio
+      href: https://devblogs.microsoft.com/cppblog/visual-studio-embedded-development/
+    - name: Embedded Software Development in Visual Studio Code
+      href: https://devblogs.microsoft.com/cppblog/vscode-embedded-development/
+    - name: Zephyr support
+      href: https://devblogs.microsoft.com/cppblog/serial-and-zephyr-support/
+- name: Embedded Tooling
+  items: 
+    - name: Peripheral Viewer
+      href: ./peripheral-view.md
+    - name: RTOS Viewer
+      href: ./rtos-view.md
+    - name: Serial Monitor 
+      href: ./serial-monitor.md
+    - name: vcpkg artifacts
+      href: https://devblogs.microsoft.com/cppblog/vcpkg-artifacts/

docs/embedded/media/peripheral-viewer.png

@@ -167,6 +167,8 @@ additionalContent:
               url: ./windows/desktop-applications-visual-cpp.md
             - text: Linux development
               url: linux/index.yml
+            - text: Embedded development
+              url: embedded/index.yml
             - text: Mobile development
               url: cross-platform/index.yml
             - text: Game development