NI-RFSG Programming State Model

The NI-RFSG programming model has three main states: Configuration (idle), Committed, and Generation (running).

The following diagram depicts the programming state model for the PXI-5670/5671 and PXIe-5672 Vector Signal Generator and NI-RFSG software.



The following diagram depicts the programming state model for the PXIe-5673/5673E Vector Signal Generator and NI-RFSG software.



  • Configuration—You can program all session properties and attributes in the Configuration state. However, when the hardware module is in the Configuration state, the properties or attributes have not yet been applied. Therefore, the module configuration may not match the session property or attribute values. The NI-RFSG device does not generate a signal in the Configuration state.
    Note When you read a property or attribute, NI-RFSG may analyze many properties in the current configuration in order to return the coerced value for that property or attribute. In general, avoid reading any properties or attributes until you have finished changing all the properties or attributes you would like to change. Otherwise, you may encounter errors if a property or attribute is read while the configuration is in an inconsistent state.
  • Committed—Calling the niRFSG Commit VI or the niRFSG_Commit function from the Configuration state performs the following actions:
    • Verifies all property or attribute settings
    • Validates the specified configuration
    • Writes all settings to the hardware modules
    • Writes the waveform to the AWG module onboard memory
    • Transitions to the Committed state

    If any properties or attributes are changed while in the Committed state, the session implicitly transitions back to the Configuration state and the hardware configuration reflects the previously committed properties or attributes.

    * Write waveform has the opposite behavior on the PXIe-5673/5673E. Write waveform transitions the session into the committed state.

  • Generation—In the Generation state, session properties or attributes always reflect the current state of the module, and the module is either waiting on a trigger or generating a signal.
    Note For the PXI-5670/5671 and PXIe-5672 devices, you cannot write any properties or attributes during the Generation state. The PXI/PXIe-5650/5651/5652 devices allow some properties or attributes to be changed during the Generation state. The PXIe-5673/5673E devices allow properties or attributes to be changed during the Generation state.
  • Note The niRFSG Close VI or the niRFSG_close function may be called from any state. Calling this VI or function stops signal generation.

    Related Topics

    niRFSG Commit VI

    niRFSG_Commit Function

    niRFSG Close VI

    niRFSG_close Function