Skip to content

Commit 47915ed

Browse files
Update device-update-raspberry-pi.md
1 parent 593942c commit 47915ed

File tree

1 file changed

+10
-12
lines changed

1 file changed

+10
-12
lines changed

articles/iot-hub-device-update/device-update-raspberry-pi.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,28 +31,26 @@ In this tutorial, you'll learn how to:
3131

3232
## Prerequisites
3333

34-
If you haven't already done so, create a [Device Update account and instance](create-device-update-account.md) and configure an IoT hub.
35-
Please note, this example requires an ethernet connection for the Raspberry Pi 3 B+ board.
34+
If you haven't already done so, create a [Device Update account and instance](create-device-update-account.md) and configure an IoT hub. This tutorial needs the device to be connected via ethernet connection.
3635

3736
Download files in **Assets** on the [Device Update GitHub releases page](https://github.com/Azure/iot-hub-device-update/releases). The Tutorial_RaspberryPi.zip has all the required files for the tutorial.
3837

39-
## Create a device or module in IoT Hub and get a connection string
38+
## Create a device in IoT Hub and get a connection string
4039

4140
Now, add the device to IoT Hub. From within IoT Hub, a connection string is generated for the device.
4241

4342
1. From the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
4443
1. On the left pane, select **Devices**. Then select **New**.
4544
1. Under **Device ID**, enter a name for the device. Ensure that the **Autogenerate keys** checkbox is selected.
4645
1. Select **Save**. On the **Devices** page, the device you created should be in the list.
47-
1. Get the device connection string by using one of two options:
48-
49-
* Option 1: Use the Device Update agent with a module identity: On the same **Devices** page, select **Add Module Identity** at the top. Create a new Device Update module with the name **IoTHubDeviceUpdate**. Choose other options as they apply to your use case and then select **Save**. Select the newly created module. In the module view, select the **Copy** icon next to **Primary Connection String**.
50-
* Option 2: Use the Device Update agent with the device identity: In the device view, select the **Copy** icon next to **Primary Connection String**.
51-
46+
1. Get the device connection string by navigating to the device view, select the **Copy** icon next to **Primary Connection String**.
5247
1. Paste the copied characters somewhere for later use in the following steps:
5348

5449
**This copied string is your device connection string**.
5550

51+
> [!NOTE]
52+
> This tutorial uses a device connection string to authenticate and connect with the IoT Hub for ease of set-up. For production scenarios, we recommend using module identity and leveraging AIS([IoT Identity Service](https://azure.github.io/iot-identity-service/)) to provision devices. [Learn more ](device-update-agent-provisioning.md)
53+
5654
## Set up Raspberry Pi
5755

5856
We provide base image and update files in **Assets** on the [Device Update GitHub releases page](https://github.com/Azure/iot-hub-device-update/releases). The Tutorial_RaspberryPi.zip has all the required files for the tutorial.
@@ -101,9 +99,6 @@ Device Update for Azure IoT Hub software is subject to the following license ter
10199

102100
Read the license terms prior to using the agent. Your installation and use constitutes your acceptance of these terms. If you don't agree with the license terms, don't use the Device Update for IoT Hub agent.
103101

104-
## Prepare on-device configurations for Device Update for IoT Hub
105-
106-
Two configuration files must be on the device so that Device Update for IoT Hub configures properly. The first file is the `du-config.json` file, which must exist at `/adu/du-config.json`. The second file is the `du-diagnostics-config.json` file, which must exist at `/adu/du-diagnostics-config.json`.
107102
## Configure the Device Update agent on Raspberry Pi
108103

109104
1. Make sure that Raspberry Pi 3 is connected to the network.
@@ -114,6 +109,7 @@ Two configuration files must be on the device so that Device Update for IoT Hub
114109
```
115110

116111
1. The DU configuration files (du-config.json and du-diagnostics-config.json) must be on the device so that Device Update for IoT Hub configures properly.
112+
117113
1. To create or open the `du-config.json` file for editing by using:
118114

119115
```bash
@@ -151,6 +147,7 @@ Two configuration files must be on the device so that Device Update for IoT Hub
151147
3. After you finish your changes, select `Ctrl+X` to exit the editor. Then enter `y` to save the changes.
152148
153149
1. Now you need to create the `du-diagnostics-config.json` file by using similar commands.
150+
2.
154151
1. Start by creating or opening the `du-diagnostics-config.json` file for editing by using:
155152
156153
```bash
@@ -176,6 +173,7 @@ Two configuration files must be on the device so that Device Update for IoT Hub
176173
"maxKilobytesToUploadPerLogPath":50
177174
}
178175
```
176+
179177
3. After you finish your changes, select `Ctrl+X` to exit the editor. Then enter `y` to save the changes.
180178
181179
1. Use the following command to show the files located in the `/adu/` directory. You should see both of your configuration files.du-diagnostics-config.json files for editing by using:
@@ -246,7 +244,7 @@ Two configuration files must be on the device so that Device Update for IoT Hub
246244
247245
*This screenshot shows the import step. File names might not match the ones used in the example.*
248246
249-
1. On the **Import update** page, review the files to be imported. Then select **Import update** to start the import process.
247+
1. On the **Import update** page, review the files to be imported. Then select **Import update** to start the import process. For the tutorial, import the sample tutorial manifest and sample update (.swu file) and the sample A/B script downloaded earlier.
250248
251249
:::image type="content" source="media/import-update/import-start-2-ppr.png" alt-text="Screenshot that shows Import update." lightbox="media/import-update/import-start-2-ppr.png":::
252250

0 commit comments

Comments
 (0)