forked from herlesupreeth/openair-cn-new
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
110 lines (81 loc) · 4.29 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
#------------------------------------------------------------------------------
OPENAIR-CN
An implementation of the Evolved Packet Core network.
#------------------------------------------------------------------------------
Openair-cn is an implementation of the 3GPP specifications concerning the
Evolved Packet Core Networks, that means it contains the implementation of the
following network elements: MME, HSS, S-GW, P-GW.
#------------------------------------------------------------------------------
UE info
KI:12341234123412341234123412341234
OPC:4340DE834D7F30CF4DAE8FADE6C54686
AMP:8234
PLMN:64F020
Authentication algorithm:milenage
IMSI: 46002XXXXXXXXXX
#------------------------------------------------------------------------------
Network
sudo ip addr add 192.168.11.1/24 dev eth0 label eth0:11 s11mme
sudo ip addr add 192.168.11.2/24 dev eth0 label eth0:21 s11sgw
eth0 inet 10.62.48.29 s1cmme sctp port 5000
cenb 10.62.48.70
uenb 10.62.48.70
s6a hss <--> mme 127.0.0.1
#---------------------
Licence info
#---------------------
The source code is mainly written under the Apache V2.0 License (http://www.apache.org/licenses/LICENSE-2.0).
The text for Apache V2.0 License is also available under LICENSE file in the same directory.
For more details on third party software, please read the NOTICE file in the same directory.
#---------------------
Linux
#---------------------
The Openair-cn code actually is written, executed, and tested on UBUNTU
desktop 14.04 64 bits.
Actually the S-GW network element requires a linux kernel version 3.19 (for tag <= v0.3.2).
Actually the S-GW network element requires a linux kernel version >= 4.7.x (for tag >= v0.4.0).
#---------------------
Collaborative work
#---------------------
This source code is managed through a GITLAB, a collaborative development
platform, URL: https://gitlab.eurecom.fr/oai/openair-cn
#---------------------
Contributions request
#---------------------
In a general way, anybody who is willing can contribute on any part of the
code in any network component. Contributions can be simple bugfixes, advices
and remarks on the design, architecture, coding/implementation, are can can
size up to a project collaboration.
There are large areas where help is needed, and some more specifics:
# By order of decreasing priority level:
- Development of test tools: eNB(s) emulator on S1 interface.
- Enhance the implementation of the HSS, many things are missing there.
- Re-implement a GTPv1-U framework in S-GW using a 'zero-copy' framework.
- Enhance the NAS layer with compliant TAU and SR procedures, implement
the handling of dedicated bearers in NAS and S/P-GW.
- Propagate the use of ITTI inside the NAS for exchanges between EMM and
ESM.
- Improve the design and implementation of the InTer-Task-Interface
middleware, a message passing software.
- Enhance the S1AP MME application with the handling of new messages.
- Help documenting, cleaning and harmonizing the source code.
#---------------------
How to contribute
#---------------------
Here are the important steps for reporting a bug/contributing to the
Openair-cn software:
Read the OpenAirInterfaceTM (OAI) Licensing Model and sign the Individual
Contributor License Agreement(s) (iCLA). Please make sure you are
authorized to work on OAI from your current employer. You still need to sign
the iCLA even if your employer is a member corporation of the alliance. The
above two licenses must be signed before your commits are included in the
main repository.
Create account on Gitlab and send an email to openair_tech (at) eurecom
(dot) fr to be added to the repository.
If you wish to contribute to the OAI documentation on Gilab wiki, then
please email to openair_tech (at) eurecom (dot) fr to sign the licence
agreement and request for account access on Gilab wiki.
Follow the coding/Gitlab branching guidelines here.
Work closely with the OAI community to ensure periodic review takes place
with them so you code can be merged to the main repository.
Use Gitlab for collaborative development, bug fixing, feature requests, etc.