Đường liên kết

Mô-đun này bao gồm các hàm kiểm soát cấu hình lớp liên kết.

Tóm tắt

Bảng liệt kê
otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
} 		enum
Xác định chế độ địa chỉ của bộ lọc Mac.

Typedef
otActiveScanResult typedef
Biểu thị một Báo hiệu IEEE 802.15.4 đã nhận.
otEnergyScanResult typedef
Đại diện cho kết quả quét năng lượng.
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) typedef
void(*
Con trỏ được gọi trong quá trình quét Chủ động IEEE 802.15.4 khi nhận được Beacon 802.15.4 hoặc quét xong.
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext) typedef
void(*
Con trỏ được gọi trong quá trình Quét năng lượng IEEE 802.15.4 khi kết quả cho kênh đã sẵn sàng hoặc quá trình quét hoàn tất.
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext) typedef
void(*
Con trỏ được gọi khi nhận được một khung IEEE 802.15.4.
otMacCounters typedef
struct otMacCounters
Đại diện cho bộ đếm lớp MAC.
otMacFilterAddressMode typedef
Xác định chế độ địa chỉ của bộ lọc Mac.
otMacFilterEntry typedef
Đại diện cho mục nhập Bộ lọc Mac.
otMacFilterIterator typedef
uint8_t
Được dùng để lặp lại các mục nhập bộ lọc mac.
otThreadLinkInfo typedef
Biểu thị thông tin cụ thể của từng đường liên kết cho các tin nhắn nhận được từ đài luồng (Thread).

Hàm
otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
Bắt đầu quét chủ động IEEE 802.15.4.
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
int8_t
Chuyển đổi chất lượng đường liên kết thành cường độ tín hiệu thông thường đã nhận.
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
Chuyển đổi cường độ tín hiệu đã nhận thành chất lượng liên kết.
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
Bắt đầu Quét năng lượng theo chuẩn IEEE 802.15.4.
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
Thêm Địa chỉ mở rộng vào bộ lọc MAC.
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
Thêm Địa chỉ mở rộng được chỉ định vào danh sách RssIn (hoặc sửa đổi địa chỉ hiện có trong danh sách RssIn) và đặt mục nhập cường độ tín hiệu nhận được (tính bằng dBm) cho các thông điệp từ địa chỉ đó.
otLinkFilterClearAddresses(otInstance *aInstance)
void
Xoá tất cả các Địa chỉ mở rộng khỏi bộ lọc MAC.
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
Xoá tất cả mục cường độ tín hiệu đã nhận (rss) và chỉ báo chất lượng của đường liên kết (lqi) (bao gồm cả giá trị mặc định) khỏi danh sách RssIn.
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
Xoá mọi cường độ tín hiệu đã nhận mặc định đã đặt trước đó (tính bằng dBm) trên Bộ lọc MAC.
otLinkFilterGetAddressMode(otInstance *aInstance)
Lấy chế độ địa chỉ của bộ lọc MAC.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Nhận mục nhập bộ lọc địa chỉ đang sử dụng.
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Nhận một mục nhập bộ lọc RssIn đang sử dụng.
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
Xoá Địa chỉ mở rộng khỏi bộ lọc MAC.
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
void
Xoá Địa chỉ mở rộng đã chỉ định khỏi danh sách RssIn.
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
void
Đặt chế độ địa chỉ của bộ lọc MAC.
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
void
Đặt cường độ tín hiệu nhận được mặc định (in dBm) trên Bộ lọc MAC.
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
Trả về tỷ lệ lỗi hiện tại của quy trình CCA (Xoá kênh đánh giá).
otLinkGetChannel(otInstance *aInstance)
uint8_t
Nhận kênh IEEE 802.15.4.
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
Tải bộ đếm lớp MAC.
otLinkGetCslChannel(otInstance *aInstance)
uint8_t
Lấy kênh CSL.
otLinkGetCslPeriod(otInstance *aInstance)
uint32_t
Lấy kỳ CSL tính bằng micrô giây.
otLinkGetCslTimeout(otInstance *aInstance)
uint32_t
Lấy thời gian chờ CSL.
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
Lấy Địa chỉ mở rộng IEEE 802.15.4.
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
Nhận mã IEEE EUI-64 do nhà máy chỉ định.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
Trả về số lần thử lại khung hình tối đa trong khi truyền trực tiếp.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
Trả về số lần thử lại khung hình tối đa trong quá trình truyền gián tiếp.
otLinkGetPanId(otInstance *aInstance)
Lấy mã PAN theo chuẩn IEEE 802.15.4.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
Nhận khoảng thời gian thăm dò ý kiến về dữ liệu của thiết bị cuối ở trạng thái ngủ.
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
Lấy mã vùng.
otLinkGetShortAddress(otInstance *aInstance)
Lấy địa chỉ ngắn của IEEE 802.15.4.
otLinkGetSupportedChannelMask(otInstance *aInstance)
uint32_t
Tải mặt nạ kênh được hỗ trợ của lớp MAC.
otLinkGetTxDirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Lấy biểu đồ các lần thử lại cho một gói trực tiếp cho đến khi thành công.
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Lấy biểu đồ các lần thử lại cho một gói gián tiếp cho đến khi thành công.
otLinkIsActiveScanInProgress(otInstance *aInstance)
bool
Cho biết liệu bạn có đang tiến hành Quét chủ động theo chuẩn IEEE 802.15.4 hay không.
otLinkIsCslEnabled(otInstance *aInstance)
bool
Cho biết liệu CSL có được bật hay không.
otLinkIsCslSupported(otInstance *aInstance)
bool
Cho biết thiết bị có kết nối với cha mẹ có hỗ trợ CSL hay không.
otLinkIsEnabled(otInstance *aInstance)
bool
Cho biết liệu lớp liên kết có được bật hay không.
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
Cho biết liệu bạn có đang tiến hành Quét năng lượng theo chuẩn IEEE 802.15.4 hay không.
otLinkIsInTransmitState(otInstance *aInstance)
bool
Cho biết liệu MAC của IEEE 802.15.4 có đang ở trạng thái truyền hay không.
otLinkIsPromiscuous(otInstance *aInstance)
bool
Cho biết liệu chế độ hỗn tạp có được bật tại lớp liên kết hay không.
otLinkIsRadioFilterEnabled(otInstance *aInstance)
bool
Cho biết bộ lọc vô tuyến IEEE 802.15.4 có được bật hay không.
otLinkResetCounters(otInstance *aInstance)
void
Đặt lại bộ đếm lớp MAC.
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
Xoá số liệu thống kê trong biểu đồ cho việc truyền trực tiếp và gián tiếp.
otLinkSendDataRequest(otInstance *aInstance)
Thêm một thông báo Yêu cầu dữ liệu IEEE 802.15.4 vào hàng đợi để truyền.
otLinkSendEmptyData(otInstance *aInstance)
Hướng dẫn thiết bị gửi một khung dữ liệu IEEE 802.15.4 trống.
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
Thiết lập kênh IEEE 802.15.4.
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
Thiết lập kênh CSL.
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
Đặt thời gian CSL tính bằng micrô giây.
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
Đặt thời gian chờ CSL tính bằng giây.
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
Bật hoặc tắt lớp liên kết.
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
Đặt Địa chỉ mở rộng IEEE 802.15.4.
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
Đặt số lần thử lại khung hình tối đa trong khi truyền trực tiếp.
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
Đặt số lần thử lại khung tối đa trong quá trình truyền gián tiếp.
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
Đặt mã PAN theo chuẩn IEEE 802.15.4.
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
Đăng ký một lệnh gọi lại để cung cấp các khung IEEE 802.15.4 thô đã nhận.
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
Đặt/xoá khoảng thời gian thăm dò dữ liệu bên ngoài/do người dùng chỉ định cho thiết bị cuối đang ngủ.
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
Bật hoặc tắt chế độ hỗn hợp lớp liên kết.
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
Bật/tắt chế độ bộ lọc radio IEEE 802.15.4.
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
Đặt mã vùng.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
Đặt mặt nạ kênh được hỗ trợ của lớp MAC.

Cấu trúc
otActiveScanResult

Biểu thị một Báo hiệu IEEE 802.15.4 đã nhận.

otEnergyScanResult

Đại diện cho kết quả quét năng lượng.

otMacCounters

Đại diện cho bộ đếm lớp MAC.

otMacFilterEntry

Đại diện cho mục nhập Bộ lọc Mac.

otThreadLinkInfo

Biểu thị thông tin cụ thể của từng đường liên kết cho các tin nhắn nhận được từ đài luồng (Thread).

Bảng liệt kê

otMacFilterAddressMode

 otMacFilterAddressMode

Xác định chế độ địa chỉ của bộ lọc Mac.

Thuộc tính
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

Đã bật chế độ lọc địa chỉ của danh sách cho phép.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

Đã bật chế độ lọc địa chỉ của danh sách từ chối.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

Bộ lọc địa chỉ đã bị tắt.

Typedef

otActiveScanResult

struct otActiveScanResult otActiveScanResult

Biểu thị một Báo hiệu IEEE 802.15.4 đã nhận.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

Đại diện cho kết quả quét năng lượng.

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

Con trỏ được gọi trong quá trình quét Chủ động IEEE 802.15.4 khi nhận được Beacon 802.15.4 hoặc quét xong.

Thông tin chi tiết
Thông số
[in] aResult
Con trỏ hợp lệ đến thông tin beacon hoặc NULL khi quá trình quét đang hoạt động hoàn tất.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otHandleEnergyScanResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

Con trỏ được gọi trong quá trình Quét năng lượng IEEE 802.15.4 khi kết quả cho kênh đã sẵn sàng hoặc quá trình quét hoàn tất.

Thông tin chi tiết
Thông số
[in] aResult
Con trỏ hợp lệ đến thông tin kết quả quét năng lượng hoặc giá trị NULL khi quá trình quét năng lượng hoàn tất.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

Con trỏ được gọi khi nhận được một khung IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aFrame
Con trỏ đến khung IEEE 802.15.4 đã nhận.
[in] aIsTx
Cho biết khung hình này có được truyền đi, nhưng không được nhận hay không.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otMacCounters

struct otMacCounters otMacCounters

Đại diện cho bộ đếm lớp MAC.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

Xác định chế độ địa chỉ của bộ lọc Mac.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

Đại diện cho mục nhập Bộ lọc Mac.

otMacFilterIterator

uint8_t otMacFilterIterator

Được dùng để lặp lại các mục nhập bộ lọc mac.

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

Biểu thị thông tin cụ thể của từng đường liên kết cho các tin nhắn nhận được từ đài luồng (Thread).

Hàm

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

Bắt đầu quét chủ động IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aScanChannels
Vectơ bit cho biết kênh nào cần quét (ví dụ: OT_CHANNEL_11_Mask).
[in] aScanDuration
Thời gian tính bằng mili giây để quét từng kênh.
[in] aCallback
Con trỏ đến một hàm được gọi khi nhận beacon hoặc quá trình quét hoàn tất.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã chấp nhận yêu cầu Quét đang hoạt động.
OT_ERROR_BUSY
Đã thực hiện một Quét đang hoạt động.

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Chuyển đổi chất lượng đường liên kết thành cường độ tín hiệu thông thường đã nhận.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aLinkQuality
Giá trị LinkQuality phải nằm trong phạm vi [0,3].
Trả về
Nền tảng thông thường đã nhận được dữ liệu ánh xạ cường độ tín hiệu đến aLinkQuality.

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

Chuyển đổi cường độ tín hiệu đã nhận thành chất lượng liên kết.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aRss
Giá trị cường độ tín hiệu đã nhận sẽ được chuyển đổi.
Trả về
Liên kết mối liên kết giá trị chất lượng với aRss.

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

Bắt đầu Quét năng lượng theo chuẩn IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aScanChannels
Vectơ bit cho biết các kênh thực hiện quét năng lượng.
[in] aScanDuration
Thời gian tính bằng mili giây để quét từng kênh.
[in] aCallback
Con trỏ đến một hàm được gọi để chuyển kết quả quét khi cho biết đã hoàn tất quá trình quét.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã chấp nhận yêu cầu Quét năng lượng.
OT_ERROR_BUSY
Không thể bắt đầu quét năng lượng.

otLinkFilterAddAddress

otError otLinkFilterAddAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Thêm Địa chỉ mở rộng vào bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới Địa chỉ mở rộng (KHÔNG ĐƯỢC PHÉP là NULL).
Giá trị trả về
OT_ERROR_NONE
Đã thêm thành công aExtAddress vào bộ lọc MAC.
OT_ERROR_NO_BUFS
Không có mục nhập nào.

otLinkFilterAddRssIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

Thêm Địa chỉ mở rộng được chỉ định vào danh sách RssIn (hoặc sửa đổi địa chỉ hiện có trong danh sách RssIn) và đặt mục nhập cường độ tín hiệu nhận được (tính bằng dBm) cho các thông điệp từ địa chỉ đó.

Địa chỉ mở rộng không nhất thiết phải nằm trong bộ lọc address allowlist/denylist để đặt rss.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới Địa chỉ mở rộng IEEE 802.15.4. KHÔNG ĐƯỢC là RỖNG.
[in] aRss
Cường độ tín hiệu nhận được (tính bằng dBm).
Giá trị trả về
OT_ERROR_NONE
Đã thêm thành công một mục cho aExtAddress và aRss.
OT_ERROR_NO_BUFS
Không có mục nhập nào.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

Xoá tất cả các Địa chỉ mở rộng khỏi bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

Xoá tất cả mục cường độ tín hiệu đã nhận (rss) và chỉ báo chất lượng của đường liên kết (lqi) (bao gồm cả giá trị mặc định) khỏi danh sách RssIn.

Khi thực hiện thao tác này, tất cả các Địa chỉ mở rộng sẽ sử dụng tín hiệu trực tuyến.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Xoá mọi cường độ tín hiệu đã nhận mặc định đã đặt trước đó (tính bằng dBm) trên Bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

Lấy chế độ địa chỉ của bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
chế độ địa chỉ.

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Nhận mục nhập bộ lọc địa chỉ đang sử dụng.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in,out] aIterator
Con trỏ đến ngữ cảnh biến lặp của bộ lọc MAC. Để nhận mục nhập bộ lọc địa chỉ đang sử dụng đầu tiên, bạn phải đặt mục này thành OT_MAC_FILTER_ITERATOR_INIT. KHÔNG ĐƯỢC là RỖNG.
[out] aEntry
Con trỏ đến vị trí đặt thông tin. KHÔNG ĐƯỢC là RỖNG.
Giá trị trả về
OT_ERROR_NONE
Đã truy xuất thành công mục nhập bộ lọc địa chỉ đang sử dụng.
OT_ERROR_NOT_FOUND
Không có mục tiếp theo nào tồn tại.

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Nhận một mục nhập bộ lọc RssIn đang sử dụng.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in,out] aIterator
Con trỏ đến ngữ cảnh biến lặp của bộ lọc MAC. KHÔNG ĐƯỢC là RỖNG. Để lấy mục nhập đầu tiên, bạn phải đặt mục này thành OT_MAC_FILTER_ITERATOR_INIT.
[out] aEntry
Con trỏ đến vị trí đặt thông tin. Mục nhập cuối cùng sẽ có địa chỉ được mở rộng như tất cả 0xff để cho biết cường độ tín hiệu nhận được mặc định nếu được đặt. aEntry KHÔNG ĐƯỢC là RỖNG.
Giá trị trả về
OT_ERROR_NONE
Đã truy xuất thành công mục nhập tiếp theo.
OT_ERROR_NOT_FOUND
Không có mục tiếp theo nào tồn tại.

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Xoá Địa chỉ mở rộng khỏi bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Không có hành động nào được thực hiện nếu không có mục nhập hiện có trong Bộ lọc khớp với Địa chỉ mở rộng đã cung cấp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới Địa chỉ mở rộng (KHÔNG ĐƯỢC PHÉP là NULL).

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Xoá Địa chỉ mở rộng đã chỉ định khỏi danh sách RssIn.

