Merge pull request #236572 from dominicbetts/iot-update-existing-core

IoT: update core articles

Author: JamesJBarnett

articles/iot/.openpublishing.redirection.iot.json

@@ -66,13 +66,18 @@
     },
     {
       "source_path_from_root": "/articles/iot-fundamentals/iot-solution-options.md",
-      "redirect_url": "/azure/iot/iot-solution-options",
-      "redirect_document_id": true
+      "redirect_url": "/azure/iot/iot-introduction",
+      "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/iot-fundamentals/iot-support-help.md",
       "redirect_url": "/azure/iot/iot-support-help",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot/iot-solution-options.md",
+      "redirect_url": "/azure/iot/iot-introduction",
+      "redirect_document_id": false
     }
   ]
 }

articles/iot/TOC.yml

@@ -0,0 +1,91 @@
+items:
+  - name: Azure Internet of Things documentation
+    href: index.yml
+
+  - name: Overview
+    items:
+    - name: Introduction
+      href: iot-introduction.md
+    - name: IoT solution components
+      items:
+      - name: Device development
+        href: iot-overview-device-development.md
+      - name: Device connectivity
+        href: iot-overview-device-connectivity.md
+      - name: Device management and control
+        href: iot-overview-device-management.md
+      - name: Process and route messages
+        href: iot-overview-message-processing.md
+      - name: Extend your IoT solution
+        href: iot-overview-solution-extensibility.md
+      - name: Analyze and visualize your IoT data
+        href: iot-overview-analyze-visualize.md
+      - name: Manage your solution
+        href: iot-overview-solution-management.md
+    - name: Azure IoT services and technologies
+      href: iot-services-and-technologies.md
+
+  - name: How-to guides
+    items:
+      - name: Use smartphone device app
+        href: iot-phone-app-how-to.md
+      - name: Use IoT Explorer
+        href: howto-use-iot-explorer.md
+
+  - name: Concepts
+    items:
+      - name: MQTT support
+        items: 
+        - name: Use MQTT with IoT Hub
+          href: iot-mqtt-connect-to-iot-hub.md
+        - name: Use MQTT with DPS
+          href: iot-mqtt-connect-to-iot-dps.md
+        - name: MQTT 5 support (preview)
+          items: 
+          - name: MQTT 5 overview
+            href: iot-mqtt-5-preview.md
+          - name: MQTT 5 API reference
+            href: iot-mqtt-5-preview-reference.md         
+
+  - name: Security
+    items:
+    - name: Security best practices
+      href: iot-security-best-practices.md    
+    - name: Security architecture
+      href: iot-security-architecture.md
+
+  - name: Resources
+    items:
+    - name: Support and help options
+      href: iot-support-help.md  
+    - name: IoT glossary
+      href: iot-glossary.md
+    - name: Azure IoT services
+      items:
+      - name: IoT Hub
+        href: ../iot-hub/index.yml
+      - name: IoT Hub Device Provisioning Service
+        href: ../iot-dps/index.yml
+      - name: IoT Central
+        href: ../iot-central/index.yml
+      - name: IoT Edge
+        href: ../iot-edge/index.yml
+      - name: Azure Maps
+        href: ../azure-maps/index.yml
+      - name: Time Series Insights
+        href: ../time-series-insights/index.yml
+    - name: IoT device developer
+      href: ../iot-develop/index.yml
+    - name: Azure IoT SDKs
+      items:
+      - name: Device and Service SDKs
+        href: iot-sdks.md
+      - name: Device SDKs lifecycle and support
+        href: iot-device-sdks-lifecycle-and-support.md
+    - name: Azure Certified for IoT device catalog
+      href: https://catalog.azureiotsolutions.com/
+    - name: Azure IoT Tools for VS Code
+      href: https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit
+    - name: Azure IoT Explorer tool
+      href: https://github.com/Azure/azure-iot-explorer
+

articles/iot/iot-introduction.md

@@ -5,20 +5,36 @@ author: dominicbetts
 ms.service: iot
 services: iot
 ms.topic: overview
-ms.date: 03/24/2023
+ms.date: 05/02/2023
 ms.author: dobett
 ms.custom:  [amqp, mqtt]
 #Customer intent: As a newcomer to IoT, I want to understand what IoT is, what services are available, and examples of business cases so I can figure out where to start.
 ---
 
 # What is Azure Internet of Things (IoT)?
 
