close Warning: Can't synchronize with repository "(default)" (/common/SVN/crkit does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Version 4 and Version 5 of wiser/mSoftware/aWiserd


Ignore:
Timestamp:
May 29, 2015, 3:45:26 PM (9 years ago)
Author:
stojadin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • wiser/mSoftware/aWiserd

    v4 v5  
    2424  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.
    2525  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.
    2727
    2828==== Transmitter modules ====
    … …  
    3333==== Usage ====
    3434
    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:
     35The 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:
    3636
    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:
    3937{{{
    40 get uhd rx_freq
     38--uhd_rx_freq 700e6
    4139}}}
    4240
    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:
     41To get the current value of any parameter, the user must enter only the parameter name preceded by ''--'':
     42
    4543{{{
    46 set uhd rx_freq 3.432e9
     44--uhd_rx_freq
    4745}}}
    4846
    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.
     47Adding 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.
    6448
    6549==== Module Parameters ====
    6650
    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
    9480
    9581==== Development ====