Esta página foi traduzida pela API Cloud Translation.

Link

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

Resumo

Enumerações
`otMacFilterAddressMode { OT_MAC_FILTER_ADDRESS_MODE_DISABLED , OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST , OT_MAC_FILTER_ADDRESS_MODE_DENYLIST }`	enum Define o modo de endereço do filtro mac.

Typedefs
`otActiveScanResult`	typedef `struct otActiveScanResult` Esta estrutura representa um Beacon IEEE 802.15.4 recebido.
`otEnergyScanResult`	typedef `struct otEnergyScanResult` Esta estrutura representa um resultado de varredura de energia.
`otHandleActiveScanResult )(otActiveScanResult aResult, void aContext)`	typedef `void(*` Este ponteiro de função é chamado durante uma Varredura Ativa IEEE 802.15.4 quando um Beacon IEEE 802.15.4 é recebido ou a varredura é concluída.
`otHandleEnergyScanResult )(otEnergyScanResult aResult, void aContext)`	typedef `void(*` Este ponteiro de função é chamado durante uma varredura de energia IEEE 802.15.4 quando o resultado de um canal está pronto ou a varredura é concluída.
`otLinkPcapCallback )(const otRadioFrame aFrame, bool aIsTx, void aContext)`	typedef `void(*` Este ponteiro de função é chamado quando um quadro IEEE 802.15.4 é recebido.
`otMacCounters`	typedef `struct otMacCounters` Esta estrutura representa os contadores da camada MAC.
`otMacFilterAddressMode`	typedef `enum otMacFilterAddressMode` Define o modo de endereço do filtro mac.
`otMacFilterEntry`	typedef `struct otMacFilterEntry` Esta estrutura representa uma entrada do filtro Mac.
`otMacFilterIterator`	typedef `uint8_t` Usado para iterar por meio de entradas de filtro mac.
`otThreadLinkInfo`	typedef `struct otThreadLinkInfo` Esta estrutura representa informações específicas do link para mensagens recebidas do rádio Thread.

