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

Thông điệp

Mô-đun này bao gồm các chức năng thao tác với bộ đệm tin nhắn OpenThread.

Tóm lược

Bảng kê

otMessagePriority {
OT_MESSAGE_PRIORITY_LOW = 0,
OT_MESSAGE_PRIORITY_NORMAL = 1,
OT_MESSAGE_PRIORITY_HIGH = 2
}
enum
Việc liệt kê này xác định các mức ưu tiên của thư OpenThread.

Typedefs

otBufferInfo typedef
struct otBufferInfo
Cấu trúc này đại diện cho thông tin bộ đệm tin nhắn.
otMessage typedef
struct otMessage
Cấu trúc này trỏ đến một bộ đệm tin nhắn OpenThread.
otMessagePriority typedef
Việc liệt kê này xác định các mức ưu tiên của thư OpenThread.
otMessageSettings typedef
Cấu trúc này đại diện cho một cài đặt tin nhắn.

Chức năng

otMessageAppend ( otMessage *aMessage, const void *aBuf, uint16_t aLength)
Nối các byte vào một tin nhắn.
otMessageFree ( otMessage *aMessage)
void
Giải phóng một bộ đệm tin nhắn được cấp phát.
otMessageGetBufferInfo ( otInstance *aInstance, otBufferInfo *aBufferInfo)
void
Nhận thông tin Bộ đệm tin nhắn.
otMessageGetLength (const otMessage *aMessage)
uint16_t
Nhận độ dài tin nhắn tính bằng byte.
otMessageGetOffset (const otMessage *aMessage)
uint16_t
Nhận phần bù tin nhắn theo byte.
otMessageGetRss (const otMessage *aMessage)
int8_t
Hàm này trả về RSS (cường độ tín hiệu đã nhận) trung bình được liên kết với tin nhắn.
otMessageIsLinkSecurityEnabled (const otMessage *aMessage)
bool
Chức năng này cho biết có hay không bật bảo mật liên kết cho tin nhắn.
otMessageQueueDequeue ( otMessageQueue *aQueue, otMessage *aMessage)
void
Hàm này loại bỏ một tin nhắn khỏi hàng đợi tin nhắn đã cho.
otMessageQueueEnqueue ( otMessageQueue *aQueue, otMessage *aMessage)
void
Hàm này thêm một tin nhắn vào cuối hàng đợi tin nhắn đã cho.
otMessageQueueEnqueueAtHead ( otMessageQueue *aQueue, otMessage *aMessage)
void
Hàm này thêm một tin nhắn ở đầu / phía trước của hàng đợi tin nhắn đã cho.
otMessageQueueGetHead ( otMessageQueue *aQueue)
Hàm này trả về một con trỏ đến thông báo ở đầu hàng đợi.
otMessageQueueGetNext ( otMessageQueue *aQueue, const otMessage *aMessage)
Hàm này trả về một con trỏ đến thông báo tiếp theo trong hàng đợi bằng cách lặp về phía trước (từ đầu đến đuôi).
otMessageQueueInit ( otMessageQueue *aQueue)
void
Khởi tạo hàng đợi tin nhắn.
otMessageRead (const otMessage *aMessage, uint16_t aOffset, void *aBuf, uint16_t aLength)
uint16_t
Đọc byte từ một tin nhắn.
otMessageSetDirectTransmission ( otMessage *aMessage, bool aEnabled)
void
Chức năng này đặt / buộc thông điệp được chuyển tiếp bằng cách sử dụng truyền trực tiếp.
otMessageSetLength ( otMessage *aMessage, uint16_t aLength)
Đặt độ dài tin nhắn theo byte.
otMessageSetOffset ( otMessage *aMessage, uint16_t aOffset)
void
Đặt độ lệch tin nhắn theo byte.
otMessageWrite ( otMessage *aMessage, uint16_t aOffset, const void *aBuf, uint16_t aLength)
int
Viết byte vào một tin nhắn.

Cấu trúc

otBufferInfo

Cấu trúc này đại diện cho thông tin bộ đệm thông báo.

otMessage

Cấu trúc này trỏ đến một bộ đệm tin nhắn OpenThread.

otMessageQueue

Cấu trúc này đại diện cho một hàng đợi tin nhắn OpenThread.

otMessageSettings

Cấu trúc này đại diện cho một cài đặt tin nhắn.

Bảng kê

otMessagePinent

 otMessagePriority

Việc liệt kê này xác định các mức ưu tiên của thư OpenThread.

