أنواع الراديو

تتضمن هذه الوحدة تجريد النظام الأساسي لإطار راديو.

ملخّص

التعدادات

anonymous enum{
  OT_RADIO_FRAME_MAX_SIZE = 127,
  OT_RADIO_FRAME_MIN_SIZE = 3,
  OT_RADIO_SYMBOLS_PER_OCTET = 2,
  OT_RADIO_BIT_RATE = 250000,
  OT_RADIO_BITS_PER_OCTET = 8,
  OT_RADIO_SYMBOL_RATE = 62500,
  OT_RADIO_SYMBOL_TIME = 1000000 * 1 / OT_RADIO_SYMBOL_RATE,
  OT_RADIO_TEN_SYMBOLS_TIME = 10 * OT_RADIO_SYMBOL_TIME,
  OT_RADIO_LQI_NONE = 0,
  OT_RADIO_RSSI_INVALID = 127,
  OT_RADIO_POWER_INVALID = 127
}
تعداد
anonymous enum{
  OT_RADIO_CHANNEL_PAGE_0 = 0,
  OT_RADIO_CHANNEL_PAGE_0_MASK = (1U << OT_RADIO_CHANNEL_PAGE_0),
  OT_RADIO_CHANNEL_PAGE_2 = 2,
  OT_RADIO_CHANNEL_PAGE_2_MASK = (1U << OT_RADIO_CHANNEL_PAGE_2)
}
تعداد
تحدد صفحة القناة.
anonymous enum{
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN = 1,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX = 10,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK = 0x3ff << OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN = 11,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX = 26,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK = 0xffff << OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN
}
تعداد
تحديد نطاق قنوات نطاق التكرار
anonymous enum{
  OT_RADIO_CAPS_NONE = 0,
  OT_RADIO_CAPS_ACK_TIMEOUT = 1 << 0,
  OT_RADIO_CAPS_ENERGY_SCAN = 1 << 1,
  OT_RADIO_CAPS_TRANSMIT_RETRIES = 1 << 2,
  OT_RADIO_CAPS_CSMA_BACKOFF = 1 << 3,
  OT_RADIO_CAPS_SLEEP_TO_TX = 1 << 4,
  OT_RADIO_CAPS_TRANSMIT_SEC = 1 << 5,
  OT_RADIO_CAPS_TRANSMIT_TIMING = 1 << 6,
  OT_RADIO_CAPS_RECEIVE_TIMING = 1 << 7
}
تعداد
يتم تحديد الثوابت التي تُستخدم للإشارة إلى إمكانات الراديو المختلفة.
anonymous enum{
  OT_IE_HEADER_SIZE = 2,
  OT_CSL_IE_SIZE = 4,
  OT_ACK_IE_MAX_SIZE = 16,
  OT_ENH_PROBING_IE_DATA_MAX_SIZE = 2
}
تعداد
تحدد الثوابت في حجم عنوان IE في ACK.
otRadioKeyType{
  OT_KEY_TYPE_LITERAL_KEY = 0,
  OT_KEY_TYPE_KEY_REF = 1
}
تعداد
تحديد الثوابت في أنواع المفاتيح
otRadioState تعداد
يمثّل حالة الراديو.

أنواع المحددات

otExtAddress typedef
struct otExtAddress
يمثّل العنوان الموسَّع IEEE 802.15.4.
otLinkMetrics typedef
struct otLinkMetrics
تمثل المقاييس التي يتم تحديدها لطلب البحث.
otMacKey typedef
struct otMacKey
يمثل مفتاح MAC.
otMacKeyMaterial typedef
otMacKeyRef typedef
تمثّل مرجعًا لمفتاح MAC الذي تستخدمه أداة PSA.
otPanId typedef
uint16_t
تمثّل رقم تعريف PAN 802.15.4.
otRadioCaps typedef
uint8_t
تمثّل الإمكانات اللاسلكية.
otRadioCoexMetrics typedef
في ما يلي عمليات نقل صالحة لحالة الراديو:
otRadioFrame typedef
struct otRadioFrame
يمثّل إطار الراديو IEEE 802.15.4.
otRadioIeInfo typedef
struct otRadioIeInfo
تمثل المعلومات ذات الصلة بIE 802.15.4 IE (عنصر المعلومات) المتعلقة بإطار راديو.
otRadioState typedef
يمثّل حالة الراديو.
otShortAddress typedef
uint16_t
يمثّل العنوان القصير IEEE 802.15.4.

المتغيّرات

