catec Li-Cor LI-830, Li-Cor LI-850 Integrator Manual

The LI-830 and LI-850
Integrator’s Guide

Turfschipper 114

2292 JB Wateringen

tel. : [phone]

e-mail : [e-mail]

www.catec.nl

LI-830 and LI-850 Gas Analyzers

Integrator's Guide

LI-COR Biosciences

464 7 Superior Street
Lincoln , Nebraska 6850 4
Phone: [phone]
Toll free: 800-447-3 576 (U.S. and Canada)
[e-mail]

Regional Offices

LI-COR Biosciences GmbH

Siemensstraße 25A
613 52 Bad Homburg
Germany
Phone: [phone]
[e-mail]

LI-COR Biosciences UK Ltd.

St. John’s Innovation Centre
Cowley Road
Cambridge
CB4 0WS
United Kingdom
Phone: [phone]
[e-mail] m

LI-COR Distributor Network:

www.licor.com/env/distributors

Notice

The information in this document is subject to change without notice.

LI-COR MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING BUT NOT
LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
LI-COR shall not be held liable for errors contained herein or for incidental or consequential damages in connection with
the furnishing, performance, or use of this material.

This document contains proprietary information, which is protected by copyright. All rights are reserved. No part of this
document may be photocopied, reproduced, or translated to another language without prior written consent of LI-COR,
Inc.

Microsoft, Windows, and Excel are registered trademarks of the Microsoft Corporation. Drierite is a registered trademark
of the W.A. Hammond Drierite Company. Fetch is a registered trademark of Fetch Softworks LLC. Excelon Bev-a-line is a
registered trademark of Thermoplastic Processes, Inc. Propafilm is a trademark of Innovia Films. All other trademarks
and registered trademarks are property of their respective owners.

Printing History

© Copyright 2017, LI-COR, Inc.

Publication Number: 977-17191

Created on Wednesday, January 24, 2018

Notes on Safety

This LI-COR product has been designed to be safe when operated in the manner described in this manual. The safety of
this product cannot be guaranteed if the product is used in any other way than is specified in this manual. The product is
intended to be used by qualified personnel. Read this entire manual before using the product.

Equipment markings:

The product is marked with this symbol when it is necessary for you to refer to the manual or
accompanying documents in order to protect against injury or damage to the product.

The product is marked with this symbol when a hazardous voltage may be present.

The product is marked with this symbol if a Chassis Ground connection is required.

WARNING

Warnings must be followed carefully to avoid bodily injury.

CAUTION

Cautions must be observed to avoid damage to your equipment.

Manual markings:

WARNING

Warnings must be followed carefully to avoid bodily injury.

CAUTION

Cautions must be observed to avoid damage to your equipment.

NOTE

Notes contain important information and useful tips on the operation of your equipment.

ii

iii

CE Marking:

This product is a CE-marked product. For conformity information, contact LI-COR Support at [e-mail].
Outside of the U.S., contact your local sales office or distributor.

California Proposition 65 Warning

WARN ING: This product contains chemicals known to the State of California to cause cancer and birth defects or other
reproductive harm.

Federal Communications Commission Radio Interference Statement

WARN ING: This equipment generates, uses, and can radiate radio frequency energy and if not installed in accordance
with the instruction manual, may cause interference to radio communications. It has been tested and found to comply
with the limits for a Class A computing device pursuant to Subpart J of Part 15 of FCC rules, which are designed to
provide a reasonable protection against such interference when operated in a commercial environment. Operation of this
equipment in a residential area is likely to cause interference in which case the user, at his own expense, will be required
to take whatever measures may be required to correct the interference.

Waste Electronic and Electrical Equipment (WEEE) Notice

This symbol indicates that the product is to be collected separately from unsorted municipal waste. The fol­lowing applies to users in European countries: This product is designated for separate collection at an
appropriate collection point. Do not dispose of as household waste. For more information, contact your
local distributor or the local authorities in charge of waste management.

iv

v

Contents

Section 1. Configuration grammar