Sau khi bị xoá khỏi danh sách RssIn, địa chỉ MAC này sẽ sử dụng chế độ cài đặt rss và lqi mặc định, giả sử các chế độ cài đặt mặc định đã được thiết lập. (Nếu chưa đặt giá trị mặc định, tín hiệu không dây sẽ được sử dụng.)

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Không có mục nào được thực hiện nếu không có mục nhập hiện có nào trong danh sách RssIn khớp với Địa chỉ mở rộng đã chỉ định.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới Địa chỉ mở rộng IEEE 802.15.4. KHÔNG ĐƯỢC là RỖNG.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

Đặt chế độ địa chỉ của bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aMode
Chế độ địa chỉ cần thiết lập.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

Đặt cường độ tín hiệu nhận được mặc định (in dBm) trên Bộ lọc MAC.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Giá trị RSS mặc định được dùng cho tất cả các khung đã nhận từ địa chỉ chưa có mục nhập RSS-IN rõ ràng trong danh sách Bộ lọc (được thêm bằng cách sử dụng otLinkFilterAddRssIn()).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aRss
Cường độ tín hiệu nhận được mặc định (tính bằng dBm) cần đặt.

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

Trả về tỷ lệ lỗi hiện tại của quy trình CCA (Xoá kênh đánh giá).