OT_TOOL_PACKED_END

هياكل

otExtAddress

يمثّل العنوان الموسَّع IEEE 802.15.4.

otLinkMetrics

تمثل المقاييس التي يتم تحديدها لطلب البحث.

otMacKey

يمثل مفتاح MAC.

otMacKeyMaterial

يمثل مفتاح MAC.

otRadioCoexMetrics

في ما يلي عمليات نقل صالحة لحالة الراديو:

otRadioframe

يمثّل إطار الراديو IEEE 802.15.4.

otRadioIeInfo

تمثل المعلومات ذات الصلة بIE 802.15.4 IE (عنصر المعلومات) المتعلقة بإطار راديو.

التعدادات

تعداد مجهول

 anonymous enum
أماكن إقامة
OT_RADIO_BITS_PER_OCTET

عدد وحدات البت لكل وحدة ثمانيّة البت.

OT_RADIO_BIT_RATE

معيار IEEE 802.15.4 2.4 غيغاهرتز (بمعدل البت لكل ثانية)

OT_RADIO_FRAME_MAX_SIZE

aMaxPHYPacketSize (IEEE 802.15.4-2006)

OT_RADIO_FRAME_MIN_SIZE

الحد الأدنى لحجم الإطار FCS + Control.

OT_RADIO_LQI_NONE

لا يتوفّر قياس مؤشر جودة الهواء.

OT_RADIO_POWER_INVALID

قيمة طاقة غير صالحة أو غير معروفة.

OT_RADIO_RSSI_INVALID

قيمة RSSI غير صالحة أو غير معروفة.

OT_RADIO_SYMBOLS_PER_OCTET

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_SYMBOL_RATE

معدّل رمز O-QPSKPHY عند التشغيل في النطاقات 780 ميغاهرتز و915 ميغاهرتز و2380 ميغاهرتز و2450 ميغاهرتز.

OT_RADIO_SYMBOL_TIME

مدة مدة الرمز بوحدة الميكرو ثانية

OT_RADIO_TEN_SYMBOLS_TIME

وقت لـ 10 رموز بوحدة ميكرو ثانية

تعداد مجهول

 anonymous enum

تحدد صفحة القناة.

أماكن إقامة
OT_RADIO_CHANNEL_PAGE_0

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_CHANNEL_PAGE_0_MASK

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_CHANNEL_PAGE_2

915 ميغاهرتز IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2_MASK

915 ميغاهرتز IEEE 802.15.4-2006

تعداد مجهول

 anonymous enum

تحديد نطاق قنوات نطاق التكرار

أماكن إقامة
OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN

معيار IEEE 802.15.4-2006 بسرعة 2.4 غيغاهرتز

OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK

915 ميغاهرتز IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX

915 ميغاهرتز IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN

915 ميغاهرتز IEEE 802.15.4-2006

تعداد مجهول

 anonymous enum

يتم تحديد الثوابت التي تُستخدم للإشارة إلى إمكانات الراديو المختلفة.

يمكنك الاطّلاع على otRadioCaps.

أماكن إقامة
OT_RADIO_CAPS_ACK_TIMEOUT

يتوافق الراديو مع حدث AckTime.

OT_RADIO_CAPS_CSMA_BACKOFF

يتيح الراديو التراجع عن استخدام CSMA لنقل الإطارات (ولكن بدون إعادة المحاولة).

OT_RADIO_CAPS_ENERGY_SCAN

يتوافق الراديو مع عمليات البحث عن الطاقة.

OT_RADIO_CAPS_NONE

لا تتوفّر إمكانية الراديو.

OT_RADIO_CAPS_RECEIVE_TIMING

يتيح الراديو استخدام Rx في وقت محدّد.

OT_RADIO_CAPS_SLEEP_TO_TX

يتوافق الراديو مع الانتقال المباشر من وضع السكون إلى TX مع إعلانات CSMA.

OT_RADIO_CAPS_TRANSMIT_RETRIES

يتوافق الراديو مع منطق إعادة المحاولة لـ tx مع تجنُّب التصادم (CSMA).

OT_RADIO_CAPS_TRANSMIT_SEC

يتوافق الراديو مع أمان tx.

OT_RADIO_CAPS_TRANSMIT_TIMING

يتيح الراديو استخدام tx في وقت محدّد.

تعداد مجهول

 anonymous enum

تحدد الثوابت في حجم عنوان IE في ACK.

أماكن إقامة
OT_ACK_IE_MAX_SIZE