Funções
`otLinkActiveScan ( otInstance aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void aCallbackContext)`	`otError` Esta função inicia uma varredura ativa IEEE 802.15.4.
`otLinkConvertLinkQualityToRss ( otInstance *aInstance, uint8_t aLinkQuality)`	`int8_t` Este método converte a qualidade do link em força típica do sinal recebido.
`otLinkConvertRssToLinkQuality ( otInstance *aInstance, int8_t aRss)`	`uint8_t` Este método converte a intensidade do sinal recebido em qualidade do link.
`otLinkCslGetChannel ( otInstance *aInstance)`	`uint8_t` Esta função obtém o canal CSL.
`otLinkCslGetPeriod ( otInstance *aInstance)`	`uint16_t` Esta função obtém o período CSL.
`otLinkCslGetTimeout ( otInstance *aInstance)`	`uint32_t` Esta função obtém o tempo limite de CSL.
`otLinkCslSetChannel ( otInstance *aInstance, uint8_t aChannel)`	`otError` Esta função define o canal CSL.
`otLinkCslSetPeriod ( otInstance *aInstance, uint16_t aPeriod)`	`otError` Esta função define o período CSL.
`otLinkCslSetTimeout ( otInstance *aInstance, uint32_t aTimeout)`	`otError` Esta função define o tempo limite de CSL.
`otLinkEnergyScan ( otInstance aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void aCallbackContext)`	`otError` Esta função inicia uma varredura de energia IEEE 802.15.4.
`otLinkFilterAddAddress ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Este método adiciona um endereço estendido ao filtro MAC.
`otLinkFilterAddRssIn ( otInstance aInstance, const otExtAddress aExtAddress, int8_t aRss)`	`otError` Este método adiciona uma entrada fixa de intensidade de sinal recebido (em dBm) para as mensagens de um determinado endereço estendido no filtro MAC.
`otLinkFilterClearAddresses ( otInstance *aInstance)`	`void` Este método limpa todos os endereços estendidos do filtro MAC.
`otLinkFilterClearAllRssIn ( otInstance *aInstance)`	`void` Este método limpa todas as entradas de intensidade do sinal recebido (incluindo RSS-in padrão) no filtro MAC.
`otLinkFilterClearDefaultRssIn ( otInstance *aInstance)`	`void` Este método limpa qualquer intensidade de sinal recebida padrão definida anteriormente (em dBm) no filtro MAC.
`otLinkFilterGetAddressMode ( otInstance *aInstance)`	`otMacFilterAddressMode` Esta função obtém o modo de endereço do filtro MAC.
`otLinkFilterGetNextAddress ( otInstance aInstance, otMacFilterIterator aIterator, otMacFilterEntry *aEntry)`	`otError` Este método obtém uma entrada de filtro de endereço em uso.
`otLinkFilterGetNextRssIn ( otInstance aInstance, otMacFilterIterator aIterator, otMacFilterEntry *aEntry)`	`otError` Este método obtém uma entrada de filtro RssIn em uso.
`otLinkFilterRemoveAddress ( otInstance aInstance, const otExtAddress aExtAddress)`	`void` Este método remove um endereço estendido do filtro MAC.
`otLinkFilterRemoveRssIn ( otInstance aInstance, const otExtAddress aExtAddress)`	`void` Este método remove uma entrada de Filtro MAC para configuração fixa de intensidade de sinal recebido para um determinado endereço estendido.
`otLinkFilterSetAddressMode ( otInstance *aInstance, otMacFilterAddressMode aMode)`	`void` Esta função define o modo de endereço do filtro MAC.
`otLinkFilterSetDefaultRssIn ( otInstance *aInstance, int8_t aRss)`	`void` Este método define a intensidade do sinal recebido padrão (em dBm) no filtro MAC.
`otLinkGetCcaFailureRate ( otInstance *aInstance)`	`uint16_t` Esta função retorna a taxa de falha CCA (Clear Channel Assessment) atual.
`otLinkGetChannel ( otInstance *aInstance)`	`uint8_t` Obtenha o canal IEEE 802.15.4.
`otLinkGetCounters ( otInstance *aInstance)`	`const otMacCounters *` Obtenha os contadores da camada MAC.
`otLinkGetExtendedAddress ( otInstance *aInstance)`	`const otExtAddress *` Obtenha o endereço estendido IEEE 802.15.4.
`otLinkGetFactoryAssignedIeeeEui64 ( otInstance aInstance, otExtAddress aEui64)`	`void` Obtenha o IEEE EUI-64 atribuído de fábrica.
`otLinkGetMaxFrameRetriesDirect ( otInstance *aInstance)`	`uint8_t` Este método retorna o número máximo de novas tentativas de quadro durante a transmissão direta.
`otLinkGetMaxFrameRetriesIndirect ( otInstance *aInstance)`	`uint8_t` Este método retorna o número máximo de novas tentativas de quadro durante a transmissão indireta.
`otLinkGetPanId ( otInstance *aInstance)`	`otPanId` Obtenha o PAN ID IEEE 802.15.4.
`otLinkGetPollPeriod ( otInstance *aInstance)`	`uint32_t` Obtenha o período de pesquisa de dados do dispositivo final com sono.
`otLinkGetShortAddress ( otInstance *aInstance)`	`otShortAddress` Obtenha o endereço curto IEEE 802.15.4.
`otLinkGetSupportedChannelMask ( otInstance *aInstance)`	`uint32_t` Obtenha a máscara de canal com suporte da camada MAC.
`otLinkGetTxDirectRetrySuccessHistogram ( otInstance aInstance, uint8_t aNumberOfEntries)`	`const uint32_t *` Este método obtém o histograma de novas tentativas para um único pacote direto até o sucesso.
`otLinkGetTxIndirectRetrySuccessHistogram ( otInstance aInstance, uint8_t aNumberOfEntries)`	`const uint32_t *` Este método obtém o histograma de novas tentativas para um único pacote indireto até o sucesso.
`otLinkIsActiveScanInProgress ( otInstance *aInstance)`	`bool` Esta função indica se um IEEE 802.15.4 Active Scan está ou não em andamento.
`otLinkIsEnabled ( otInstance *aInstance)`	`bool` Esta função indica se a camada de link está habilitada ou não.
`otLinkIsEnergyScanInProgress ( otInstance *aInstance)`	`bool` Esta função indica se uma varredura de energia IEEE 802.15.4 está em andamento ou não.
`otLinkIsInTransmitState ( otInstance *aInstance)`	`bool` Esta função indica se um MAC IEEE 802.15.4 está ou não no estado de transmissão.
`otLinkIsPromiscuous ( otInstance *aInstance)`	`bool` Esta função indica se o modo promíscuo está habilitado ou não na camada de link.
`otLinkResetCounters ( otInstance *aInstance)`	`void` Redefina os contadores da camada MAC.
`otLinkResetTxRetrySuccessHistogram ( otInstance *aInstance)`	`void` Este método limpa as estatísticas do histograma para transmissões diretas e indiretas.
`otLinkSendDataRequest ( otInstance *aInstance)`	`otError` Esta função enfileira uma mensagem IEEE 802.15.4 Data Request para transmissão.
`otLinkSendEmptyData ( otInstance *aInstance)`	`otError` Esta função instrui o dispositivo a enviar um quadro de dados IEEE 802.15.4 vazio.
`otLinkSetChannel ( otInstance *aInstance, uint8_t aChannel)`	`otError` Defina o canal IEEE 802.15.4.
`otLinkSetEnabled ( otInstance *aInstance, bool aEnable)`	`otError` Esta função ativa ou desativa a camada de link.
`otLinkSetExtendedAddress ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Esta função define o endereço estendido IEEE 802.15.4.
`otLinkSetMaxFrameRetriesDirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)`	`void` Este método define o número máximo de novas tentativas de quadro durante a transmissão direta.
`otLinkSetMaxFrameRetriesIndirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)`	`void` Este método define o número máximo de novas tentativas de quadro durante a transmissão indireta.
`otLinkSetPanId ( otInstance *aInstance, otPanId aPanId)`	`otError` Defina o PAN ID IEEE 802.15.4.
`otLinkSetPcapCallback ( otInstance aInstance, otLinkPcapCallback aPcapCallback, void aCallbackContext)`	`void` Esta função registra um retorno de chamada para fornecer quadros IEEE 802.15.4 brutos recebidos.
`otLinkSetPollPeriod ( otInstance *aInstance, uint32_t aPollPeriod)`	`otError` Definir / limpar o período de pesquisa de dados externo / especificado pelo usuário para o dispositivo final com sono.
`otLinkSetPromiscuous ( otInstance *aInstance, bool aPromiscuous)`	`otError` Esta função ativa ou desativa o modo promíscuo da camada de link.
`otLinkSetSupportedChannelMask ( otInstance *aInstance, uint32_t aChannelMask)`	`otError` Defina a máscara de canal com suporte da camada MAC.

