| title | description | author | ms.author | ms.date | ms.topic | ms.service |
|---|---|---|---|---|---|---|
Using Proxy Updates with Device Update for Azure IoT Hub| Microsoft Docs |
Using Proxy Updates with Device Update for Azure IoT Hub |
ValOlson |
valls |
11/12/2021 |
conceptual |
iot-hub-device-update |
With Proxy updates, you can (1) target over-the-air updates to multiple components on the IoT device or (2) target over-the-air updates to multiple sensors connected to the IoT device. Use cases where proxy updates is applicable include:
- Targeting specific update files to different partitions on the device.
- Targeting specific update files to different apps/components on the device
- Targeting specific update files to sensors connected to an IoT devices. These sensors could be connected to the IoT device over a network protocol (for example, USB, CANbus etc.).
In order to update a component or components that connected to a target IoT Device, the device builder must register a custom Component Enumerator Extension that is built specifically for their IoT devices. The Component Enumerator Extension is required so that the Device Update Agent can map a 'child update' with a specific component, or group of components, which the update is intended for. See Contoso Component Enumerator for an example on how to implement and register a custom Component Enumerator extension.
Note
Device Update service does not know anything about component(s) on the target device. Only the Device Update agent does the above mapping.
In the following example, we will demonstrate how to do a Proxy update and use the multi-step ordered execution feature introduced in the Public Preview Refresh Release. Multi-step ordered execution feature allows for granular update controls including an install order, pre-install, install, and post-install steps. Use cases include, for example, a required preinstall check that is needed to validate the device state before starting an update, etc. Learn more about multi-step ordered execution.
See this tutorial on how to do a Proxy update using the Device Update agent with sample updates for components connected to a Contoso Virtual Vacuum device.