Skip to content

NI DMM Inherent IVI Attributes

Jump to bottom
ni-siray edited this page May 7, 2021 · 3 revisions

Inherent IVI Attributes

NIDMM_ATTRIBUTE_RESOURCE_DESCRIPTOR

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the resource descriptor of the instrument.

NIDMM_ATTRIBUTE_LOGICAL_NAME

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the logical name of the instrument.

NIDMM_ATTRIBUTE_CHANNEL_COUNT

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViInt32 RO None None

Description

Indicates the number of channels that the specific instrument driver supports. For each attribute for which the IVI_VAL_MULTI_CHANNEL flag attribute is set, the IVI engine maintains a separate cache value for each channel.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_PREFIX

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

The prefix for the specific instrument driver. The name of each user-callable function in this driver starts with this prefix. The prefix can be up to a maximum of eight characters.

NIDMM_ATTRIBUTE_INSTRUMENT_FIRMWARE_REVISION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None niDMM_revision_query

Description

A string containing the instrument firmware revision number.

NIDMM_ATTRIBUTE_INSTRUMENT_MANUFACTURER

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the manufacturer of the instrument.

NIDMM_ATTRIBUTE_INSTRUMENT_MODEL

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the instrument model.

NIDMM_ATTRIBUTE_INSTR_SERIAL_NUMBER

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the serial number of the instrument. This attribute corresponds to the serial number label that is attached to most products.

NIDMM_ATTRIBUTE_GROUP_CAPABILITIES

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the capabilities and extension groups supported by the specific driver.

NIDMM_ATTRIBUTE_SUPPORTED_INSTRUMENT_MODELS

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the instrument models supported by the specific driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_CLASS_SPEC_MAJOR_VERSION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViInt32 RO None None

Description

The major version number of the class specification for the specific driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_CLASS_SPEC_MINOR_VERSION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViInt32 RO None None

Description

The minor version number of the class specification for the specific driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_DESCRIPTION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing a description of the specific driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_VENDOR

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the vendor of the specific driver.

NIDMM_ATTRIBUTE_CACHE

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None [InitWithOptions

ViBoolean Description

Specifies whether to cache the value of attributes. When caching is enabled, the instrument driver keeps track of the current instrument settings and avoids sending redundant commands to the instrument. Thus, it significantly increases execution speed. The instrument driver can choose to always cache or to never cache particular attributes regardless of the setting of this attribute. The default value is VI_TRUE (1). Use the niDMM_InitWithOptions function to override this setting.

NIDMM_ATTRIBUTE_DRIVER_SETUP

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None niDMM_InitWithOptions

Description

This attribute indicates the Driver Setup string that the user specified when initializing the driver. Some cases exist where the end-user must specify instrument driver options at initialization time. An example of this is specifying a particular instrument model from among a family of instruments that the driver supports. This is useful when using simulation. The end-user can specify driver-specific options through the DriverSetup keyword in the Option_String parameter in niDMM_InitWithOptions. If the user does not specify a Driver Setup string, this attribute returns an empty string.

NIDMM_ATTRIBUTE_INTERCHANGE_CHECK

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None niDMM_GetNextInterchangeWarning

Description

Specifies whether to perform interchangeability checking and log interchangeability warnings when you call niDMM functions. Interchangeability warnings indicate that using your application with a different instrument might cause different behavior. Use niDMM_GetNextInterchangeWarning to clear the list of interchangeability warnings without reading them. Interchangeability checking examines the attributes in a capability group only if you specify a value for at least one attribute within that group. Interchangeability warnings can occur when an attribute affects the behavior of the instrument and you have not set that attribute, or the attribute has been invalidated since you set it.

Defined Values

VI_FALSE (default) 0 False
VI_TRUE 1 True

NIDMM_ATTRIBUTE_QUERY_INSTRUMENT_STATUS

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None niDMM_InitWithOptions

Description

Specifies whether the instrument driver queries the instrument status after each operation. Querying the instrument status is very useful for debugging. After the user program is validated, this attribute can be set to VI_FALSE (0) to disable status checking and maximize performance. The instrument driver can choose to ignore status checking for particular attributes regardless of the setting of this attribute. The default value is VI_TRUE (1). Use niDMM_InitWithOptions to override this setting.

NIDMM_ATTRIBUTE_RANGE_CHECK

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None niDMM_InitWithOptions

Description

Specifies whether to validate attribute values and function parameters. If enabled, the instrument driver validates the parameter values passed to driver functions. Range checking parameters is very useful for debugging. After the user program is validated, this attribute can be set to VI_FALSE (0) to disable range checking and maximize performance. The default value is VI_TRUE (1). Use the niDMM_InitWithOptions function to override this setting.

NIDMM_ATTRIBUTE_RECORD_COERCIONS

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None None

Description

Specifies whether the IVI engine keeps a list of the value coercions it makes for ViInt32 and ViReal64 attributes. Call niDMM_GetNextCoercionRecord function to override this setting.

NIDMM_ATTRIBUTE_SIMULATE

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViBoolean R/W None [InitWithOptions

Description

Specifies whether or not to simulate instrument driver I/O operations. If simulation is enabled, instrument driver functions perform range checking and call IVI Get and Set functions, but they do not perform instrument I/O. For output parameters that represent instrument data, the instrument driver functions return calculated values. The default value is VI_FALSE (0). Use the [InitWithOptions function to override this setting.

Note  Simulate can only be set within the [InitWithOptions function. The attribute value cannot be changed outside of the function

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_MAJOR_VERSION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViInt32 RO None None

Description

Returns the major version number of this instrument driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_MINOR_VERSION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViInt32 RO None None

Description

The minor version number of this instrument driver.

NIDMM_ATTRIBUTE_SPECIFIC_DRIVER_REVISION

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string that contains additional version information about this instrument driver.

NIDMM_ATTRIBUTE_ID_QUERY_RESPONSE

Specific Attribute

Data
type		 Access Coercion High-Level Function
ViString RO None None

Description

A string containing the type of instrument used in the current session.

Table of Contents

Home

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally