Vínculo sin procesar

Este módulo incluye funciones que controlan la configuración sin procesar de la capa de vínculo.

Resumen

Typedefs
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Puntero al recibir una trama IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Puntero al recibir una trama IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Puntero al recibir una trama IEEE 802.15.4.

remotas
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Inicia la secuencia de búsqueda de energía en la radio.
otLinkRawGetCaps(otInstance *aInstance)
Obtén las funciones de radio.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Obtiene el estado del modo promiscuo.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Obtén la hora actual de la plataforma (ancho de 64 bits) del chip de radio.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Obtén la medición de RSSI más reciente.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
La radio pasa de transmitir a recibir.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Indica si la capa de vínculo sin procesar está habilitada o no.
otLinkRawReceive(otInstance *aInstance)
Transición de la radio de Suspender a Recibir.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Establece el valor actual del contador de tramas de MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Establece el valor del contador de tramas de MAC actual solo si el valor nuevo es mayor que el actual.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
Actualiza las claves de MAC y el índice de claves.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Habilita o inhabilita el modo promiscuo.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Habilita o inhabilita la capa de vínculos sin procesar.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Establece la dirección corta para filtrar las direcciones.
otLinkRawSleep(otInstance *aInstance)
Haz la transición de la radio de Recibir a Suspender.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Agrega la dirección extendida a la tabla de coincidencias de origen.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Agrega una dirección corta a la tabla de coincidencias de origen.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Quitar todas las direcciones extendidas de la tabla de coincidencias de origen.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Quitar la dirección extendida de la tabla de coincidencias de origen de la radio.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Quitar todas las direcciones cortas de la tabla de coincidencias de origen.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Quita la dirección corta de la tabla de coincidencias de origen.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Habilita o inhabilita la coincidencia de fuente para el marco pendiente.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Inicia la secuencia de transmisión en la radio.

Typedefs

otLinkRawEnergyScanDone

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

Puntero al recibir una trama IEEE 802.15.4.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnergyScanMaxRssi
Es el RSSI máximo que se encontró en el canal analizado.

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Puntero al recibir una trama IEEE 802.15.4.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aFrame
Un puntero para el marco recibido o NULL si se anuló la operación de recepción.
[in] aError
OT_ERROR_NONE cuando se recibe un fotograma correctamente. OT_ERROR_ABORT cuando se anuló la recepción y no se recibió un fotograma

otLinkRawTransmitDone

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

Puntero al recibir una trama IEEE 802.15.4.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aFrame
Un puntero al fotograma que se transmitió.
[in] aAckFrame
Un puntero para el marco ACK.
[in] aError
OT_ERROR_NONE cuando se transmitió el fotograma. OT_ERROR_NO_ACK cuando se transmitió la trama, pero no se recibió ninguna ACK, OT_ERROR_CHANNEL_ACCESS_ asistencia cuando no se pudo realizar la transmisión debido a la actividad en el canal OT_ERROR_ABORT cuando se anuló la transmisión por otros motivos

remotas

otLinkRawEnergyScan

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

Inicia la secuencia de búsqueda de energía en la radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aScanChannel
El canal en el que se realizará la búsqueda de energía.
[in] aScanDuration
Es la duración, en milisegundos, del canal que se analizará.
[in] aCallback
Un puntero a una función que se llama cuando se completa un canal analizado.
Valores que se muestran
OT_ERROR_NONE
Se inició correctamente la búsqueda del canal.
OT_ERROR_BUSY
La radio está realizando un escaneo de energía.
OT_ERROR_NOT_IMPLEMENTED
La radio no admite el análisis de energía.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtén las funciones de radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El vector de bits de capacidad de radio. La pila habilita o inhabilita algunas funciones según este valor.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Obtiene el estado del modo promiscuo.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
true
El modo promiscuo está habilitado.
false
El modo promiscuo está inhabilitado.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Obtén la hora actual de la plataforma (ancho de 64 bits) del chip de radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El tiempo de radio actual en microsegundos.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Obtén la medición de RSSI más reciente.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
El RSSI en dBm cuando es válido. 127 cuando RSSI no es válido.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio pasa de transmitir a recibir.

Muestra un puntero al búfer de transmisión.

El emisor forma la trama IEEE 802.15.4 en este búfer y, luego, llama a otLinkRawTransmit() para solicitar la transmisión.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Qué muestra
Un puntero al búfer de transmisión o NULL si la capa de vínculo sin procesar no está habilitada.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Indica si la capa de vínculo sin procesar está habilitada o no.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
true
La capa de vínculo sin procesar está habilitada.
false
La capa de vínculos sin procesar está inhabilitada.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Transición de la radio de Suspender a Recibir.

Enciende la radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
OT_ERROR_NONE
Se realizó correctamente la transición a Recibir.
OT_ERROR_INVALID_STATE
La radio estaba desactivada o transmitiendo.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Establece el valor actual del contador de tramas de MAC.

Siempre establece el contador de MAC en el nuevo valor determinado aMacFrameCounter, independientemente del valor actual.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aMacFrameCounter
El valor del contador de tramas de MAC.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Establece el valor del contador de tramas de MAC actual solo si el valor nuevo es mayor que el actual.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aMacFrameCounter
El valor del contador de tramas de MAC.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

Actualiza las claves de MAC y el índice de claves.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aKeyIdMode
El modo de ID de la clave.
[in] aKeyId
El índice de la clave.
[in] aPrevKey
La clave MAC anterior.
[in] aCurrKey
La clave MAC actual.
[in] aNextKey
La siguiente clave MAC.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Habilita o inhabilita el modo promiscuo.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnable
Es un valor para habilitar o inhabilitar el modo promiscuo.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Habilita o inhabilita la capa de vínculos sin procesar.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aCallback
Un puntero a una función a la que se llama cuando se recibe una trama IEEE 802.15.4. NULL para inhabilitar la capa de vínculo sin procesar.
Valores que se muestran
OT_ERROR_FAILED
No se pudo habilitar o inhabilitar la radio.
OT_ERROR_INVALID_STATE
Si la interfaz IPv6 de OpenThread ya está habilitada.
OT_ERROR_NONE
Si el estado de habilitación se configuró correctamente

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Establece la dirección corta para filtrar las direcciones.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aShortAddress
Es la dirección corta de IEEE 802.15.4.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Haz la transición de la radio de Recibir a Suspender.

Apaga la radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
OT_ERROR_NONE
Se realizó correctamente la transición al modo de suspensión.
OT_ERROR_BUSY
La radio estaba transmitiendo
OT_ERROR_INVALID_STATE
Se inhabilitó la radio

otLinkRawSrcMatchAddExtEntry

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

Agrega la dirección extendida a la tabla de coincidencias de origen.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aExtAddress
La dirección extendida que se agregará.
Valores que se muestran
OT_ERROR_NONE
Se agregó correctamente la dirección extendida a la tabla de coincidencias de origen.
OT_ERROR_NO_BUFS
No hay ninguna entrada disponible en la tabla de coincidencias de origen.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Agrega una dirección corta a la tabla de coincidencias de origen.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aShortAddress
La dirección corta que se agregará.
Valores que se muestran
OT_ERROR_NONE
Se agregó correctamente la dirección corta a la tabla de coincidencias de origen.
OT_ERROR_NO_BUFS
No hay ninguna entrada disponible en la tabla de coincidencias de origen.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Quitar todas las direcciones extendidas de la tabla de coincidencias de origen.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchClearExtEntry

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

Quitar la dirección extendida de la tabla de coincidencias de origen de la radio.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aExtAddress
La dirección extendida que se quitará.
Valores que se muestran
OT_ERROR_NONE
La dirección extendida se quitó correctamente de la tabla de coincidencias de origen.
OT_ERROR_NO_ADDRESS
La dirección extendida no se encuentra en la tabla de coincidencias de origen.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Quitar todas las direcciones cortas de la tabla de coincidencias de origen.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Quita la dirección corta de la tabla de coincidencias de origen.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aShortAddress
La dirección corta que se quitará.
Valores que se muestran
OT_ERROR_NONE
La dirección corta se quitó correctamente de la tabla de coincidencias de origen.
OT_ERROR_NO_ADDRESS
La dirección corta no está en la tabla de coincidencias de origen.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Habilita o inhabilita la coincidencia de fuente para el marco pendiente.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnable
Habilita o inhabilita la coincidencia de fuente para el fotograma pendiente.
Valores que se muestran
OT_ERROR_NONE
Si se ejecuta correctamente.
OT_ERROR_INVALID_STATE
Si la capa de vínculos sin procesar no está habilitada.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Inicia la secuencia de transmisión en la radio.

El emisor debe formar la trama IEEE 802.15.4 en el búfer proporcionado por otLinkRawGetTransmitBuffer() antes de solicitar la transmisión. La potencia de transmisión y el canal también se incluyen en la estructura otRadioFrame.

La secuencia de transmisión consta de lo siguiente:

  1. Transición de la radio a transmitir desde el receptor
  2. Transmite la PSDU en un canal determinado y a la potencia de transmisión determinada.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aCallback
Un puntero para una función a la que se llama cuando se completa la transmisión.
Valores que se muestran
OT_ERROR_NONE
Se realizó correctamente la transición a la transmisión.
OT_ERROR_INVALID_STATE
La radio no estaba en estado de recepción.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.