| 1 | | = COSMOS Education Toolkit = |
| 2 | | This wiki page contains tutorials for open-access remotely-accessible science, technology, engineering and mathematics (STEM) experiments for K--12 Education in the COSMOS testbed. |
| 3 | | |
| 4 | | Authors: |
| 5 | | * Panagiotis Skrimponis, New York University: ps3857[at]nyu.edu |
| 6 | | * Nikos Makris, New York University |
| 7 | | |
| 8 | | Last updated: September 22, 2020 |
| 9 | | |
| 10 | | == Description == |
| 11 | | |
| 12 | | == Publications == |
| 13 | | For more information about the 'COSMOS Education Toolkit' and the teacher's professional development program, please read: |
| 14 | | |
| 15 | | 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'' |
| 16 | | 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 (Paper)] |
| 17 | | |
| 18 | | Please email Panagiotis (ps3857[at]nyu.edu) if you have any questions or you are interested to use the experiments or the 'COSMOS Education Toolkit' in your class. If you use them in your class please cite the above papers. |
| 19 | | |
| 20 | | == K--12 STEM Experiments using COSMOS SandBox1 == |
| 21 | | |
| 22 | | === Tutorial Description === |
| 23 | | 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. |
| 24 | | |
| 25 | | [[Image(sb1-rooftop.png, 800px)]] |
| 26 | | |
| 27 | | |
| 28 | | === Tutorial Set-Up === |
| 29 | | ==== Node Set-up ==== |
| 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: |
| 35 | | {{{#!shell |
| 36 | | omf tell -a offh -t system:topo:allres |
| 37 | | }}} |
| 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. |
| 39 | | {{{#!shell |
| 40 | | omf load -i education-toolkit.ndz -t sdr2-s1-lg1,sdr2-md1 |
| 41 | | }}} |
| 42 | | 1. Turn all the required resources on and check the status |
| 43 | | {{{#!shell |
| 44 | | omf tell -a on -t sdr2-s1-lg1,sdr2-md1 |
| 45 | | }}} |
| 46 | | 1. Check that the nodes are turned on |
| 47 | | {{{#!shell |
| 48 | | omf stat -t system:topo:allres |
| 49 | | }}} |
| 50 | | |
| 51 | | ==== Experiment Set-Up ==== |
| 52 | | |
| 53 | | To 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 | | |
| 55 | | To visualize the front-end web interface we need to forward the port 80 of the remote node to the local host. For the sdr2-s1-lg1 we will use port 8081, while for the sdr2-md1 we will use the 8082. To communicate with the back-end server we need to forward the port 8090 of the remote node to the local host. For the sdr2-s1-lg1 we will use port 8091, while for the sdr2-md1 we will use the 8092. Some of the experiments require to use audio at the transmitter or the receiver, for this purpose we create a TCP socket at port 8100 of the remote node. To forward port 8100 we will use port 8101 for the sdr2-s1-lg1, and port 8102 for sdr2-md1. At the host computer we developed a very simple python program that is attached at the bottom of the page. The program connects to the server that is running at the remote node, and outputs the received data to the local audio card. |
| 56 | | |
| 57 | | Almost all the GNU Radio experiments require the use of a QT 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 X-Server from the remote node to the local node. |
| 58 | | |
| 59 | | In order to to enable the port and X-Server forwarding for the sdr2-s1-lg1 you need to open a new terminal and execute the following commands: |
| 60 | | {{{#!shell-session |
| 61 | | not_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 |
| 62 | | your_username@console:~$ ssh -Y root@sdr2-s1-lg1 |
| 63 | | }}} |
| 64 | | |
| 65 | | In order to to enable the port and X-Server forwarding for the sdr2-md1 you need to open a new terminal and execute the following commands: |
| 66 | | {{{#!shell-session |
| 67 | | not_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 |
| 68 | | your_username@console:~$ ssh -Y root@sdr2-md1 |
| 69 | | }}} |
| 70 | | |
| 71 | | 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 the following link [https://localhost:8081], and to connect to the web interface of sdr2-md1 press the following link [https://localhost:8082] |
| 72 | | |
| 73 | | === Experiment Execution === |
| 74 | | First, you need open the web interface of either node. Let's open [https://localhost:8081]. If you did all the above steps correctly you should be able to see the following, |
| 75 | | |
| 76 | | [[Image(toolkit-main.png, 500px)]] |
| 77 | | |
| 78 | | Then, navigate on the topic you would like to learn (Mathematics, Science or Computer Science) by pressing the appropriate button. Let's select the science lessons. Then, you need to select grade. Let's select grade 8. You should be able to see the following, |
| 79 | | |
| 80 | | [[Image(cosmos-science-8.png, 500px)]] |
| 81 | | |
| 82 | | While all the experiments are available on the 'COSMOS Education Toolkit' right now only some of them are available on COSMOS testbed. The lessons that can be executed on testbed will have an indication on the top right corner. |
| 83 | | |
| 84 | | ==== AM/FM Modulation ==== |
