متنوع

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

ملخص

التعداد
`otPlatMcuPowerState { OT_PLAT_MCU_POWER_STATE_ON = 0, OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1, OT_PLAT_MCU_POWER_STATE_OFF = 2 }`	تعداد تعداد حالات قوة جهاز التحكم الجزئي.
`otPlatResetReason`	تعداد تعداد أكواد أسباب إعادة التعيين المحتملة.

المهام
`otPlatAssertFail (const char *aFilename, int aLineNumber)`	`void` توفر هذه الوظيفة تطبيق منصة محددة للتأكيد.
`otPlatGetMcuPowerState ( otInstance *aInstance)`	`otPlatMcuPowerState` تحصل هذه الوظيفة على حالة طاقة MCU المطلوبة الحالية.
`otPlatGetResetReason ( otInstance *aInstance)`	`otPlatResetReason` ترجع هذه الوظيفة سبب آخر إعادة تعيين النظام الأساسي.
`otPlatReset ( otInstance *aInstance)`	`void` تقوم هذه الوظيفة بإعادة تعيين البرنامج على النظام الأساسي ، إذا كانت مدعومة.
`otPlatSetMcuPowerState ( otInstance *aInstance, otPlatMcuPowerState aState)`	`otError` تحدد هذه الوظيفة حالة طاقة MCU المطلوبة.
`otPlatWakeHost (void)`	`void` تؤدي هذه الوظيفة عملية خاصة بالنظام الأساسي لتنبيه MCU المضيف.

التعداد

otPlatMcuPowerState

 otPlatMcuPowerState

تعداد حالات قوة جهاز التحكم الجزئي.

يتم استخدام هذه القيم لتكوين NCP عند تمكين OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL .

تحدد حالة الطاقة حالة الطاقة المرغوبة لوحدة التحكم الدقيقة (MCU) الخاصة بـ NCP عندما يدخل نظام تشغيل النظام الأساسي الأساسي في وضع الخمول (على سبيل المثال ، تتم معالجة جميع المهام / الأحداث النشطة ويمكن أن تدخل MCU في حالة طاقة موفرة للطاقة).

تحدد حالة الطاقة بشكل أساسي كيفية تفاعل المضيف مع NCP وما إذا كان المضيف يحتاج إلى مشغل خارجي ("كزة") إلى NCP قبل أن يتمكن من الاتصال بـ NCP أم لا.

بعد إعادة OT_PLAT_POWER_STATE_ON يجب أن تكون حالة طاقة MCU هي OT_PLAT_POWER_STATE_ON .

الخصائص

