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 del vínculo 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 inicia la secuencia de escaneo 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` Obtén el tiempo de la plataforma actual (64 bits de ancho) del chip de radio.
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Obtén la medición RSSI más reciente.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` Transiciones de radio de transmisión a recepción
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Esta función indica si se habilitó o no la capa de vínculo sin procesar.
`otLinkRawReceive(otInstance *aInstance)`	`otError` Transición de la radio de suspensión a recepción.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Establece el valor actual del contador de marcos MAC.
`otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Establece el valor actual del contador de marcos MAC solo si el nuevo valor 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 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 las direcciones.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Haz la transición de la recepción de sueño a la de suspensión.
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Agregando la dirección extendida a la tabla de coincidencia de origen.
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Agregando una dirección corta a la tabla de coincidencia de fuentes.
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` Quitar todas las direcciones extendidas de la tabla de coincidencia de fuentes.
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Se quitará la dirección extendida de la tabla de coincidencia de fuentes de la radio.
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` Quita todas las direcciones cortas de la tabla de coincidencias de origen.
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Se está quitando la dirección corta de la tabla de coincidencia de fuentes.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Habilita o inhabilita la coincidencia de fuentes 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.

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 para el 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 cancela la recepción y no se recibe un encuadre.

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ó ningún ACK ERROR_CHANNEL_ACCESS_FAILURE cuando no se pudo realizar la transmisión debido a la actividad del canal. OT_ERROR_ABORT cuando se anula 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`	El canal en el que se realizará el escaneo de energía.
`[in] aScanDuration`	La duración (en milisegundos) del canal que se analizará.
`[in] aCallback`	Un puntero a una función llamada al finalizar un canal escaneado.

Valores de retorno

`OT_ERROR_NONE`	Se inició correctamente la búsqueda del canal.
`OT_ERROR_BUSY`	La radio realiza análisis escaneados.
`OT_ERROR_NOT_IMPLEMENTED`	La radio no admite el escaneo de energía.
`OT_ERROR_INVALID_STATE`	Si la capa del vínculo sin procesar no está habilitada

oLinkLinkRawGetCaps

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 de retorno

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

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Obtén el tiempo de la plataforma actual (64 bits de ancho) 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.

oLinkLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Obtén 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
)

Transiciones de radio de transmisión a recepción

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

El emisor de la llamada forma el marco IEEE 802.15.4 en este búfer y llama a otLinkRawTransmit() para solicitar la transmisión.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Qué muestra

Un puntero para el 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 se habilitó o no la capa de vínculo sin procesar.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

`true`	La capa del vínculo sin procesar está habilitada.
`false`	La capa del vínculo sin procesar está inhabilitada.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Transición de la radio de suspensión a recepción.

Enciende la radio.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

`OT_ERROR_NONE`	La transición se realizó correctamente.
`OT_ERROR_INVALID_STATE`	La radio se inhabilitó o transmitía.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Establece el valor actual del contador de marcos MAC.

Esta función 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`	Es el valor de contador de fotogramas de MAC.

Valores de retorno

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

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

Detalles

Parámetros

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

Valores de retorno

`OT_ERROR_NONE`	Si el proceso se realiza correctamente,
`OT_ERROR_INVALID_STATE`	Si la capa del 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 la clave.
`[in] aPrevKey`	La clave MAC anterior.
`[in] aCurrKey`	La clave MAC actual.
`[in] aNextKey`	La siguiente clave MAC.

Valores de retorno

`OT_ERROR_NONE`	Si el proceso se realiza correctamente,
`OT_ERROR_INVALID_STATE`	Si la capa del 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 de retorno

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

otLinkRawSetReceiveListo

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 a una función llamada al recibir un marco IEEE 802.15.4. NULL para inhabilitar la capa del vínculo sin procesar.

Valores de retorno

`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 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 de retorno

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

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Haz la transición de la recepción de sueño a la de suspensión.

Apaga la radio.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

`OT_ERROR_NONE`	La transición se realizó correctamente.
`OT_ERROR_BUSY`	La radio se transmitía
`OT_ERROR_INVALID_STATE`	Se inhabilitó la radio

otLinkRawSrcMatchAddExtEntry

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

Agregando la dirección extendida a la tabla de coincidencia de origen.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aExtAddress`	La dirección extendida que se agregará.

Valores de retorno

`OT_ERROR_NONE`	Se agregó correctamente la dirección extendida a la tabla de coincidencia de fuentes.
`OT_ERROR_NO_BUFS`	No hay entradas disponibles en la tabla de coincidencias de origen.
`OT_ERROR_INVALID_STATE`	Si la capa del vínculo sin procesar no está habilitada

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Agregando una dirección corta a la tabla de coincidencia de fuentes.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aShortAddress`	La dirección corta que se agregará.

Valores de retorno

`OT_ERROR_NONE`	Se agregó correctamente la dirección corta a la tabla de coincidencia de fuentes.
`OT_ERROR_NO_BUFS`	No hay entradas disponibles en la tabla de coincidencias de origen.
`OT_ERROR_INVALID_STATE`	Si la capa del vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Quitar todas las direcciones extendidas de la tabla de coincidencia de fuentes.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

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

otLinkRawSrcMatchClearExtEntry

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

Se quitará la dirección extendida de la tabla de coincidencia 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 de retorno

`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 está en la tabla de coincidencia de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa del vínculo sin procesar no está habilitada

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

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

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

`OT_ERROR_NONE`	Si el proceso se realiza correctamente,
`OT_ERROR_INVALID_STATE`	Si la capa del 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 coincidencia de fuentes.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aShortAddress`	La dirección corta que se quitará.

Valores de retorno

`OT_ERROR_NONE`	Se quitó correctamente la dirección corta de la tabla de coincidencia de fuentes.
`OT_ERROR_NO_ADDRESS`	La dirección corta no se encuentra en la tabla de coincidencia de fuentes.
`OT_ERROR_INVALID_STATE`	Si la capa del vínculo sin procesar no está habilitada

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

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

Detalles

Parámetros

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

Valores de retorno

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

oLinkLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

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

El emisor 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 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 llamada al finalizar la transmisión.

Valores de retorno

`OT_ERROR_NONE`	La transición a Transmisión se realizó correctamente.
`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.