This wiki page contains tutorials for open-access remotely-accessible STEM experiments for K--12 Education in the COSMOS testbed.

Authors:
* Panagiotis Skrimponis, New York University: ps3857[at]nyu.edu
* Nikos Makris, New York University
* Virgilios Passas, New York University

Last updated: September 8, 2020

== COSMOS Education Toolkit in COSMOS SandBox1 ==

=== Description ===
In this tutorial, we will use a large node (s1.lg1) and a medium node (md1) of the 'Main Rooftop SDR Deployment' in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 sandbox 1]. More specifically we will use the sdr2-s1-lg1 and sdr2-md1 nodes. These nodes have a USRP Krypton 2974 connected via PCI-e

=== Publications ===
For more information about the integration of the FDE-based FD transceivers in COSMOS, please read:

1. ''Panagiotis Skrimponis, Nikos Makris, Sheila Borges Rajguru, Karen Cheng, Jonatan Ostromertzky, Emily Ford, Zoran Kostic, Gil Zussman, and Thanasis Korakis, “COSMOS Education Toolkit,” in Proc. ACM SIGCOMM Computer and Communication Review (to appear), Oct. 2020''
2. ''Panagiotis Skrimponis, Nikos Makris, Karen Cheng, Jonatan Ostromertzky, Zoran Kostic, Gil Zussman, Thanasis Korakis, and Sheila Borges Rajguru, “A Teacher Professional Development Program Using Wireless Communications and NGSS to Enhance STEM Teaching and Learning,” in Proc. 2020 ASEE Virtual Annual Conference Content Access, Jul. 2020'' [https://peer.asee.org/34073 (Download)]

Please cite the above papers if you use the hardware. Please email Panagiotis Skrimponis (ps3857[at]columbia.edu) if you use (or plan to use) the 'COSMOS Education Toolkit' experiments or if you have any questions.

=== Tutorial Set-Up ===
Follow the steps below to gain access to the [wiki:Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate images. 
 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
 1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1
 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with one SSH session. 
 1. Make sure all the nodes and devices of this reservation are turned off:
{{{#!shell
omf tell -a offh -t system:topo:allres
}}}
 1. The image education-toolkit.ndz is [baseline_gr.ndz] with the COSMOS education web framework, and the K--12 educational labs and lesson plans. Load education-toolkit.ndz on sdr2-s1-lg1,sdr2-md1.  
{{{#!shell
omf load -i education-toolkit.ndz -t sdr2-s1-lg1,sdr2-md1
}}}
 1. Turn all the required resources on and check the status
{{{#!shell
omf tell -a on -t sdr2-s1-lg1,sdr2-md1
}}}
 1. Check that the nodes are turned on
{{{#!shell
omf stat -t system:topo:allres
}}}

=== Experiment Execution ===
After setting up the nodes, we can now start exploring the K--12 wireless labs. To run the experiments we use a web friently interface

To execute the experiment and use the web framework you need to connect to the cosmos-sb1 and enable
the HTTP port forwarding by using the following command:
{{{#!shell-session
not_a_user@laptop:~$ ssh -Y your_username@console.sb1.cosmos-lab.org 8080:sdr2-s1-lg1:80 8090:sdr2-s1-lg1:8090 8100:sdr2-s1-lg1:8100
your_username@console:~$ ssh -Y root@sdr2-s1-lg1 
}}}

Now in you need to open a new ssh session in order to enable the HTTP forwarding for the sdr2-md1

{{{#!shell-session
not_a_user@laptop:~$ ssh -Y your_username@console.sb1.cosmos-lab.org 8082:sdr2-s1-lg1:80 8092:sdr2-s1-lg1:8090 8102:sdr2-s1-lg1:8100
your_username@console:~$ ssh -Y root@sdr2-md1
}}}