nl::Weave::Profiles::SoftwareUpdate

Este espacio de nombres incluye todas las interfaces dentro de Weave para el perfil de actualización de software de Weave, que incluye el protocolo correspondiente del mismo nombre.

Resumen

Enumeraciones

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum
Tipos de mensaje de SoftwareUpdate.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
}
enum
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
}
enum
Marcas de control para el campo de control del marco ImageQuery.
@312 enum
Máscaras de bits para el campo de opciones de actualización opcional de ImageQueryResponse.
@313 enum
Cambia las compensaciones para el campo de opciones de actualización opcional de ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
Longitudes, en bytes, para las strings de bytes de la especificación de integridad.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum
@317 enum
Etiquetas de elementos de datos del perfil SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
Condiciones que rigen la política de actualización.
UpdatePriority{
  Normal,
  Critical
}
enum
Actualiza las prioridades.

remotas

integrityLength(uint8_t aType)
int
Un método de compatibilidad que asigne los valores IntegrityTypes a la longitud de los hashes de ese tipo.

Clases

nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Interfaz para el delegado WeaveImageAnnounceServer.

nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce

Es la clase que describe el mensaje ImageAnnounce.

nl::Weave::Profiles::SoftwareUpdate::ImageQuery

Una clase para admitir la creación y la decodificación de mensajes de consulta de imagen.

nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

Una clase para admitir la creación y la decodificación de los mensajes de respuesta de consulta de imagen.

nl::Weave::Profiles::SoftwareUpdate::IntegritySpec

Una clase auxiliar que contiene el tipo de integridad y el hash real de la imagen de actualización de software.

nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList

Una clase auxiliar para contener una lista de tipos de integridad como parte de la consulta de imagen.

nl::Weave::Profiles::SoftwareUpdate::ProductSpec

Es una clase auxiliar que representa una especificación de producto.

nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList

Una clase auxiliar que contiene una lista de esquemas de actualización como parte de la consulta de imagen.

nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer

Servidor que escucha anuncios de imágenes de Weave.

Enumeraciones

@309

 @309

Tipos de mensaje de SoftwareUpdate.

Propiedades
kMsgType_DownloadNotify

Un mensaje opcional del cliente al servidor que se usa para notificar al servidor sobre el estado de la descarga.

Su carga útil es una nl::Weave::Profiles::StatusReporting::StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Un mensaje opcional no solicitado que usa el servidor para anunciar la disponibilidad de una actualización de software.

El mensaje no tiene carga útil.

kMsgType_ImageQuery

Un mensaje de consulta que envía el cliente al servidor.

Su formato se define con la clase ImageQuery.

kMsgType_ImageQueryResponse

Un mensaje generado en respuesta a un mensaje de consulta de imagen exitosa.

Su formato se define con la clase ImageQueryResponse.

kMsgType_ImageQueryStatus

Un mensaje generado en respuesta a un mensaje de consulta de imagen con errores.

Su carga útil es una nl::Weave::Profiles::StatusReporting::StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Un mensaje generado en respuesta al mensaje de notificación de descarga.

Su carga útil es una nl::Weave::Profiles::StatusReporting::StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Un mensaje opcional del cliente al servidor que se usa para comunicar el estado final de la actualización.

Su carga útil es una nl::Weave::Profiles::StatusReporting::StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes. Como se espera que el mensaje se genere después de una actualización real, se envía en un ExchangeContext nuevo y se trata como un mensaje no solicitado en el servidor.

@310

 @310

Códigos de estado específicos del perfil de SoftwareUpdate.

Propiedades
kStatus_Abort

server => client, indica que el cliente debe darse por vencido, ya que el servidor no tiene opciones.

kStatus_DownloadFailed

client => servidor, indica que falló un intento de descarga.

kStatus_IntegrityCheckFailed

client => servidor, indica que se descargó una imagen, pero no se pudo completar la verificación de integridad posterior.

kStatus_InvalidInstructions

client => server, indica que el cliente no pudo descargar una imagen debido a que las instrucciones de descarga contenidas en ImageQueryResponse, es decir.

