Enlace sin procesar

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

Resumen

Typedefs
`otLinkRawEnergyScanDone )(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Esta función apunta a la recepción de una trama IEEE 802.15.4.
`otLinkRawReceiveDone )(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Esta función apunta a la recepción de una trama IEEE 802.15.4.
`otLinkRawTransmitDone )(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Esta función apunta a la recepción de una trama IEEE 802.15.4.

Funciones
`otLinkRawEnergyScan ( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Este método inicia la secuencia de exploración de energía en la radio.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` Obtenga las capacidades de radio.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` Esta función obtiene el estado de modo promiscuo.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` Obtenga el tiempo actual de la plataforma (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 enlace sin procesar está habilitada o no.
`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 tramas MAC.
`otLinkRawSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Actualice las claves MAC y el índice de claves.
`otLinkRawSetPromiscuous ( otInstance *aInstance, bool aEnable)`	`otError` Esta función habilita o deshabilita el modo promiscuo.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Esta función habilita / deshabilita la capa de enlace sin procesar.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Configure la Dirección corta para el filtrado de direcciones.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` Haga la transición de la radio de Recibir a Suspender.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Agregar dirección extendida a la tabla de coincidencias de origen.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Agregar una dirección corta a la tabla de coincidencias de origen.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` Eliminando todas las direcciones extendidas de la tabla de coincidencias de origen.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Eliminando la dirección extendida a la tabla de coincidencias de origen de la radio.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` Eliminando todas las direcciones cortas de la tabla de coincidencias de origen.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Eliminando la dirección corta de la tabla de coincidencias de origen.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` Habilitar / deshabilitar la coincidencia de origen 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)

Esta función apunta a la recepción de una trama IEEE 802.15.4.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aEnergyScanMaxRssi`	El RSSI máximo encontrado en el canal escaneado.

otLinkRawReceiveDone

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

Esta función apunta a la recepción de una trama IEEE 802.15.4.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aFrame`	Un puntero a la trama recibida o NULL si se canceló la operación de recepción.
`[in] aError`	OT_ERROR_NONE cuando se recibió correctamente una trama. OT_ERROR_ABORT cuando se canceló la recepción y no se recibió una trama.

otLinkRawTransmitDone

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

Esta función apunta a la recepción de una trama IEEE 802.15.4.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aFrame`	Un puntero al fotograma que se transmitió.
`[in] aAckFrame`	Un puntero al marco ACK.
`[in] aError`	OT_ERROR_NONE cuando se transmitió la trama. OT_ERROR_NO_ACK cuando se transmitió la trama pero no se recibió ACK OT_ERROR_CHANNEL_ACCESS_FAILURE cuando la transmisión no pudo tener lugar debido a la actividad en el canal. OT_ERROR_ABORT cuando la transmisión se interrumpió por otras razones.

Funciones

otLinkRawEnergyScan

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

Este método inicia la secuencia de exploración de energía en la radio.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aScanChannel`	El canal para realizar el escaneo de energía.
`[in] aScanDuration`	La duración, en milisegundos, del canal que se va a escanear.
`[in] aCallback`	Un puntero a una función llamada al finalizar un canal escaneado.

Valores devueltos

`OT_ERROR_NONE`	Comenzó a escanear el canal con éxito.
`OT_ERROR_NOT_IMPLEMENTED`	La radio no admite escaneo de energía.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtenga las capacidades de radio.

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Devoluciones

El vector de bits de capacidad de radio. La pila habilita o deshabilita algunas funciones en función de este valor.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Esta función obtiene el estado de modo promiscuo.

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Valores devueltos

`true`	El modo promiscuo está habilitado.
`false`	El modo promiscuo está desactivado.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Obtenga el tiempo actual de la plataforma (ancho de 64 bits) del chip de radio.

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Devoluciones

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 a una instancia de OpenThread.

Devoluciones

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.

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

La persona que llama 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 a una instancia de OpenThread.

Devoluciones

Un puntero al búfer de transmisión o NULL si la capa de enlace sin procesar no está habilitada.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Esta función indica si la capa de enlace sin procesar está habilitada o no.

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Valores devueltos

`true`	La capa de enlace sin procesar está habilitada.
`false`	La capa de enlace sin procesar está deshabilitada.

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 a una instancia de OpenThread.

Valores devueltos

`OT_ERROR_NONE`	Transición exitosa 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 MAC.

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace 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
)

Actualice las claves MAC y el índice de claves.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aKeyIdMode`	El modo de identificación 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 devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Esta función habilita o deshabilita el modo promiscuo.

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Esta función habilita / deshabilita la capa de enlace sin procesar.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aCallback`	Un puntero a una función llamada al recibir una trama IEEE 802.15.4. NULL para deshabilitar la capa de enlace sin procesar.

Valores devueltos

`OT_ERROR_FAILED`	La radio no se pudo habilitar / deshabilitar.
`OT_ERROR_INVALID_STATE`	Si la interfaz OpenThread IPv6 ya está habilitada.
`OT_ERROR_NONE`	Si el estado de habilitación se estableció correctamente.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Configure la Dirección corta para el filtrado de direcciones.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aShortAddress`	La dirección corta IEEE 802.15.4.

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

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

Apaga la radio.

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Valores devueltos

`OT_ERROR_NONE`	Transición exitosa al sueño.
`OT_ERROR_BUSY`	La radio estaba transmitiendo
`OT_ERROR_INVALID_STATE`	La radio estaba desactivada

otLinkRawSrcMatchAddExtEntry

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

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

Detalles

Parámetros

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

Valores devueltos

`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 enlace sin procesar no está habilitada.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

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

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Se agregó con éxito una 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 enlace sin procesar no está habilitada.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

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

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawSrcMatchClearExtEntry

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

Eliminando la dirección extendida a la tabla de coincidencias de origen de la radio.

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Se eliminó 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 enlace sin procesar no está habilitada.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

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

Detalles

Parámetros

[in] aInstance

Un puntero a una instancia de OpenThread.

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

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

Detalles

Parámetros

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

Valores devueltos

`OT_ERROR_NONE`	Se eliminó correctamente la dirección corta 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 enlace sin procesar no está habilitada.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Habilitar / deshabilitar la coincidencia de origen para el marco pendiente

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aEnable`	Habilitar / deshabilitar la coincidencia de origen para el marco pendiente.

Valores devueltos

`OT_ERROR_NONE`	Si tiene éxito.
`OT_ERROR_INVALID_STATE`	Si la capa de enlace sin procesar no está habilitada.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

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

La persona que llama debe formar la trama 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:

Transición de la radio para transmitir desde recibir.
Transmite la PSDU en el canal dado y en la potencia de transmisión dada.

Detalles

Parámetros

`[in] aInstance`	Un puntero a una instancia de OpenThread.
`[in] aCallback`	Un puntero a una función llamada al finalizar la transmisión.

Valores devueltos

`OT_ERROR_NONE`	Transición exitosa a Transmitir.
`OT_ERROR_INVALID_STATE`	La radio no estaba en estado de recepción.