Trang này được dịch bởi Cloud Translation API.

Đường liên kết thô

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 thô.

Tóm tắt

Typedef
`otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Con trỏ hàm này khi nhận khung IEEE 802.15.4.
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Con trỏ hàm này khi nhận khung IEEE 802.15.4.
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Con trỏ hàm này khi nhận khung IEEE 802.15.4.

Hàm
`otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Phương thức này bắt đầu trình tự quét năng lượng trên đài.
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` Tải các tính năng radio.
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` Hàm này nhận trạng thái của chế độ quảng cáo xen kẽ.
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` Nhận thời gian hiện tại của nền tảng (chiều rộng 64 bit) của chip radio.
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Nhận kết quả đo RSSI mới nhất.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` Chuyển đổi radio từ Truyền sang Nhận.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` Hàm này cho biết liệu lớp liên kết thô có được bật hay không.
`otLinkRawReceive(otInstance *aInstance)`	`otError` Tôi đang chuyển đài phát thanh từ chế độ Ngủ sang Nhận.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Đặt giá trị bộ đếm khung MAC hiện tại.
`otLinkRawSetMacKey(otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Cập nhật khóa MAC và chỉ mục khóa.
`otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)`	`otError` Chức năng này bật hoặc tắt chế độ liên tục.
`otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Hàm này sẽ bật/tắt lớp liên kết thô.
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Đặt Địa chỉ ngắn để lọc địa chỉ.
`otLinkRawSleep(otInstance *aInstance)`	`otError` Chuyển đổi đài phát từ Nhận sang chế độ ngủ.
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Thêm địa chỉ mở rộng vào bảng so khớp nguồn.
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Thêm địa chỉ ngắn vào bảng so khớp nguồn.
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` Xóa tất cả địa chỉ mở rộng khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Đang xóa địa chỉ mở rộng khỏi bảng so khớp nguồn của đài.
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` Xóa tất cả các địa chỉ ngắn khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Đang xóa địa chỉ ngắn khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Bật/tắt tính năng so khớp nguồn cho khung đang chờ xử lý.
`otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Phương thức này bắt đầu trình tự truyền trên đài.

Typedef

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

Con trỏ hàm này khi nhận khung IEEE 802.15.4.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aEnergyScanMaxRssi`	RSSI tối đa gặp phải trên kênh được quét.

otLinkRawNhậnDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Con trỏ hàm này khi nhận khung IEEE 802.15.4.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aFrame`	Con trỏ đến khung đã nhận hoặc NULL nếu thao tác nhận đã bị hủy.
`[in] aError`	OT_ERROR_None khi nhận được khung. OT_ERROR_ABORT khi tiếp nhận bị huỷ và không nhận được khung.

otLinkRawTruyềnDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

Con trỏ hàm này khi nhận khung IEEE 802.15.4.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aFrame`	Con trỏ đến khung đã được truyền.
`[in] aAckFrame`	Con trỏ tới khung ACK.
`[in] aError`	OT_ERROR_AVAILABLE khi khung đã được truyền. OT_ERROR_NO_ACK khi khung được truyền nhưng không nhận được ACK khi OT_ERROR_CHANNEL_ACCESS_FAILURE khi không thể diễn ra quá trình truyền do hoạt động trên kênh. OT_ERROR_ABORT khi quá trình truyền bị huỷ vì các lý do khác.

Hàm

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

Phương thức này bắt đầu trình tự quét năng lượng trên đài.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aScanChannel`	Kênh cần quét năng lượng.
`[in] aScanDuration`	Thời lượng, tính bằng mili giây, để quét kênh.
`[in] aCallback`	Con trỏ đến hàm được gọi là hoàn thành kênh được quét.

Giá trị trả về

`OT_ERROR_NONE`	Đã bắt đầu quét kênh thành công.
`OT_ERROR_BUSY`	Đài này đang thực hiện quét tìm dữ liệu.
`OT_ERROR_NOT_IMPLEMENTED`	Đài không hỗ trợ quét năng lượng.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Tải các tính năng radio.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Trả về

vectơ bit công suất của đài. Ngăn xếp bật hoặc tắt một số hàm dựa trên giá trị này.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Hàm này nhận trạng thái của chế độ quảng cáo xen kẽ.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`true`	Chế độ đa năng đang bật.
`false`	Chế độ đa năng bị tắt.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Nhận thời gian hiện tại của nền tảng (chiều rộng 64 bit) của chip radio.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Trả về

Thời gian radio hiện tại tính bằng micrô giây.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Nhận kết quả đo RSSI mới nhất.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Trả về

RSSI tính bằng dBm khi hợp lệ. 127 khi RSSI không hợp lệ.

otLinkRawGetTruyềnBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Chuyển đổi radio từ Truyền sang Nhận.

Phương thức này trả về một con trỏ tới bộ đệm truyền.

Người gọi tạo khung IEEE 802.15.4 trong bộ đệm này, sau đó gọi otLinkRawTruyền() để yêu cầu truyền.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Trả về

Con trỏ đến bộ đệm truyền hoặc NULL nếu lớp liên kết thô không được bật.

Đã bật otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Hàm này cho biết liệu lớp liên kết thô có được bật hay không.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`true`	Lớp liên kết thô được bật.
`false`	Lớp liên kết thô đã bị vô hiệu hóa.

otLinkRawNhận

otError otLinkRawReceive(
  otInstance *aInstance
)

Tôi đang chuyển đài phát thanh từ chế độ Ngủ sang Nhận.

Bật đài.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang Nhận.
`OT_ERROR_INVALID_STATE`	Đài đã bị vô hiệu hóa hoặc truyền đi.

otLinkRawSetMacFrameBộ đếm

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Đặt giá trị bộ đếm khung MAC hiện tại.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aMacFrameCounter`	Giá trị bộ đếm khung MAC.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

Cập nhật khóa MAC và chỉ mục khóa.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aKeyIdMode`	Chế độ mã nhận dạng chính.
`[in] aKeyId`	Chỉ mục khóa.
`[in] aPrevKey`	Khóa MAC trước đó.
`[in] aCurrKey`	Khóa MAC hiện tại.
`[in] aNextKey`	Khóa MAC tiếp theo.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Chức năng này bật hoặc tắt chế độ liên tục.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aEnable`	Giá trị để bật hoặc tắt chế độ đa dạng.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSetSetDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Hàm này sẽ bật/tắt lớp liên kết thô.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aCallback`	Con trỏ đến hàm được gọi khi nhận khung IEEE 802.15.4. Giá trị NULL để vô hiệu hóa lớp liên kết thô.

Giá trị trả về

`OT_ERROR_FAILED`	Không thể bật/tắt đài.
`OT_ERROR_INVALID_STATE`	Nếu giao diện OpenThread IPv6 đã được bật.
`OT_ERROR_NONE`	Đã đặt thành công trạng thái bật.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Đặt Địa chỉ ngắn để lọc địa chỉ.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn IEEE 802.15.4.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Chuyển đổi đài phát từ Nhận sang chế độ ngủ.

Tắt đài.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang chế độ Ngủ.
`OT_ERROR_BUSY`	Đài đang truyền
`OT_ERROR_INVALID_STATE`	Đài đã bị vô hiệu hóa

otLinkRawSrcmatchAddExtSession

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

Thêm địa chỉ mở rộng vào bảng so khớp nguồn.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aExtAddress`	Địa chỉ mở rộng cần thêm.

Giá trị trả về

`OT_ERROR_NONE`	Đã thêm thành công địa chỉ mở rộng vào bảng so khớp nguồn.
`OT_ERROR_NO_BUFS`	Không có mục nhập nào trong bảng so khớp nguồn.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcMatchAddShortentry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Thêm địa chỉ ngắn vào bảng so khớp nguồn.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn mà bạn muốn thêm.

Giá trị trả về

`OT_ERROR_NONE`	Đã thêm thành công địa chỉ ngắn vào bảng so khớp nguồn.
`OT_ERROR_NO_BUFS`	Không có mục nhập nào trong bảng so khớp nguồn.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcmatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Xóa tất cả địa chỉ mở rộng khỏi bảng so khớp nguồn.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcmatchClearExtEntry

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

Đang xóa địa chỉ mở rộng khỏi bảng so khớp nguồn của đài.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aExtAddress`	Địa chỉ mở rộng cần xóa.

Giá trị trả về

`OT_ERROR_NONE`	Đã xóa thành công địa chỉ mở rộng khỏi bảng so khớp nguồn.
`OT_ERROR_NO_ADDRESS`	Địa chỉ mở rộng không nằm trong bảng so khớp nguồn.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcmatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Xóa tất cả các địa chỉ ngắn khỏi bảng so khớp nguồn.

Thông tin chi tiết

Các thông số

[in] aInstance

Con trỏ tới một thực thể của OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcmatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Đang xóa địa chỉ ngắn khỏi bảng so khớp nguồn.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn cần xoá.

Giá trị trả về

`OT_ERROR_NONE`	Đã xóa thành công địa chỉ ngắn khỏi bảng so khớp nguồn.
`OT_ERROR_NO_ADDRESS`	Địa chỉ ngắn không nằm trong bảng so khớp nguồn.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawSrcmatchEnabled

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Bật/tắt tính năng so khớp nguồn cho khung đang chờ xử lý.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aEnable`	Bật/tắt tính năng so khớp nguồn cho khung đang chờ xử lý.

Giá trị trả về

`OT_ERROR_NONE`	Nếu thành công.
`OT_ERROR_INVALID_STATE`	Nếu lớp liên kết thô không được bật.

otLinkRawTruyền

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Phương thức này bắt đầu trình tự truyền trên đài.

Người gọi phải tạo khung IEEE 802.15.4 trong bộ đệm do otLinkRawGetTruyềnBuffer() cung cấp trước khi yêu cầu truyền dữ liệu. Kênh và công suất truyền tải cũng được đưa vào cấu trúc otRadioFrame.

Trình tự truyền dữ liệu bao gồm:

Đang chuyển đổi đài phát sang Truyền từ Nhận.
Truyền PSDU trên kênh đã cho và ở công suất phát đã cho.

Thông tin chi tiết

Các thông số

`[in] aInstance`	Con trỏ tới một thực thể của OpenThread.
`[in] aCallback`	Con trỏ đến hàm được gọi khi hoàn tất quá trình truyền.

Giá trị trả về

`OT_ERROR_NONE`	Đã chuyển thành công sang đường truyền.
`OT_ERROR_INVALID_STATE`	Đài không ở trạng thái Nhận.

Tài nguyên

Các chủ đề về Tham chiếu API OpenThread được tạo từ mã nguồn, có sẵn 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 phần Tài nguyên.