使用真实 SLE IQ 数据¶
先下载数据集¶
sle IQ数据集 记录了 WS63 发出的真实星闪测试信号,由 E310 通过 30 dB 衰减连接采集。 IQ 是无线波形的两路采样数值,可以用于离线解调、接收算法开发和 FPGA 回放测试。
数据集可以脱离本项目独立使用。 无需克隆仓库、安装本项目或 Git LFS; 可用 Python、MATLAB、GNU Radio 等工具处理,数学模型是可选的分析参考。
本版有 72 组配置、360 份文件,覆盖 GFSK、QPSK、8PSK 及 1/2/4 MSym/s 符号率。 每组包含三次发射采样,以及发射前后各一次静默采样。下载约 450 MB,解压后 IQ 约 1.51 GB。 旧错位编码样本已由修复后的实测样本替换,发布包不含旧错误 IQ、试采和失败空文件。
在全新目录执行以下命令。需要 GitHub CLI、zstd、tar、sha256sum 和 Python 3.11 及以上,预留至少 3 GB 空间。
gh release download sle-iq-20261116-r2 -R OpenSparklink/sparklink_sim -D sle-iq-assets
cd sle-iq-assets
sha256sum -c SHA256SUMS
cat ws63-rx2-20261115-r2.tar.zst.part-* > sle-iq.tar.zst
sha256sum -c ARCHIVE_SHA256SUMS
mkdir restored
zstd -dc sle-iq.tar.zst | tar -xf - -C restored
python3 verify_dataset.py restored/ws63-rx2-20261115-r2
四个分卷必须全部下载、按编号拼接后再解压,不需要 Git LFS。
校验脚本只使用 Python 标准库。原始数据在解压目录的 raw/ 下;先看 iq-index.csv 选样本,再从 samples.jsonl
读取对应的采样参数和验证记录。完整的附件、压缩包和原始文件都可分别校验。
数据为 16 MS/s、约 2441 MHz、10 MHz 带宽,RX2 手动增益 15 dB。 小端有符号 16 位整数按 I、Q 交错,每四字节构成一个复数采样;原生 ADC 只有 12 位有效数据, 其余位作符号扩展。每份文件约 65.536 ms,未裁切、归一化或重采样。
使用前需要知道¶
先选配置,再读参数。 用
iq-index.csv找到所需调制、符号率、导频和编码组合,再从samples.jsonl读取该文件的实际采集参数。文件开头不等于包头。 一份 IQ 包含多个突发和空闲段,先做信号检测和同步;首尾截断的包不要当作完整包解码。
4M 8PSK 注意采样时刻。 本批数据中,部分整数定时下的 CRC 失败可通过分数定时恢复;遇到类似问题,先检查定时,再判断数据是否损坏。
静默文件用来测噪声和误检。 优先使用同一配置配套的静默对照,设置检测门限,不把静默文件混入发包统计。
检查 GFSK IQ¶
先读取采集元数据,按实际 I/Q 顺序、字节序及有效位宽解包。
保留整段原始 IQ 和关联静默对照,不按已知载荷或同步位置预先裁切。
调用 nearlink_sdr.phy.gfsk.analyze_gfsk_capture 时显式提供实际采样率、
请求符号率和同增益的静默对照;当前前端支持整数 SPS ≥4,不固定为8。
前端以每符号平均功率的静默99.9%分位数乘4作为检测门限。 采用65抽头Hamming低通,截止频率为请求符号率,因果群延迟32样本。 每个能量段都输出:过短段、记录边界截断段、无法区分双频状态的段不会伪装成完整包。 CFO取双簇鉴频中心的中点;定时取每符号积分鉴频眼图的最大平均绝对值, 不使用期待载荷、CRC或同步相关结果选择定时。实际比特判决复用原有GFSK解调器。
bit0_filtered_index 为滤波后第一个判决区间的开始;
bit0_raw_reference 减去32样本群延迟,后续判决区间相隔SPS样本。
该坐标是原始文件偏移和一个样本的定时网格,不是空口硬件时间。
符号时钟还提供请求附近±10%的过渡能量谱峰、谱峰对比和观测时长;
FFT零填充后的网格间隔不是绝对时钟精度或独立SRO校准。
prbs9 定义数学约定为x⁹+x⁵+1、全一初态、stage8优先输出。
厂测固件是否使用相同种子、位序、扰码和帧封装,必须另外确认。
GFSK波形比较、能量段、同步候选或PRBS相似性都不能替代控制头、CRC和逐字节验收。
采集前端只返回未解析比特及诊断。若上下文已确认,可另调用
phy.frame.decode_ft1_a3_candidates:显式提供同步字、CRC24A种子与加扰种子
(None明确表示无加扰),扫描全部同步候选,复用已有A3解包和CRC算法。
头CRC12通过才使用长度,数据CRC24A通过才返回载荷;坏候选和截断候选保留,
继续搜索后续同步。不使用期待长度或载荷选择同步位置,也不为通过而枚举种子。
这是指定FT1/A3/CRC24A配置的解析器,不代表全部厂测模式或业务配置都相同。
不要直接把假定对齐的 rx_chain 或FT1 decode_head 的简化成功标志作为真实头CRC证据。
prbs15使用x¹⁵+x¹⁴+1、全一初态、stage14输出,与SDK厂测生成器的14/13反馈一致。
字节位序在采集分析调用处显式指定,不用期待载荷辅助同步。
PSK采集与FT2/A3检查¶
phy.psk.acquire_psk_capture接受完整IQ、静默、实际采样率、显式符号率及已知同步符号。
当前整数SPS≥4。采用原beta=.4、span10 RRC居中离线滤波,能量阈值与GFSK相同。
在各整数采样相位搜索已知同步的差分归一相关,最大值达到固定.85才获取;
CFO、相位和增益仅由同步估计,不用期待载荷或CRC选择同步。所有短段、边界段、
未同步段保留。raw索引为居中滤波后的符号中心文件坐标,不是硬件空口时间。
用PSKModulator.map_symbols和PSKDemodulator.demap_symbols的start_symbol_index
维持帧起点的奇偶关系;不能在控制/数据字段或导频后隐式重置。
refine_psk_carrier在去交替旋转后作M次方盲FFT和相位拟合,
归一频率搜索±.1,依靠前置同步消除星座歧义,不枚举相位以迎合CRC。
该前端不含SRO恢复、均衡或绝对EVM标定,不能声称全部PSK接收能力已验收。
phy.frame.decode_ft2_a3_capture限定显式无加扰、CRC24A配置;
控制Polar(64,48)经真实A3头CRC后才信任长度/MCS。控制16:1导频,
数据导频必须显式指定0/1/4/16;1:1仅适用于明示厂测配置。
MCS6/8/10/12的数据复用原有码块分割、Polar及CRC,数据CRC通过才返回载荷。
CRC合格仍须另外核对已知内容,不能把未知厂测前缀解释为已确认协议字段。
原有rx_chain/frame_to_symbols的对齐假设和字段局部相位组织未由本增量全部验收;
真实IQ分析直接使用上述显式帧参考接口,不把已有通路的简化成功标志作为证据。
同一ADC输入的分数定时对照¶
acquire_psk_capture(..., timing_subdivisions=8)在原RRC之后用三次样条,
以1/8原始采样间隔搜索同一已知同步相关最大值;默认1保留整数路径。
能量、滤波、载波与CRC不变,不用期待载荷或CRC选择分数相位。
这是同一ADC记录的插值算法实验,不增加真实采样率、不证明原4SPS不足。
当前仅估计固定分数相位,不实现SRO或分数定时跟踪。
比较不同实际采样率需另控模拟带宽、数字滤波/抽取、增益和丢样状态,
高实际采样率成功也不能单独证明低采样率混叠。