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ínculos sin procesar.

Resumen

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 comienza la secuencia de análisis de energía en la radio.
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` Obtén las capacidades de 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` Obtén la medición de RSSI más reciente.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` La radio cambia de Transmitir a Recibir.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Esta función indica si la capa de vínculos sin procesar está habilitada.
`otLinkRawReceive(otInstance *aInstance)`	`otError` Transición de la radio del sueño al de recepción.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Establece el valor del contador de fotogramas MAC actual.
`otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Establece el valor del contador de marcos MAC actual solo si el 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` 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ínculos sin procesar.
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Establece la dirección corta para filtrar las direcciones.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Cambia 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` Se está quitando 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` Quitar 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 fotograma 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 escaneado.

otLinkRawReceiveListo

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 para el fotograma recibido o NULO si se anuló la operación de recepción.
`[in] aError`	OT_ERROR_NONE cuando se recibió un marco con éxito. OT_ERROR_ABORT cuando se anuló la recepción y no se recibió un fotograma.

oLinkLinkRawDone

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 para el marco ACK.
`[in] aError`	OT_ERROR_NONE cuando se transmitió el fotograma OT_ERROR_NO_ACK cuando se transfirió el fotograma, pero no se recibió ACK OT_ERROR_CHANNEL_ACCESS_FAILURE 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.

Funciones

otLinkRawEnergyScan

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

Este método comienza la secuencia de análisis de energía en la radio.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aScanChannel`	El canal para realizar el análisis 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 escaneado.

Valores que se muestran

`OT_ERROR_NONE`	Se comenzó a buscar correctamente el canal.
`OT_ERROR_BUSY`	La radio está realizando un análisis de energía.
`OT_ERROR_NOT_IMPLEMENTED`	La radio no admite el escaneo 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 capacidades de 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 según 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 promis 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

La hora 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 el RSSI no es válido

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio cambia 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 del 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.

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 del sueño al de recepción.

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`	La radio se inhabilitó o transmitió.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Establece el valor del contador de fotogramas MAC actual.

Esta función siempre establece el contador MAC en el valor aMacFrameCounter nuevo, independientemente del valor actual.

Detalles

Parámetros

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

Valores que se muestran

`OT_ERROR_NONE`	Si se realiza de forma correcta
`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 marcos MAC actual solo si el 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 fotogramas de MAC.

Valores que se muestran

`OT_ERROR_NONE`	Si se realiza de forma correcta
`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 clave.
`[in] aKeyId`	El índice de 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 realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos 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 se realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos sin procesar no está habilitada

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Esta función 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 un marco con el estándar 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 ni 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 estableció 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`	La dirección corta IEEE 802.15.4

Valores que se muestran

`OT_ERROR_NONE`	Si se realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos sin procesar no está habilitada

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Cambia 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ó 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 entradas disponibles 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 entradas disponibles 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 realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos 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 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`	Se quitó correctamente la dirección extendida de la tabla de coincidencias de origen.
`OT_ERROR_NO_ADDRESS`	La dirección extendida no está 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 realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos sin procesar no está habilitada

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Quitar 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`	Se quitó correctamente la dirección corta de la tabla de coincidencias de origen.
`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ínculos sin procesar no está habilitada

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Habilita o inhabilita la coincidencia de fuente para el fotograma 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 realiza de forma correcta
`OT_ERROR_INVALID_STATE`	Si la capa de vínculos 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 otLinkRawGetStreamBuffer() 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 recepción
Transmite la PSDU en el canal y la potencia de transmisión determinados.

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 completa la transmisión.

Valores que se muestran

`OT_ERROR_NONE`	Se realizó correctamente la transición a Transmitir.
`OT_ERROR_INVALID_STATE`	La radio no estaba en el 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 colaborar con nuestra documentación, consulta la sección Recursos.