Tốc độ được duy trì trong một khoảng thời gian (khoảng) lần truyền khung hình OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW gần nhất.

Thông tin chi tiết
Trả về
Tỷ lệ lỗi CCA có giá trị tối đa là 0xffff tương ứng với tỷ lệ lỗi là 100%.

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

Nhận kênh IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Kênh IEEE 802.15.4.
Xem thêm:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Tải bộ đếm lớp MAC.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Con trỏ đến các bộ đếm lớp MAC.

otLinkGetCslChannel

uint8_t otLinkGetCslChannel(
  otInstance *aInstance
)

Lấy kênh CSL.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Kênh CSL.

otLinkGetCslPeriod

uint32_t otLinkGetCslPeriod(
  otInstance *aInstance
)

Lấy kỳ CSL tính bằng micrô giây.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Kỳ CSL tính bằng micrô giây.

otLinkGetCslTimeout

uint32_t otLinkGetCslTimeout(
  otInstance *aInstance
)

Lấy thời gian chờ CSL.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Thời gian chờ của CSL tính bằng giây.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Lấy Địa chỉ mở rộng IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Con trỏ tới Địa chỉ mở rộng IEEE 802.15.4.

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Nhận mã IEEE EUI-64 do nhà máy chỉ định.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến thực thể OpenThread.
[out] aEui64
Con trỏ đến vị trí đặt IEEE EUI-64 do nhà máy chỉ định.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

