Esta página foi traduzida pela API Cloud Translation.

Link bruto

Este módulo inclui funções que controlam a configuração bruta de camada de link.

Resumo

Typedefs
`otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Este ponteiro de função no recebimento de um frame IEEE 802.15.4.
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Este ponteiro de função no recebimento de um frame IEEE 802.15.4.
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Este ponteiro de função no recebimento de um frame IEEE 802.15.4.

Functions
`otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Esse método inicia a sequência de verificação de energia no rádio.
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` Conheça os recursos de rádio.
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` Essa função recebe o status do modo promíscuo.
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` Indica o tempo atual da plataforma (largura de 64 bits) do chip de rádio.
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Faça a medição mais recente de RSSI.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` O rádio vai passar de Transmitir para Receber.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Essa função indica se a camada de link bruta está ativada ou não.
`otLinkRawReceive(otInstance *aInstance)`	`otError` Fazendo a transição do rádio do modo de suspensão para o recebimento.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Define o valor atual do contador de frames MAC.
`otLinkRawSetMacKey(otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Atualize as chaves MAC e o índice de chaves.
`otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)`	`otError` Esta função ativa ou desativa o modo promíscuo.
`otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Essa função ativa/desativa a camada de link bruta.
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Defina o Endereço curto para filtrar endereços.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Transição do rádio de "Receber" para "Sono".
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Adição de endereço estendido à tabela de correspondências de origem.
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Adição de um endereço curto à tabela de correspondências de origem.
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` Removendo todos os endereços estendidos da tabela de correspondências de origem.
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Removendo endereço estendido para a tabela de correspondências de origem do rádio.
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` Removendo todos os endereços curtos da tabela de correspondências de origem.
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Removendo endereço curto da tabela de correspondências de origem.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Ativar/desativar correspondência de origem para o frame pendente.
`otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Esse método inicia a sequência de transmissão no rádio.

Typedefs

OtLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

Este ponteiro de função no recebimento de um frame IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aEnergyScanMaxRssi`	O RSSI máximo encontrado no canal verificado.

OtLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Este ponteiro de função no recebimento de um frame IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aFrame`	Um ponteiro para o frame recebido ou NULL caso a operação de recebimento seja cancelada.
`[in] aError`	OT_ERROR_NONE ao receber um frame. OT_ERROR_ABORT quando a recepção foi cancelada e o frame não foi recebido.

OtLinkRawBroadcastDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

Este ponteiro de função no recebimento de um frame IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aFrame`	Um ponteiro para o frame que foi transmitido.
`[in] aAckFrame`	Um ponteiro para o frame ACK.
`[in] aError`	OT_ERROR_NONE quando o frame foi transmitido. OT_ERROR_NO_ACK quando o frame foi transmitido, mas nenhum ACK foi recebido OT_ERROR_CHANNEL_ACCESS_FAILURE quando a transmissão não pôde ocorrer devido a atividades no canal. OT_ERROR_ABORT quando a transmissão foi cancelada por outros motivos.

Functions

OtLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

Esse método inicia a sequência de verificação de energia no rádio.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aScanChannel`	O canal para realizar a busca de energia.
`[in] aScanDuration`	A duração, em milésimos de segundo, do canal a ser verificado.
`[in] aCallback`	Um ponteiro para uma função chamada após a conclusão de um canal verificado.

Valores de retorno

`OT_ERROR_NONE`	A verificação do canal foi iniciada.
`OT_ERROR_BUSY`	O rádio está realizando a digitalização.
`OT_ERROR_NOT_IMPLEMENTED`	O rádio não é compatível com a verificação de energia.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Conheça os recursos de rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

O vetor de bit da capacidade de rádio. A pilha ativa ou desativa algumas funções com base nesse valor.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Essa função recebe o status do modo promíscuo.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`true`	O modo promíscuo está ativado.
`false`	O modo promíscuo está desativado.

OtLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Indica o tempo atual da plataforma (largura de 64 bits) do chip de rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

O tempo de rádio atual em microssegundos.

OtLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Faça a medição mais recente de RSSI.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

O RSSI em dBm quando é válido. 127 quando a RSSI é inválida.

OtLinkRawGetBroadcastBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

O rádio vai passar de Transmitir para Receber.

Esse método retorna um ponteiro para o buffer de transmissão.

O autor da chamada forma o frame IEEE 802.15.4 nesse buffer e, em seguida, chama otLinkRawBroadcast() para solicitar a transmissão.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

Um ponteiro para o buffer de transmissão ou NULL se a camada de link bruta não estiver ativada.

OtLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Essa função indica se a camada de link bruta está ativada ou não.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`true`	A camada de link bruta está ativada.
`false`	A camada bruta de links está desativada.

OtLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Fazendo a transição do rádio do modo de suspensão para o recebimento.

Ligue o rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`OT_ERROR_NONE`	Transição para o recebimento concluída.
`OT_ERROR_INVALID_STATE`	O rádio foi desativado ou em transmissão.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor atual do contador de frames MAC.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aMacFrameCounter`	O valor do contador de frames MAC.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

