Link bruto

Esse módulo inclui funções que controlam a configuração bruta da camada de links.

Resumo

Typedefs
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Ponteiro no recebimento de um frame IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Ponteiro no recebimento de um frame IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Ponteiro no recebimento de um frame IEEE 802.15.4.

remotas
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Inicia a sequência de busca de energia no rádio.
otLinkRawGetCaps(otInstance *aInstance)
Conheça os recursos de rádio.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Recebe o status do modo promíscuo.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Define o tempo atual da plataforma (largura de 64 bits) do chip de rádio.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Confira a medição de RSSI mais recente.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
O rádio passa da transmissão para o recebimento.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Indica se a camada de links bruta está ativada ou não.
otLinkRawReceive(otInstance *aInstance)
Transição do rádio de "Suspensão" para "Receber".
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Define o valor atual do contador de frames MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Define o valor atual do contador de frames MAC somente se o novo valor for maior que o atual.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
Atualizar as chaves MAC e o índice de chaves.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Ativa ou desativa o modo promíscuo.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Ativa/desativa a camada de links bruta.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Defina o endereço curto para a filtragem de endereço.
otLinkRawSleep(otInstance *aInstance)
Transição do rádio de recebimento para suspensão.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Adicionando endereço estendido à tabela de correspondências de origem.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Adicionando endereço curto à tabela de correspondências de origem.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Remover todos os endereços estendidos da tabela de correspondências de origem.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Remover o endereço estendido da tabela de correspondências de origem do rádio.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Remover todos os endereços curtos da tabela de correspondências de origem.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Remoção do endereço curto da tabela de correspondências de origem.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Ativar/desativar correspondência de origem para frame pendente.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Inicia a sequência de transmissão no rádio.

Typedefs

otLinkRawEnergyScanDone

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

Ponteiro 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)

Ponteiro 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 se a operação de recebimento tiver sido cancelada.
[in] aError
OT_ERROR_NONE quando um frame foi recebido. OT_ERROR_ABORT quando a recepção foi cancelada e um frame não foi recebido.

otLinkRawTransmitDone

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

Ponteiro 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_ERRORS quando a transmissão não pôde ocorrer devido à atividade no canal. OT_ERROR_ABORT quando a transmissão foi cancelada por outros motivos.

remotas

otLinkRawEnergyScan

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

Inicia a sequência de busca de energia no rádio.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aScanChannel
O canal em que a verificação de energia será realizada.
[in] aScanDuration
A duração, em milissegundos, do canal a ser buscado.
[in] aCallback
Um ponteiro para uma função chamada na conclusão de um canal verificado.
Valores de retorno
OT_ERROR_NONE
A busca do canal foi iniciada.
OT_ERROR_BUSY
O rádio está fazendo a leitura de energia.
OT_ERROR_NOT_IMPLEMENTED
O rádio não tem suporte à verificação de energia.
OT_ERROR_INVALID_STATE
Se a camada de links 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 bits da capacidade de rádio. A pilha ativa ou desativa algumas funções com base nesse valor.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

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
)

Define 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
)

Confira a medição de 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.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

O rádio passa da transmissão para o recebimento.

Retorna um ponteiro para o buffer de transmissão.

O autor da chamada forma o frame IEEE 802.15.4 nesse buffer e depois chama otLinkRawTransmit() 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 enlace bruta não estiver ativada.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Indica se a camada de links 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 enlace bruta está ativada.
false
A camada de enlace bruta está desativada.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

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

Ligue o rádio.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
Valores de retorno
OT_ERROR_NONE
Transferido para recebimento.
OT_ERROR_INVALID_STATE
O rádio estava desativado ou em transmissão.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor atual do contador de frames MAC.

Sempre define o contador MAC como o novo valor fornecido aMacFrameCounter, independente 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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor atual do contador de frames MAC somente se o novo valor for maior 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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links 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
)

Atualizar 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 de chave.
[in] aPrevKey
A chave MAC anterior.
[in] aCurrKey
A chave MAC atual.
[in] aNextKey
A próxima tecla MAC.
Valores de retorno
OT_ERROR_NONE
Se for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Ativa/desativa a camada de links 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.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Defina o endereço curto para a filtragem de endereço.

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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Transição do rádio de recebimento para suspensão.

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 concluída para o modo de suspensão.
OT_ERROR_BUSY
O rádio estava transmitindo
OT_ERROR_INVALID_STATE
O rádio foi desativado

otLinkRawSrcMatchAddExtEntry

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

Adicionando 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 links bruta 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 links bruta não estiver ativada.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Remover 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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSrcMatchClearExtEntry

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

Remover o 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 links bruta não estiver ativada.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Remover 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 for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta 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
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ência de origem.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

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

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aEnable
Ativar/desativar a correspondência de origem para o frame pendente.
Valores de retorno
OT_ERROR_NONE
Se for bem-sucedido.
OT_ERROR_INVALID_STATE
Se a camada de links bruta não estiver ativada.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

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 otLinkRawGetTransmitBuffer() antes de solicitar a transmissão. O canal e a potência de transmissão também estão incluídos na estrutura otRadioFrame.

A sequência de transmissão consiste em:

  1. Transição do rádio para transmitir do recebimento.
  2. Transmite a 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 transmissão.
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 mais informações ou para contribuir com nossa documentação, consulte Recursos.