Trả về số lần thử lại khung hình tối đa trong khi truyền trực tiếp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Số lần thử lại tối đa trong quá trình truyền trực tiếp.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

Trả về số lần thử lại khung hình tối đa trong quá trình truyền gián tiếp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Số lần thử lại tối đa trong quá trình truyền gián tiếp.

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Lấy mã PAN theo chuẩn IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Mã PAN theo chuẩn IEEE 802.15.4.
Xem thêm:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Nhận khoảng thời gian thăm dò ý kiến về dữ liệu của thiết bị cuối ở trạng thái ngủ.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Khoảng thời gian thăm dò dữ liệu của thiết bị cuối đang ngủ tính bằng mili giây.
Xem thêm:
otLinkSetPollPeriod

otLinkGetRegion

otError otLinkGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

Lấy mã vùng.

Định dạng vùng radio là đại diện ascii 2 byte của mã ISO 3166 alpha-2.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
[out] aRegionCode
Mã vùng của đài phát thanh. aRegionCode >> 8 là ký tự ascii đầu tiên và aRegionCode & 0xff là ký tự ascii thứ hai.
Giá trị trả về
OT_ERROR_INVALID_ARGS
aRegionCode là nullptr.
OT_ERROR_FAILED
Các lỗi khác theo nền tảng cụ thể.
OT_ERROR_NONE
Đã nhận được mã vùng.
OT_ERROR_NOT_IMPLEMENTED
Tính năng này chưa được triển khai.

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Lấy địa chỉ ngắn của IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Con trỏ tới địa chỉ ngắn của IEEE 802.15.4.

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

