Code Review
/
it
/
test.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
review
|
tree
raw
|
inline
| side by side
Reorganize directories and switch libaries to using asn1c
[it/test.git]
/
simulators
/
e2sim
/
README.md
diff --git
a/simulators/e2sim/README.md
b/simulators/e2sim/README.md
index
6c8d10c
..
db93deb
100644
(file)
--- a/
simulators/e2sim/README.md
+++ b/
simulators/e2sim/README.md
@@
-1,4
+1,4
@@
-/*****************************************************************************
+
#
/*****************************************************************************
# *
# Copyright 2019 AT&T Intellectual Property *
# Copyright 2019 Nokia *
# *
# Copyright 2019 AT&T Intellectual Property *
# Copyright 2019 Nokia *
@@
-15,11
+15,11
@@
# See the License for the specific language governing permissions and *
# limitations under the License. *
# *
# See the License for the specific language governing permissions and *
# limitations under the License. *
# *
-******************************************************************************/
+
#
******************************************************************************/
-# INSTALLATION
- * Tested environment: Ubuntu 16.04
-
*
Install dependencies
+
+# INSTALLATION (tested on Ubuntu 16.04)
+
1.
Install dependencies
$ sudo apt-get update
$ sudo apt-get install -y
build-essential
$ sudo apt-get update
$ sudo apt-get install -y
build-essential
@@
-35,40
+35,51
@@
libboost-all-dev
$ sudo apt-get clean
libboost-all-dev
$ sudo apt-get clean
- ## Build
- $ ./build_e2sim
+ 2. SET ENVIRONMENT VARIABLE
+ Add this line to `~/.bashrc`
+ export E2SIM_DIR=<your e2sim directory>
-# SET ENVIRONMENT VARIABLE
- Add this line to `~/.bashrc`
- $ export E2SIM_DIR=<your e2sim directory>
+ 3. Build the official e2sim
+ $ ./build_e2sim
-# RUN E2SIM
- $ cd $E2SIM_DIR/build/
- $ ./e2agent [SERVER IP] [PORT]
+# USAGE
+ $ $E2SIM_DIR/build/e2sim [SERVER IP] [PORT]
- By default, SERVER IP = 127.0.0.1, PORT = 3642
2 (X2AP Port)
+ By default, SERVER IP = 127.0.0.1, PORT = 3642
1
# DOCKER
Note: The commands in this section must be run from $E2SIM_DIR
* Build docker image
# DOCKER
Note: The commands in this section must be run from $E2SIM_DIR
* Build docker image
- $
./build_docker
+ $
sudo docker build -f docker/Dockerfile -t [DOCKER_IMAGE]:[TAG] .
-
## R
un docker container
- $ sudo docker run --rm --net host -it
e2agent sh -c "./build/e2agent
[SERVER IP] [PORT]"
+
* Example how to r
un docker container
+ $ sudo docker run --rm --net host -it
[DOCKER_IMAGE]:[TAG] sh -c "./build/e2sim
[SERVER IP] [PORT]"
-# SUPPORTED MESSAGE FLOWS
(Last updated May 24, 2019)
+# SUPPORTED MESSAGE FLOWS
-- X2 SETUP REQUEST (RIC -> RAN)
-- X2 SETUP RESPONSE (RAN -> RIC)
+- RIC INDICATION (RAN -> RIC) version 1.3.0 September 13, 2019
+ SgNBAdditionRequest
+
+- RIC SUBSCRIPTION REQUEST (RIC -> RAN) version 1.2.0 May 24, 2019
+- RIC SUBSCRIPTION RESPONSE (RAN -> RIC)
+- RIC SUBSCRIPTION FAILURE (RAN -> RIC)
- ENDC X2 SETUP REQUEST (RIC -> RAN)
- ENDC X2 SETUP RESPONSE (RAN -> RIC)
- ENDC X2 SETUP REQUEST (RIC -> RAN)
- ENDC X2 SETUP RESPONSE (RAN -> RIC)
-- RIC SUBSCRIPTION REQUEST (RIC -> RAN)
-- RIC SUBSCRIPTION RESPONSE (RAN -> RIC)
-- RIC SUBSCRIPTION FAILURE (RAN -> RIC)
+- X2 SETUP REQUEST (RIC -> RAN)
+- X2 SETUP RESPONSE (RAN -> RIC)
+
+# GENERATING ASN1C CODES FOR E2AP, E2SM, X2AP
+ 1. Install asn1c compiler
+ ./tools/install_asn1c
+ 2. Generate asn1c codes using e2ap, e2sm and x2ap specs
+ Download the following files into tools/asn_defs
+ - e2ap-v031.asn
+ - e2sm-gNB-X2-release-1-v041.asn
+ - x2ap-no-desc-15-04.asn
# Change logs:
03/12/2019: currently supports sending and receiving X2 SETUP messages
# Change logs:
03/12/2019: currently supports sending and receiving X2 SETUP messages