Package org.lsst.ccs.drivers.lighthouse

Contains code to run the 2016, 3016 and 5016 family of airborne particle counters from Lighthouse Worldwide Solutions.

See: Description

Interface Summary

Interface	Description
Hardware	Provides low-level hardware operations.

Class Summary

Class	Description
ASCIIModbus	Very simple ASCII Modbus communications, just good enough for the Lighthouse particle counter.
ChannelDatum	Represents a single channel datum from a Lighthouse counter.
Client	Encapsulates requests made of Lighthouse particle counter.
DataRecord	Represents a single data record from a Lighthouse particle counter.
LighthouseDriver	Shell command driver.

Enum Summary

Enum	Description
ChannelType	The kinds of things Lighthouse data channel might measure.
ChannelUnits	The measurement units for Lighthouse data channels.
DataChannel	The data channels we can read from a Lighthouse counter.
DeviceCommand	The hardware commands used by this software.
DeviceFlag	The status flags that can be set for a Lighthouse counter device.
RecordFlag	The device status flags that can be set for a Lighthouse data record.

Package org.lsst.ccs.drivers.lighthouse Description

Contains code to run the 2016, 3016 and 5016 family of airborne particle counters from Lighthouse Worldwide Solutions. Developed and tested using the Handheld 3016-IAQ.

The device measures the density of airborne particles of various sizes. The models purchased for the LSST I&T clean room have attachments for the measurement of temperature and relative humidity as well.

There's a driver, LighthouseDriver, which can be run as a CCS command-line application using the script run-counter.sh. The class Client represents a single device.

Remote control is via the ASCII variant of the Modbus protocol over an RS-232C line. Modern versions of the device come with an FTDI USB-to-serial conversion cable that's USB-A on one end and RJ-45 on the other. The code in this package is written assuming that the FTDI cable appears as USB serial port; for that to happen your Linux system must have the ftdi_sio and usbserial modules installed.

The comm parameters for the serial port are fixed by Lighthouse: raw tty mode, 19200 bps, eight data bits, no parity, one stop bit. This software doesn't attempt to set comm parameters. Also, each counter is assumed to be on its own cable and to have a Modbus slave ID of 1.

Despite the settings of the built-in display, the particle counts read from the device are always raw, cumulative counts. For example, a value of 2259 for the 1.0-micron counter channel indicates that during the sample period the device counted 2259 particles of size 1.0 microns or larger.

Although the display may show temperature in degrees Celsius or Fahrenheit, temperatures read from the device are always in degrees Fahrenheit.