Skip to content

Commit 53d215f

Browse files
authored
Merge pull request #113168 from dominicbetts/central-model-id
Add model ID information to concepts article
2 parents 6482d32 + f237c1a commit 53d215f

File tree

1 file changed

+18
-10
lines changed

1 file changed

+18
-10
lines changed

articles/iot-central/core/concepts-get-connected.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ This article describes the following use cases:
3636
- [Connect devices at scale using X.509 certificates](#connect-devices-using-x509-certificates) - the recommended approach for production environments.
3737
- [Connect devices without first registering them](#connect-without-registering-devices)
3838
- [Connect devices that use DPS individual enrollments](#individual-enrollment-based-device-connectivity)
39-
- [Connect devices using IoT Plug and Play (preview) features](#connect-devices-with-iot-plug-and-play-preview)
39+
- [Automatically associate a device with a device template](#automatically-associate-with-a-device-template)
4040

4141
## Connect a single device
4242

@@ -133,7 +133,7 @@ The flow is slightly different depending on whether the devices use SAS tokens o
133133
On the **Administration > Device connection** page, the **Auto approve** option controls whether you need to manually approve the device before it can start sending data.
134134
135135
> [!NOTE]
136-
> To learn how automatically associate a device with a device template, see [Connect devices with IoT Plug and Play (preview)](#connect-devices-with-iot-plug-and-play-preview).
136+
> To learn how automatically associate a device with a device template, see [Automatically associate a device with a device template](#automatically-associate-with-a-device-template).
137137
138138
### Connect devices that use X.509 certificates without registering
139139
@@ -150,7 +150,7 @@ The flow is slightly different depending on whether the devices use SAS tokens o
150150
On the **Administration > Device connection** page, the **Auto approve** option controls whether you need to manually approve the device before it can start sending data.
151151
152152
> [!NOTE]
153-
> To learn how automatically associate a device with a device template, see [Connect devices with IoT Plug and Play (preview)](#connect-devices-with-iot-plug-and-play-preview).
153+
> To learn how automatically associate a device with a device template, see [Automatically associate a device with a device template](#automatically-associate-with-a-device-template).
154154
155155
## Individual enrollment-based device connectivity
156156
@@ -159,7 +159,7 @@ For customers connecting devices that each have their own authentication credent
159159
> [!NOTE]
160160
> When you create an individual enrollment for a device, it takes precedence over the default group enrollment options in your IoT Central application.
161161
162-
### Creating individual enrollments
162+
### Create individual enrollments
163163
164164
IoT Central supports the following attestation mechanisms for individual enrollments:
165165
@@ -175,14 +175,22 @@ IoT Central supports the following attestation mechanisms for individual enrollm
175175
176176
- **Trusted Platform Module (TPM) attestation:** A [TPM](https://docs.microsoft.com/azure/iot-dps/concepts-tpm-attestation) is a type of hardware security module. Using a TPM is one of the most secure ways to connect a device. This article assumes you're using a discrete, firmware, or integrated TPM. Software emulated TPMs are well suited for prototyping or testing, but they don't provide the same level of security as discrete, firmware, or integrated TPMs. Don't use software TPMs in production. To create an individual enrollment that uses a TPM, open the **Device Connection** page, select **Individual enrollment** as the connection method, and **TPM** as the mechanism. Enter the TPM endorsement key and save the device connection information.
177177
178-
## Connect devices with IoT Plug and Play (preview)
178+
## Automatically associate with a device template
179179
180-
One of the key features of IoT Plug and Play (preview) with IoT Central is the ability to associate device templates automatically on device connection. Along with device credentials, devices can now send the **CapabilityModelId** as part of the device registration call. This capability enables IoT Central to discover and associate the device template with the device. The discovery process works as follows:
180+
One of the key features of IoT Central is the ability to associate device templates automatically on device connection. Along with device credentials, devices can send a **CapabilityModelId** as part of the device registration call. The **CapabilityModelID** is a URN that identifies the capability model the device implements. The IoT Central application can use the **CapabilityModelID** to identify the device template to use and then automatically associate the device with the device template. The discovery process works as follows:
181181
182-
1. Associates with the device template if it's already published in the IoT Central application.
183-
1. Fetches from the public repository of published and certified capability models.
182+
1. If the device template is already published in the IoT Central application, the device is associated with the device template.
183+
1. For pre-certified IoT Plug and Play devices, if the device template is not already published in the IoT Central application, the device template is fetched from the public repository.
184184
185-
Below is the format of the additional payload the device would send during the DPS registration call
185+
The following snippets show the format of the additional payload the device must send during the DPS registration call for automatic association to work.
186+
187+
This is the format for devices that use the generally available device SDK that doesn't support IoT Plug and Play:
188+
189+
```javascript
190+
iotcModelId: '< this is the URN for the capability model>';
191+
```
192+
193+
This is the format for devices using public preview device SDK that does support IoT Plug and Play:
186194

187195
```javascript
188196
'__iot:interfaces': {
@@ -191,7 +199,7 @@ Below is the format of the additional payload the device would send during the D
191199
```
192200

193201
> [!NOTE]
194-
> Note that the **Auto approve** option on **Administration > Device connection** must be enabled for devices to automatically connect, discover the device template, and start sending data.
202+
> The **Auto approve** option on **Administration > Device connection** must be enabled for devices to automatically connect, discover the device template, and start sending data.
195203
196204
## Device status values
197205

0 commit comments

Comments
 (0)