Các loại sóng vô tuyến

Mô-đun này bao gồm tính năng trừu tượng của nền tảng cho khung radio.

Tóm tắt

Bảng liệt kê

anonymous enum{
  OT_RADIO_FRAME_MAX_SIZE = 127,
  OT_RADIO_FRAME_MIN_SIZE = 3,
  OT_RADIO_SYMBOLS_PER_OCTET = 2,
  OT_RADIO_BIT_RATE = 250000,
  OT_RADIO_BITS_PER_OCTET = 8,
  OT_RADIO_SYMBOL_RATE = 62500,
  OT_RADIO_SYMBOL_TIME = 1000000 * 1 / OT_RADIO_SYMBOL_RATE,
  OT_RADIO_TEN_SYMBOLS_TIME = 10 * OT_RADIO_SYMBOL_TIME,
  OT_RADIO_LQI_NONE = 0,
  OT_RADIO_RSSI_INVALID = 127,
  OT_RADIO_POWER_INVALID = 127
}
enum
anonymous enum{
  OT_RADIO_CHANNEL_PAGE_0 = 0,
  OT_RADIO_CHANNEL_PAGE_0_MASK = (1U << OT_RADIO_CHANNEL_PAGE_0),
  OT_RADIO_CHANNEL_PAGE_2 = 2,
  OT_RADIO_CHANNEL_PAGE_2_MASK = (1U << OT_RADIO_CHANNEL_PAGE_2)
}
enum
Xác định trang kênh.
anonymous enum{
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN = 1,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX = 10,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK = 0x3ff << OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN = 11,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX = 26,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK = 0xffff << OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN
}
enum
Xác định phạm vi kênh dải tần số.
anonymous enum{
  OT_RADIO_CAPS_NONE = 0,
  OT_RADIO_CAPS_ACK_TIMEOUT = 1 << 0,
  OT_RADIO_CAPS_ENERGY_SCAN = 1 << 1,
  OT_RADIO_CAPS_TRANSMIT_RETRIES = 1 << 2,
  OT_RADIO_CAPS_CSMA_BACKOFF = 1 << 3,
  OT_RADIO_CAPS_SLEEP_TO_TX = 1 << 4,
  OT_RADIO_CAPS_TRANSMIT_SEC = 1 << 5,
  OT_RADIO_CAPS_TRANSMIT_TIMING = 1 << 6,
  OT_RADIO_CAPS_RECEIVE_TIMING = 1 << 7,
  OT_RADIO_CAPS_RX_ON_WHEN_IDLE = 1 << 8
}
enum
Xác định các hằng số dùng để biểu thị các chức năng vô tuyến.
anonymous enum{
  OT_IE_HEADER_SIZE = 2,
  OT_CSL_IE_SIZE = 4,
  OT_ACK_IE_MAX_SIZE = 16,
  OT_ENH_PROBING_IE_DATA_MAX_SIZE = 2
}
enum
Xác định các hằng số về kích thước của tiêu đề IE trong ACK.
otRadioKeyType{
  OT_KEY_TYPE_LITERAL_KEY = 0,
  OT_KEY_TYPE_KEY_REF = 1
}
enum
Xác định hằng số cho các kiểu khoá.
otRadioState enum
Biểu thị trạng thái của đài.

Typedef

otExtAddress typedef
struct otExtAddress
Đại diện cho Địa chỉ mở rộng IEEE 802.15.4.
otLinkMetrics typedef
struct otLinkMetrics
Đại diện cho các chỉ số được chỉ định để truy vấn.
otMacKey typedef
struct otMacKey
Đại diện cho Khoá MAC.
otMacKeyMaterial typedef
otMacKeyRef typedef
Đại diện cho Tham chiếu khoá MAC mà PSA sử dụng.
otPanId typedef
uint16_t
Đại diện cho mã nhận dạng PAN của IEEE 802.15.4.
otRadioCaps typedef
uint16_t
Biểu thị các chức năng radio.
otRadioCoexMetrics typedef
Sau đây là các quá trình chuyển đổi trạng thái radio hợp lệ:
otRadioFrame typedef
struct otRadioFrame
Đại diện cho khung radio IEEE 802.15.4.
otRadioIeInfo typedef
struct otRadioIeInfo
Biểu thị thông tin liên quan đến IEEE 802.15.4 Tiêu đề IE (Thông tin) của khung radio.
otRadioState typedef
Biểu thị trạng thái của đài.
otShortAddress typedef
uint16_t
Đại diện cho Địa chỉ ngắn của IEEE 802.15.4.

