{"id":129,"date":"2014-11-06T19:19:40","date_gmt":"2014-11-06T19:19:40","guid":{"rendered":"http:\/\/www.nerdlingen.de\/?p=129"},"modified":"2019-02-01T09:14:22","modified_gmt":"2019-02-01T08:14:22","slug":"agilent-u1253a-with-labview","status":"publish","type":"post","link":"https:\/\/www.nerdlingen.de\/?p=129","title":{"rendered":"Agilent U1253A with LabView"},"content":{"rendered":"

Agilent’s U-Series Multimeters have the ability to be talked to via an infrared interface (and some of them even feature an OLED display<\/a>), either through Agilent<\/del> Keysight’s slightly overpriced USB-To-IR Adapter<\/a>, or by building your own. If you intent to follow the latter path, be sure to read Josip Medved’s Info about the Adapter<\/a>; it covers pretty much everything you need. There’s also a YouTube-Video with a more sophisticated<\/a> (and probably oversized) approach.<\/p>\n

LabView<\/h2>\n

With the communication working (you might test it with Keysight’s own logging-tool<\/a>), it’s probably more interesting to be able to control the device using LabView. Unfortunately, I could not find any libraries, and the documentation is limited to a post on Philipp Klaus’ blog describing the basic command set<\/a>.<\/p>\n

\"Screenshot<\/a>
A sample program constantly reading the meter’s data<\/figcaption><\/figure>\n

In short, the Device features 2.5 “channels”, or let’s call them data-streams; it is capable of e.g. measuring voltage and frequency of an AC source simultaneously and can additionally report the current ambient temperature; although that feature might not be of so much use. In principle, to continuously read out the data measured by the multimeter, you might want to query it’s current setting (unit, range, precision), it’s value or status (like auto-range, position of the rotary switch etc.).<\/p>\n

Command Set<\/h2>\n

To find out how to talk to the device, and how to interpret it’s response, I used a Serial Analyzer<\/a> in conjunction with the original software. The result is a LabView-Library that’s capable of handling a reasonable part of all passive commands (no controlling of the device so far<\/del> only limited support for configuring the device so far) – the lib, however, should be considered in alpha-state and might still contain bugs. Every command sent from the computer should be terminated by a single linefeed (0x0A, “\\n” etc.); the device itself terminates with carriage return and linefeed. On error, the device will return “*E\\r\\n”. Most of the time, the meter acts as passive command-responder, except when the user turns the rotary-switch – in that case, the device sends the switch position counting from 0 (and excluding the “off” state – which means you won’t be able to detect a “switch-off” event except with a communication timeout) preceded by a star, i.e. “*1\\r\\n” for Volt.<\/p>\n

The commands I saw on the line include:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Command<\/th>Meaning<\/th>\n<\/tr>\n<\/thead>\n
*CLS<\/td>allways sent to the device on the beginning of a command set. Probably resets the last read-command<\/td>\n<\/tr>\n
*RST<\/td>said to reset the meter, up to now I didn't see any actual change in behavior<\/td>\n<\/tr>\n
*IDN?<\/td>Request identification of the meter. Result is a string devided into 4 parts by commas, i.e.
\n\"Agilent Technologies,U1253A,MY12345678,V1.01\", reading the company's name, the model- and serial number and it's firmware version<\/td>\n<\/tr>\n
STAT?<\/td>Returns the current device status. I could only identify two parameters so far.
\n
\nSample:
\n\"000000I00012L00204001\"
\n(Character 17, 2 in this case, indicates the current position of the rotary switch, whereas the last digit is set to 1 when AUTO-range is enabled)<\/td>\n<\/tr>\n
CONF? (or)
\nCONF? @#<\/td>		Request the current configuration (for channel @#) of the meter, see the next section<\/td>\n<\/tr>\n
FETC? (or)
\nFETC? @#<\/td>		\"Fetch\" either the 1st display\/stream\/channel (or however you'd like to call it) or request a specific one (i.e. \"FETC? @2\" for the auxiliary reading, i.e. the frequency of an A\/C voltage)
\n
\nThe meter always returns a single floating point number.<\/td>\n<\/tr>\n
READ?<\/td>Return the current meter reading, only applies to the 1st channel\/stream\/dataset...<\/td>\n<\/tr>\n
SYST:BATT?<\/td>Get the meter's battery status, returns a single floating point value in %\/fully charged.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Read configuration options<\/h3>\n

Following a “CONF?”, the device answers with it’s current setting (i.e. voltage or frequency) and a few parameters. To request the configuration of a specific “channel”, send “CONF? @#” replacing the # with a number from 0 to 2. The type of voltage or current, or any subtype of measurement is appended to the basic setting with a semicolon. Additional parameters are separated from this basic information with a space, again separated by commas. Example: “VOLT:ACDC +1.00000000E+00,+1.00000000E-04” denotes an AC\/DC voltage-measurement with a range of 1 Volt an a maximum resolution of 0.1 mV. The following table will give some more detailed information:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Option<\/th>Meaning<\/th>\n<\/tr>\n<\/thead>\n
VOLT(:type)<\/td>The channel will return a voltage. When configured for DC voltage, it's just \"VOLT\". For AC, AC\/DC or DB(V\/M) measurements, the corresponding option follows with a semicolon, i.e. \"VOLT:ACDC\".
\n
\nAdditional parameters are the measurement rage in Volts and the value for the last (4th) digit (i.e. the precision). These parameters will not be returned for dBV or dBM measurements.<\/td>\n<\/tr>\n
CURR(:type)<\/td>Current measurement. Again, DC is the default without a semicolon, AC and ACDC are reported seperately.
\n
\nFor the mA\/A measurement range, there's an additional measurement mode displaying the current as a percentage between 0 mA\/4 mA and 20 mA, the corresponding return value is \"CPER:4-20mA\" or \"CPER:40-20mA\".
\n
\nParameters are range and precision.<\/td>\n<\/tr>\n
RES<\/td>Resistance, parameters are again range and precision.<\/td>\n<\/tr>\n
COND<\/td>Conductance measurement, parameters are range and precision.<\/td>\n<\/tr>\n
DIOD<\/td>Diode measurement, this setting doesn't seem to return any range or precision.<\/td>\n<\/tr>\n
CAP<\/td>Capacitance, parameters as for VOLT or CURR.<\/td>\n<\/tr>\n
CPER:(range)<\/td>\"Percentage Scale\". Probably made for adjustment measurements, displays a percentage of the measured current in the range of [4..20] mA or [0..20] mA. The range is given after the semicolon, i.e. \"CPER:4-20mA\". Additional parameters like for CURR.<\/td>\n<\/tr>\n
FREQ<\/td>Frequency in Hz, parameters are again range and precision. So far only seen for the second channel.<\/td>\n<\/tr>\n
PRES<\/td>The value of the frequency counter (channel 1). Does not return any reasonable range, only one parameter: 1 for direct counting, and 100 for a prescaler (divider) or 100.<\/td>\n<\/tr>\n
PULS:(type)<\/td>Pulse-Width measurement. Might return either a percentage of high-value to low-value (\"PULS:POUT\") or the pulse width directly (\"PULS:PWID\"). Ranges will show the values of the voltage measurement.<\/td>\n<\/tr>\n
TEMP:(type) (unit)<\/td>Temperature measurement, the only supported setting for the third channel.
\n
\nType might be either \"K\" or \"J\", depending on the configured type of the thermocouple - or \"ENV\" denoting the meter's environment measurement (channel 3).
\n
\nThe only parameter is the unit, either \"CEL\" for Celsius or \"FAR\" for Fahrenheit.<\/td>\n<\/tr>\n
CONT<\/td>Continuity measurement, similar to RES but with (if configured) audible tone on contact<\/td>\n<\/tr>\n
*E<\/td>Error, i.e. an unused channel.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Send configuration<\/h3>\n

Different “layers” of functionality for specific switch-positions can also be selected via Software. The device accepts two lines of configuration options after a “CLS*” command (I didn’t test it without), the possible options depend on the position of the rotary switch. An erroneous command will be acknowledged by “*E”, the configuration, however, might still be partially applied and might lead to instable operation (i.e. incomplete or overlapping data on the display). Success in changing the configuration will not trigger any response. Note that, upon selecting additional (calculated) quantities, those might become the primary reading; selecting AC-Voltage and Frequency for example will change the first channel to frequency, and reports the voltage on the second channel.<\/p>\n

Each switch position allows a different set of options, as can be seen in the following table:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Rotary Switch<\/th>Command<\/th>Meaning<\/th>\n<\/tr>\n<\/thead>\n
0 (V\/AC)
\n1 (Volt)
\n2 (mVolt)<\/td>		CONF:VOLT{:AC,:DC,:ACDC} (range)<\/td>Change the range of the AC voltage measured, possible parameters are 5, 50, 500 and 1000 (Volt each) or 0.1, 0.5 and 1 (also Volt, valid for position 2). Omit the range parameter to enable auto-range.
\n
\nParameters AC, DC and ACDC are only valid for switch-positions 1 and 2.<\/td>\n<\/tr>\n
CONF:FREQ<\/td>Measure the frequency additionally to the voltage, it will become the primary reading. Auto-range only.<\/td>\n<\/tr>\n
CONF:PULS:(type)<\/td>Measure pulse-width (primary). Possible types are PDUT\/NDUT (positive\/negative edged dutycycle in %) or PWID\/NWID (positive\/negative edged step-width in ms)<\/td>\n<\/tr>\n
CALC:FUNC {DBV,DBM}<\/td>Set the primary channel to read calculated dB\/V or dB\/M values<\/td>\n<\/tr>\n
3 (Resistance)<\/td>CONF:RES (range)<\/td>Configure the resistance measurement; ranges are none (auto), 500, 5k, 50k, 500k, 5M, 50M or 500M (Ohms each of course).<\/td>\n<\/tr>\n
CONF:COND<\/td>Measure conductance, only one range is supported and may not be configured (500 nS)<\/td>\n<\/tr>\n
CONF:CONT (range)<\/td>Measure continuity; accepts the same ranges like CONF:RES<\/td>\n<\/tr>\n
4 (Diode)<\/td>CONF:DIOD<\/td>Standard, set to Diode-measurement. Range is fixed to 2.1 V<\/td>\n<\/tr>\n
CONF:FCOU (range)<\/td>Select the frequency counter function. Range is either 1 for direct counting, or 100 to select a prescaler of 1\/100 to measure frequencies of up to 20 MHz<\/td>\n<\/tr>\n
5 (Capacitance)<\/td>CONF:CAP (range)<\/td>Set the range of the capacitance measurement, either none (Auto) or 10n, 100n, 1000n, 10u, 100u, 1000u, 10m or 100m (Farad each).<\/td>\n<\/tr>\n
CONF:TEMP (type),(unit)<\/td>Switch to temperature measurement. Type is either K or J for {K\/J}-Type thermocouples. Unit is either FAR-enheit or CEL-sius.<\/td>\n<\/tr>\n
SYST:TCOM (0, 1)<\/td>Enable \/ Disable 0\u00b0 compensation<\/td>\n<\/tr>\n
6 (\u00b5A)
\n7 (mA\/A)<\/td>		CONF:CURR{:AC,:DC,:ACDC} (range)<\/td>Set the current measurement to DC, AC or AC\/DC measurement and configure the range to autorange (none) or 500u, 5000u (\u00b5A) for position 6 (\u00b5A) or 0.05, 0.5 (A) for Position 7.<\/td>\n<\/tr>\n
CONF:CURR:PERC<\/td>Display the measured current as a percentage - no direct range parameter!<\/td>\n<\/tr>\n
SYST:CPER (range)<\/td>Configure the range of the Percentage Scale measurement - either \"0-20\" or \"4-20\" (mA each).<\/td>\n<\/tr>\n
for Additional parameters see Positions 0 to 2!<\/td>\n<\/tr>\n
(possibly) All<\/td>SYST:TENV (0, 1)<\/td>Enable \/ Disable measurement of the environment temperature, will be readable on channel 3<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

A few VIs exist already to configure the device using the above commands.<\/p>\n

Update: Configure PWM Output<\/h3>\n

The last available switch-position (#8) will allow you to operate a PWM output with 3 Volts\/peak and an instrumental precicion of 1\/256 of the frequency set. The device features three commands to program the PWM output. “CQU:FREQ X” sets the output frequency to X, possible options can be taken from the manual and range from 0.5 Hz to 4.8 kHz. The pulse width can be controlled from 0.39 % to 99.609 % \/ total, given in values from 1 to 255. The device has two commands to set the pulse width, “CQU:PWID X” will program the pulse width and display the value in ms, where as “CQU:DCYC X” will display the duty cycle in %.<\/p>\n

Code<\/h2>\n

The code including the sample program can be found on bitbucket<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Agilent’s U-Series Multimeters have the ability to be talked to via an infrared interface (and some of them even feature an OLED display), either through Agilent Keysight’s slightly overpriced USB-To-IR Adapter, or by building your own. If you intent to …<\/p>\n

Agilent U1253A with LabView<\/span> Read More »<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,7,4],"tags":[],"class_list":["post-129","post","type-post","status-publish","format-standard","hentry","category-english","category-labview","category-software"],"_links":{"self":[{"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/posts\/129","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=129"}],"version-history":[{"count":19,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/posts\/129\/revisions"}],"predecessor-version":[{"id":288,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=\/wp\/v2\/posts\/129\/revisions\/288"}],"wp:attachment":[{"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=129"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=129"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.nerdlingen.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=129"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}