Skip to content

Commit 6349f48

Browse files
authored
Update how-to-device-twins.md intro
1 parent 7d6713b commit 6349f48

File tree

1 file changed

+4
-33
lines changed

1 file changed

+4
-33
lines changed

articles/iot-hub/how-to-device-twins.md

Lines changed: 4 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -15,47 +15,18 @@ ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
1515

1616
# Get started with device twins
1717

18-
Device twins are JSON documents that store device state information, including metadata, configurations, and conditions. IoT Hub persists a device twin for each device that connects to it.
19-
20-
[!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
21-
22-
Use device twins to:
18+
Use the Azure IoT Hub device SDK and service SDK to develop applications that handle common device twin tasks. Device twins are JSON documents that store device state information including metadata, configurations, and conditions. IoT Hub persists a device twin for each device that connects to it. You can use device twins to:
2319

2420
* Store device metadata from your solution back end.
25-
2621
* Report current state information such as available capabilities and conditions, for example, the connectivity method used, from your device app.
27-
2822
* Synchronize the state of long-running workflows, such as firmware and configuration updates, between a device app and a back-end app.
29-
3023
* Query your device metadata, configuration, or state.
3124

32-
Device twins are designed for synchronization and for querying device configurations and conditions. For more information about device twins, including when to use device twins, see [Understand device twins](iot-hub-devguide-device-twins.md).
33-
34-
IoT Hubs store device twins, which contain the following elements:
35-
36-
* **Tags**. Device metadata accessible only by the solution back end.
25+
For more information about device twins, including when to use device twins, see [Understand device twins](iot-hub-devguide-device-twins.md).
3726

38-
* **Desired properties**. JSON objects modifiable by the solution back end and observable by the device app.
39-
40-
* **Reported properties**. JSON objects modifiable by the device app and readable by the solution back end.
41-
42-
Tags and properties can't contain arrays, but can contain nested objects.
43-
44-
The following illustration shows device twin organization:
45-
46-
:::image type="content" source="../../includes/media/iot-hub-selector-twin-get-started/twin.png" alt-text="Screenshot of a device twin concept diagram.":::
47-
48-
It is useful to review the various device twin fields that are available using the Azure portal. To learn how, see [How to view and update devices based on device twin properties](/azure/iot-hub/manage-device-twins).
49-
50-
Additionally, the solution back end can query device twins based on all the above data. For more information about querying, see [IoT Hub query language](iot-hub-devguide-query-language.md).
51-
52-
This article shows you how to:
27+
[!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
5328

54-
* View device twin and update reported properties
55-
* Update device twin tags
56-
* Create a device desired property update notificaton callback
57-
* Use a backend application to update tags and desired properties
58-
* Query devices from your back-end app using filters on the tags and properties previously created
29+
This article shows you how to develop two types of applications. Device apps can handle requests to update desired properties and respond with changes to reported properties. Service apps can update device twin tags, set new desired properties, and query devices based on device twin values.
5930

6031
> [!NOTE]
6132
> This article is meant to complement [Azure IoT SDKs](iot-hub-devguide-sdks.md) samples that are referenced from within this article. You can use SDK tools to build both device and back-end applications.

0 commit comments

Comments
 (0)