Esta página foi traduzida pela API Cloud Translation.

Coprocessador de rede

Este módulo inclui funções que controlam a execução da pilha Thread.

Resumo

Typedefs
`otNcpDelegateAllowPeekPoke)(uint32_t aAddress, uint16_t aCount)`	typedef `bool(*` Define o tipo de delegado (apontador de função) para controlar o comportamento da operação de espiada/poke.
`otNcpHdlcSendCallback)(const uint8_t *aBuf, uint16_t aBufLength)`	typedef `int(*` Esse ponteiro de função é chamado para enviar dados NCP codificados em HDLC.

Funções
`otNcpHdlcInit(otInstance *aInstance, otNcpHdlcSendCallback aSendCallback)`	`void` Inicialize o NCP com base no enquadramento HDLC.
`otNcpHdlcReceive(const uint8_t *aBuf, uint16_t aBufLength)`	`void` Essa função é chamada depois que os dados NCP codificados em HDLC são recebidos.
`otNcpHdlcSendDone(void)`	`void` Essa função é chamada após o envio do NCP ser concluído.
`otNcpPlatLogv(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, va_list aArgs)`	`void` Grava o registro do OpenThread usando `otNcpStreamWrite`.
`otNcpRegisterPeekPokeDelagates(otNcpDelegateAllowPeekPoke aAllowPeekDelegate, otNcpDelegateAllowPeekPoke aAllowPokeDelegate)`	`void` Esse método registra funções delegadas de acesso rápido/poke com o módulo NCP.
`otNcpSpiInit(otInstance *aInstance)`	`void` Inicialize o NCP com base no enquadramento de SPI.
`otNcpStreamWrite(int aStreamId, const uint8_t *aDataPtr, int aDataLen)`	`otError` Envie dados ao host por um stream específico.

Typedefs

OtNcpDelegateAllowPeekPoke

bool(* otNcpDelegateAllowPeekPoke)(uint32_t aAddress, uint16_t aCount)

Define o tipo de delegado (apontador de função) para controlar o comportamento da operação de espiada/poke.

Essa função delegada é chamada para decidir se quer permitir a visualização prévia ou poke de uma região de memória específica. É usado se o suporte à NCP estiver ativado para comandos "spicar/poke".

Detalhes

Parâmetros

`[in] aAddress`	Endereço de início da região da memória.
`[in] aCount`	Número de bytes a serem exibidos ou tocados.

Retorna

Verdadeiro para permitir a visualização/poke da região de memória especificada, caso contrário, FALSO.

OtNcpHdlcSendCallback

int(* otNcpHdlcSendCallback)(const uint8_t *aBuf, uint16_t aBufLength)

Esse ponteiro de função é chamado para enviar dados NCP codificados em HDLC.

Detalhes

Parâmetros

`[in] aBuf`	Um ponteiro para um buffer com uma saída.
`[in] aBufLength`	Um comprimento dos dados de saída armazenados no buffer.

Retorna

Número de bytes processados pelo callback.

Funções

OtNcpHdlcInit

void otNcpHdlcInit(
  otInstance *aInstance,
  otNcpHdlcSendCallback aSendCallback
)

Inicialize o NCP com base no enquadramento HDLC.

Detalhes

Parâmetros

`[in] aInstance`	Estrutura da instância do OpenThread.
`[in] aSendCallback`	O ponteiro de função usado para enviar dados NCP.

otNcpHdlcReceber

void otNcpHdlcReceive(
  const uint8_t *aBuf,
  uint16_t aBufLength
)

Essa função é chamada depois que os dados NCP codificados em HDLC são recebidos.

Detalhes

Parâmetros

`[in] aBuf`	Um ponteiro para um buffer.
`[in] aBufLength`	O comprimento dos dados armazenados no buffer.

OtNcpHdlcSendDone

void otNcpHdlcSendDone(
  void
)

Essa função é chamada após o envio do NCP ser concluído.

OtNcpPlatLogv

void otNcpPlatLogv(
  otLogLevel aLogLevel,
  otLogRegion aLogRegion,
  const char *aFormat,
  va_list aArgs
)

Grava o registro do OpenThread usando otNcpStreamWrite.

Detalhes

Parâmetros

`[in] aLogLevel`	O nível de registro.
`[in] aLogRegion`	A região do registro.
`[in] aFormat`	Um ponteiro para a string de formato.
`[in] aArgs`	va_list correspondente aaFormat.

OtNcpRegisterPeekPokeDelagates

void otNcpRegisterPeekPokeDelagates(
  otNcpDelegateAllowPeekPoke aAllowPeekDelegate,
  otNcpDelegateAllowPeekPoke aAllowPokeDelegate
)

Esse método registra funções delegadas de acesso rápido/poke com o módulo NCP.

As funções delegadas são chamadas pelo módulo NCP para decidir se permitem a exibição prévia ou poke de uma região de memória específica. Se o ponteiro delegado for definido como NULL, ele permitirá uma operação de visualização/poke para qualquer endereço.

Detalhes

Parâmetros

`[in] aAllowPeekDelegate`	Delegue o ponteiro da função para a operação de exibição.
`[in] aAllowPokeDelegate`	Delegue o ponteiro da função para a operação poke.

OtNcpSpiInit

void otNcpSpiInit(
  otInstance *aInstance
)

Inicialize o NCP com base no enquadramento de SPI.

Detalhes

Parâmetros

[in] aInstance

Estrutura da instância do OpenThread.

OtNcpStreamWrite

otError otNcpStreamWrite(
  int aStreamId,
  const uint8_t *aDataPtr,
  int aDataLen
)

Envie dados ao host por um stream específico.

Essa função tenta enviar os dados fornecidos para o host usando o aStreamId fornecido. Isso é útil para relatar mensagens de erro, implementar consoles de depuração/diagnóstico e, possivelmente, outros tipos de fluxos de dados.

A gravação pode ser totalmente aceita ou rejeitada. Não é possível fazer gravações parciais.

Detalhes

Parâmetros

`[in] aStreamId`	Um identificador numérico para o stream a ser gravado. Se definido como "0", o fluxo de depuração será definido por padrão.
`[in] aDataPtr`	Um ponteiro para os dados que serão enviados no stream. Se o aDataLen for diferente de zero, esse parâmetro NÃO PODE ser NULL.
`[in] aDataLen`	O número de bytes de dados do aDataPtr para enviar.

Retornar valores

`OT_ERROR_NONE`	Os dados foram colocados na fila para entrega ao host.
`OT_ERROR_BUSY`	Não há recursos suficientes para concluir esta solicitação. Geralmente, essa é uma condição temporária.
`OT_ERROR_INVALID_ARGS`	O aStreamId fornecido era inválido.

Recursos

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