Tính chất
OT_MESSAGE_PRIORITY_HIGH

Mức độ ưu tiên cao.

OT_MESSAGE_PRIORITY_LOW

Mức độ ưu tiên thấp.

OT_MESSAGE_PRIORITY_NORMAL

Mức độ ưu tiên bình thường.

Typedefs

otBufferInfo

struct otBufferInfo otBufferInfo

Cấu trúc này đại diện cho thông tin bộ đệm tin nhắn.

otMessage

struct otMessage otMessage

Cấu trúc này trỏ đến một bộ đệm tin nhắn OpenThread.

otMessagePinent

enum otMessagePriority otMessagePriority

Việc liệt kê này xác định các mức ưu tiên của thư OpenThread.

otMessageSettings

struct otMessageSettings otMessageSettings

Cấu trúc này đại diện cho một cài đặt tin nhắn.

Chức năng

otMessageAppend

otError otMessageAppend(
  otMessage *aMessage,
  const void *aBuf,
  uint16_t aLength
)

Nối các byte vào một tin nhắn.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aBuf
Một con trỏ đến dữ liệu để nối thêm.
[in] aLength
Số byte để nối thêm.
Giá trị trả lại
OT_ERROR_NONE
Đã nối thành công tin nhắn
OT_ERROR_NO_BUFS
Không có bộ đệm nào để phát triển thông điệp.
Xem thêm:
otMessageFree
otMessageGetLength
otMessageSetLength
otMessageGetOffset
otMessageSetOffset
otMessageRead
otMessageWrite

otMessageFree

void otMessageFree(
  otMessage *aMessage
)

Giải phóng một bộ đệm tin nhắn được cấp phát.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
Xem thêm:
otMessageAppend
otMessageGetLength
otMessageSetLength
otMessageGetOffset
otMessageSetOffset
otMessageRead
otMessageWrite

otMessageGetBufferInfo

void otMessageGetBufferInfo(
  otInstance *aInstance,
  otBufferInfo *aBufferInfo
)

Nhận thông tin Bộ đệm tin nhắn.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến phiên bản OpenThread.
[out] aBufferInfo
Một con trỏ nơi ghi thông tin bộ đệm thư.

otMessageGetLength

uint16_t otMessageGetLength(
  const otMessage *aMessage
)

Nhận độ dài tin nhắn tính bằng byte.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
Lợi nhuận
Độ dài tin nhắn tính bằng byte.
Xem thêm:
otMessageFree
otMessageAppend
otMessageSetLength
otMessageGetOffset
otMessageSetOffset
otMessageRead
otMessageWrite
otMessageSetLength

otMessageGetOffset

uint16_t otMessageGetOffset(
  const otMessage *aMessage
)

Nhận phần bù tin nhắn theo byte.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
Lợi nhuận
Giá trị bù thông báo.
Xem thêm:
otMessageFree
otMessageAppend
otMessageGetLength
otMessageSetLength
otMessageSetOffset
otMessageRead
otMessageWrite

otMessageGetRss

int8_t otMessageGetRss(
  const otMessage *aMessage
)

Hàm này trả về RSS (cường độ tín hiệu nhận được) trung bình được liên kết với tin nhắn.

Chi tiết
Lợi nhuận
Giá trị RSS trung bình (tính bằng dBm) hoặc OT_RADIO_RSSI_INVALID nếu không có sẵn RSS trung bình.

otMessageIsLinkSecurityEnabled

bool otMessageIsLinkSecurityEnabled(
  const otMessage *aMessage
)

Chức năng này cho biết có hay không bật bảo mật liên kết cho tin nhắn.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
Giá trị trả lại
TRUE
Nếu bảo mật liên kết được bật.
FALSE
Nếu bảo mật liên kết không được bật.

otMessageQueueDequeue

void otMessageQueueDequeue(
  otMessageQueue *aQueue,
  otMessage *aMessage
)

Hàm này loại bỏ một tin nhắn khỏi hàng đợi tin nhắn đã cho.

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.
[in] aMessage
Thông báo cần loại bỏ.

otMessageQueueEnqueue

void otMessageQueueEnqueue(
  otMessageQueue *aQueue,
  otMessage *aMessage
)

Hàm này thêm một tin nhắn vào cuối hàng đợi tin nhắn đã cho.

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.
[in] aMessage
Tin nhắn cần thêm.

otMessageQueueEnqueueAtHead

void otMessageQueueEnqueueAtHead(
  otMessageQueue *aQueue,
  otMessage *aMessage
)

