Description: to understand output from srsRAN and other
Tutorial:
- description gNB: https://docs.srsran.com/projects/project/en/latest/user_manuals/source/console_ref.html \
- and: https://docs.srsran.com/projects/4g/en/latest/usermanuals/source/srsenb/source/6_enb_commandref.html \
- description UE: https://docs.srsran.com/projects/4g/en/latest/usermanuals/source/srsue/source/6_ue_commandref.html#ue-commandref
- wireshark: https://docs.srsran.com/projects/project/en/latest/user_manuals/source/outputs.html
- grafana: https://docs.srsran.com/projects/project/en/latest/user_manuals/source/grafana_gui.html
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 |
|--------------------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 |
---------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 |
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)
- 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
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
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.