Biến

OT_TOOL_PACKED_END

Cấu trúc

otExtAddress

Đại diện cho Địa chỉ mở rộng IEEE 802.15.4.

otLinkMetrics

Đại diện cho các chỉ số được chỉ định để truy vấn.

otMacKey

Đại diện cho Khoá MAC.

otMacKeyMaterial

Đại diện cho Khoá MAC.

otRadioCoexMetrics

Sau đây là các quá trình chuyển đổi trạng thái radio hợp lệ:

otRadioFrame

Đại diện cho khung radio IEEE 802.15.4.

otRadioIeInfo

Biểu thị thông tin liên quan đến IEEE 802.15.4 Tiêu đề IE (Thông tin) của khung radio.

Bảng liệt kê

enum ẩn danh

 anonymous enum
Thuộc tính
OT_RADIO_BITS_PER_OCTET

Số bit trên mỗi octet.

OT_RADIO_BIT_RATE

2,4 GHz IEEE 802.15.4 (bit/giây)

OT_RADIO_FRAME_MAX_SIZE

aMaxPHYPacketSize (IEEE 802.15.4-2006)

OT_RADIO_FRAME_MIN_SIZE

Kích thước tối thiểu của khung hình FCS + CONTROL.

OT_RADIO_LQI_NONE

Không hỗ trợ đo lường LQI.

OT_RADIO_POWER_INVALID

Giá trị nguồn điện không hợp lệ hoặc không xác định.

OT_RADIO_RSSI_INVALID

Giá trị RSSI không hợp lệ hoặc không xác định.

OT_RADIO_SYMBOLS_PER_OCTET

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_SYMBOL_RATE

Tỷ lệ ký hiệu O-QPSK PHY khi hoạt động ở các tần số 780 MHz, 915 MHz, 2380 MHz, 2450 MHz.

OT_RADIO_SYMBOL_TIME

Thời gian biểu tượng tính bằng đơn vị micrô giây.

OT_RADIO_TEN_SYMBOLS_TIME

Thời gian cho 10 ký hiệu tính bằng đơn vị micrô giây.

enum ẩn danh

 anonymous enum

Xác định trang kênh.

Thuộc tính
OT_RADIO_CHANNEL_PAGE_0

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_0_MASK

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2

915 MHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2_MASK

915 MHz IEEE 802.15.4-2006

enum ẩn danh

 anonymous enum

Xác định phạm vi kênh dải tần số.

Thuộc tính
OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN

2,4 GHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK

915 MHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX

915 MHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN

915 MHz IEEE 802.15.4-2006

enum ẩn danh

 anonymous enum

Xác định các hằng số dùng để biểu thị các chức năng vô tuyến.

Vui lòng xem otRadioCaps.

Thuộc tính
OT_RADIO_CAPS_ACK_TIMEOUT

Radio hỗ trợ sự kiện AckTime.

OT_RADIO_CAPS_CSMA_BACKOFF

Radio hỗ trợ thời gian đợi CSMA để truyền khung (nhưng không thể thử lại).

OT_RADIO_CAPS_ENERGY_SCAN

Radio hỗ trợ tính năng Quét năng lượng.

OT_RADIO_CAPS_NONE

Radio không hỗ trợ tính năng nào.

OT_RADIO_CAPS_RECEIVE_TIMING

Đài hỗ trợ rx tại một thời điểm cụ thể.

OT_RADIO_CAPS_RX_ON_WHEN_IDLE

Radio hỗ trợ xử lý RxOnWhenIdle.

OT_RADIO_CAPS_SLEEP_TO_TX

Radio hỗ trợ chuyển đổi trực tiếp từ chế độ ngủ sang TX bằng CSMA.

OT_RADIO_CAPS_TRANSMIT_RETRIES

Radio hỗ trợ logic thử lại tx có tính năng tránh xung đột (CSMA).

OT_RADIO_CAPS_TRANSMIT_SEC

Radio có hỗ trợ tính năng bảo mật thiết bị đầu cuối.

OT_RADIO_CAPS_TRANSMIT_TIMING

Đài hỗ trợ thiết bị giao tiếp vào thời điểm cụ thể.

enum ẩn danh

 anonymous enum

Xác định các hằng số về kích thước của tiêu đề IE trong ACK.

Thuộc tính
OT_ACK_IE_MAX_SIZE

Độ dài tối đa cho tiêu đề IE trong ACK.

