nearlink_sdr.phy.frame

帧结构组装与解析 -- TXS-10002-2025 标准 6.3.2-6.3.5 节。

支持帧类型 1-4，包含前导码、同步序列、控制信息、数据载荷和导频插入。

Module Contents

Classes

FrameConfig	无线帧配置参数。
FrameFields	已组装帧各字段的比特/符号数组。

Functions

assemble_frame_bits	在比特级别组装完整帧结构。
frame_to_symbols	将帧字段转换为含导频插入的调制符号流。
symbols_to_data_bits	将接收符号流解析还原为控制位和数据位。

API

class nearlink_sdr.phy.frame.FrameConfig

无线帧配置参数。

frame_type: int

None

symbol_rate_mhz: float

1.0

pilot_interval: int

0

crc_len: int

24

mod_type: str = <Multiline-String>

sync_m_index: int | None

None

class nearlink_sdr.phy.frame.FrameFields

已组装帧各字段的比特/符号数组。

preamble_bits: numpy.ndarray

'field(...)'

sync_bits: numpy.ndarray

'field(...)'

ctrl_bits: numpy.ndarray

'field(...)'

data_bits: numpy.ndarray

'field(...)'

frame_type: int

1

nearlink_sdr.phy.frame.assemble_frame_bits(ctrl_info_bits: numpy.ndarray, data_payload_bits: numpy.ndarray, config: nearlink_sdr.phy.frame.FrameConfig) → nearlink_sdr.phy.frame.FrameFields

在比特级别组装完整帧结构。

生成调制前的比特级帧结构。

参数:

• ctrl_info_bits -- 物理层控制信息比特。

• data_payload_bits -- 数据 + 完整性保护 + CRC 比特。

• config -- 帧配置参数。

返回:

包含所有帧字段的 FrameFields 对象。

nearlink_sdr.phy.frame.frame_to_symbols(fields: nearlink_sdr.phy.frame.FrameFields, config: nearlink_sdr.phy.frame.FrameConfig) → numpy.ndarray

将帧字段转换为含导频插入的调制符号流。

帧类型 1（GFSK）返回拼接后的比特序列（非复数符号）。 帧类型 2-4（PSK）返回含导频的复数符号流。

参数:

• fields -- 已组装的帧字段。

• config -- 帧配置参数。

返回:

类型 1：比特数组（送入 GFSK 调制器）。 类型 2-4：基带复数符号数组。

nearlink_sdr.phy.frame.symbols_to_data_bits(symbols: numpy.ndarray, config: nearlink_sdr.phy.frame.FrameConfig, n_ctrl_coded_bits: int = 0, n_data_bits: int = 0) → tuple[numpy.ndarray, numpy.ndarray]

将接收符号流解析还原为控制位和数据位。

简化解析器，假定已知帧参数。

参数:

• symbols -- 接收到的复数符号流。

• config -- 帧配置参数。

• n_ctrl_coded_bits -- 编码控制位的数量。

• n_data_bits -- 数据位数量（调制前）。

返回:

(ctrl_bits, data_bits) — 解调后的比特数组。