开始使用srsUE

### 开始使用srsUE

要开始使用srsUE，您需要一台装有基于GNU/Linux操作系统的电脑和SDR射频前端。SDR射频前端是一种通用无线电设备，例如Ettus Research USRP，它连接到您的电脑并支持传输和接收原始无线电信号。

如果您使用的是基于Ubuntu的操作系统，您可以通过以下命令从提供的二进制包安装srsUE：

```bash
sudo add-apt-repository ppa:srslte/releases
sudo apt-get update
sudo apt-get install srsue
```

如果您使用的是不同的发行版，您可以按照项目GitHub页面提供的指南从源代码安装。

安装软件后，您可以通过运行以下命令将配置文件安装到默认位置（`~/.config/srsran_4g`）：

```bash
srsran_4g_install_configs.sh user
```

### 运行软件

要使用默认参数运行srsUE，请在命令行上运行`sudo srsue`。srsUE需要以sudo管理员权限运行，以便能够创建高优先级线程并在成功连接到网络后创建TUN设备。启动时，srsUE将尝试找到您的射频前端设备并连接到本地小区。

如果srsUE成功连接到本地网络，它将启动一个TUN接口`tun_srsue`。TUN接口可以像电脑上的任何其他网络接口一样使用，支持网络的数据传输。

成功连接网络的示例控制台输出：

```plaintext
linux; GNU C++ version 6.3.0 20170618; Boost_106200; UHD_003.009.007-release
Reading configuration file /.config/srsran_4g/ue.conf...
Built in RelWithDebInfo mode using commit 6b2961fce on branch next.

Opening 1 RF devices with 2 RF channels...
Opening USRP with args: type=b200,master_clock_rate=30.72e6
Waiting PHY to initialize ... done!

Attaching UE...
Searching cell in DL EARFCN=2850, f_dl=2630.0 MHz, f_ul=2510.0 MHz
Found Cell:  Mode=FDD, PCI=1, PRB=6, Ports=2, CFO=1.3 KHz
Found PLMN:  Id=00101, TAC=7
Random Access Transmission: seq=42, ra-rnti=0x2
RRC Connected
Random Access Complete.     c-rnti=0x46, ta=0
Network attach successful. IP: 192.168.3.2
```

### 配置

UE可以通过配置文件`ue.conf`进行配置。此配置文件提供有关工作频率、发射功率水平、USIM属性、日志级别等的参数。要使用已安装的配置文件运行srsUE，请使用`sudo srsue ~/.config/srsran/ue.conf`。

配置文件中指定的所有参数也可以在命令行上覆盖。例如，要使用不同的EARFCN运行UE，可以使用`sudo srsue ~/.config/srsran_4g/ue.conf --rf.dl_earfcn 3350`。

默认情况下，srsUE使用虚拟USIM卡，参数来自`ue.conf`。这些参数包括：

- ALGO - 要使用的认证算法（MILENAGE或XOR）
- IMSI - USIM的唯一标识符
- K - 与EPC中的HSS共享的秘密密钥
- OP或OPc - 运营商代码（仅与MILENAGE算法一起使用）

要成功连接到网络，这些参数需要与EPC的HSS中的参数匹配。MILENAGE是在大多数网络中使用的算法，XOR算法主要在测试设备和测试USIM卡中使用。OP是全网运营商代码，OPc是USIM特定的加密运营商代码 - 两者都受srsUE支持。

### 硬件设置

要使用srsUE通过无线连接到本地网络，您需要一个射频前端和合适的天线。默认的EARFCN是3400（上行链路2565MHz，下行链路2685MHz）。为了减少发射机-接收机串扰，我们建议将发射机和接收机天线以90度角放置。

srsUE也可以通过有线连接使用。电缆配置和所需的射频组件将取决于您的射频前端。对于像USRP这样的射频前端，请将TX连接到RX，并确保至少有30dB的衰减，以避免损坏设备。

有关有线连接的详细信息，请参见高级使用部分。

### 操作系统设置

srsUE以用户空间运行在标准Linux内核上。为了获得最佳性能，我们建议禁用CPU频率缩放。要禁用频率缩放，请使用：

```bash
echo "performance" | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
```

### 观察结果

要观察srsUE的结果，请使用生成的日志文件和数据包捕获。

默认情况下，在/tmp/ue.log下创建日志文件。srsUE配置文件可以用来指定网络栈每层的日志级别，并启用十六进制消息输出。支持的日志级别有debug、info、warning、error和none。

日志消息格式如下：

```plaintext
Timestamp  [Layer ]  Level    Content
```

例如：

```plaintext
17:52:25.246 [RLC ]  Info    DRB1 Tx SDU
```

或启用了十六进制消息输出：

```plaintext
17:52:25.246 [RLC ]  Info    DRB1 Tx SDU
         0000: 8b 45 00 00 c7 f3 8b 40 00 01 11 d1 f6 c0 a8 03
         0010: 01 ef ff ff fa 92 55 07 6c 00 b3 ee 41 4d 2d 53
```

物理层日志消息有额外的细节：

```plaintext
Timestamp  [Layer]  Level  [Subframe] Channel:  Content
```

例如：

```plaintext
17:52:26.094 [PHY1]  Info  [05788]  PDSCH:    l_crb= 1, harq=0, snr=22.1 dB, CW0: tbs=55, mcs=22, rv=0, crc=OK, it=1, dec_time=  12 us
```

srsUE应用支持在两个级别上进行数据包捕获 - MAC层和NAS层。MAC层捕获包括控制和数据流量，如果网络配置了，将会被加密。NAS层捕获仅包括控制流量，不会被加密。数据包捕获（pcap）文件可以使用Wireshark（www.wireshark.org）查看。