nearlink_sdr.phy.frame¶
帧结构组装与解析 -- TXS-10002-2025 标准 6.3.2-6.3.5 节。
支持帧类型 1-4,包含前导码、同步序列、控制信息、数据载荷和导频插入。
Module Contents¶
Classes¶
无线帧配置参数。 |
|
已组装帧各字段的比特/符号数组。 |
Functions¶
在比特级别组装完整帧结构。 |
|
解析已判决比特中的 FT1/A3 候选(6.3.2、6.4.1.4、6.10.1/4)。 |
|
解析显式无加扰/CRC24A的FT2/A3采集,symbols从已知同步起点开始。 |
|
将帧字段转换为含导频插入的调制符号流。 |
|
将接收符号流解析还原为控制位和数据位。 |
API¶
- 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(...)'
- 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.decode_ft1_a3_candidates(bits: numpy.ndarray, *, sync_word: int, data_crc_seed: int, whitening_seed: int | None) list[dict][源代码]¶
解析已判决比特中的 FT1/A3 候选(6.3.2、6.4.1.4、6.10.1/4)。
同步字、CRC种子及是否加扰必须由调用者显式给出,不从期待载荷挑选。
None明确表示不加扰(例如经实测确认的厂测配置),不是普通链路默认值。 头CRC通过后才读取11位长度;数据CRC通过后才返回payload。 错候选和截断候选保留诊断,继续搜索其后的同步,不消耗整个窗口。 返回坐标均为输入比特偏移,end为exclusive;不声称完成RF或硬件时间同步。
- nearlink_sdr.phy.frame.decode_ft2_a3_capture(symbols: numpy.ndarray, *, sync_word: int, data_crc_seed: int, pilot_interval: int, carrier_method: str = 'coherent') dict[源代码]¶
解析显式无加扰/CRC24A的FT2/A3采集,symbols从已知同步起点开始。
控制QPSK固定16:1导频,Polar(64,48),实际A3头CRC后才读长度和MCS。 数据复用现有码块分割、Polar和CRC;不使用decode_head的简化成功标志。 1:1导频仅供显式厂测配置,不能推广为普通业务默认配置。 返回payload仅表示CRC合格;是否符合外部源的已知数据仍须调用者另行核对。
- 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) — 解调后的比特数组。