5G NR 频点计算工具 — 一个开箱即用的 NR 配置参数计算器基于 3GPP TS 38.104/38.211/38.213 协议实现支持 FR1/FR2 全频段GUI 命令行双模式开箱即用。频点计算工具链接一、项目简介在 5G NR 网络规划与测试中频点配置是一项繁琐且容易出错的工作。我们需要根据中心频率、带宽、SCS 等参数精确计算出 PointA ARFCN、SSB GSCN、k_SSB、offsetToPointA、CORESET#0、SearchSpace#0 等一系列配置参数。这款NR 频点计算工具正是为解决这一痛点而生——它严格遵循 3GPP 协议规范支持FR1Sub-7 GHz和FR2毫米波全频段提供GUI 图形界面和命令行两种使用方式开箱即用。二、功能亮点✅PointA 计算根据中心频点和带宽精确计算 DL PointA ARFCN✅SSB 位置确定自动计算 SSB 的 ARFCN、GSCN、k_SSB 偏移量✅CORESET#0 推荐遍历协议定义的所有候选项推荐最优配置✅SearchSpace#0 选项提供 PDCCH Monitor 周期完整可选参数表✅Channel Raster 检查验证中心频点是否符合信道栅格要求✅频段自动识别根据频率自动标注 NR Band如 n78、n77✅FR1/FR2 全覆盖支持 15/30/60kHzFR1和 60/120/240kHzFR2SCS✅NTN 扩展频段内置 n254/n255/n256 等 NTN 频段支持✅GUI 命令行适合不同使用场景三、安装使用说明方式 1直接运行 EXE推荐无需安装 Python 环境直接双击下载的可执行文件dist/NR_频点计算工具.exe打开图形界面后输入参数中心频点或 GSCN点击计算即可。方式 2命令行运行python nr_freq_calc.py--center308400--scs30--ssb-scs30--bw20常用参数参数说明默认值--center NDL 中心 ARFCN必填--gscn NSSB GSCN可选--ssb-arfcn NSSB 中心 ARFCN可选--scs NSCSkHz, 15/30/60/120/24030--ssb-scs NSSB SCSkHz, 15/30/120/24030--bw N带宽MHz20--duplex双工模式 FDD/TDDFDD--coreset0 N指定 CORESET#0 索引自动推荐--searchspace0 N指定 SearchSpace#0 索引0实用示例# 根据 GSCN 计算python nr_freq_calc.py--gscn3843# 指定 DL 中心 SSB ARFCN CORESET#0python nr_freq_calc.py--center308400--ssb-arfcn307470--coreset02# FR2 高带宽场景python nr_freq_calc.py--gscn22268--scs120--ssb-scs120--bw200# FR1 FDD 场景python nr_freq_calc.py--center676020--scs15--ssb-scs15--bw5--duplexFDD方式 3作为 Python 模块导入fromnr_freq_calcimportcalculate,format_results resultscalculate({center:308400,scs:30,ssb_scs:30,bw:20})print(format_results(results))四、GUI 界面使用指南启动图形界面后输入流程非常简单1. 设置基本参数SCS子载波间隔15/30/60/120/240 kHzSSB SCS同步信号子载波间隔带宽频道带宽5/10/20/100 MHz 等双工模式FDD 或 TDD2. 输入频点信息DL ARFCN / Freq(MHz)下行中心频点两者填其一即可自动换算同步SSB ARFCN / Freq(MHz) / GSCNSSB 位置三者填其一即可3. 可选参数CORESET#0留空则自动推荐最优值SearchSpace#0按需指定索引4. 点击计算下方结果区将显示完整的 NR 频点配置信息包括Carrier ConfigurationPointA、中心频点、上下边缘 NRBSSB ConfigurationGSCN、SC0、Lmax 模式offsetToPointA偏移量计算细节Channel Raster 检查结果CORESET#0 候选列表含推荐标记SearchSpace#0 可选参数表Summary复制粘贴用的摘要五、输出结果解读Carrier ConfigurationDL PointA ARFCN下行参考点所有 CRB 编号基于此DL Center ARFCN实际使用的中心频点可能与输入略有偏移以对齐 PRB 网格NRB可用物理资源块数量SSB ConfigurationSSB GSCN全局参考信道号包含 N、M 分解值SSB SCS子载波间隔类型Case A/B/C/D/ELmax最大 SSB 发射波束数CORESET#0列出所有适合当前配置的 CORESET#0 候选项第一个为系统推荐的优选值。六、支持频段内置完整的 3GPP NR 频段数据库TS 38.101-1 Table 5.2-1 NTN bands from 38.101-5涵盖FR1 频段Sub-7 GHzn1/n2/n3/n5/n7/n8/n12-n14/n18/n20/n25-n29/n30/n34/n38-n53/n65-n71/n74/n77-n85/n90-n95/n96FR2 频段mmWaven101/n102/n104/n254-n256NTN 扩展频段n254/n255/n256七、常见问题Q: 为什么计算结果中的 DL Center ARFCN 和我输入的不一样A: PointA 必须对齐到 PRB 网格ARFCN mod SCS/ΔF 0因此中心频点会被微调至最近的合法值。结果中会显示具体的 Delta 值。Q: 支持的 SCS 组合有哪些A: FR1 支持 15/30/60 kHzFR2 支持 60/120/240 kHz。SCS 和 SSB SCS 的组合需符合协议约束。Q: 如何在 NTN 场景下使用A: 工具已内置 NTN 扩展频段n254/n255/n256正常使用 GUI 或命令行输入对应频率即可。八、获取源码Gitee 仓库https://gitee.com/diligt/tools项目结构nr_freq_tool/ ├── nr_freq_calc.py # 计算引擎可单独命令行运行或模块导入 ├── nr_param_input.py # GUI 图形界面PyInstaller 入口 ├── nr_calc_param_all.py # 辅助计算函数集合 ├── magic-lamp_39027.ico # 程序图标 ├── dist/ │ └── NR_频点计算工具.exe # 打包好的独立可执行文件 └── README.md # 详细文档九、依赖与环境Python 源码方式Python 3.9tkinterPython 标准库自带打包 EXE仅需 PyInstallerpipinstallpyinstaller python-mPyInstaller--onefile--noconsole^--iconmagic-lamp_39027.ico^ --add-datamagic-lamp_39027.ico;.^--nameNR_频点计算工具nr_param_input.py如果觉得这个工具对你有所帮助欢迎 Star / Fork / Issue 交流