Structs
otActiveScanResult	Esta estrutura representa um Beacon IEEE 802.15.4 recebido.
otEnergyScanResult	Esta estrutura representa um resultado de varredura de energia.
otMacCounters	Esta estrutura representa os contadores da camada MAC.
otMacFilterEntry	Esta estrutura representa uma entrada do filtro Mac.
otThreadLinkInfo	Esta estrutura representa informações específicas do link para mensagens recebidas do rádio Thread.

Enumerações

otMacFilterAddressMode

 otMacFilterAddressMode

Define o modo de endereço do filtro mac.

Propriedades
`OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST`	O modo de filtro de endereço da lista de permissões está habilitado.
`OT_MAC_FILTER_ADDRESS_MODE_DENYLIST`	O modo de filtro de endereço Denylist está habilitado.
`OT_MAC_FILTER_ADDRESS_MODE_DISABLED`	O filtro de endereço está desativado.

Typedefs

otActiveScanResult

struct otActiveScanResult otActiveScanResult

Esta estrutura representa um Beacon IEEE 802.15.4 recebido.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

Esta estrutura representa um resultado de varredura de energia.

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

Este ponteiro de função é chamado durante uma Varredura Ativa IEEE 802.15.4 quando um Beacon IEEE 802.15.4 é recebido ou a varredura é concluída.

Detalhes

Parâmetros

`[in] aResult`	Um ponteiro válido para as informações do beacon ou NULL quando a varredura ativa é concluída.
`[in] aContext`	Um ponteiro para o contexto específico do aplicativo.

otHandleEnergyScanResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