Hàm này thêm một tin nhắn ở đầu / phía trước của hàng đợi tin nhắn đã cho.

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.
[in] aMessage
Tin nhắn cần thêm.

otMessageQueueGetHead

otMessage * otMessageQueueGetHead(
  otMessageQueue *aQueue
)

Hàm này trả về một con trỏ đến thông báo ở đầu hàng đợi.

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.
Lợi nhuận
Một con trỏ đến thông báo ở đầu hàng đợi hoặc NULL nếu hàng đợi trống.

otMessageQueueGetNext

otMessage * otMessageQueueGetNext(
  otMessageQueue *aQueue,
  const otMessage *aMessage
)

Hàm này trả về một con trỏ đến thông báo tiếp theo trong hàng đợi bằng cách lặp về phía trước (từ đầu đến đuôi).

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn hiện tại.
Lợi nhuận
Một con trỏ đến thông báo tiếp theo trong hàng đợi sau aMessage hoặc NULL nếu aMessage is the tail of queue. NULL is returned if aMessage is not in the queue aQueue`.

otMessageQueueInit

void otMessageQueueInit(
  otMessageQueue *aQueue
)

Khởi tạo hàng đợi tin nhắn.

Hàm này PHẢI được gọi một lần và chỉ một lần cho một cá thể otMessageQueue trước bất kỳ hàm otMessageQueue nào khác. Hành vi không được xác định nếu các API hàng đợi khác được sử dụng với otMessageQueue trước khi nó được khởi tạo hoặc nếu nó được khởi tạo nhiều lần.

Chi tiết
Thông số
[in] aQueue
Một con trỏ đến hàng đợi tin nhắn.

otMessageRead

uint16_t otMessageRead(
  const otMessage *aMessage,
  uint16_t aOffset,
  void *aBuf,
  uint16_t aLength
)

Đọc byte từ một tin nhắn.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aOffset
Phần bù tính bằng byte.
[in] aBuf
Một con trỏ tới bộ đệm mà các byte thông báo được đọc tới.
[in] aLength
Số byte để đọc.
Lợi nhuận
Số byte được đọc.
Xem thêm:
otMessageFree
otMessageAppend
otMessageGetLength
otMessageSetLength
otMessageGetOffset
otMessageSetOffset
otMessageWrite

otMessageSetDirectTransmission

void otMessageSetDirectTransmission(
  otMessage *aMessage,
  bool aEnabled
)

Chức năng này đặt / buộc thông điệp được chuyển tiếp bằng cách sử dụng truyền trực tiếp.

Cài đặt mặc định cho một tin nhắn mới là false .

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aEnabled
Nếu true , thông điệp buộc phải sử dụng đường truyền trực tiếp. Nếu false , thông báo sẽ tuân theo quy trình bình thường.

otMessageSetLength

otError otMessageSetLength(
  otMessage *aMessage,
  uint16_t aLength
)

Đặt độ dài tin nhắn theo byte.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aLength
Độ dài tính bằng byte.
Giá trị trả lại
OT_ERROR_NONE
Đặt thành công độ dài tin nhắn.
OT_ERROR_NO_BUFS
Không có bộ đệm có sẵn để phát triển thông điệp.
Xem thêm:
otMessageFree
otMessageAppend
otMessageGetLength
otMessageGetOffset
otMessageSetOffset
otMessageRead
otMessageWrite

otMessageSetOffset

void otMessageSetOffset(
  otMessage *aMessage,
  uint16_t aOffset
)

Đặt độ lệch tin nhắn theo byte.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aOffset
Phần bù tính bằng byte.
Xem thêm:
otMessageFree
otMessageAppend
otMessageGetLength
otMessageSetLength
otMessageGetOffset
otMessageRead
otMessageWrite

otMessageWrite

int otMessageWrite(
  otMessage *aMessage,
  uint16_t aOffset,
  const void *aBuf,
  uint16_t aLength
)

Viết byte vào một tin nhắn.

Chi tiết
Thông số
[in] aMessage
Một con trỏ đến bộ đệm tin nhắn.
[in] aOffset
Phần bù tính bằng byte.
[in] aBuf
Một con trỏ tới bộ đệm mà các byte thông báo được ghi từ đó.
[in] aLength
Số byte cần ghi.
Lợi nhuận
Số byte được viết.
Xem thêm:
otMessageFree
otMessageAppend
otMessageGetLength
otMessageSetLength
otMessageGetOffset
otMessageSetOffset
otMessageRead