Kalibrate-RTL 技术文档

本文档将详细介绍如何安装和使用 Kalibrate-RTL 项目，该项目能够扫描指定频段的 GSM 基站并计算本地振荡器频率偏移。

1. 安装指南

安装依赖

首先，确保安装了以下依赖库：

• libtool
• libfftw3-dev

在 Debian 系统上的安装命令如下：

sudo apt-get install libtool libfftw3-dev

克隆仓库

然后从 GitHub 仓库克隆项目：

git clone https://github.com/steve-m/kalibrate-rtl.git

编译项目

进入项目目录并编译：

cd kal-v0.4.1
./bootstrap && CXXFLAGS='-W -Wall -O3' ./configure && make

2. 项目使用说明

Kalibrate-RTL 提供了两种主要使用方式：扫描基站和计算频率偏移。

扫描基站

使用以下命令扫描指定频段的 GSM 基站：

src/kal -s <band indicator>

其中 <band indicator> 可以是以下值之一：GSM850, GSM900, EGSM, DCS, PCS。

例如，扫描 GSM-850 频段：

src/kal -s 850

计算频率偏移

使用以下命令根据附近的 GSM 基站计算频率偏移：

src/kal -c <channel> [-f <frequency>]

其中 <channel> 是基站的频道号，<frequency> 是基站的频率。

例如，使用频道 145 计算频率偏移：

src/kal -c 145

3. 项目 API 使用文档

Kalibrate-RTL 的命令行工具提供了多种选项用于配置扫描和计算过程。以下是一些常用选项：

• -s <band indicator>：扫描指定频段的 GSM 基站。
• -c <channel>：使用指定频道计算频率偏移。
• -f <frequency>：使用指定频率计算频率偏移。
• -b <band indicator>：指定频段。
• -R <side>：指定侧 A (0) 或 B (1)。
• -A <antenna>：指定天线 TX/RX (0) 或 RX2 (1)。
• -g <gain>：指定增益百分比。
• -F <frequency>：指定 FPGA 主时钟频率。
• -v：开启详细输出。
• -D：开启调试信息。
• -h：显示帮助信息。

4. 项目安装方式

Kalibrate-RTL 的安装方式已在上述“安装指南”中详细说明。简要步骤如下：

1. 安装依赖库。
2. 克隆项目仓库。
3. 编译项目。

通过以上步骤，用户可以成功安装并使用 Kalibrate-RTL 项目。