Este ponteiro de função é chamado durante uma varredura de energia IEEE 802.15.4 quando o resultado de um canal está pronto ou a varredura é concluída.

Detalhes

Parâmetros

`[in] aResult`	Um ponteiro válido para as informações do resultado da varredura de energia ou NULL quando a varredura de energia for concluída.
`[in] aContext`	Um ponteiro para o contexto específico do aplicativo.

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

Este ponteiro de função é chamado quando um quadro IEEE 802.15.4 é recebido.

Nota: Este callback é chamado após o processamento FCS e aFrame não pode conter os FCS reais que foi recebido.

Detalhes

Parâmetros

`[in] aFrame`	Um ponteiro para o quadro IEEE 802.15.4 recebido.
`[in] aIsTx`	Se este quadro é transmitido, não recebido.
`[in] aContext`	Um ponteiro para o contexto específico do aplicativo.

otMacCounters

struct otMacCounters otMacCounters

Esta estrutura representa os contadores da camada MAC.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

Define o modo de endereço do filtro mac.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

Esta estrutura representa uma entrada do filtro Mac.

otMacFilterIterator

uint8_t otMacFilterIterator

Usado para iterar por meio de entradas de filtro mac.

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

Esta estrutura representa informações específicas do link para mensagens recebidas do rádio Thread.

Funções

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

Esta função inicia uma varredura ativa IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aScanChannels`	Um vetor de bit que indica quais canais fazer a varredura (por exemplo, OT_CHANNEL_11_MASK).
`[in] aScanDuration`	O tempo em milissegundos a ser gasto na varredura de cada canal.
`[in] aCallback`	Um ponteiro para uma função chamada ao receber um sinalizador ou varredura é concluído.
`[in] aCallbackContext`	Um ponteiro para o contexto específico do aplicativo.

Valores Retornados

`OT_ERROR_NONE`	Aceitou a solicitação de varredura ativa.
`OT_ERROR_BUSY`	Já realizando uma varredura ativa.

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Este método converte a qualidade do link em força típica do sinal recebido.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aLinkQuality`	O valor de LinkQuality deve estar no intervalo [0,3].

Devoluções

Plataforma típica recebido mapeamento intensidade do sinal para aLinkQuality .

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

Este método converte a intensidade do sinal recebido em qualidade do link.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aRss`	O valor de intensidade do sinal recebido a ser convertido.

Devoluções

Mapeamento valor de qualidade link para aRss .

otLinkCslGetChannel

uint8_t otLinkCslGetChannel(
  otInstance *aInstance
)

Esta função obtém o canal CSL.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O canal CSL.

otLinkCslGetPeriod

uint16_t otLinkCslGetPeriod(
  otInstance *aInstance
)

Esta função obtém o período CSL.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O período CSL em unidades de 10 símbolos.

otLinkCslGetTimeout

uint32_t otLinkCslGetTimeout(
  otInstance *aInstance
)

Esta função obtém o tempo limite de CSL.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O tempo limite de CSL em segundos.

otLinkCslSetChannel

otError otLinkCslSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Esta função define o canal CSL.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aChannel`	O canal de amostra CSL. Valor do canal deve ser `0` (Conjunto CSL canal não especificado) ou dentro do intervalo [1, 10] (915 MHz, se suportado) e 11, 26 .

Valores Retornados

`OT_ERROR_NONE`	Defina os parâmetros CSL com sucesso.
`OT_ERROR_INVALID_ARGS`	Inválida `aChannel` .

otLinkCslSetPeriod

otError otLinkCslSetPeriod(
  otInstance *aInstance,
  uint16_t aPeriod
)

Esta função define o período CSL.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPeriod`	O período CSL em unidades de 10 símbolos.

Valores Retornados

`OT_ERROR_NONE`	Defina o período CSL com sucesso.
`OT_ERROR_INVALID_ARGS`	Período CSL inválido.

otLinkCslSetTimeout

otError otLinkCslSetTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

Esta função define o tempo limite de CSL.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aTimeout`	O tempo limite de CSL em segundos.

Valores Retornados

`OT_ERROR_NONE`	Defina com sucesso o tempo limite de CSL.
`OT_ERROR_INVALID_ARGS`	Tempo limite de CSL inválido.

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

