https://github.com/opennetworkinglab/aether-srsran
srsRAN Blueprint for Aether OnRamp
https://github.com/opennetworkinglab/aether-srsran
Last synced: 7 months ago
JSON representation
srsRAN Blueprint for Aether OnRamp
- Host: GitHub
- URL: https://github.com/opennetworkinglab/aether-srsran
- Owner: opennetworkinglab
- License: apache-2.0
- Created: 2024-10-17T16:32:51.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-15T00:54:55.000Z (over 1 year ago)
- Last Synced: 2025-02-15T01:27:44.913Z (over 1 year ago)
- Language: Makefile
- Size: 26.4 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# srsRAN gNB
The `aether-srsran` repository allows srsRAN (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-srsran' repository, use the following command:
```
git clone https://github.com/opennetworkinglab/aether-srsran.git
```
## Step-by-Step Installation
To install srsRAN-gNB, follow these steps:
1. Install Docker by running `make srsran-docker-install`.
Note: If docker already installed then ignore this step
2. Configure the network for srsRAN-gNB:
- Set the "data_iface" parameter to the network interface name of the machine which runs gNB.
- 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 `srsran-router-install` to create the network.
- To remove the network, run `srsran-router-uninstall`.
3. Start the srsRAN-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 srsran-gnb-install`.
- To stop the gNB, run `make srsran-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 srsran-uesim-start`.
- To stop the UE simulation, run `make srsran-uesim-stop`.
5. Run additional tests (ping):
- Enter the UE Docker container using `docker exec -it rfsim5g-srsran-nr-ue bash`.
- Use `ip netns exec ue1 ping -c 5 192.168.250.1` to view the success result.
### One-Step Installation
To install srsRAN gNB in one go, run `make aether-srsran-gnb-install`.
### Uninstall
To uninstall srsRAN gNB, run `make aether-srsran-gnb-uninstall`.