Chẩn đoán ban đầu – Nền tảng

Mô-đun này bao gồm bản tóm tắt nền tảng cho các tính năng chẩn đoán.

Tóm tắt

Bảng liệt kê

otGpioMode{
  OT_GPIO_MODE_INPUT = 0,
  OT_GPIO_MODE_OUTPUT = 1
}
enum
Xác định các chế độ gpio.

Hàm

otPlatDiagAlarmCallback(otInstance *aInstance)
void
Xử lý sự kiện chuông báo.
otPlatDiagChannelSet(uint8_t aChannel)
void
Đặt kênh để sử dụng cho thông tin chẩn đoán ban đầu.
otPlatDiagGpioGet(uint32_t aGpio, bool *aValue)
Nhận giá trị gpio.
otPlatDiagGpioGetMode(uint32_t aGpio, otGpioMode *aMode)
Tải chế độ gpio.
otPlatDiagGpioSet(uint32_t aGpio, bool aValue)
Đặt giá trị gpio.
otPlatDiagGpioSetMode(uint32_t aGpio, otGpioMode aMode)
Đặt chế độ gpio.
otPlatDiagModeGet(void)
bool
Cho biết liệu chế độ chẩn đoán gốc có được bật hay không.
otPlatDiagModeSet(bool aMode)
void
Bật/tắt chế độ chẩn đoán ban đầu.
otPlatDiagProcess(otInstance *aInstance, uint8_t aArgsLength, char *aArgs[], char *aOutput, size_t aOutputMaxLen)
Xử lý một dòng lệnh chẩn đoán ban đầu.
otPlatDiagRadioGetPowerSettings(otInstance *aInstance, uint8_t aChannel, int16_t *aTargetPower, int16_t *aActualPower, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
Xem chế độ cài đặt nguồn cho kênh cụ thể.
otPlatDiagRadioGetRawPowerSetting(otInstance *aInstance, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
Nhận chế độ cài đặt nguồn thô đài phát cho mô-đun chẩn đoán.
otPlatDiagRadioRawPowerSettingEnable(otInstance *aInstance, bool aEnable)
Bật/tắt lớp nền tảng để sử dụng chế độ cài đặt nguồn thô do otPlatDiagRadioSetRawPowerSetting() đặt.
otPlatDiagRadioReceived(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
void
Xử lý khung vô tuyến đã nhận.
otPlatDiagRadioSetRawPowerSetting(otInstance *aInstance, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)
Đặt chế độ cài đặt nguồn thô đài phát cho mô-đun chẩn đoán.
otPlatDiagRadioTransmitCarrier(otInstance *aInstance, bool aEnable)
Bắt đầu/dừng lớp nền tảng để truyền sóng sóng mang liên tục.
otPlatDiagRadioTransmitStream(otInstance *aInstance, bool aEnable)
Bắt đầu/dừng lớp nền tảng để truyền luồng ký tự.
otPlatDiagTxPowerSet(int8_t aTxPower)
void
Đặt công suất truyền để dùng cho chẩn đoán ban đầu.

Bảng liệt kê

otGpioMode

 otGpioMode

Xác định các chế độ gpio.

Thuộc tính
OT_GPIO_MODE_INPUT

Chế độ nhập không có điện trở kéo.

OT_GPIO_MODE_OUTPUT

Chế độ đầu ra.

Hàm

otPlatDiagAlarmCallback

void otPlatDiagAlarmCallback(
  otInstance *aInstance
)

Xử lý sự kiện chuông báo.

Thông tin chi tiết
Các tham số
[in] aInstance
Thực thể OpenThread cho yêu cầu hiện tại.

otPlatDiagChannelSet

void otPlatDiagChannelSet(
  uint8_t aChannel
)

Đặt kênh để sử dụng cho thông tin chẩn đoán ban đầu.

Thông tin chi tiết
Các tham số
[in] aChannel
Giá trị của kênh.

otPlatDiagGpioGet

otError otPlatDiagGpioGet(
  uint32_t aGpio,
  bool *aValue
)

Nhận giá trị gpio.

Thông tin chi tiết
Các tham số
[in] aGpio
Số gpio.
[out] aValue
Một con trỏ nơi đặt giá trị gpio.
Giá trị trả về
OT_ERROR_NONE
Đã nhận thành công giá trị gpio.
OT_ERROR_FAILED
Đã xảy ra lỗi nền tảng khi nhận giá trị gpio.
OT_ERROR_INVALID_ARGS
aGpio không được hỗ trợ hoặc aValue là NULL.
OT_ERROR_INVALID_STATE
Bạn chưa bật chế độ chẩn đoán hoặc chưa định cấu hình aGpio làm dữ liệu đầu vào.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai hoặc định cấu hình trên nền tảng.

otPlatDiagGpioGetMode

otError otPlatDiagGpioGetMode(
  uint32_t aGpio,
  otGpioMode *aMode
)

Tải chế độ gpio.

Thông tin chi tiết
Các tham số
[in] aGpio
Số gpio.
[out] aMode
Một con trỏ nơi đặt chế độ gpio.
Giá trị trả về
OT_ERROR_NONE
Đã tải thành công chế độ gpio.
OT_ERROR_FAILED
Chế độ mà nền tảng trả về không được triển khai trong OpenThread hoặc đã xảy ra lỗi nền tảng khi tải chế độ gpio.
OT_ERROR_INVALID_ARGS
aGpio không được hỗ trợ hoặc aMode là NULL.
OT_ERROR_INVALID_STATE
Chế độ chẩn đoán chưa được bật.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai hoặc định cấu hình trên nền tảng.

otPlatDiagGpioSet

otError otPlatDiagGpioSet(
  uint32_t aGpio,
  bool aValue
)

Đặt giá trị gpio.

Thông tin chi tiết
Các tham số
[in] aGpio
Số gpio.
[in] aValue
giá trị true (đúng) để đặt gpio thành mức cao hoặc false (sai) nếu không.
Giá trị trả về
OT_ERROR_NONE
Đã đặt gpio thành công.
OT_ERROR_FAILED
Đã xảy ra lỗi nền tảng khi đặt gpio.
OT_ERROR_INVALID_ARGS
aGpio không được hỗ trợ.
OT_ERROR_INVALID_STATE
Chưa bật chế độ chẩn đoán hoặc aGpio chưa được định cấu hình làm kết quả.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai hoặc định cấu hình trên nền tảng.

otPlatDiagGpioSetMode

otError otPlatDiagGpioSetMode(
  uint32_t aGpio,
  otGpioMode aMode
)

Đặt chế độ gpio.

Thông tin chi tiết
Các tham số
[in] aGpio
Số gpio.
[out] aMode
Chế độ gpio.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công chế độ gpio.
OT_ERROR_FAILED
Đã xảy ra lỗi nền tảng khi đặt chế độ gpio.
OT_ERROR_INVALID_ARGS
aGpio hoặc aMode không được hỗ trợ.
OT_ERROR_INVALID_STATE
Chế độ chẩn đoán chưa được bật.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai hoặc định cấu hình trên nền tảng.

otPlatDiagModeGet

bool otPlatDiagModeGet(
  void
)

Cho biết liệu chế độ chẩn đoán gốc có được bật hay không.

Thông tin chi tiết
Trả về
TRUE nếu chế độ chẩn đoán ban đầu được bật, nếu không thì là FALSE.

otPlatDiagModeSet

void otPlatDiagModeSet(
  bool aMode
)

Bật/tắt chế độ chẩn đoán ban đầu.

Thông tin chi tiết
Các tham số
[in] aMode
TRUE để bật chế độ chẩn đoán, nếu không sẽ là FALSE.

otPlatDiagProcess

otError otPlatDiagProcess(
  otInstance *aInstance,
  uint8_t aArgsLength,
  char *aArgs[],
  char *aOutput,
  size_t aOutputMaxLen
)

Xử lý một dòng lệnh chẩn đoán ban đầu.

Đầu ra của hàm này (nội dung được ghi vào aOutput) PHẢI kết thúc bằng \0\0 nằm trong vùng đệm đầu ra.

Thông tin chi tiết
Các tham số
[in] aInstance
Thực thể OpenThread cho yêu cầu hiện tại.
[in] aArgsLength
Số lượng đối số trong aArgs.
[in] aArgs
Đối số của dòng lệnh chẩn đoán.
[out] aOutput
Kết quả thực thi chẩn đoán.
[in] aOutputMaxLen
Dung lượng bộ nhớ đệm đầu ra.
Giá trị trả về
OT_ERROR_INVALID_ARGS
Lệnh này được hỗ trợ nhưng cung cấp các đối số không hợp lệ.
OT_ERROR_NONE
Lệnh được xử lý thành công.
OT_ERROR_INVALID_COMMAND
Lệnh không hợp lệ hoặc không được hỗ trợ.

otPlatDiagRadioGetPowerSettings

otError otPlatDiagRadioGetPowerSettings(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t *aTargetPower,
  int16_t *aActualPower,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

Xem chế độ cài đặt nguồn cho kênh cụ thể.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aChannel
Kênh phát thanh.
[out] aTargetPower
Công suất mục tiêu tính bằng 0,01 dBm.
[out] aActualPower
Công suất thực tế tính bằng 0,01 dBm.
[out] aRawPowerSetting
Con trỏ đến mảng byte cài đặt nguồn thô.
[in,out] aRawPowerSettingLength
Khi nhập, một con trỏ tới kích thước aRawPowerSetting. Trên dữ liệu đầu ra, con trỏ đến độ dài của dữ liệu cài đặt nguồn thô.
Giá trị trả về
OT_ERROR_NONE
Đã nhận được năng lượng mục tiêu.
OT_ERROR_INVALID_ARGS
aChannel không hợp lệ, , aActualPower, aRawPowerSetting hoặc aRawPowerSettingLength là NULL hoặc quá ngắn.
OT_ERROR_NOT_FOUND
Không tìm thấy chế độ cài đặt nguồn cho aChannel.
OT_ERROR_NOT_IMPLEMENTED
Phương thức này không được triển khai.

otPlatDiagRadioGetRawPowerSetting

otError otPlatDiagRadioGetRawPowerSetting(
  otInstance *aInstance,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

Nhận chế độ cài đặt nguồn thô đài phát cho mô-đun chẩn đoán.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[out] aRawPowerSetting
Con trỏ đến mảng byte cài đặt nguồn thô.
[in,out] aRawPowerSettingLength
Khi nhập, một con trỏ tới kích thước aRawPowerSetting. Trên dữ liệu đầu ra, con trỏ đến độ dài của dữ liệu cài đặt nguồn thô.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công chế độ cài đặt nguồn thô.
OT_ERROR_INVALID_ARGS
aRawPowerSetting hoặc aRawPowerSettingLength là NULL hoặc quá ngắn.
OT_ERROR_NOT_FOUND
Chưa đặt chế độ cài đặt nguồn thô.
OT_ERROR_NOT_IMPLEMENTED
Phương thức này không được triển khai.

otPlatDiagRadioRawPowerSettingEnable

otError otPlatDiagRadioRawPowerSettingEnable(
  otInstance *aInstance,
  bool aEnable
)

Bật/tắt lớp nền tảng để sử dụng chế độ cài đặt nguồn thô do otPlatDiagRadioSetRawPowerSetting() đặt.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aEnable
TRUE để bật hoặc FALSE để tắt chế độ cài đặt nguồn thô.
Giá trị trả về
OT_ERROR_NONE
Bật/tắt thành công chế độ cài đặt nguồn thô.
OT_ERROR_NOT_IMPLEMENTED
Phương thức này không được triển khai.

otPlatDiagRadioReceived

void otPlatDiagRadioReceived(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otError aError
)

Xử lý khung vô tuyến đã nhận.

Thông tin chi tiết
Các tham số
[in] aInstance
Thực thể OpenThread cho yêu cầu hiện tại.
[in] aFrame
Khung vô tuyến đã nhận.
[in] aError
Trạng thái khung radio đã nhận.

otPlatDiagRadioSetRawPowerSetting

otError otPlatDiagRadioSetRawPowerSetting(
  otInstance *aInstance,
  const uint8_t *aRawPowerSetting,
  uint16_t aRawPowerSettingLength
)

Đặt chế độ cài đặt nguồn thô đài phát cho mô-đun chẩn đoán.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aRawPowerSetting
Con trỏ đến mảng byte cài đặt nguồn thô.
[in] aRawPowerSettingLength
Độ dài của aRawPowerSetting.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công chế độ cài đặt nguồn thô.
OT_ERROR_INVALID_ARGS
aRawPowerSetting là NULL hoặc aRawPowerSettingLength quá dài.
OT_ERROR_NOT_IMPLEMENTED
Phương thức này không được triển khai.

otPlatDiagRadioTransmitCarrier

otError otPlatDiagRadioTransmitCarrier(
  otInstance *aInstance,
  bool aEnable
)

Bắt đầu/dừng lớp nền tảng để truyền sóng sóng mang liên tục.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aEnable
TRUE để bật hoặc FALSE để vô hiệu hoá lớp nền tảng để truyền sóng sóng mang liên tục.
Giá trị trả về
OT_ERROR_NONE
Đã bật/tắt thành công .
OT_ERROR_INVALID_STATE
Đài không ở trạng thái Đang nhận.
OT_ERROR_NOT_IMPLEMENTED
Phương thức này không được triển khai.

otPlatDiagRadioTransmitStream

otError otPlatDiagRadioTransmitStream(
  otInstance *aInstance,
  bool aEnable
)

Bắt đầu/dừng lớp nền tảng để truyền luồng ký tự.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aEnable
TRUE để bật hoặc FALSE để tắt lớp nền tảng để truyền phát luồng.
Giá trị trả về
OT_ERROR_NONE
Đã bật/tắt thành công.
OT_ERROR_INVALID_STATE
Đài không ở trạng thái Đang nhận.
OT_ERROR_NOT_IMPLEMENTED
Hàm này không được triển khai.

otPlatDiagTxPowerSet

void otPlatDiagTxPowerSet(
  int8_t aTxPower
)

Đặt công suất truyền để dùng cho chẩn đoán ban đầu.

Thông tin chi tiết
Các tham số
[in] aTxPower
Giá trị công suất truyền.

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.