Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

Đườ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ỏ khi nhận được khung IEEE 802.15.4.
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Con trỏ khi nhận được khung IEEE 802.15.4.
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Con trỏ khi nhận được khung IEEE 802.15.4.

Hàm
`otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Bắt đầu trình tự quét năng lượng trên đài.
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` Khai thác các chức năng của đài phát thanh.
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` Nhận trạng thái của chế độ hỗn tạp.
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` Nhận thời gian nền tảng hiện tại (chiều rộng 64 bit) của chip radio.
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` Nhận kết quả đo lường RSSI mới nhất.
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` Quá trình chuyển đổi vô tuyến từ Truyền sang Nhận.
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` 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 từ chế độ Ngủ sang chế độ Nhận.
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Đặt giá trị bộ đếm khung MAC hiện tại.
`otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Chỉ thiết lập giá trị bộ đếm khung MAC hiện tại nếu giá trị mới lớn hơn giá trị 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 khoá MAC và chỉ mục khoá.
`otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)`	`otError` Bật hoặc tắt chế độ hỗn tạp.
`otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` 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 từ chế độ 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` Đang thêm địa chỉ ngắn vào bảng so khớp nguồn.
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` Xoá tất cả địa chỉ mở rộng khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Xoá địa chỉ mở rộng cho bảng so khớp nguồn của đài.
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` Đang xoá tất cả địa chỉ ngắn khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` Đang xoá địa chỉ ngắn khỏi bảng so khớp nguồn.
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` Bật/tắt chế độ so khớp nguồn cho khung đang chờ xử lý.
`otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Bắt đầu trình tự truyền trên đài.

Typedef

otLinkRawEnergyScanDone

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

Con trỏ khi nhận được khung 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] aEnergyScanMaxRssi`	RSSI tối đa đạt được trên kênh được quét.

otLinkRawReceiveDone

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

Con trỏ khi nhận được khung 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] aFrame`	Con trỏ đến khung đã nhận hoặc NULL nếu thao tác nhận bị huỷ.
`[in] aError`	OT_ERROR_NONE khi nhận được khung hình thành công. OT_ERROR_ABORT khi quá trình thu nhận bị hủy và không nhận được khung hình.

otLinkRawTransmitDone

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

Con trỏ khi nhận được khung 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] aFrame`	Con trỏ đến khung đã được truyền.
`[in] aAckFrame`	Con trỏ đến khung ACK.
`[in] aError`	OT_ERROR_NONE khi khung hình được truyền. OT_ERROR_NO_ACK khi khung được truyền nhưng không nhận ACK nào OT_ERROR_CHANNEL_ACCESS_FAILURE khi quá trình truyền không thể diễn ra do có hoạt động trên kênh. OT_ERROR_ABORT khi quá trình truyền bị hủy vì lý do khác.

Hàm

otLinkRawEnergyScan

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

Bắt đầu trình tự quét năng lượng trên đài.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aScanChannel`	Kênh sẽ 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 một hàm được gọi khi hoàn tất một kênh đã quét.

Giá trị trả về

`OT_ERROR_NONE`	Bắt đầu quét kênh thành công.
`OT_ERROR_BUSY`	Đài đang thực hiện quét năng lượng.
`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
)

Khai thác các chức năng của đài phát thanh.

Thông tin chi tiết

Thông số

[in] aInstance

Con trỏ đến một thực thể OpenThread.

Trả về

Vectơ bit chức năng vô tuyến. 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
)

Nhận trạng thái của chế độ hỗn tạp.

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`	Đã tắt chế độ Nhược điểm.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

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

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 radio hiện tại tính bằng micrô giây.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

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

Thông tin chi tiết

Thông số

[in] aInstance

Con trỏ đến một thực thể OpenThread.

Trả về

RSSI tính bằng dBm khi giá trị này hợp lệ. 127 khi RSSI không hợp lệ.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Quá trình chuyển đổi vô tuyến từ Truyền sang Nhận.

Trả về một con trỏ tới vùng đệm truyền.

Phương thức gọi sẽ tạo khung IEEE 802.15.4 trong vùng đệm này rồi gọi otLinkRawTransmit() để yêu cầu truyền dữ liệu.

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 vùng đệm truyền hoặc NULL nếu lớp liên kết thô không được bật.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

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

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 thô được bật.
`false`	Lớp liên kết thô bị vô hiệu hoá.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

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

Bật đài.

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`	Đã chuyển thành công sang chế độ Nhận.
`OT_ERROR_INVALID_STATE`	Đài đã bị tắt hoặc đang truyền đi.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

Luôn đặt bộ đếm MAC là giá trị mới cho trước aMacFrameCounter độc lập với giá trị hiện tại.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể 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.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Chỉ thiết lập giá trị bộ đếm khung MAC hiện tại nếu giá trị mới lớn hơn giá trị hiện tại.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể 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 khoá MAC và chỉ mục khoá.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aKeyIdMode`	Chế độ giá trị nhận dạng khoá.
`[in] aKeyId`	Chỉ mục khoá.
`[in] aPrevKey`	Khoá MAC trước đó.
`[in] aCurrKey`	Khoá MAC hiện tại.
`[in] aNextKey`	Khoá 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
)

Bật hoặc tắt chế độ hỗn tạp.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aEnable`	Một giá trị để bật hoặc tắt chế độ hỗn tạp.

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.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Bật/tắt lớp liên kết thô.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aCallback`	Con trỏ trỏ đến hàm được gọi khi nhận khung IEEE 802.15.4. NULL (Rỗng) để tắt lớp đường 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`	Nếu trạng thái bật đã được đặt thành công.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

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

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn của 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 từ chế độ Nhận sang chế độ Ngủ.

Tắt đài.

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`	Đã chuyển đổi thành công sang chế độ Ngủ.
`OT_ERROR_BUSY`	Đài đang truyền đi
`OT_ERROR_INVALID_STATE`	Đài đã bị tắt

otLinkRawSrcMatchAddExtEntry

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

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aExtAddress`	Địa chỉ mở rộng sẽ được thêm vào.

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 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
)

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

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn sẽ được 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 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
)

Xoá tất cả địa chỉ mở rộng khỏi bảng so khớp nguồ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`	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
)

Xoá địa chỉ mở rộng cho bảng so khớp nguồn của đài.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể OpenThread.
`[in] aExtAddress`	Địa chỉ mở rộng cần được xoá.

Giá trị trả về

`OT_ERROR_NONE`	Đã xoá 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 có 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
)

Đang xoá tất cả địa chỉ ngắn khỏi bảng so khớp nguồ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`	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 xoá địa chỉ ngắn khỏi bảng so khớp nguồn.

Thông tin chi tiết

Thông số

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

Giá trị trả về

`OT_ERROR_NONE`	Đã xoá thành công địa chỉ ngắn khỏi bảng so khớp nguồn.
`OT_ERROR_NO_ADDRESS`	Địa chỉ rút gọn không có 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.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Bật/tắt chế độ so khớp nguồn cho khung đang chờ xử lý.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một thực thể 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.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Bắt đầu trình tự truyền trên đài.

Phương thức gọi phải tạo khung IEEE 802.15.4 trong vùng đệm do otLinkRawGetTransmitBuffer() cung cấp trước khi yêu cầu truyền. Kênh và công suất truyền cũng có trong cấu trúc otRadioFrame.

Trình tự truyền bao gồm:

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

Thông tin chi tiết

Thông số

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

Giá trị trả về

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang Bên truyền.
`OT_ERROR_INVALID_STATE`	Đài không ở trạng thái Đang nhận.

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.