nl::Weave::Profiles::SoftwareUpdate

Esse namespace inclui todas as interfaces do Weave para o perfil Weave Software Update, que inclui o protocolo correspondente com o mesmo nome.

Resumo

Enumerações

@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 mensagens do 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
Sinalizações de controle do campo de controle do frame ImageQuery.
@312 enum
Bitmasks para o campo de opções de atualização opcional de ImageQueryResponse.
@313 enum
Deslocamentos de deslocamento do campo de opções de atualização opcional de ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
Tamanhos, em bytes, para as strings de bytes da especificação de integridade.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum
@317 enum
Tags de elementos de dados para o perfil SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
Condições que regem a política de atualização.
UpdatePriority{
  Normal,
  Critical
}
enum
Prioridades de atualização.

remotas

integrityLength(uint8_t aType)
int
Um método de suporte que mapeia os valores de IntegrityTypes para o comprimento dos hashes desse tipo.

Aulas

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

Interface para o delegado WeaveImageAnnounceServer.

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

Classe que descreve a mensagem ImageAnnounce.

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

Uma classe para dar suporte à criação e decodificação de mensagens de consulta de imagem.

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

Uma classe para dar suporte à criação e decodificação das mensagens de resposta da consulta de imagem.

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

Uma classe auxiliar que contém o tipo de integridade e o hash real da imagem de atualização de software.

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

Uma classe auxiliar para manter uma lista de tipos de integridade como parte da consulta de imagem.

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

Uma classe auxiliar que representa uma especificação de produto.

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

Uma classe auxiliar para manter uma lista de esquemas de atualização como parte da consulta de imagem.

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

Servidor que detecta anúncios de imagem do Weave.

Enumerações

@309

 @309

Tipos de mensagens do SoftwareUpdate.

Propriedades
kMsgType_DownloadNotify

Uma mensagem opcional do cliente para o servidor, usada para notificar o servidor sobre o status do download.

O payload dele é nl::Weave::Profiles::StatusReporting::StatusReport, com as informações adicionais de status extraídas de SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Uma mensagem não solicitada opcional, usada pelo servidor para anunciar a disponibilidade de uma atualização de software.

A mensagem não tem um payload.

kMsgType_ImageQuery

Uma mensagem de consulta enviada pelo cliente para o servidor.

O formato é definido com a classe ImageQuery.

kMsgType_ImageQueryResponse

Uma mensagem gerada em resposta a uma mensagem de consulta de imagem bem-sucedida.

O formato é definido pela classe ImageQueryResponse.

kMsgType_ImageQueryStatus

Uma mensagem gerada em resposta a uma falha na mensagem de consulta de imagem.

O payload dele é nl::Weave::Profiles::StatusReporting::StatusReport, com as informações adicionais de status extraídas de SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Uma mensagem gerada em resposta à mensagem de notificação de download.

O payload dele é nl::Weave::Profiles::StatusReporting::StatusReport, com as informações adicionais de status extraídas de SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Uma mensagem opcional do cliente para o servidor, usada para comunicar o status final da atualização.

O payload dele é nl::Weave::Profiles::StatusReporting::StatusReport, com as informações adicionais de status extraídas de SoftwareUpdateStatusCodes. Como a mensagem precisa ser gerada após a atualização, ela é enviada em um novo ExchangeContext e é tratada como uma mensagem não solicitada no servidor.

@310

 @310

Códigos de status do SoftwareUpdate específicos do perfil.

Propriedades
kStatus_Abort

server => client, indica que o cliente deve desistir, pois o servidor está sem opções.

kStatus_DownloadFailed

client => servidor, indica que ocorreu uma falha em uma tentativa de download.

kStatus_IntegrityCheckFailed

client => server, indica que uma imagem foi transferida por download, mas falhou na verificação de integridade subsequente.

kStatus_InvalidInstructions

client => server, indica que o cliente não conseguiu fazer o download de uma imagem porque as instruções de download contidas em ImageQueryResponse, ou seja,

