User Tools

Site Tools


from_gnuradio_to_cortxlab

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
from_gnuradio_to_cortxlab [2017/02/06 15:10] lcardosofrom_gnuradio_to_cortxlab [2018/01/29 14:31] (current) mimbert
Line 1: Line 1:
-# From an empty GNU Radio companion sheet to CorteXlab (Using USRPs) (Using USRPs)+# From A to Z: GNU Radio with CorteXlab using USRPs
  
 In the [[GNU Radio Benchmark example|first tutorial]] we introduced the way to construct a CorteXlab "task" given a ready-made GNU Radio script.  In the [[GNU Radio Benchmark example|first tutorial]] we introduced the way to construct a CorteXlab "task" given a ready-made GNU Radio script. 
  
-This tutorial goes one step deeper, going through the process of executing an experiment on CorteXlab starting from an empty GNU Radio project on your computer.+This tutorial goes one step deeper, through the process of running an experiment on CorteXlab starting from an empty GNU Radio project on your computer.
  
-For practical purposes, we will use a GNU Radio example instead of starting from a clean sheet, but you will use the same procedure when you'll you want to run your own project on CorteXlab.+For practical purposes, we will use a readily available GNU Radio example instead of starting from a clean sheet, but this will introduce the same procedure you'll use when you want to run your own project on CorteXlab.
  
 ##Setup ##Setup
Line 11: Line 11:
 The purpose of this tutorial is to execute an OFDM transmission between two USRP nodes. One node will be the transmitter and the other one will be the receiver. Instead of starting from an empty project, we are going to use the GNU Radio examples for an OFDM transmitter and receiver. The purpose of this tutorial is to execute an OFDM transmission between two USRP nodes. One node will be the transmitter and the other one will be the receiver. Instead of starting from an empty project, we are going to use the GNU Radio examples for an OFDM transmitter and receiver.
  
-Let us start by copying the files ''tx\_ofdm.grc'' and ''rx\_ofdm.grc'' located in ''$path\_to\_gnuradio/examples/digital/ofdm'' to a new folder of your choice. This folder will be your task folder.+Let us start by copying the files ''tx\_ofdm.grc'' and ''rx\_ofdm.grc'' located in ''<path\_to\_gnuradio>/examples/digital/ofdm'' to a new folder of your choice. This folder will be your task folder. //(Important note: <path\_to\_gnuradio> varies depending upon the way you are using GNURadio: If you have installed GNURadio on your workstation, you know where you choose to install it. If using the GNURadio instance which is part of CorteXlab toolchain on airlock, then the exact location is: ''/cortexlab/toolchains/current/share/gnuradio/examples/digital/ofdm/''
 +//
  
 As you can guess ''tx\_ofdm.grc'' will be used for the OFDM transmitter and ''rx\_ofdm.grc'' for the OFDM receiver. As you can guess ''tx\_ofdm.grc'' will be used for the OFDM transmitter and ''rx\_ofdm.grc'' for the OFDM receiver.
Line 68: Line 69:
 ## Create the scenario ## Create the scenario
  
-The experiment description file called `scenario.desc` will be looked for and read by the experiment scheduler to get which nodes and what software will be used during the experiment. It also gives the necessary startup scripts and parameters that the user provides for his experiment.+The experiment description file called `scenario.yaml` will be looked for and read by the experiment scheduler to get which nodes and what software will be used during the experiment. It also gives the necessary startup scripts and parameters that the user provides for his experiment.
  
-Here is a simple example of a `scenario.desc` file:+Here is a simple example of a `scenario.yaml` file:
 <code> <code>
 # Example scenario description file # Example scenario description file
Line 79: Line 80:
 # Scenario textual description # Scenario textual description
 #   simple string (a one liner) #   simple string (a one liner)
-desc OFDM tx-rx example scenario for CorteXlab+description: OFDM tx-rx example scenario for CorteXlab
  
 # Experiment maximum duration # Experiment maximum duration
 #   Time after which the experiment is forced to stop #   Time after which the experiment is forced to stop
-#   integer (minutes+#   integer (seconds
-durat 2+duration: 60
  
 # Node list # Node list
Line 90: Line 91:
 #   format: #   format:
 # #
-#   (machine): +#   nodes: 
-  entry (entry point script relative to the task root+#     (machine): 
-#   exit (exit point script relative to the task root. Use "none" for none)+      command: (entry point script relative to the task root)
  
-node4: +nodes: 
-   entry rx_ofdm.py +  node4: 
-   params dummy-but-needed +    command: ./rx_ofdm.py 
- +    passive: true 
-node6: +  node6: 
-   entry tx_ofdm.py +    command: ./tx_ofdm.py
-   params dummy-but-needed+
 </code> </code>
  
-This file uses its own syntax and is self-documented. Here the params line is mandatory even if it is not used (This will be changed in a future version). Adapt this example to suit your needs.+This file uses the yaml syntax and is self-documented. Adapt this example to suit your needs.
  
  
Line 114: Line 114:
 │   ├── tx_ofdm.py │   ├── tx_ofdm.py
 │   ├── rx_ofdm.py │   ├── rx_ofdm.py
-│   ├── scenario.desc+│   ├── scenario.yaml
 │   ├── tx_ofdm.grc │   ├── tx_ofdm.grc
 │   └── rx_ofdm.grc │   └── rx_ofdm.grc
Line 177: Line 177:
 <code> <code>
 you@srvairlock:~$ minus testbed status you@srvairlock:~$ minus testbed status
-Testbed status+num total tasks  2540 
-ID count so far6 +num tasks waiting0 
-Number of awaiting jobs: 0 +num tasks running: 0 
-ID of the running jobNone (None means server is idle)+tasks currently running: 
 +  (none)
 </code> </code>
  
Line 208: Line 209:
 you@srvairlock:~/results/task_15$ cd node4 you@srvairlock:~/results/task_15$ cd node4
 you@srvairlock:~/results/task_15/node4$ ls you@srvairlock:~/results/task_15/node4$ ls
-rx_ofdm.grc  scenario.desc  stdout.txt   tx_ofdm.py+rx_ofdm.grc  scenario.yaml  stdout.txt   tx_ofdm.py
 rx_ofdm.py   stderr.txt     tx_ofdm.grc rx_ofdm.py   stderr.txt     tx_ofdm.grc
 </code> </code>
from_gnuradio_to_cortxlab.1486390240.txt.gz · Last modified: 2017/02/06 15:10 by lcardoso

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki