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)	otError Inicia la secuencia de búsqueda de energía en la radio.
otLinkRawGetCaps(otInstance *aInstance)	otRadioCaps 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)	otRadioFrame * 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)	otError Transición de la radio de Suspender a Recibir.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)	otError Establece el valor actual del contador de tramas de MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)	otError 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)	otError Actualiza las claves de MAC y el índice de claves.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)	otError Habilita o inhabilita el modo promiscuo.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)	otError Habilita o inhabilita la capa de vínculos sin procesar.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)	otError Establece la dirección corta para filtrar las direcciones.
otLinkRawSleep(otInstance *aInstance)	otError Haz la transición de la radio de Recibir a Suspender.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Agrega la dirección extendida a la tabla de coincidencias de origen.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)	otError Agrega una dirección corta a la tabla de coincidencias de origen.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)	otError Quitar todas las direcciones extendidas de la tabla de coincidencias de origen.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Quitar la dirección extendida de la tabla de coincidencias de origen de la radio.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)	otError Quitar todas las direcciones cortas de la tabla de coincidencias de origen.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)	otError Quita la dirección corta de la tabla de coincidencias de origen.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)	otError Habilita o inhabilita la coincidencia de fuente para el marco pendiente.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)	otError 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.