Atualize as chaves MAC e o índice de chaves.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aKeyIdMode`	O modo de ID da chave.
`[in] aKeyId`	O índice da chave.
`[in] aPrevKey`	A chave MAC anterior.
`[in] aCurrKey`	A chave MAC atual.
`[in] aNextKey`	A próxima chave MAC.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Esta função ativa ou desativa o modo promíscuo.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aEnable`	Um valor para ativar ou desativar o modo promíscuo.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Essa função ativa/desativa a camada de link bruta.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aCallback`	Um ponteiro para uma função chamada ao receber um frame IEEE 802.15.4. NULL para desativar a camada de link bruto.

Valores de retorno

`OT_ERROR_FAILED`	Não foi possível ativar/desativar o rádio.
`OT_ERROR_INVALID_STATE`	Se a interface IPv6 do OpenThread já estiver ativada.
`OT_ERROR_NONE`	Se o estado de ativação foi definido com sucesso.

OtLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Defina o Endereço curto para filtrar endereços.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aShortAddress`	O endereço curto IEEE 802.15.4.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Transição do rádio de "Receber" para "Sono".

Desligue o rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`OT_ERROR_NONE`	Transição para o modo de suspensão concluída.
`OT_ERROR_BUSY`	A rádio estava transmitindo
`OT_ERROR_INVALID_STATE`	O rádio foi desativado

OtLinkRawSrcMatchAddExtEntry

otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Adição de endereço estendido à tabela de correspondências de origem.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aExtAddress`	O endereço estendido a ser adicionado.

Valores de retorno

`OT_ERROR_NONE`	O endereço estendido foi adicionado à tabela de correspondências de origem.
`OT_ERROR_NO_BUFS`	Não há entradas disponíveis na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Adição de um endereço curto à tabela de correspondências de origem.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aShortAddress`	O endereço curto a ser adicionado.

Valores de retorno

`OT_ERROR_NONE`	O endereço curto foi adicionado à tabela de correspondências de origem.
`OT_ERROR_NO_BUFS`	Não há entradas disponíveis na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Removendo todos os endereços estendidos da tabela de correspondências de origem.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSrcMatchClearExtEntry

otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Removendo endereço estendido para a tabela de correspondências de origem do rádio.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aExtAddress`	O endereço estendido a ser removido.

Valores de retorno

`OT_ERROR_NONE`	O endereço estendido foi removido da tabela de correspondências de origem.
`OT_ERROR_NO_ADDRESS`	O endereço estendido não está na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Removendo todos os endereços curtos da tabela de correspondências de origem.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Removendo endereço curto da tabela de correspondências de origem.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aShortAddress`	O endereço curto a ser removido.

Valores de retorno

`OT_ERROR_NONE`	O endereço curto foi removido da tabela de correspondências de origem.
`OT_ERROR_NO_ADDRESS`	O endereço curto não está na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Ativar/desativar correspondência de origem para o frame pendente.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aEnable`	Ativa/desativa a correspondência de origem para o frame pendente.

Valores de retorno

`OT_ERROR_NONE`	Se funcionar.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver ativada.

OtLinkRawTransmitir

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Esse método inicia a sequência de transmissão no rádio.

O autor da chamada precisa formar o frame IEEE 802.15.4 no buffer fornecido por otLinkRawGetBroadcastBuffer() antes de solicitar a transmissão. O canal e o poder de transmissão também estão incluídos na estrutura do otRadioFrame.

A sequência de transmissão consiste no seguinte:

Transição do rádio para Transmissão de Recebimento.
Transmite o PSDU no canal especificado e na potência de transmissão especificada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aCallback`	Um ponteiro para uma função chamada após a conclusão da transmissão.

Valores de retorno

`OT_ERROR_NONE`	A transição para "Transmitir" foi concluída.
`OT_ERROR_INVALID_STATE`	O rádio não estava no estado de recebimento.

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.