nl :: Tecer:: Perfis :: Atualização de software:: ImageQueryResponse
#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>
Uma classe para oferecer suporte à criação e decodificação das mensagens de resposta de consulta de imagem.
Resumo
A mensagem de resposta à consulta de imagem tem o formato:
comprimento | Nome do Campo |
variável | URI |
variável | Especificação de versão |
variável | Especificação de integridade |
1 byte | Esquema de atualização |
1 byte | Opções de atualização |
Mordeu | Significado |
0..2 | Prioridade de atualização |
3..4 | Atualizar condição |
5 | Status do relatório. Quando definido, o cliente é solicitado a gerar as mensagens DownloadNotify e UpdateNotify opcionais. |
5..7 | Reservado |
Construtores e Destruidores | |
---|---|
ImageQueryResponse () O construtor padrão para ImageQueryResponse . |
Atributos públicos | |
---|---|
integritySpec | Um campo que contém as informações de integridade (tipo de integridade e um hash) para a imagem de atualização de software. |
reportStatus | bool Solicite para informar o servidor sobre o andamento da atualização do software por meio das mensagens opcionais DownloadNotify e UpdateNotify. |
updateCondition | Instruções sobre as condições sob as quais proceder com a atualização do software. |
updatePriority | Instruções que orientam o dispositivo quando realizar a atualização do software. |
updateScheme | uint8_t O esquema de atualização a ser usado para baixar a imagem de atualização do software. |
uri | Uma string UTF-8 de comprimento variável contendo a localização da imagem do software. |
versionSpec | Uma string UTF-8 de comprimento variável contendo uma identificação de versão de software específica do fornecedor. |
Funções públicas | |
---|---|
init ( ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority , UpdateCondition , bool) | Inicialize explicitamente o objeto ImageQueryResponse com os valores fornecidos. |
operator== (const ImageQueryResponse &) const | bool Um operador de igualdade. |
pack (PacketBuffer *) | Serialize o ImageQueryResponse no PacketBuffer fornecido. |
print (void) | void |
Funções estáticas públicas | |
---|---|
parse (PacketBuffer *, ImageQueryResponse &) | Desserialize a mensagem de resposta de consulta de imagem fornecida em um PacketBuffer em um ImageQueryResponse fornecido. |
Atributos públicos
integridadeSpec
IntegritySpec integritySpec
Um campo que contém as informações de integridade (tipo de integridade e um hash) para a imagem de atualização de software.
reportStatus
bool reportStatus
Solicite para informar o servidor sobre o andamento da atualização do software por meio das mensagens opcionais DownloadNotify e UpdateNotify.
updateCondition
UpdateCondition updateCondition
Instruções sobre as condições sob as quais proceder com a atualização do software.
updatePriority
UpdatePriority updatePriority
Instruções que orientam o dispositivo quando realizar a atualização do software.
updateScheme
uint8_t updateScheme
O esquema de atualização a ser usado para baixar a imagem de atualização do software.
Seu valor é obtido de UpdateSchemes .
uri
ReferencedString uri
Uma string UTF-8 de comprimento variável contendo a localização da imagem do software.
O conteúdo desta string deve estar em conformidade com a especificação RFC 3986. Para esquemas de atualização correspondentes a um protocolo de Internet bem definido (HTTP, HTTPS, SFTP), o elemento do esquema do URI DEVE estar em conformidade com a codificação canônica de URL para esse esquema de protocolo. O comprimento da sequência não deve exceder 65565 e a sequência deve caber em uma única mensagem Weave, que pode estar sujeita a limitações de MTU.
versionSpec
ReferencedString versionSpec
Uma string UTF-8 de comprimento variável contendo uma identificação de versão de software específica do fornecedor.
O comprimento da string não deve exceder 256 bytes.
Funções públicas
ImageQueryResponse
ImageQueryResponse()
O construtor padrão para ImageQueryResponse .
O ImageQueryResponse pode ser preenchido por meio do método init () ou pela desserialização do objeto de uma mensagem.
iniciar
WEAVE_ERROR init( ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority, UpdateCondition, bool )
Inicialize explicitamente o objeto ImageQueryResponse com os valores fornecidos.
Detalhes | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||||||||||
Devoluções | WEAVE_NO_ERROR Incondicionalmente. |
operador ==
bool operator==( const ImageQueryResponse & ) const
Um operador de igualdade.
Detalhes | |||
---|---|---|---|
Parâmetros |
| ||
Devoluções | verdadeiro se todos os campos em ambos os objetos forem iguais, falso caso contrário |
pacote
WEAVE_ERROR pack( PacketBuffer * )
Serialize o ImageQueryResponse no PacketBuffer fornecido.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Valores Retornados |
|
impressão
void print( void )
Funções estáticas públicas
analisar
WEAVE_ERROR parse( PacketBuffer *, ImageQueryResponse & )
Desserialize a mensagem de resposta de consulta de imagem fornecida em um PacketBuffer em um ImageQueryResponse fornecido.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | WEAVE_NO_ERROR com sucesso | ||||
Devoluções | WEAVE_ERROR_BUFFER_TOO_SMALL Se a mensagem era muito pequena para conter todos os campos do ImageQuery | ||||
Devoluções | WEAVE_ERROR_INVALID_INTEGRITY_TYPE Se o tipo de integridade fornecido não for um dos valores especificados em IntegrityTypes |