Tải mặt nạ kênh được hỗ trợ của lớp MAC.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Mặt nạ kênh được hỗ trợ là uint32_t với bit 0 (lsb) ánh xạ đến kênh 0, bit 1 đến kênh 1, v.v.

otLinkGetTxDirectRetrySuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Lấy biểu đồ các lần thử lại cho một gói trực tiếp cho đến khi thành công.

Có hiệu lực khi bật cấu hình MỞ HOẠT_PROFILE_CONFIG_MAC_RETRY_ THÀNH CÔNG_HISTOGRAM_ENABLE.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[out] aNumberOfEntries
Một con trỏ đến vị trí đặt kích thước của mảng biểu đồ được trả về.
Trả về
Con trỏ đến biểu đồ của lượt thử lại (ở dạng một mảng). Phần tử thứ n cho biết gói đã được gửi với lần thử lại thứ n.

otLinkGetTxIndirectRetrySuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Lấy biểu đồ các lần thử lại cho một gói gián tiếp cho đến khi thành công.

Có hiệu lực khi bật cấu hình MỞ HOẠT_PROFILE_CONFIG_MAC_RETRY_ THÀNH CÔNG_HISTOGRAM_ENABLE.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[out] aNumberOfEntries
Một con trỏ đến vị trí đặt kích thước của mảng biểu đồ được trả về.
Trả về
Con trỏ đến biểu đồ của lượt thử lại (ở dạng một mảng). Phần tử thứ n cho biết gói đã được gửi với lần thử lại thứ n.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

