ACW 2025 Tutorial Information

Internet Access

You need unrestricted Internet access from the laptop you will be accessing AERPAW from.

Please make sure to attach to the eduroam WiFi network if you have an eduroam profile set up on your computer at your home institution.

If you do not have eduroam, request a username and password from one of the tutorial coordinators, and then connect to the ncsu WiFi network.

Please do not use the guest WiFi since it does not provide the privileges required to run the tutorials.

If you have not already, go to https://go.ncsu.edu/acw25-tutorial to access this Tutorial Information document.

Self-guided, self-paced tutorial

The ACW tutorials are designed to be completely self-guided.  With the information provided to you through the AERPAW User Manual, you can traverse the tutorials entirely by yourself.  In fact, you do not need to be at ACW to do so.

The benefit of attending the tutorial sessions at ACW '25 is that you can get instant, personalized help from AERPAW personnel, standing by for that purpose, if any of the instructions or material in the User Manual is unclear, or if you face problems as you attempt to traverse the steps specified.

AERPAW User Manual

The User Manual is organized in pages or sections.  On the left of the User Manual there is a Navigation Bar with a menu. This menu allows you to visit any section and subsection in the User Manual.  This page itself is part of the User Manual, so you can access that menu from this page itself.

Custom Disposable Tutorial Environment

You can stop your traversal at any time, and come back to it later, during ACW '25.

However, please keep in mind that during the ACW '25 event, you will be using a completely equivalent but distinct parallel Virtual Environment than the Production AERPAW system for the tutorials.  Therefore, the User registrations, Experiments, and any custom code you develop during the tutorials will not persist after the conclusion of ACW '25; they will all be deleted.

If you want to save any custom code you have developed during the tutorials, please do so; the easiest way to do so is probably to cut and paste locally into your laptop.  (If you believe your code is too voluminous for that, but worth saving, please get in touch with a tutorial coordinator to explore possible alternate options.)

Install Software

For various tutorials, you will need to install various software on your laptop if you do not already have them installed.  You may do this up front, or as you come to them during the course of the tutorials.

In case you would like to install all the software beforehand, here is the list of necessary software:

1. OpenVPN (on Linux or Windows - for Linux make sure it is openvpn version 2), or Tunnelblick 8.0 (on MacOS).  (See Section 2 of AERPAW User Manual for instructions, if you need.)

2. Some application that lets you run Secure Shell (ssh) sessions - native on Linux, on Windows apps like MobaXTerm, PuttY, etc.

3. QGroundControl (See Section 2 of AERPAW User Manual for instructions).

4. MATLAB local install/license (or access to an institutional license server) - optional but highly desirable.

Preliminaries

Familiarize yourself with AERPAW by reading Section 1 of the AERPAW User Manual.

This overview video may be helpful to view.

Please pay special attention to Section 4.3, which reviews the complete workflow.

Please ask a tutorial coordinator if any part of the User Manual is unclear, or you encounter any difficulty with any of the steps, in this and all subsequent steps.

Using Custom Event Web Portal

Although the AERPAW User Manual provides a well-known URL for the AERPAW Web Portal, for the ACW '25 event we are using a custom Portal, so as to avoid potentially affecting in-production AERPAW experiments due to the tutorial activity.

Instead of the URL given in the User Manual, use the Portal at the following URL:

https://tutorial-portal.aerpaw.ncsu.edu/

User Registration, Role, Project

Follow the procedure provided in Section 4.7.1 to register yourself as an AERPAW User.

Follow the procedure provided in Section 4.7.2 to request the Experimenter Role.

This video may be helpful to view. (Note: Part of this video might be outdated since the portal was updated after this video was made)

Once the request is granted, follow the procedure provided in Section 4.7.3 to join the Project "ACW25 Tutorial Project". (Note: Do not create a project, just join the existing ACW25 Tutorial Project)

Create a Single Experiment

You will create an AERPAW "Experiment" that you will work with in Development Mode through the various tutorial sessions.  It is important that you create no more than a single experiment during ALL the tutorial sessions you attend.  DO NOT create more than one Experiment.  This single Experiment will allow you to explore all the various tutorials.

This will not only save you a lot of time and effort at each tutorial, but also the AERPAW substrate is likely to run short of resources if attendees create more than one Experiment each.

Follow the procedure provided in Section 4.7.4 to create an Experiment of your own.  In the step to choose Experiment Target Resources, choose the AFRN "LW1", and an APRN "LPN1".

This video may be helpful to view. (Note: Part of this video might be outdated since the portal was updated after this video was made)

Login to Your Virtual Experiment

Follow the procedure provided in Section 4.7.5 to access the virtual versions of your target AERPAW Nodes.

This video and this video may be helpful to view.

Hands-on Tutorial#1: GNU Radio Channel Sounding with AERPAW & AADM Challenge 

• GE2: Channel Sounder (Ozgur Ozdemir)

• AADM Sample Experiment 

• Cheat Sheet for the tutorial 

Hands-on Tutorial#2: 5G OAI IQ Collection and Post Processing

• OE2: 5G IQ Collection with OAI (Chase Ueltschey and Zehran Reshi)

Hands-on Tutorial#3: AERPAW LTE Flying Base Station

• E2E1: Single-UAV LTE eNB Serving Ground UEs Canonical Experiments (Chase Ueltschey and Zehran Reshi)

Additional information on AERPAW datasets can also be found at: https://aerpaw.org/experiments/datasets/