TREL – Ngăn xếp chuỗi

Mô-đun này xác định các API Liên kết đóng gói phát thanh luồng (TREL) cho luồng trên cơ sở hạ tầng.

Tóm tắt

Các hàm trong mô-đun này yêu cầu bật OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

Typedef
otTrelPeer typedef
struct otTrelPeer
Đại diện cho ứng dụng ngang hàng TREL.
otTrelPeerIterator typedef
uint16_t
Đại diện cho một trình lặp để lặp lại qua các mục nhập trong bảng ứng dụng ngang hàng TREL.

Hàm
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Lặp lại qua các mục trong bảng ứng dụng ngang hàng rồi nhận mục nhập tiếp theo trong bảng.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Khởi chạy một trình biến lặp của bảng ngang hàng.
otTrelIsEnabled(otInstance *aInstance)
bool
Cho biết liệu hoạt động TREL có được bật hay không.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
Cho biết đã bật chế độ bộ lọc hay chưa.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
Bật hoặc tắt hoạt động TREL.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
Đặt chế độ bộ lọc (bật/tắt tính năng lọc).

Cấu trúc
otTrelPeer

Đại diện cho ứng dụng ngang hàng TREL.

Typedef

otTrelPeer

struct otTrelPeer otTrelPeer

Đại diện cho ứng dụng ngang hàng TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Đại diện cho một trình lặp để lặp lại qua các mục nhập trong bảng ứng dụng ngang hàng TREL.

Hàm

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Lặp lại qua các mục trong bảng ứng dụng ngang hàng rồi nhận mục nhập tiếp theo trong bảng.

Thông tin chi tiết
Thông số
[in] aInstance
Thực thể OpenThread.
[in] aIterator
Biến lặp. PHẢI được khởi tạo.
Trả về
Con trỏ đến mục nhập otTrelPeer tiếp theo hoặc NULL nếu không có mục nhập nào khác trong bảng.

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Khởi chạy một trình biến lặp của bảng ngang hàng.

Thông tin chi tiết
Thông số
[in] aInstance
Thực thể OpenThread.
[in] aIterator
Trình lặp để khởi chạy.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

Cho biết liệu hoạt động TREL có được bật hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Thực thể OpenThread.
Giá trị trả về
TRUE
nếu thao tác TREL được bật.
FALSE
nếu thao tác TREL bị tắt.

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Cho biết đã bật chế độ bộ lọc hay chưa.

Thông tin chi tiết
Thông số
[in] aInstance
Thực thể OpenThread.
Giá trị trả về
TRUE
nếu bạn bật chế độ bộ lọc TREL.
FALSE
nếu bạn tắt chế độ bộ lọc TREL.

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Bật hoặc tắt hoạt động TREL.

Khi aEnable là đúng, hàm này sẽ bắt đầu một quá trình duyệt DNS-SD đang diễn ra trên tên dịch vụ "_trel._udp" trong miền duyệt web cục bộ để khám phá các thiết bị khác hỗ trợ TREL. Thiết bị cũng đăng ký một dịch vụ mới để quảng cáo bằng DNS-SD, với tên dịch vụ là "_trel._udp" cho biết thiết bị có hỗ trợ TREL. Sau đó, thiết bị sẽ sẵn sàng nhận thông báo TREL từ ứng dụng ngang hàng.

Khi aEnable là false, chức năng này sẽ dừng quá trình duyệt DNS-SD trên tên dịch vụ "_trel._udp", ngừng quảng cáo dịch vụ TREL DNS-SD và xoá bảng ngang hàng TREL.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aEnable
Giá trị boolean để bật/tắt thao tác TREL.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Đặt chế độ bộ lọc (bật/tắt tính năng lọc).

Khi bạn bật chế độ bộ lọc, mọi lưu lượng truy cập Rx và tx thông qua giao diện TREL sẽ tự động bị loại bỏ. Thao tác này chủ yếu nhằm mục đích sử dụng trong quá trình kiểm thử.

Không giống như otTrel{Enable/Disable}() (bắt đầu/dừng hoàn toàn hoạt động TREL), khi chế độ bộ lọc được bật, giao diện TREL sẽ tiếp tục bật.

Thông tin chi tiết
Thông số
[in] aInstance
Thực thể OpenThread.
[in] aFiltered
TRUE để bật chế độ lọc, FALSE để tắt chế độ lọc.

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.