الخصائص
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	يمكن أن تدخل MCU الخاصة بـ NCP حالة طاقة منخفضة (موفرة للطاقة). عندما يتم تعيين حالة الطاقة المطلوبة لـ NCP على `LOW_POWER` ، من المتوقع أن يقوم المضيف " `LOW_POWER` " NCP (على سبيل المثال ، مشغل خارجي مثل المقاطعة) قبل أن يتمكن من الاتصال بـ NCP (إرسال رسالة إلى NCP). يتم تحديد آلية "الوخز" من خلال رمز النظام الأساسي (بناءً على واجهة NCP مع المضيف). أثناء ضبط حالة الطاقة على `LOW_POWER` ، لا يزال بإمكان NCP (في أي وقت) إرسال رسائل إلى المضيف. لاحظ أن تلقي رسالة من NCP لا يشير إلى أن حالة طاقة NCP قد تغيرت ، أي أنه من المتوقع أن يستمر المضيف في "الوخز" عندما يريد التحدث إلى NCP حتى يتم تغيير حالة الطاقة بشكل صريح (عن طريق مكالمة ناجحة إلى `otPlatSetMcuPowerState()` تغيير الحالة إلى `ON` ). ملاحظة: `LOW_POWER` حالة الطاقة `LOW_POWER` فقط وضع طاقة MCU ولا ترتبط بحالة الراديو (تتم إدارة الراديو بواسطة OpenThread core ودور الجهاز ، على سبيل المثال ، الجهاز نائم أم لا.
`OT_PLAT_MCU_POWER_STATE_OFF`	NCP متوقف بالكامل. يلزم إعادة تعيين جهاز NCP (عبر دبوس RESET) لإعادة NCP إلى `SPINEL_MCU_POWER_STATE_ON` . لا يتم الاحتفاظ بذاكرة الوصول العشوائي بعد إعادة التعيين.
`OT_PLAT_MCU_POWER_STATE_ON`	تظل MCU الخاصة بـ NCP قيد التشغيل والنشطة طوال الوقت. عند ضبط حالة الطاقة المطلوبة لـ NCP على `ON` ، يمكن للمضيف إرسال رسائل إلى NCP دون الحاجة إلى أي "ضغط" أو مشغلات خارجية. ملاحظة: تحدد حالة الطاقة `ON` فقط وضع طاقة MCU ولا ترتبط بحالة الراديو.

OT_PLAT_MCU_POWER_STATE_LOW_POWER

يمكن أن تدخل MCU الخاصة بـ NCP حالة طاقة منخفضة (موفرة للطاقة).

عندما يتم تعيين حالة الطاقة المطلوبة لـ NCP على LOW_POWER ، من المتوقع أن يقوم المضيف " LOW_POWER " NCP (على سبيل المثال ، مشغل خارجي مثل المقاطعة) قبل أن يتمكن من الاتصال بـ NCP (إرسال رسالة إلى NCP). يتم تحديد آلية "الوخز" من خلال رمز النظام الأساسي (بناءً على واجهة NCP مع المضيف).

أثناء ضبط حالة الطاقة على LOW_POWER ، لا يزال بإمكان NCP (في أي وقت) إرسال رسائل إلى المضيف. لاحظ أن تلقي رسالة من NCP لا يشير إلى أن حالة طاقة NCP قد تغيرت ، أي أنه من المتوقع أن يستمر المضيف في "الوخز" عندما يريد التحدث إلى NCP حتى يتم تغيير حالة الطاقة بشكل صريح (عن طريق مكالمة ناجحة إلى otPlatSetMcuPowerState() تغيير الحالة إلى ON ).

ملاحظة: LOW_POWER حالة الطاقة LOW_POWER فقط وضع طاقة MCU ولا ترتبط بحالة الراديو (تتم إدارة الراديو بواسطة OpenThread core ودور الجهاز ، على سبيل المثال ، الجهاز نائم أم لا.

OT_PLAT_MCU_POWER_STATE_OFF

NCP متوقف بالكامل.

يلزم إعادة تعيين جهاز NCP (عبر دبوس RESET) لإعادة NCP إلى SPINEL_MCU_POWER_STATE_ON . لا يتم الاحتفاظ بذاكرة الوصول العشوائي بعد إعادة التعيين.

OT_PLAT_MCU_POWER_STATE_ON

تظل MCU الخاصة بـ NCP قيد التشغيل والنشطة طوال الوقت.

عند ضبط حالة الطاقة المطلوبة لـ NCP على ON ، يمكن للمضيف إرسال رسائل إلى NCP دون الحاجة إلى أي "ضغط" أو مشغلات خارجية.

ملاحظة: تحدد حالة الطاقة ON فقط وضع طاقة MCU ولا ترتبط بحالة الراديو.

otPlatResetReason

 otPlatResetReason

تعداد أكواد أسباب إعادة التعيين المحتملة.

هذه في نفس الترتيب مثل رموز أسباب إعادة تعيين Spinel.

المهام

فشل otPlatAssert

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

توفر هذه الوظيفة تطبيق منصة محددة للتأكيد.

تفاصيل

المعلمات

`[in] aFilename`	اسم الملف حيث تم التأكيد.
`[in] aLineNumber`	رقم السطر في الملف حيث تم التأكيد.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

تحصل هذه الوظيفة على حالة طاقة MCU المطلوبة الحالية.

هذا فقط قابل للتطبيق ويستخدم لتكوين NCP عند تمكين OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL .

بعد إعادة OT_PLAT_POWER_STATE_ON يجب أن تعود حالة الطاقة OT_PLAT_POWER_STATE_ON . أثناء التشغيل ، يجب ألا تتغير حالة الطاقة إلا من خلال استدعاء ناجح صريح لـ otPlatSetMcuPowerState() .

تفاصيل

المعلمات

[in] aInstance

مؤشر إلى مثيل OpenThread.

عائدات

حالة الطاقة الحالية.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

ترجع هذه الوظيفة سبب آخر إعادة تعيين النظام الأساسي.

تفاصيل

المعلمات

[in] aInstance

بنية مثيل OpenThread.

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

تقوم هذه الوظيفة بإعادة تعيين البرنامج على النظام الأساسي ، إذا كانت مدعومة.

تفاصيل

المعلمات

[in] aInstance

بنية مثيل OpenThread.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

تحدد هذه الوظيفة حالة طاقة MCU المطلوبة.

هذا فقط قابل للتطبيق ويستخدم لتكوين NCP عند تمكين OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL .

تفاصيل

المعلمات

`[in] aInstance`	مؤشر إلى مثيل OpenThread.
`[in] aState`	حالة طاقة MCU الجديدة.

إرجاع القيم

`OT_ERROR_NONE`	تم تحديث حالة الطاقة بنجاح.
`OT_ERROR_FAILED`	لا تدعم النظام الأساسي حالة طاقة MCU المحددة.

otPlatWakeHost

void otPlatWakeHost(
  void
)

تؤدي هذه الوظيفة عملية خاصة بالنظام الأساسي لتنبيه MCU المضيف.

يستخدم هذا فقط لتكوينات NCP.