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
|
const otMacKeyMaterial *
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.