Esta função inicia uma varredura de energia IEEE 802.15.4.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aScanChannels`	Um vetor de bits que indica em quais canais realizar a varredura de energia.
`[in] aScanDuration`	O tempo em milissegundos a ser gasto na varredura de cada canal.
`[in] aCallback`	Um ponteiro para uma função chamada para passar o resultado da varredura indica a conclusão da varredura.
`[in] aCallbackContext`	Um ponteiro para o contexto específico do aplicativo.

Valores Retornados

`OT_ERROR_NONE`	Aceitou a solicitação do Energy Scan.
`OT_ERROR_BUSY`	Não foi possível iniciar a varredura de energia.

otLinkFilterAddAddress

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

Este método adiciona um endereço estendido ao filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aExtAddress`	Um ponteiro para o endereço estendido (NÃO DEVE ser NULL).

Valores Retornados

`OT_ERROR_NONE`	Adicionado com sucesso `aExtAddress` de filtro MAC.
`OT_ERROR_NO_BUFS`	Não existe nenhuma entrada disponível.

otLinkFilterAddRssIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

Este método adiciona uma entrada fixa de intensidade de sinal recebido (em dBm) para as mensagens de um determinado endereço estendido no filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aExtAddress`	Um ponteiro para o endereço estendido IEEE 802.15.4. Não deve ser nulo.
`[in] aRss`	A intensidade do sinal recebido (em dBm).

Valores Retornados

`OT_ERROR_NONE`	Adicionado com sucesso uma entrada para `aExtAddress` e `aRss` .
`OT_ERROR_NO_BUFS`	Não existe nenhuma entrada disponível.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

Este método limpa todos os endereços estendidos do filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

Este método limpa todas as entradas de intensidade do sinal recebido (incluindo RSS-in padrão) no filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Este método limpa qualquer intensidade de sinal recebida padrão definida anteriormente (em dBm) no filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

Esta função obtém o modo de endereço do filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

o modo de endereço.

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Este método obtém uma entrada de filtro de endereço em uso.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in,out] aIterator`	Um ponteiro para o contexto do iterador do filtro MAC. Para obter a primeira entrada de filtro de endereço em uso, deve ser definido como OT_MAC_FILTER_ITERATOR_INIT. Não deve ser nulo.
`[out] aEntry`	Um ponteiro para onde as informações são colocadas. Não deve ser nulo.

Valores Retornados

`OT_ERROR_NONE`	Obtida com sucesso uma entrada de filtro de endereço em uso.
`OT_ERROR_NOT_FOUND`	Não existe nenhuma entrada subsequente.

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Este método obtém uma entrada de filtro RssIn em uso.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in,out] aIterator`	Um ponteiro para o contexto do iterador do filtro MAC. Não deve ser nulo. Para obter a primeira entrada, deve ser definido como OT_MAC_FILTER_ITERATOR_INIT.
`[out] aEntry`	Um ponteiro para onde as informações são colocadas. A última entrada teria o endereço estendido como todos 0xff para indicar a intensidade do sinal recebido padrão se ele foi definido. `aEntry` não deve ser NULL.

Valores Retornados

`OT_ERROR_NONE`	Recuperado com sucesso a próxima entrada.
`OT_ERROR_NOT_FOUND`	Não existe nenhuma entrada subsequente.

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Este método remove um endereço estendido do filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Nenhuma ação é executada se não houver nenhuma entrada existente no Filtro que corresponda ao endereço estendido fornecido.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aExtAddress`	Um ponteiro para o endereço estendido (NÃO DEVE ser NULL).

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Este método remove uma entrada de Filtro MAC para configuração fixa de intensidade de sinal recebido para um determinado endereço estendido.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Nenhuma ação é executada se não houver nenhuma entrada existente no Filtro que corresponda ao endereço estendido fornecido.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aExtAddress`	Um ponteiro para o endereço estendido IEEE 802.15.4. Não deve ser nulo.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

Esta função define o modo de endereço do filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aMode`	O modo de endereço a ser definido.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

Este método define a intensidade do sinal recebido padrão (em dBm) no filtro MAC.

Esta função está disponível quando a configuração OPENTHREAD_CONFIG_MAC_FILTER_ENABLE está habilitada.

