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

تشمل هذه الوحدة المجرّد الأساسي لإطار لاسلكي.

الملخّص

التعدادات

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_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 مَعلمة typetype
struct otExtAddress
تمثل هذه البنية العنوان IEEE 802.15.4 الموسَّع.
otLinkMetrics مَعلمة typetype
struct otLinkMetrics
تمثّل هذه البنية المقاييس المحدّدة لطلب البحث.
otMacKey مَعلمة typetype
struct otMacKey
تمثل هذه البنية مفتاح MAC.
otMacKeyMaterial مَعلمة typetype
otMacKeyRef مَعلمة typetype
يمثل هذا النوع مرجع مفتاح MAC الذي تستخدمه إعلانات الخدمة العامة (PSA).
otPanId مَعلمة typetype
uint16_t
يمثل هذا النوع رقم تعريف PANEE 802.15.4 PAN.
otRadioCaps مَعلمة typetype
uint8_t
يمثل هذا النوع إمكانات الراديو.
otRadioCoexMetrics مَعلمة typetype
في ما يلي انتقالات حالة الراديو الصالحة:
otRadioFrame مَعلمة typetype
struct otRadioFrame
تمثل هذه البنية إطار الراديو IEEE 802.15.4.
otRadioIeInfo مَعلمة typetype
struct otRadioIeInfo
تمثّل هذه البنية المعلومات المتعلقة بإطار راديو IEEE 802.15.4 Header (عنصر المعلومات) لإطار لاسلكي.
otRadioState مَعلمة typetype
تمثّل هذه البنية حالة الراديو.
otShortAddress مَعلمة typetype
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

تمثّل هذه البنية المعلومات المتعلقة بإطار راديو IEEE 802.15.4 Header (عنصر المعلومات) لإطار لاسلكي.

التعدادات

عدد مجهول

 anonymous enum
المنشآت الفندقية
OT_RADIO_BITS_PER_OCTET

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

OT_RADIO_BIT_RATE

2.4 غيغاهرتز IEEE 802.15.4 (بت في الثانية)

OT_RADIO_FRAME_MAX_SIZE

الحد الأقصىPHYPacketSize (IEEE 802.15.4-2006)

OT_RADIO_FRAME_MIN_SIZE

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

OT_RADIO_LQI_NONE

قياس LQI غير معتمد.

OT_RADIO_POWER_INVALID

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

OT_RADIO_RSSI_INVALID

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

OT_RADIO_SYMBOLS_PER_OCTET

2.4 غيغاهرتز IEEE 802.15.4-2006

عدد مجهول

 anonymous enum

وتحدّد هذه القائمة صفحة القناة.

المنشآت الفندقية
OT_RADIO_CHANNEL_PAGE_0

2.4 غيغاهرتز IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_0_MASK

2.4 غيغاهرتز IEEE 802.15.4-2006

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

2.4 غيغاهرتز IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX

2.4 غيغاهرتز IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN

2.4 غيغاهرتز IEEE 802.15.4-2006

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 مع تجنُّب الاصطدام.

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 الموسَّع.

otLinkMetrics

struct otLinkMetrics otLinkMetrics

تمثّل هذه البنية المقاييس المحدّدة لطلب البحث.

otMacKey

struct otMacKey otMacKey

تمثل هذه البنية مفتاح MAC.

otMacKeyMaterial

struct otMacKeyMaterial otMacKeyMaterial

otMacKeyRef

otCryptoKeyRef otMacKeyRef

يمثل هذا النوع مرجع مفتاح MAC الذي تستخدمه إعلانات الخدمة العامة (PSA).

otPanId

uint16_t otPanId

يمثل هذا النوع رقم تعريف PANEE 802.15.4 PAN.

otRadioCaps

uint8_t otRadioCaps

يمثل هذا النوع إمكانات الراديو.

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

otRadioCoexMetrics

struct otRadioCoexMetrics otRadioCoexMetrics

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

(راديو قيد التشغيل) +---- Enable() +-+Receive() +---+ Transmit() +----+ | |----->| |----->| |-------->| | | موقوف | | النوم | | استلام | | إرسال | | |<-----| |<-----| |<--------| | +---- Disable() +-- Sleep() +---+Receive() +----+ (لا يمكن تشغيل الراديو) أو إرسال الإشارة

أثناء أمر طلب البيانات IEEE 802.15.4، يمكن اختصار عملية الانتقال Sleep->Receive->Transmit للانتقال المباشر من Sleep to Transmit إذا كان النظام الأساسي يوفّر إمكانية OT_Radio_CapS_SLEEP_TO_TX. وتمثل هذه البنية مقاييس التواجد اللاسلكي.

otRadioFrame

struct otRadioFrame otRadioFrame

تمثل هذه البنية إطار الراديو IEEE 802.15.4.

otRadioIeInfo

struct otRadioIeInfo otRadioIeInfo

تمثّل هذه البنية المعلومات المتعلقة بإطار راديو IEEE 802.15.4 Header (عنصر المعلومات) لإطار لاسلكي.

otRadioState

enum otRadioState otRadioState

تمثّل هذه البنية حالة الراديو.

في البداية، يكون الراديو في الحالة "متوقف".

otShortAddress

uint16_t otShortAddress

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

المتغيرات

OT_Tool_PACKED_END

OT_TOOL_PACKED_BEGIN struct otExtAddress OT_TOOL_PACKED_END

وحدات ماكرو

CSL_IE_HEAD_BYTES_HI

 CSL_IE_HEADER_BYTES_HI 0x0d

تم إصلاح الرأس الثاني لرأس CSL IE.

CSL_IE_HEAD_BYTES_LO

 CSL_IE_HEADER_BYTES_LO 0x04

تم إصلاح الرأس الأول في CSL 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_BWAYCAST

 OT_PANID_BROADCAST 0xffff

IEEE 802.15.4 بث رقم PAN.

OT_Tool_PACKED_END

 OT_TOOL_PACKED_END

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

المراجع

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