TEMPS1(1)							     TEMPS1(1)



NAME
       tempS1 - 1-Wire network temperature communication

SYNOPSIS
       tempS1 [-d device] [-i] [-l lockfile] [-n serial_number=alias] [-o outfile] [-s seconds]

DESCRIPTION
       TempS1	is   for  interrogating  temperature  transducers,  (like  the
       Maxim/Dallas Semiconductor DS18S20 1-Wire Digital  Thermometer,)  on  a
       1-wire  network	through a Maxim/Dallas Semiconductor DS9097U Universal
       COM Port Adaptor, (or equivalent,) serial port connection.

       The default port is /dev/ttyS1. The  default  semaphore	lock  file  is
       /var/lock/LCK..ttyS1, which has an fcntl(2) advisory lock applied.

       As an example usage:

	   tempS1 -s 360 -o /var/log/temperature/temperature.log \
		  -n AA0008014C02A810=John -n 670008014C733C10=DataC \
		  -n 520008014BEBD210=Attic -n 7200080194479610=Ambient \
		  -n 3700080193FE8910=Den

       would  log  the temperature in the file temperature.log on the 6 minute
       marker from the system clock, (i.e., at 0, 6, 12, 18 ... minutes  after
       the hour,) for the 5 devices, using the device aliases in the log file;
       the log file is a tab delimited flat database text  file,  collated  in
       temporal order.

OPTIONS
       -d device
	      Device name, (/dev/ttyS1).

       -i     Scan the 1-wire port for device serial numbers.

       -l lockfile
	      Lock file name, (/var/lock/LCK..ttyS1).

       -n serial_number=alias
	      Device serial number(s) and alias(es), one per device.

       -o outfilename
	      Output filename, (stdout).

       -s seconds
	      Time interval to wait between temperature readings.

       -v     Print the program's version information

WARNINGS
       The  termios(3)	and fopen(2) settings tested only on Linux 2.4. Porta-
       bility to systems other than Linux may be problematical. The  semaphore
       locking	mechanism  uses fcntl(2), and may not be compatible with other
       serial programs.

SEE ALSO
       tempS0(1), tempS1(1).

DIAGNOSTICS
       Error messages for  incompatible  arguments,  inaccessible  files,  and
       opening and closing files.

AUTHORS
       ----------------------------------------------------------------------

       A license is hereby granted to reproduce this software source code and
       to create executable versions from this source code.  The copyright
       notice included with the software must be maintained in all copies
       produced.

       THIS PROGRAM IS PROVIDED "AS IS". THE AUTHOR PROVIDES NO WARRANTIES
       WHATSOEVER, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF
       MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE.  THE
       AUTHOR DOES NOT WARRANT THAT USE OF THIS PROGRAM DOES NOT INFRINGE THE
       INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY IN ANY COUNTRY.

       Copyright (c) 1994-2008, John Conover, All Rights Reserved.

       Comments and/or bug reports should be addressed to:

	   john@email.johncon.com (John Conover)

	   http://www.johncon.com/

       ----------------------------------------------------------------------



			      September 10, 2008		     TEMPS1(1)