Initialize With Options
- Updated2023-02-17
- 3 minute(s) read
Initialize With Options
Opens a session for the supported hardware you specify, sets initial values of certain properties for the session, and returns a reference that identifies the instrument in all subsequent NI-RFSG nodes.
Inputs/Outputs

resource name
Resource name of the device to initialize.

error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error

option string
Initial value of certain properties for the session.
You can set the following properties using this input:
- Range Check
- Query Instrument Status
- Cache
- Coercions
- Simulate
- Driver Setup
Option String Syntax
The syntax for option string consists of the following relations:
propertyName=value
where
- propertyName is the name of the property.
- value is the value to which the property is set.
Syntax for Setting Multiple Properties
To set multiple properties, separate their assignments with a comma, as shown in the following option string:
"RangeCheck=1, QueryInstrStatus=0, Cache=1, DriverSetup=AWG:pxi1slot4"
Configuring the Driver Setup String
- Use the Driver Setup keyword in the option string to complete the following tasks:
- Specify your hardware device or external (non-National Instruments) device
- Simulate hardware that is not present
- Specify an NI-RFSG instrument driver FPGA extensions bitfile
Note Specifying an AE, AWG, or LO module in the Driver Setup string overrides any different existing association configured in MAX.
- Use the following format when configuring the Driver Setup string: Tag:Value
- When specifying or simulating multiple devices, separate them with a semicolon, as shown in the following string: DriverSetup=AWG:pxi1slot4; LO:pxi1slot7
| Use | Example Driver Setup String | Supported Devices |
|---|---|---|
| Specify an Amplitude Extender (AE) | DriverSetup=AE:Dev1 | PXIe-5654/5654 with PXIe-5696 |
| Specify a Waveform Generator (AWG) | DriverSetup=AWG:Dev1 | PXIe-5611, PXIe-5673E |
| Specify an external AWG | DriverSetup=AWG:<external> | |
| Specify a local oscillator (LO) | DriverSetup=LO:Dev1 | |
| Specify an external LO | DriverSetup=LO:<external> | PXIe-5611, PXIe-5644/5645/5646, PXIe-5673E, PXIe-5840 |
| Specify an NI-RFSG instrument driver FPGA extensions bitfile | DriverSetup=Bitfile:filename.lvbitx | PXIe-5644/5645/5646, PXIe-5820/5840 |
| Simulate a device | DriverSetup=Model:model number; BoardType:type |
Refer to Simulating an NI-RFSG Device for more information about supported devices. |

id query
Boolean value that indicates whether NI-RFSG performs an ID query.
| True | NI-RFSG performs an ID query. |
| False | NI-RFSG does not perform an ID query. |

reset
Boolean value that indicates whether the NI-RFSG device is reset during the initialization procedure.
| True | The device is reset. |
| False | The device is not reset. |

session out
Reference to your instrument session passed to the next node.

error out
Error information.
The node produces this output according to standard error behavior.
Hardware Support
This node supports the following hardware:
- PXIe-5611
- PXIe-5644/5645/5646
- PXI/PXIe-5650/5651/5652, PXIe-5653/5654/5654 with PXIe-5696
- PXIe-5673E
- PXIe-5820/5840