get_config_string()

Returns configuration or device information as a null-terminated string.

Prototype

get_config_string(info_type, board_num, dev_num, config_item, max_config_len)

Parameters

info_type (InfoType)

The configuration information for each board is grouped into different categories. This parameter specifies which category you want. Always set this parameter to InfoType.BOARDINFO.

board_num (int)

The number associated with the board when it was installed with InstaCal or created with create_daq_device().

dev_num (int)

The purpose of the dev_num parameter depends on on the value of the config_item parameter. It can serve as a channel number, an index into the config_item, or it can be ignored. Unless otherwise noted in the config_item parameter values section below, this value is ignored.

config_item (BoardInfo)

The type of information to read from the device. Set it to one of the constants listed in the config_item parameter values section below.

max_config_len (int)

The maximum number of bytes to be read from the device into config_val.

Returns

config_item parameter values

Note that the dev_num parameter is ignored for most ConfigItems.

ConfigItemDescription
DEVMACADDRMAC address of an Ethernet device.
DEVSERIALNUMFactory serial number of a USB or Bluetooth device.

dev_num specifies either a base board (0) or an expansion board (1).
DEVUNIQUEIDUnique identifier of a discoverable device, such as the serial number of a USB device or MAC address of an Ethernet device.
DEVVERSIONFirmware version and FPGA version installed on a device.

Use this setting in conjunction with one of these DevNum settings:
  • MAIN (main firmware version)
  • MEASUREMENT (measurement firmware version)
  • MEASUREMENT_EXP (expansion board measurement firmware version)
  • RADIO (radio firmware version)
  • FPGA (FPGA version)
USERDEVIDUser-configured string identifier of up to maxConfigLen character/bytes from an Ethernet, Bluetooth, or USB device.