O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Marceneiro

Este módulo inclui funções para o papel Combinador de linhas de execução.

Resumo

Enumerações
otJoinerState tipo enumerado
Esta enumeração define o estado do Combinador.

Typedefs
otJoinerCallback)(otError aError, void *aContext) typedef
void(*
Esse ponteiro de função é chamado para notificar a conclusão de uma operação de mesclagem.
otJoinerDiscerner typedef
Essa estrutura representa um Discerner do combinador.
otJoinerState typedef
Esta enumeração define o estado do Combinador.

Functions
otJoinerGetDiscerner(otInstance *aInstance)
Essa função recebe o Discerner do combinador.
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
Essa função recebe o ID do Combinador.
otJoinerGetState(otInstance *aInstance)
Essa função retorna o estado do Combinador.
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
Essa função define o Discerner do combinador.
otJoinerStart(otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
Essa função ativa o papel de Thread Joiner.
otJoinerStateToString(otJoinerState aState)
const char *
Essa função converte um determinado valor de enumeração do estado do combinador em uma string legível.
otJoinerStop(otInstance *aInstance)
void
Essa função desativa o papel Thread Joiner.

Estruturas
otJoinerDiscerner (em inglês)

Essa estrutura representa um Discerner do combinador.

Enumerações

OtJoinerState

 otJoinerState

Esta enumeração define o estado do Combinador.

Typedefs

OtJoinerCallback

void(* otJoinerCallback)(otError aError, void *aContext)

Esse ponteiro de função é chamado para notificar a conclusão de uma operação de mesclagem.

Detalhes
Parâmetros
[in] aError
OT_ERROR_NONE se o processo de participação tiver sido concluído. OT_ERROR_SECURITY se o processo de participação falhar devido a credenciais de segurança. OT_ERROR_NOT_FOUND se nenhuma rede conjunta for encontrada. OT_ERROR_RESPONSE_REFUND se uma resposta expirar.
[in] aContext
Um ponteiro para contexto específico do aplicativo.

OtJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

Essa estrutura representa um Discerner do combinador.

OtJoinerState

enum otJoinerState otJoinerState

Esta enumeração define o estado do Combinador.

Functions

OtJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

Essa função recebe o Discerner do combinador.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância do OpenThread.
Retorna
Um ponteiro para o Discerner do combinador ou NULL caso nenhum esteja definido.

OtJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

Essa função recebe o ID do Combinador.

Se um discador não estiver definido, o ID do combinador será o primeiro resultado de 64 bits do cálculo do SHA-256 em relação ao IEEE 64-EU4 atribuído à fábrica. Caso contrário, o ID do combinador será calculado com base no valor do discador.

O ID do Combinador também é usado como o endereço estendido IEEE 802.15.4 do dispositivo durante o processo de comissionamento.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância do OpenThread.
Retorna
Um ponteiro para o ID do Combinador.

OtJoinerGetState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

Essa função retorna o estado do Combinador.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Valores de retorno
OT_JOINER_STATE_IDLE
OT_JOINER_STATE_DISCOVER
OT_JOINER_STATE_CONNECT
OT_JOINER_STATE_CONNECTED
OT_JOINER_STATE_ENTRUST
OT_JOINER_STATE_JOINED

OtJoinerSetDiscerner

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

Essa função define o Discerner do combinador.

O Discerner do combinador é usado para calcular o ID do combinador usado durante o processo de comissionamento/participação.

Por padrão, quando um disjuntor não é fornecido ou definido como NULL, o ID do combinador é derivado como os primeiros 64 bits do resultado do cálculo do SHA-256 em relação ao IEEE 64 da UE atribuído à fábrica. Esse é o principal comportamento esperado pela especificação da linha de execução.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para a instância do OpenThread.
[in] aDiscerner
Um ponteiro para um Discerner do combinador. Se NULL limpará todos os definidores anteriormente definidos
Valores de retorno
OT_ERROR_NONE
O discador do Combinador foi atualizado.
OT_ERROR_INVALID_ARGS
aDiscerner não é válido (o comprimento especificado não está dentro do intervalo válido).
OT_ERROR_INVALID_STATE
Como o processo de participação está em andamento, não foi possível mudar o discador.

OtJoinerStart

otError otJoinerStart(
  otInstance *aInstance,
  const char *aPskd,
  const char *aProvisioningUrl,
  const char *aVendorName,
  const char *aVendorModel,
  const char *aVendorSwVersion,
  const char *aVendorData,
  otJoinerCallback aCallback,
  void *aContext
)

Essa função ativa o papel de Thread Joiner.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aPskd
Um ponteiro para o PSKd.
[in] aProvisioningUrl
Um ponteiro para o URL de provisionamento (pode ser NULL).
[in] aVendorName
Um ponteiro para o nome do fornecedor (pode ser NULL).
[in] aVendorModel
Um ponteiro para o modelo do fornecedor (pode ser NULL).
[in] aVendorSwVersion
Um ponteiro para a versão SW do fornecedor (pode ser NULL).
[in] aVendorData
Um ponteiro para os dados do fornecedor (pode ser NULL).
[in] aCallback
Um ponteiro para uma função chamada quando a operação de mesclagem é concluída.
[in] aContext
Um ponteiro para contexto específico do aplicativo.
Valores de retorno
OT_ERROR_NONE
O papel de Combinador foi iniciado.
OT_ERROR_BUSY
A tentativa anterior ainda está em andamento.
OT_ERROR_INVALID_ARGS
aPskd ou aProvisioningUrl são inválidos.
OT_ERROR_INVALID_STATE
A pilha IPv6 não está ativada ou a pilha Thread está totalmente ativada.

otJoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

Essa função converte um determinado valor de enumeração do estado do combinador em uma string legível.

Detalhes
Parâmetros
[in] aState
É o estado da junção.
Retorna
Uma representação de string legível de aState.

OtJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

Essa função desativa o papel Thread Joiner.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.

Macros

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

Tamanho máximo em bits do Discerner do combinador.

Recursos

Os tópicos de referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para saber mais ou contribuir com nossa documentação, consulte Recursos.