หน้านี้ได้รับการแปลโดย Cloud Translation API

เบ็ดเตล็ด

โมดูลนี้ประกอบด้วยแพลตฟอร์มสำหรับพฤติกรรมอื่นๆ

สรุป

การแจกแจง
`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)`	`otPlatMcuPowerState` รับสถานะพลังงาน MCU ที่ต้องการในปัจจุบัน
`otPlatGetResetReason(otInstance *aInstance)`	`otPlatResetReason` แสดงเหตุผลสำหรับการรีเซ็ตแพลตฟอร์มครั้งล่าสุด
`otPlatReset(otInstance *aInstance)`	`void` รีเซ็ตซอฟต์แวร์บนแพลตฟอร์ม หากรองรับ
`otPlatResetToBootloader(otInstance *aInstance)`	`otError` รีเซ็ตฮาร์ดแวร์บนแพลตฟอร์มเพื่อเปิดโหมด Bootloader หากรองรับ
`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 เป็นหลัก และโฮสต์จำเป็นต้องทริกเกอร์ภายนอก ("poke") ไปยัง NCP ก่อนที่จะสื่อสารกับ NCP หรือไม่

หลังจากรีเซ็ต สถานะพลังงานของ MCU ต้องเป็น OT_PLAT_POWER_STATE_ON

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	MCU ของ NCP สามารถเข้าสู่สถานะการใช้พลังงานต่ำ (ประหยัดพลังงาน) เมื่อตั้งค่าสถานะพลังงานที่ต้องการของ NCP เป็น `LOW_POWER` โฮสต์จะต้อง "แหย่" NCP (เช่น ทริกเกอร์ภายนอก เช่น การรบกวน) ก่อนที่จะสื่อสารกับ NCP ได้ (ส่งข้อความไปยัง NCP) กลไก "poke" จะกำหนดโดยโค้ดแพลตฟอร์ม (ขึ้นอยู่กับอินเทอร์เฟซของ NCP กับโฮสต์) ในขณะที่สถานะพลังงานตั้งค่าเป็น `LOW_POWER` NCP จะยังคงสามารถส่งข้อความไปยังโฮสต์ได้ (เมื่อใดก็ได้) โปรดทราบว่าการรับข้อความจาก NCP ไม่ได้ระบุว่าสถานะพลังงานของ NCP มีการเปลี่ยนแปลง กล่าวคือ โฮสต์จะต้อง "จิ๊ก" ต่อไปเมื่อต้องการพูดคุยกับ NCP จนกว่าจะมีการเปลี่ยนสถานะพลังงานอย่างชัดเจน (จากการเรียก `otPlatSetMcuPowerState()` ได้สำเร็จและเปลี่ยนสถานะเป็น `ON`) หมายเหตุ: สถานะพลังงานของ `LOW_POWER` จะเป็นตัวกำหนดโหมดพลังงานของ MCU เท่านั้น และไม่เกี่ยวข้องกับสถานะของวิทยุ (วิทยุได้รับการจัดการโดยบทบาทหลักและบทบาทของอุปกรณ์ของ OpenThread เช่น อุปกรณ์ง่วงอยู่หรือไม่)
`OT_PLAT_MCU_POWER_STATE_OFF`	NCP ปิดอยู่โดยสมบูรณ์ ต้องรีเซ็ตฮาร์ดแวร์ NCP (ผ่าน PIN รีเซ็ต) เพื่อนำ NCP กลับไปยัง `SPINEL_MCU_POWER_STATE_ON` ไม่เก็บรักษา RAM ไว้หลังจากรีเซ็ต
`OT_PLAT_MCU_POWER_STATE_ON`	MCU ของ NCP จะเปิดและทำงานอยู่ตลอดเวลา เมื่อตั้งค่าสถานะพลังงานที่ต้องการของ NCP เป็น `ON` โฮสต์จะส่งข้อความไปยัง NCP ได้โดยไม่ต้องมี "poke" หรือทริกเกอร์ภายนอกใดๆ หมายเหตุ: สถานะพลังงานของ `ON` จะเป็นตัวกำหนดโหมดพลังงานของ MCU เท่านั้น และไม่เกี่ยวข้องกับสถานะของวิทยุ

OT_PLAT_MCU_POWER_STATE_LOW_POWER

MCU ของ NCP สามารถเข้าสู่สถานะการใช้พลังงานต่ำ (ประหยัดพลังงาน)

เมื่อตั้งค่าสถานะพลังงานที่ต้องการของ NCP เป็น LOW_POWER โฮสต์จะต้อง "แหย่" NCP (เช่น ทริกเกอร์ภายนอก เช่น การรบกวน) ก่อนที่จะสื่อสารกับ NCP ได้ (ส่งข้อความไปยัง NCP) กลไก "poke" จะกำหนดโดยโค้ดแพลตฟอร์ม (ขึ้นอยู่กับอินเทอร์เฟซของ NCP กับโฮสต์)

ในขณะที่สถานะพลังงานตั้งค่าเป็น LOW_POWER NCP จะยังคงสามารถส่งข้อความไปยังโฮสต์ได้ (เมื่อใดก็ได้) โปรดทราบว่าการรับข้อความจาก NCP ไม่ได้ระบุว่าสถานะพลังงานของ NCP มีการเปลี่ยนแปลง กล่าวคือ โฮสต์จะต้อง "จิ๊ก" ต่อไปเมื่อต้องการพูดคุยกับ NCP จนกว่าจะมีการเปลี่ยนสถานะพลังงานอย่างชัดเจน (จากการเรียก otPlatSetMcuPowerState() ได้สำเร็จและเปลี่ยนสถานะเป็น ON)

หมายเหตุ: สถานะพลังงานของ LOW_POWER จะเป็นตัวกำหนดโหมดพลังงานของ MCU เท่านั้น และไม่เกี่ยวข้องกับสถานะของวิทยุ (วิทยุได้รับการจัดการโดยบทบาทหลักและบทบาทของอุปกรณ์ของ OpenThread เช่น อุปกรณ์ง่วงอยู่หรือไม่)

OT_PLAT_MCU_POWER_STATE_OFF

NCP ปิดอยู่โดยสมบูรณ์

ต้องรีเซ็ตฮาร์ดแวร์ NCP (ผ่าน PIN รีเซ็ต) เพื่อนำ NCP กลับไปยัง SPINEL_MCU_POWER_STATE_ON ไม่เก็บรักษา RAM ไว้หลังจากรีเซ็ต

OT_PLAT_MCU_POWER_STATE_ON

MCU ของ NCP จะเปิดและทำงานอยู่ตลอดเวลา

เมื่อตั้งค่าสถานะพลังงานที่ต้องการของ NCP เป็น ON โฮสต์จะส่งข้อความไปยัง NCP ได้โดยไม่ต้องมี "poke" หรือทริกเกอร์ภายนอกใดๆ

หมายเหตุ: สถานะพลังงานของ ON จะเป็นตัวกำหนดโหมดพลังงานของ MCU เท่านั้น และไม่เกี่ยวข้องกับสถานะของวิทยุ

otPlatResetReason

 otPlatResetReason

การแจกแจงรหัสเหตุผลที่รีเซ็ตที่เป็นไปได้

ซึ่งจะเรียงลําดับเดียวกับรหัสเหตุผลในการรีเซ็ต Spinel

ฟังก์ชัน

otPlatAssertFail

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 ในระหว่างการดำเนินการ สถานะพลังงานควรเปลี่ยนผ่านการเรียกใช้ 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
)

รีเซ็ตฮาร์ดแวร์บนแพลตฟอร์มเพื่อเปิดโหมด Bootloader หากรองรับ

ใช้เมื่อเปิดใช้ OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE

รายละเอียด

พารามิเตอร์

[in] aInstance

โครงสร้างอินสแตนซ์ OpenThread

แสดงผลค่า

`OT_ERROR_NONE`	รีเซ็ตเป็น Bootloader เรียบร้อยแล้ว
`OT_ERROR_BUSY`	ล้มเหลวเนื่องจากมีการดำเนินการอื่นที่กำลังดำเนินอยู่
`OT_ERROR_NOT_CAPABLE`	ไม่สามารถรีเซ็ตเป็น Bootloader

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

ตั้งค่าสถานะพลังงาน MCU ที่ต้องการ

รายละเอียด

พารามิเตอร์

`[in] aInstance`	ตัวชี้ไปยังอินสแตนซ์ OpenThread
`[in] aState`	สถานะพลังงานของ MCU ใหม่

แสดงผลค่า

`OT_ERROR_NONE`	อัปเดตสถานะพลังงานเรียบร้อยแล้ว
`OT_ERROR_FAILED`	แพลตฟอร์มไม่รองรับสถานะพลังงาน MCU ที่ระบุ

otPlatWakeHost

void otPlatWakeHost(
  void
)

ดำเนินการเฉพาะแพลตฟอร์มเพื่อปลุกระบบ MCU ของโฮสต์

ใช้เฉพาะสำหรับการกำหนดค่า NCP เท่านั้น

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล