تشغيل الراديو
تعرض هذه الوحدة ملخصًا للنظام الأساسي للعمليات اللاسلكية.
ملخّص
الدوال |
|
---|---|
otPlatDiagRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
يستدعي سائق الراديو هذه الطريقة لإعلام وحدة بيانات تشخيص OpenThread بإطار مستلَم.
|
otPlatDiagRadioTransmitDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
يستدعي سائق الراديو هذه الطريقة لإعلام وحدة تشخيص OpenThread باكتمال عملية النقل.
|
otPlatRadioAddCalibratedPower(otInstance *aInstance, uint8_t aChannel, int16_t aActualPower, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)
|
أضِف قوة معايرة للقناة المحدّدة إلى جدول معايرة الطاقة.
|
otPlatRadioAddSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
|
أضِف عنوانًا موسَّعًا إلى جدول مطابقة عنوان المصدر.
|
otPlatRadioAddSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)
|
أضِف عنوانًا قصيرًا إلى جدول مطابقة عنوان المصدر.
|
otPlatRadioClearCalibratedPowers(otInstance *aInstance)
|
محو جميع طاقة المعايرة من جدول معايرة الطاقة
|
otPlatRadioClearSrcMatchExtEntries(otInstance *aInstance)
|
void
امح كل العناوين الطويلة/الطويلة من جدول مطابقة عنوان المصدر.
|
otPlatRadioClearSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
|
أزِل عنوانًا موسَّعًا من جدول مطابقة عنوان المصدر.
|
otPlatRadioClearSrcMatchShortEntries(otInstance *aInstance)
|
void
امحُ جميع العناوين القصيرة من جدول مطابقة عنوان المصدر.
|
otPlatRadioClearSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)
|
أزِل عنوانًا قصيرًا من جدول مطابقة عنوان المصدر.
|
otPlatRadioConfigureEnhAckProbing(otInstance *aInstance, otLinkMetrics aLinkMetrics, otShortAddress aShortAddress, const otExtAddress *aExtAddress)
|
تفعيل/إيقاف أو إجراء اختبارات استقصائية استنادًا إلى حملات تكييف الهواء المحسّنة في الراديو لبادئ تشغيل محدّد
|
otPlatRadioDisable(otInstance *aInstance)
|
إيقاف الراديو
|
otPlatRadioEnable(otInstance *aInstance)
|
تفعيل الراديو
|
otPlatRadioEnableCsl(otInstance *aInstance, uint32_t aCslPeriod, otShortAddress aShortAddr, const otExtAddress *aExtAddr)
|
تفعيل أو إيقاف مستقبِل CSL
|
otPlatRadioEnableSrcMatch(otInstance *aInstance, bool aEnable)
|
void
تفعيل/إيقاف ميزة مطابقة عنوان المصدر.
|
otPlatRadioEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration)
|
ابدأ تسلسل فحص الطاقة على الراديو.
|
otPlatRadioEnergyScanDone(otInstance *aInstance, int8_t aEnergyScanMaxRssi)
|
void
يستدعي سائق الراديو هذه الطريقة لإشعار OpenThread باكتمال عملية فحص الطاقة.
|
otPlatRadioGetCoexMetrics(otInstance *aInstance, otRadioCoexMetrics *aCoexMetrics)
|
الحصول على مقاييس العمل المشترَك لاسلكيًا
|
otPlatRadioGetCslAccuracy(otInstance *aInstance)
|
uint8_t
يمكنك الحصول على الدقة الحالية بوحدات ± نبضة في الدقيقة، من الساعة المستخدمة لجدولة عمليات CSL.
|
otPlatRadioGetCslUncertainty(otInstance *aInstance)
|
uint8_t
عدم التيقن الكامل للجهاز في جدولة عمليات إرسال CSL بوحدات 10 ميكرو ثانية
|
otPlatRadioGetPreferredChannelMask(otInstance *aInstance)
|
uint32_t
الحصول على قناع القناة المفضّل للراديو الذي يفضّل الجهاز استخدامه.
|
otPlatRadioGetRawPowerSetting(otInstance *aInstance, uint8_t aChannel, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
|
الحصول على إعداد الطاقة الأولية للقناة المحددة.
|
otPlatRadioGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
|
الحصول على رمز المنطقة
|
otPlatRadioGetRssi(otInstance *aInstance)
|
int8_t
الحصول على أحدث قياسات RSSI.
|
otPlatRadioGetState(otInstance *aInstance)
|
الحصول على الحالة الحالية للراديو
|
otPlatRadioGetSupportedChannelMask(otInstance *aInstance)
|
uint32_t
احصل على قناع القناة المتوافقة مع الراديو والتي يُسمح فيها بتشغيل الجهاز.
|
otPlatRadioGetTransmitBuffer(otInstance *aInstance)
|
الحصول على المخزن المؤقت لإطار الإرسال اللاسلكي
|
otPlatRadioIsCoexEnabled(otInstance *aInstance)
|
bool
تحقّق مما إذا كان قد تم تفعيل تبادل الراديو.
|
otPlatRadioIsEnabled(otInstance *aInstance)
|
bool
تحقّق مما إذا كان الراديو مفعّلاً أم لا.
|
otPlatRadioReceive(otInstance *aInstance, uint8_t aChannel)
|
لنقل الراديو من وضع السكون إلى استلام (تشغيل الراديو).
|
otPlatRadioReceiveAt(otInstance *aInstance, uint8_t aChannel, uint32_t aStart, uint32_t aDuration)
|
حدِّد موعدًا لفترة استقبال الراديو في وقت ومدّة محدَّدة.
|
otPlatRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
يستدعي سائق الراديو هذه الطريقة لإعلام OpenThread بإطار مستلَم.
|
otPlatRadioSetChannelMaxTransmitPower(otInstance *aInstance, uint8_t aChannel, int8_t aMaxPower)
|
اضبط الحدّ الأقصى لطاقة النقل لقناة معيّنة.
|
otPlatRadioSetChannelTargetPower(otInstance *aInstance, uint8_t aChannel, int16_t aTargetPower)
|
اضبط الطاقة المستهدَفة للقناة المحددة.
|
otPlatRadioSetCoexEnabled(otInstance *aInstance, bool aEnabled)
|
تفعيل وضع تبادل البريد.
|
otPlatRadioSetRegion(otInstance *aInstance, uint16_t aRegionCode)
|
اضبط رمز المنطقة.
|
otPlatRadioSleep(otInstance *aInstance)
|
يمكنك نقل الراديو من وضع "الاستلام" إلى وضع السكون (إيقاف الراديو).
|
otPlatRadioTransmit(otInstance *aInstance, otRadioFrame *aFrame)
|
ابدأ تسلسل الإرسال على الراديو.
|
otPlatRadioTxDone(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)
|
void
يستدعي سائق الراديو هذه الدالة لإشعار OpenThread بأنّ عملية النقل قد اكتملت، ما يوفر كلاً من الإطار المُنقَل وإطار العرض الذي تم استلامه.
|
otPlatRadioTxStarted(otInstance *aInstance, otRadioFrame *aFrame)
|
void
يستدعي سائق الراديو هذه الطريقة لإعلام OpenThread بأنّ عملية النقل قد بدأت.
|
otPlatRadioUpdateCslSampleTime(otInstance *aInstance, uint32_t aCslSampleTime)
|
void
تعديل عيّنة CSL من خلال سائق الراديو
|
الدوال
otPlatDiagRadioReceivedتم
void otPlatDiagRadioReceiveDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
يستدعي سائق الراديو هذه الطريقة لإعلام وحدة بيانات تشخيص OpenThread بإطار مستلَم.
يتم استخدامه عند تفعيل بيانات التشخيص.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otPlatDiagRadioTransmitDone
void otPlatDiagRadioTransmitDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
يستدعي سائق الراديو هذه الطريقة لإعلام وحدة تشخيص OpenThread باكتمال عملية النقل.
يتم استخدامه عند تفعيل بيانات التشخيص.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioAddCalibatedPower
otError otPlatRadioAddCalibratedPower( otInstance *aInstance, uint8_t aChannel, int16_t aActualPower, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength )
أضِف قوة معايرة للقناة المحدّدة إلى جدول معايرة الطاقة.
ملاحظة:واجهة برمجة التطبيقات هذه هي واجهة برمجة تطبيقات اختيارية للمنصات اللاسلكية. ويعود الأمر إلى طبقة النظام الأساسي لتنفيذه.
aActualPower
هي الطاقة الناتجة عن القياس الفعلي عند ضبط معلَمات وحدات الأجهزة اللاسلكية على aRawPowerSetting
.
إعداد الطاقة الأولية هو مصفوفة مبهمة بالبايت. OpenThread لا يحدد تنسيق إعدادات الطاقة الأولية. تنسيقها ذو صلة بالأجهزة اللاسلكية ويجب أن يحدّده مطوّرو البرامج في برنامج تشغيل الراديو. على سبيل المثال، إذا كان جهاز الراديو يحتوي على شريحة اللاسلكي وشريحة FEM، يمكن أن يشكّل إعداد الطاقة الأولية مزيجًا من سجل الطاقة اللاسلكية وقيمة كسب FEM.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
إدخال otPlatRadioAddSrcmatchExt
otError otPlatRadioAddSrcMatchExtEntry( otInstance *aInstance, const otExtAddress *aExtAddress )
أضِف عنوانًا موسَّعًا إلى جدول مطابقة عنوان المصدر.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
إدخال otPlatRadioAddSrcmatchShortShort
otError otPlatRadioAddSrcMatchShortEntry( otInstance *aInstance, otShortAddress aShortAddress )
أضِف عنوانًا قصيرًا إلى جدول مطابقة عنوان المصدر.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioClearCalibatedPowers
otError otPlatRadioClearCalibratedPowers( otInstance *aInstance )
محو جميع طاقة المعايرة من جدول معايرة الطاقة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioClearSrcmatchExtEntries
void otPlatRadioClearSrcMatchExtEntries( otInstance *aInstance )
امح كل العناوين الطويلة/الطويلة من جدول مطابقة عنوان المصدر.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
إدخال otPlatRadioClearSrcVoiceExt
otError otPlatRadioClearSrcMatchExtEntry( otInstance *aInstance, const otExtAddress *aExtAddress )
أزِل عنوانًا موسَّعًا من جدول مطابقة عنوان المصدر.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioClearSrcmatchShortEntries
void otPlatRadioClearSrcMatchShortEntries( otInstance *aInstance )
امحُ جميع العناوين القصيرة من جدول مطابقة عنوان المصدر.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
إدخال otPlatRadioClearSrc MatchShort
otError otPlatRadioClearSrcMatchShortEntry( otInstance *aInstance, otShortAddress aShortAddress )
أزِل عنوانًا قصيرًا من جدول مطابقة عنوان المصدر.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioConfigureEnhAckProbing
otError otPlatRadioConfigureEnhAckProbing( otInstance *aInstance, otLinkMetrics aLinkMetrics, otShortAddress aShortAddress, const otExtAddress *aExtAddress )
تفعيل/إيقاف أو إجراء اختبارات استقصائية استنادًا إلى حملات تكييف الهواء المحسّنة في الراديو لبادئ تشغيل محدّد
بعد ضبط مُسْتَخْدِمْ بَرْنَامَجِ التَّكْيِيفْ بِوَاسِطَةْ مُبَدِّلْ مُسَاعَدَة مُحَدَّدَة، يَجِبْ أَنْ يَشْمَلَ مُكَيِّفْ خَيْرَاتِ الْمُرَقَّبْ عَلَى بَيَانَاتْ مِيزَاتِ الرَّابِطْ. وتُعلِم هذه الطريقة الراديو ببدء أو إيقاف جمع بيانات مقاييس الروابط، وتتضمّن معلومات IE الخاصة بالمورِّد والتي تتضمّن البيانات الواردة في AC-ACK المُرسَلة إلى مبتدئ هذا البرنامج.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otPlatRadioDisable
otError otPlatRadioDisable( otInstance *aInstance )
إيقاف الراديو
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioEnable
otError otPlatRadioEnable( otInstance *aInstance )
تفعيل الراديو
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioEnableCsl
otError otPlatRadioEnableCsl( otInstance *aInstance, uint32_t aCslPeriod, otShortAddress aShortAddr, const otExtAddress *aExtAddr )
تفعيل أو إيقاف مستقبِل CSL
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otPlatRadioEnableSrcmatch
void otPlatRadioEnableSrcMatch( otInstance *aInstance, bool aEnable )
تفعيل/إيقاف ميزة مطابقة عنوان المصدر.
تتحكم ميزة مطابقة عنوان المصدر في كيفية تحديد طبقة الراديو لقمة "الإطار في انتظار المراجعة" بالنسبة إلى المجموعات المذكورة في طلبات ردّ البيانات من الأطفال.
وعند الإيقاف، يجب أن تضبط طبقة الراديو "الإطار في انتظار المراجعة" على جميع الطلبات.
في حال تفعيل هذه السياسة، تستخدم طبقة الراديو جدول مطابقة عنوان المصدر لتحديد ما إذا كان سيتم ضبط وحدة البت "في انتظار المراجعة" في الإطار أو محوها في أمر طلب البيانات.
يعرض جدول مطابقة عنوان المصدر قائمة العناصر الثانوية التي يتوفّر لها إطار في انتظار المراجعة. يمكن إضافة عنوان قصير أو عنوان طويل/طويل إلى جدول مطابقة العنوان المصدر.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioEnergyScan
otError otPlatRadioEnergyScan( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration )
ابدأ تسلسل فحص الطاقة على الراديو.
يُستخدم عندما يوفر الراديو إمكانية OT_Rad_CAPS_ENERGY_SCAN.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otPlatRadioEnergyScanتم
void otPlatRadioEnergyScanDone( otInstance *aInstance, int8_t aEnergyScanMaxRssi )
يستدعي سائق الراديو هذه الطريقة لإشعار OpenThread باكتمال عملية فحص الطاقة.
يُستخدم عندما يوفر الراديو إمكانية OT_Rad_CAPS_ENERGY_SCAN.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioGetCoexMetrics
otError otPlatRadioGetCoexMetrics( otInstance *aInstance, otRadioCoexMetrics *aCoexMetrics )
الحصول على مقاييس العمل المشترَك لاسلكيًا
يُستخدم عند تفعيل الميزة OPENThread_CONFIG_PLATFORM_Rad_COEX_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioGetCslAccuracy
uint8_t otPlatRadioGetCslAccuracy( otInstance *aInstance )
يمكنك الحصول على الدقة الحالية بوحدات ± نبضة في الدقيقة، من الساعة المستخدمة لجدولة عمليات CSL.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
انحراف إلّا أنّ الوقت المنقضي x rx/tx بالوحدة، وهو معدّل وحدة تساوي نبضة في الدقيقة
|
otPlatRadioGetCslUncertainity
uint8_t otPlatRadioGetCslUncertainty( otInstance *aInstance )
عدم التيقن الكامل للجهاز في جدولة عمليات إرسال CSL بوحدات 10 ميكرو ثانية
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
عدم التيقّن من CSL في وحداتنا العشرة
|
otPlatRadioGetPreferredChannelMask
uint32_t otPlatRadioGetPreferredChannelMask( otInstance *aInstance )
الحصول على قناع القناة المفضّل للراديو الذي يفضّل الجهاز استخدامه.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
القناع المفضّل للقناة
|
otPlatRadioGetRawPowerSetting
otError otPlatRadioGetRawPowerSetting( otInstance *aInstance, uint8_t aChannel, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength )
الحصول على إعداد الطاقة الأولية للقناة المحددة.
ملاحظة: تنفّذ OpenThread src/core/utils
عملية تنفيذ تلقائية لواجهة برمجة التطبيقات otPlatRadioAddCalibratedPower()
وotPlatRadioClearCalibratedPowers()
وotPlatRadioSetChannelTargetPower()
. يتم توفير واجهة برمجة التطبيقات هذه من خلال التنفيذ التلقائي للحصول على إعداد الطاقة الأولية للقناة المحددة. وإذا لم تستخدم المنصة عملية التنفيذ التلقائية، يمكنها تجاهل واجهة برمجة التطبيقات هذه.
يجب أن تحلل طبقة الراديو للنظام الأساسي إعداد الطاقة الأولية بناءً على تنسيق طبقة الراديو المحددة ومعلّمات كل وحدة من أجهزة الراديو.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otPlatRadioGetregion
otError otPlatRadioGetRegion( otInstance *aInstance, uint16_t *aRegionCode )
الحصول على رمز المنطقة
إنّ تنسيق المنطقة اللاسلكية هو تمثيل ASCII 2 بايت لرمز ISO 3166 alpha-2.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otPlatRadioGetRssi
int8_t otPlatRadioGetRssi( otInstance *aInstance )
الحصول على أحدث قياسات RSSI.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
قيمة RSSI في dBm عندما تكون صالحة 127 عندما يكون RSSI غير صالح.
|
otPlatRadioGetState
otRadioState otPlatRadioGetState( otInstance *aInstance )
الحصول على الحالة الحالية للراديو
غير مطلوب في OpenThread. يمكن استخدامه لتصحيح الأخطاء و/أو لأغراض خاصة بالتطبيق.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
الحالة الراهنة للراديو
|
otPlatRadioGet متوافقChannelMask
uint32_t otPlatRadioGetSupportedChannelMask( otInstance *aInstance )
احصل على قناع القناة المتوافقة مع الراديو والتي يُسمح فيها بتشغيل الجهاز.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
قناع القناة المعتمد على الراديو.
|
otPlatRadioGetTransmitBuffer
otRadioFrame * otPlatRadioGetTransmitBuffer( otInstance *aInstance )
الحصول على المخزن المؤقت لإطار الإرسال اللاسلكي
يفتح OpenThread إطار IEEE 802.15.4 في هذا المخزن المؤقت، ثم يطلب otPlatRadioTransmit()
لطلب النقل.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى المخزن المؤقت لإطار الإرسال
|
otPlatRadioIsCoexEnabled
bool otPlatRadioIsCoexEnabled( otInstance *aInstance )
تحقّق مما إذا كان قد تم تفعيل تبادل الراديو.
يُستخدم عند تفعيل الميزة OPENThread_CONFIG_PLATFORM_Rad_COEX_ENABLE.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
صحيح إذا تم تفعيل coex اللاسلكي، أو تم تحديده على "خطأ".
|
otPlatRadioIsEnabled
bool otPlatRadioIsEnabled( otInstance *aInstance )
تحقّق مما إذا كان الراديو مفعّلاً أم لا.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
صحيح إذا تم تفعيل الراديو، ويتم خطأ "خطأ" في الحالات الأخرى.
|
otPlatRadio الاستلام
otError otPlatRadioReceive( otInstance *aInstance, uint8_t aChannel )
لنقل الراديو من وضع السكون إلى استلام (تشغيل الراديو).
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioReceivedAt
otError otPlatRadioReceiveAt( otInstance *aInstance, uint8_t aChannel, uint32_t aStart, uint32_t aDuration )
حدِّد موعدًا لفترة استقبال الراديو في وقت ومدّة محدَّدة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otPlatRadioReceivedتم
void otPlatRadioReceiveDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
يستدعي سائق الراديو هذه الطريقة لإعلام OpenThread بإطار مستلَم.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioSetChannelMaxTransmitPower
otError otPlatRadioSetChannelMaxTransmitPower( otInstance *aInstance, uint8_t aChannel, int8_t aMaxPower )
اضبط الحدّ الأقصى لطاقة النقل لقناة معيّنة.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otPlatRadioSetChannelTargetPower
otError otPlatRadioSetChannelTargetPower( otInstance *aInstance, uint8_t aChannel, int16_t aTargetPower )
اضبط الطاقة المستهدَفة للقناة المحددة.
ملاحظة:واجهة برمجة التطبيقات هذه هي واجهة برمجة تطبيقات اختيارية للمنصات اللاسلكية. ويعود الأمر إلى طبقة النظام الأساسي لتنفيذه. وفي حال تنفيذ واجهة برمجة التطبيقات هذه، يجب إيقاف الدالة otPlatRadioSetTransmitPower()
.
يجب أن يضبط برنامج التشغيل اللاسلكي الطاقة الإخراج الفعلية على أن تكون أقل من أو تساوي التيار المُستهدف وأن تكون أقرب ما يمكن من الطاقة المستهدَفة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otPlatRadioSetCoexEnabled
otError otPlatRadioSetCoexEnabled( otInstance *aInstance, bool aEnabled )
تفعيل وضع تبادل البريد.
يُستخدم عند تفعيل الميزة OPENThread_CONFIG_PLATFORM_Rad_COEX_ENABLE.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioSetregion
otError otPlatRadioSetRegion( otInstance *aInstance, uint16_t aRegionCode )
اضبط رمز المنطقة.
إنّ تنسيق المنطقة اللاسلكية هو تمثيل ASCII 2 بايت لرمز ISO 3166 alpha-2.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
OotPlatRadioSleep
otError otPlatRadioSleep( otInstance *aInstance )
يمكنك نقل الراديو من وضع "الاستلام" إلى وضع السكون (إيقاف الراديو).
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otPlatRadioTransmit
otError otPlatRadioTransmit( otInstance *aInstance, otRadioFrame *aFrame )
ابدأ تسلسل الإرسال على الراديو.
يجب أن يُتصل المتصل بإطار IEEE 802.15.4 في المخزن المؤقت الذي يوفره otPlatRadioGetTransmitBuffer()
قبل طلب الإرسال. يتم أيضًا تضمين طاقة القناة والإرسال في بنية otRadioframe.
يتألف تسلسل الإرسال من:
- نقل الراديو إلى إحدى الولايات التالية:
- يمكنك تلقّي إشعار في حال تفعيل ميزة RX عندما يكون الجهاز غير نشِط لفترة قصيرة أو يكون OT_Rad_CAPS_SLEEP_TO_TX غير متوافق.
- السكون إذا كان RX متوقّفًا عندما يكون الجهاز في وضع عدم النشاط مع إتاحة OT_Rad_CAPS_SLEEP_TO_TX.
- لنقل العنصر الافتراضي على القناة المحددة وبقوة النقل المحددة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otPlatRadioTxDone
void otPlatRadioTxDone( otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError )
يستدعي سائق الراديو هذه الدالة لإشعار OpenThread بأنّ عملية النقل قد اكتملت، ما يوفر كلاً من الإطار المُنقَل وإطار العرض الذي تم استلامه.
عندما يوفّر الراديو إمكانية OT_RADIO_CAPS_TRANSMIT_SEC
، تعدِّل طبقة النظام الأساسي اللاسلكية aFrame
بعدّاد إطارات الأمان وقيم فهرس المفاتيح التي يحتفظ بها الراديو.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioTxStarted
void otPlatRadioTxStarted( otInstance *aInstance, otRadioFrame *aFrame )
يستدعي سائق الراديو هذه الطريقة لإعلام OpenThread بأنّ عملية النقل قد بدأت.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otPlatRadioUpdateCslSampleTime
void otPlatRadioUpdateCslSampleTime( otInstance *aInstance, uint32_t aCslSampleTime )
تعديل عيّنة CSL من خلال سائق الراديو
يتم تخزين عينة من الوقت في برنامج تشغيل الراديو كنسخة لحساب المرحلة عند إرسال ACK باستخدام CSL IE.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.