Skip to content

Latest commit

 

History

History
153 lines (127 loc) · 7.82 KB

README.md

File metadata and controls

153 lines (127 loc) · 7.82 KB
Raw

Description: to understand output from srsRAN and other
Tutorial:

Table of Contents

1. Trace File

to get log files check

## gnb
/tmp/gnb.log
/tmp/gnb_mac.pcap

## ue
/tmp/ue.log
/tmp/ue_metrics.csv
metrics full name expected value note
pci Physical Cell Identifier number identification of a cell physical layer, determined bt PSS (Primary Sync Signal) and SSS (Secondary Sync Signal)
mcs Modulation and Coding Scheme 0 (low target code rate) - 28 (high target code rate) There are three tables
brate Bitrate bit/sec
rsrp Reference Signal Receive Power dBm
snr signal to noise ratio dB
ok Number of packet successfully sent no. of pkg
nok Number of packet dropped no. of pkg
(%) % of packets dropped %
ta Timing advanced ms

1.1. gNB

          |--------------------DL---------------------|-------------------UL------------------------------
 pci rnti | cqi  ri  mcs  brate   ok  nok  (%)  dl_bs | pusch  mcs  brate   ok  nok  (%)    bsr    ta  phr
   1 4604 |  15   1   28   3.3M  134    0   0%      0 |  27.9   28   126k   25    1   3%      0   0us   28
   1 4604 |  15   1   28   857k   57    0   0%      0 |  28.0   28    95k   19    0   0%      0   0us   28
   1 4604 |  15   1   28   324k   43    0   0%      0 |  25.8   28   169k   24    4  14%      0   0us   26
   1 4604 |  15   1   27   1.7M  134    2   1%      0 |  28.2   28   172k   39    0   0%      0   n/a   28
   1 4604 |  15   1   28    14M  551    0   0%      0 |  27.4   28   217k   47    0   0%      0   0us   28
   1 4604 |  15   1   28   6.7M  285    0   0%      0 |  28.7   28   187k   38    0   0%      0   n/a   28
# metrics full name expected value note
DL rnti Radio Network Temporary Identifier 0000-FFFF UE identifier
cqi Channel Quality Indicator 1 (poor) - 15 (best), 0 is out of range reported by the UE. Main focus on different modulation
ri rank indicator 1 (worst performance) or 2 (best performance) reported from the UE showing how well multiple antenna work, 2 means no correlation/interference between the antenna, 1 means signal from two Tx Antenna perceived by UE to be like single signal from single antenna
dl_bs downlink buffer status bytes data waiting to be transmitted as reported by the gNB
UL pusch PUSCH SINR (Signal-to-Interference-plus-Noise Ratio) dB
bsr Buffer status report bytes data waiting to be transmitted as reported by the UE
phr Power headroom dB [-23, 40] how much transmission power left for a UE to use in addition to the power being used by current transmission

1.2. UE

---------Signal-----------|-----------------DL-----------------|-----------UL-----------
rat  pci  rsrp   pl   cfo | mcs  snr  iter  brate  bler  ta_us | mcs   buff  brate  bler
 nr    1    39    0 -6.0u |  26   65   1.0    16k    0%    0.0 |  26    0.0   109k    0%
 nr    1    39    0 -4.0u |  26   67   1.4    19k    0%    0.0 |  26    0.0   112k    0%
 nr    1    39    0  415n |  27   68   2.5    17k    0%    0.0 |  26     90   104k    0%
 nr    1    39    0 -2.0u |  27   66   2.3    18k    0%    0.0 |  26     90   111k    0%
# metrics full name expected value note
Signal rat component carrier lte or nr
pl path loss dB
cfo Carrier Frequency Offset Hz mismatch carrier frequency between transmitted signal and recieved signal
DL iter Average number of turbo decider iterations
bler block error rate rate of transmitted block/error recieved block)
UL buff uplink buffer status byte data waiting to be transmitted

2. Wireshark

following this link: https://docs.srsran.com/projects/project/en/latest/user_manuals/source/outputs.html

  • add entry of DLT_User with specified protocol (edit->preference->protocols->DLT_user)

2.1. MAC PCAP

  • enable on gnb config

  • enable MAC_NR protocol (analyze->enabled protocols->MAC_NR-> enable mac_nr_udp)
  • edit preference of the protocol (edit->preference->protocols->MAC_NR => enable both "Attemtps to...", set LCID->DRB mapping to "From configuration protocol"
  • see result in wireshark

3. Grafana GUI

following this link: https://docs.srsran.com/projects/project/en/latest/user_manuals/source/grafana_gui.html

  • add metrics in gnb config file
metrics:
    enable_json_metrics: true       # Enable reporting metrics in JSON format
    addr: 172.19.1.4                # Metrics-server IP
    port: 55555                     # Metrics-server Port
  • launching GUI
sudo docker compose -f docker/docker-compose.yml up grafana
  • the following should show
Creating network "docker_ran" with the default driver
Starting metrics_server ...
Starting metrics_server ... done
Creating grafana        ... done
Attaching to grafana
  • go to http://localhost:3300/ in your browser

4. htop

htop
echo q | htop | aha --black --line-fix > htop.html

Could show usage of single or multiple core operating.


Can show snippet of single core 100% usage, but it should show other core work as well. However, if it shows result like below, the gnb trace can return `Late: 6000; Underflow: 0; Overflow: 0; Error: exceeded maximum number of timed out transmissions.`



For this problem, can try to assign it to use other core

sudo taskset -c 0-7 ./gnb -c ./your_config_file

However, if the issue persist, advice to reinstall Ubuntu22.04, then reinstall srsRAN_Project again.