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.

BLE

Mô-đun này bao gồm tính năng tóm tắt nền tảng để giao tiếp với Máy chủ BLE.

Tóm tắt

Nền tảng này cần triển khai Bluetooth LE 4.2 trở lên.

Typedef
`otBleRadioPacket`	typedef `struct otBleRadioPacket` Đại diện cho gói BLE.

Hàm
`otPlatBleDisable(otInstance *aInstance)`	`otError` Tắt đài phát Bluetooth năng lượng thấp.
`otPlatBleEnable(otInstance *aInstance)`	`otError` Bật đài phát Bluetooth năng lượng thấp.
`otPlatBleGapAdvStart(otInstance *aInstance, uint16_t aInterval)`	`otError` Bắt đầu quy trình Quảng cáo BLE.
`otPlatBleGapAdvStop(otInstance *aInstance)`	`otError` Dừng quy trình Quảng cáo BLE.
`otPlatBleGapDisconnect(otInstance *aInstance)`	`otError` Ngắt kết nối BLE.
`otPlatBleGapOnConnected(otInstance *aInstance, uint16_t aConnectionId)`	`void` Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng một Thiết bị trung tâm BLE đã được kết nối.
`otPlatBleGapOnDisconnected(otInstance *aInstance, uint16_t aConnectionId)`	`void` Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng Thiết bị trung tâm BLE đã bị ngắt kết nối.
`otPlatBleGattMtuGet(otInstance aInstance, uint16_t aMtu)`	`otError` Các lượt đọc hiện sử dụng giá trị ATT_MTU.
`otPlatBleGattOnMtuUpdate(otInstance *aInstance, uint16_t aMtu)`	`void` Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng ATT_MTU đã được cập nhật.
`otPlatBleGattServerIndicate(otInstance aInstance, uint16_t aHandle, const otBleRadioPacket aPacket)`	`otError` Gửi chỉ báo giá trị tên người dùng theo ATT.
`otPlatBleGattServerOnWriteRequest(otInstance aInstance, uint16_t aHandle, const otBleRadioPacket aPacket)`	`void` Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng đã nhận được gói Yêu cầu ghi ATT.

Cấu trúc
otBleRadioPacket	Đại diện cho gói BLE.

Typedef

otBleRadioPacket

struct otBleRadioPacket otBleRadioPacket

Đại diện cho gói BLE.

Hàm

otPlatBleDisable

otError otPlatBleDisable(
  otInstance *aInstance
)

Tắt đài phát Bluetooth năng lượng thấp.

Khi bạn tắt chính sách này, ngăn xếp BLE sẽ xoá hàng đợi sự kiện và không tạo sự kiện mới. Thiết bị ngoại vi BLE bị tắt hoặc chuyển sang trạng thái ngủ khi pin yếu. Mọi bộ nhớ động mà ngăn xếp sử dụng sẽ được giải phóng, nhưng có thể vẫn sẽ dành riêng bộ nhớ tĩnh.

Thông tin chi tiết

Thông số

[in] aInstance

Cấu trúc thực thể OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Đã chuyển đổi thành công sang trạng thái tắt.
`OT_ERROR_FAILED`	Không thể tắt đài BLE.

otPlatBleEnable

otError otPlatBleEnable(
  otInstance *aInstance
)

Bật đài phát Bluetooth năng lượng thấp.

Thông tin chi tiết

Thông số

[in] aInstance

Cấu trúc thực thể OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Đã bật thành công.
`OT_ERROR_FAILED`	Không thể bật đài BLE.

otPlatBleGapAdvStart

otError otPlatBleGapAdvStart(
  otInstance *aInstance,
  uint16_t aInterval
)

Bắt đầu quy trình Quảng cáo BLE.

Thiết bị BLE sẽ sử dụng quảng cáo không được chuyển hướng và không áp dụng bộ lọc. Bạn phải gửi một gói Quảng cáo BLE trên tất cả các kênh quảng cáo (37, 38 và 39).

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aInterval`	Khoảng thời gian giữa các gói quảng cáo tiếp theo trong đơn vị OT_BLE_ADV_INTERVAL_UNIT. Phải nằm trong phạm vi OT_BLE_ADV_INTERVAL_MIN và OT_BLE_ADV_INTERVAL_MAX hoặc OT_BLE_ADV_INTERVAL_DEFAULT cho một giá trị mặc định được đặt tại thời gian biên dịch.

Giá trị trả về

`OT_ERROR_NONE`	Quy trình quảng cáo đã được bắt đầu.
`OT_ERROR_INVALID_STATE`	Thiết bị BLE đang ở trạng thái không hợp lệ.
`OT_ERROR_INVALID_ARGS`	Giá trị khoảng thời gian không hợp lệ đã được cung cấp.

otPlatBleGapAdvStop

otError otPlatBleGapAdvStop(
  otInstance *aInstance
)

Dừng quy trình Quảng cáo BLE.

Thông tin chi tiết

Thông số

[in] aInstance

Cấu trúc thực thể OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Quy trình quảng cáo đã dừng.
`OT_ERROR_INVALID_STATE`	Thiết bị BLE đang ở trạng thái không hợp lệ.

otPlatBleGapDisconnect

otError otPlatBleGapDisconnect(
  otInstance *aInstance
)

Ngắt kết nối BLE.

Thiết bị BLE phải sử dụng mã lý do Kết nối bị chấm dứt do người dùng từ xa (0x13) khi ngắt kết nối khỏi thiết bị BLE ngang hàng.

Thông tin chi tiết

Thông số

[in] aInstance

Cấu trúc thực thể OpenThread.

Giá trị trả về

`OT_ERROR_NONE`	Quy trình ngắt kết nối đã bắt đầu.
`OT_ERROR_INVALID_STATE`	Thiết bị BLE đang ở trạng thái không hợp lệ.

otPlatBleGapOnConnected

void otPlatBleGapOnConnected(
  otInstance *aInstance,
  uint16_t aConnectionId
)

Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng một Thiết bị trung tâm BLE đã được kết nối.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aConnectionId`	Giá trị nhận dạng của kết nối mở.

