otRadioFrame

#include <radio.h>

Bir IEEE 802.15.4 radyo çerçevesini temsil eder.

Özet

Herkese açık özellikler

mAckFrameCounter
uint32_t
ACK güvenlik çerçevesi sayacı (mAckedWithSecEnhAck ayarlandığında geçerlidir).
mAckKeyId
uint8_t
ACK güvenlik anahtarı dizini (mAckedWithSecEnhAck ayarlandığında geçerlidir).
mAckedWithFramePending
bool
Bu mesaj, karenin onaylanıp onaylanmadığını gösterir ve kare beklemede ayarlanır.
mAckedWithSecEnhAck
bool
Bu mesaj, bu çerçevenin güvenli geliştirme ACK ile onaylanıp onaylanmadığını gösterir.
mAesKey
AES-CCM çerçeve güvenliği için kullanılan anahtar materyali.
mChannel
uint8_t
Kareyi iletmek/almak için kullanılan kanal.
mCslPresent
bool
CSL üstbilgisi IE varsa doğru değerine ayarlayın.
mCsmaCaEnabled
bool
Bu paket için CSMA-CA'yı etkinleştirmek için true (doğru), aksi takdirde yanlış değerine ayarlayın.
mIeInfo
Başlık IE(ler) ile ilgili bilgilerin işaretçisi.
mInfo
union otRadioFrame::@24
Bir radyo çerçevesi için bilgi gönderme ve alma birleşimi.
mIsARetx
bool
Karenin yeniden iletim olup olmadığını belirtir.
mIsHeaderUpdated
bool
Başlıkta çerçeve sayacının ve CSL IE'lerinin düzgün şekilde güncellenip güncellenmediğini belirtir.
mIsSecurityProcessed
bool
SubMac'in bu çerçevenin AES işlemesini atlaması gerekiyorsa doğru değerini alır.
mLength
uint16_t
PSDU'nun uzunluğu.
mLqi
uint8_t
Alınan kareler için Bağlantı Kalitesi Göstergesi.
mMaxCsmaBackoffs
uint8_t
CCA hatası bildirilmeden önceki maksimum geri yükleme denemesi sayısı.
mMaxFrameRetries
uint8_t
İletim hatası olduğunda izin verilen maksimum yeniden deneme sayısı.
mPsdu
uint8_t *
PSDU.
mRadioType
uint8_t
Radyo bağlantısı türü, radyo sürücüsü tarafından yoksayılmalıdır.
mRssi
int8_t
Alınan kareler için dBm cinsinden alınan sinyal gücü göstergesi.
mRxChannelAfterTxDone
uint8_t
Kare TX'i tamamlandıktan sonra RX kanalı (tüm kare yeniden denemelerinden sonra - onay alındıktan veya zaman aşımı ya da iptalden sonra).
mRxInfo
struct otRadioFrame::@24::@26
Radyo çerçevesini temsil eden yapı, bilgi alır.
mTimestamp
uint64_t
Yerel antende SFD'nin sonu varken yerel radyo saatinin mikrosaniye cinsinden zamanı.
mTxDelay
uint32_t
mTxDelayBaseTime değerine referansta bulunulan bu iletim için mikrosaniye cinsinden gecikme süresi.
mTxDelayBaseTime
uint32_t
Yerel radyo saatine göre planlanmış iletimler için mikrosaniye cinsinden temel süre; bkz. otPlatRadioGetNow ve mTxDelay.
mTxInfo
struct otRadioFrame::@24::@25
Radyo çerçevesi iletim bilgilerini temsil eden yapı.

Herkese açık özellikler

mAckFrameCounter

uint32_t otRadioFrame::mAckFrameCounter

ACK güvenlik çerçevesi sayacı (mAckedWithSecEnhAck ayarlandığında geçerlidir).

mAckKeyId

uint8_t otRadioFrame::mAckKeyId

