Liên kết thô

Mô-đun này bao gồm các chức năng điều khiển cấu hình lớp liên kết thô.

Tóm lược

Typedefs
`otLinkRawEnergyScanDone )(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Con trỏ hàm này khi nhận được khung IEEE 802.15.4.
`otLinkRawReceiveDone )(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Con trỏ chức năng này khi nhận được 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 được khung IEEE 802.15.4.

Chức năng
`otLinkRawEnergyScan ( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Phương pháp này bắt đầu chuỗi quét năng lượng trên đài.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` Nhận các khả năng vô tuyến.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` Chức năng này nhận được trạng thái của chế độ lăng nhăng.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` Nhận thời gian nền tảng hiện tại (chiều rộng 64bits) của chip radio.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` Nhận phép đo RSSI gần đây nhất.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` Bộ đàm chuyển đổi từ Truyền sang Nhận.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` Chức năng 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` Chuyển radio từ 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ế độ lăng nhăng.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Chức năng này bật / tắt lớp liên kết thô.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Đặt Địa chỉ rút gọn để lọc địa chỉ.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` Chuyển radio từ Nhận sang Ngủ.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Thêm địa chỉ mở rộng vào bảng đối sánh nguồn.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Thêm địa chỉ ngắn vào bảng đối sánh nguồn.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` Xóa tất cả các địa chỉ mở rộng khỏi bảng đối sánh nguồn.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Xóa địa chỉ mở rộng cho bảng đối sánh nguồn của radio.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` Xóa tất cả các địa chỉ ngắn khỏi bảng đối sánh nguồn.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Xóa địa chỉ ngắn cho bảng đối sánh nguồn.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` Bật / Tắt đối sánh nguồn cho khung đang chờ xử lý.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Phương pháp này bắt đầu trình tự phát trên radio.

Typedefs

otLinkRawEnergyScanDone

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

Con trỏ chức năng này khi nhận được khung IEEE 802.15.4.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aEnergyScanMaxRssi`	RSSI tối đa gặp phải trên kênh đã quét.

otLinkRawReceiveDone

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

Con trỏ chức năng này khi nhận được khung IEEE 802.15.4.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aFrame`	Một con trỏ đến khung đã nhận hoặc NULL nếu hoạt động nhận bị hủy bỏ.
`[in] aError`	OT_ERROR_NONE khi nhận khung thành công. OT_ERROR_ABORT khi quá trình tiếp nhận bị hủy bỏ và không nhận được khung.

otLinkRawTransmitDone

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

Con trỏ chức năng này khi nhận được khung IEEE 802.15.4.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aFrame`	Một con trỏ đến khung đã được truyền.
`[in] aAckFrame`	Một con trỏ đến khung ACK.
`[in] aError`	OT_ERROR_NONE khi khung được truyền. OT_ERROR_NO_ACK khi khung được truyền nhưng không nhận được ACK OT_ERROR_CHANNEL_ACCESS_FAILURE khi quá trình truyền không thể diễn ra do hoạt động trên kênh. OT_ERROR_ABORT khi quá trình truyền bị hủy bỏ vì những lý do khác.

Chức năng

otLinkRawEnergyScan

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

Phương pháp này bắt đầu chuỗi quét năng lượng trên radio.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aScanChannel`	Kênh để thực hiện quét năng lượng.
`[in] aScanDuration`	Thời lượng, tính bằng mili giây, cho kênh được quét.
`[in] aCallback`	Một con trỏ đến một hàm được gọi khi hoàn thành một kênh đã quét.

Giá trị trả lại

`OT_ERROR_NONE`	Đã bắt đầu quét kênh thành cô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
)

Nhận các khả năng vô tuyến.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Lợi nhuận

Vectơ bit khả năng vô tuyến. Ngăn xếp bật hoặc tắt một số chức năng dựa trên giá trị này.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Chức năng này nhận được trạng thái của chế độ lăng nhăng.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

`true`	Chế độ lăng nhăng được bật.
`false`	Chế độ lăng nhăng bị tắt.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

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

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Lợi nhuận

