Skip to content

Commit f237c1a

Browse files
committed
Fix warnings
1 parent 718a864 commit f237c1a

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

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

Lines changed: 15 additions & 12 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,28 +175,31 @@ 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-
## Automatically associate a device template
178+
## Automatically associate with a device template
179179
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 the **CapabilityModelId**( URN for the capability model) 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:
181-
1. Associates with the device template if it's already published in the IoT Central application.
182-
1. For Pre-Certified Plug and Play devices, if the device template is not already published in IoT Central the template is fetched from the public repository.
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:
183181
184-
Below is the format of the additional payload the device would send during the DPS registration call.
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.
184+
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:
185188
186-
This is the format for devices using non PnP device SDK
187189
```javascript
188190
iotcModelId: '< this is the URN for the capability model>';
189191
```
190192

191-
This is the format for devices using Public Preview PnP device SDK
193+
This is the format for devices using public preview device SDK that does support IoT Plug and Play:
194+
192195
```javascript
193196
'__iot:interfaces': {
194197
CapabilityModelId: <this is the URN for the capability model>
195198
}
196199
```
197200

198201
> [!NOTE]
199-
> 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.
200203
201204
## Device status values
202205

0 commit comments

Comments
 (0)