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

تتضمن هذه الوحدة ملخصًا للنظام الأساسي لإعداد الراديو.

ملخّص

الدوال

otPlatRadioGetBusSpeed(otInstance *aInstance)
uint32_t
يمكنك الحصول على سرعة الحافلة بوحدة البت/ثانية بين المضيف وشريحة الراديو.
otPlatRadioGetCaps(otInstance *aInstance)
احصل على إمكانات الراديو.
otPlatRadioGetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t *aThreshold)
للحصول على حد CCA ED للراديو بالديسيبل بالمللي ثانية الذي يتم قياسه في موصِّل الهوائي وفق IEEE 802.15.4 - 2015، القسم 10.1.4.
otPlatRadioGetFemLnaGain(otInstance *aInstance, int8_t *aGain)
للحصول على اكتساب RX LNA التابع لـ FEM في dBm
otPlatRadioGetIeeeEui64(otInstance *aInstance, uint8_t *aIeeeEui64)
void
للحصول على IEEE-EU4-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 EDA للراديو بالديسيبل بالمللي ثانية عند قياس موصِّل الهوائي وفقًا للمعيار IEEE 802.15.4 - 2015. القسم 10.1.4.
otPlatRadioSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
حدِّد العنوان الموسّع لفلترة العناوين.
otPlatRadioSetFemLnaGain(otInstance *aInstance, int8_t aGain)
تضبط هذه السياسة قيمة اكتساب Rx LNA لشركة FEM في dBm.
otPlatRadioSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
void
لضبط قيمة عدّاد إطار MAC الحالي.
otPlatRadioSetMacFrameCounterIfLarger(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
بنية مثيل OpenThread.
المرتجعات
متّجه إمكانات الراديو (راجِع تعريفات OT_RADIO_CAP_*).

otPlatRadioGetCCaEnergyDetectThreshold

otError otPlatRadioGetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t *aThreshold
)

للحصول على حد CCA ED للراديو بالديسيبل بالمللي ثانية الذي يتم قياسه في موصِّل الهوائي وفق IEEE 802.15.4 - 2015، القسم 10.1.4.

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

otPlatRadioGetFemLnaGet

otError otPlatRadioGetFemLnaGain(
  otInstance *aInstance,
  int8_t *aGain
)

للحصول على اكتساب RX LNA التابع لـ FEM في dBm

التفاصيل
المَعلمات
[in] aInstance
بنية مثيل OpenThread.
[out] aGain
اكتساب RX LNA التابع لـ FEM بعد ذلك في 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-EU4-64 التي يحدّدها المصنع في هذه الواجهة.

التفاصيل
المَعلمات
[in] aInstance
بنية مثيل OpenThread.
[out] aIeeeEui64
مؤشر إلى IEEE-EUI-64 المعيَّن للمصنع.

otPlatRadioGetNow

uint64_t otPlatRadioGetNow(
  otInstance *aInstance
)

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

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

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

OtlatlatioioGetPromiscuous

bool otPlatRadioGetPromiscuous(
  otInstance *aInstance
)

الحصول على حالة الوضع غير الموحّد.

التفاصيل
المَعلمات
[in] aInstance
بنية مثيل OpenThread.
قيم الإرجاع
TRUE
تم تفعيل وضع "غير متناغم".
FALSE
تم إيقاف وضع "غير للمستخدم".

otPlatRadioGetاستلامSensitivity

int8_t otPlatRadioGetReceiveSensitivity(
  otInstance *aInstance
)

تعرَّف على قيمة حساسية استقبال الراديو.

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

otPlatRadioGetTransmitPower

otError otPlatRadioGetTransmitPower(
  otInstance *aInstance,
  int8_t *aPower
)

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

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

otPlatRadioGetVersionString

const char * otPlatRadioGetVersionString(
  otInstance *aInstance
)

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

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

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

otPlatRadioSetCCaEnergyDetectThreshold

otError otPlatRadioSetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t aThreshold
)

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

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

otPlatRadioSetSetAddress

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

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

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

otPlatRadioSetFemLnaGet

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

تضبط هذه السياسة قيمة اكتساب Rx LNA لشركة FEM في dBm.

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

otPlatRadioSetMacframeCounter

void otPlatRadioSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

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

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

otPlatRadioSetMacframeCounterIflarger

void otPlatRadioSetMacFrameCounterIfLarger(
  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_Rad_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
بنية مثيل OpenThread.
[in] aPanId
رقم تعريف رقم PAN وفقًا للمعيار IEEE 802.15.4.

otPlatRadioSetPromiscuous

void otPlatRadioSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

تفعيل أو إيقاف الوضع "غير للمستخدم"

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

otPlatRadioSetShortAddress

void otPlatRadioSetShortAddress(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

حدِّد العنوان القصير لفلترة العناوين.

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

otPlatRadioSetTransmitPower

otError otPlatRadioSetTransmitPower(
  otInstance *aInstance,
  int8_t aPower
)

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

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

الموارد

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