About XML communications 1-1
Types of data 1-2
Connecting over a terminal program 1-3
Sending a command 1-4
Reading data from the instrument 1-5

Configuring the output rate 1-5
Enabling and disabling an output variable 1-5
Turning off all output variables except CO2 1-6
Removing XML tags 1-7
Reading the full dataset 1-7

Reading instrument settings 1-8

All settings 1-8
Configuration settings 1-8
Zero and span settings 1-8
Polynomial settings 1-9
Pump settings 1-9
Optical source hours of operation 1-9
Serial number 1-9
Software version 1-10

Applying instrument settings 1-11

Controlling the pump 1-11
Calibrating the instrument 1-12
Configuring the alarms 1-14
Configuring the analog outputs 1-15

Section 2. Element descriptions

Data tags 2-2

Raw data tags 2-3

Auxiliary data tags 2-3

RS-232 serial tags 2-4

Configuration tags 2-5

Alarm tags 2-6
DAC tags 2-7

Pump tags 2-8
Source tag 2-8
Calibration tags 2-9
Polynomial tags 2-10

Tech tags 2-11
Full XML grammar 2-12

Appendix A. Supplemental information

Serial cable pin assignments A-1
Circuit board connector A-1
Details on the serial connection A-3

Serial communication parameters A-3
Finding your Windows serial port A-3
Connecting with a Windows terminal program A-3
Connecting with a Mac terminal program A-4

vi

Section 1.

Configuration grammar

The LI-830 and LI-850 can communicate with a computer or a system controller
through a serial connection (either the RS-232 or USB output). The following dis­cussion describes how to implement the communication protocol. To help facil­itate this discussion, this document will rely exclusively on a terminal program to
communicate with the gas analyzer. To use this document, download and install a
terminal program on your computer. We give examples using TeraTerm for Win­dows and Serial for Mac, but nearly any terminal program will work.

About XML communications

The configuration grammar used to communicate with the analyzer is based upon
the eXtensible Markup Language (XML). XML relies on the use of tags to
"Markup", or give structural rules to a set of data.

A tag is a descriptive identifier enclosed between a less than (<) and a greater than
(>) symbol, used in part to describe a piece of data. For example, <name> is a tag
that describes a person's name. Each tag must have a corresponding end tag,
denoted by '/'. Extending the example above, the end tag of <name> is </name>.

Elements are the basic unit of XML content. An element consists of a start tag and
an end tag, and everything in between. For example, consider the following ele­ment:

<name>george</name>.

In this example, <name> (start tag) and </name> (end tag) comprise the markup,
and "george" comprises the data. Because XML is extensible, tags can be defined
specifically for the data they are meant to describe.

Elements can also contain other elements other than data.

1-1LI-830 and LI-850 Gas Analyzer Integrator's Guide

Section 1. Configuration grammar

<name>

<first>george</first>
<last>smith</last>

</name>

In this example, the outermost element <name> encompasses two other elements
that contain data. All elements combined make up the XML document.

The LI-830 and LI-850 communications are not case sensitive. So, your commands
can be upper case, lower case, or a combination of upper and lower case if you are
so inclined. The instruments do not interpret upper case commands as yelling, in
the way that people often do.

Types of data

An element includes a start tag, end tag, and the data inside the tags. The data can
take any of the forms described in Table 1-1 below.

Value Description Example

{val | val |...} The value will be a member of the specified set. In this

document, the vertical bar (|) means "or".

2.5 | 5

{bool} Boolean values. TRUE | FALSE
{float} Floating point values in decimal or exponential notation. 3.1415927
{int} Integers. 25
{iso date} Date in the International Organization for Standards (ISO)

format: 4-digit year, 2-digit month, and 2-digit day.

2017-11-07

{string} A sequence of characters HGA-4234
'?' The question mark, when sent in the XML, requests all

values for that XML tag.

Table 1-1. The types of information sent in the XML grammar.

1-2 LI-830 and LI-850 Gas Analyzer Integrator's Guide

Connecting over a terminal program

