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(*` Esse ponteiro de função recebe um frame IEEE 802.15.4.
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Esse ponteiro de função recebe um frame IEEE 802.15.4.
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Esse ponteiro de função recebe um frame IEEE 802.15.4.

Funções
`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` Obtenha os recursos de rádio.
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` Essa função recebe o status do modo promíscuo.
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` Obtém o tempo atual da plataforma (largura de 64 bits) do chip de rádio.
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Veja a medição RSSI mais recente.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` O rádio muda de Transmitir para Receber.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Essa função indica se a camada de link bruta está ou não ativada.
`otLinkRawReceive(otInstance *aInstance)`	`otError` Transição do rádio para Sono.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Define o valor do contador atual do frame MAC.
`otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Define o valor do contador do frame MAC somente se o novo valor for maior do que o atual.
`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` Esta função ativa/desativa a camada do link bruto.
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Defina o Endereço curto para filtragem de endereço.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Mude o rádio de "Receber para suspender".
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Adicionando o endereço estendido à tabela de correspondências de origem.
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Adicionando 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` Remoção do endereço estendido da 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` Remoção do endereço curto da tabela de correspondências de origem.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Ativar/Desativar correspondência de origem para o quadro 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)

Esse ponteiro de função recebe 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)

Esse ponteiro de função recebe 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 se a operação de recebimento for cancelada.
`[in] aError`	OT_ERROR_NONE ao receber um frame. OT_ERROR_ABORT quando a recepção foi cancelada e um frame não foi recebido.

OtLinkRawBroadcastDone

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

Esse ponteiro de função recebe 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 foi realizada devido à atividade no canal. OT_ERROR_ABORT quando a transmissão foi cancelada por outros motivos.

Funções

Verificação de energia no link

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 em que realizar a verificação de energia.
`[in] aScanDuration`	A duração, em milissegundos, da verificação do canal.
`[in] aCallback`	Um ponteiro para uma função chamada na 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 varredura de energia.
`OT_ERROR_NOT_IMPLEMENTED`	O rádio não suporta verificação de energia.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruto não estiver ativada.

OtLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtenha os recursos de rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

O vetor de bit de 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
)

Obtém 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
)

Veja a medição RSSI mais recente.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Retorna

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

OtLinkRawGetTransmissãoBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

O rádio muda 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 otLinkRawTransmissão() 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á ou não ativada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância do OpenThread.

Valores de retorno

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

OtLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Transição do rádio para Sono.

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 estava desativado ou transmitindo.

OtLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor do contador atual do frame MAC.

Essa função sempre define o contador MAC para o novo valor aMacFrameCounter, independentemente do valor atual.

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 bruto não estiver ativada.

OtLinkRawSetMacFrameCounterIfLarger.

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor do contador do frame MAC somente se o novo valor for maior do que o atual.

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 bruto 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 bruto não estiver ativada.

OtLinkRawSetPromiscuous (em inglês)

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 bruto não estiver ativada.

OtLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Esta função ativa/desativa a camada do link bruto.

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 do OpenThread IPv6 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 filtragem de endereço.

Detalhes

Parâmetros

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

Valores de retorno

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

OtLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Mude o rádio de "Receber para suspender".

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 espera concluída.
`OT_ERROR_BUSY`	O rádio estava transmitindo
`OT_ERROR_INVALID_STATE`	O rádio foi desativado

Entrada otLinkRawSrcMatchAddExtEntry

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

Adicionando o 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`	Nenhuma entrada disponível na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruto não estiver ativada.

OtLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Adicionando 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`	Nenhuma entrada disponível na tabela de correspondências de origem.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruto 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 bruto não estiver ativada.

Entrada otLinkRawSrcMatchClearExtEntry

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

Remoção do endereço estendido da 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 bruto 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 bruto não estiver ativada.

OtLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Remoção do 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`	Endereço curto 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 bruto não estiver ativada.

OtLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Ativar/Desativar correspondência de origem para o quadro pendente.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância do OpenThread.
`[in] aEnable`	Ativar/desativar correspondência de origem para o quadro pendente.

Valores de retorno

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

OtLinkRawBroadcast

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 a potência de transmissão também estão incluídos na estrutura do otRadioFrame.

A sequência de transmissão consiste em:

Transição do rádio para Transmissão a partir do recebimento.
Transmite o PSDU no canal e na potência de transmissão fornecidos.

Detalhes

Parâmetros

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

Valores de retorno

`OT_ERROR_NONE`	Transição concluída para a opção "Transmitir".
`OT_ERROR_INVALID_STATE`	O rádio não estava no estado Receber.

Recursos

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