-The Azure Internet of Things (IoT) is a collection of Microsoft-managed cloud services that let you connect, monitor, and control your IoT assets at scale. In simpler terms, an IoT solution is made up of IoT devices that communicate with cloud services.
+The Azure Internet of Things (IoT) is a collection of Microsoft-managed cloud services, edge components, and SDKs that let you connect, monitor, and control your IoT assets at scale. In simpler terms, an IoT solution is made up of IoT devices that communicate with cloud services.
 
 The following diagram shows a high-level view of the components in a typical IoT solution. This article focuses on the key groups of components: devices, IoT cloud services, other cloud services, and solution-wide concerns. Other articles in this section provide more detail on each of these components.
 
 :::image type="content" source="media/iot-introduction/iot-architecture.svg" alt-text="Diagram that shows the high-level IoT solution architecture." border="false":::
 
+## Solution options
+
+To build an IoT solution for your business, you typically evaluate your solution by using the *managed app platform* approach and build your enterprise solution by using the *platform services*.
+
+A managed app platform lets you quickly evaluate your IoT solution by reducing the number of decisions needed to achieve results. The managed app platform takes care of most infrastructure elements in your solution, letting you focus on adding industry knowledge and evaluating the solution. Azure IoT Central is a managed app platform.
+
+Platform services provide all the building blocks for customized and flexible IoT applications. You have more options to choose and code when you connect your devices, and ingest, store, and analyze your data. Azure IoT platform services include Azure IoT Hub, Device Provisioning Service, and Azure Digital Twins.
+
+| Managed app platform | Platform services |
+|----------------------|-------------------|
+| Take advantage of a platform that handles the security and management of your IoT applications and devices. | Have full control over the underlying services in your solution. For example: </br> Scaling and securing services to meet your needs. </br> Using in-house or partner expertise to onboard devices and provision services. |
+| Customize branding, dashboards, user roles, devices, and telemetry. However, you can't customize the underlying IoT services. | Fully customize and control your IoT solution. |
+| Has a simple, predictable pricing structure. | Let you fine-tune services to control overall costs. |
+
+To learn more, see [What Azure technologies and services can you use to create IoT solutions?](iot-services-and-technologies.md).
+
 ## IoT devices
 
 An IoT device is typically made up of a circuit board with sensors attached that uses WiFi to connect to the internet. For example:
@@ -32,23 +48,28 @@ There's a wide variety of devices available from different manufacturers to buil
 
 Microsoft provides open-source [Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) that you can use to build the apps that run on your devices.
 
-To learn more, see [IoT device development](iot-overview-device-development.md).
+> [!IMPORTANT]
+> Because IoT Central uses IoT Hub internally, any device that can connect to an IoT Central application can also connect to an IoT hub.
+
+To learn more about the devices in your IoT solution, see [IoT device development](iot-overview-device-development.md).
 
 ## Connectivity
 
-Typically, IoT devices send telemetry from the sensors to cloud services in your solution. However, other types of communication are possible such as a cloud service sending commands to your devices. The following are some examples of device-to-cloud and cloud-to-device communication:
+Typically, IoT devices send telemetry from their attached sensors to cloud services in your solution. However, other types of communication are possible such as a cloud service sending commands to your devices. The following are examples of device-to-cloud and cloud-to-device communication:
 
 * A mobile refrigeration truck sends temperature every 5 minutes to an IoT Hub.
 
 * A cloud service sends a command to a device to change the frequency at which it sends telemetry to help diagnose a problem.
 
-* A device sends alerts based on the values read from its sensors. For example, a device monitoring a batch reactor in a chemical plant, sends an alert when the temperature exceeds a certain value.
+* A device monitoring a batch reactor in a chemical plant sends an alert when the temperature exceeds a certain value.
+
+* A thermostat reports the maximum temperature the device has reached since the last reboot.
 
-* Your devices send information to display on a dashboard for viewing by human operators. For example, a control room in a refinery may show the temperature, pressure, and flow volumes in each pipe, enabling operators to monitor the facility.
+* A cloud service sets the target temperature for a thermostat device.
 
-The [IoT Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) and IoT Hub support common [communication protocols](../iot-hub/iot-hub-devguide-protocols.md) such as HTTP, MQTT, and AMQP.
+The [IoT Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) and IoT Hub support common [communication protocols](../iot-hub/iot-hub-devguide-protocols.md) such as HTTP, MQTT, and AMQP for device-to-cloud and cloud-to-device communication. In some scenarios, you may need a gateway to connect your IoT devices to your cloud services.
 
