Vínculo
Este módulo incluye funciones que controlan la configuración de las capas de vínculos.
Resumen
Enumeraciones |
|
---|---|
otMacFilterAddressMode{
|
Enum Define el modo de dirección del filtro de Mac. |
Typedefs |
|
---|---|
otActiveScanResult
|
typedefstruct otActiveScanResult
Esta estructura representa una baliza con IEEE 802.15.4 recibida. |
otEnergyScanResult
|
typedefstruct otEnergyScanResult
Esta estructura representa un resultado de análisis de energía. |
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
|
typedefvoid(*
Se llama a este puntero de función durante un escaneo activo de IEEE 802.15.4 cuando se recibe una baliza IEEE 802.15.4 o se completa el análisis. |
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
|
typedefvoid(*
Se llama a este puntero de función durante un escaneo de energía IEEE 802.15.4 cuando el resultado para un canal está listo o el análisis se completa. |
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
|
typedefvoid(*
Se llama a este puntero de función cuando se recibe un marco IEEE 802.15.4. |
otMacCounters
|
typedefstruct otMacCounters
Esta estructura representa los contadores de capa MAC. |
otMacFilterAddressMode
|
typedef Define el modo de dirección del filtro de Mac. |
otMacFilterEntry
|
typedefstruct otMacFilterEntry
Esta estructura representa una entrada de filtro de Mac. |
otMacFilterIterator
|
typedefuint8_t
Se usa para iterar a través de entradas de filtros de Mac. |
otThreadLinkInfo
|
typedefstruct otThreadLinkInfo
Esta estructura representa información específica del vínculo para los mensajes recibidos de la radio Thread. |
Funciones |
|
---|---|
otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
|
Esta función inicia un análisis activo IEEE 802.15.4.
|
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
|
int8_t
Este método convierte la calidad del vínculo en la intensidad típica de la señal recibida.
|
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
|
uint8_t
Este método convierte la intensidad de la señal recibida en calidad de vínculo.
|
otLinkCslGetChannel(otInstance *aInstance)
|
uint8_t
Esta función obtiene el canal CSL.
|
otLinkCslGetPeriod(otInstance *aInstance)
|
uint16_t
Esta función obtiene el período CSL.
|
otLinkCslGetTimeout(otInstance *aInstance)
|
uint32_t
Esta función obtiene el tiempo de espera de CSL.
|
otLinkCslSetChannel(otInstance *aInstance, uint8_t aChannel)
|
Establece el canal de CSL.
|
otLinkCslSetPeriod(otInstance *aInstance, uint16_t aPeriod)
|
Establece el período de CSL en unidades de 10 símbolos.
|
otLinkCslSetTimeout(otInstance *aInstance, uint32_t aTimeout)
|
Establece el tiempo de espera del CSL en segundos.
|
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
|
Esta función inicia un escaneo de energía IEEE 802.15.4.
|
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
Este método agrega una dirección extendida al filtro de MAC.
|
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
|
Este método agrega una entrada de intensidad de la señal recibida (en dBm) fija para los mensajes desde una dirección extendida determinada en el filtro de MAC.
|
otLinkFilterClearAddresses(otInstance *aInstance)
|
void
Este método borra todas las direcciones extendidas del filtro de MAC.
|
otLinkFilterClearAllRssIn(otInstance *aInstance)
|
void
Este método borra todas las entradas de intensidad de señal recibidas (incluida la entrada RSS predeterminada) en el filtro MAC.
|
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
|
void
Este método borra la intensidad de la señal recibida (en dBm) predeterminada que se configuró anteriormente en el filtro MAC.
|
otLinkFilterGetAddressMode(otInstance *aInstance)
|
Esta función obtiene el modo de dirección del filtro MAC.
|
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
|
Este método obtiene una entrada de filtro de direcciones en uso.
|
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
|
Este método obtiene una entrada de filtro RssIn en uso.
|
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
void
Este método quita una dirección extendida del filtro de MAC.
|
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
|
void
Este método quita una entrada de filtro MAC para la configuración de intensidad de la señal recibida fija para una dirección extendida determinada.
|
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
|
void
Esta función establece el modo de dirección del filtro MAC.
|
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
|
void
Este método establece la intensidad de la señal recibida (dBm) predeterminada en el filtro de MAC.
|
otLinkGetCcaFailureRate(otInstance *aInstance)
|
uint16_t
Esta función muestra la tasa de fallas actual de CCA (Clear Channel Assessment).
|
otLinkGetChannel(otInstance *aInstance)
|
uint8_t
Obtén el canal IEEE 802.15.4.
|
otLinkGetCounters(otInstance *aInstance)
|
const otMacCounters *
Obtén los contadores de capa de MAC.
|
otLinkGetExtendedAddress(otInstance *aInstance)
|
const otExtAddress *
Obtiene la dirección extendida IEEE 802.15.4.
|
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
|
void
Obtén la IEEE EUI-64 asignada a la fábrica.
|
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
|
uint8_t
Este método muestra la cantidad máxima de reintentos de fotogramas durante la transmisión directa.
|
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
|
uint8_t
Este método muestra la cantidad máxima de reintentos de fotogramas durante la transmisión indirecta.
|
otLinkGetPanId(otInstance *aInstance)
|
Obtén el ID de PAN de IEEE 802.15.4.
|
otLinkGetPollPeriod(otInstance *aInstance)
|
uint32_t
Obtiene el período de sondeo de datos del dispositivo final soñoliento.
|
otLinkGetShortAddress(otInstance *aInstance)
|
Obtén la dirección corta IEEE 802.15.4.
|
otLinkGetSupportedChannelMask(otInstance *aInstance)
|
uint32_t
Obtén la máscara de canal compatible de la capa MAC.
|
otLinkGetTxDirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
|
const uint32_t *
Este método obtiene el histograma de reintentos para un solo paquete directo hasta que se completa correctamente.
|
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
|
const uint32_t *
Este método obtiene el histograma de reintentos para un solo paquete indirecto hasta que se ejecuta de forma correcta.
|
otLinkIsActiveScanInProgress(otInstance *aInstance)
|
bool
Esta función indica si hay un escaneo activo de IEEE 802.15.4 en curso.
|
otLinkIsEnabled(otInstance *aInstance)
|
bool
Esta función indica si la capa del vínculo está habilitada o no.
|
otLinkIsEnergyScanInProgress(otInstance *aInstance)
|
bool
Esta función indica si un análisis de energía IEEE 802.15.4 está en curso.
|
otLinkIsInTransmitState(otInstance *aInstance)
|
bool
Esta función indica si una MAC IEEE 802.15.4 está en el estado de transmisión.
|
otLinkIsPromiscuous(otInstance *aInstance)
|
bool
Esta función indica si el modo promiscuo está habilitado en la capa del vínculo.
|
otLinkIsRadioFilterEnabled(otInstance *aInstance)
|
bool
Esta función indica si el filtro de radio IEEE 802.15.4 está habilitado o no.
|
otLinkResetCounters(otInstance *aInstance)
|
void
Restablece los contadores de capa MAC.
|
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
|
void
Este método borra las estadísticas del histograma para las transmisiones indirectas y directas.
|
otLinkSendDataRequest(otInstance *aInstance)
|
Esta función pone en cola un mensaje de solicitud de datos IEEE 802.15.4 para su transmisión.
|
otLinkSendEmptyData(otInstance *aInstance)
|
Esta función indica al dispositivo que envíe un marco de datos vacío IEEE 802.15.4.
|
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
|
Configura el canal IEEE 802.15.4.
|
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
|
Esta función habilita o inhabilita la capa de vínculo.
|
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
Configura la dirección extendida IEEE 802.15.4.
|
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
|
void
Este método establece la cantidad máxima de reintentos de trama durante la transmisión directa.
|
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
|
void
Este método establece la cantidad máxima de reintentos de fotogramas durante la transmisión indirecta.
|
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
|
Establece el ID de PAN de IEEE 802.15.4.
|
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
|
void
Esta función registra una devolución de llamada para proporcionar los marcos IEEE 802.15.4 sin procesar recibidos.
|
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
|
Configurar/borrar el período de sondeo de datos externo/especificado por el usuario para el dispositivo final soñoliento
|
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
|
Esta función habilita o inhabilita el modo promiscuo en la capa del vínculo.
|
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
|
void
Esta función habilita o inhabilita el modo de filtro de radio IEEE 802.15.4.
|
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
|
Establece la máscara de canal compatible de la capa MAC.
|
Structs |
|
---|---|
otActiveScanResult; |
Esta estructura representa una baliza con IEEE 802.15.4 recibida. |
Resultado de otEnergyScan |
Esta estructura representa un resultado de análisis de energía. |
otMacCounters |
Esta estructura representa los contadores de capa MAC. |
otMacFilterEntry |
Esta estructura representa una entrada de filtro de Mac. |
otThreadLinkInfo. |
Esta estructura representa información específica del vínculo para los mensajes recibidos de la radio Thread. |
Enumeraciones
Modo de filtro de direcciones Mac
otMacFilterAddressMode
Define el modo de dirección del filtro de Mac.
Propiedades | |
---|---|
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST
|
Se habilitó el modo de filtro de direcciones en la lista de entidades permitidas. |
OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
|
El modo de filtro de direcciones de la lista de bloqueo está habilitado. |
OT_MAC_FILTER_ADDRESS_MODE_DISABLED
|
El filtro de dirección está inhabilitado. |
Typedefs
otActiveScanResult
struct otActiveScanResult otActiveScanResult
Esta estructura representa una baliza con IEEE 802.15.4 recibida.
otEnergyScanResult
struct otEnergyScanResult otEnergyScanResult
Esta estructura representa un resultado de análisis de energía.
otHandleActiveScanResult
void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
Se llama a este puntero de función durante un escaneo activo de IEEE 802.15.4 cuando se recibe una baliza IEEE 802.15.4 o se completa el análisis.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otHandleEnergyScanResult
void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
Se llama a este puntero de función durante un escaneo de energía IEEE 802.15.4 cuando el resultado para un canal está listo o el análisis se completa.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
Devolución de llamada de otLinkPcap
void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
Se llama a este puntero de función cuando se recibe un marco IEEE 802.15.4.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
Contadores otMac
struct otMacCounters otMacCounters
Esta estructura representa los contadores de capa MAC.
Modo de filtro de direcciones Mac
enum otMacFilterAddressMode otMacFilterAddressMode
Define el modo de dirección del filtro de Mac.
Entrada de filtro Mac
struct otMacFilterEntry otMacFilterEntry
Esta estructura representa una entrada de filtro de Mac.
otFilterFilterIterator
uint8_t otMacFilterIterator
Se usa para iterar a través de entradas de filtros de Mac.
Información de vínculo de otThread
struct otThreadLinkInfo otThreadLinkInfo
Esta estructura representa información específica del vínculo para los mensajes recibidos de la radio Thread.
Funciones
otLinkActiveScan
otError otLinkActiveScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext )
Esta función inicia un análisis activo IEEE 802.15.4.
Detalles | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||
Valores de retorno |
|
oLinkLinkConvertLinkQualityToRss
int8_t otLinkConvertLinkQualityToRss( otInstance *aInstance, uint8_t aLinkQuality )
Este método convierte la calidad del vínculo en la intensidad típica de la señal recibida.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
La plataforma típica recibió la asignación de intensidad de la señal a
aLinkQuality . |
otLinkConvertRssToLinkQuality
uint8_t otLinkConvertRssToLinkQuality( otInstance *aInstance, int8_t aRss )
Este método convierte la intensidad de la señal recibida en calidad de vínculo.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
Vincula la asignación del valor de calidad a
aRss . |
otLinkCslGetChannel
uint8_t otLinkCslGetChannel( otInstance *aInstance )
Esta función obtiene el canal CSL.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El canal de la CSL.
|
oLinkLinkCslGetPeriod
uint16_t otLinkCslGetPeriod( otInstance *aInstance )
Esta función obtiene el período CSL.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El punto del CSL en unidades de 10 símbolos.
|
otLinkCslGetTimeout
uint32_t otLinkCslGetTimeout( otInstance *aInstance )
Esta función obtiene el tiempo de espera de CSL.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Tiempo de espera de CSL en segundos.
|
otLinkCslSetChannel
otError otLinkCslSetChannel( otInstance *aInstance, uint8_t aChannel )
Establece el canal de CSL.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
otLinkCslSetPeriod
otError otLinkCslSetPeriod( otInstance *aInstance, uint16_t aPeriod )
Establece el período de CSL en unidades de 10 símbolos.
Para inhabilitar la CSL, establece este parámetro en 0
.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
otLinkCslSetTimeout
otError otLinkCslSetTimeout( otInstance *aInstance, uint32_t aTimeout )
Establece el tiempo de espera del CSL en segundos.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
otLinkEnergyScan
otError otLinkEnergyScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext )
Esta función inicia un escaneo de energía IEEE 802.15.4.
Detalles | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||
Valores de retorno |
|
otLinkFilterAddAddress
otError otLinkFilterAddAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Este método agrega una dirección extendida al filtro de MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
otLinkFilterAddRssIn
otError otLinkFilterAddRssIn( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss )
Este método agrega una entrada de intensidad de la señal recibida (en dBm) fija para los mensajes desde una dirección extendida determinada en el filtro de MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkFilterClearAddresses
void otLinkFilterClearAddresses( otInstance *aInstance )
Este método borra todas las direcciones extendidas del filtro de MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||
---|---|---|---|
Parámetros |
|
otLinkFilterClearAllRssIn
void otLinkFilterClearAllRssIn( otInstance *aInstance )
Este método borra todas las entradas de intensidad de señal recibidas (incluida la entrada RSS predeterminada) en el filtro MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||
---|---|---|---|
Parámetros |
|
otLinkFilterClearDefaultRssIn
void otLinkFilterClearDefaultRssIn( otInstance *aInstance )
Este método borra la intensidad de la señal recibida (en dBm) predeterminada que se configuró anteriormente en el filtro MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||
---|---|---|---|
Parámetros |
|
otLinkFilterGetAddressMode
otMacFilterAddressMode otLinkFilterGetAddressMode( otInstance *aInstance )
Esta función obtiene el modo de dirección del filtro MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
en el modo de dirección.
|
otLinkFilterGetNextAddress
otError otLinkFilterGetNextAddress( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
Este método obtiene una entrada de filtro de direcciones en uso.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkFilterGetNextRssIn
otError otLinkFilterGetNextRssIn( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
Este método obtiene una entrada de filtro RssIn en uso.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkFilterRemoveAddress
void otLinkFilterRemoveAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Este método quita una dirección extendida del filtro de MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
No se llevará a cabo ninguna acción si no hay una entrada existente en Filtro que coincida con la dirección extendida dada.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
oLinkLinkRemoveRssIn
void otLinkFilterRemoveRssIn( otInstance *aInstance, const otExtAddress *aExtAddress )
Este método quita una entrada de filtro MAC para la configuración de intensidad de la señal recibida fija para una dirección extendida determinada.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
No se llevará a cabo ninguna acción si no hay una entrada existente en Filtro que coincida con la dirección extendida dada.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkFilterSetAddressMode
void otLinkFilterSetAddressMode( otInstance *aInstance, otMacFilterAddressMode aMode )
Esta función establece el modo de dirección del filtro MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkFilterSetDefaultRssIn
void otLinkFilterSetDefaultRssIn( otInstance *aInstance, int8_t aRss )
Este método establece la intensidad de la señal recibida (dBm) predeterminada en el filtro de MAC.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
El valor RSS predeterminado se usa para todos los marcos recibidos de direcciones para las que no hay una entrada RSS-IN explícita en la lista de filtros (se agrega mediante otLinkFilterAddRssIn()
).
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkGetCcaFailureRate
uint16_t otLinkGetCcaFailureRate( otInstance *aInstance )
Esta función muestra la tasa de fallas actual de CCA (Clear Channel Assessment).
La velocidad se mantiene durante un período (aproximadamente) de las últimas OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW
transmisiones de fotogramas.
Detalles | |
---|---|
Qué muestra |
La tasa de fallas de CCA con el valor máximo
0xffff corresponde a la tasa de falla del 100%. |
Canal de destino de otLink
uint8_t otLinkGetChannel( otInstance *aInstance )
Obtén el canal IEEE 802.15.4.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El canal IEEE 802.15.4.
|
otLinkSetChannel
oLinkLinkCounters
const otMacCounters * otLinkGetCounters( otInstance *aInstance )
Obtén los contadores de capa de MAC.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Un puntero para los contadores de capas de MAC.
|
oLinkLinkExtendedExtensión
const otExtAddress * otLinkGetExtendedAddress( otInstance *aInstance )
Obtiene la dirección extendida IEEE 802.15.4.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Un puntero a la dirección extendida IEEE 802.15.4.
|
oLinkLinkFactoryFactoryededIeeeEui64
void otLinkGetFactoryAssignedIeeeEui64( otInstance *aInstance, otExtAddress *aEui64 )
Obtén la IEEE EUI-64 asignada a la fábrica.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkGetMaxFrameRetriesDirect
uint8_t otLinkGetMaxFrameRetriesDirect( otInstance *aInstance )
Este método muestra la cantidad máxima de reintentos de fotogramas durante la transmisión directa.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
La cantidad máxima de reintentos durante la transmisión directa.
|
otLinkGetMaxFrameRetriesIndirect
uint8_t otLinkGetMaxFrameRetriesIndirect( otInstance *aInstance )
Este método muestra la cantidad máxima de reintentos de fotogramas durante la transmisión indirecta.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
La cantidad máxima de reintentos durante la transmisión indirecta.
|
otLinkGetPanId
otPanId otLinkGetPanId( otInstance *aInstance )
Obtén el ID de PAN de IEEE 802.15.4.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El ID de número PAN para IEEE 802.15.4.
|
otLinkSetPanId
otLinkGetPollPeriod
uint32_t otLinkGetPollPeriod( otInstance *aInstance )
Obtiene el período de sondeo de datos del dispositivo final soñoliento.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
El período de sondeo de datos del dispositivo final soñoliento en milisegundos.
|
otLinkSetPollPeriod
oLinkLinkGetShortAddress
otShortAddress otLinkGetShortAddress( otInstance *aInstance )
Obtén la dirección corta IEEE 802.15.4.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Un puntero a la dirección corta IEEE 802.15.4.
|
otLinkGetSupportedChannelMask
uint32_t otLinkGetSupportedChannelMask( otInstance *aInstance )
Obtén la máscara de canal compatible de la capa MAC.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
Es la máscara de canal admitida como
uint32_t con el bit 0 (lsb) asignado al canal 0, el bit 1 al canal 1, etcétera. |
otLinkGetTxDirectRetrySuccessHistogram
const uint32_t * otLinkGetTxDirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
Este método obtiene el histograma de reintentos para un solo paquete directo hasta que se completa correctamente.
Esta función es válida cuando la configuración OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
Un puntero al histograma de reintentos (en forma de un arreglo). El elemento n-th indica que el paquete se envió con n-th reintento.
|
otLinkGetTxIndirectRetrySuccessHistogram
const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
Este método obtiene el histograma de reintentos para un solo paquete indirecto hasta que se ejecuta de forma correcta.
Esta función es válida cuando la configuración OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Qué muestra |
Un puntero al histograma de reintentos (en forma de un arreglo). El elemento n-th indica que el paquete se envió con n-th reintento.
|
oLinkLinkActiveActiveInProgress
bool otLinkIsActiveScanInProgress( otInstance *aInstance )
Esta función indica si hay un escaneo activo de IEEE 802.15.4 en curso.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
true, si un análisis activo de IEEE 802.15.4 está en curso; de lo contrario, es false.
|
otLinkIsEnabled
bool otLinkIsEnabled( otInstance *aInstance )
Esta función indica si la capa del vínculo está habilitada o no.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
oLinkLinkEnEnergyScanInProgress
bool otLinkIsEnergyScanInProgress( otInstance *aInstance )
Esta función indica si un análisis de energía IEEE 802.15.4 está en curso.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
true si un análisis de energía IEEE 802.15.4 está en curso; de lo contrario, es false.
|
otLinkIsInTransmitState
bool otLinkIsInTransmitState( otInstance *aInstance )
Esta función indica si una MAC IEEE 802.15.4 está en el estado de transmisión.
El módulo MAC se encuentra en el estado de transmisión durante el procedimiento de CSMA/CA, CCA, datos, transmisión de marcos de solicitud de datos o balizas y recibe una confirmación de un marco transmitido. El módulo MAC no se encuentra en el estado de transmisión durante la transmisión de un marco ACK o de una solicitud de pixel contador.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Qué muestra |
true si una MAC de IEEE 802.15.4 está en estado de transmisión; de lo contrario, es false.
|
oLinkLinkPromiscuous
bool otLinkIsPromiscuous( otInstance *aInstance )
Esta función indica si el modo promiscuo está habilitado en la capa del vínculo.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
oLinkLinkRadioRadioEnabled
bool otLinkIsRadioFilterEnabled( otInstance *aInstance )
Esta función indica si el filtro de radio IEEE 802.15.4 está habilitado o no.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
Detalles | |||||
---|---|---|---|---|---|
Valores de retorno |
|
otLinkResetCounters
void otLinkResetCounters( otInstance *aInstance )
Restablece los contadores de capa MAC.
Detalles | |||
---|---|---|---|
Parámetros |
|
otLinkResetTxRetrySuccessHistogram
void otLinkResetTxRetrySuccessHistogram( otInstance *aInstance )
Este método borra las estadísticas del histograma para las transmisiones indirectas y directas.
Esta función es válida cuando la configuración OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE está habilitada.
Detalles | |||
---|---|---|---|
Parámetros |
|
otLinkSendDataRequest
otError otLinkSendDataRequest( otInstance *aInstance )
Esta función pone en cola un mensaje de solicitud de datos IEEE 802.15.4 para su transmisión.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
oLinkLinkEmptyEmptyData
otError otLinkSendEmptyData( otInstance *aInstance )
Esta función indica al dispositivo que envíe un marco de datos vacío IEEE 802.15.4.
Esta función solo se admite en un dispositivo Rx-Off-When-Idle para enviar un marco de datos vacío a su elemento superior. Nota: Solo está disponible cuando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
está habilitado.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkSetChannel
otError otLinkSetChannel( otInstance *aInstance, uint8_t aChannel )
Configura el canal IEEE 802.15.4.
Esta función solo tiene éxito cuando los protocolos de Thread están inhabilitados. Una llamada exitosa a esta función invalida los conjuntos de datos operativos activos y pendientes en la memoria no volátil.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkGetChannel
otLinkSetEnabled
otError otLinkSetEnabled( otInstance *aInstance, bool aEnable )
Esta función habilita o inhabilita la capa de vínculo.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
oLinkLinkExtendedExtended
otError otLinkSetExtendedAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Configura la dirección extendida IEEE 802.15.4.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkSetMaxFrameRetriesDirect
void otLinkSetMaxFrameRetriesDirect( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect )
Este método establece la cantidad máxima de reintentos de trama durante la transmisión directa.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkSetMaxFrameRetriesIndirect
void otLinkSetMaxFrameRetriesIndirect( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect )
Este método establece la cantidad máxima de reintentos de fotogramas durante la transmisión indirecta.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkSetPanId
otError otLinkSetPanId( otInstance *aInstance, otPanId aPanId )
Establece el ID de PAN de IEEE 802.15.4.
Esta función solo tiene éxito cuando los protocolos de Thread están inhabilitados. Una llamada exitosa a esta función también invalida los conjuntos de datos operativos activos y pendientes en la memoria no volátil.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
||||||
Valores de retorno |
|
otLinkGetPanId
otLinkSetPcapCallback
void otLinkSetPcapCallback( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext )
Esta función registra una devolución de llamada para proporcionar los marcos IEEE 802.15.4 sin procesar recibidos.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
otLinkSetPollPeriod
otError otLinkSetPollPeriod( otInstance *aInstance, uint32_t aPollPeriod )
Configurar/borrar el período de sondeo de datos externo/especificado por el usuario para el dispositivo final soñoliento
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
otLinkGetPollPeriod
otLinkSetPromiscuous
otError otLinkSetPromiscuous( otInstance *aInstance, bool aPromiscuous )
Esta función habilita o inhabilita el modo promiscuo en la capa del vínculo.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
oLinkLinkRadioRadioEnabled
void otLinkSetRadioFilterEnabled( otInstance *aInstance, bool aFilterEnabled )
Esta función habilita o inhabilita el modo de filtro de radio IEEE 802.15.4.
Esta función está disponible cuando se habilita la configuración de OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.
El filtro de radio está diseñado principalmente para realizar pruebas. Se puede usar para bloquear temporalmente todos los archivos tx/rx en la radio 802.15.4. Cuando el filtro de radio está habilitado, la radio se pone en modo de suspensión en lugar de recibir (para garantizar que el dispositivo no reciba ningún fotograma ni envíe posibles confirmaciones). Además, las solicitudes de transmisión de fotogramas se muestran inmediatamente sin enviar el marco de manera inalámbrica (muestra el error "no ack" si se solicita ack; de lo contrario, muestra un resultado correcto).
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
otLinkSetSupportedChannelMask
otError otLinkSetSupportedChannelMask( otInstance *aInstance, uint32_t aChannelMask )
Establece la máscara de canal compatible de la capa MAC.
Esta función solo tiene éxito cuando los protocolos de Thread están inhabilitados.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Valores de retorno |
|
Macros
TS_MAC_FILTER_FIXED_RSS_DISABLED
OT_MAC_FILTER_FIXED_RSS_DISABLED 127
Se usa para indicar que no se estableció ninguna intensidad fija de la señal recibida.
TS_MAC_FILTER_ITERATOR_INIT
OT_MAC_FILTER_ITERATOR_INIT 0
Inicializador de otMacFilterIterator.
TS_US_PER_TEN_SYMBOLS
OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME
Tiempo para 10 símbolos en unidades de microsegundos.
Recursos
Los temas de referencia de la API de OpenThread se originan en el código fuente, disponible en GitHub. Para obtener más información o colaborar con nuestra documentación, consulta Recursos.