Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Updating and reverting device configuration

Console

...

Update the device configuration

...

1. Go to the ClearBlade IoT Core console’s Registries page.

2. Click the registry ID that contains the device.

3. In the left registry menu, click Devices.

4. Click the device ID whose configuration you want to update.

5. Click the ellipsis (⋮) at the top-right of the page, then select Update device.

6. Select the configuration’s format (text, Base64) and paste the data in the configuration box.

7. Click SEND TO DEVICE.

See Protocol differences for how devices receive the new configuration.To revert

Revert the device configuration to a previous version

...

1. Go to the Google Cloud console’s Registries page.

2. Click the registry ID that contains the device whose configuration you want to revert.

3. In the left registry menu, click Devices.

4. Click the device ID whose configuration you wish to revert.

5. Click CONFIGURATION & STATE. Use the checkboxes to display configuration history, state history, or both. By default, both are shown.

6. Click a row to get the full configuration or state data in JSON and the timestamp and version.

7. Click COMPARE to compare the configuration data with the state data. This view can help you debug configurations and ensure devices have acknowledged specific configuration versions if you use MQTT (the HTTP bridge does not support configuration acknowledgments).

8. Click the version you want to revert to. Select Text in the Format list to see a text version of the configuration details.

9. Click Revert, ensure you've selected the correct version, then click Revert.

API

To update or revert device configuration via the API, use the device modifyCloudToDeviceConfig method, specifying the new or previous configuration in the config field. You can specify a configuration when creating a device and then use modifyCloudToDeviceConfig to change it later.

...

Reviewing device configuration

Console

1. Go to the Google Cloud console’s Registries page.

2. Click the registry ID that contains the device whose configuration you want to update.

3. In the left registry menu, click Devices.

4. Click the device ID whose configuration you want to update.

5. Click CONFIGURATION & STATE. Use the checkboxes to display configuration history, state history, or both. By default, both are shown.

6. Click a row to get the full configuration or state data in JSON and the timestamp and version.

7. Click COMPARE to compare the configuration data with the state data. This view can help you debug configurations and ensure devices have acknowledged specific configuration versions if you use MQTT (the HTTP bridge does not support configuration acknowledgments).

To review device configuration via the API, use a device configVersions.list request.

...