To connect with the analyzer, power it on and connect the USB cable between the
analyzer and your computer. Or, connect to the board as described in Circuit board
connector on pageA-1.

1

Launch the terminal program.

In this example, we use TeraTerm for Windows and Serial for Mac. In either case,
you can select from the devices that are connected to the computer.

2

Connect with the instrument.

In TeraTerm on Windows:

Launch the TeraTerm app. Select Serial,
select the port called COM#: USB Serial

Port (COM#), then click OK.

In Serial on Mac:

Launch the Serial app. It will open a
window that lists all of the devices.
Select LI-830/850 and click Open.

You may or may not see data stream into the terminal program immediately,
depending on the current instrument configuration.

The default configuration for serial communication is given in Details on the serial
connection on pageA-3.

Section 1. Configuration grammar

1-3Connecting over a terminal program

Section 1. Configuration grammar

Sending a command

It can be a bit tricky to send commands if you're unfamiliar with terminal pro­grams. Here are some tips that might help you get started:

Note: The root tag for the LI-850 is <li850> and the root tag for the LI-830 is

<li830>. We use <li850> throughout most of this document.

In TeraTerm on Windows:

Select the text below:

<li850>?</li850> or
<li830>?</li830>

and copy it to the clipboard (Ctrl + C).

In TeraTerm, click Edit > Paste <CR> to
open a clipboard window, where you
can edit the command.

Click OK to submit the command.

In Serial on Mac:

Click Terminal > Send String.

Type (or copy and paste) the com­mand into the interface.

<li850>?</li850> or
<li830>?</li830>

Click Send to submit the command.

The instrument will reply by returning the entire configuration as XML.

Note: A simple way to write the commands is to copy the text from this doc­ument or type the command into a text editor and copy the text to your clipboard
(select the text and press Ctrl+C). Then right-click in the terminal window and
paste the command (or press Ctrl+V).

1-4 LI-830 and LI-850 Gas Analyzer Integrator's Guide

Reading data from the instrument

This section describes how to view measurements from the instrument in a ter­minal program.

Configuring the output rate

Copy the following command and paste it into the TeraTerm window:

<li850>

<cfg>

<outrate>1</outrate>

</cfg>

</li850>

This will configure the instrument to send one measurement per second. The
instrument will respond with a confirmation message (<li850><ack-

>true</ack></li850>) and by sending data once per second. You still may not see

data however, depending on the instrument settings.

Enabling and disabling an output variable

To include the CO2reading among the data sent from the instrument, copy the fol­lowing command and paste it into the TeraTerm window:

<li850>

<rs232>

<co2>true</co2>

</rs232>

</li850>

This will configure the instrument to send the CO2measurement. After sending
the command you will see the confirmation message and other variables in addi­tion to CO2, depending upon the instrument settings. The confirmation message is

<li850><ack>true</ack></li850>.

To exclude the CO2reading from the data, send this command:

<li850>

<rs232>

<co2>false</co2>

</rs232>

</li850>

CO2will no longer be returned. You will still see all the measurements that are
configured as TRUE but not specified here.

Section 1. Configuration grammar

1-5Reading data from the instrument

Section 1. Configuration grammar

Turning off all output variables except CO

2

Send this command to stop the instrument from sending all the measurements
except CO2and to send CO2once per second:

<li850>

<cfg>

<outrate>1</outrate>
</cfg>
<rs232>

<co2>true</co2>

<flowrate>false</flowrate>

<h2o>false</h2o>

<celltemp>false</celltemp>

<cellpres>false</cellpres>

<ivolt>false</ivolt>

<co2abs>false</co2abs>

<h2oabs>false</h2oabs>

<h2odewpoint>false</h2odewpoint>

<raw>false</raw>

<echo>false</echo>

<strip>false</strip>
</rs232>

</li850>

It may be evident by now that the TRUE command means do send; whereas the
FALSE command means do not send. Also, here we included the command to con­figure the output rate to once per second.

1-6 LI-830 and LI-850 Gas Analyzer Integrator's Guide