5G: Open5GS: Your First LTE

From OnnoWiki
Jump to navigation Jump to search

Your First LTE 2022-04-22 08:43

This post is the perfect starting point for learning to build your own LTE network. View this lession as a guided introduction – including the installation, configuration, and best practices that will ease your learning.

Prerequisites First, you have to prepare USRP B200/B210 to run srsRAN. However, please keep in mind that you would still need a fairly high-end PC (at least dual-core i5, better quad-core i7) with USB 3.0 to attach the USRP B200/B210.

For USRP B200/B210, you can use a GPS antenna for clock synchronization. Of course, it can work without a GPS antenna, but if you have that antenna, it’s a good to have a window near your desk where you can put the small GPS patch antenna. In my case, a 1 to 2 meters antenna cable is used between desk/computer and the window.

This document will be described with the following equipment.

i5-8500 PC with Ubuntu 20.04(focal) USRP B200/B210 with USB 3.0 iPhone XS sysmoUSIM-SJS1 10Mhz GPS-DO(Optional) Overall Physical Setup If you want to use GPS antenna, setup your devices in the following order:

GPS antenna near window GPS antenna connected to “GPS ANT” connector of GPS-DO (SMA) 10MHz output (BNC) of GPS-DO connected to 10MHz input of USRP (SMA) GPS input of USRP open/unused! 1PPS input of USRP open/unused! GPS-DO powered via power supply Note: When the GPS-DO acquires a lock on the GPS signal, a GREEN LED is displayed. GPS takes time to function normally. You also need to wait for the RED LED(ALARM) to turn off.

Then, setup the USRP B200/B210 as below:

Small Antennas should be connected to USRP Rx/Tx ports (RF-A/RF-B) USRP powered via power supply or over USB 3.0 USRP USB 3.0 port connected to your PC USIM Setup Bascially, you can learn how to use it in the sysmoUSIM manual or on the official homepage of pysim project. Let’s take a quickstart guide for this experiment.

Install dependencies: $ sudo apt-get install pcscd pcsc-tools libccid libpcsclite-dev python-pyscard Connect SIM card reader to your computer and insert programmable SIM card to the reader. Check the status of connection by entering the following command: $ pcsc_scan PC/SC device scanner V 1.5.2 (c) 2001-2017, Ludovic Rousseau <ludovic.rousseau@free.fr> Using reader plug'n play mechanism Scanning present readers... 0: HID Global OMNIKEY 3x21 Smart Card Reader [OMNIKEY 3x21 Smart Card Reader] 00

Sun May 26 14:26:12 2019 

