Đườ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 struct otActiveScanResult Biểu thị một Báo hiệu IEEE 802.15.4 đã nhận.
otEnergyScanResult	typedef struct otEnergyScanResult Đạ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 enum otMacFilterAddressMode Xác định chế độ địa chỉ của bộ lọc Mac.
otMacFilterEntry	typedef struct otMacFilterEntry Đạ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 struct 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(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)	otError 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)	otError Bắt đầu Quét năng lượng theo chuẩn IEEE 802.15.4.
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Thêm Địa chỉ mở rộng vào bộ lọc MAC.
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)	otError 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)	otMacFilterAddressMode Lấy chế độ địa chỉ của bộ lọc MAC.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)	otError Nhận mục nhập bộ lọc địa chỉ đang sử dụng.
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)	otError 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)	otPanId 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)	otError Lấy mã vùng.
otLinkGetShortAddress(otInstance *aInstance)	otShortAddress 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)	otError 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)	otError 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)	otError Thiết lập kênh IEEE 802.15.4.
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)	otError Thiết lập kênh CSL.
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)	otError Đặt thời gian CSL tính bằng micrô giây.
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)	otError Đặt thời gian chờ CSL tính bằng giây.
otLinkSetEnabled(otInstance *aInstance, bool aEnable)	otError Bật hoặc tắt lớp liên kết.
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Đặ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)	otError Đặ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)	otError Đặ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)	otError 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)	otError Đặt mã vùng.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)	otError Đặ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.

Lưu ý: Lệnh gọi lại này được gọi sau khi xử lý FCS và aFrame có thể không chứa FCS thực tế đã nhận được.

Lưu ý: Lệnh gọi lại này được gọi trước khi xử lý bảo mật 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.

Lưu ý: Danh sách RssIn chứa các Địa chỉ mở rộng có giá trị rss hoặc chỉ báo chất lượng liên kết (lqi) đã được đặt khác với giá trị mặc định.

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.

Lưu ý: Bạn chỉ có thể bật / tắt lớp liên kết khi giao diện luồng ở trạng thái tắ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.

Lưu ý: Chỉ thành công khi tắt các giao thức Thread.

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ủ.

Lưu ý: Chức năng này chỉ cập nhật khoảng thời gian thăm dò ý kiến của thiết bị cuối ở trạng thái ngủ. Để cập nhật thời gian chờ con, hàm otThreadSetChildTimeout() sẽ được gọi.

Lưu ý: Giá trị tối thiểu khác 0 phải là OPENTHREAD_CONFIG_MAC_MINIMUM_POLL_PERIOD (10 mili giây). Hoặc để xoá khoảng thời gian thăm dò ý kiến do người dùng chỉ định.

Lưu ý: Giá trị do người dùng chỉ định không được vượt quá giá trị tối đa 0x3FFFFFF ((1 << 26) - 1) được phép, nếu không, giá trị này sẽ bị cắt bớt theo giá trị tối đa.

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.

Lưu ý: Bạn chỉ có thể bật Chế độ hỗn hợp khi tắt giao diện Luồng.

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

 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.