Cho biết liệu bạn có đang tiến hành Quét chủ động theo chuẩn IEEE 802.15.4 hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
true nếu đang thực hiện Quét chủ động theo chuẩn IEEE 802.15.4, nếu không thì là false.

otLinkIsCslEnabled

bool otLinkIsCslEnabled(
  otInstance *aInstance
)

Cho biết liệu CSL có được bật hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
TRUE
Lớp liên kết đã bật CSL.
FALSE
Lớp liên kết chưa bật CSL.

otLinkIsCslSupported

bool otLinkIsCslSupported(
  otInstance *aInstance
)

Cho biết thiết bị có kết nối với cha mẹ có hỗ trợ CSL hay không.

Thông tin chi tiết
Giá trị trả về
TRUE
Nếu cha mẹ hỗ trợ CSL.
FALSE
Nếu nhà xuất bản mẹ không hỗ trợ CSL.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

Cho biết liệu lớp liên kết có được bật hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
TRUE
Đã bật lớp liên kết.
FALSE
Lớp liên kết chưa được bật.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

Cho biết liệu bạn có đang tiến hành Quét năng lượng theo chuẩn IEEE 802.15.4 hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
true nếu đang quét năng lượng theo chuẩn IEEE 802.15.4, nếu không thì là false.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

Cho biết liệu MAC của IEEE 802.15.4 có đang ở trạng thái truyền hay không.

Mô-đun MAC ở trạng thái truyền trong quy trình CSMA/CA, CCA, Dữ liệu, Báo hiệu hoặc khung Yêu cầu dữ liệu và nhận ACK của khung được truyền. Mô-đun MAC không ở trạng thái truyền trong quá trình truyền khung ACK hoặc khung Yêu cầu báo hiệu.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
true nếu một MAC của IEEE 802.15.4 đang ở trạng thái truyền, nếu không thì là false.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

Cho biết liệu chế độ hỗn tạp có được bật tại lớp liên kết hay không.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
TRUE
Chế độ hỗn tạp đang bật.
FALSE
Chế độ hỗn tạp chưa được bật.

otLinkIsRadioFilterEnabled

bool otLinkIsRadioFilterEnabled(
  otInstance *aInstance
)

Cho biết bộ lọc vô tuyến IEEE 802.15.4 có được bật hay không.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Thông tin chi tiết
Giá trị trả về
TRUE
Nếu bộ lọc đài đang bật.
FALSE
Nếu bộ lọc đài đang tắt.

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Đặt lại bộ đếm lớp MAC.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

Xoá số liệu thống kê trong biểu đồ cho việc truyền trực tiếp và gián tiếp.