Reader 0: HID Global OMNIKEY 3x21 Smart Card Reader [OMNIKEY 3x21 Smart Card Re
 Card state: Card inserted,
 ATR: 3B 9F 96 80 1F C7 80 31 A0 73 BE 21 13 67 43 20 07 18 00 00 01 A5

... If SIM card reader is recognized then we can expect to print “Card inserted”. Get the code of PySIM with installing dependency: $ sudo apt-get install python-pyscard python-serial python-pip $ pip install pytlv $ git clone git://git.osmocom.org/pysim Read your SIM card: $ ./pySim-read.py -p0 or ./pySim-read.py -p1 Using PC/SC reader (dev=0) interface Reading ... ICCID: 8988211000000213010 IMSI: 310789012345301 SMSP: ffffffffffffffffffffffffffffffffffffffffffffffffe1ffffffffffffffffffffffff ... Program your SIM card like the followings: ./pySim-prog.py -p 0 -n Open5GS -a 62416296 -s 8988211000000213010 -i 310789012345301 -x 310 -y 789 -k 82E9053A1882085FF2C020359938DAE9 -o BFD5771AAF4F6728E9BC6EF2C2533BDB Using PC/SC reader (dev=0) interface Insert card now (or CTRL-C to cancel) Autodetected card type: sysmoUSIM-SJS1 Generated card parameters : 

> Name    : Open5GS
> SMSP    : e1ffffffffffffffffffffffff0581005155f5ffffffffffff000000
> ICCID   : 8988211000000213010
> MCC/MNC : 310/789
> IMSI    : 310789012345301
> Ki      : 82E9053A1882085FF2C020359938DAE9
> OPC     : BFD5771AAF4F6728E9BC6EF2C2533BDB
> ACC     : None

Programming ... Done ! Note: You should use your ADM value to program USIM card, not my ADM(-a 62416296).

Installation We will use Ubuntu 20.04(focal) installed PC.

1. USRP Hardware Driver Most Linux distributions provide UHD as part of their package management. On Debian and Ubuntu systems, this will install the base UHD library, all headers and build-specific files, as well as utilities:

$ sudo add-apt-repository ppa:ettusresearch/uhd $ sudo apt update $ sudo apt install libuhd-dev libuhd003 uhd-host After installing, you need to download the FPGA images packages by running uhd images downloader on the command line (the actual path may differ based on your installation):

$ sudo /usr/lib/uhd/utils/uhd_images_downloader.py 2. srsRAN On Ubuntu 20.04(focal), one can install the required libraries with:

$ sudo apt install cmake libfftw3-dev libmbedtls-dev libboost-program-options-dev libconfig++-dev libsctp-dev Download and build srsLTE:

$ git clone https://github.com/srsRAN/srsRAN.git $ cd srsRAN $ git checkout release_21_10 $ git rev-parse HEAD 5275f33360f1b3f1ee8d1c4d9ae951ac7c4ecd4e $ mkdir build $ cd build $ cmake ../ $ make $ make test 3. Open5GS The Open5GS package is available on the recent versions of Ubuntu.

  1. Getting the authentication key

$ sudo apt install wget $ wget https://download.opensuse.org/repositories/home:/acetcom:/open5gs:/latest/xUbuntu_20.04/Release.key $ sudo apt-key add Release.key

  1. Installing Open5GS

$ sudo sh -c "echo 'deb https://download.opensuse.org/repositories/home:/acetcom:/open5gs:/latest/xUbuntu_20.04/ ./' > /etc/apt/sources.list.d/open5gs.list" $ sudo apt update $ sudo apt install open5gs The following shows how to install the Web UI of Open5GS.

$ curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash - $ sudo apt install nodejs $ curl -fsSL https://open5gs.org/open5gs/assets/webui/install | sudo -E bash - Configuration & Running 1. Open5GS When you purchase the sysmoUSIM, you will receive the following information via e-mail.

Title : sysmocom SIM Card Details / AM93\PICK\00859

IMSI ICCID ACC PIN1 PUK1 PIN2 PUK2 Ki OPC ADM1 KIC1 KID1 KIK1 ... 901700000017408 8988211000000174089 0100 3623 84724035 8774 57473966 B1233463AB9BC2AD2DB1830EB6417E7B 625150E2A943E3353DD23554101CAFD4 47190711 C865CAA0A54542333929B29B116F4375 7D7F65DCD99003C0A0D5D31CA3E5253E 5B27983AF628FC3FCB36B89300012944 Here’s my subscriber information from above.

MCC/MNC : 901/70 IMSI : 901700000017408 K : B1233463AB9BC2AD2DB1830EB6417E7B OPc : 625150E2A943E3353DD23554101CAFD4 If you programmed USIM using a card reader like me, you should use your SIM information.

MCC/MNC : 310/789 IMSI : 310789012345301 K : 82E9053A1882085FF2C020359938DAE9 OPc : BFD5771AAF4F6728E9BC6EF2C2533BDB Connect to http://localhost:3000 and login with admin account.

Username : admin Password : 1423

Then proceed as follows:

Go to Subscriber Menu. Click + Button to add a new subscriber. Fill the IMSI, security context(K, OPc, AMF), and APN of the subscriber. Click SAVE Button Modify install/etc/open5gs/mme.yaml to set the S1AP IP address, PLMN ID, and TAC.

$ diff -u /etc/open5gs/mme.yaml.old /etc/open5gs/mme.yaml --- mme.yaml.old 2020-08-22 12:07:32.755250028 -0400 +++ mme.yaml 2020-08-22 12:08:17.309320211 -0400 @@ -208,20 +208,20 @@ 

mme:
    freeDiameter: /home/acetcom/Documents/git/open5gs/install/etc/freeDiameter/mme.conf
    s1ap:

- addr: 127.0.0.2 + addr: 127.0.1.2 

    gtpc:
      addr: 127.0.0.2
    gummei:
      plmn_id:

- mcc: 901 - mnc: 70 + mcc: 310 + mnc: 789 

      mme_gid: 2
      mme_code: 1
    tai:
      plmn_id:

- mcc: 901 - mnc: 70 - tac: 1 + mcc: 310 + mnc: 789 + tac: 2 

    security:
        integrity_order : [ EIA1, EIA2, EIA0 ]
        ciphering_order : [ EEA0, EEA1, EEA2 ]

Modify install/etc/open5gs/sgwu.yaml to set the GTP-U IP address.

$ diff -u /etc/open5gs/sgwu.yaml.old /etc/open5gs/sgwu.yaml --- sgwu.yaml.old 2020-08-22 12:08:44.782880778 -0400 +++ sgwu.yaml 2020-08-22 12:06:49.809299514 -0400 @@ -82,7 +82,7 @@ 

#
sgwu:
    gtpu:

- addr: 10.11.0.6 + addr: 127.0.0.6 

    pfcp:
      addr: 127.0.0.6

After changing conf files, please restart Open5GS daemons.

$ sudo systemctl restart open5gs-mmed.service $ sudo systemctl restart open5gs-sgwud.service If your phone can connect to internet, you must run the following command in Open5GS-PGW installed host.

      1. Check IP Tables

$ sudo iptables -L Chain INPUT (policy ACCEPT) target prot opt source destination

Chain FORWARD (policy ACCEPT) target prot opt source destination

Chain OUTPUT (policy ACCEPT) target prot opt source destination

      1. Check NAT Tables

$ sudo iptables -L -t nat Chain PREROUTING (policy ACCEPT) target prot opt source destination

Chain INPUT (policy ACCEPT) target prot opt source destination

Chain OUTPUT (policy ACCEPT) target prot opt source destination

Chain POSTROUTING (policy ACCEPT) target prot opt source destination

      1. Enable IPv4/IPv6 Forwarding

$ sudo sysctl -w net.ipv4.ip_forward=1 $ sudo sysctl -w net.ipv6.conf.all.forwarding=1

      1. Add NAT Rule

$ sudo iptables -t nat -A POSTROUTING -s 10.45.0.0/16 ! -o ogstun -j MASQUERADE $ sudo ip6tables -t nat -A POSTROUTING -s 2001:db8:cafe::/48 ! -o ogstun -j MASQUERADE Note: For the first time, it is a good condition if you do not have any rules in the IP/NAT tables. If a program such as docker has already set up a rule, you will need to add a rule differently.

2. srsRAN Change back to the srsRAN source directory and copy the main config example as well as all additional config files for RR, SIB and DRB.

$ cp srsenb/enb.conf.example srsenb/enb.conf $ cp srsenb/rr.conf.example srsenb/rr.conf $ cp srsenb/drb.conf.example srsenb/drb.conf $ cp srsenb/sib.conf.example srsenb/sib.conf $ cp srsenb/sib.conf.mbsfn.example srsenb/sib.conf.mbsfn You should check your phone frequency. If your phone does not support Band-3, you should use a different DL EARFCN value.

$ diff -u enb.conf.example enb.conf -- enb.conf.example 2022-01-19 20:30:13.612993155 +0900 +++ enb.conf 2022-01-19 21:04:15.674419300 +0900 @@ -20,9 +20,9 @@ 

#####################################################################
[enb]
enb_id = 0x19B

-mcc = 001 -mnc = 01 -mme_addr = 127.0.1.100 +mcc = 310 +mnc = 789 +mme_addr = 127.0.1.2 

gtp_bind_addr = 127.0.1.1
s1c_bind_addr = 127.0.1.1
s1c_bind_port = 0

@@ -67,7 +67,7 @@ 

tx_gain = 80
rx_gain = 40

-#device_name = auto +device_name = auto 

# For best performance in 2x2 MIMO and >= 15 MHz use the following device_args settings:
#     USRP B210: num_recv_frames=64,num_send_frames=64

@@ -81,7 +81,7 @@ 

# Example for ZMQ-based operation with TCP transport for I/Q samples
#device_name = zmq

-#device_args = fail_on_disconnect=true,tx_port=tcp://*:2000,rx_port=tcp://localhost:2001,id=enb,base_srate=23.04e6 +device_args = clock=external 

#####################################################################
# Packet capture configuration

$ diff -u rr.conf.example rr.conf -- rr.conf.example 2022-01-19 20:30:13.620992794 +0900 +++ rr.conf 2022-01-19 21:05:21.959044145 +0900 @@ -55,10 +55,10 @@ 

  {
    // rf_port = 0;
    cell_id = 0x01;

- tac = 0x0007; + tac = 0x0002; 

    pci = 1;
    // root_seq_idx = 204;

- dl_earfcn = 3350; + dl_earfcn = 1600; 

    //ul_earfcn = 21400;
    ho_active = false;
    //meas_gap_period = 0; // 0 (inactive), 40 or 80

@@ -114,4 +114,4 @@ 

nr_cell_list =
(
  // no NR cells

MME Address, TAC, PLMN ID, DL EARFCN, and Device Argument are updated as belows.

MME Address : 127.0.1.2 TAC : 2 PLMN ID : MNC(310), MCC(789) programmed USIM with a card reader DL EARFCN : Band-3 - from your Phone Device Argument : Clock source from external GPS-DO If you are not using GPS-DO, you can just comment out device_args as shown below.

$ diff -u enb.conf enb.conf.no_gps_do --- enb.conf 2022-01-19 21:08:32.941527373 +0900 +++ enb.conf.no_gps_do 2022-01-19 21:10:18.612581261 +0900 @@ -81,7 +81,7 @@ 

# Example for ZMQ-based operation with TCP transport for I/Q samples
#device_name = zmq

-device_args = clock=external +#device_args = fail_on_disconnect=true,tx_port=tcp://*:2000,rx_port=tcp://localhost:2001,id=enb,base_srate=23.04e6 

#####################################################################
# Packet capture configuration

Now, run the srsRAN as follows:

$ cd srsenb/ $ sudo UHD_IMAGES_DIR=/usr/share/uhd/images ../build/srsenb/src/srsenb ./enb.conf --- Software Radio Systems LTE eNodeB ---

Reading configuration file ./enb.conf... WARNING: cpu0 scaling governor is not set to performance mode. Realtime processing could be compromised. Consider setting it to performance mode before running the application.

Built in Release mode using commit 5275f3336 on branch HEAD.

connect(): Connection refused Failed to initiate S1 connection. Attempting reconnection in 10 seconds Opening 1 channels in RF device=default with args=default Available RF device list: UHD Trying to open RF device 'UHD' [INFO] [UHD] linux; GNU C++ version 9.3.0; Boost_107100; UHD_4.1.0.4-release [INFO] [LOGGING] Fastpath logging disabled at runtime. Opening USRP channels=1, args: type=b200,master_clock_rate=23.04e6 [INFO] [UHD RF] RF UHD Generic instance constructed [INFO] [B200] Detected Device: B200 [INFO] [B200] Operating over USB 3. [INFO] [B200] Initialize CODEC control... [INFO] [B200] Initialize Radio control... [INFO] [B200] Performing register loopback test... [INFO] [B200] Register loopback test passed [INFO] [B200] Asking for clock rate 23.040000 MHz... [INFO] [B200] Actually got clock rate 23.040000 MHz. RF device 'UHD' successfully opened

= eNodeB started

Type <t> to view trace Turn on your eNodeB and Phone You can see actual traffic through wireshark – [srsenb.pcapng]. You can view the log at /var/log/open5gs/*.log.



Referensi

Retrieved from "https://onnocenter.or.id/wiki/index.php?title=5G:_Open5GS:_Your_First_LTE&oldid=64938"