Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Cài đặt

Mô-đun này bao gồm sự trừu tượng hóa nền tảng để lưu trữ cài đặt không bay hơi.

Tóm lược

Chức năng

otPlatSettingsAdd ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength)
Thêm giá trị vào cài đặt.
otPlatSettingsDeinit ( otInstance *aInstance)
void
Thực hiện bất kỳ khởi tạo nào cho hệ thống con cài đặt, nếu cần.
otPlatSettingsDelete ( otInstance *aInstance, uint16_t aKey, int aIndex)
Xóa cài đặt khỏi kho cài đặt.
otPlatSettingsGet ( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength)
Tìm nạp giá trị của một cài đặt.
otPlatSettingsInit ( otInstance *aInstance)
void
Thực hiện bất kỳ khởi tạo nào cho hệ thống con cài đặt, nếu cần.
otPlatSettingsSet ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength)
Đặt hoặc thay thế giá trị của một cài đặt.
otPlatSettingsWipe ( otInstance *aInstance)
void
Xóa tất cả cài đặt khỏi cửa hàng cài đặt.

Chức năng

otPlatSettingsAdd

otError otPlatSettingsAdd(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

Thêm giá trị vào cài đặt.

Hàm này thêm giá trị vào cài đặt được xác định bởi aKey, mà không thay thế bất kỳ giá trị hiện có nào.

Lưu ý rằng việc triển khai cơ bản không bắt buộc phải duy trì thứ tự của các mục được liên kết với một khóa cụ thể. Giá trị gia tăng có thể được thêm vào phần cuối, phần đầu, hoặc thậm chí ở đâu đó ở giữa. Thứ tự của mọi giá trị tồn tại từ trước cũng có thể thay đổi.

Việc gọi hàm này thành công có thể khiến các cài đặt không liên quan với nhiều giá trị được sắp xếp lại.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.
[in] aKey
Khóa liên quan đến cài đặt để thay đổi.
[in] aValue
Một con trỏ đến giá trị mới của cài đặt sẽ được đọc từ đó. KHÔNG ĐƯỢC NULL nếu aValueLength khác 0.
[in] aValueLength
Độ dài của dữ liệu được trỏ tới bởi aValue. Có thể bằng không.
Giá trị trả lại
OT_ERROR_NONE
Cài đặt đã cho đã được thêm vào hoặc theo giai đoạn để được thêm vào.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai trên nền tảng này.
OT_ERROR_NO_BUFS
Không còn dung lượng để lưu cài đặt đã cho.

otPlatSettingsDeinit

void otPlatSettingsDeinit(
  otInstance *aInstance
)

Thực hiện bất kỳ khởi tạo nào cho hệ thống con cài đặt, nếu cần.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.

otPlatSettingsDelete

otError otPlatSettingsDelete(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex
)

Xóa cài đặt khỏi kho cài đặt.

Chức năng này xóa một giá trị cụ thể khỏi cài đặt được xác định bởi aKey khỏi cửa hàng cài đặt.

Lưu ý rằng việc triển khai cơ bản không bắt buộc phải duy trì thứ tự của các mục được liên kết với một khóa cụ thể.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.
[in] aKey
Khóa liên quan đến cài đặt được yêu cầu.
[in] aIndex
Chỉ mục của giá trị được xóa. Nếu được đặt thành -1, tất cả các giá trị cho aKey này sẽ bị xóa.
Giá trị trả lại
OT_ERROR_NONE
Khoá và chỉ mục đã cho đã được tìm thấy và xoá thành công.
OT_ERROR_NOT_FOUND
Không tìm thấy khóa hoặc chỉ mục đã cho trong kho cài đặt.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai trên nền tảng này.

otPlatSettingsGet

otError otPlatSettingsGet(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex,
  uint8_t *aValue,
  uint16_t *aValueLength
)

Tìm nạp giá trị của một cài đặt.

Hàm này tìm nạp giá trị của cài đặt được xác định bởi aKey và ghi nó vào bộ nhớ được aValue trỏ tới. Sau đó, nó ghi độ dài vào số nguyên được trỏ tới bởi aValueLength. Giá trị ban đầu của aValueLength là số byte tối đa được ghi vào aValue.

Hàm này có thể được sử dụng để kiểm tra sự tồn tại của khóa mà không cần tìm nạp giá trị bằng cách đặt aValue và aValueLength thành NULL. Bạn cũng có thể kiểm tra độ dài của cài đặt mà không cần tìm nạp bằng cách chỉ đặt aValue thành NULL.

Lưu ý rằng việc triển khai bộ nhớ cơ bản là không bắt buộc để duy trì thứ tự cài đặt có nhiều giá trị. Thứ tự của các giá trị đó CÓ THỂ thay đổi sau BẤT CỨ thao tác ghi vào cửa hàng.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.
[in] aKey
Khóa liên quan đến cài đặt được yêu cầu.
[in] aIndex
Chỉ số của mặt hàng cụ thể để lấy.
[out] aValue
Một con trỏ đến nơi ghi giá trị của cài đặt. Có thể được đặt thành NULL nếu chỉ kiểm tra sự hiện diện hoặc độ dài của cài đặt.
[in,out] aValueLength
Một con trỏ đến độ dài của giá trị. Khi được gọi, con trỏ này sẽ trỏ đến một số nguyên chứa kích thước giá trị lớn nhất có thể được ghi vào aValue. Đổi lại, độ dài thực của cài đặt được ghi. Điều này có thể được đặt thành NULL nếu thực hiện kiểm tra sự hiện diện.
Giá trị trả lại
OT_ERROR_NONE
Cài đặt đã cho đã được tìm thấy và tìm nạp thành công.
OT_ERROR_NOT_FOUND
Không tìm thấy cài đặt đã cho trong cửa hàng cài đặt.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai trên nền tảng này.

otPlatSettingsInit

void otPlatSettingsInit(
  otInstance *aInstance
)

Thực hiện bất kỳ khởi tạo nào cho hệ thống con cài đặt, nếu cần.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.

otPlatSettingsSet

otError otPlatSettingsSet(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

Đặt hoặc thay thế giá trị của một cài đặt.

Hàm này đặt hoặc thay thế giá trị của một cài đặt được xác định bởi aKey. Nếu trước đó có nhiều hơn một giá trị được liên kết với aKey, thì tất cả chúng sẽ bị xóa và thay thế bằng mục nhập duy nhất này.

Việc gọi hàm này thành công có thể khiến các cài đặt không liên quan với nhiều giá trị được sắp xếp lại.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.
[in] aKey
Khóa liên quan đến cài đặt để thay đổi.
[in] aValue
Một con trỏ đến giá trị mới của cài đặt sẽ được đọc từ đó. KHÔNG ĐƯỢC NULL nếu aValueLength khác 0.
[in] aValueLength
Độ dài của dữ liệu được trỏ tới bởi aValue. Có thể bằng không.
Giá trị trả lại
OT_ERROR_NONE
Cài đặt nhất định đã được thay đổi hoặc theo giai đoạn.
OT_ERROR_NOT_IMPLEMENTED
Chức năng này không được triển khai trên nền tảng này.
OT_ERROR_NO_BUFS
Không còn dung lượng để lưu cài đặt đã cho.

otPlatSettingsWipe

void otPlatSettingsWipe(
  otInstance *aInstance
)

Xóa tất cả cài đặt khỏi kho cài đặt.

Chức năng này xóa tất cả các cài đặt khỏi kho cài đặt, đưa nó về trạng thái ban đầu.

Chi tiết
Thông số
[in] aInstance
Cấu trúc phiên bản OpenThread.