`nearlink_sdr.phy.rf_compliance`¶

射频合规参数与校验 — 标准第 8 章。

实现 TXS-10002-2025 标准中 8.2-8.4 定义的窄带/UWB 射频指标:

8.2.1 输出功率等级
8.2.2 调制精度 (GFSK 频偏 / PSK EVM / 频率容限 / 时钟精度)
8.2.3 无用发射 (GFSK/PSK 频段内杂散)
8.3.1 接收灵敏度与最大输入电平
8.3.2 接收机选择性
8.3.4 RSSI 精度
8.4 UWB 射频 (信道、频谱模板、频率容限、均方根误差)

Module Contents¶

Classes¶

`ChannelBandwidth`
`EVMLimit`	EVM 限值。
`FreqBand`
`FreqToleranceSpec`	频率容限规范。
`GFSKFreqDevResult`	GFSK 频偏校验结果。
`GFSKFreqDevSpec`	GFSK 调制频偏规范 — 针对单个符号速率。
`IntermodEntry`	接收机干扰互调要求。
`OutOfBandEntry`	频段外选择性要求条目。
`PSKModulation`
`PSKSpectrumMask`	PSK 发射频谱模板中各参考偏移频率 (MHz)。
`PowerClass`
`RFComplianceReport`	射频合规综合报告。
`SelectivityEntry`	接收机选择性要求条目。
`UWBSpectrumMask`	UWB 频谱模板参数 (8.4.3)。

Functions¶

`check_clock_accuracy`	校验时钟精度 (8.2.2.4 / 8.2.2.5)。
`check_evm`	校验 PSK EVM 是否满足表 53 限值。
`check_freq_tolerance`	校验频率容限是否满足 8.2.2.3。
`check_gfsk_freq_dev`	校验 GFSK 频率偏差是否满足标准 8.2.2.1。
`check_rssi_accuracy`	校验 RSSI 测量精度 (8.3.4)。
`check_rx_spurious_emission`	校验接收机杂散发射 (8.3.3)。
`check_uwb_nrmse`	校验 UWB 标准化均方根误差 (8.4.5)。
`classify_power`	根据最大输出功率确定功率等级。
`get_psk_spectrum_mask`	获取指定带宽的 PSK 频谱模板。
`gfsk_inband_spurious_limit_dbm`	计算 GFSK 频段内杂散限值 (dBm)。
`reference_sensitivity`	返回参考灵敏度 (dBm)。
`selectivity_freq_offsets`	返回指定带宽的 f1/f2/f3 频率偏移 (MHz)。
`uwb_channel_center_freq_mhz`	计算 UWB 物理信道中心频率 (MHz)。
`validate_power_step`	校验相邻发射功率差是否不大于 8 dB (8.2.1)。

Data¶

`ACTIVE_CLOCK_JITTER_US`
`ACTIVE_CLOCK_PPM`
`MAX_INPUT_LEVEL_DBM`
`RSSI_ACCURACY_DB`
`RSSI_SIGNAL_OFFSET_DB`
`SLEEP_CLOCK_JITTER_US`
`SLEEP_CLOCK_PPM`
`SUB_1G_TOLERANCE_PPM`
`UWB_CLOCK_TOLERANCE_PPM`
`UWB_FREQ_TOLERANCE_PPM`
`UWB_MAX_NRMSE_DIFF_DB`
`UWB_MAX_NRMSE_PCT`

API¶

nearlink_sdr.phy.rf_compliance.ACTIVE_CLOCK_JITTER_US¶: 2.0

nearlink_sdr.phy.rf_compliance.ACTIVE_CLOCK_PPM¶: 20.0

nearlink_sdr.phy.rf_compliance.MAX_INPUT_LEVEL_DBM¶: None

nearlink_sdr.phy.rf_compliance.RSSI_ACCURACY_DB¶: 6.0

nearlink_sdr.phy.rf_compliance.RSSI_SIGNAL_OFFSET_DB¶: 6.0

nearlink_sdr.phy.rf_compliance.SLEEP_CLOCK_JITTER_US¶: 16.0

nearlink_sdr.phy.rf_compliance.SLEEP_CLOCK_PPM¶: 500.0

nearlink_sdr.phy.rf_compliance.SUB_1G_TOLERANCE_PPM¶: 100.0

nearlink_sdr.phy.rf_compliance.UWB_CLOCK_TOLERANCE_PPM¶: 20.0

nearlink_sdr.phy.rf_compliance.UWB_FREQ_TOLERANCE_PPM¶: 20.0

nearlink_sdr.phy.rf_compliance.UWB_MAX_NRMSE_DIFF_DB¶: 2.0

nearlink_sdr.phy.rf_compliance.UWB_MAX_NRMSE_PCT¶: 25.0

class nearlink_sdr.phy.rf_compliance.ChannelBandwidth[源代码]¶

Bases: enum.IntEnum

BW_100K¶: 100

BW_125K¶: 125

BW_250K¶: 250