O valor RSS padrão é usado para todos os quadros recebidos de endereços para as quais não há nenhuma entrada RSS-IN explícita na lista Filter (adicionado usando otLinkFilterAddRssIn() ).

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aRss`	A intensidade do sinal recebido padrão (em dBm) a ser definida.

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

Esta função retorna a taxa de falha CCA (Clear Channel Assessment) atual.

A taxa é mantido sobre uma janela de (aproximadamente) última OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW quadro transmissões.

Detalhes
Devoluções	A taxa de falhas CCA com valor máximo `0xffff` correspondente à taxa de fracasso de 100%.

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

Obtenha o canal IEEE 802.15.4.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O canal IEEE 802.15.4.

Veja também:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Obtenha os contadores da camada MAC.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Um ponteiro para os contadores da camada MAC.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Obtenha o endereço estendido IEEE 802.15.4.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Um ponteiro para o endereço estendido IEEE 802.15.4.

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Obtenha o IEEE EUI-64 atribuído de fábrica.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para a instância OpenThread.
`[out] aEui64`	Um ponteiro para onde o IEEE EUI-64 atribuído de fábrica é colocado.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

Este método retorna o número máximo de novas tentativas de quadro durante a transmissão direta.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O número máximo de tentativas durante a transmissão direta.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

Este método retorna o número máximo de novas tentativas de quadro durante a transmissão indireta.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O número máximo de novas tentativas durante a transmissão indireta.

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Obtenha o PAN ID IEEE 802.15.4.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O IEEE 802.15.4 PAN ID.

Veja também:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Obtenha o período de pesquisa de dados do dispositivo final com sono.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

O período de pesquisa de dados do dispositivo final com sono em milissegundos.

Veja também:
otLinkSetPollPeriod

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Obtenha o endereço curto IEEE 802.15.4.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Um ponteiro para o endereço curto IEEE 802.15.4.

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

Obtenha a máscara de canal com suporte da camada MAC.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

A máscara de canal suportada como uint32_t com pouco mapeamento 0 (LSB) para o canal 0, bit 1 ao canal 1, assim por diante.

otLinkGetTxDirectRetrySuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Este método obtém o histograma de novas tentativas para um único pacote direto até o sucesso.

Esta função é válida quando a configuração OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[out] aNumberOfEntries`	Um ponteiro para onde o tamanho da matriz de histograma retornada é colocado.

Devoluções

Um ponteiro para o histograma de novas tentativas (na forma de uma matriz). O n-ésimo elemento indica que o pacote foi enviado com n-ésima tentativa.

otLinkGetTxIndirectRetrySuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Este método obtém o histograma de novas tentativas para um único pacote indireto até o sucesso.

