Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

otRadioFrame

#include <radio.h>

Esta estructura representa un marco de radio IEEE 802.15.4.

Resumen

Atributos públicos

mAckFrameCounter
uint32_t
Contador de marcos de seguridad ACK (aplicable cuando se configura mAckedWithSecEnhAck)
mAckKeyId
uint8_t
Índice de llave de seguridad ACK (aplicable cuando se configura mAckedWithSecEnhAck).
mAckedWithFramePending
bool
Esto indica si este marco se reconoció con un marco pendiente establecido.
mAckedWithSecEnhAck
bool
Esto indica si se reconoció este fotograma con ACK de mejora seguro.
mAesKey
El material clave utilizado para la seguridad del marco AES-CCM.
mChannel
uint8_t
Canal usado para transmitir/recibir el marco.
mCslPresent
bool
Se establece como verdadero si el encabezado de CSL IE está presente.
mCsmaCaEnabled
bool
Si se establece como verdadera, se habilita CSMA-CA para este paquete; de lo contrario, se establece como "false".
mIeInfo
Es el puntero a la información relacionada de los encabezados IE.
mInfo
union otRadioFrame::@24
Es la unión de transmisión y recepción de información para una trama de radio.
mIsARetx
bool
Indica si el fotograma es una retransmisión o no.
mIsHeaderUpdated
bool
Indica si los IES de CSL y el contador de marcos se actualizaron correctamente en el encabezado.
mIsSecurityProcessed
bool
Verdadero si SubMac debe omitir el procesamiento de AES de este marco.
mLength
uint16_t
Longitud de la PSDU.
mLqi
uint8_t
Indicador de calidad de vínculos para los marcos recibidos.
mMaxCsmaBackoffs
uint8_t
Cantidad máxima de intentos de retirada antes de declarar una falla de CCA.
mMaxFrameRetries
uint8_t
Cantidad máxima de reintentos permitidos después de una falla de transmisión.
mPsdu
uint8_t *
La PSDU.
mRadioType
uint8_t
Tipo de vínculo de radio: El controlador de radio debe ignorarlo.
mRssi
int8_t
Indicador de intensidad de la señal recibida en dBm para los fotogramas recibidos.
mRxChannelAfterTxDone
uint8_t
El canal RX después de que se completa la transmisión de fotogramas (después de todos los reintentos de fotogramas: confirmación de recepción, tiempo de espera o anulación).
mRxInfo
struct otRadioFrame::@24::@26
Estructura que representa a un marco de radio y recibe información.
mTimestamp
uint64_t
La marca de tiempo en la que se recibió el fotograma en microsegundos.
mTxDelay
uint32_t
El tiempo de retraso para esta transmisión (basado en mTxDelayBaseTime).
mTxDelayBaseTime
uint32_t
El tiempo base de la demora en la transmisión.
mTxInfo
struct otRadioFrame::@24::@25
Estructura que representa la información de transmisión de la trama de radio.

Atributos públicos

Contador de marcos mA

uint32_t otRadioFrame::mAckFrameCounter

Contador de marcos de seguridad ACK (aplicable cuando se configura mAckedWithSecEnhAck)

ID de clave de dispositivo móvil

uint8_t otRadioFrame::mAckKeyId

Índice de llave de seguridad ACK (aplicable cuando se configura mAckedWithSecEnhAck).

Se faltó con marco pendiente

bool otRadioFrame::mAckedWithFramePending

Esto indica si este marco se reconoció con un marco pendiente establecido.

fruncido

bool otRadioFrame::mAckedWithSecEnhAck

Esto indica si se reconoció este fotograma con ACK de mejora seguro.

Clave de mAes

const otMacKeyMaterial * otRadioFrame::mAesKey

El material clave utilizado para la seguridad del marco AES-CCM.

Canal móvil

uint8_t otRadioFrame::mChannel

Canal usado para transmitir/recibir el marco.

MCSLS

bool otRadioFrame::mCslPresent

Se establece como verdadero si el encabezado de CSL IE está presente.

mCsmaCaEnabled

bool otRadioFrame::mCsmaCaEnabled

Si se establece como verdadera, se habilita CSMA-CA para este paquete; de lo contrario, se establece como "false".

Información adicional

otRadioIeInfo * otRadioFrame::mIeInfo

Es el puntero a la información relacionada de los encabezados IE.

Información móvil

union otRadioFrame::@24 otRadioFrame::mInfo

Es la unión de transmisión y recepción de información para una trama de radio.

mIsARetx

bool otRadioFrame::mIsARetx

Indica si el fotograma es una retransmisión o no.

Encabezado de la actualización de mIs

bool otRadioFrame::mIsHeaderUpdated

Indica si los IES de CSL y el contador de marcos se actualizaron correctamente en el encabezado.

Si la capa de la plataforma no proporciona la función OT_RADIO_CAPS_TRANSMIT_SEC, puede ignorar esta marca.