OT_CSL_IE_SIZE

Kích thước của nội dung CSL IE tính bằng byte.

OT_ENH_PROBING_IE_DATA_MAX_SIZE

Độ dài tối đa của dữ liệu Chỉ số liên kết trên IE của nhà cung cấp cụ thể.

OT_IE_HEADER_SIZE

Kích thước của tiêu đề IE tính bằng byte.

otRadioKeyType

 otRadioKeyType

Xác định hằng số cho các kiểu khoá.

Thuộc tính
OT_KEY_TYPE_KEY_REF

Sử dụng mã tham chiếu đến khoá.

OT_KEY_TYPE_LITERAL_KEY

Sử dụng Khoá viết tay.

otRadioState

 otRadioState

Biểu thị trạng thái của đài.

Ban đầu, đài ở trạng thái Tắt.

Typedef

otExtAddress

struct otExtAddress otExtAddress

Đại diện cho Địa chỉ mở rộng IEEE 802.15.4.

otLinkMetrics

struct otLinkMetrics otLinkMetrics

Đại diện cho các chỉ số được chỉ định để truy vấn.

otMacKey

struct otMacKey otMacKey

Đại diện cho Khoá MAC.

otMacKeyMaterial

struct otMacKeyMaterial otMacKeyMaterial

otMacKeyRef

otCryptoKeyRef otMacKeyRef

Đại diện cho Tham chiếu khoá MAC mà PSA sử dụng.

otPanId

uint16_t otPanId

Đại diện cho mã nhận dạng PAN của IEEE 802.15.4.

otRadioCaps

uint16_t otRadioCaps

Biểu thị các chức năng radio.

Giá trị là trường bit cho biết các chức năng mà đài hỗ trợ. Xem định nghĩa OT_RADIO_CAPS_*.

otRadioCoexMetrics

struct otRadioCoexMetrics otRadioCoexMetrics

Sau đây là các quá trình chuyển đổi trạng thái radio hợp lệ:

(Bật đài) +----+ Bật() +-+ Nhận() +---+ Truyền() +----+ | |----->| |----->| |-------->| | Đã tắt | | Ngủ | | Nhận | | Truyền | |<-----| |<-----| |<--------| | +---+ Tắt() +-+ Tín hiệu Radio() +---+ Nhận + ---+ Tín hiệu Radio() +---+ Nhận + ----

Trong lệnh yêu cầu dữ liệu IEEE 802.15.4, lệnh chuyển đổi Sleep->Receive->Phát có thể được rút ngắn để chuyển đổi trực tiếp từ chế độ Ngủ sang chế độ Phát nếu nền tảng hỗ trợ chức năng OT_Radio_CAPS_SLEEP_TO_TX. Biểu thị các chỉ số cùng tồn tại qua sóng vô tuyến.

otRadioFrame

struct otRadioFrame otRadioFrame

Đại diện cho khung radio IEEE 802.15.4.

otRadioIeInfo

struct otRadioIeInfo otRadioIeInfo

Biểu thị thông tin liên quan đến IEEE 802.15.4 Tiêu đề IE (Thông tin) của khung radio.

otRadioState

enum otRadioState otRadioState

Biểu thị trạng thái của đài.

Ban đầu, đài ở trạng thái Tắt.

otShortAddress

uint16_t otShortAddress

Đại diện cho Địa chỉ ngắn của IEEE 802.15.4.

Biến

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otExtAddress OT_TOOL_PACKED_END

Macro

CSL_IE_HEADER_BYTES_HI

 CSL_IE_HEADER_BYTES_HI 0x0d

Sửa byte thứ hai của tiêu đề CSL IE.

CSL_IE_HEADER_BYTES_LO

 CSL_IE_HEADER_BYTES_LO 0x04

Sửa byte đầu tiên của tiêu đề CSL IE.

OT_EXT_ADDRESS_SIZE

 OT_EXT_ADDRESS_SIZE 8

Kích thước của Địa chỉ mở rộng IEEE 802.15.4 (byte)

OT_MAC_KEY_SIZE

 OT_MAC_KEY_SIZE 16

Kích thước của Khoá MAC tính bằng byte.

OT_PANID_BROADCAST

 OT_PANID_BROADCAST 0xffff

Mã PAN phát sóng IEEE 802.15.4.

OT_TOOL_PACKED_END

 OT_TOOL_PACKED_END

Chỉ báo dành riêng cho trình biên dịch ở cuối lớp hoặc cấu trúc đóng gói byte.

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.