Khác

Mô-đun này bao gồm các mô-đun trừu tượng trên nền tảng dành cho các hành vi khác.

Tóm tắt

Bảng liệt kê
otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
} 		enum
Bảng liệt kê trạng thái nguồn của bộ vi điều khiển.
otPlatResetReason enum
Bảng liệt kê các mã lý do có thể đặt lại.

Hàm
otPlatAssertFail(const char *aFilename, int aLineNumber)
void
Cung cấp phương thức triển khai dành riêng cho nền tảng để xác nhận.
otPlatGetMcuPowerState(otInstance *aInstance)
Nhận trạng thái nguồn MCU hiện tại mong muốn.
otPlatGetResetReason(otInstance *aInstance)
Trả về lý do đặt lại nền tảng gần đây nhất.
otPlatReset(otInstance *aInstance)
void
Thực hiện đặt lại phần mềm trên nền tảng nếu được hỗ trợ.
otPlatResetToBootloader(otInstance *aInstance)
Thực hiện đặt lại phần cứng trên nền tảng để chạy chế độ trình tải khởi động (nếu được hỗ trợ).
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
Đặt trạng thái nguồn MCU mong muốn.
otPlatWakeHost(void)
void
Thực hiện một thao tác dành riêng cho nền tảng để đánh thức MCU máy chủ.

Bảng liệt kê

otPlatMcuPowerState

 otPlatMcuPowerState

Bảng liệt kê trạng thái nguồn của bộ vi điều khiển.

Các giá trị này được dùng cho cấu hình NCP khi bạn bật OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Trạng thái nguồn chỉ định trạng thái nguồn mong muốn của bộ vi điều khiển (MCU) của NCP khi hệ điều hành của nền tảng cơ bản chuyển sang chế độ rảnh (tức là tất cả tác vụ/sự kiện đang hoạt động đều được xử lý và MCU có khả năng chuyển sang trạng thái tiết kiệm năng lượng).

Trạng thái nguồn chủ yếu xác định cách máy chủ tương tác với NCP và liệu máy chủ có cần điều kiện kích hoạt bên ngoài ("cắm") với NCP hay không trước khi có thể giao tiếp với NCP hay không.

Sau khi đặt lại, trạng thái nguồn của MCU PHẢI là OT_PLAT_POWER_STATE_ON.

Thuộc tính
OT_PLAT_MCU_POWER_STATE_LOW_POWER

MCU của NCP có thể chuyển sang trạng thái tiết kiệm năng lượng (tiết kiệm năng lượng).

Khi trạng thái nguồn mong muốn của NCP được đặt thành LOW_POWER, máy chủ lưu trữ dự kiến sẽ "cắt" NCP (ví dụ: một trình kích hoạt bên ngoài như một ngắt) trước khi có thể giao tiếp với NCP (gửi thông báo tới NCP). Cơ chế "chọi" được xác định bằng mã nền tảng (dựa trên giao diện NCP đối với máy chủ).

Khi trạng thái nguồn được đặt thành LOW_POWER, NCP vẫn có thể gửi thông báo đến máy chủ bất cứ lúc nào. Lưu ý rằng việc nhận thông báo từ NCP KHÔNG cho biết trạng thái nguồn của NCP đã thay đổi, tức là máy chủ dự kiến sẽ tiếp tục "chọc" khi muốn trao đổi với NCP cho đến khi trạng thái nguồn được thay đổi rõ ràng (bằng lệnh gọi thành công đến otPlatSetMcuPowerState() thay đổi trạng thái thành ON).
OT_PLAT_MCU_POWER_STATE_OFF

NCP đã tắt hoàn toàn.

Bạn cần đặt lại phần cứng NCP (thông qua mã PIN Reset (Đặt lại)) để đưa NCP trở lại SPINEL_MCU_POWER_STATE_ON. RAM không được giữ lại sau khi đặt lại.

OT_PLAT_MCU_POWER_STATE_ON

MCU của NCP luôn bật và hoạt động.

Khi bạn đặt trạng thái nguồn mong muốn của NCP thành ON, máy chủ lưu trữ có thể gửi thông báo đến NCP mà không cần đến lệnh "chọi" hoặc điều kiện kích hoạt bên ngoài nào.

otPlatResetReason

 otPlatResetReason

Bảng liệt kê các mã lý do có thể đặt lại.

Các mã này theo cùng thứ tự với các mã lý do đặt lại Spinel.

Hàm

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Cung cấp phương thức triển khai dành riêng cho nền tảng để xác nhận.

Thông tin chi tiết
Thông số
[in] aFilename
Tên của tệp nơi xảy ra xác nhận.
[in] aLineNumber
Số dòng trong tệp nơi xuất hiện xác nhận.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Nhận trạng thái nguồn MCU hiện tại mong muốn.

Cách này chỉ áp dụng và dùng cho cấu hình NCP khi bạn bật OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Sau khi đặt lại, trạng thái nguồn PHẢI trả về OT_PLAT_POWER_STATE_ON. Trong quá trình vận hành, trạng thái nguồn NÊN chỉ thay đổi thông qua lệnh gọi thành công rõ ràng đến otPlatSetMcuPowerState().

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến thực thể OpenThread.
Trả về
Trạng thái nguồn hiện tại.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Trả về lý do đặt lại nền tảng gần đây nhất.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

Thực hiện đặt lại phần mềm trên nền tảng nếu được hỗ trợ.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

Thực hiện đặt lại phần cứng trên nền tảng để chạy chế độ trình tải khởi động (nếu được hỗ trợ).

Được dùng khi bạn bật OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
Giá trị trả về
OT_ERROR_NONE
Đặt lại thành công về trình tải khởi động.
OT_ERROR_BUSY
Không thành công do có một hoạt động khác đang diễn ra.
OT_ERROR_NOT_CAPABLE
Không thể đặt lại về trình tải khởi động.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Đặt trạng thái nguồn MCU mong muốn.

Cách này chỉ áp dụng và dùng cho cấu hình NCP khi bạn bật OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến thực thể OpenThread.
[in] aState
Trạng thái nguồn mới của MCU.
Giá trị trả về
OT_ERROR_NONE
Đã cập nhật thành công trạng thái nguồn.
OT_ERROR_FAILED
Nền tảng không hỗ trợ trạng thái nguồn MCU đã cho.

otPlatWakeHost

void otPlatWakeHost(
  void
)

Thực hiện một thao tác dành riêng cho nền tảng để đánh thức MCU máy chủ.

Thông số này chỉ được dùng cho cấu hình NCP.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.