nl:: Weave:: Profiles:: SoftwareUpdate:: ImageQuery
#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>
Uma classe para dar suporte à criação e decodificação de mensagens de consulta de imagem.
Resumo
O frame de consulta de imagem tem o seguinte formato no fio.
Comprimento | Nome do campo |
1 byte | controle de frames |
6 bytes | especificação do produto |
variável | especificação da versão |
2,4 bytes | lista de tipos de integridade |
2,5 bytes | atualizar lista de esquemas |
variável | especificação da localidade (opcional) |
8 bytes | ID do nó de destino |
variável | dados específicos do fornecedor (opcional) |
Bit | Significado |
0 | 1 - dados específicos do fornecedor presentes, 0 - não presentes |
1 | 1 - especificação de localidade presente, 0 - não presente |
2 | 1 - ID do nó de destino presente, 0 - não presente |
3..7 | Reservados |
Construtores e destrutores |
|
---|---|
ImageQuery()
Construtor padrão de ImageQuery.
|
Atributos públicos |
|
---|---|
integrityTypes
|
Tipos de integridade com suporte do dispositivo.
|
localeSpec
|
Uma string UTF-8 de comprimento variável que contém a localidade POSIX em vigor no dispositivo para o qual a consulta de imagem está sendo feita.
|
packageSpec
|
Uma string UTF-8 de comprimento variável que contém uma string de especificação de pacote específica do fornecedor.
|
productSpec
|
Especificação do produto que descreve o dispositivo que está fazendo a consulta de imagem.
|
targetNodeId
|
uint64_t
Um ID de nó opcional do dispositivo que faz a consulta.
|
theMetaData
|
O campo de dados específico do fornecedor tem um tamanho variável e ocupa o restante da carga útil da mensagem do Weave, além dos campos descritos acima.
|
updateSchemes
|
Atualizar esquemas (protocolos de download) compatíveis com o dispositivo.
|
version
|
Uma string UTF-8 de comprimento variável que contém a versão do software especificada pelo fornecedor do dispositivo para o qual a consulta está sendo feita.
|
Funções públicas |
|
---|---|
init(ProductSpec & aProductSpec, ReferencedString & aVersion, IntegrityTypeList & aTypeList, UpdateSchemeList & aSchemeList, ReferencedString *aPackage, ReferencedString *aLocale, uint64_t aTargetNodeId, ReferencedTLVData *aMetaData)
|
Inicialize explicitamente o objeto ImageQuery com os valores fornecidos.
|
operator==(const ImageQuery &) const
|
bool
Um operador de igualdade.
|
pack(PacketBuffer *)
|
Serialize a ImageQuery subjacente no PacketBuffer fornecido.
|
print(void)
|
void
|
Funções estáticas públicas |
|
---|---|
parse(PacketBuffer *, ImageQuery &)
|
Desserializa a mensagem de consulta de imagem fornecida em um PacketBuffer em uma ImageQuery fornecida.
|
Atributos públicos
localeSpec
ReferencedString localeSpec
Uma string UTF-8 de comprimento variável que contém a localidade POSIX em vigor no dispositivo para o qual a consulta de imagem está sendo feita.
O conteúdo da string precisa estar de acordo com o formato do identificador de localidade POSIX, conforme especificado na norma ISO/IEC 15897, por exemplo, en_AU.UTF-8 para inglês australiano.
packageSpec
ReferencedString packageSpec
Uma string UTF-8 de comprimento variável que contém uma string de especificação de pacote específica do fornecedor.
O conteúdo do campo descreve o tipo de contêiner desejado para a imagem do software, como "rpm", "deb", "tgz", "elf" etc. OBSERVAÇÃO: esse campo não é usado nas implementações do protocolo Nest.
productSpec
ProductSpec productSpec
Especificação do produto que descreve o dispositivo que está fazendo a consulta de imagem.
targetNodeId
uint64_t targetNodeId
Um ID de nó opcional do dispositivo que faz a consulta.
O campo de ID do nó de destino é opcional. Se ausente, o ID do nó de destino para a consulta será implicitamente o nó que foi a origem da mensagem de consulta de imagem.
O campo de ID do nó de destino normalmente é usado em instâncias em que o nó de origem da mensagem IMAGE QUERY está servindo como um proxy de atualização de software para outro nó.
theMetaData
ReferencedTLVData theMetaData
O campo de dados específico do fornecedor tem um tamanho variável e ocupa o restante da carga útil da mensagem do Weave, além dos campos descritos acima.
O campo codifica informações específicas do fornecedor sobre o dispositivo para o qual a consulta está sendo feita. O campo de dados específico do fornecedor é opcional. Se estiver presente, o campo terá uma forma de estrutura anônima codificada por TLV. As tags apresentadas dentro dessa estrutura devem ser tags específicas do perfil totalmente qualificadas.
updateSchemes
UpdateSchemeList updateSchemes
Atualizar esquemas (protocolos de download) compatíveis com o dispositivo.
version
ReferencedString version
Uma string UTF-8 de comprimento variável que contém a versão do software especificada pelo fornecedor do dispositivo para o qual a consulta está sendo feita.
Precisa ter 32 ou menos.
Funções públicas
ImageQuery
ImageQuery()
Construtor padrão de ImageQuery.
A ImageQuery pode ser preenchida chamando init() ou desserializando o objeto de uma mensagem.
init
WEAVE_ERROR init( ProductSpec & aProductSpec, ReferencedString & aVersion, IntegrityTypeList & aTypeList, UpdateSchemeList & aSchemeList, ReferencedString *aPackage, ReferencedString *aLocale, uint64_t aTargetNodeId, ReferencedTLVData *aMetaData )
Inicialize explicitamente o objeto ImageQuery com os valores fornecidos.
Detalhes | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parâmetros |
|
||||||||||||||||
Retorna |
WEAVE_NO_ERROR Incondicionalmente.
|
operador==
bool operator==( const ImageQuery & ) const
Um operador de igualdade.
Detalhes | |||
---|---|---|---|
Parâmetros |
|
||
Retorna |
verdadeiro se todos os campos em ambos os objetos forem iguais. Caso contrário, será falso
|
pacote
WEAVE_ERROR pack( PacketBuffer * )
Serialize a ImageQuery subjacente no PacketBuffer fornecido.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
|
||||
Valores de retorno |
|
mostrar
void print( void )
Funções estáticas públicas
parse
WEAVE_ERROR parse( PacketBuffer *, ImageQuery & )
Desserializa a mensagem de consulta de imagem fornecida em um PacketBuffer em uma ImageQuery fornecida.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
|
||||
Retorna |
WEAVE_NO_ERROR Em caso de êxito
|
||||
Retorna |
WEAVE_ERROR_BUFFER_TOO_small se a mensagem for muito pequena para conter todos os campos da ImageQuery.
|
||||
Retorna |
WEAVE_ERROR_INVALID_LIST_LENGTH se a mensagem continha um IntegrityTypeList ou um UpdateSchemeList muito longo
|