Có hiệu lực khi bật cấu hình MỞ HOẠT_PROFILE_CONFIG_MAC_RETRY_ THÀNH CÔNG_HISTOGRAM_ENABLE.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

Thêm một thông báo Yêu cầu dữ liệu IEEE 802.15.4 vào hàng đợi để truyền.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
OT_ERROR_NONE
Đã thêm một thông báo Yêu cầu dữ liệu IEEE 802.15.4 vào hàng đợi thành công.
OT_ERROR_INVALID_STATE
Thiết bị hiện không ở chế độ rx-off-when-idle.
OT_ERROR_NO_BUFS
Không có đủ vùng đệm thư.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

Hướng dẫn thiết bị gửi một khung dữ liệu IEEE 802.15.4 trống.

Chỉ hỗ trợ trên thiết bị Rx-Off-When-Idle để gửi một khung dữ liệu trống đến thành phần mẹ. Lưu ý: chỉ áp dụng khi bạn bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
OT_ERROR_NONE
Đã thêm một thư trống vào hàng đợi thành công.
OT_ERROR_INVALID_STATE
Thiết bị không ở chế độ Rx-Off-When-Idle.
OT_ERROR_NO_BUFS
Không có đủ vùng đệm thư.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Thiết lập kênh IEEE 802.15.4.

Chỉ thành công khi giao thức Thread bị tắt. Lệnh gọi thành công hàm này sẽ làm mất hiệu lực của Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aChannel
Kênh IEEE 802.15.4.
Giá trị trả về
OT_ERROR_NONE
Đã đặt kênh thành công.
OT_ERROR_INVALID_ARGS
Nếu aChannel không nằm trong phạm vi [11, 26] hoặc không nằm trong mặt nạ kênh được hỗ trợ.
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.
Xem thêm:
otLinkGetChannel

otLinkSetCslChannel

otError otLinkSetCslChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Thiết lập kênh CSL.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aChannel
Kênh mẫu CSL. Giá trị kênh phải là 0 (Đặt kênh CSL chưa xác định) hoặc trong phạm vi [1, 10] (nếu được hỗ trợ 915 MHz) và 11, 26.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công các thông số CSL.
OT_ERROR_INVALID_ARGS
aChannel không hợp lệ.

otLinkSetCslPeriod

otError otLinkSetCslPeriod(
  otInstance *aInstance,
  uint32_t aPeriod
)

Đặt thời gian CSL tính bằng micrô giây.

Tắt CSL bằng cách đặt tham số này thành 0.

Dấu chấm CSL PHẢI là bội số của OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC, nếu không, hệ thống sẽ trả về OT_ERROR_INVALID_ARGS.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aPeriod
Kỳ CSL tính bằng micrô giây.
Giá trị trả về
OT_ERROR_NONE
Đặt thành công khoảng thời gian CSL.
OT_ERROR_INVALID_ARGS
Khoảng thời gian CSL không hợp lệ

otLinkSetCslTimeout

otError otLinkSetCslTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

Đặt thời gian chờ CSL tính bằng giây.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aTimeout
Thời gian chờ của CSL tính bằng giây.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công thời gian chờ CSL.
OT_ERROR_INVALID_ARGS
Thời gian chờ CSL không hợp lệ.

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Bật hoặc tắt lớp liên kết.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aEnable
true để bật lớp liên kết hoặc false nếu không làm như vậy.
Giá trị trả về
OT_ERROR_NONE
Đã bật / tắt thành công lớp liên kết.
OT_ERROR_INVALID_STATE
Không thể tắt lớp liên kết vì giao diện Luồng đang bật.

otLinkSetExtendedAddress

otError otLinkSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Đặt Địa chỉ mở rộng IEEE 802.15.4.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới Địa chỉ mở rộng IEEE 802.15.4.
Giá trị trả về
OT_ERROR_NONE
Thiết lập thành công Địa chỉ mở rộng IEEE 802.15.4.
OT_ERROR_INVALID_ARGS
aExtAddress là NULL.
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

Đặt số lần thử lại khung hình tối đa trong khi truyền trực tiếp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aMaxFrameRetriesDirect
Số lần thử lại tối đa trong quá trình truyền trực tiếp.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

