Se usó la API de Cloud Translation para traducir esta página.

Vínculo sin procesar

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

Summary

Typedefs
`otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Este puntero de función al recibir un marco IEEE 802.15.4
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Este puntero de función al recibir un marco IEEE 802.15.4
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Este puntero de función al recibir un marco IEEE 802.15.4

Funciones
`otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Este método inicia la secuencia de escaneo de energía en la radio.
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` Obtén las capacidades de la radio.
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` Esta función obtiene el estado del modo promiscuo.
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` Obtener el tiempo de plataforma actual (ancho de 64 bits) del chip de radio
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Obtenga la medición RSSI más reciente.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` La radio pasa de Transmitir a Recibir.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Esta función indica si la capa de vínculos 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 marcos MAC.
`otLinkRawSetMacKey(otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Actualiza el índice de claves y las claves MAC.
`otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)`	`otError` Esta función habilita o inhabilita el modo promiscuo.
`otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Esta función habilita o inhabilita la capa de vínculo sin procesar.
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Establece la dirección corta para filtrar direcciones.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Pasa la radio de Recibir a Suspender.
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Agregando dirección extendida a la tabla de coincidencias de fuentes.
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Agregando la dirección corta a la tabla de coincidencias de fuentes.
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` Se quitarán todas las direcciones extendidas de la tabla de coincidencia de fuentes.
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Se está quitando la dirección extendida de la tabla de coincidencias de fuentes de la radio.
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` Se quitarán todas las direcciones cortas de la tabla de coincidencias de fuentes.
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Se está quitando la dirección corta de la tabla de coincidencias de fuentes.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Habilita o inhabilita la coincidencia de fuentes para el marco pendiente.
`otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Este método inicia la secuencia de transmisión en la radio.

Typedefs

otLinkRawEnergyScanDone

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

Este puntero de función al recibir un marco IEEE 802.15.4

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnergyScanMaxRssi`	La cantidad máxima de RSSI que se encontró en el canal analizado.

otLinkRawReceiveDone

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

Este puntero de función al recibir un marco IEEE 802.15.4

Detalles

Parámetros

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

otLinkRawTransDone

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

Este puntero de función al recibir un marco IEEE 802.15.4

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aFrame`	Un puntero al marco que se transmitió.
`[in] aAckFrame`	Un puntero al marco ACK.
`[in] aError`	OT_ERROR_NONE cuando se transmitió el marco. OT_ERROR_NO_ACK cuando se transmitió el marco, pero no se recibió ACK ERROR_CHANNEL_ACCESS_FAILURE cuando no se pudo realizar la transmisión debido a la actividad del canal. OT_ERROR_ABORT cuando se anuló la transmisión por otros motivos.

Funciones

otLinkRawEnergyScan

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

Este método inicia la secuencia de escaneo de energía en la radio.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aScanChannel`	Indica el canal en el que se realizará el escaneo de energía.
`[in] aScanDuration`	Es la duración, en milisegundos, del canal que se analizará.
`[in] aCallback`	Un puntero para una función que se llama cuando se completa un canal analizado.

Valores que se muestran

`OT_ERROR_NONE`	Se comenzó a explorar correctamente el canal.
`OT_ERROR_BUSY`	La radio está realizando un escaneo eléctrico.
`OT_ERROR_NOT_IMPLEMENTED`	La radio no admite el escaneo de energía.
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtén las capacidades de la radio.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Qué muestra

Vector de bits de capacidad de radio La pila habilita o inhabilita algunas funciones en función de este valor.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Esta función obtiene el estado del modo promiscuo.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores que se muestran

`true`	Se habilitó el modo promiscuo.
`false`	El modo promiscuo está inhabilitado.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Obtener el tiempo de plataforma actual (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
)

Obtenga la medición 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 el RSSI no es válido.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio pasa de Transmitir a Recibir.

Este método muestra un puntero al búfer de transmisión.

El llamador forma el marco 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
)

Esta función indica si la capa de vínculos 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`	La transición se recibió correctamente.
`OT_ERROR_INVALID_STATE`	Se inhabilitó la transmisión o la transmisión.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Establece el valor actual del contador de marcos MAC.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aMacFrameCounter`	Es el valor del contador de fotogramas MAC.

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo 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 el índice de claves y las claves MAC.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aKeyIdMode`	El modo de ID de clave.
`[in] aKeyId`	El índice de claves
`[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 el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Esta función habilita o inhabilita el modo promiscuo.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnable`	Un valor para habilitar o inhabilitar el modo promiscuo.

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Esta función habilita o inhabilita la capa de vínculo sin procesar.

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 recibe un marco IEEE 802.15.4. NULL para inhabilitar la capa del 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 direcciones.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aShortAddress`	Dirección corta IEEE 802.15.4

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Pasa 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`	La transición se realizó correctamente.
`OT_ERROR_BUSY`	La radio estaba transmitiendo
`OT_ERROR_INVALID_STATE`	Se inhabilitó la radio

otLinkRawSrcMatchAddExtEntry

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

Agregando dirección extendida a la tabla de coincidencias de fuentes.

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 fuentes.
`OT_ERROR_NO_BUFS`	No hay entradas disponibles en la tabla de coincidencias de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Agregando la dirección corta a la tabla de coincidencias de fuentes.

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 fuentes.
`OT_ERROR_NO_BUFS`	No hay entradas disponibles en la tabla de coincidencias de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Se quitarán todas las direcciones extendidas de la tabla de coincidencia de fuentes.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearExtEntry

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

Se está quitando la dirección extendida de la tabla de coincidencias de fuentes 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`	Se quitó correctamente la dirección extendida de la tabla de coincidencia de fuentes.
`OT_ERROR_NO_ADDRESS`	La dirección extendida no se encuentra en una tabla de coincidencias de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Se quitarán todas las direcciones cortas de la tabla de coincidencias de fuentes.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Se está quitando la dirección corta de la tabla de coincidencias de fuentes.

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`	Se quitó correctamente la dirección corta de la tabla de coincidencias de fuentes.
`OT_ERROR_NO_ADDRESS`	La dirección corta no se encuentra en la tabla de coincidencias de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

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

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnable`	Habilita o inhabilita la coincidencia de fuentes para el marco pendiente.

Valores que se muestran

`OT_ERROR_NONE`	Si el proceso se realiza correctamente
`OT_ERROR_INVALID_STATE`	Si la capa de vínculo sin procesar no está habilitada

otLinkRawTrans

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Este método inicia la secuencia de transmisión en la radio.

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

La secuencia de transmisión consta de los siguientes elementos:

Transición de la radio a Transmitir desde Recibir
Transmite la PSDU por el canal especificado y 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 que se llama cuando se completa la transmisión.

Valores que se muestran

`OT_ERROR_NONE`	Se realizó correctamente la transición a Transmit.
`OT_ERROR_INVALID_STATE`	La radio no estaba en el estado "Recibir".

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.