URI, esquema de atualização, condição de atualização, foram mal formados ou inconsistentes.

kStatus_NoUpdateAvailable

server => cliente, indica que uma consulta de imagem foi recebida e compreendida e que o servidor não tem atualização para o cliente no momento.

kStatus_Retry

server => cliente, indica que o cliente deve enviar outra consulta de imagem e reiniciar/continuar a atualização.

kStatus_UpdateFailed

client => server, indica que ocorreu uma falha na tentativa de instalar uma imagem especificada pelo servidor.

@311

 @311

Sinalizações de controle do campo de controle do frame ImageQuery.

Propriedades
kFlag_LocaleSpecPresent

A especificação Locale está presente na ImageQuery.

kFlag_PackageSpecPresent

A especificação do pacote está presente em ImageQuery.

kFlag_TargetNodeIdPresent

O ID do nó de destino está presente em ImageQuery.

@312

 @312

Bitmasks para o campo de opções de atualização opcional de ImageQueryResponse.

@313

 @313

Deslocamentos de deslocamento do campo de opções de atualização opcional de ImageQueryResponse.

@314

 @314

Tipos de integridade com suporte do perfil do SoftwareUpdate.

O frame de consulta de imagem contém informações sobre as quais a verificação de integridade é compatível com o cliente, e a resposta da consulta de imagem contém um tipo e um valor de integridade para a imagem que o cliente está sendo instruído a baixar e instalar. Os tipos permitidos são:

Propriedades
kIntegrityType_Last

Número de elementos válidos na enumeração.

kIntegrityType_SHA160

Hash seguro de 160 bits, (SHA-1), obrigatório.

kIntegrityType_SHA256

Hash seguro de 256 bits (SHA-2).

kIntegrityType_SHA512

Hash seguro (SHA-2) de 512 bits.

@315

 @315

Tamanhos, em bytes, para as strings de bytes da especificação de integridade.

@316

 @316

Atualização dos esquemas compatíveis com o perfil do SofwareUpdate.

Da mesma forma que os tipos de integridade com suporte, a consulta de imagem contém informações sobre quais esquemas de atualização, ou seja, protocolos de download, o cliente aceita, e a resposta contém um valor para indicar o esquema de atualização a ser usado no download das imagens. Os esquemas com suporte são:

Propriedades
kUpdateScheme_BDX

A transferência de dados em massa do Weave será usada como protocolo de download.

kUpdateScheme_HTTP

O HTTP será usado como protocolo de download.

kUpdateScheme_HTTPS

HTTPS será usado como protocolo de download.

kUpdateScheme_Last

Número de elementos válidos na enumeração.

kUpdateScheme_SFTP

O SFTP será usado como protocolo de download.

@317

 @317

Tags de elementos de dados para o perfil SoftwareUpdate.

UpdateCondition

 UpdateCondition

Condições que regem a política de atualização.

Propriedades
IfLater

Faça o download e instale a imagem se a especificação da versão no frame de resposta for mais recente do que a versão do software instalada atualmente.

IfUnmatched

Faça o download e instale a imagem se a especificação da versão no frame de resposta não corresponder à versão do software instalada.

OnOptIn

fazer o download e instalar a imagem em algum acionador fornecido por um usuário no local.

Unconditionally

Faça o download e instale a imagem, independentemente da versão do software em execução no momento.

UpdatePriority

 UpdatePriority

Prioridades de atualização.

Propriedades
Critical

A atualização precisa ser executada imediatamente.

Normal

A atualização pode ser executada a critério do cliente.

remotas

integrityLength

int integrityLength(
  uint8_t aType
)

Um método de suporte que mapeia os valores de IntegrityTypes para o comprimento dos hashes desse tipo.

Detalhes
Parâmetros
[in] aType
Um valor IntegrityTypes
Retorna
Comprimento do hash do tipo de hash fornecido.