Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
O
OpenXG UE
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Michael Black
OpenXG UE
Commits
ae448552
Commit
ae448552
authored
Oct 27, 2021
by
Melissa
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update README.txt for NSA mode
parent
1c6c2900
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
16 additions
and
16 deletions
+16
-16
doc/episys/nsa_mode_l2_emulator/README.txt
doc/episys/nsa_mode_l2_emulator/README.txt
+16
-16
No files found.
doc/episys/nsa_mode_l2_emulator/README.txt
View file @
ae448552
There are fundamental changes to the L2 emulation mechanism; these changes allow the
There are fundamental changes to the L2 emulation mechanism; these changes allow the
user to run multiple UEs in separate Linux processes/machines/VMs/etc. They use a separate
user to run multiple UEs in separate Linux processes/machines/VMs/etc. They use a separate
entity between the UE(s) and eNB
; where the UEs use nFAPI to communicate with the e
NB. The
entity between the UE(s) and eNB
/gNB. The UEs use nFAPI to communicate with the eNB/g
NB. The
nFAPI interface allows us to run in an emulated L2 mode, meaning that we are bypassing
nFAPI interface allows us to run in an emulated L2 mode, meaning that we are bypassing
the layer 1 (PHY) layer functionality. Becasue we are bypassing the PHY layer, special
the layer 1 (PHY) layer functionality. Becasue we are bypassing the PHY layer, special
channel model
l
ing capabilty has been added in the LTE UE phy_stub_ue.c file. To understand
channel modeling capabilty has been added in the LTE UE phy_stub_ue.c file. To understand
the interfaces between the different components associated with NSA mode, the image
the interfaces between the different components associated with NSA mode, the image
functional_diagram_proxy_nsa.png has been provided.
functional_diagram_proxy_nsa.png has been provided.
This functionality allows the user to plug in their own channel model and emulat
or
the packet dropping procedure
This functionality allows the user to plug in their own channel model and emulat
e
the packet dropping procedure
in real time. The channel model
l
ing has not been provided by EpiSci, but the OAI code
in real time. The channel modeling has not been provided by EpiSci, but the OAI code
base already has some BLER curves available for use. The chan
nle model
ling functionality
base already has some BLER curves available for use. The chan
el mode
ling functionality
that is included in the phy_stub_ue.c file only includes the downlink channel model
l
ing.
that is included in the phy_stub_ue.c file only includes the downlink channel modeling.
Any uplink channel model
l
ing must be conducted in some sort of proxy, which would sit
Any uplink channel modeling must be conducted in some sort of proxy, which would sit
between the UEs and eNB
. (A description of the downlink channel model
ling is shown in the
between the UEs and eNB
/gNB. (A description of the downlink channel mode
ling is shown in the
Channel_Abstraction_UE_Handling_LTE.PNG image).
Channel_Abstraction_UE_Handling_LTE.PNG image).
The updates to the OAI code base removed some latent bugs, added multi-UE scalability,
The updates to the OAI code base removed some latent bugs, added multi-UE scalability,
and were tested with a standard bypass proxy between the UE(s) and eNB. The bypass proxy is
and were tested with a standard bypass proxy between the UE(s) and eNB
/gNB
. The bypass proxy is
publicly available on GitHub. With this package,
publicly available on GitHub
(https://github.com/EpiSci/oai-lte-multi-ue-proxy)
. With this package,
various multi-UE scenarios can be tested without the overhead of PHY-layer features
various multi-UE scenarios can be tested without the overhead of PHY-layer features
of underlying radios.
of underlying radios.
The added features to the OAI code base are listed below.
- Ease of use of gprof and address sanitizer for debugging purposes
- Ease of use of gprof and address sanitizer for debugging purposes
- Updated json files to allow for GDB, real-time debugging capabilities
- Updated json files to allow for GDB, real-time debugging capabilities
- Updated logging features to minimally log only key connection milestones. This improves scalability of multiple UEs.
- Updated logging features to minimally log only key connection milestones. This improves scalability of multiple UEs.
The logging mechanism described here is located in the log.c and log.h files. The LOG_MINIMAL
The logging mechanism described here is located in the log.c and log.h files. The LOG_MINIMAL
function allows us to remove
all OAI logging and only include LOG_A(...) logs
. The LOG_A
function allows us to remove
most logs and include LOG_A(...) logs and above
. The LOG_A
logs were chosen as analysis logs to meet EpiSci's internal testing procedure. The LOG_As
logs were chosen as analysis logs to meet EpiSci's internal testing procedure. The LOG_As
only include logs that are considered to be
critical milestones in a particular procedure. (i.e.
a
only include logs that are considered to be
milestones in a given test. For example,
a
log indicating that the
RACH procedure has been completed for LTE.) To revert to the original logging
log indicating that the
CFRA procedure has been completed for NSA mode. To revert to full logging,
mechanism, simply
set LOG_MINIMAL = 0 in the log.h file.
set LOG_MINIMAL = 0 in the log.h file.
- Updated logging to include time stamp for timing analysis
- Updated logging to include time stamp for timing analysis
- Updated memory allocation procedures to correct size requirements
- Updated memory allocation procedures to correct size requirements
- Added debugging features to handle signal terminations
- Added debugging features to handle signal terminations
...
@@ -52,7 +52,7 @@ mechanism, simply set LOG_MINIMAL = 0 in the log.h file.
...
@@ -52,7 +52,7 @@ mechanism, simply set LOG_MINIMAL = 0 in the log.h file.
Additionally, NSA mode includes the establishment between an NR UE and the gNB via the LTE UE and eNB
Additionally, NSA mode includes the establishment between an NR UE and the gNB via the LTE UE and eNB
connection. For NSA mode, the downlink channel abstraction has not been added to the feature set yet.
connection. For NSA mode, the downlink channel abstraction has not been added to the feature set yet.
NSA mode has been tested and is fully functional with EpiSci's public version of the nFAPI proxy
NSA mode has been tested and is fully functional with EpiSci's public version of the nFAPI proxy
located at https://github.com/EpiSci/oai-lte-multi-ue-proxy
/blob/master/README.md
located at https://github.com/EpiSci/oai-lte-multi-ue-proxy
NSA mode establishment includes the following steps:
NSA mode establishment includes the following steps:
- First UE capability enquiry is sent to NR UE
- First UE capability enquiry is sent to NR UE
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment