Changes between Version 1 and Version 2 of Tutorials/Wireless/Education Toolkit


Ignore:
Timestamp:
Sep 22, 2020, 5:28:57 AM (4 years ago)
Author:
skrimpon
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/Wireless/Education Toolkit

    v1 v2  
    1717For more information about the 'COSMOS Education Toolkit' and the teacher's professional development program, please read:
    1818
    19 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''
    20 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://wimnet.ee.columbia.edu/wp-content/uploads/2020/05/COSMOS_Education_ASEE2020.pdf (Download)][https://wimnet.ee.columbia.edu/wp-content/uploads/2020/07/ASEE_2020_COSMOS_PD.pdf (Presentation)] [https://peer.asee.org/34073 (ASEE)]
     191. 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
     202. D. Raychaudhuri, I. Seskar, G. Zussman, T. Korakis, D. Kilper, T. Chen, J. Kolodziejski, M. Sherman, Z. Kostic, X. Gu, H. Krishnaswamy, S. Maheshwari, P. Skrimponis, and C. Gutterman, “Challenge: COSMOS: A city-scale programmable testbed for experimentation with advanced wireless,” in Proc. ACM MOBICOM’20 (to appear), 2020." ​[https://wimnet.ee.columbia.edu/wp-content/uploads/2020/02/MobiCom2020_COSMOS.pdf (Download)] https://doi.org/10.1145/3372224.3380891
     213. 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://wimnet.ee.columbia.edu/wp-content/uploads/2020/05/COSMOS_Education_ASEE2020.pdf (Download)] [https://wimnet.ee.columbia.edu/wp-content/uploads/2020/07/ASEE_2020_COSMOS_PD.pdf (Presentation)] [https://peer.asee.org/34073 (ASEE)]
    2122
    22 Please email Panagiotis (ps3857[at]nyu.edu) if you have any questions or you are interested to use the 'COSMOS Education Toolkit' in your class. In case you use these experiments in your class please cite the above papers.
     23Please email Panagiotis if you have any questions or you are interested to use the 'COSMOS Education Toolkit' in your class. In case you use these experiments in your class please cite the above papers.
    2324
    2425== COSMOS SandBox1 ==
    25 The SDR experiments of the 'COSMOS Education Toolkit' have been evaluated in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 sandbox 1] using the outdoor sub-6 GHz deployment. In this tutorial we will use a large {{{s1.lg1}}} and a medium node {{{md1}}} of the 'Main Rooftop SDR Deployment'. Both of the nodes are equiped with a USRP Krypton 2974 via PCI-e.
     26The SDR experiments of the 'COSMOS Education Toolkit' have been evaluated in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 sandbox 1] using the outdoor sub-6 GHz deployment. In this tutorial we will use a large `s1.lg1` and a medium node `md1` of the 'Main Rooftop SDR Deployment'. Both of the nodes are equiped with a USRP Krypton 2974 via PCI-e.
    2627
    2728[[Image(sb1-rooftop.png, 800px)]]
    2829
    2930=== Node Setup ===
    30 Follow the steps below to gain access to the [wiki:Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate images.
    31  1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
    32  1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1
    33  1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with one SSH session.
    34  1. Make sure all the nodes and devices of this reservation are turned off:
     31Follow the steps below to gain access to the [wiki:Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate image.
     321. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
     331. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1
     341. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console `console.sb1.cosmos-lab.org` using SSH.
     351. Power off all the nodes and devices of sb1.
    3536{{{#!shell
    3637omf tell -a offh -t system:topo:allres
    3738}}}
    38  1. The image education-toolkit.ndz is [https://wiki.cosmos-lab.org/wiki/UserGuide/DiskImages#BaselineGnuRadio baseline_gr.ndz] with the COSMOS educational framework, and the K--12 educational labs and with their lesson plans. Load education-toolkit.ndz on sdr2-s1-lg1,sdr2-md1.
     391. Load the {{{education-toolkit.ndz}}} on `sdr2-s1-lg1` and `sdr2-md1`.
    3940{{{#!shell
    4041omf load -i education-toolkit.ndz -t sdr2-s1-lg1,sdr2-md1
    4142}}}
    42  1. Turn all the required resources on and check the status
     431. Power on `sdr2-s1-lg1` and `sdr2-md1`.
    4344{{{#!shell
    4445omf tell -a on -t sdr2-s1-lg1,sdr2-md1
    4546}}}
    46  1. Check that the nodes are turned on
     471. Check the status of the nodes and devices of sb1. Verify that `sdr2-s1-lg1` and `sdr2-md1` are on.
    4748{{{#!shell
    4849omf stat -t system:topo:allres
    4950}}}
     51
     52=== Experiment Setup ===
     53To run the experiments we have developed a user-friendly web interface based on HTML and CSS, and back-end web-server developed in python that will control and orchestrate the experiments.
     54
     55We wan to communicate between the host machine and the remote testbed nodes in a similar way as we do in the 'COSMOS Education Toolkit'. The solution is to use port forwarding.
     56
     57{{{#!th colspan=3 rowspan=1
     58sdr2-s1-lg1
     59}}}
     60|----------------
     61||= Description =||= Remote Port =||= Local Port =||
     62|| Front-end web interface ||  80  ||  8081  ||
     63|| Back-end web server ||  8090  ||  8091  ||
     64|| Audio TCP server ||  8100  ||  8101  ||
     65[[BR]]
     66{{{#!th colspan=3 rowspan=1
     67sdr2-md1
     68}}}
     69|----------------
     70||= Description =||= Remote Port =||= Local Port =||
     71|| Front-end web interface ||  80  ||  8082  ||
     72|| Back-end web server ||  8090  ||  8092  ||
     73|| Audio TCP server ||  8100  ||  8102  ||
     74
     75`Port:80` is used for visualizing the web interface and start all the lessons and labs. `Port:8090` is used to communicate with the back-end server. Both of these ports are essential for all the lessons and labs. Some labs require the use of a speaker so you can listen to the incoming audio signal from the SDRs. For this reason we create a TCP socket at `Port:8100` of the remote node that will stream the audio to the host. For the host we create a simple python file that can be used to connect to the TCP server and listen to the music. All the GNU Radio experiments require the use of a GUI. For this reason, when you are connecting to sb1 and the node you should use either the -X or -Y option. This will forward the X11 Server from the remote node to the local host.
     76
     771. Open a new terminal and enable port and X11 forwarding from `sdr2-s1-lg1`
     78{{{#!shell-session
     79not_a_user@laptop:~$ ssh -Y your_username@console.sb1.cosmos-lab.org -L 8081:sdr2-s1-lg1:80 -L 8091:sdr2-s1-lg1:8090 -L 8101:sdr2-s1-lg1:8100
     80your_username@console:~$ ssh -Y root@sdr2-s1-lg1
     81}}}
     821. Open a new terminal and enable port and X11 forwarding from `sdr2-md1`
     83{{{#!shell-session
     84not_a_user@laptop:~$ ssh -Y your_username@console.sb1.cosmos-lab.org -L 8082:sdr2-md1:80 -L 8092:sdr2-md1:8090 -L 8102:sdr2-md1:8100
     85your_username@console:~$ ssh -Y root@sdr2-md1
     86}}}
     87
     88Both of the terminal sessions need to remain open. After setting up the nodes, we can now start exploring the COSMOS K--12 STEM educational labs. To connect to the web interface of `sdr2-s1-lg1` press [https://localhost:8081], and to connect to the web interface of sdr2-md1 press [https://localhost:8082].
     89
     90=== Experiment Execution ===
     91 * [wiki:./EducationToolkit/8-am-fm-modulation AM/FM Modulation]