الحد الأقصى لطول عنوان IE في ACK

OT_CSL_IE_SIZE

حجم محتوى CSL IE بالبايت.

OT_ENH_PROBING_IE_DATA_MAX_SIZE

الحد الأقصى لطول بيانات "مقاييس الرابط" في أداة IE الخاصة بالمورّد.

OT_IE_HEADER_SIZE

حجم عنوان IE بالبايت.

otRadioKeyType

 otRadioKeyType

تحديد الثوابت في أنواع المفاتيح

أماكن إقامة
OT_KEY_TYPE_KEY_REF

استخدام مرجع إلى المفتاح:

OT_KEY_TYPE_LITERAL_KEY

استخدِم المفاتيح الحرفية.

OtRadioState

 otRadioState

يمثّل حالة الراديو.

في البداية، يكون الراديو في وضع الإيقاف.

أنواع المحددات

otExtAddress

struct otExtAddress otExtAddress

يمثّل العنوان الموسَّع IEEE 802.15.4.

المقاييس الإضافية

struct otLinkMetrics otLinkMetrics

تمثل المقاييس التي يتم تحديدها لطلب البحث.

مفتاح Mac

struct otMacKey otMacKey

يمثل مفتاح MAC.

OotMacKeyMaterial

struct otMacKeyMaterial otMacKeyMaterial

OtMacKeyref

otCryptoKeyRef otMacKeyRef

تمثّل مرجعًا لمفتاح MAC الذي تستخدمه أداة PSA.

otPanId

uint16_t otPanId

تمثّل رقم تعريف PAN 802.15.4.

قنوات OTRadioCaps

uint8_t otRadioCaps

تمثّل الإمكانات اللاسلكية.

القيمة هي حقل بت يشير إلى الإمكانات المتوفرة في الراديو. يُرجى الاطّلاع على OT_RADIO_CAPS_* تعريفات.

OotRadioCoexMetrics

struct otRadioCoexMetrics otRadioCoexMetrics

في ما يلي عمليات نقل صالحة لحالة الراديو:

(الراديو مفعّل) +----+ Enable() +-+ Receive() +---+ Transmit() +----+ | |----->| |----->| |-------->| | | غير مفعَّل | | السكون | | استلام | | إرسال | |<-----| |<-----| |<--------| | +----+ زر الإيقاف المؤقت +-- + استقبال +--النقل + +-

أثناء أمر طلب البيانات IEEE 802.15.4، يمكن اختصار عملية النقل Sleep->استلام->النقل للانتقال مباشرةً من وضع السكون إلى الإرسال في حال توافق النظام الأساسي مع إمكانية OT_اللاسلكي_CAPS_SLEEP_TO_TX. تعرض مقاييس التعاصر اللاسلكي.

إطار otRadioframe

struct otRadioFrame otRadioFrame

يمثّل إطار الراديو IEEE 802.15.4.

otRadioIeInfo

struct otRadioIeInfo otRadioIeInfo

تمثل المعلومات ذات الصلة بIE 802.15.4 IE (عنصر المعلومات) المتعلقة بإطار راديو.

OtRadioState

enum otRadioState otRadioState

يمثّل حالة الراديو.

في البداية، يكون الراديو في وضع الإيقاف.

OotShortAddress

uint16_t otShortAddress

يمثّل العنوان القصير IEEE 802.15.4.

المتغيّرات

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otExtAddress OT_TOOL_PACKED_END

وحدات ماكرو

CSL_IE_HEADER_BYTES_HI

 CSL_IE_HEADER_BYTES_HI 0x0d

تم تثبيت البايت الثاني لرأس CSL IE.

CSL_IE_HEADER_BYTES_LO

 CSL_IE_HEADER_BYTES_LO 0x04

تم تثبيت رأس CSE IE الأول بالبايت.

OT_EXT_ADDRESS_SIZE

 OT_EXT_ADDRESS_SIZE 8

حجم العنوان الموسَّع IEEE 802.15.4 (بالبايت)

الوقت الإضافي: OT_MAC_KEY_SIZE

 OT_MAC_KEY_SIZE 16

حجم مفتاح MAC بالبايت

الدالة OT_PANID_BStreetCAST

 OT_PANID_BROADCAST 0xffff

IEEE 802.15.4 رقم تعريف رقم PAN للبث.

OT_TOOL_PACKED_END

 OT_TOOL_PACKED_END

مؤشر خاص بالعارض في نهاية فئة أو بنية مليئة بالبايت.

الموارد

تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.