Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
slapos
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
Steven Gueguen
slapos
Commits
cad76981
Commit
cad76981
authored
Jul 19, 2023
by
Joanne Hugé
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
software/ors-amarisoft: update README and changelog
parent
1efb2bce
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
35 additions
and
43 deletions
+35
-43
software/ors-amarisoft/README.md
software/ors-amarisoft/README.md
+27
-41
software/ors-amarisoft/changelog.rst
software/ors-amarisoft/changelog.rst
+8
-2
No files found.
software/ors-amarisoft/README.md
View file @
cad76981
...
@@ -2,51 +2,51 @@
...
@@ -2,51 +2,51 @@
How to deploy from scratch
How to deploy from scratch
1.
Compile and install kernel module lte_trx_sdr by
`# cd trx_sdr*/kernel/ && make && sh init.sh`
1.
Install Amarisoft binaries in /opt/amarisoft/v20XX-XX-XX with folders:
2.
Make sure to have "create_tun = True" in /etc/opt/slapos/slapos.cfg
*
enb: needs to containt libraries from trx_sdr
3.
Install ors playbook
*
trx_sdr
4.
Deploy this SR
*
mme
2.
Install ors playbook
3.
Deploy this SR
## Generated buildout configurations and json input schemas
## Generated buildout configurations and json input schemas
Since there are m
any
ors-amarisoft softwares releases and software types, the following files are
Since there are m
ultiple
ors-amarisoft softwares releases and software types, the following files are
generated with jinja2 templates with the render-templates script before being pushed to gitlab:
generated with jinja2 templates with the render-templates script before being pushed to gitlab:
*
instance-tdd1900-enb-input-schema.json
*
instance-tdd-enb-input-schema.json
*
instance-tdd1900-gnb-input-schema.json
*
instance-fdd-enb-input-schema.json
*
instance-tdd2600-enb-input-schema.json
*
software-fdd.cfg
*
instance-tdd2600-gnb-input-schema.json
*
software-tdd.cfg.json
*
instance-tdd3500-enb-input-schema.json
*
instance-fdd-ue-nr-input-schema.json
*
instance-tdd3500-gnb-input-schema.json
*
instance-tdd-gnb-input-schema.json
*
instance-tdd3700-enb-input-schema.json
*
instance-tdd-ue-nr-input-schema.json
*
instance-tdd3700-gnb-input-schema.json
*
test/testFDD.py
*
software-tdd1900.cfg
*
test/testTDD.py
*
software-tdd1900.cfg.json
*
software-tdd.cfg
*
software-tdd2600.cfg
*
instance-tdd-ue-lte-input-schema.json
*
software-tdd2600.cfg.json
*
instance-fdd-gnb-input-schema.json
*
software-tdd3500.cfg
*
software-fdd.cfg.json
*
software-tdd3500.cfg.json
*
instance-fdd-ue-lte-input-schema.json
*
software-tdd3700.cfg
*
software-tdd3700.cfg.json
These files should not be modified directly, and the render-templates scripts should be run along
These files should not be modified directly, and the render-templates scripts should be run along
with update-hash before each commit.
with update-hash before each commit.
## Services
## Services
instance.cfg is rather complicated because Amarisoft LTE stack consists of 4 binaries
We run 2 binaries from Amarisoft LTE stack:
*
**lteenb**
- eNodeB software is the server accepting connection from UI (user interfaces)
*
**lteenb**
- eNodeB software is the server accepting connection from UI (user interfaces)
*
**ltemme**
- Mobile Management Entity in other words core network which handles orchestration of
*
**ltemme**
- Mobile Management Entity in other words core network which handles orchestration of
eNodeBs in case UI switches from one to another
eNodeBs in case UI switches from one to another
*
**lteims**
- IP Multimedia System is another protocol such as LTE but designed for services over
IP. Please read http://www.differencebetween.com/difference-between-lte-and-vs-ims-2/
*
**ltembmsgw**
- Multimedia Broadcast Multicast Services (Gateway) is technology which broadcast
the same multimedia content into multiple IP addresses at once to save bandwidth.
Those binaries are started in foreground, originaly in screen. We don't want the binaries inside one
Those binaries are started in foreground, originaly in screen. We don't want the binaries inside one
screen because then we cannot easily control their resource usage. Thus we make
4
on-watch services.
screen because then we cannot easily control their resource usage. Thus we make
2
on-watch services.
### ENB / GNB
Is the eNodeB (4G) or gNodeB (5G). This binary handles the radio protocols and sends and receives
IQ samples to trx_sdr driver.
### MME
### MME
...
@@ -54,20 +54,6 @@ Is the core network. This binary keep track of UEs and to which eNodeB they are
...
@@ -54,20 +54,6 @@ Is the core network. This binary keep track of UEs and to which eNodeB they are
It reroutes traffic when UE switches between eNodeBs.
It reroutes traffic when UE switches between eNodeBs.
MME also serves as a service bus thus all services must register within MME.
MME also serves as a service bus thus all services must register within MME.
### IMS
Service connected into MME bus. IMS handles circuit-ish services over IP whereas LTE would have
failed because it is intended as data-over-IP service.
### MBMSGW
MBMS Gateway is a standalone component connected to BMSC (Broadcast Multicast Service Centre), server
supporting streaming content from providers, which is another component inside our core network not
provided by Amarisoft.
MBMS Gateway is connected to MME which then manages MBMS sessions.
## Gotchas!
## Gotchas!
**trx_sdr.so**
provided from archive MUST be placed next to
`lteenb`
binary. This library is the
**trx_sdr.so**
provided from archive MUST be placed next to
`lteenb`
binary. This library is the
...
...
software/ors-amarisoft/changelog.rst
View file @
cad76981
Changelog
Changelog
=========
=========
Version 1.0.3
XX (2023-06-XX
)
Version 1.0.3
30 (2023-07-19
)
-------------
-------------
* Change Slice Differentiator input parameter to hexadecimal representation
* Change Slice Differentiator input parameter to hexadecimal representation
* Add TDD Configurations with maximum uplink
* Add TDD Configurations with maximum uplink
* Modify reference power signal to improve radio link over long distances
* Modify reference power signal to improve radio link over long distances
* Add TAC parameter to eNB
* Add Tracking Area Code (TAC) parameter to eNB
* Publish useful values:
- Frequency and band
- Current TX and RX gain
- Estimated TX power in dB and W based on https://handbook.rapid.space/rapidspace-ORS.tx.gain
- ORS frequency range rating
- ORS version
Version 1.0.326 (2023-06-14)
Version 1.0.326 (2023-06-14)
-------------
-------------
...
...
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