BW_500K¶: 500

BW_1M¶: 1000

BW_2M¶: 2000

BW_4M¶: 4000

class nearlink_sdr.phy.rf_compliance.EVMLimit[源代码]¶

EVM 限值。

rms_pct: float¶: None

pct99: float¶: None

peak_pct: float¶: None

class nearlink_sdr.phy.rf_compliance.FreqBand[源代码]¶

Bases: enum.IntEnum

BAND_2400¶: 0

BAND_5100¶: 1

BAND_5800¶: 2

SUB_1G¶: 3

class nearlink_sdr.phy.rf_compliance.FreqToleranceSpec[源代码]¶

频率容限规范。

freq_offset_khz: float¶: None

freq_drift_khz: float¶: None

drift_rate_hz_per_us: float¶: None

class nearlink_sdr.phy.rf_compliance.GFSKFreqDevResult[源代码]¶

GFSK 频偏校验结果。

min_ok: bool¶: None

fd1_ok: bool¶: None

fd2_ok: bool¶: None

ratio_ok: bool¶: None

zero_crossing_ok: bool¶: None

property passed: bool¶

class nearlink_sdr.phy.rf_compliance.GFSKFreqDevSpec[源代码]¶

GFSK 调制频偏规范 — 针对单个符号速率。

symbol_rate_msps: float¶: None

symbol_interval_us: float¶: None

min_deviation_khz: float¶: None

fd1_min_khz: float¶: None

fd1_max_khz: float¶: None

fd2_min_khz: float¶: None

fd2_fd1_ratio_min: float¶: 0.8

zero_crossing_margin: float¶: 0.125

class nearlink_sdr.phy.rf_compliance.IntermodEntry[源代码]¶

接收机干扰互调要求。

bw_khz: int¶: None

signal_offset_db: float¶: None

interferer_level_dbm: float¶: None

n_values: tuple[int, ...]¶: None

class nearlink_sdr.phy.rf_compliance.OutOfBandEntry[源代码]¶

频段外选择性要求条目。

freq_range: tuple[float, float]¶: None

interferer_level_dbm: float¶: None

step_mhz: float¶: None

class nearlink_sdr.phy.rf_compliance.PSKModulation[源代码]¶

Bases: enum.IntEnum

PI2_BPSK¶: 0

PI4_QPSK¶: 1

PI8_8PSK¶: 2

class nearlink_sdr.phy.rf_compliance.PSKSpectrumMask[源代码]¶

PSK 发射频谱模板中各参考偏移频率 (MHz)。

bw: nearlink_sdr.phy.rf_compliance.ChannelBandwidth¶: None

f1_mhz: float¶: None

f2_mhz: float¶: None

f3_mhz: float | None¶: None

f4_mhz: float | None¶: None

class nearlink_sdr.phy.rf_compliance.PowerClass[源代码]¶

Bases: enum.IntEnum

CLASS_0¶: 0

CLASS_1¶: 1

CLASS_2¶: 2

CLASS_3¶: 3

CLASS_4¶: 4

CLASS_5¶: 5

CLASS_6¶: 6

class nearlink_sdr.phy.rf_compliance.RFComplianceReport[源代码]¶

射频合规综合报告。

power_class: nearlink_sdr.phy.rf_compliance.PowerClass | None¶: None

power_step_ok: bool | None¶: None

gfsk_dev: nearlink_sdr.phy.rf_compliance.GFSKFreqDevResult | None¶: None

evm_ok: bool | None¶: None

freq_tolerance_ok: bool | None¶: None

clock_ok: bool | None¶: None

spurious_ok: bool | None¶: None

sensitivity_dbm: float | None¶: None

selectivity_ok: bool | None¶: None

rssi_ok: bool | None¶: None

uwb_spectrum_ok: bool | None¶: None

uwb_nrmse_ok: bool | None¶: None

errors: list[str]¶: 'field(...)'

property passed: bool¶: 全部已检项均通过时返回 True。

class nearlink_sdr.phy.rf_compliance.SelectivityEntry[源代码]¶

接收机选择性要求条目。

signal_level_offset_db: float¶: None

interferer_level_dbm: float¶: None

freq_offset_type: str¶: None

class nearlink_sdr.phy.rf_compliance.UWBSpectrumMask[源代码]¶

UWB 频谱模板参数 (8.4.3)。

pulse_width_ns: float¶: None

transition_band_hz() → tuple[float, float][源代码]¶: 过渡带范围 [0.65/Tp, 0.8/Tp] Hz。

check_spectrum(freq_offset_hz: float, psd_db_relative: float) → bool[源代码]¶

校验 PSD 是否满足频谱模板要求。

|f-fc| in [0.65/Tp, 0.8/Tp]: 低于峰值 10 dB
|f-fc| > 0.8/Tp: 低于峰值 18 dB

nearlink_sdr.phy.rf_compliance.check_clock_accuracy(ppm: float, jitter_us: float, is_sleep: bool = False) → bool[源代码]¶: 校验时钟精度 (8.2.2.4 / 8.2.2.5)。

