| | 1 | = ALOE OFDM Transmitter Demo = |
| | 2 | |
| | 3 | We describe in this page how to download the OFDM transmitter demo we presented at COST-Terra Summer School 2012. |
| | 4 | |
| | 5 | Main Features: |
| | 6 | |
| | 7 | * Bandwidth 2-20 MHz |
| | 8 | * FFT size 128-2048 points |
| | 9 | * Turbo-encoding |
| | 10 | * Cyclic-Prefix |
| | 11 | * Run-time reconfiguration |
| | 12 | * '''E2E Latency: 4 ms''' (constant and non-random) |
| | 13 | * Distributed processing (tested with 2 processors and GigaEthernet) |
| | 14 | * GUI: signal visualization, execution time monitoring, etc. |
| | 15 | |
| | 16 | == Download and install == |
| | 17 | 1) Prerequisites: |
| | 18 | |
| | 19 | * Linux operating (tested on Ubuntu) |
| | 20 | * Only the 'readline' and 'termcap' libraries are required to install ALOE. Ask your OS vendor how to install these libraries. |
| | 21 | |
| | 22 | If you want to use the USRP, make sure you have the UHD drivers is installed before installing ALOE. |
| | 23 | |
| | 24 | 2) Download the latest ALOE unstable version from http://flexnets.upc.edu/downloads/aloe-ctss-demo-1.5.0.tar.gz |
| | 25 | |
| | 26 | 3) Untar, uncompress and cd into created directory |
| | 27 | |
| | 28 | 4) Configure, compile and install |
| | 29 | |
| | 30 | {{{ |
| | 31 | ./configure |
| | 32 | make |
| | 33 | sudo make install |
| | 34 | }}} |
| | 35 | 5) Add the following lines to /etc/sysctl.conf file |
| | 36 | |
| | 37 | {{{ |
| | 38 | kernel.msgmnb=1048576 |
| | 39 | kernel.msgmax=10485760 |
| | 40 | kernel.msgmni=128 |
| | 41 | }}} |
| | 42 | and run |
| | 43 | |
| | 44 | {{{ |
| | 45 | sudo sysctl -p |
| | 46 | }}} |
| | 47 | 6) Run the MAC-TEST to obtain your processor performance: |
| | 48 | |
| | 49 | {{{ |
| | 50 | sudo runcf -t NOFCORES 1000000 |
| | 51 | }}} |
| | 52 | replacing NOFCORES with the number of cores in your processor. You should see something like this: |
| | 53 | |
| | 54 | {{{ |
| | 55 | child 2: 1344192127:118 -> 1344192127:1561 diff: 0:1443 693 MMACS |
| | 56 | child 3: 1344192127:117 -> 1344192127:1561 diff: 0:1444 692 MMACS |
| | 57 | child 1: 1344192127:214 -> 1344192127:1597 diff: 0:1383 723 MMACS |
| | 58 | child 0: 1344192127:214 -> 1344192127:1597 diff: 0:1383 723 MMACS |
| | 59 | parent: 1344192126:183204->1344192127:3329 diff: 0:820125 |
| | 60 | }}} |
| | 61 | Now set the ''mops'' field in /usr/local/etc/platform.conf option to the MMACS obtained in the test. |
| | 62 | |
| | 63 | == Running the Demo application == |
| | 64 | 1) Run core framework. Requires root privileges to set real-time scheduler |
| | 65 | |
| | 66 | {{{ |
| | 67 | sudo runcf |
| | 68 | }}} |
| | 69 | 2) In the command prompt, run |
| | 70 | |
| | 71 | {{{ |
| | 72 | load ofdm128 |
| | 73 | init ofdm128 |
| | 74 | run ofdm128 |
| | 75 | }}} |
| | 76 | to load, initialize and run the OFDM-128 application. Now you can check the waveform is running with the command |
| | 77 | |
| | 78 | {{{ |
| | 79 | execinfo ofdm128 |
| | 80 | }}} |
| | 81 | 3) The OFDM bandwidth can be modified at run-time with: |
| | 82 | |
| | 83 | {{{ |
| | 84 | statset ofdm128 source fftsize 256 |
| | 85 | statset ofdm128 source fftsize 512 |
| | 86 | }}} |
| | 87 | Which set the fft size to 256 and 512 tones respectively (4 and 8 MHz bandwidth). By default, the framework will use one processor only from your computer. If you have a multi-core processor, edit the 'nof_cores' option in /usr/local/etc/platform.conf file. In our tests, the OFDM application runs perfectly in a 2.5 GHz Intel processor using one core only. The 512 mode produces frequent real-time faults (printed stdout). This mode works correctly in a dual-processor environment. |
| | 88 | |
| | 89 | == USRP == |
| | 90 | If the UHD driver is installed before running ALOE's configure script, the option dac=uhd in /usr/local/etc/platform.conf file allows ALOE to send samples to the USRP. Just edit the platform.conf file and run the OFDM-128 waveform from the ALOE command man. The device sampling frequency is automatically configured by ALOE. Since not all devices can work with the same sampling frequencies, the execution period (time-slot) can differ slightly from one set-up to another. |
| | 91 | |
| | 92 | You may experience with different sampling frequencies and time-slots editing the file /usr/local/etc/usrp.conf. By setting different sampling frequencies |
| | 93 | |
| | 94 | == Distributed Processing == |
| | 95 | 1) Download and install ALOE in two computers |
| | 96 | |
| | 97 | 2) Setup your network, making sure you have full TCP and UDP connectivity between both computers. |
| | 98 | |
| | 99 | 3) Edit file /usr/local/etc/xitf1.conf and replace 192.168.1.1 by the ip address of your MASTER node. |
| | 100 | |
| | 101 | 4) |