Si la plataforma proporciona la función OT_RADIO_CAPS_TRANSMIT_SEC, se espera que maneje el procesamiento de seguridad tx y la asignación del contador de fotogramas. En este caso, se espera el siguiente comportamiento:

Cuando se establece mIsHeaderUpdated, indica que el núcleo de OpenThread ya configuró el contador de marcos y los IES de CSL (si la seguridad está habilitada) en el fotograma preparado. Se garantiza que el contador coincida con el valor del contador de los intentos anteriores del mismo marco. La plataforma no debe asignar ni cambiar el contador de fotogramas (pero es posible que aún deba realizar un procesamiento de seguridad según la marca mIsSecurityProcessed).

Si no se establece mIsHeaderUpdated, el contador de fotogramas y la clave CSL IE no se establecen en el fotograma por el núcleo de OpenThread, y es responsabilidad de la plataforma de radio asignarlos. La plataforma debe actualizar el encabezado del marco (asignar valores de contador y de CSL IE) antes de enviar el fotograma de forma inalámbrica; sin embargo, si se anula la transmisión y el fotograma nunca se envía de forma inalámbrica (p.ej., error de acceso al canal), la plataforma puede optar por no actualizar el encabezado. Si la plataforma actualiza el encabezado, también debe establecer esta marca antes de pasar el marco desde la devolución de llamada otPlatRadioTxDone().

Seguridad de mIs

bool otRadioFrame::mIsSecurityProcessed

Verdadero si SubMac debe omitir el procesamiento de AES de este marco.

mLongitud

uint16_t otRadioFrame::mLength

Longitud de la PSDU.

mlqi

uint8_t otRadioFrame::mLqi

Indicador de calidad de vínculos para los marcos recibidos.

Retiradas de campañas de máx. rendimiento

uint8_t otRadioFrame::mMaxCsmaBackoffs

Cantidad máxima de intentos de retirada antes de declarar una falla de CCA.

Reintentos de mMaxFrame

uint8_t otRadioFrame::mMaxFrameRetries

Cantidad máxima de reintentos permitidos después de una falla de transmisión.

MDU

uint8_t * otRadioFrame::mPsdu

La PSDU.

Tipo de radio

uint8_t otRadioFrame::mRadioType

Tipo de vínculo de radio: El controlador de radio debe ignorarlo.

MSR

int8_t otRadioFrame::mRssi

Indicador de intensidad de la señal recibida en dBm para los fotogramas recibidos.

mRxChannelAfterTxDone

uint8_t otRadioFrame::mRxChannelAfterTxDone

El canal RX después de que se completa la transmisión de fotogramas (después de todos los reintentos de fotogramas: confirmación de recepción, tiempo de espera o anulación).

Las plataformas de radio pueden ignorarla por completo. La pila de PO se asegurará de llamar a otPlatRadioReceive() con el canal RX deseado después de que se realice la transmisión de un fotograma y se indique en la devolución de llamada otPlatRadioTxDone(). Las plataformas de radio que no proporcionan OT_RADIO_CAPS_TRANSMIT_RETRIES siempre deben ignorar esto.

Esto está diseñado para situaciones en las que puede haber un retraso en las interacciones entre la pila OT y la radio, como ejemplo que se usa en la arquitectura del host o del RCP para garantizar que el RCP cambie al canal PAN más rápido. En particular, esto puede ayudar con la tx de CSL a un niño soñoliento, en el que el niño puede usar un canal diferente para el CSL que el canal PAN. Después del fotograma Tx, queremos que la radio o el RCP regrese al canal PAN con rapidez para asegurarse de que el elemento superior no omita la transmisión del tx del niño más tarde, p.ej., el niño responde al fotograma anterior del CSL mediante el canal PAN mientras la radio permanece en el canal CSL.

El cambio al canal RX DEBE ocurrir después de que el fotograma TX esté completo, es decir, después de todos los reintentos y cuando se reciba la confirmación (cuando la marca "Solicitud de confirmación" se configure en el marco de transmisión) o el tiempo de espera de confirmación. Ten en cuenta que se espera confirmar la confirmación en el mismo canal al que se envía el fotograma.

Información de mRx

struct otRadioFrame::@24::@26 otRadioFrame::mRxInfo

Estructura que representa a un marco de radio y recibe información.

marca de tiempo

uint64_t otRadioFrame::mTimestamp

La marca de tiempo en la que se recibió el fotograma en microsegundos.

El valor SERÁ el momento en que se recibió el SFD.

Retraso mtx

uint32_t otRadioFrame::mTxDelay

El tiempo de retraso para esta transmisión (basado en mTxDelayBaseTime).

Tiempo de base de retraso x

uint32_t otRadioFrame::mTxDelayBaseTime

El tiempo base de la demora en la transmisión.

Información de Mx

struct otRadioFrame::@24::@25 otRadioFrame::mTxInfo

Estructura que representa la información de transmisión de la trama de radio.

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.