inspectrum 开源项目教程

项目介绍

inspectrum 是一个用于分析捕获信号的工具，主要用于软件定义无线电接收器。它支持大文件（100GB+）处理，提供频谱图、幅度频率相位和IQ样本的绘图，以及用于测量周期、符号率和提取符号的游标。此外，它还支持导出选定时间段、过滤样本和解调数据。

项目快速启动

安装

Linux

在大多数发行版中，可以使用包管理器安装 inspectrum。

macOS

通过 Homebrew 或 MacPorts 安装。

Windows

使用 radioconda conda 安装。

从源码构建

前提条件

• cmake >= 3.1
• fftw 3.x
• liquid-dsp >= v1.3.0
• pkg-config
• qt5

构建步骤

1. 克隆项目仓库：

   git clone https://github.com/miek/inspectrum.git
   cd inspectrum
   

2. 构建项目：

   mkdir build
   cd build
   cmake ..
   make
   

3. 运行 inspectrum：

   ./inspectrum [filename]
   

支持的文件类型

• sigmf-meta
• sigmf-data - SigMF 录制
• cf32, fc32, cfile - 复数 32 位浮点样本（GNU Radio osmocom_fft）
• cf64, fc64 - 复数 64 位浮点样本
• cs32, sc32, c32 - 复数 32 位有符号整数样本（SDRAngel）
• cs16, sc16, c16 - 复数 16 位有符号整数样本（BladeRF）
• cs8, sc8, c8 - 复数 8 位有符号整数样本（HackRF）
• cu8, uc8 - 复数 8 位无符号整数样本（RTL-SDR）
• f32 - 实数 32 位浮点样本

应用案例和最佳实践

案例一：信号分析

使用 inspectrum 分析从 SDR 接收器捕获的信号，通过频谱图和游标功能，可以精确测量信号的频率、幅度和相位。

案例二：数据导出

在 inspectrum 中选择特定时间段的数据，并导出为过滤后的样本或解调数据，以便进一步处理或分析。

典型生态项目

GNU Radio

GNU Radio 是一个开源的软件无线电框架，与 inspectrum 结合使用，可以实现从信号捕获到分析的完整流程。

SigMF

信号测量格式（SigMF）是一个开放的标准，用于描述和存储无线电信号的元数据和数据，inspectrum 支持 SigMF 格式的文件。

通过这些模块的介绍和实践，用户可以快速上手并深入使用 inspectrum 进行信号分析和处理。