El URI, el esquema de actualización y la condición de actualización tenían un formato incorrecto o incoherentes.

kStatus_NoUpdateAvailable

server => client, indica que se recibió y comprendió una consulta de imagen, y que el servidor no tiene actualizaciones para el cliente en este momento.

kStatus_Retry

server => client, indica que el cliente debe enviar otra consulta de imagen y reiniciar o continuar la actualización

kStatus_UpdateFailed

client => server, indica que se produjo un error al intentar instalar una imagen especificada por el servidor.

@311

 @311

Marcas de control para el campo de control del marco ImageQuery.

Propiedades
kFlag_LocaleSpecPresent

La especificación de Locale está presente en ImageQuery.

kFlag_PackageSpecPresent

La especificación del paquete está presente en ImageQuery.

kFlag_TargetNodeIdPresent

El ID del nodo de destino está presente en ImageQuery.

@312

 @312

Máscaras de bits para el campo de opciones de actualización opcional de ImageQueryResponse.

@313

 @313

Cambia las compensaciones para el campo de opciones de actualización opcional de ImageQueryResponse.

@314

 @314

Tipos de integridad que admite el perfil SoftwareUpdate.

El marco de la consulta de imagen contiene información sobre qué verificación de integridad admite el cliente, y la respuesta de la consulta de imagen contiene un tipo y valor de integridad para la imagen que se le indica al cliente que descargue e instale. Los tipos admitidos son los siguientes:

Propiedades
kIntegrityType_Last

Cantidad de elementos válidos en la enumeración.

kIntegrityType_SHA160

Se requiere un hash seguro de 160 bits (SHA-1).

kIntegrityType_SHA256

Hash seguro de 256 bits (SHA-2).

kIntegrityType_SHA512

Hash seguro (SHA-2) de 512 bits

@315

 @315

Longitudes, en bytes, para las strings de bytes de la especificación de integridad.

@316

 @316

Se actualizaron los esquemas compatibles con el perfil de SofwareUpdate.

Al igual que los tipos de integridad admitidos, la consulta de imágenes contiene información sobre los esquemas de actualización (es decir, protocolos de descarga) que admite el cliente, y la respuesta contiene un valor para indicar el esquema de actualización que se debe usar en la descarga de las imágenes. Los esquemas compatibles son los siguientes:

Propiedades
kUpdateScheme_BDX

La transferencia masiva de datos de Weave debe usarse como protocolo de descarga.

kUpdateScheme_HTTP

Se debe usar HTTP como protocolo de descarga.

kUpdateScheme_HTTPS

Se debe usar HTTPS como protocolo de descarga.

kUpdateScheme_Last

Cantidad de elementos válidos en la enumeración.

kUpdateScheme_SFTP

Se debe usar SFTP como protocolo de descarga.

@317

 @317

Etiquetas de elementos de datos del perfil SoftwareUpdate.

UpdateCondition

 UpdateCondition

Condiciones que rigen la política de actualización.

Propiedades
IfLater

Descarga e instala la imagen si la especificación de la versión en el marco de respuesta es posterior a la versión de software instalada actualmente.

IfUnmatched

Descarga e instala la imagen si la especificación de la versión en el marco de respuesta no coincide con la versión de software instalada actualmente.

OnOptIn

descargar e instalar la imagen en algún activador proporcionado por un usuario en el sitio.

Unconditionally

Descarga e instala la imagen independientemente de la versión de software que se esté ejecutando.

UpdatePriority

 UpdatePriority

Actualiza las prioridades.

Propiedades
Critical

La actualización se debe ejecutar de inmediato.

Normal

La actualización se puede ejecutar a discreción del cliente.

remotas

integrityLength

int integrityLength(
  uint8_t aType
)

Un método de compatibilidad que asigne los valores IntegrityTypes a la longitud de los hashes de ese tipo.

Detalles
Parámetros
[in] aType
Un valor IntegrityTypes
Qué muestra
Es la longitud del hash del tipo proporcionado.