Wiki

Below is the source of this page. To edit this source as well as other pages on the wiki, you must login.
===== FMComms5 Plugin Description =====

The FMCOMMS5 plugin works with the [[iio_oscilloscope|IIO Oscilloscope]]. You always use the latest version if possible. Changing any field will immediately write changes which have been made to the FMComms5 settings to the hardware, and then read it back to make sure the setting is valid. If you want to set something that the GUI changes to a different number, that either means that GUI is rounding (sorry), or the hardware (either the AD9361 or the FPGA fabric) does not support that mode/precision.


<WRAP info>
**For the main OSC plot window: The allowed channel sections are based on following rules:**
  - Channels need to enabled pairwise I & Q. (example voltage0 & voltage1 or voltage2 & voltage3, etc. )
  - The number of enabled pairwise channels need to be equal between the two devices.
  - Devices are split as following: voltage0..3 Device A, voltage4..7 Device B
</WRAP>

If you want to go play with ''/sys/bus/iio/devices/....'' and manipulate the devices behind the back of the GUI, it's still possible to see the settings by clicking the "refresh" button at the bottom of the GUI.

If you think the device has a setting that isn't managed by this tab, check out the [[fmcomms2_advanced_plugin|fmcomms5 Advanced Plugin]] for the IIO Oscilloscope.

The FMComms5 view is divided in four sections:
  * **Device Global Settings**
  * **Receive Chain**
  * **Transmit Chain**
  * **FPGA Settings**

{{ :resources:tools-software:linux-software:fmcomms5_plugin.png?380|}}

==== Device Global Settings ====
  * **Active ENSM:** Displays the active mode of the Enable State Machine. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#enable_state_machine_controls | Read More ]]
  * **ENSM Modes:** Selects one of the available modes: FDD and TDD. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#enable_state_machine_controls | Read More ]]
  * **Calibration Mode:** Displays the active calibration mode. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#calibration_mode_controls | Read More ]]
  * **Calibration Modes:** Selects one of the available modes: auto, manual, rf_dc_offs and tx_quad. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#calibration_mode_controls | Read More ]]
  * **TRX Rate Governor:** Displays the active option of the Rate Governors. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rate_governors | Read More ]]
  * **TRX Rate Governor Available:** Selects one of the available options: nominal and highest_osr. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rate_governors | Read More ]]
  * **Filter FIR configuration**
    * **FIR parameters file chooser** Allows a FIR filter configuration to be loaded from a file. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#digital_fir_filter_controls | Read More ]]
    * **Enable RX FIR Filter Only:** Enables/Disables the FIR filter on RX path. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#filter_enable_/_disable | Read More ]]
    * **Enable TX FIR Filter Only:** Enables/Disables the FIR filter on TX path.[[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#filter_enable_/_disable | Read More ]]
    * **Enable RX & TX FIR filters:** Enables the FIR filter on both RX and TX paths.
    * **Disable All:** Disables the FIR filter on both RX and TX paths.
  * **RX Path Rates:** Lists the rates of: BBPLL, ADC, R2, R1, RF, RXSAMP. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#list_chosen_rx_path_rates | Read More ]]
  * **TX Path Rates:** Lists the rates of: TXSAMP, TF, T1, T2, DAC, BBPLL. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#list_chosen_tx_path_rates | Read More ]]
  * **DCXO Coarse Tune:** Selects the attribute for a coarse tune. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#dcxo_tuning_digital_controlled_crystal_oscillator | Read More]]
  * **DCXO Fine Tune:** Selects the attribute for a fine tune. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#dcxo_tuning_digital_controlled_crystal_oscillator | Read More]]

Note that all settings above apply to both ad9361 devices.

==== Receive Chain ====
  * **RF Bandwidth(MHz):** Configures RX analog filters: RX TIA LPF and RX BB LPF. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rx_rf_bandwidth_control | Read More ]]
  * **Sampling Rate(MSPS):** Selects the sample rate of the ADC. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#setting_/_querying_the_rx_sample_rate | Read More ]]
  * **RF Port Select:** Selects the RF Port of the receive channels. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rf_port_selection | Read More ]]
  * **RX LO Frequency(MHz):** Selects the RX local oscillator frequency. Range 70MHz to 6GHz with 1Hz tuning granularity. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#local_oscillator_control(lo) | Read More ]]
  * **Fastlock Mode** [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#fastlock_mode | Read More ]]
    * **Fastlock Profile:** Selects a profile to be stored or recalled.
    * **Store:** Stores the selected profile.
    * **Recall:** Recalls the selected profile.
  * **Tracking** [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#calibration_tracking_controls | Read More ]]
    * **Quadrature**
    * **RF DC**
    * **BB DC**
  * **RX**
    * **Hardware Gain(dB):** Controls the RX gain only in Manual Gain Control Mode (MGC).   [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#MGC_setting_the_current_gain | Read More ]]
    * **RSSI(dB):** Displays the received strength signal level. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#received_strength_signal_indicator_(rssi) | Read More ]]
    * **Gain Control:** Displays the active gain mode. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rx_gain_control | Read More ]]
    * **Gain Control Modes:** Selects one of the available modes: manual, slow_attack, hybrid and fast_attack. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rx_gain_control | Read More ]]

Note that only **RF Bandwidth**, **Sampling Rate**, **RF Port Select** and **Tracking** settings apply to both ad9361 devices.

==== Transmit Chain ====
  * **RF Bandwidth(MHz):** Configures TX analog filters: TX BB LPF and  TX Secondary LPF. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#tx_rf_bandwidth_control | Read More ]]
  * **Sampling Rate(MSPS):** Selects the sample rate of the DAC.  [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#setting_/_querying_the_tx_sample_rate | Read More ]]
  * **RF Port Select:** Selects the RF Port of the transmit channels. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#rf_port_selection | Read More ]]
  * **TX LO Frequency(MHz):** Selects the TX local oscillator frequency. Range 70MHz to 6GHz with 1Hz tuning granularity. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#local_oscillator_control(lo) | Read More ]]
  * **Fastlock Mode** [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#fastlock_mode | Read More ]]
    * **Fastlock Profile:** Selects a profile to be stored or recalled.
    * **Store:** Stores the selected profile.
    * **Recall:** Recalls the selected profile.
  * **TX**
      * **Attenuation(dB):** Individually controlls attenuation for TX1 and TX2. The range is from 0 to -89.75 dB in 0.25dB steps. [[:resources/tools-software/linux-drivers/iio-transceiver/ad9361#tx_attenuation_control | Read More ]]

Note that only **RF Bandwidth**, **Sampling Rate** and **RF Port Select** settings apply to both ad9361 devices.

==== FPGA Settings ====
  * **Transmit/DDS**
    * **DDS Mode:** Selects on the the available modes:
       - One CW Tone
       - Two CW Tones
       - Independent I/Q Control
       - DAC Buffer Output (Output a data file)
       - Disabled.
    * **Tone**
      * **Frequency(MHz):** Selects the frequency of the tone.
      * **Scale:** Selects the scale of the tone.
      * **Phase(degrees):** Selects the phase of the tone.
  * **Receive**
    * **Phase Rotation :** Selects the rotation phase of a RX
Analog Devices Wiki

Page Tools
