Changes between Version 48 and Version 49 of Tutorials/Wireless/mmwave Paam Real TimePHY

Timestamp:

Jun 14, 2026, 7:13:35 PM (8 days ago)

Author:

zhenzhou77

Comment:

Add Nexus (Mobi Com'26) to tutorial: update title and description; label existing Experiment Execution sections as Savannah; add Nexus Experiment Execution section (clone/build + Run with Emulated-RU).

Tutorials/Wireless/mmwave Paam Real TimePHY

@@ -1 +1 @@
 [[Include(WikiToC)]]
 
-= Savannah: Efficient mmWave Baseband Processing with Minimal and Heterogeneous Resources  =
+= Savannah & Nexus: Efficient and Scalable mmWave Baseband Processing with Minimal and Heterogeneous Resources  =
 
 === Description ===
-In this tutorial, we demonstrate Savannah, a framework for efficient mmWave baseband processing with minimal and heterogeneous resources. 
+In this tutorial, we demonstrate two frameworks for efficient mmWave baseband processing: '''Savannah''', a framework for efficient mmWave baseband processing with minimal and heterogeneous resources, and '''Nexus''', a framework for efficient and scalable multi-cell mmWave baseband processing with heterogeneous compute. 
 
 * The codebase, README and installation instructions for Savannah software can be found in attachments called {{{Savannah.zip}}} under [https://docs.renew-wireless.org/license/ RENEW license]. 
@@ -183 +183 @@
 
 
-=== Experiment Execution ===
+=== Experiment Execution: Savannah ===
 ==== General information ====
 **Notice** For every terminal you opened up, please run:
@@ -402 +402 @@
 }}}
 
-=== Experiment Execution - ACC100 DPDK BBDev ===
+=== Experiment Execution: Savannah - ACC100 DPDK BBDev ===
 ==== ACC100 Unittests ====
 **Notice**: COSMOS testbed currently does not have ACC100 card installed in the servers, but we provide unit test code and testcases for your reference if you have installed the card on your own system. 
@@ -416 +416 @@
 
 
+
+
+== Experiment Execution: Nexus ==
+
+[https://github.com/functions-lab/Nexus Nexus] extends this work to '''efficient and scalable multi-cell mmWave baseband processing with heterogeneous compute'''. Unlike the single-cell Savannah pipeline above, Nexus is able to process multiple cells concurrently on shared, heterogeneous compute resources.
+
+=== Download and Install Nexus ===
+
+The Nexus codebase is open-source and hosted on !GitHub. On the server ({{{srv1-lg1}}}), clone and build the repository:
+
+{{{
+git clone https://github.com/functions-lab/Nexus.git
+cd Nexus
+}}}
+
+Please follow the build/installation instructions in the repository's {{{README}}} to compile Nexus (it uses a CMake-based build similar to Savannah).
+
+Repository: [https://github.com/functions-lab/Nexus/tree/main https://github.com/functions-lab/Nexus/tree/main]
+
+=== Run with Emulated-RU ===
+
+The detailed, up-to-date execution flow is documented in the repository under the '''"Run with Emulated-RU"''' section. At a high level, you run the gNodeB (base station) in one terminal and the UE (sender) in another, passing one JSON config file per cell. Additional cells can be added by appending the corresponding JSON config files.
+
+In terminal 1, bring up the gNodeB (base station):
+
+{{{
+sudo LD_LIBRARY_PATH=${LD_LIBRARY_PATH} ./build/agora <Cell-1> <Cell-2> ... <Cell-N>
+}}}
+
+In terminal 2, bring up the UE (sender):
+
+{{{
+sudo LD_LIBRARY_PATH=${LD_LIBRARY_PATH} ./build/sender --num_threads=<X> --core_offset=<X> --enable_slow_start=1 <Cell-1> <Cell-2> ... <Cell-N>
+}}}
+
+For the full set of steps, configuration options, and the multi-cell setup, please refer to the '''"Run with Emulated-RU"''' section of the [https://github.com/functions-lab/Nexus/tree/main Nexus repository].