Thời gian vô tuyến hiện tại tính bằng micro giây.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Nhận phép đo RSSI gần đây nhất.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Lợi nhuận

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

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Bộ đàm chuyển đổi 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 otLinkRawTransmit () để yêu cầu truyền.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Lợi nhuận

Một con trỏ đến bộ đệ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
)

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

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

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

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Chuyển radio từ Ngủ sang Nhận.

Bật đài.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang Nhận.
`OT_ERROR_INVALID_STATE`	Đài đã bị tắt hoặc đang truyền.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aMacFrameCounter`	Giá trị bộ đếm khung MAC.

Giá trị trả lại

`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 các khóa MAC và chỉ mục khóa.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aKeyIdMode`	Chế độ ID chính.
`[in] aKeyId`	Chỉ số quan trọng.
`[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ả lại

`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ế độ lăng nhăng.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aEnable`	Giá trị để bật hoặc tắt chế độ quảng cáo.

Giá trị trả lại

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

Chức năng này bật / tắt lớp liên kết thô.

Chi tiết

Thông số

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

Giá trị trả lại

`OT_ERROR_FAILED`	Không thể bật / tắt radio.
`OT_ERROR_INVALID_STATE`	Nếu giao diện OpenThread Ip6 đã được bật.
`OT_ERROR_NONE`	Nếu trạng thái kích hoạt đã được thiết lập thành công.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Đặt Địa chỉ rút gọn để lọc địa chỉ.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn IEEE 802.15.4.

Giá trị trả lại

`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 radio từ Nhận sang Ngủ.

Tắt radio.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang chế độ Ngủ.
`OT_ERROR_BUSY`	Đài phát thanh đang truyền
`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 đối sánh nguồn.

Chi tiết

Thông số

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

Giá trị trả lại

`OT_ERROR_NONE`	Đã thêm thành công địa chỉ mở rộng vào bảng đối sánh nguồn.
`OT_ERROR_NO_BUFS`	Không có mục nhập nào trong bảng đối sánh 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 đối sánh nguồn.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn sẽ được thêm vào.

Giá trị trả lại

`OT_ERROR_NONE`	Đã thêm thành công địa chỉ ngắn vào bảng đối sánh nguồn.
`OT_ERROR_NO_BUFS`	Không có mục nhập nào trong bảng đối sánh 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ả các địa chỉ mở rộng khỏi bảng đối sánh nguồn.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

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

Xóa địa chỉ mở rộng cho bảng đối sánh nguồn của radio.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aExtAddress`	Địa chỉ mở rộng sẽ bị xóa.

Giá trị trả lại

`OT_ERROR_NONE`	Đã xóa thành công địa chỉ mở rộng khỏi bảng đối sánh nguồn.
`OT_ERROR_NO_ADDRESS`	Địa chỉ mở rộng không có trong bảng đối sánh 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 đối sánh nguồn.

Chi tiết

Thông số

[in] aInstance

Một con trỏ đến một phiên bản OpenThread.

Giá trị trả lại

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

Xóa địa chỉ ngắn cho bảng đối sánh nguồn.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aShortAddress`	Địa chỉ ngắn cần được xóa.

Giá trị trả lại

`OT_ERROR_NONE`	Đã xóa thành công địa chỉ ngắn khỏi bảng đối sánh nguồn.
`OT_ERROR_NO_ADDRESS`	Địa chỉ ngắn không có trong bảng đối sánh 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 đối sánh nguồn cho khung đang chờ xử lý.

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aEnable`	Bật / tắt đối sánh nguồn cho khung đang chờ xử lý.

Giá trị trả lại

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

Phương pháp này bắt đầu trình tự phát trên radio.

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

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

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

Chi tiết

Thông số

`[in] aInstance`	Một con trỏ đến một phiên bản OpenThread.
`[in] aCallback`	Một con trỏ đến một hàm được gọi khi hoàn thành quá trình truyền.

Giá trị trả lại

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