إعداد الراديو

تشمل هذه الوحدة تجريد الأنظمة الأساسية للإعداد اللاسلكي.

الملخّص

الدوال

otPlatRadioGetBusSpeed(otInstance *aInstance)
uint32_t
احصل على سرعة الحافلة بالبت/ثانية بين المضيف وشريحة الراديو.
otPlatRadioGetCaps(otInstance *aInstance)
يمكنك الحصول على إمكانات الراديو.
otPlatRadioGetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t *aThreshold)
احصل على حد CCA للراديو بوحدة قياس ديسيبل ملي واط ومقاس بموصّل هوائي وفقًا للفقرة 10.1.4 من معايير IEEE 802.15.4 - 2015.
otPlatRadioGetFemLnaGain(otInstance *aInstance, int8_t *aGain)
الحصول على ربح RNA LNA الخارجي في ديسيبل ميللي واط.
otPlatRadioGetIeeeEui64(otInstance *aInstance, uint8_t *aIeeeEui64)
void
احصل على IEEE EU-64 الذي تم تخصيصه من المصنع لهذه الواجهة.
otPlatRadioGetNow(otInstance *aInstance)
uint64_t
يمكنك الحصول على الوقت المقدر الحالي (بالميكرو ثانية) لرقاقة الراديو.
otPlatRadioGetPromiscuous(otInstance *aInstance)
bool
الحصول على حالة الوضع المختلط
otPlatRadioGetReceiveSensitivity(otInstance *aInstance)
int8_t
الحصول على قيمة حساسية استلام الراديو
otPlatRadioGetTransmitPower(otInstance *aInstance, int8_t *aPower)
الحصول على طاقة الإرسال للراديو بالديسيبل ميلي واط
otPlatRadioGetVersionString(otInstance *aInstance)
const char *
الحصول على سلسلة الإصدار اللاسلكي
otPlatRadioSetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t aThreshold)
تعيين حد CCA للراديو بوحدة القياس ديسيبل ملي واط ومقاس بموصّل هوائي وفقًا للفقرة 10.1.4 من معايير IEEE 802.15.4 - 2015.
otPlatRadioSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
إعداد العنوان الموسّع لفلترة العناوين.
otPlatRadioSetFemLnaGain(otInstance *aInstance, int8_t aGain)
ضبط ربح RNA LNA الخارجي في dBm.
otPlatRadioSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
void
تضبط هذه الطريقة قيمة عدّاد إطار MAC الحالي.
otPlatRadioSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKeyMaterial *aPrevKey, const otMacKeyMaterial *aCurrKey, const otMacKeyMaterial *aNextKey, otRadioKeyType aKeyType)
void
يمكنك تعديل مفاتيح MAC وفهرس المفاتيح.
otPlatRadioSetPanId(otInstance *aInstance, otPanId aPanId)
void
ضبط معرّف PAN لفلترة العناوين.
otPlatRadioSetPromiscuous(otInstance *aInstance, bool aEnable)
void
تفعيل وضع المشاعر أو إيقافه.
otPlatRadioSetShortAddress(otInstance *aInstance, otShortAddress aShortAddress)
void
إعداد العنوان القصير لفلترة العناوين.
otPlatRadioSetTransmitPower(otInstance *aInstance, int8_t aPower)
اضبط طاقة إرسال الراديو بالديسيبل ميلي واط.

الدوال

otPlatRadioGetBusSpeed

uint32_t otPlatRadioGetBusSpeed(
  otInstance *aInstance
)

احصل على سرعة الحافلة بالبت/ثانية بين المضيف وشريحة الراديو.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
طلبات الإرجاع
سرعة الحافلة بالبت/ثانية بين المضيف وشريحة الراديو. عرض 0 عندما توجد طبقة MAC والطبقة اللاسلكية على الشريحة نفسها.

otPlatRadioGetCaps

otRadioCaps otPlatRadioGetCaps(
  otInstance *aInstance
)