otPlatBleGapOnDisconnected

void otPlatBleGapOnDisconnected(
  otInstance *aInstance,
  uint16_t aConnectionId
)

Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng Thiết bị trung tâm BLE đã bị ngắt kết nối.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aConnectionId`	Giá trị nhận dạng của kết nối đã đóng.

otPlatBleGattMtuGet

otError otPlatBleGattMtuGet(
  otInstance *aInstance,
  uint16_t *aMtu
)

Các lượt đọc hiện sử dụng giá trị ATT_MTU.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[out] aMtu`	Một con trỏ để xuất giá trị ATT_MTU hiện tại.

Giá trị trả về

`OT_ERROR_NONE`	Giá trị ATT_MTU đã được đặt trong `aMtu`.
`OT_ERROR_FAILED`	Thiết bị BLE không thể xác định ATT_MTU của thiết bị.

otPlatBleGattOnMtuUpdate

void otPlatBleGattOnMtuUpdate(
  otInstance *aInstance,
  uint16_t aMtu
)

Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng ATT_MTU đã được cập nhật.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aMtu`	Giá trị ATT_MTU đã cập nhật.

otPlatBleGattServerIndicate

otError otPlatBleGattServerIndicate(
  otInstance *aInstance,
  uint16_t aHandle,
  const otBleRadioPacket *aPacket
)

Gửi chỉ báo giá trị tên người dùng theo ATT.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aHandle`	Tên người dùng của thuộc tính cần biểu thị.
`[in] aPacket`	Con trỏ đến gói chứa giá trị cần chỉ ra.

Giá trị trả về

`OT_ERROR_NONE`	Đã gửi Chỉ báo giá trị tên người dùng ATT.
`OT_ERROR_INVALID_STATE`	Thiết bị BLE đang ở trạng thái không hợp lệ.
`OT_ERROR_INVALID_ARGS`	Giá trị xử lý không hợp lệ, dữ liệu hoặc độ dài dữ liệu đã được cung cấp.
`OT_ERROR_NO_BUFS`	Không tìm thấy vùng đệm nội bộ nào.

otPlatBleGattServerOnWriteRequest

void otPlatBleGattServerOnWriteRequest(
  otInstance *aInstance,
  uint16_t aHandle,
  const otBleRadioPacket *aPacket
)

Trình điều khiển BLE gọi phương thức này để thông báo cho OpenThread rằng đã nhận được gói Yêu cầu ghi ATT.

Thông tin chi tiết

Thông số

`[in] aInstance`	Cấu trúc thực thể OpenThread.
`[in] aHandle`	Tên người dùng của thuộc tính được viết.
`[in] aPacket`	Con trỏ đến gói chứa giá trị sẽ được ghi vào thuộc tính.

Macro

OT_BLE_ADV_INTERVAL_DEFAULT

 OT_BLE_ADV_INTERVAL_DEFAULT 100

Khoảng thời gian mặc định cho gói quảng cáo (mili giây).

OT_BLE_ADV_INTERVAL_MAX

 OT_BLE_ADV_INTERVAL_MAX 0x4000

Khoảng thời gian tối đa cho phép đối với gói quảng cáo bằng đơn vị OT_BLE_ADV_INTERVAL_UNIT (10,24 giây).

OT_BLE_ADV_INTERVAL_MIN

 OT_BLE_ADV_INTERVAL_MIN 0x0020

Khoảng thời gian cho phép tối thiểu cho gói quảng cáo bằng đơn vị OT_BLE_ADV_INTERVAL_UNIT (20 mili giây).

OT_BLE_ADV_INTERVAL_UNIT

 OT_BLE_ADV_INTERVAL_UNIT OT_BLE_TIMESLOT_UNIT

Đơn vị dùng để tính toán khoảng thời gian (0,625 mili giây).

OT_BLE_ATT_MTU_MAX

 OT_BLE_ATT_MTU_MAX 67

Kích thước MTU ATT tối đa được phép (phải lớn hơn 23).

OT_BLE_DEFAULT_POWER

 OT_BLE_DEFAULT_POWER 0

Giá trị nguồn mặc định cho BLE.

OT_BLE_TIMESLOT_UNIT

 OT_BLE_TIMESLOT_UNIT 625

Thời lượng khe thời gian trên lớp PHY tính bằng micrô giây (0,625 mili 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.