Imports a configuration to the session from the specified file.


icon

Inputs/Outputs

  • civrn.png Instrument Handle —

    Instrument Handle identifies a particular instrument session.

    Instrument Handle is obtained from the niFgen Initialize VI, niFgen Initialize With Options VI, or the niFgen Initialize With Channels VI.

  • cpath.png file path —

    file path is the absolute path to the file that contains the configuration to import.

    If you specify an empty or relative path, this VI returns an error.

    Default file extension: .nifgenconfig

  • cerrcodeclst.png error in —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

    Default value: no error

  • iivrn.png Instrument Handle Out —

    Instrument Handle Out passes a reference to your instrument session to the next VI.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Details

    Requirements for Exporting and Importing Arbitrary Waveforms

    Arbitrary waveforms you export and import between sessions using this VI must meet the following criteria:

    • All waveforms in the exporting session are created from files using the niFgen Create Waveform (poly) VI
    • The full file path of the file containing the arbitrary waveform still exists upon import
    • All waveforms are defined using handles rather than names
    • All waveforms are complete—none are streamed or incrementally written

    You can set the device mode with the niFgen Configure Output Mode VI. For more information on arbitrary waveform mode, refer to Arbitrary Waveform Output Mode and Configure Arbitrary Waveform Mode.

    Channel Mapping Behavior

    When exporting and importing configurations between NI‑FGEN sessions that were initialized with different channels using the channel name input to the niFgen Initialize With Channels VI, the configuration of the exporting channel is mapped to the importing channel.

    For example, if your entry for channel name is 0 for the exporting session and 1 for the importing session, the configuration exported from channel 0 is imported into channel 1.

    Note This VI will return an error if the total number of channels initialized for the exporting session is not equal to the total number of channels initialized for the importing session.