Device Update for Azure IoT Hub mediante Azure RTOS

Este artículo le indica el procedimiento para crear el agente de Device Update for IoT Hub en Azure RTOS NetX Duo. También proporciona API sencillas para que los desarrolladores integren la funcionalidad de actualización de dispositivos en sus aplicaciones. Consulte ejemplos de paneles clave de evaluación de semiconductores que incluyen las guías introductorias para aprender a configurar, crear e implementar actualizaciones inalámbricas en los dispositivos.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Requisitos previos

  • Acceso a una instancia de IoT Hub. Se recomienda usar el nivel S1 (Estándar) o superior.
  • Una instancia de Device Update y una cuenta vinculada al centro de IoT. Si aún no lo ha hecho, siga la guía para crear y vincular una cuenta de Device Update.

Introducción

Cada proyecto de ejemplo de Azure Real-Time Operating System (RTOS) específico de la placa contiene código y documentación sobre cómo usar Device Update for IoT Hub en él. Podrá:

  1. Descargue los archivos de ejemplo específicos de la placa de los ejemplos de Azure RTOS y Device Update.
  2. Busque la carpeta "docs" en el ejemplo descargado.
  3. En los documentos, siga los pasos para preparar los recursos de Azure y una cuenta, y registrar los dispositivos IoT en ella.
  4. Siga los documentos para crear una nueva imagen de firmware e importar el manifiesto para la placa.
  5. Publique la imagen de firmware y el manifiesto en Device Update for IoT Hub.
  6. Descargue y ejecute el proyecto en el dispositivo.

Obtenga más información sobre Azure RTOS.

Etiquetado del dispositivo

  1. Mantenga la aplicación del dispositivo en ejecución desde el paso anterior.

  2. Inicie sesión en Azure Portal y vaya al centro de IoT.

  3. En el panel izquierdo, seleccione Dispositivos. Busque su dispositivo IoT y vaya al dispositivo gemelo.

  4. En el dispositivo gemelo, elimine cualquier valor de etiqueta de Device Update existente. Para ello, establézcalo en NULL.

  5. Agregue un nuevo valor de etiqueta de Device Update al objeto JSON raíz como se indica a continuación:

        "tags": {
                "ADUGroup": "<CustomTagValue>"
                }
    

Creación de un grupo de actualización

  1. Vaya a la pestaña Grupos e implementaciones en la parte superior de la página.

    Captura de pantalla que muestra los dispositivos desagrupados.

  2. Seleccione Nuevo grupo para crear un grupo.

    Captura de pantalla que muestra una adición de grupos de dispositivos.

  3. Seleccione una etiqueta de IoT Hub y una clase de dispositivo en la lista. A continuación, seleccione Crear grupo.

    Captura de pantalla que muestra la selección de etiquetas.

  4. Una vez creado el grupo, verá que se han actualizado la lista de grupos y el gráfico de Update Compliance. En el gráfico de Update Compliance se muestra el recuento de dispositivos en los distintos estados de compatibilidad: En la actualización más reciente, Nuevas actualizaciones disponibles y Actualizaciones en curso. Obtenga más información sobre Update Compliance.

    Captura de pantalla que muestra la vista de cumplimiento de actualizaciones.

  5. Debería ver el grupo recién creado y todas las actualizaciones disponibles para los dispositivos del nuevo grupo. Si hay dispositivos que no cumplen los requisitos de clase de dispositivo del grupo, se mostrarán en un grupo no válido correspondiente. Para implementar la mejor actualización disponible en el nuevo grupo definido por el usuario desde esta vista, seleccione Implementar junto al grupo.

Obtenga más información sobre cómo agregar etiquetas y crear grupos de actualizaciones.

Implementación de firmware nuevo

  1. Una vez creado el grupo, debería ver una nueva actualización disponible para el grupo de dispositivos, con un vínculo a la actualización en Mejor actualización. Puede que tenga que actualizar una vez. Más información sobre el cumplimiento de actualizaciones.

  2. Para elegir el grupo de destino, seleccione el nombre del grupo. Se le dirigirá a los detalles del grupo en Group basics (Conceptos básicos del grupo).

    Captura de pantalla que muestra los detalles de los grupos.

  3. Para iniciar la implementación, vaya a la pestaña Implementación actual. Seleccione el vínculo de implementación situado junto a la actualización deseada en la sección Actualizaciones disponibles. La mejor actualización disponible para un grupo determinado se indica con el término Óptima resaltado.

    Captura de pantalla que muestra la selección de una actualización.

  4. Programe la implementación para que se inicie inmediatamente o en el futuro. Seleccione Crear.

    Sugerencia

    De forma predeterminada, la fecha y hora de inicio es de 24 horas a partir de la hora actual. Asegúrese de seleccionar una fecha y hora diferentes si quiere que la implementación comience antes.

    Captura de pantalla que muestra la pantalla Crear implementación.

  5. En Detalles de implementación, Estado cambia a Activo. La actualización implementada está marcada con (implementando).

    Captura de pantalla que muestra Implementación como Activa.

  6. Vea el gráfico de cumplimiento para comprobar que la actualización está en curso.

  7. Una vez que el dispositivo se ha actualizado correctamente, puede ver que el gráfico de cumplimiento y los detalles de la implementación se actualizan para reflejar lo mismo.

    Captura de pantalla que muestra que la actualización se ha realizado correctamente.

Supervisar la implementación de actualizaciones

  1. Seleccione la pestaña Historial de implementación en la parte superior de la página.

    Captura de pantalla que muestra del historial de implementación.

  2. Seleccione Detalles junto a la implementación que ha creado.

    Captura de pantalla que muestra Detalles de implementación.

  3. SeleccioneActualizar para ver los detalles de estado más recientes.

Ahora ha completado una actualización correcta de la imagen completa con Device Update for IoT Hub en un dispositivo insertado en Azure RTOS.

Pasos siguientes

Para más información sobre Azure RTOS y cómo funciona con IoT Hub, consulte la página web de Azure RTOS.