Đặt số lần thử lại khung tối đa trong quá trình truyền gián tiếp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aMaxFrameRetriesIndirect
Số lần thử lại tối đa trong quá trình truyền gián tiếp.

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

Đặt mã PAN theo chuẩn IEEE 802.15.4.

Chỉ thành công khi giao thức Thread bị tắt. Lệnh gọi thành công hàm này cũng sẽ làm mất hiệu lực của Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aPanId
Mã PAN theo chuẩn IEEE 802.15.4.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công mã PAN.
OT_ERROR_INVALID_ARGS
Nếu aPanId không nằm trong khoảng [0, 65534].
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.
Xem thêm:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

Đăng ký một lệnh gọi lại để cung cấp các khung IEEE 802.15.4 thô đã nhận.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aPcapCallback
Con trỏ đến một hàm được gọi khi nhận khung liên kết IEEE 802.15.4 hoặc NULL để vô hiệu hoá lệnh gọi lại.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

Đặt/xoá khoảng thời gian thăm dò dữ liệu bên ngoài/do người dùng chỉ định cho thiết bị cuối đang ngủ.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aPollPeriod
khoảng thời gian của cuộc thăm dò ý kiến về dữ liệu tính bằng mili giây.
Giá trị trả về
OT_ERROR_NONE
Đặt/xoá thời gian thăm dò ý kiến do người dùng chỉ định thành công.
OT_ERROR_INVALID_ARGS
Nếu aPollPeriod không hợp lệ.
Xem thêm:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

Bật hoặc tắt chế độ hỗn hợp lớp liên kết.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aPromiscuous
true để bật chế độ hỗn tạp hoặc false nếu không làm như vậy.
Giá trị trả về
OT_ERROR_NONE
Đã bật thành công chế độ hỗn tạp.
OT_ERROR_INVALID_STATE
Không thể bật chế độ hỗn tạp vì giao diện Luồng đang bật.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

Bật/tắt chế độ bộ lọc radio IEEE 802.15.4.

Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE được bật.

Bộ lọc radio chủ yếu dành cho mục đích thử nghiệm. Nó có thể được sử dụng để tạm thời chặn tất cả các tx/rx trên 802.15.4 radio. Khi bật bộ lọc vô tuyến, đài sẽ chuyển sang chế độ ngủ thay vì nhận (để đảm bảo thiết bị không nhận được bất kỳ khung hình nào và/hoặc có thể gửi xác nhận). Ngoài ra, các yêu cầu truyền khung hình sẽ trả về ngay lập tức mà không gửi khung qua vô tuyến (trả về lỗi "no ack" nếu có yêu cầu, nếu không thì trả về thành công).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aFilterEnabled
TRUE để bật bộ lọc radio, FALSE để tắt

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

Đặt mã vùng.

Định dạng vùng radio là đại diện ascii 2 byte của mã ISO 3166 alpha-2.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aRegionCode
Mã vùng của đài phát thanh. aRegionCode >> 8 là ký tự ascii đầu tiên và aRegionCode & 0xff là ký tự ascii thứ hai.
Giá trị trả về
OT_ERROR_FAILED
Các lỗi khác theo nền tảng cụ thể.
OT_ERROR_NONE
Đã đặt thành công mã vùng.
OT_ERROR_NOT_IMPLEMENTED
Tính năng này chưa được triển khai.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Đặt mặt nạ kênh được hỗ trợ của lớp MAC.

Chỉ thành công khi giao thức Thread bị tắt.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aChannelMask
Mặt nạ kênh được hỗ trợ (bit 0 hoặc lsb ánh xạ đến kênh 0, v.v.).
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công mặt nạ kênh được hỗ trợ.
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.

Macro

 OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC (160)

Đại diện cho đơn vị ký hiệu 10 chu kỳ CSL tính bằng micrô giây.

Khoảng thời gian CSL (tính bằng micrô giây) PHẢI là bội số của giá trị này.

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

Dùng để cho biết bạn chưa đặt cường độ tín hiệu đã nhận cố định nào.

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

Trình khởi tạo cho otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME

Thời gian cho 10 ký hiệu tính bằng đơn vị micrô giây.

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.