-IoT devices have different characteristics when compared to other clients such as browsers and mobile apps. The device SDKs help you address the challenges of connecting devices securely and reliably to your cloud services.  Specifically, IoT devices:
+IoT devices have different characteristics when compared to other clients such as browsers and mobile apps. Specifically, IoT devices:
 
 * Are often embedded systems with no human operator.
 * Can be deployed in remote locations, where physical access is expensive.
@@ -57,29 +78,38 @@ IoT devices have different characteristics when compared to other clients such a
 * May have intermittent, slow, or expensive network connectivity.
 * May need to use proprietary, custom, or industry-specific application protocols.
 
-To learn more, see [Device infrastructure and connectivity](iot-overview-device-connectivity.md).
+The device SDKs help you address the challenges of connecting devices securely and reliably to your cloud services.
+
+To learn more device connectivity and gateways, see [Device infrastructure and connectivity](iot-overview-device-connectivity.md).
 
 ## Cloud services
 
 In an IoT solution, the cloud services typically:
 
-* Receive telemetry at scale from your devices, and determining how to process and store that data.
+* Receive telemetry at scale from your devices, and determine how to process and store that data.
 * Analyze the telemetry to provide insights, either in real time or after the fact.
-* Send commands from the cloud to a specific device.
-* Provision devices and controlling which devices can connect to your infrastructure.
-* Control the state of your devices and monitoring their activities.
+* Send commands from the cloud to specific devices.
+* Provision devices and control which devices can connect to your infrastructure.
+* Control the state of your devices and monitor their activities.
 * Manage the firmware installed on your devices.
 
-For example, in a remote monitoring solution for an oil pumping station, the services use telemetry from the pumps to identify anomalous behavior. When a cloud service identifies an anomaly, it can automatically send a command back to the device to take a corrective action. This process generates an automated feedback loop between the device and the cloud that greatly increases the solution efficiency.
+For example, in a remote monitoring solution for an oil pumping station, the services use telemetry from the pumps to identify anomalous behavior. When a cloud service identifies an anomaly, it can automatically send a command to the device to take a corrective action. This process implements an automated feedback loop between the device and the cloud that greatly increases the solution efficiency.
+
+Some cloud services, such as IoT Hub and the Device Provisioning Service, are IoT specific. Other cloud services, such as storage and visualization, provide generic services to your solution.
+
+To learn more, see:
 
-Some cloud services, such as IoT Hub and the Device Provisioning Service, are IoT specific. Other cloud services can provide generic services to your solution such as storage and visualizations.
+- [Device management and control](iot-overview-device-management.md)
+- [Message processing in an IoT solution](iot-overview-message-processing.md)
+- [Extend your IoT solution](iot-overview-solution-extensibility.md)
+- [Analyze and visualize your IoT data](iot-overview-analyze-visualize.md)
 
 ## Solution-wide concerns
 
-Any IoT solution has to address the following solution-wide concerns:
+Any IoT solution must address the following solution-wide concerns:
 
 * [Security](iot-security-best-practices.md) including physical security, authentication, authorization, and encryption
-* Solution management including deployment and monitoring.
+* [Solution management](iot-overview-solution-management.md) including deployment and monitoring.
 * High availability and disaster recovery for all the components in your solution.
 * Scalability for all the services in your solution.
 

articles/iot/iot-overview-analyze-visualize.md

@@ -81,5 +81,5 @@ IoT Central provides a rich set of features that you can use to analyze and visu
 
 Now that you've seen an overview of the analysis and visualization options available to your IoT solution, some suggested next steps include:
 
-- [Choose the right IoT solution](iot-solution-options.md)
+- [IoT solution options](iot-introduction.md#solution-options)
 - [Azure IoT services and technologies](iot-services-and-technologies.md)

articles/iot/iot-overview-solution-extensibility.md

@@ -9,7 +9,7 @@ ms.topic: overview
 ms.date: 04/03/2023
 ms.custom: template-overview
 
-# As a solution builder, I want a high-level overview of the options for extensing an IoT solution so that I can easily find relevant content for my scenario.
+# As a solution builder, I want a high-level overview of the options for extending an IoT solution so that I can easily find relevant content for my scenario.
 ---
 
 # Extend your IoT solution
@@ -94,4 +94,4 @@ The IoT Central application templates provide a starting point for building IoT
 Now that you've seen an overview of the extensibility options available to your IoT solution, some suggested next steps include:
 
 - [Analyze and visualize your IoT data](iot-overview-analyze-visualize.md)
-- [Choose the right IoT solution](iot-solution-options.md)
+- [IoT solution options](iot-introduction.md#solution-options)