Esta função é válida quando a configuração OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[out] aNumberOfEntries`	Um ponteiro para onde o tamanho da matriz de histograma retornada é colocado.

Devoluções

Um ponteiro para o histograma de novas tentativas (na forma de uma matriz). O n-ésimo elemento indica que o pacote foi enviado com n-ésima tentativa.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

Esta função indica se um IEEE 802.15.4 Active Scan está ou não em andamento.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

verdadeiro se uma varredura ativa IEEE 802.15.4 estiver em andamento; caso contrário, falso.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

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

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`true`	A camada de link está ativada.
`false`	A camada de link não está habilitada.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

Esta função indica se uma varredura de energia IEEE 802.15.4 está em andamento ou não.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

verdadeiro se uma varredura de energia IEEE 802.15.4 estiver em andamento; caso contrário, falso.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

Esta função indica se um MAC IEEE 802.15.4 está ou não no estado de transmissão.

O módulo MAC está no estado de transmissão durante o procedimento CSMA / CA, transmissão de quadro CCA, Dados, Beacon ou Solicitação de Dados e recebendo um ACK de um quadro transmitido. O módulo MAC não está no estado de transmissão durante a transmissão de um quadro ACK ou um quadro Beacon Request.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

verdadeiro se um MAC IEEE 802.15.4 estiver no estado de transmissão, falso caso contrário.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

Esta função indica se o modo promíscuo está ou não habilitado na camada de link.

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 não está ativado.

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Redefina os contadores da camada MAC.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

Este método limpa as estatísticas do histograma para transmissões diretas e indiretas.

Esta função é válida quando a configuração OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

Esta função enfileira uma mensagem IEEE 802.15.4 Data Request para transmissão.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Enfileirado com sucesso uma mensagem de solicitação de dados IEEE 802.15.4.
`OT_ERROR_ALREADY`	Uma mensagem de solicitação de dados IEEE 802.15.4 já está enfileirada.
`OT_ERROR_INVALID_STATE`	O dispositivo não está no modo rx-off-when-idle.
`OT_ERROR_NO_BUFS`	Buffers de mensagem insuficientes disponíveis.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

Esta função instrui o dispositivo a enviar um quadro de dados IEEE 802.15.4 vazio.

Esta função só é suportada em um dispositivo Rx-Off-When-Idle para enviar um quadro de dados vazio para seu pai. Nota: disponível somente quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE está habilitado.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores Retornados

`OT_ERROR_NONE`	Mensagem vazia enfileirada com sucesso.
`OT_ERROR_INVALID_STATE`	O dispositivo não está no modo Rx-Off-When-Idle.
`OT_ERROR_NO_BUFS`	Buffers de mensagem insuficientes disponíveis.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Defina o canal IEEE 802.15.4.

Esta função é bem-sucedida apenas quando os protocolos de thread estão desabilitados. Uma chamada bem-sucedida para esta função invalida os conjuntos de dados operacionais ativos e pendentes na memória não volátil.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aChannel`	O canal IEEE 802.15.4.

Valores Retornados

`OT_ERROR_NONE`	Defina o canal com sucesso.
`OT_ERROR_INVALID_ARGS`	Se `aChannel` não está no intervalo [11, 26] ou não é na máscara de canal suportada.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

Veja também:
otLinkGetChannel

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

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

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnable`	true para habilitar a camada de link ou false, caso contrário.

Valores Retornados

`OT_ERROR_NONE`	Ativado / desativado com sucesso a camada de link.
`OT_ERROR_INVALID_STATE`	Não foi possível desabilitar a camada de link porque a interface Thread está habilitada.

otLinkSetExtendedAddress

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

Esta função define o endereço estendido IEEE 802.15.4.

Esta função é bem-sucedida apenas quando os protocolos de thread estão desabilitados.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aExtAddress`	Um ponteiro para o endereço estendido IEEE 802.15.4.

Valores Retornados

`OT_ERROR_NONE`	Configure com sucesso o endereço estendido IEEE 802.15.4.
`OT_ERROR_INVALID_ARGS`	`aExtAddress` foi NULL.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

Este método define o número máximo de novas tentativas de quadro durante a transmissão direta.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aMaxFrameRetriesDirect`	O número máximo de tentativas durante a transmissão direta.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

Este método define o número máximo de novas tentativas de quadro durante a transmissão indireta.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aMaxFrameRetriesIndirect`	O número máximo de tentativas durante a transmissão indireta.

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

Defina o PAN ID IEEE 802.15.4.

Esta função é bem-sucedida apenas quando os protocolos de thread estão desabilitados. Uma chamada bem-sucedida para esta função também invalida os conjuntos de dados operacionais ativos e pendentes na memória não volátil.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPanId`	O IEEE 802.15.4 PAN ID.

Valores Retornados

`OT_ERROR_NONE`	Defina o PAN ID com sucesso.
`OT_ERROR_INVALID_ARGS`	Se aPanId não estiver no intervalo [0, 65534].
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

Veja também:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

Esta função registra um retorno de chamada para fornecer quadros IEEE 802.15.4 brutos recebidos.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPcapCallback`	Um ponteiro para uma função que é chamada ao receber um quadro de link IEEE 802.15.4 ou NULL para desativar o retorno de chamada.
`[in] aCallbackContext`	Um ponteiro para o contexto específico do aplicativo.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

Definir / limpar o período de pesquisa de dados externo / especificado pelo usuário para o dispositivo final com sono.

Nota: Esta função atualiza somente período de sondagem de dispositivo final sonolento. Para atualizar criança de tempo limite da função otThreadSetChildTimeout() será chamado.

