متفرقه

این ماژول شامل انتزاعات پلت فرم برای رفتارهای متفرقه است.

خلاصه

شمارش ها

otPlatMcuPowerState {
OT_PLAT_MCU_POWER_STATE_ON = 0,
OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
OT_PLAT_MCU_POWER_STATE_OFF = 2
}		 enum
شمارش حالت های قدرت میکروکنترلر.
otPlatResetReason enum
شمارش کدهای دلیل بازنشانی احتمالی

کارکرد

otPlatAssertFail (const char *aFilename, int aLineNumber)
void
یک پلتفرم پیاده سازی خاص را برای ادعا فراهم می کند.
otPlatGetMcuPowerState ( otInstance *aInstance)
وضعیت فعلی توان MCU مورد نظر را دریافت می کند.
otPlatGetResetReason ( otInstance *aInstance)
دلیل آخرین بازنشانی پلت فرم را برمی‌گرداند.
otPlatReset ( otInstance *aInstance)
void
در صورت پشتیبانی، بازنشانی نرم افزاری را روی پلت فرم انجام می دهد.
otPlatResetToBootloader ( otInstance *aInstance)
در صورت پشتیبانی، یک بازنشانی سخت‌افزاری روی پلتفرم برای راه‌اندازی حالت بوت‌لودر انجام می‌دهد.
otPlatSetMcuPowerState ( otInstance *aInstance, otPlatMcuPowerState aState)
حالت توان MCU مورد نظر را تنظیم می کند.
otPlatWakeHost (void)
void
یک عملیات خاص پلت فرم را برای بیدار کردن MCU میزبان انجام می دهد.

شمارش ها

otPlatMcuPowerState

 otPlatMcuPowerState

شمارش حالت های قدرت میکروکنترلر.

زمانی که OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL فعال باشد، از این مقادیر برای پیکربندی NCP استفاده می‌شود.

حالت توان، وضعیت توان مورد نظر میکروکنترلر NCP (MCU) را زمانی که سیستم عامل پلتفرم زیربنایی وارد حالت بیکار می‌شود، مشخص می‌کند (یعنی تمام وظایف/رویدادهای فعال پردازش می‌شوند و MCU به طور بالقوه می‌تواند وارد حالت انرژی صرفه‌جویی شود).

حالت قدرت در درجه اول تعیین می کند که میزبان چگونه باید با NCP تعامل داشته باشد و آیا میزبان قبل از اینکه بتواند با NCP ارتباط برقرار کند به یک ماشه خارجی ("poke") برای NCP نیاز دارد یا خیر.

پس از تنظیم مجدد، وضعیت برق MCU باید OT_PLAT_POWER_STATE_ON باشد.

خواص
OT_PLAT_MCU_POWER_STATE_LOW_POWER

MCU NCP می تواند وارد حالت کم مصرف (صرفه جویی در انرژی) شود.

هنگامی که حالت برق مورد نظر NCP روی LOW_POWER تنظیم می شود، انتظار می رود میزبان قبل از اینکه بتواند با NCP ارتباط برقرار کند (به NCP پیام بفرستد) NCP را (به عنوان مثال، یک ماشه خارجی مانند یک وقفه) "poke" کند. مکانیسم "poke" توسط کد پلت فرم (بر اساس رابط NCP با میزبان) تعیین می شود.

در حالی که وضعیت برق روی LOW_POWER تنظیم شده است، NCP همچنان می‌تواند (در هر زمانی) پیام‌هایی را به میزبان ارسال کند. توجه داشته باشید که دریافت یک پیام از NCP نشان نمی‌دهد که وضعیت قدرت NCP تغییر کرده است، به عنوان مثال، انتظار می‌رود میزبان زمانی که می‌خواهد با NCP صحبت کند تا زمانی که وضعیت قدرت صراحتاً تغییر نکند (با یک تماس موفق) به "poke" ادامه دهد. به otPlatSetMcuPowerState() تغییر وضعیت به ON ).

OT_PLAT_MCU_POWER_STATE_OFF

NCP کاملاً خاموش است.

برای بازگرداندن NCP به SPINEL_MCU_POWER_STATE_ON ، یک بازنشانی سخت افزاری NCP (از طریق پین RESET) لازم است. RAM پس از تنظیم مجدد حفظ نمی شود.

OT_PLAT_MCU_POWER_STATE_ON

MCU NCP همیشه روشن و فعال می ماند.

هنگامی که حالت برق مورد نظر NCP روی ON تنظیم می شود، میزبان می تواند پیام هایی را بدون نیاز به "poke" یا محرک های خارجی به NCP ارسال کند.

otPlatResetReason

 otPlatResetReason

شمارش کدهای دلیل بازنشانی احتمالی

اینها به ترتیب کدهای دلیل بازنشانی Spinel هستند.

کارکرد

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

یک پلتفرم پیاده سازی خاص را برای ادعا فراهم می کند.

جزئیات
مولفه های
[in] aFilename
نام فایلی که ادعا در آن رخ داده است.
[in] aLineNumber
شماره خط در فایلی که ادعا در آن صورت گرفته است.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

وضعیت فعلی توان MCU مورد نظر را دریافت می کند.

این فقط زمانی که OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL فعال باشد برای پیکربندی NCP کاربرد دارد و استفاده می‌شود.

پس از تنظیم مجدد، وضعیت برق باید 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.

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

در صورت پشتیبانی، یک بازنشانی سخت‌افزاری روی پلتفرم برای راه‌اندازی حالت بوت‌لودر انجام می‌دهد.

زمانی استفاده می‌شود که OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE فعال باشد.

جزئیات
مولفه های
[in] aInstance
ساختار نمونه OpenThread.
ارزش های بازگشتی
OT_ERROR_NONE
بازنشانی به بوت لودر با موفقیت انجام شد.
OT_ERROR_BUSY
به دلیل یک عملیات دیگر شکست خورده است.
OT_ERROR_NOT_CAPABLE
قادر به بازنشانی به بوت لودر نیست.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

حالت توان MCU مورد نظر را تنظیم می کند.

این فقط زمانی که OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL فعال باشد برای پیکربندی NCP کاربرد دارد و استفاده می‌شود.

جزئیات
مولفه های
[in] aInstance
اشاره گر به نمونه OpenThread.
[in] aState
وضعیت برق جدید MCU.
ارزش های بازگشتی
OT_ERROR_NONE
وضعیت برق با موفقیت به روز شد.
OT_ERROR_FAILED
حالت توان MCU داده شده توسط پلت فرم پشتیبانی نمی شود.

otPlatWakeHost

void otPlatWakeHost(
  void
)

یک عملیات خاص پلت فرم را برای بیدار کردن MCU میزبان انجام می دهد.

این فقط برای تنظیمات NCP استفاده می شود.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.