nearlink_sdr.phy.rf_compliance.check_evm(mod: nearlink_sdr.phy.rf_compliance.PSKModulation, rms_evm_pct: float, pct99_evm_pct: float, peak_evm_pct: float) → bool[源代码]¶: 校验 PSK EVM 是否满足表 53 限值。

nearlink_sdr.phy.rf_compliance.check_freq_tolerance(band: nearlink_sdr.phy.rf_compliance.FreqBand, mod_type: str, freq_offset_khz: float, freq_drift_khz: float, drift_rate_hz_per_us: float, carrier_freq_mhz: float = 0.0) → bool[源代码]¶

校验频率容限是否满足 8.2.2.3。

参数:

band -- 频段类型。
mod_type -- 调制类型 ("GFSK", "BPSK/QPSK", "8PSK")。
freq_offset_khz -- 初始频率偏差 (kHz)。
freq_drift_khz -- 频率漂移 (kHz)。
drift_rate_hz_per_us -- 频率漂移率 (Hz/us)。
carrier_freq_mhz -- 载波频率 (MHz), sub-1GHz 时用于 ppm 校验。

nearlink_sdr.phy.rf_compliance.check_gfsk_freq_dev(symbol_rate_msps: float, min_deviation_khz: float, fd1_khz: float, fd2_khz: float, max_zero_crossing_error: float = 0.0) → nearlink_sdr.phy.rf_compliance.GFSKFreqDevResult[源代码]¶: 校验 GFSK 频率偏差是否满足标准 8.2.2.1。

nearlink_sdr.phy.rf_compliance.check_rssi_accuracy(measured_rssi_dbm: float, actual_level_dbm: float, ref_sensitivity_dbm: float) → bool[源代码]¶

校验 RSSI 测量精度 (8.3.4)。

在参考灵敏度 +6 dB 处, 误差应不大于 ±6 dB。

nearlink_sdr.phy.rf_compliance.check_rx_spurious_emission(spurious_dbm: float, limit_dbm: float = -57.0) → bool[源代码]¶

校验接收机杂散发射 (8.3.3)。

标准要求接收机杂散发射应符合国家频谱法规。默认限值 -57 dBm (30 MHz ~ 1 GHz 频段, GB/T 9254.1 限值)。

nearlink_sdr.phy.rf_compliance.check_uwb_nrmse(sync_nrmse_pct: float, meas_nrmse_pct: float) → bool[源代码]¶

校验 UWB 标准化均方根误差 (8.4.5)。

同步信号和测量信号 NRMSE 均不超过 25%, 且两者差值不超过 ±2 dB。

nearlink_sdr.phy.rf_compliance.classify_power(pmax_dbm: float) → nearlink_sdr.phy.rf_compliance.PowerClass[源代码]¶: 根据最大输出功率确定功率等级。

nearlink_sdr.phy.rf_compliance.get_psk_spectrum_mask(bw: nearlink_sdr.phy.rf_compliance.ChannelBandwidth) → nearlink_sdr.phy.rf_compliance.PSKSpectrumMask[源代码]¶: 获取指定带宽的 PSK 频谱模板。

nearlink_sdr.phy.rf_compliance.gfsk_inband_spurious_limit_dbm(bw: nearlink_sdr.phy.rf_compliance.ChannelBandwidth, k_offset_mhz: float) → float[源代码]¶

计算 GFSK 频段内杂散限值 (dBm)。

对宽信道 (1/2/4 MHz, 表56) 返回 dBm/MHz; 对窄信道 (100-500 kHz, 表57) 返回 dBm/100kHz。

nearlink_sdr.phy.rf_compliance.reference_sensitivity(bw_khz: int, mcs: int | None = None) → float[源代码]¶

返回参考灵敏度 (dBm)。

参数:

bw_khz -- 信道带宽 (kHz)。
mcs -- MCS 索引。None 时返回 GFSK 灵敏度。

nearlink_sdr.phy.rf_compliance.selectivity_freq_offsets(bw_khz: int) → tuple[float, float, float][源代码]¶: 返回指定带宽的 f1/f2/f3 频率偏移 (MHz)。

nearlink_sdr.phy.rf_compliance.uwb_channel_center_freq_mhz(nc: int) → float[源代码]¶

计算 UWB 物理信道中心频率 (MHz)。

fc = 499.2 + Nc * 124.8 (Nc in 0..79) 特殊信道: 125 -> 7542.6, 126 -> 18041.8, 127 -> 8541.0

nearlink_sdr.phy.rf_compliance.validate_power_step(prev_dbm: float, curr_dbm: float) → bool[源代码]¶: 校验相邻发射功率差是否不大于 8 dB (8.2.1)。

nearlink_sdr.phy.rf_compliance¶

Module Contents¶

Classes¶

Functions¶

Data¶

API¶

`nearlink_sdr.phy.rf_compliance`¶