Changes between Version 4 and Version 5 of wiser/mSoftware/aWiserd
- Timestamp:
- May 29, 2015, 3:45:26 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
wiser/mSoftware/aWiserd
v4 v5 24 24 1. '''store_to_file''': simply stores the time samples as complex 32bit floats in a binary file, with the format of the file being: receiver frequency as a 32bit float, receiver sampling rate as a 32bit float, receiver gain as a 32bit float, the number of stored samples as a 32bit unsigned integer, followed by the samples as 32bit complex floats, with the real part coming first and imaginary second for each sample. Consumer name is "storetofile". Needed parameters: the required number of time samples to store. 25 25 1. '''fft_movavg_oml''': performs the FFT on the time samples received from the receiver module, calculates the moving average and sends the results to the OML server. The consumer name is "fftmovingavgoml". Needed parameters: FFT length, averaging window length, OML server address and port (use server name "FILE" to store locally), OML filename. 26 1. '''fft_sigpower_oml''': performs the FFT on the time samples receivd from the receiver module, calculates the peak power in dBm and 3dB bandwidth each second, and on used command sends the results to the OML server. Needed parameters: FFT length, OML server address and port (use server name " FILE" to store locally), OML filename.26 1. '''fft_sigpower_oml''': performs the FFT on the time samples receivd from the receiver module, calculates the peak power in dBm and 3dB bandwidth each second, and on used command sends the results to the OML server. Needed parameters: FFT length, OML server address and port (use server name "file" to store locally), OML filename. 27 27 28 28 ==== Transmitter modules ==== … … 33 33 ==== Usage ==== 34 34 35 The commands may be entered in the command line or sent via TCP. The default port is 5123. The list of commands with their syntax:35 The parameters may be entered in the command line or sent via TCP. The default port is 5123. To set a parameter, the user must enter its name preceded by ''--'', and followed by the desired value. For example, to set receiver frequency to 700 MHz the user can enter the following: 36 36 37 ===== get =====38 '''get''' command is used to obtain values of parameters of certain modules. The user must use the correct module (uhd, rx and tx) when trying to access a parameter. For example, the receiver frequency, called rx_freq, is a parameter of the radio module (uhd), since it is set using the radio device driver. On the other hand, FFT length or the moving average window or anything the receiver consumers might need is a part of the receiver module (rx). For example, the command to get the current value of the receiver frequency is:39 37 {{{ 40 get uhd rx_freq 38 --uhd_rx_freq 700e6 41 39 }}} 42 40 43 ===== set ===== 44 '''set''' command is used to set values of the parameters. It's similar to "get", with the addition of the value at the end. Example: 41 To get the current value of any parameter, the user must enter only the parameter name preceded by ''--'': 42 45 43 {{{ 46 set uhd rx_freq 3.432e9 44 --uhd_rx_freq 47 45 }}} 48 46 49 ===== add ===== 50 '''"add"''' command is used to add a consumer to the transmitting or receiving module. Examples: 51 {{{ 52 add rx fftmovingavgudp 53 add tx waveform 54 }}} 55 56 ===== delete ===== 57 '''"delete"''' command deletes (stops) an added producer/consumer from the transmitting or receiving module. Examples: 58 {{{ 59 delete rx fftpowudp 60 }}} 61 62 ===== scan ===== 63 "scan" is a procedure that reads a script from a file, and then follows it to perform scanning of the spectrum by repeatedly adding the store_to_file consumer, and then deleting it when the work is done, for different values of receiving parameters. It has a single parameter: the file name from which the script is loaded. The input file is a textual file. The first line contains a single number N, the number of times the store_to_file will be run, followed by N lines containing 4 parameters each: central receiver frequency, receiver sampling rate, receiver gain and the required number of samples to be stored. 47 Adding the described modules is done using the parameter ''--addmodule'', followed by the module name. In order to run a module for a specified time, the parameters ''--recv_running_time'' or ''--tran_running_time'' need to be set to the desired time (in milliseconds), and the flag ''--timed'' needs to be used. 64 48 65 49 ==== Module Parameters ==== 66 50 67 || Receiver module ('''rx''') || 68 || numbins || FFT length || 69 || avgwinlen || Averaging window length || 70 || measurement_uri || UDP address used to send the measurement results to || 71 || measurement_port || UDP port used to send the measurement results to || 72 || minimal_power || Lower bound of measured power || 73 || maximal_power || Upper bound of measured power || 74 75 || Transmitter module ('''tx''') || 76 || wavetype || Type of transmitted waveform (SINE, CONST) || 77 || wavefreq || Frequency of the transmitted waveform || 78 || amplitude || Amplitude of the transmitted waveform || 79 || wavefilename || Input file name || 80 81 || Radio module ('''uhd''') || 82 || rx_freq || Receiver central frequency || 83 || rx_rate || Receiver sampling rate || 84 || rx_bandwidth || Receiver bandwidth || 85 || rx_gain || Receiver gain || 86 || rx_antenna || Receiver antenna || 87 || tx_freq || Transmitter central frequency || 88 || tx_rate || Transmitter sampling rate || 89 || tx_bandwidth || Transmitter bandwidth || 90 || tx_gain || Transmitter gain || 91 || tx_antenna || Transmitter antenna || 92 || sub_device || USRP radio internal subdevice to be used || 93 || clock_ref || USRP radio clock reference || 51 || --addmodule || Add a module (RX modules: 'timesamplestofile', 'fftmovingavgoml', 'fftmovingavgudp', 'fftsigpoweroml', 'fftpowudp'; TX modules: 'signalfromfile', 'waveform') || 52 || --delmodule || Delete a module 53 || --timed || Module runs for a predefined time and then gets automatically deleted 54 || --uhd_rx_antenna || Receiver antenna ('RX2', 'TX/RX') 55 || --uhd_tx_antenna || Transmitter antenna ('TX/RX') 56 || --uhd_rx_freq || Receiver central frequency 57 || --uhd_tx_freq || Transmitter central frequency 58 || --uhd_rx_rate || Receiver sampling rate 59 || --uhd_tx_rate || Transmitter sampling rate 60 || --uhd_rx_gain || Receiver gain in dB 61 || --uhd_tx_gain || Transmitter gain in dB 62 || --uhd_rx_bandwidth || Receiver bandwidth 63 || --uhd_tx_bandwidth || Transmitter bandwidth 64 || --recv_numbins || Number of FFT bins. 65 || --recv_avgwinlen || Averaging window length. 66 || --recv_oml_filename || Output filename for OML 67 || --recv_oml_servername || OML server name ('idb2:3003' or 'file') 68 || --recv_oml_output_type || Output data type for OML ('blob', 'vector', 'scalars') 69 || --recv_udp_port || UDP port 70 || --recv_udp_uri || UDP uri 71 || --recv_min_power || Minimal considered power in dBm 72 || --recv_max_power || Maximal considered power in dBm 73 || --recv_output_filename || Filename for local storing the time samples (do not add the extension) 74 || --recv_running_time || Running time for timed modules, in milliseconds 75 || --tran_wavetype || Type of transmitted waveform, SINE, CONST, SQUARE, RAMP 76 || --tran_wavefreq || Frequency of transmitted waveform 77 || --tran_amplitude || Amplitude of transmitted waveform (max 0.7) 78 || --tran_wavefilename || Name of the file containing the waveform 79 || --tran_running_time || Running time for timed modules, in milliseconds 94 80 95 81 ==== Development ====