OtRadioFrame
#include <radio.h>
Essa estrutura representa um frame de rádio IEEE 802.15.4.
Resumo
Atributos públicos |
|
---|---|
mAckFrameCounter
|
uint32_t
Contador de frames de segurança ACK (aplicável quando
mAckedWithSecEnhAck é definido). |
mAckKeyId
|
uint8_t
Índice de chave de segurança ACK (aplicável quando
mAckedWithSecEnhAck é definido). |
mAckedWithFramePending
|
bool
Indica se este frame foi confirmado com um frame pendente definido.
|
mAckedWithSecEnhAck
|
bool
Indica se este frame foi confirmado com ACK de ajuste seguro.
|
mAesKey
|
const otMacKeyMaterial *
É o material de chave usado para a segurança do frame AES-CCM.
|
mChannel
|
uint8_t
Canal usado para transmitir/receber o frame.
|
mCslPresent
|
bool
Defina como "true" se o cabeçalho CSL do IE estiver presente.
|
mCsmaCaEnabled
|
bool
Defina como "true" para ativar o CSMA-CA no pacote. Caso contrário, "false".
|
mIeInfo
|
O ponteiro para as informações relacionadas ao IE do cabeçalho.
|
mInfo
|
union otRadioFrame::@23
A união de transmissão e recebimento de informações para um frame de rádio.
|
mIsARetx
|
bool
Indica se o frame é uma retransmissão ou não.
|
mIsHeaderUpdated
|
bool
Indica se os contagens de frame e os CSL IEs estão atualizados corretamente no cabeçalho.
|
mIsSecurityProcessed
|
bool
Verdadeiro se o SubMac precisa ignorar o processamento AES desse frame.
|
mLength
|
uint16_t
Duração da PSDU.
|
mLqi
|
uint8_t
Indicador de qualidade do link dos frames recebidos.
|
mMaxCsmaBackoffs
|
uint8_t
Número máximo de tentativas de espera antes de declarar uma falha na CCA.
|
mMaxFrameRetries
|
uint8_t
Número máximo de novas tentativas permitidas após uma falha de transmissão.
|
mPsdu
|
uint8_t *
A PSDU.
|
mRadioType
|
uint8_t
Tipo de link de rádio: deve ser ignorado pelo driver do rádio.
|
mRssi
|
int8_t
Indicador de intensidade do sinal recebido em dBm para os frames recebidos.
|
mRxInfo
|
struct otRadioFrame::@23::@25
A estrutura que representa o frame de rádio recebe informações.
|
mTimestamp
|
uint64_t
É o carimbo de data/hora em que o frame foi recebido em microssegundos.
|
mTxDelay
|
uint32_t
É o tempo de atraso dessa transmissão com base em
mTxDelayBaseTime . |
mTxDelayBaseTime
|
uint32_t
O tempo base para o atraso da transmissão.
|
mTxInfo
|
struct otRadioFrame::@23::@24
Estrutura que representa a transmissão de informações do frame de rádio.
|
Atributos públicos
mAckFrameCounter
uint32_t otRadioFrame::mAckFrameCounter
Contador de frames de segurança ACK (aplicável quando mAckedWithSecEnhAck
é definido).
mAckKeyId.
uint8_t otRadioFrame::mAckKeyId
Índice de chave de segurança ACK (aplicável quando mAckedWithSecEnhAck
é definido).
mAckedWithFramePendente
bool otRadioFrame::mAckedWithFramePending
Indica se este frame foi confirmado com um frame pendente definido.
mAckedWithSecEnhAck
bool otRadioFrame::mAckedWithSecEnhAck
Indica se este frame foi confirmado com ACK de ajuste seguro.
mAesKey
const otMacKeyMaterial * otRadioFrame::mAesKey
É o material de chave usado para a segurança do frame AES-CCM.
Canal m
uint8_t otRadioFrame::mChannel
Canal usado para transmitir/receber o frame.
mCslPresent
bool otRadioFrame::mCslPresent
Defina como "true" se o cabeçalho CSL do IE estiver presente.
mCsmaCaEnabled
bool otRadioFrame::mCsmaCaEnabled
Defina como "true" para ativar o CSMA-CA no pacote. Caso contrário, "false".
Informações sobre a mídia
otRadioIeInfo * otRadioFrame::mIeInfo
O ponteiro para as informações relacionadas ao IE do cabeçalho.
Informações sobre dispositivos móveis
union otRadioFrame::@23 otRadioFrame::mInfo
A união de transmissão e recebimento de informações para um frame de rádio.
mIsARetx
bool otRadioFrame::mIsARetx
Indica se o frame é uma retransmissão ou não.
mIsHeaderUpdated
bool otRadioFrame::mIsHeaderUpdated
Indica se os contagens de frame e os CSL IEs estão atualizados corretamente no cabeçalho.
Se a camada da plataforma não fornecer o recurso OT_RADIO_CAPS_TRANSMIT_SEC
, ela poderá ignorar essa sinalização.
Se a plataforma fornecer o recurso OT_RADIO_CAPS_TRANSMIT_SEC
, ela deverá processar o processamento de segurança tx e a atribuição do contador de frames. Nesse caso, o comportamento a seguir é esperado:
Quando mIsHeaderUpdated
é definido, isso indica que o núcleo OpenThread já definiu o contador de frames e os IES IE (se a segurança estiver ativada) no frame preparado. É garantido que o contador corresponda ao valor do contador das tentativas anteriores do mesmo frame. A plataforma não pode atribuir ou alterar o contador de frames, mas talvez ainda precise executar o processamento de segurança dependendo da sinalização mIsSecurityProcessed
.
Se mIsHeaderUpdated
não for definido, o contador de frames e a chave CSL IE não serão definidos no frame pelo núcleo OpenThread, e será responsabilidade da plataforma de rádio atribuí-los. A plataforma precisa atualizar o cabeçalho do frame (atribuir valores de contador LCS e CSL) antes de enviar o frame over the air (OTA) mas, se a transmissão for cancelada e o frame nunca for enviado over the air (por exemplo, erro de acesso ao canal), a plataforma poderá optar por não atualizar o cabeçalho. Se a plataforma atualizar o cabeçalho, ela também precisará definir essa sinalização antes de transmitir o frame de volta do callback otPlatRadioTxDone()
.
mIsSecurityProcessed.
bool otRadioFrame::mIsSecurityProcessed
Verdadeiro se o SubMac precisa ignorar o processamento AES desse frame.
mComprimento
uint16_t otRadioFrame::mLength
Duração da PSDU.
MLLi
uint8_t otRadioFrame::mLqi
Indicador de qualidade do link dos frames recebidos.
mMaxCsmaBackoffs
uint8_t otRadioFrame::mMaxCsmaBackoffs
Número máximo de tentativas de espera antes de declarar uma falha na CCA.
mMaxFrameRetries
uint8_t otRadioFrame::mMaxFrameRetries
Número máximo de novas tentativas permitidas após uma falha de transmissão.
mPsdu
uint8_t * otRadioFrame::mPsdu
A PSDU.
Tipo de rádio m
uint8_t otRadioFrame::mRadioType
Tipo de link de rádio: deve ser ignorado pelo driver do rádio.
MRSSI
int8_t otRadioFrame::mRssi
Indicador de intensidade do sinal recebido em dBm para os frames recebidos.
Informações sobre o celular
struct otRadioFrame::@23::@25 otRadioFrame::mRxInfo
A estrutura que representa o frame de rádio recebe informações.
mTimestamp
uint64_t otRadioFrame::mTimestamp
É o carimbo de data/hora em que o frame foi recebido em microssegundos.
O valor precisará ser o horário em que a SFD foi recebida quando TIME_SYNC ou CSL está ativado. Caso contrário, o tempo em que o frame MAC foi totalmente recebido também será aceitável.
mTxDelay
uint32_t otRadioFrame::mTxDelay
É o tempo de atraso dessa transmissão com base em mTxDelayBaseTime
.
mTxDelayBaseTimeTime
uint32_t otRadioFrame::mTxDelayBaseTime
O tempo base para o atraso da transmissão.
mTxInfo
struct otRadioFrame::@23::@24 otRadioFrame::mTxInfo
Estrutura que representa a transmissão de informações do frame de rádio.
Recursos
Os tópicos de referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para saber mais ou contribuir com nossa documentação, consulte Recursos.