[[Include(/WikiToC)]]

= Tutorials =

A number of tutorials are provided enabling users to quickly pick up various aspects of the COSMOS testbed. They are grouped based on functionality and are mostly focused on sandboxes in order to alleviate the pressure on the main testbed.  

== SDR and Wireless ==

COSMOS has multiple SDR devices deployed for experimenter use as listed [wiki:Hardware/sdr here]. Each [wiki:Hardware/Nodes node] consists of a combination of SDRs, sub 6GHz and mmWave RF front ends. This section provides tutorials for SDR usage on COSMOS, illustrating steps to access them, and providing node images, tools required to develop and conduct experiments. The main SDRs device usage is illustrated in the [wiki:./Wireless/BasicUsage basic wireless usage tutorial]. A number of more advanced tutorials include the tutorial on how to [wiki:./Wireless/MeasurementTool instrument your SDR experiment] with the [https://oml-doc.orbit-lab.org OML], while the [wiki:./Wireless/ChannelSoundingKrypton channel sounding tutorial] illustrates the use of custom FPGA code to improve the performance of the SDR platform. 
Also:

 * [wiki:./Wireless/Fosphor Spectrum visualization  with Fosphor]
 * [wiki:./Wireless/FullDuplex Full-duplex]
 * [wiki:./Wireless/mmwaveSB1 Basic mmWave (60 GHz) USRP based tutorial]
 * [wiki:./Wireless/mmwaveRFSoC Sivers IMA (60 GHz): RFSoC based tutorials]
 * [wiki:./Wireless/mmwave80211adORCA 802.11ad (60 GHz) preamble transmission and detection]
 * [wiki:./Wireless/mmwavePaamBasics IBM PAAMs (28 GHz): Basic operations and usage]
 * [wiki:./Wireless/mmwavePaamAgora IBM PAAMs (28 GHz): Integration with USRPs with MIMO capability]
 * [wiki:./Wireless/ChannelSoundingMIMO 2 x 2 MIMO channel sounding] 
 * [wiki:./Wireless/MassiveMIMO Massive MIMO channel sounding] 
 * [wiki:./Wireless/EducationToolkit K-12 STEM labs]

== Optical Networking ==

 * [wiki:./Optical/Tutorial1 Basic optical tutorial]
 * [wiki:./Optical/MininetOpticalTutorial1 Basic optical tutorial (Mininet-Optical software emulated version)]
 * [wiki:/Workshops/SigComm2022/OpticalTutorial Optical tutorial at ACM SIGCOMM 2022 (hardware)]
 * [wiki:/Workshops/SigComm2022/MininetOptical Optical tutorial at ACM SIGCOMM 2022 (Mininet-Optical software emulated version)]

== Wired Networking ==

To check COSMOS wired network performance one can use the [wiki:./Wired/network-performance iperf tutorial].

== Edge Computing ==

Use of [https://www.xilinx.com/products/boards-and-kits/alveo.html Alveo U200 FPGA platform], that is available in all COSMOS servers, is illustrated with the [wiki:./EdgeComputing/AlveoGettingStarted FPGA Getting Started tutorial]. 

Number of tutorials are related to virtualization including: [wiki:./EdgeComputing/ServiceMigration service migration in container environment]


== 4G/5G Systems ==

* Open source [wiki:./4G5G/openairinterface 4G SDR tutorial] based on [https://www.openairinterface.org/ OpenAirInterface (OAI) code] 
* Getting started with [https://https://www.interdigital.com/ Interdigital] [wiki:./4G5G/InterDigital-5G 5G-NR Performance system] tutorial
* Amarisoft 5GNR (SA) [https://wiki.cosmos-lab.org/wiki/Tutorials/4G5G/amarisoft SDR tutorial with USRP N310s]
* Amarisoft 5GNR (SA) [https://wiki.cosmos-lab.org/wiki/Tutorials/4G5G/amarisoftcotsue with COTS UEs] 

== Orchestration Platforms ==

The tutorials in this group can be used as a starting point for experimentation with the two major [https://en.wikipedia.org/wiki/Network_function_virtualization Network Functions Virtualization (NFV)] Management and Orchestration (MANO) platforms:

 * The [https://www.linuxfoundation.org/ Linux Foundation] [https://www.onap.org/ ONAP] project [wiki:./Cloud/ONAP tutorial]
 * The [https://osm.etsi.org/ Open Source MANO (OSM)] an [https://www.etsi.org/ ETSI] initiative [wiki:./Cloud/OSM tutorial]