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)
em que o campo de controle de frames tem campos de bits, como mostrado a seguir:

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
A ImageQuery, como uma estrutura, tem leitura um pouco diferente da representação em trânsito. Em particular, a versão e a localidade são strings c com terminação nula (em oposição a tuplas (comprimento, caracteres), e os dois itens opcionais são representados como ponteiros anuláveis, portanto, não há um booleano separado para verificar.

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

integrityTypes

IntegrityTypeList integrityTypes

Tipos de integridade com suporte do dispositivo.

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
[in] aProductSpec
Especificação do produto.
[in] aVersion
Versão do software instalada atualmente.
[in] aTypeList
Os tipos de integridade compatíveis com o cliente.
[in] aSchemeList
Os esquemas de atualização suportados pelo cliente.
[in] aPackage
Especificação de um pacote opcional com suporte do cliente.
[in] aLocale
Especificação de localidade opcional solicitada pelo cliente.
[in] aTargetNodeId
Um ID de nó de destino opcional.
[in] aMetaData
Um blob de dados do fornecedor opcional codificado em TLV.
Retorna
WEAVE_NO_ERROR Incondicionalmente.

operador==

bool operator==(
  const ImageQuery &
) const

Um operador de igualdade.

Detalhes
Parâmetros
another
Uma ImageQuery para verificar essa ImageQuery
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
[in] aBuffer
Um buffer de pacote em que a consulta será empacotada.
Valores de retorno
WEAVE_NO_ERROR
Se a operação for bem-sucedida
WEAVE_ERROR_BUFFER_TOO_SMALL
Se ImageQuery é muito grande para caber no buffer fornecido.

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
[in] aBuffer
Um ponteiro para um pacote para analisar a consulta de imagem.
[in] aQuery
Objeto no qual colocar o resultado
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