{"id":25495937,"url":"https://github.com/opennetworkinglab/aether-oai","last_synced_at":"2025-08-22T07:34:54.852Z","repository":{"id":250376224,"uuid":"833282270","full_name":"opennetworkinglab/aether-oai","owner":"opennetworkinglab","description":"OAI RAN with Aether Core","archived":false,"fork":false,"pushed_at":"2025-02-14T21:10:55.000Z","size":69,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-14T22:21:08.213Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opennetworkinglab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-24T18:04:35.000Z","updated_at":"2025-02-14T21:10:59.000Z","dependencies_parsed_at":"2024-12-30T21:32:24.144Z","dependency_job_id":"936e393a-80c4-4425-92a4-bdcd63eea154","html_url":"https://github.com/opennetworkinglab/aether-oai","commit_stats":null,"previous_names":["opennetworkinglab/aether-oai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Faether-oai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Faether-oai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Faether-oai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opennetworkinglab%2Faether-oai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opennetworkinglab","download_url":"https://codeload.github.com/opennetworkinglab/aether-oai/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239576797,"owners_count":19662113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-19T00:52:44.147Z","updated_at":"2025-02-19T00:52:44.982Z","avatar_url":"https://github.com/opennetworkinglab.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OAI gNB\n\nThe `aether-oai` repository allows OAI RAN (both physical and simulated) to work with the Aether SD-Core using Docker.\nIt has been tested in simulation mode and with USRP X310 as the RAN hardware.\n\nTo download the 'aether-oai' repository, use the following command:\n```\ngit clone https://github.com/opennetworkinglab/aether-oai.git\n```\n\n## Step-by-Step Installation\nTo install oai-gNB, follow these steps:\n\n1. Install Docker by running `make oai-docker-install`.\n2. Configure the network for oai-gNB:\n   - Set the \"data_iface\" parameter to the network interface name of the machine.\n   - Set \"network.name\" to the name of the Docker network to be created.\n   - Set \"network.bridge.name\" to the name of the interface to be created.\n   - Set \"subnet\", which should correspond to the \"ran_subnet\" of 5GC (SD-Core) or the machine's subnet.\n   - run `oai-router-install` to create the network.\n      - To remove the network, run `oai-router-remove`.\n3. Start the OAI-gNB Docker containers:\n   - Set the container image \"gnb_image\" for gNB.\n   - Set \"simulation\" to true to run in simulation mode.\n   - Set \"conf_file\" path for corresponding conf file for gNB i.e., for simulation.\n   - Set \"ip\" for gNB container, it should in same subnet as network.\n   - Set \"core.amf.ip\" with IP address of Aether core.\n   - Start docker container using `make oai-gNb-install`.\n      - To stop the gNB, run `make oai-gNb-stop`.\n4. Start the UE simulation:\n   - Set the container image \"ue_image\" for UeSimulation.\n   - Set \"network\" same as the network name used for gNB.\n   - Set \"gnb.ip\" with the IP address of the gNB container.\n   - Set \"simulation\" to true to run in simulation mode.\n   - Set \"conf_file\" path for corresponding conf file for UeSimulation.\n   - Run `make oai-uEsim-start`.\n      - To stop the UE simulation, run `make oai-uEsim-stop`.\n5. Check the results:\n   - Enter the UE Docker container using `docker exec -it rfsim5g-oai-nr-ue bash`.\n   - Use `ping -I oaitun_ue1 google.com -c 2` to view the success result.\n\n### One-Step Installation\nTo install OAI gNB in one go, run `make aether-oai-gNb-install`.\n\n### Uninstall\nTo uninstall OAI gNB, run `make aether-oai-gNb-install`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennetworkinglab%2Faether-oai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopennetworkinglab%2Faether-oai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopennetworkinglab%2Faether-oai/lists"}