nl::Weave::Perfiles:SoftwareUpdate

Este espacio de nombres incluye todas las interfaces de Weave para el perfil de Weave Software Update, que incluye el protocolo correspondiente con el 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
@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 opcional de opciones de actualización de ImageQueryResponse.
@313 enum
Los desplazamientos del campo opcional de opciones de actualización de ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
Longitudes, en bytes, de 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 para el perfil de SoftwareUpdate
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
Condiciones que rigen la política de actualización.
UpdatePriority{
  Normal,
  Critical
}
enum
Actualizar prioridades.

Functions

integrityLength(uint8_t aType)
int
Un método de asistencia que mapea los valores de IntegrityTypes con las longitudes de los hash de ese tipo.

Clases

nl::Weave::Perfiles::Actualización de software::IWeaveImageAnnounceServerDelegate

Interfaz para el delegado WeaveImageAnnounceServer.

nl::Weave::Perfiles::Actualización de software::ImagenDeAnuncio

Clase que describe el mensaje ImageAnnounce.

nl::Weave::Perfiles::Actualización de software::ImageQuery

Una clase para admitir la creación y la decodificación de mensajes de búsqueda de imágenes.

nl::Weave::Perfiles::Actualización de software::ImageQueryResponse

Una clase para admitir la creación y la decodificación de los mensajes de respuesta de consultas de imágenes.

nl::Weave::Perfiles::Actualización de software::IntegritySpec

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

nl::Weave::Perfiles::Actualización de software::IntegrityTypeList

Una clase auxiliar para contener una lista de tipos de integridad como parte de la búsqueda de imágenes.

nl::Weave::Perfiles::Actualización de software::ProductSpec

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

nl::Weave::Perfiles::Actualización de software::UpdateSchemeList

Una clase auxiliar para contener una lista de esquemas de actualización como parte de la búsqueda de imágenes.

nl::Weave::Perfiles::Actualización de software::WeaveImageAnnounceServer

Servidor que escucha anuncios de imágenes de Weave.

Enumeraciones

@309

 @309

SoftwareUpdate.

Properties
kMsgType_DownloadNotify

Un mensaje opcional del cliente al servidor que se utiliza para notificarle sobre el estado de descarga.

Su carga útil es un 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 exitoso.

Su formato se define mediante la clase ImageQueryResponse.

kMsgType_ImageQueryStatus

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

Su carga útil es un 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 un 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 un 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 la actualización real, se envía en un ExchangeContext nuevo y se trata como un mensaje no solicitado en el servidor.

@310

 @310

SoftwareUpdate son códigos de estado específicos del perfil.

Properties
kStatus_Abort

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

kStatus_DownloadFailed

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

kStatus_IntegrityCheckFailed

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

kStatus_InvalidInstructions

client => el servidor indica que el cliente no pudo descargar una imagen porque las instrucciones de descarga que se incluyen en la ImageQueryResponse, es decir,

El URI, el esquema de actualización, la condición de actualización, estaban mal formados o eran incoherentes.

kStatus_NoUpdateAvailable

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

kStatus_Retry

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

kStatus_UpdateFailed

client => indica que falló un intento de instalar una imagen especificada por el servidor.

@311

 @311

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

Properties
kFlag_LocaleSpecPresent

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

kFlag_PackageSpecPresent

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

kFlag_TargetNodeIdPresent

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

@312

 @312

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

@313

 @313

Los desplazamientos del campo opcional de opciones de actualización de ImageQueryResponse.

@314

 @314

Tipos de integridad compatibles con el perfil SoftwareUpdate.

El marco de consulta de la imagen contiene información sobre la verificación de integridad que admite el cliente y la respuesta de la consulta de imagen contiene un tipo y un valor de integridad para la imagen que se le solicita al cliente descargar e instalar. Los tipos admitidos son los siguientes:

Properties
kIntegrityType_Last

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

kIntegrityType_SHA160

Se requiere el 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, de las strings de bytes de la especificación de integridad.

@316

 @316

Esquemas de actualización compatibles con el perfil de SofwareUpdate

Al igual que los tipos de integridad compatibles, la consulta de imagen contiene información sobre los esquemas de actualización, es decir, los protocolos de descarga, es compatible con 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:

Properties
kUpdateScheme_BDX

Se debe usar la transferencia masiva de datos de Weave como protocolo de descarga.

kUpdateScheme_HTTP

Se usará HTTP como protocolo de descarga.

kUpdateScheme_HTTPS

Se usará HTTPS como protocolo de descarga.

kUpdateScheme_Last

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

kUpdateScheme_SFTP

SFTP se usará como protocolo de descarga.

@317

 @317

Etiquetas de elementos de datos para el perfil de SoftwareUpdate

Condición de actualización

 UpdateCondition

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

Properties
IfLater

Descarga la imagen y, luego, instálala 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 que aparece en el marco de respuesta no coincide con la versión de software que está instalada actualmente.

OnOptIn

Descargue e instale la imagen en algún activador que proporciona un usuario en el sitio.

Unconditionally

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

Prioridad de actualización

 UpdatePriority

Actualizar prioridades.

Properties
Critical

La actualización debe ejecutarse de inmediato.

Normal

La actualización se puede ejecutar a discreción de los clientes.

Functions

Longitud de la integridad

int integrityLength(
  uint8_t aType
)

Un método de asistencia que mapea los valores de IntegrityTypes con las longitudes de los hash de ese tipo.

Detalles
Parámetros
[in] aType
Un valor IntegrityTypes
Qué muestra
Longitud del hash del tipo de hash proporcionado.