Skip to content

Commit 41fccbc

Browse files
Merge pull request #28 from microsoft/matt/25.04_features
Add Significant Commits / Features
2 parents bdc858c + fda12c0 commit 41fccbc

1 file changed

Lines changed: 40 additions & 25 deletions

File tree

README.md

Lines changed: 40 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,70 @@
11
- [1. Introduction](#1-introduction)
2-
- [2. Getting Started](#2-getting-started)
3-
- [2.1. Prerequisites](#21-prerequisites)
4-
- [2.2. Preparing the Environment](#22-preparing-the-environment)
5-
- [2.2.1. Initialize submodules:](#221-initialize-submodules)
6-
- [2.2.2. Set required environment variables:](#222-set-required-environment-variables)
7-
- [2.2.3. There are two ways to start the srsRAN deployment:](#223-there-are-two-ways-to-start-the-srsran-deployment)
8-
- [2.2.4. Start the srsRAN](#224-start-the-srsran)
9-
- [2.2.4.1. Deploy RAN without jrtc:](#2241-deploy-ran-without-jrtc)
10-
- [2.2.4.2. Deploy RAN with jrtc:](#2242-deploy-ran-with-jrtc)
11-
- [2.3. Running the Examples](#23-running-the-examples)
12-
- [3. Hooks](#3-hooks)
13-
- [4. License](#4-license)
2+
- [2. Significant Commits / Features](#2-significant-commits--features)
3+
- [3. Getting Started](#3-getting-started)
4+
- [3.1. Prerequisites](#31-prerequisites)
5+
- [3.2. Preparing the Environment](#32-preparing-the-environment)
6+
- [3.2.1. Initialize submodules:](#321-initialize-submodules)
7+
- [3.2.2. Set required environment variables:](#322-set-required-environment-variables)
8+
- [3.2.3. There are two ways to start the srsRAN deployment:](#323-there-are-two-ways-to-start-the-srsran-deployment)
9+
- [3.2.4. Start the srsRAN](#324-start-the-srsran)
10+
- [3.2.4.1. Deploy RAN without jrtc:](#3241-deploy-ran-without-jrtc)
11+
- [3.2.4.2. Deploy RAN with jrtc:](#3242-deploy-ran-with-jrtc)
12+
- [3.3. Running the Examples](#33-running-the-examples)
13+
- [4. Hooks and Codelets](#4-hooks-and-codelets)
14+
- [5. Frequently Asked Questions](#5-frequently-asked-questions)
15+
- [6. License](#6-license)
1416

1517

1618
# 1. Introduction
1719

1820
This project provides a collection of sample applications for instrumenting **srsRAN** using the
1921
[jbpf](https://github.com/microsoft/jbpf) and [jrt-controller](https://github.com/microsoft/jrt-controller) frameworks.
2022

21-
# 2. Getting Started
23+
# 2. Significant Commits / Features
24+
25+
[Sep 10, 2025, commit bdc858c](https://github.com/microsoft/jrtc-apps/commit/bdc858c2f27f4d903f6466406f7514faf677d364) - srsRAN v25.04 support
26+
27+
- Upgrade Jrtc to srsRAN v25.04
28+
- Updates to flags required for building srsRAN images.
29+
- Updates to numerous [codelets](./codelets) to align with latest srsRAN header files.
30+
- Improvements to [Dashboard](./jrtc_apps/dashboard/).
31+
32+
[Aug 8, 2025, commit 0176d4c](https://github.com/microsoft/jrtc-apps/commit/0176d4cafdbc491f3948b6cb2a31864e5518b604) - Dashboard visualisations
33+
34+
- Final update to Dashboard visualisation (Azure Log Analytics) for srsRAN v23.04
35+
36+
# 3. Getting Started
2237

2338
The simplest way to get started is by using Kubernetes. This is the default installation method and helps eliminate any dependency-related issues.
2439
However, we also support bare-metal installations.
2540
For bare-metal setup instructions, please follow [these instructions](docs/baremetal.md)
2641

27-
## 2.1. Prerequisites
42+
## 3.1. Prerequisites
2843

2944
Before starting, ensure that **Kubernetes** and **Helm** are installed and configured.
3045
If you are not an expert in Kubernetes, you can try one of the simple, single-node setups, such as [k3d](https://k3s.io/).
3146
This guide assumes **srsRAN** will be deployed using **Helm**.
3247

33-
## 2.2. Preparing the Environment
48+
## 3.2. Preparing the Environment
3449

35-
### 2.2.1. Initialize submodules:
50+
### 3.2.1. Initialize submodules:
3651

3752
```bash
3853
cd ~/jbpf_apps
3954
./init_submodules.sh
4055
```
4156

42-
### 2.2.2. Set required environment variables:
57+
### 3.2.2. Set required environment variables:
4358

4459
```bash
4560
source set_vars.sh
4661
```
4762

48-
### 2.2.3. There are two ways to start the srsRAN deployment:
63+
### 3.2.3. There are two ways to start the srsRAN deployment:
4964
- with JRTC - this will create two pods, one for srsRAN, and one for JRTC. The JRTC pod has two containers; one for the *jrt-controller* and one running the *jrt-decoder*.
5065
- without JRTC - This will just create a single pod, for srsRAN.
5166

52-
### 2.2.4. Start the srsRAN
67+
### 3.2.4. Start the srsRAN
5368

5469
Move to the ***jrtc-apps/containers/Helm*** directory and make sure that parameters related to local setup, such as Core IP, RRH, Local MAC Address, and VLAN ID are correctly configured.
5570
These parameters are supplied from the Helm chart `values.yaml` (the default values are [here](./containers/Helm/values.yaml)).
@@ -81,7 +96,7 @@ The easiest way to configure parameters related to local setup is to supply them
8196
Once the parameters are configured correctly we can deploy srsRAN
8297

8398

84-
#### 2.2.4.1. Deploy RAN without jrtc:
99+
#### 3.2.4.1. Deploy RAN without jrtc:
85100

86101
```
87102
./install.sh -h . -f config.yaml
@@ -96,7 +111,7 @@ The easiest way to configure parameters related to local setup is to supply them
96111
srs-gnb-du1-0 3/3 Running 0 11s
97112
```
98113

99-
#### 2.2.4.2. Deploy RAN with jrtc:
114+
#### 3.2.4.2. Deploy RAN with jrtc:
100115

101116
```
102117
cd ~/jrtc-apps/containers/Helm
@@ -115,7 +130,7 @@ The easiest way to configure parameters related to local setup is to supply them
115130

116131
---
117132

118-
## 2.3. Running the Examples
133+
## 3.3. Running the Examples
119134

120135
This project includes two examples:
121136

@@ -131,20 +146,20 @@ This project includes two examples:
131146

132147
---
133148

134-
# 3. Hooks and Codelets
149+
# 4. Hooks and Codelets
135150

136151
The available Jbpf hooks are described [here](./docs/srsran_hooks.md). Some of the codelets are documented [here](./docs/codelets.md).
137152

138153

139-
# 4. Frequently Asked Questions
154+
# 5. Frequently Asked Questions
140155

141156
**Q:** Can codelets and apps be loaded from a different server or even a different folder?
142157

143158
**A:** No. At the moment, the [install.sh](./containers/Helm/install.sh) of the Helm chart maps local volumes `codelets_vol_mount` and `codelets_vol_mount` into the srsRAN and jrtc pods respectively, using a predefined folder structure. The loading process is triggered through REST but the apps and codelet source code and object files are loaded from the local volumes, not sent over REST. This is currently done for simplicity, but one can easily modify this design to fully support loading through REST API.
144159

145160

146161

147-
# 5. License
162+
# 6. License
148163

149164
This project is licensed under the [MIT License](LICENSE.md).
150165

0 commit comments

Comments
 (0)