يمكنك الحصول على إمكانات الراديو.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
طلبات الإرجاع
متّجه قدرة الراديو اللاسلكي (اطّلع على OT_RADIO_CAP_* تعريفات).

otPlatRadioGetGetaEnergyDetect أيضًا

otError otPlatRadioGetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t *aThreshold
)

احصل على حد CCA للراديو بوحدة قياس ديسيبل ملي واط ومقاس بموصّل هوائي وفقًا للفقرة 10.1.4 من معايير IEEE 802.15.4 - 2015.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[out] aThreshold
حد أدنى CCA ED بالديسيبل ميلي واط
قيم الإرجاع
OT_ERROR_NONE
تم استرداد حد CAA ED بنجاح.
OT_ERROR_INVALID_ARGS
كان aThreshold فارغًا.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ عملية ضبط حد CAA ED عبر dBm.

otPlatRadioGetGetFemLnaGain

otError otPlatRadioGetFemLnaGain(
  otInstance *aInstance,
  int8_t *aGain
)

الحصول على ربح RNA LNA الخارجي في ديسيبل ميللي واط.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[out] aGain
ربح RNA LX الخارجي في dBm.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد مكاسب LNA الخارجية لـ FEM.
OT_ERROR_INVALID_ARGS
كان aGain فارغًا.
OT_ERROR_NOT_IMPLEMENTED
لا يتم تنفيذ إعداد LNA الخارجي في FEM.

otPlatRadioGetIeeeEui64

void otPlatRadioGetIeeeEui64(
  otInstance *aInstance,
  uint8_t *aIeeeEui64
)

احصل على IEEE EU-64 الذي تم تخصيصه من قبل المصنع لهذه الواجهة.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[out] aIeeeEui64
مؤشر إلى IEEE EU-64 الذي تم تخصيصه من المصنع.

otPlatRadioGetNow

uint64_t otPlatRadioGetNow(
  otInstance *aInstance
)

يمكنك الحصول على الوقت المقدر الحالي (بالميكرو ثانية) لرقاقة الراديو.

يجب أن يكون موقّت الميكروثانية موقّتًا قيد التشغيل. ويجب أن يستمر الموقّت في التقدّم بدقة الميكروثانية حتى عندما يكون الراديو في وضع السكون.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
طلبات الإرجاع
الوقت الحالي بالميكروثانية. UINT64_MAX عندما لا يتوافق النظام الأساسي أو عندما يكون وقت الراديو غير جاهز.

otPlatRadioGetPromiscuous

bool otPlatRadioGetPromiscuous(
  otInstance *aInstance
)

الحصول على حالة الوضع المختلط

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
قيم الإرجاع
TRUE
تم تفعيل وضع المشاعر.
FALSE
تم إيقاف وضع المشاعر.

حساسية otPlatRadioGetReceiveSense

int8_t otPlatRadioGetReceiveSensitivity(
  otInstance *aInstance
)

الحصول على قيمة حساسية استلام الراديو

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
طلبات الإرجاع
قيمة الحساسية للإذاعة اللاسلكية بالديسيبل ميلي واط

otPlatRadioGetGetmitmitPower

otError otPlatRadioGetTransmitPower(
  otInstance *aInstance,
  int8_t *aPower
)

احصل على طاقة الإرسال اللاسلكية بالديسيبل ميلي واط.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[out] aPower
طاقة الإرسال ديسيبل ميلي واط.
قيم الإرجاع
OT_ERROR_NONE
تم استرداد قوة الإرسال بنجاح.
OT_ERROR_INVALID_ARGS
كان aPower فارغًا.
OT_ERROR_NOT_IMPLEMENTED
لا يتم تنفيذ إعداد إرسال الطاقة عبر ديسيبل ملي واط.

otPlatRadioGetVersionString

const char * otPlatRadioGetVersionString(
  otInstance *aInstance
)

الحصول على سلسلة الإصدار اللاسلكي

