catec Li-Cor LI-830 Assembly Instructions

The LI-830 and LI-850
Integrator’s Guide
Turfschipper 114
2292 JB Wateringen
tel. : [phone]
e-mail : [email protected]
www.catec.nl

LI-830 and LI-850 Gas Analyzers
Integrator's Guide
LI-COR Biosciences
4647 Superior Street
Lincoln, Nebraska 68504
Phone: [phone]
Toll free: 800-447-3576 (U.S. and Canada)
envsale[email protected]om
Regional Offices
LI-COR Biosciences GmbH
Siemensstraße 25A
61352 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]
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
WARNING: 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
WARNING: 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.
1Launch 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.
2Connect 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 CO2
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

Removing XML tags
So far we've been viewing data inside the XML tags. If you simply want to see the
data without the enclosing XML tags, send this command:
<li850>
<rs232>
<strip>true</strip>
</rs232>
</li850>
The instrument will respond with the confirmation message:
<li850><ack>true</ack></li850>
and by streaming space-delimited text rather than XML text. Send this command to
return the data with XML tags:
<li850>
<rs232>
<strip>false</strip>
</rs232>
</li850>
The instrument will respond with the confirmation message and by streaming data
as XML text.
Reading the full dataset
Sending this command:
<li850>
<data>?</data>
</li850>
instructs the analyzer to send the most recent set of data values according to the cur-
rent configuration. You will only see data values that are set as true (see Enabling
and disabling an output variable on page1-5). In other words, you may see no data,
some data, or all of the data.
Section 1. Configuration grammar
1-7Removing XML tags

Section 1. Configuration grammar
Reading instrument settings
Previously we described how to configure the data that is sent over the serial port
(RS-232 or USB). Here we describe how to read the current settings in the instru-
ment. You may want to set the output rate (<outrate>) to 0 for these exercises.
The analyzer can be polled for individual sets of data by sending an XML document
with a ?in place of the set of elements requested. The element sets that can be
requested include the data set, the current configuration, and the entire state of the
instrument.
All settings
To receive the entire state of the instrument as an XML document (except the
<tech> information), send this command:
<li850>?</li850>
The instrument will reply with the full configuration followed by the confirmation
message.
Configuration settings
To receive all of the configuration information, send this command:
<li850>
<cfg>?</cfg>
</li850>
The instrument will return the current configuration, including heater status, filter
settings, DACs, and alarms, followed by the confirmation message. See Con-
figuration tags on page2-5 for the full description.
Zero and span settings
To receive the user-settable zero and span calibration settings, send:
<li850>
<cal>?</cal>
</li850>
The instrument will return the current zero and span calibration information,
including the dates of calibrations and the zero and span coefficients. See Cal-
ibration tags on page2-9 for the full description.
1-8 LI-830 and LI-850 Gas Analyzer Integrator's Guide

Polynomial settings
To receive the coefficients for the calibration polynomial function, send:
<li850>
<poly>?</poly>
</li850>
The instrument will return the factory-determined polynomial coefficients that are
unique to your instrument. See Polynomial tags on page2-10 for the full description.
Pump settings
To receive the pump settings, send:
<li850>
<pump>?</pump>
</li850>
If the LI-COR pump is installed, the instrument will return all of the pump set-
tings and the confirmation message. See Pump tags on page2-8 for the full descrip-
tion.
Optical source hours of operation
To receive the hours of operation for the optical source, send:
<li850>
<source>?</source>
</li850>
The instrument will return the number of hours on the source, followed by con-
firmation.
Serial number
To request the serial number of your instrument, send the following:
<li850>
<serialnum>?</serialnum>
</li850>
The instrument will return the serial number of the instrument, followed by con-
firmation.
Section 1. Configuration grammar
1-9Polynomial settings

Section 1. Configuration grammar
Software version
To request the software version, send:
<li850>
<ver>?</ver>
</li850>
The instrument will return the software version number.
1-10 LI-830 and LI-850 Gas Analyzer Integrator's Guide

Applying instrument settings
Here we describe how to apply some settings. Earlier we described how to set the
output rate. The output rate is a configuration:
<li850>
<cfg>
<outrate>1</outrate>
</cfg>
</li850>
You can also configure the other settings. For example, sending this command:
<li850>
<cfg>
<heater>false</heater>
</cfg>
</li850>
will turn the optical bench heater off and return a confirmation message. You nor-
mally don't want the heater off, so send this command to reenable it:
<li850>
<cfg>
<heater>true</heater>
</cfg>
</li850>
Controlling the pump
For instruments that are equipped with a LI-COR-installed pump, the pump con-
trols are in their own tag: <pump>. To enable the pump, send:
<li850>
<pump>
<enabled>true</enabled>
</pump>
</li850>
The instrument will respond with a confirmation message.
To disable the pump, send:
<li850>
<pump>
<enabled>false</enabled>
</pump>
</li850>
The instrument will respond with a confirmation message.
Section 1. Configuration grammar
1-11Applying instrument settings

Section 1. Configuration grammar
Calibrating the instrument
The analyzer CO2and H2O (LI-850 only) zeros and spans can be performed using
XML grammar. Just like when you calibrate with the software, be sure that a suit-
able calibration gas is flowing through the optical cell before changing a zero or
span. See the instruction manual for details. To request the calibration information
(optional), enter the following command:
<li850>
<cal>?</cal>
</li850>
The instrument will respond with the current calibration information and a con-
firmation message: <li850><ack>true</ack></li850>. If the calibration cannot
be performed, an error is returned: <li850><error>text</error></li850>.
1Set the CO2zero.
With suitable CO2-free air flowing through the analyzer cell:
ASend the command to initiate the zero. The date and concentration must be sent together.
<li850>
<cal>
<date>yyyy-mm-dd</date>
<co2zero>true</co2zero>
</cal>
</li850>
BWait for the acknowledgment.
When the zero is set the instrument will return confirmation. If the operation fails
the instrument will return an error message.
2Set the primary CO2span.
Using a CO2span gas with a known concentration of CO2in air:
ASend the command to initiate the span.
<li850>
<cal>
<date>yyyy-mm-dd</date>
<co2span>gas concentration</co2span>
</cal>
</li850>
BWait for the acknowledgment.
When the primary span is set the instrument will return confirmation. If the oper-
ation fails the instrument will return an error message.
1-12 LI-830 and LI-850 Gas Analyzer Integrator's Guide