https://github.com/opennetworkinglab/aether-oai
OAI RAN with Aether Core
https://github.com/opennetworkinglab/aether-oai
Last synced: 9 months ago
JSON representation
OAI RAN with Aether Core
- Host: GitHub
- URL: https://github.com/opennetworkinglab/aether-oai
- Owner: opennetworkinglab
- License: apache-2.0
- Created: 2024-07-24T18:04:35.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-02-14T21:10:55.000Z (over 1 year ago)
- Last Synced: 2025-02-14T22:21:08.213Z (over 1 year ago)
- Language: Makefile
- Size: 67.4 KB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OAI gNB
The `aether-oai` repository allows OAI RAN (both physical and simulated) to work with the Aether SD-Core using Docker.
It has been tested in simulation mode and with USRP X310 as the RAN hardware.
To download the 'aether-oai' repository, use the following command:
```
git clone https://github.com/opennetworkinglab/aether-oai.git
```
## Step-by-Step Installation
To install oai-gNB, follow these steps:
1. Install Docker by running `make oai-docker-install`.
2. Configure the network for oai-gNB:
- Set the "data_iface" parameter to the network interface name of the machine.
- Set "network.name" to the name of the Docker network to be created.
- Set "network.bridge.name" to the name of the interface to be created.
- Set "subnet", which should correspond to the "ran_subnet" of 5GC (SD-Core) or the machine's subnet.
- run `oai-router-install` to create the network.
- To remove the network, run `oai-router-remove`.
3. Start the OAI-gNB Docker containers:
- Set the container image "gnb_image" for gNB.
- Set "simulation" to true to run in simulation mode.
- Set "conf_file" path for corresponding conf file for gNB i.e., for simulation.
- Set "ip" for gNB container, it should in same subnet as network.
- Set "core.amf.ip" with IP address of Aether core.
- Start docker container using `make oai-gNb-install`.
- To stop the gNB, run `make oai-gNb-stop`.
4. Start the UE simulation:
- Set the container image "ue_image" for UeSimulation.
- Set "network" same as the network name used for gNB.
- Set "gnb.ip" with the IP address of the gNB container.
- Set "simulation" to true to run in simulation mode.
- Set "conf_file" path for corresponding conf file for UeSimulation.
- Run `make oai-uEsim-start`.
- To stop the UE simulation, run `make oai-uEsim-stop`.
5. Check the results:
- Enter the UE Docker container using `docker exec -it rfsim5g-oai-nr-ue bash`.
- Use `ping -I oaitun_ue1 google.com -c 2` to view the success result.
### One-Step Installation
To install OAI gNB in one go, run `make aether-oai-gNb-install`.
### Uninstall
To uninstall OAI gNB, run `make aether-oai-gNb-install`.