Link bruto

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

Resumo

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

Funções
`otLinkRawEnergyScan ( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Este método inicia a seqüência de varredura de energia no rádio.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` Obtenha os recursos de rádio.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` Esta função obtém o status de modo promíscuo.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` Obtenha o tempo de plataforma atual (largura de 64 bits) do chip de rádio.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` Obtenha a medição RSSI mais recente.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` As transições de rádio de Transmitir para Receber.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` Esta função indica se a camada de link bruta está habilitada ou não.
`otLinkRawReceive ( otInstance *aInstance)`	`otError` Fazendo a transição do rádio de Dormir para Receber.
`otLinkRawSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Define o valor atual do contador de quadros 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` Esta função ativa / desativa a camada de link bruta.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Defina o endereço curto para filtragem de endereço.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` Faça a transição do rádio de Receber para Dormir.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Adicionando endereço estendido à tabela de correspondência 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ência de origem.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Removendo o endereço estendido para a tabela de correspondência de origem do rádio.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` Removendo todos os endereços curtos da tabela de correspondência de origem.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Removendo o endereço curto da tabela de correspondências de origem.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` Ativar / desativar correspondência de origem para quadro pendente.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Este método inicia a seqüê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 quadro IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância 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 quadro IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aFrame`	Um ponteiro para o quadro recebido ou NULL se a operação de recebimento foi abortada.
`[in] aError`	OT_ERROR_NONE ao receber um quadro com sucesso. OT_ERROR_ABORT quando a recepção foi abortada e um quadro não foi recebido.

otLinkRawTransmitDone

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

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

Detalhes

Parâmetros

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

Funções

otLinkRawEnergyScan

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

Este método inicia a seqüência de varredura de energia no rádio.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aScanChannel`	O canal para realizar a varredura de energia.
`[in] aScanDuration`	A duração, em milissegundos, do canal a ser varrido.
`[in] aCallback`	Um ponteiro para uma função chamada na conclusão de um canal varrido.

Valores Retornados

`OT_ERROR_NONE`	Varredura do canal iniciada com sucesso.
`OT_ERROR_NOT_IMPLEMENTED`	O rádio não suporta varredura de energia.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtenha os recursos de rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

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

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Esta função obtém o status de modo promíscuo.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

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

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O tempo de rádio atual em microssegundos.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Obtenha a medição RSSI mais recente.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

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

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

As transições de rádio de Transmitir para Receber.

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

O chamador forma o quadro IEEE 802.15.4 neste buffer e chama otLinkRawTransmit () para solicitar a transmissão.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

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

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

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

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Fazendo a transição do rádio de Dormir para Receber.

Ligue o rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Transição para receber com sucesso.
`OT_ERROR_INVALID_STATE`	O rádio foi desativado ou transmitindo.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Define o valor atual do contador de quadros MAC.

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

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 OpenThread.
`[in] aKeyIdMode`	O modo de identificação da chave.
`[in] aKeyId`	O índice principal.
`[in] aPrevKey`	A chave MAC anterior.
`[in] aCurrKey`	A chave MAC atual.
`[in] aNextKey`	A próxima chave MAC.

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

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 OpenThread.
`[in] aEnable`	Um valor para ativar ou desativar o modo promíscuo.

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

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

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_FAILED`	O rádio não pôde ser habilitado / desabilitado.
`OT_ERROR_INVALID_STATE`	Se a interface OpenThread IPv6 já estiver habilitada.
`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 OpenThread.
`[in] aShortAddress`	O endereço curto IEEE 802.15.4.

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Faça a transição do rádio de Receber para Dormir.

Desligue o rádio.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Transição para suspensão com sucesso.
`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ência de origem.

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_NONE`	Endereço estendido adicionado com sucesso à 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 bruta não estiver habilitada.

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 OpenThread.
`[in] aShortAddress`	O endereço curto a ser adicionado.

Valores Retornados

`OT_ERROR_NONE`	Endereço curto adicionado com sucesso à 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 bruta não estiver habilitada.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawSrcMatchClearExtEntry

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

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

Detalhes

Parâmetros

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

Valores Retornados

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

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

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

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_NONE`	Endereço curto removido com sucesso 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 link bruta não estiver habilitada.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

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

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_NONE`	Se for bem-sucedido.
`OT_ERROR_INVALID_STATE`	Se a camada de link bruta não estiver habilitada.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Este método inicia a seqüência de transmissão no rádio.

O chamador deve formar o quadro 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:

Fazendo a transição do rádio para transmitir da recepção.
Transmite o PSDU no canal fornecido e na potência de transmissão fornecida.

Detalhes

Parâmetros

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

Valores Retornados

`OT_ERROR_NONE`	Transição para Transmitir com sucesso.
`OT_ERROR_INVALID_STATE`	O rádio não estava no estado Receber.