هذه هي وظيفة اختيارية لنظام أساسي للراديو. في حال عدم توفير برنامج التشغيل للراديو للأنظمة الأساسية، يتم استخدام إصدار OpenThread بدلاً من ذلك من OpenOpen.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
طلبات الإرجاع
مؤشر إلى إصدار الراديو لـ OpenThread.
اطّلع أيضًا على:
otGetVersionString()).

otPlatRadioSetCCaEnergyDetect أيضًا

otError otPlatRadioSetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t aThreshold
)

تعيين حد CCA للراديو بوحدة القياس ديسيبل ملي واط ومقاس بموصّل هوائي وفقًا للفقرة 10.1.4 من معايير IEEE 802.15.4 - 2015.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aThreshold
حد أدنى CCA ED بالديسيبل ميلي واط
قيم الإرجاع
OT_ERROR_NONE
تم ضبط قوة الإرسال بنجاح.
OT_ERROR_INVALID_ARGS
يتوفّر حد معيّن خارج النطاق.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ عملية ضبط حد CAA ED عبر dBm.

otPlatRadioSetSetAddress

void otPlatRadioSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

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

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aExtAddress
مؤشر إلى العنوان IEEE 802.15.4 الموسَّع المخزَّن بترتيب صغير في بايت.

otPlatRadioSetFemLnaGain

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

ضبط ربح RNA LNA الخارجي في dBm.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aGain
ربح RNA LX الخارجي في dBm.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط مكاسب LNA الخارجية لـ FEM بنجاح.
OT_ERROR_NOT_IMPLEMENTED
لا يتم تنفيذ إعداد أرباح LNA الخارجية في FEM.

otPlatRadioSetMacFrameCounter

void otPlatRadioSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

تضبط هذه الطريقة قيمة عدّاد إطار MAC الحالي.

يتم استخدام هذه الدالة عندما يوفر الراديو إمكانية OT_RADIO_CAPS_TRANSMIT_SEC.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aMacFrameCounter
قيمة عدّاد إطار MAC.

otPlatRadioSetMacKey

void otPlatRadioSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKeyMaterial *aPrevKey,
  const otMacKeyMaterial *aCurrKey,
  const otMacKeyMaterial *aNextKey,
  otRadioKeyType aKeyType
)

يمكنك تعديل مفاتيح MAC وفهرس المفاتيح.

يتم استخدام هذه الدالة عندما يوفر الراديو إمكانية OT_Radio_CapS_TRANSMIT_SEC.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aKeyIdMode
وضع "معرِّف المفتاح".
[in] aKeyId
فهرس مفتاح MAC الحالي.
[in] aPrevKey
مؤشر إلى مفتاح MAC السابق.
[in] aCurrKey
مؤشر إلى مفتاح MAC الحالي.
[in] aNextKey
مؤشر إلى مفتاح MAC التالي.
[in] aKeyType
نوع المفتاح المستخدم.

otPlatRadioSetPanId

void otPlatRadioSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

ضبط معرّف PAN لفلترة العناوين.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aPanId
معرّف PANEE 802.15.4 PAN

otPlatRadioSetPromiscuous

void otPlatRadioSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

تفعيل وضع المشاعر أو إيقافه.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aEnable
TRUE للتفعيل أو FALSE لإيقاف الوضع المتنوّع.

otPlatRadioSetSetAddress

void otPlatRadioSetShortAddress(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

إعداد العنوان القصير لفلترة العناوين.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aShortAddress
العنوان القصير IEEE 802.15.4

otPlatRadioSetTransmitPower

otError otPlatRadioSetTransmitPower(
  otInstance *aInstance,
  int8_t aPower
)

اضبط طاقة إرسال الراديو بالديسيبل ميلي واط.

التفاصيل
المعلَمات
[in] aInstance
بنية المثال المفتوح.
[in] aPower
طاقة الإرسال ديسيبل ميلي واط.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط قوة الإرسال بنجاح.
OT_ERROR_NOT_IMPLEMENTED
لا يتم تنفيذ إعداد إرسال الطاقة عبر ديسيبل ملي واط.

المراجع

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