Nota: Minimal valor diferente de zero deve ser OPENTHREAD_CONFIG_MAC_MINIMUM_POLL_PERIOD (10ms). Ou zero para limpar o período de sondagem especificado pelo usuário.

Nota: valor especificado pelo usuário não mais do que o valor máximo 0x3FFFFFF ((1 << 26) - 1) deve ser permitido, sob pena de ser cortada pelo valor máximo.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPollPeriod`	período de pesquisa de dados em milissegundos.

Valores Retornados

`OT_ERROR_NONE`	Definido / apagado com sucesso o período de pesquisa especificado pelo usuário.
`OT_ERROR_INVALID_ARGS`	Se aPollPeriod for inválido.

Veja também:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

Esta função ativa ou desativa o modo promíscuo da camada de link.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPromiscuous`	verdadeiro para habilitar o modo promíscuo ou falso caso contrário.

Valores Retornados

`OT_ERROR_NONE`	Modo promíscuo habilitado com sucesso.
`OT_ERROR_INVALID_STATE`	Não foi possível habilitar o modo promíscuo porque a interface Thread está habilitada.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Defina a máscara de canal com suporte da camada MAC.

Esta função é bem-sucedida apenas quando os protocolos de thread estão desabilitados.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aChannelMask`	A máscara de canal com suporte (bit 0 ou mapeamento lsb para o canal 0 e assim por diante).

Valores Retornados

`OT_ERROR_NONE`	Defina com sucesso a máscara de canal compatível.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

Macros

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

Usado para indicar que nenhuma intensidade de sinal recebido fixo foi definida.

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

Inicializador para otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS 160

Os microssegundos por 10 símbolos.

Link

Resumo

Enumerações

Typedefs

Funções

Structs

Enumerações

otMacFilterAddressMode

Typedefs

otActiveScanResult

otEnergyScanResult

otHandleActiveScanResult

otHandleEnergyScanResult

otLinkPcapCallback

otMacCounters

otMacFilterAddressMode

otMacFilterEntry

otMacFilterIterator

otThreadLinkInfo

Funções

otLinkActiveScan

otLinkConvertLinkQualityToRss

otLinkConvertRssToLinkQuality

otLinkCslGetChannel

otLinkCslGetPeriod

otLinkCslGetTimeout

otLinkCslSetChannel

otLinkCslSetPeriod

otLinkCslSetTimeout

otLinkEnergyScan

otLinkFilterAddAddress

otLinkFilterAddRssIn

otLinkFilterClearAddresses

otLinkFilterClearAllRssIn

otLinkFilterClearDefaultRssIn

otLinkFilterGetAddressMode

otLinkFilterGetNextAddress

otLinkFilterGetNextRssIn

otLinkFilterRemoveAddress

otLinkFilterRemoveRssIn

otLinkFilterSetAddressMode

otLinkFilterSetDefaultRssIn

otLinkGetCcaFailureRate

otLinkGetChannel

otLinkGetCounters

otLinkGetExtendedAddress

otLinkGetFactoryAssignedIeeeEui64

otLinkGetMaxFrameRetriesDirect

otLinkGetMaxFrameRetriesIndirect

otLinkGetPanId

otLinkGetPollPeriod

otLinkGetShortAddress

otLinkGetSupportedChannelMask

otLinkGetTxDirectRetrySuccessHistogram

otLinkGetTxIndirectRetrySuccessHistogram

otLinkIsActiveScanInProgress

otLinkIsEnabled

otLinkIsEnergyScanInProgress

otLinkIsInTransmitState

otLinkIsPromiscuous

otLinkResetCounters

otLinkResetTxRetrySuccessHistogram

otLinkSendDataRequest

otLinkSendEmptyData

otLinkSetChannel

otLinkSetEnabled

otLinkSetExtendedAddress

otLinkSetMaxFrameRetriesDirect

otLinkSetMaxFrameRetriesIndirect

otLinkSetPanId

otLinkSetPcapCallback

otLinkSetPollPeriod

otLinkSetPromiscuous

otLinkSetSupportedChannelMask

Macros

OT_MAC_FILTER_FIXED_RSS_DISABLED

OT_MAC_FILTER_ITERATOR_INIT

OT_US_PER_TEN_SYMBOLS