Skip to content

O
openairinterface-6g
Commit a0d8baf3 authored by Laurent THOMAS's avatar Laurent THOMAS Committed by calvin_peyron
Browse files
Options

update and rename TESTING_GNB_W_COTS_UE.md to describe actual content

parent 2ea4cbbd
Hide whitespace changes
Inline Side-by-side
Showing with 33 additions and 30 deletions
doc/README.md
View file @ a0d8baf3
...@@ -52,7 +52,7 @@ There is some general information in the [OpenAirInterface Gitlab Wiki](https:// ...@@ -52,7 +52,7 @@ There is some general information in the [OpenAirInterface Gitlab Wiki](https://
* IF setups and arbitrary frequencies * IF setups and arbitrary frequencies
* MIMO * MIMO
- [How to run OAI with O-RAN 7.2 FHI](./ORAN_FHI7.2_Tutorial.md) - [How to run OAI with O-RAN 7.2 FHI](./ORAN_FHI7.2_Tutorial.md)
- [How to run a 5G-NSA setup](./TESTING_GNB_W_COTS_UE.md) - [How to run a 5G-NSA setup](./TESTING_OAI_NSA_COTS_UE.md)
- [How to run a 4G setup using L1 simulator](./L1SIM.md) _Note: we recommend the RFsimulator_ - [How to run a 4G setup using L1 simulator](./L1SIM.md) _Note: we recommend the RFsimulator_
- [How to use the L2 simulator](./L2NFAPI.md) - [How to use the L2 simulator](./L2NFAPI.md)
- [How to use the OAI channel simulator](../openair1/SIMULATION/TOOLS/DOC/channel_simulation.md) - [How to use the OAI channel simulator](../openair1/SIMULATION/TOOLS/DOC/channel_simulation.md)
......
doc/TESTING_GNB_W_COTS_UE.md → doc/TESTING_OAI_NSA_COTS_UE.md
View file @ a0d8baf3
...@@ -7,12 +7,12 @@ STATUS 2020/10/15 : added External Resources section and links ...@@ -7,12 +7,12 @@ STATUS 2020/10/15 : added External Resources section and links
## External Resources ## External Resources
Additional Resources to this page can be found here (special mention to Walter Maguire <wmaguire@live.com>) : Additional Resources to this page can be found here (special mention to Walter Maguire <wmaguire@live.com>) :
https://docs.google.com/document/d/1pL8Szm0ocGxdl5ESVp12Ff71a4PbhCb9SpvbLZzwYbo/edit?usp=sharing [Additional Notes Supporting the OAI COTS NSA](https://docs.google.com/document/d/1pL8Szm0ocGxdl5ESVp12Ff71a4PbhCb9SpvbLZzwYbo/edit?usp=sharing)
At time of writing, the openairinterface5G Commit Tag is 2020.w39 At time of writing, the openairinterface5G Commit Tag is 2020.w39
Faraday Cages can be found here : Faraday Cages can be found here :
http://www.saelig.com/MFR00066/ste2300.htm [Faraday Cage](http://www.saelig.com/MFR00066/ste2300.htm)
## Configuration Overview ## Configuration Overview
...@@ -37,32 +37,32 @@ Our code might not work with all 5G phones yet, but we are constantly improving ...@@ -37,32 +37,32 @@ Our code might not work with all 5G phones yet, but we are constantly improving
* Simcom SIMCOM8200EA * Simcom SIMCOM8200EA
* Quectel RM500Q-GL * Quectel RM500Q-GL
Note1: In the version we have at Eurecom, you need to set the PLMN to 50501, and you also need to change the firmware to "11.0.0 (RD1A.201105.003.B1, Nov 2020, EU carriers)" (see https://developers.google.com/android/images) Note1: In the version we have at Eurecom, you need to set the PLMN to 50501, and you also need to change the firmware to "11.0.0 (RD1A.201105.003.B1, Nov 2020, EU carriers)" (see [Factory Images for Nexus and Pixel Devices](https://developers.google.com/android/images))
## Repository ## Repository
https://gitlab.eurecom.fr/oai/openairinterface5g/tree/develop [OAI](https://gitlab.eurecom.fr/oai/openairinterface5g/tree/develop)
## Architecture Setup ## Architecture Setup
The scheme below depicts our typical setup: The scheme below depicts our typical setup:
![image info](./testing_gnb_w_cots_ue_resources/oai_fr1_setup.jpg) ![image info](./images/oai_fr1_setup.jpg)
The photo depicts the FR1 setup part of the scheme above: The photo depicts the FR1 setup part of the scheme above:
![image info](./testing_gnb_w_cots_ue_resources/oai_fr1_lab.jpg) ![image info](./images/oai_fr1_lab.jpg)
## Build and Install ## Build and Install
General guidelines to build eNB and gNB : General guidelines to build eNB and gNB :
See https://gitlab.eurecom.fr/oai/openairinterface5g/blob/develop/doc/BUILD.md#building-ues-enodeb-and-gnodeb-executables See [Building UE, eNB and gNb executables](https://gitlab.eurecom.fr/oai/openairinterface5g/blob/develop/doc/BUILD.md#building-ues-enodeb-and-gnodeb-executables)
- **eNB** - **eNB**
``` ```bash
cd <your oai installation directory>/openairinterface5g/ cd <your oai installation directory>/openairinterface5g/
source oaienv source oaienv
cd cmake_targets/ cd cmake_targets/
...@@ -72,7 +72,7 @@ cd cmake_targets/ ...@@ -72,7 +72,7 @@ cd cmake_targets/
- **gNB** - **gNB**
``` ```bash
cd <your oai installation directory>/openairinterface5g/ cd <your oai installation directory>/openairinterface5g/
source oaienv source oaienv
cd cmake_targets/ cd cmake_targets/
...@@ -83,8 +83,7 @@ cd cmake_targets/ ...@@ -83,8 +83,7 @@ cd cmake_targets/
- **EPC** - **EPC**
for reference: for reference:
https://github.com/OPENAIRINTERFACE/openair-epc-fed/blob/master/docs/DEPLOY_HOME.md [DEPLOY_HOME_MAGMA_MME](https://github.com/OPENAIRINTERFACE/openair-epc-fed/blob/master/docs/DEPLOY_HOME_MAGMA_MME.md)
## Configuration Files ## Configuration Files
...@@ -93,15 +92,17 @@ Each component (EPC, eNB, gNB) has its own configuration file. ...@@ -93,15 +92,17 @@ Each component (EPC, eNB, gNB) has its own configuration file.
These config files are passed as arguments of the run command line, using the option -O \<conf file\> These config files are passed as arguments of the run command line, using the option -O \<conf file\>
The **REFERENCE** files for eNB and gNB, **used by the CI**, can be found here: The **REFERENCE** files for eNB and gNB, **used by the CI**, can be found here:
[enb conf file](../ci-scripts/conf_files/enb.band7.tm1.fr1.25PRB.usrpb210.conf) * [enb conf file](../ci-scripts/conf_files/enb.band7.25prb.usrpb200.tm1.conf)
[gnb conf file](../ci-scripts/conf_files/gnb.band78.tm1.fr1.106PRB.usrpb210.conf) * [gnb conf file](../ci-scripts/conf_files/gnb-du.sa.band78.106prb.usrpb200.conf)
These files have to be updated manually to set the IP addresses and frequency. These files have to be updated manually to set the IP addresses and frequency.
---
**ATTENTION** : an **EXTERNAL** clock is used to sync the eNB and gNB, >**⚠️ ATTENTION ⚠️**
whether the clock is internal or external is defined in the configuration files (!! details needed !!) >
>An **EXTERNAL** clock is used to sync the eNB and gNB, whether the clock is internal or external is defined in the configuration files (!! details needed !!)
>
---
1- In the **eNB configuration file** : 1- In the **eNB configuration file** :
- look for MME IP address, and update the **ipv4 field** with the IP address of the **EPC** server - look for MME IP address, and update the **ipv4 field** with the IP address of the **EPC** server
...@@ -198,14 +199,13 @@ The test takes typically a few seconds, max 10-15 seconds. If it takes more than ...@@ -198,14 +199,13 @@ The test takes typically a few seconds, max 10-15 seconds. If it takes more than
- **EPC** (on EPC host): - **EPC** (on EPC host):
for reference: for reference:
https://github.com/OPENAIRINTERFACE/openair-epc-fed/blob/master/docs/DEPLOY_HOME.md [DEPLOY_HOME_MAGMA_MME](https://github.com/OPENAIRINTERFACE/openair-epc-fed/blob/master/docs/DEPLOY_HOME_MAGMA_MME.md)
- **eNB** (on the eNB host): - **eNB** (on the eNB host):
Execute: Execute:
``` ```bash
~/openairinterface5g/cmake_targets/ran_build/build$ sudo ./lte-softmodem -O **YOUR_ENB_CONF_FILE** | tee **YOUR_LOG_FILE** ~/openairinterface5g/cmake_targets/ran_build/build$ sudo ./lte-softmodem -O **YOUR_ENB_CONF_FILE** | tee **YOUR_LOG_FILE**
``` ```
...@@ -213,13 +213,16 @@ Execute: ...@@ -213,13 +213,16 @@ Execute:
- **gNB** (on the gNB host) - **gNB** (on the gNB host)
---
**ATTENTION** : for the gNB execution, >**⚠️ ATTENTION ⚠️**
The **-E** option is required to enable the tri-quarter sampling rate when using a B2xx serie USRP >
The **-E** option is **NOT supported** when using a a N300 USRP > For the gNB execution:
> - The **-E** option is required to enable the tri-quarter sampling rate when using a B2xx serie USRP
> - The **-E** option is **NOT supported** when using a a N300 USRP
---
Execute: Execute:
``` ```bash
~/openairinterface5g/cmake_targets/ran_build/build$ sudo ./nr-softmodem -O **YOUR_GNB_CONF_FILE** -E --nsa | tee **YOUR_LOG_FILE** ~/openairinterface5g/cmake_targets/ran_build/build$ sudo ./nr-softmodem -O **YOUR_GNB_CONF_FILE** -E --nsa | tee **YOUR_LOG_FILE**
``` ```
...@@ -229,9 +232,9 @@ Execute: ...@@ -229,9 +232,9 @@ Execute:
The test case corresponds to the UE attachement, that is the UE connection and its initial access in 5G, as depicted below: The test case corresponds to the UE attachement, that is the UE connection and its initial access in 5G, as depicted below:
**Source** : https://www.sharetechnote.com/html/5G/5G_LTE_Interworking.html **Source** : [5G/LTE interworking](https://www.sharetechnote.com/html/5G/5G_LTE_Interworking.html )
![image info](./testing_gnb_w_cots_ue_resources/attach_signaling_scheme.jpg) ![image info](./images/attach_signaling_scheme.jpg)
The test reaches step **12. E-RAB modifcation confirmation** , eventhough not all the messages will appear in the log file. The test reaches step **12. E-RAB modifcation confirmation** , eventhough not all the messages will appear in the log file.
...@@ -239,8 +242,8 @@ The test reaches step **12. E-RAB modifcation confirmation** , eventhough not al ...@@ -239,8 +242,8 @@ The test reaches step **12. E-RAB modifcation confirmation** , eventhough not al
From the log file that is generated, we can monitor several important steps, to assess that the test was successful. From the log file that is generated, we can monitor several important steps, to assess that the test was successful.
Log files examples can be found here: Log files examples can be found here:
[enb log file](https://gitlab.eurecom.fr/oai/openairinterface5g/-/blob/rh_doc_update_3/doc/testing_gnb_w_cots_ue_resources/oai_enb.log) * [enb log file](./testing_oai_nsa_w_cots_ue_resources/oai_enb.log)
[gnb log file](https://gitlab.eurecom.fr/oai/openairinterface5g/-/blob/rh_doc_update_3/doc/testing_gnb_w_cots_ue_resources/oai_gnb.log) * [gnb log file](./testing_oai_nsa_w_cots_ue_resources/oai_gnb.log)
- eNB receives UE capabilities information, including its NR capabilites, and triggers sGNB Addition Request message: - eNB receives UE capabilities information, including its NR capabilites, and triggers sGNB Addition Request message:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment