[1455] | 1 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 2 | % Transmitting and Receiving Data using WARPLab (SISO Configuration) |
---|
| 3 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 4 | |
---|
| 5 | % The specific steps implemented in this script are the following |
---|
| 6 | |
---|
| 7 | % 0. Initializaton and definition of parameters |
---|
| 8 | % 1. Generate a vector of samples to transmit and send the samples to the |
---|
| 9 | % WARP board (Sample Frequency is 40MHz) |
---|
| 10 | % 2. Prepare WARP boards for transmission and reception and send trigger to |
---|
| 11 | % start transmission and reception (trigger is the SYNC packet) |
---|
| 12 | % 3. Read the received samples from the WARP board |
---|
| 13 | % 4. Reset and disable the boards |
---|
| 14 | % 5. Plot the transmitted and received data and close sockets |
---|
| 15 | |
---|
| 16 | % In this lab exercise you will write a matlab script that implements the |
---|
| 17 | % six steps above. Part of the code is provided, some part of the code you |
---|
| 18 | % will write. Read the code below and fill in with your code wherever you |
---|
| 19 | % are asked to do so. |
---|
| 20 | |
---|
| 21 | % NOTE: To avoid conflict with other groups using the boards, please test |
---|
| 22 | % the code you write in this script in any of the following three ways: |
---|
| 23 | % |
---|
| 24 | % Option 1. Run this script from MATLAB's Command Window by entering the |
---|
| 25 | % name of the script (enter warplab_siso_example_TxRx_WorkshopExercise in |
---|
| 26 | % matlab's Command Window). |
---|
| 27 | % Option 2. In the menu bar go to Debug and select Run. If there |
---|
| 28 | % are errors in the code, error messages will appear in the Command Window. |
---|
| 29 | % Option 3. Press F5. If the are errors in the code, error messages will |
---|
| 30 | % appear in the Command Window. |
---|
| 31 | % |
---|
| 32 | % DO NOT USE the Evaluate selection option and DO NOT run the script by |
---|
| 33 | % sections. To test any change, always run the whole script by following |
---|
| 34 | % any of the three options above. |
---|
| 35 | |
---|
| 36 | % WARPLab documentation can be found online at |
---|
| 37 | % http://warp.rice.edu/trac/wiki/WARPLab |
---|
| 38 | |
---|
| 39 | |
---|
| 40 | try, |
---|
| 41 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 42 | % Code to avoid conflict between users, only needed for the workshop, go to |
---|
| 43 | % step 0 below to start the initialization and definition of parameters |
---|
| 44 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 45 | % fid = fopen('c:\boards_lock.txt'); |
---|
| 46 | % |
---|
| 47 | % if(fid > -1) |
---|
| 48 | % fclose('all'); |
---|
| 49 | % errordlg('Boards already in use - Please try again!'); |
---|
| 50 | % return; |
---|
| 51 | % end |
---|
| 52 | |
---|
| 53 | % !echo > c:\boards_lock.txt |
---|
| 54 | |
---|
| 55 | |
---|
| 56 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 57 | % 0. Initializaton and definition of parameters |
---|
| 58 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 59 | %Load some global definitions (packet types, etc.) |
---|
| 60 | warplab_defines |
---|
| 61 | |
---|
| 62 | % Create Socket handles and intialize nodes |
---|
| 63 | [socketHandles, packetNum] = warplab_initialize; |
---|
| 64 | |
---|
| 65 | % Separate the socket handles for easier access |
---|
| 66 | % The first socket handle is always the magic SYNC |
---|
| 67 | % The rest of the handles are the handles to the WARP nodes |
---|
| 68 | udp_Sync = socketHandles(1); |
---|
| 69 | udp_node1 = socketHandles(2); |
---|
| 70 | udp_node2 = socketHandles(3); |
---|
| 71 | |
---|
| 72 | % Define WARPLab parameters. |
---|
| 73 | %-------------------------------------------------------------------------% |
---|
| 74 | % USER CODE HERE |
---|
| 75 | |
---|
| 76 | % Create the following variables and assign them valid values: |
---|
| 77 | |
---|
| 78 | % TxDelay: Number of noise samples per Rx capture. In [0:2^14] |
---|
| 79 | % TxLength: Length of transmission. In [0:2^14-1-TxDelay] |
---|
| 80 | % CarrierChannel: Channel in the 2.4 GHz band. In [1:14] |
---|
| 81 | % Node1_Radio2_TxGain_BB: Tx Baseband Gain. In [0:3] |
---|
| 82 | % Node1_Radio2_TxGain_RF: Tx RF Gain. In [0:63] |
---|
| 83 | % Node2_Radio2_RxGain_BB: Rx Baseband Gain. In [0:31] |
---|
| 84 | % Node2_Radio2_RxGain_RF: Rx RF Gain. In [1:3] |
---|
| 85 | |
---|
| 86 | % Note: For this experiment node 1 will be set as the transmitter and node |
---|
| 87 | % 2 will be set as the receiver (this is done later in the code), hence, |
---|
| 88 | % there is no need to define receive gains for node 1 and there is no |
---|
| 89 | % need to define transmitter gains for node 2. |
---|
| 90 | |
---|
| 91 | |
---|
| 92 | %-------------------------------------------------------------------------% |
---|
| 93 | |
---|
| 94 | TxMode = 0; % Transmission mode. In [0:1] |
---|
| 95 | % 0: Single Transmission |
---|
| 96 | % 1: Continuous Transmission. Tx board will continue |
---|
| 97 | % transmitting the vector of samples until the user manually |
---|
| 98 | % disables the transmitter. |
---|
| 99 | |
---|
| 100 | % Download the WARPLab parameters to the WARP nodes. |
---|
| 101 | % The nodes store the TxDelay, TxLength, and TxMode parameters in |
---|
| 102 | % registers defined in the WARPLab sysgen model. The nodes set radio |
---|
| 103 | % related parameters CarrierChannel, TxGains, and RxGains, using the |
---|
| 104 | % radio controller functions. |
---|
| 105 | |
---|
| 106 | % The TxDelay, TxLength, and TxMode parameters need to be known at the transmitter; |
---|
| 107 | % the receiver doesn't require knowledge of these parameters (the receiver |
---|
| 108 | % will always capture 2^14 samples). For this exercise node 1 will be set as |
---|
| 109 | % the transmitter (this is done later in the code). Since TxDelay, TxLength and |
---|
| 110 | % TxMode are only required at the transmitter we download the TxDelay, TxLength and |
---|
| 111 | % TxMode parameters only to the transmitter node (node 1). |
---|
| 112 | warplab_writeRegister(udp_node1,TX_DELAY,TxDelay); |
---|
| 113 | warplab_writeRegister(udp_node1,TX_LENGTH,TxLength); |
---|
| 114 | warplab_writeRegister(udp_node1,TX_MODE,TxMode); |
---|
| 115 | % The CarrierChannel parameter must be downloaded to all nodes |
---|
| 116 | warplab_setRadioParameter(udp_node1,CARRIER_CHANNEL,CarrierChannel); |
---|
| 117 | warplab_setRadioParameter(udp_node2,CARRIER_CHANNEL,CarrierChannel); |
---|
| 118 | % Node 1 will be set as the transmitter so download Tx gains to node 1. |
---|
| 119 | warplab_setRadioParameter(udp_node1,RADIO2_TXGAINS,(Node1_Radio2_TxGain_RF + Node1_Radio2_TxGain_BB*2^16)); |
---|
| 120 | % Node 2 will be set as the receiver so download Rx gains to node 2. |
---|
| 121 | warplab_setRadioParameter(udp_node2,RADIO2_RXGAINS,(Node2_Radio2_RxGain_BB + Node2_Radio2_RxGain_RF*2^16)); |
---|
| 122 | |
---|
| 123 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 124 | % 1. Generate a vector of samples to transmit and send the samples to the |
---|
| 125 | % WARP board (Sample Frequency is 40MHz) |
---|
| 126 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 127 | % Prepare some data to be transmitted |
---|
| 128 | t = 0:(1/40e6):TxLength/40e6 - 1/40e6; % Create time vector. |
---|
| 129 | |
---|
| 130 | %-------------------------------------------------------------------------% |
---|
| 131 | % USER CODE HERE |
---|
| 132 | |
---|
| 133 | % Create a signal to transmit, the signal is a function of the time vector |
---|
| 134 | % 't' the signal can be real or complex. Store the signal to transmit in a |
---|
| 135 | % variable named 'Node1_Radio2_TxData' (Node1_Radio2_TxData = your signal). |
---|
| 136 | |
---|
| 137 | % The signal must meet the following requirements: |
---|
| 138 | % - Signal to transmit must be a row vector. |
---|
| 139 | % - The amplitude of the real part must be in [-1:1] and the amplitude |
---|
| 140 | % of the imaginary part must be in [-1:1]. |
---|
| 141 | % - Highest frequency component is limited to 9.5 MHz (signal bandwidth |
---|
| 142 | % is limited to 19 MHz) |
---|
| 143 | % - Lowest frequency component is limited to 30 kHz |
---|
| 144 | |
---|
| 145 | %-------------------------------------------------------------------------% |
---|
| 146 | |
---|
| 147 | % Download the samples to be transmitted |
---|
| 148 | warplab_writeSMWO(udp_node1, RADIO2_TXDATA, Node1_Radio2_TxData); |
---|
| 149 | |
---|
| 150 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 151 | % 2. Prepare WARP boards for transmission and reception and send trigger to |
---|
| 152 | % start transmission and reception (trigger is the SYNC packet) |
---|
| 153 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 154 | % The following lines of code set node 1 as transmitter and node 2 as |
---|
| 155 | % receiver; transmission and capture are triggered by sending the SYNC |
---|
| 156 | % packet. |
---|
| 157 | |
---|
| 158 | % Enable transmitter radio path in radio 2 in node 1 (enable radio 2 in |
---|
| 159 | % node 1 as transmitter) |
---|
| 160 | warplab_sendCmd(udp_node1, RADIO2_TXEN, packetNum); |
---|
| 161 | |
---|
| 162 | % Enable transmission of node1's radio 2 Tx buffer (enable transmission |
---|
| 163 | % of samples stored in radio 2 Tx Buffer in node 1) |
---|
| 164 | warplab_sendCmd(udp_node1, RADIO2TXBUFF_TXEN, packetNum); |
---|
| 165 | |
---|
| 166 | % Enable receiver radio path in radio 2 in node 2 (enable radio 2 in |
---|
| 167 | % node 2 as receiver) |
---|
| 168 | warplab_sendCmd(udp_node2, RADIO2_RXEN, packetNum); |
---|
| 169 | |
---|
| 170 | % Enable capture in node2's radio 2 Rx Buffer (enable radio 2 rx buffer in |
---|
| 171 | % node 2 for storage of samples) |
---|
| 172 | warplab_sendCmd(udp_node2, RADIO2RXBUFF_RXEN, packetNum); |
---|
| 173 | |
---|
| 174 | % Prime transmitter state machine in node 1. Node 1 will be |
---|
| 175 | % waiting for the SYNC packet. Transmission from node 1 will be triggered |
---|
| 176 | % when node 1 receives the SYNC packet. |
---|
| 177 | warplab_sendCmd(udp_node1, TX_START, packetNum); |
---|
| 178 | |
---|
| 179 | % Prime receiver state machine in node 2. Node 2 will be waiting |
---|
| 180 | % for the SYNC packet. Capture at node 2 will be triggered when node 2 |
---|
| 181 | % receives the SYNC packet. |
---|
| 182 | warplab_sendCmd(udp_node2, RX_START, packetNum); |
---|
| 183 | |
---|
| 184 | % Send the SYNC packet |
---|
| 185 | warplab_sendSync(udp_Sync); |
---|
| 186 | |
---|
| 187 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 188 | % 3. Read the received samples from the WARP board |
---|
| 189 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 190 | % Read back the received samples |
---|
| 191 | [Node2_Radio2_RawRxData] = warplab_readSMRO(udp_node2, RADIO2_RXDATA, TxLength+TxDelay); |
---|
| 192 | % Process the received samples to obtain meaningful data |
---|
| 193 | [Node2_Radio2_RxData,Node2_Radio2_RxOTR] = warplab_processRawRxData(Node2_Radio2_RawRxData); |
---|
| 194 | % Read stored RSSI data |
---|
| 195 | [Node2_Radio2_RawRSSIData] = warplab_readSMRO(udp_node2, RADIO2_RSSIDATA, ceil((TxLength+TxDelay)/8)); |
---|
| 196 | % Procecss Raw RSSI data to obtain meningful RSSI values |
---|
| 197 | [Node2_Radio2_RSSIData] = warplab_processRawRSSIData(Node2_Radio2_RawRSSIData); |
---|
| 198 | |
---|
| 199 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 200 | % 4. Reset and disable the boards |
---|
| 201 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 202 | % Set radio 2 Tx buffer in node 1 back to Tx disabled mode |
---|
| 203 | warplab_sendCmd(udp_node1, RADIO2TXBUFF_TXDIS, packetNum); |
---|
| 204 | |
---|
| 205 | % Disable the transmitter radio |
---|
| 206 | warplab_sendCmd(udp_node1, RADIO2_TXDIS, packetNum); |
---|
| 207 | |
---|
| 208 | % Set radio 2 Rx buffer in node 2 back to Rx disabled mode |
---|
| 209 | warplab_sendCmd(udp_node2, RADIO2RXBUFF_RXDIS, packetNum); |
---|
| 210 | |
---|
| 211 | % Disable the receiver radio |
---|
| 212 | warplab_sendCmd(udp_node2, RADIO2_RXDIS, packetNum); |
---|
| 213 | |
---|
| 214 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 215 | % 5. Plot the transmitted and received data and close sockets |
---|
| 216 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 217 | figure; |
---|
| 218 | subplot(2,2,1); |
---|
| 219 | plot(real(Node1_Radio2_TxData)); |
---|
| 220 | title('Tx Node 1 Radio 2 I'); |
---|
| 221 | xlabel('n (samples)'); ylabel('Amplitude'); |
---|
| 222 | axis([0 2^14 -1 1]); % Set axis ranges. |
---|
| 223 | subplot(2,2,2); |
---|
| 224 | plot(imag(Node1_Radio2_TxData)); |
---|
| 225 | title('Tx Node 1 Radio 2 Q'); |
---|
| 226 | xlabel('n (samples)'); ylabel('Amplitude'); |
---|
| 227 | axis([0 2^14 -1 1]); % Set axis ranges. |
---|
| 228 | subplot(2,2,3); |
---|
| 229 | plot(real(Node2_Radio2_RxData)); |
---|
| 230 | title('Rx Node 2 Radio 2 I'); |
---|
| 231 | xlabel('n (samples)'); ylabel('Amplitude'); |
---|
| 232 | axis([0 2^14 -1 1]); % Set axis ranges. |
---|
| 233 | subplot(2,2,4); |
---|
| 234 | plot(imag(Node2_Radio2_RxData)); |
---|
| 235 | title('Rx Node 2 Radio 2 Q'); |
---|
| 236 | xlabel('n (samples)'); ylabel('Amplitude'); |
---|
| 237 | axis([0 2^14 -1 1]); % Set axis ranges. |
---|
| 238 | |
---|
| 239 | % Close sockets |
---|
| 240 | pnet('closeall'); |
---|
| 241 | |
---|
| 242 | % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 243 | % % Code to avoid conflict between users, only needed for the workshop |
---|
| 244 | % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
---|
| 245 | % !del c:\boards_lock.txt |
---|
| 246 | catch, |
---|
| 247 | % Reset nodes |
---|
| 248 | warplab_reset2x2Node(udp_node1); |
---|
| 249 | warplab_reset2x2Node(udp_node2); |
---|
| 250 | % Close sockets |
---|
| 251 | pnet('closeall'); |
---|
| 252 | % !del c:\boards_lock.txt |
---|
| 253 | lasterr |
---|
| 254 | end |
---|