ACK güvenlik anahtarı dizini (mAckedWithSecEnhAck ayarlandığında geçerlidir).

mAckedWithFramePending

bool otRadioFrame::mAckedWithFramePending

Bu mesaj, karenin onaylanıp onaylanmadığını gösterir ve kare beklemede ayarlanır.

mAckedWithSecEnhAck

bool otRadioFrame::mAckedWithSecEnhAck

Bu mesaj, bu çerçevenin güvenli geliştirme ACK ile onaylanıp onaylanmadığını gösterir.

mAesKey

const otMacKeyMaterial * otRadioFrame::mAesKey

AES-CCM çerçeve güvenliği için kullanılan anahtar materyali.

mChannel

uint8_t otRadioFrame::mChannel

Kareyi iletmek/almak için kullanılan kanal.

mCslPresent

bool otRadioFrame::mCslPresent

CSL üstbilgisi IE varsa doğru değerine ayarlayın.

mCsmaCaEnabled

bool otRadioFrame::mCsmaCaEnabled

Bu paket için CSMA-CA'yı etkinleştirmek için true (doğru), aksi takdirde yanlış değerine ayarlayın.

mIeInfo

otRadioIeInfo * otRadioFrame::mIeInfo

Başlık IE(ler) ile ilgili bilgilerin işaretçisi.

mInfo

union otRadioFrame::@24 otRadioFrame::mInfo

Bir radyo çerçevesi için bilgi gönderme ve alma birleşimi.

mIsARetx

bool otRadioFrame::mIsARetx

Karenin yeniden iletim olup olmadığını belirtir.

mIsHeaderUpdated

bool otRadioFrame::mIsHeaderUpdated

Başlıkta çerçeve sayacının ve CSL IE'lerinin düzgün şekilde güncellenip güncellenmediğini belirtir.

Platform katmanı OT_RADIO_CAPS_TRANSMIT_SEC özelliği sağlamıyorsa bu işareti yok sayabilir.

Platform OT_RADIO_CAPS_TRANSMIT_SEC özelliği sağlıyorsa platformun tx güvenlik işlemelerini ve çerçeve sayacının atanmasını işlemesi beklenir. Bu durumda aşağıdaki davranış beklenir:

mIsHeaderUpdated ayarlandığında, OpenThread Core'un hazırlanan karede çerçeve sayacını ve CSL IE'lerini (güvenlik etkinse) önceden ayarladığını belirtir. Sayaç, aynı çerçevenin önceki denemelerindeki sayaç değeriyle eşleşecek şekilde sağlanır. Platform, çerçeve sayacını atamamalı veya değiştirmemelidir (ancak mIsSecurityProcessed işaretine bağlı olarak güvenlik işlemi gerçekleştirmesi gerekebilir).

mIsHeaderUpdated ayarlanmazsa çerçeve sayacı ve CSL IE anahtarı OpenThread core tarafından çerçeve içinde ayarlanmaz ve bunların atanması radyo platformunun sorumluluğundadır. Platform, çerçeveyi kablosuz olarak göndermeden önce çerçeve başlığını güncellemelidir (sayaç ve CSL IE değerleri atayın). Ancak iletim iptal edilir ve çerçeve hiçbir zaman kablosuz olarak gönderilmezse (ör. kanal erişim hatası), platform başlığı güncellememeyi tercih edebilir. Platform başlığı güncellerse çerçeveyi otPlatRadioTxDone() geri çağırmasından geri almadan önce bu işareti de ayarlamalıdır.

mIsSecurityProcessed

bool otRadioFrame::mIsSecurityProcessed

SubMac'in bu çerçevenin AES işlemesini atlaması gerekiyorsa doğru değerini alır.

mLength

uint16_t otRadioFrame::mLength

PSDU'nun uzunluğu.

mLqi

uint8_t otRadioFrame::mLqi

Alınan kareler için Bağlantı Kalitesi Göstergesi.

mMaxCsmaBackoffs

uint8_t otRadioFrame::mMaxCsmaBackoffs

CCA hatası bildirilmeden önceki maksimum geri yükleme denemesi sayısı.

mMaxFrameRetries

uint8_t otRadioFrame::mMaxFrameRetries

İletim hatası olduğunda izin verilen maksimum yeniden deneme sayısı.

mPsdu

uint8_t * otRadioFrame::mPsdu

PSDU.

mRadioType

uint8_t otRadioFrame::mRadioType

Radyo bağlantısı türü, radyo sürücüsü tarafından yoksayılmalıdır.

mRssi

int8_t otRadioFrame::mRssi

Alınan kareler için dBm cinsinden alınan sinyal gücü göstergesi.

mRxChannelAfterTxDone

uint8_t otRadioFrame::mRxChannelAfterTxDone

Kare TX'i tamamlandıktan sonra RX kanalı (tüm kare yeniden denemelerinden sonra - onay alındıktan veya zaman aşımı ya da iptalden sonra).

Radyo platformları bunu tamamen yok saymayı tercih edebilir. OT yığını, bir kare TX işlemi tamamlandıktan ve otPlatRadioTxDone() geri aramasıyla sinyal verildikten sonra otPlatRadioReceive() adlı kullanıcının istenen RX kanalıyla çağrılmasını sağlar. OT_RADIO_CAPS_TRANSMIT_RETRIES sağlamayan radyo platformları bunu her zaman görmezden gelmelidir.

Bu kullanım, OT yığını ile radyo arasındaki etkileşimlerde gecikme olabileceği durumlarda amaçlanmıştır. Örneğin, RCP/ana makine mimarisinde RCP'nin PAN kanalına daha hızlı geçiş yapmasını sağlamak için kullanılır. Bu, özellikle uykulu bir çocuğa CSL izleme işleminde yardımcı olabilir. Çocuk, CSL için PAN kanalından farklı bir kanal kullanabilir. Tx karesinden sonra, üst öğenin daha sonra çocuktan gelen iletiyi atlamamasını sağlamak için radyo/RCP'nin hızlı bir şekilde PAN kanalına geri gitmesini isteriz. Örneğin, çocuk, CSL kanalında kalırken PAN kanalını kullanarak üst ağdan CSL ile iletilen önceki kareye yanıt verebilir.

RX kanalına geçişin, çerçeve TX'i tamamen tamamlandıktan sonra (tüm yeniden denemelerden ve onay alındığında (TX karesinde "Onay İsteği" bayrağı ayarlandığında) veya onay zaman aşımına uğradıktan sonra yapılması ZORUNLUDUR. Onaylamanın, karenin gönderildiği kanalda bekleneceğini unutmayın.

mRxInfo

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

Radyo çerçevesini temsil eden yapı, bilgi alır.

mTimestamp

uint64_t otRadioFrame::mTimestamp

Yerel antende SFD'nin sonu varken yerel radyo saatinin mikrosaniye cinsinden zamanı.

mTxDelay

uint32_t otRadioFrame::mTxDelay

mTxDelayBaseTime değerine referansta bulunulan bu iletim için mikrosaniye cinsinden gecikme süresi.

Not: mTxDelayBaseTime + mTxDelay SHALL, yerel radyo saatine göre yerel antede SFD'nin sonunun bulunacağı zamanı gösterir.

mTxDelayBaseTime

uint32_t otRadioFrame::mTxDelayBaseTime

Yerel radyo saatine göre planlanmış iletimler için mikrosaniye cinsinden temel süre; bkz. otPlatRadioGetNow ve mTxDelay.

mTxInfo

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

Radyo çerçevesi iletim bilgilerini temsil eden yapı.

Kaynaklar

OpenThread API Referans konuları, GitHub'da bulunan kaynak koddan gelir. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar bölümüne bakın.