9c0cd3f9df
This will make a number of things easier in the future, as well as (finally!) avoiding the Id-smashing problem which has plagued developers for so long. Boy, I'm glad we're not using sup anymore. This update would have been insane otherwise.
113 lines
3.6 KiB
Groff
113 lines
3.6 KiB
Groff
.\" Copyright (c) 1992, 1993 Eugene W. Stark
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by Eugene W. Stark.
|
|
.\" 4. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY EUGENE W. STARK (THE AUTHOR) ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
|
|
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Th XTEN 8 "30 Oct 1993"
|
|
.Dd Oct 30, 1993
|
|
.Dt XTEN 1
|
|
.Os BSD FreeBSD
|
|
.Sh NAME
|
|
xten \- transmit X-10 commands
|
|
.Sh SYNOPSIS
|
|
.Nm xten
|
|
[ - ] house key[:cnt] [ [ house ] key[:cnt] .\|.\|. ]
|
|
.Sh DESCRIPTION
|
|
.Nm Xten
|
|
is a command-line interface to the X-10 daemon.
|
|
When invoked with a one-letter house code (A-P) and a series of key/unit
|
|
codes as arguments, it requests the X-10 daemon to transmit a corresponding
|
|
series of X-10 packets. The X-10 daemon makes its best effort to ensure
|
|
that the packets are all transmitted correctly, though in general it is
|
|
not possible to tell whether the commands were actually received and
|
|
executed by the remote X-10 devices.
|
|
.Pp
|
|
When invoked with the single argument \-,
|
|
.Nm xten
|
|
enters an interactive mode in which a line is repeatedly read from the
|
|
standard input, sent to the X-10 daemon, and the one-line response from
|
|
the daemon printed on the standard output.
|
|
.Sh OPTIONS
|
|
The
|
|
.I
|
|
house
|
|
argument is a one-letter house code in the range A-P.
|
|
All the X-10 requests generated will refer to this house code.
|
|
Each
|
|
.I
|
|
key
|
|
is either a numeric unit code in the range 1-16, or else
|
|
is a string that specifies an X-10 function. The possible
|
|
function code strings are:
|
|
.Bl -diag
|
|
.It AllUnitsOff
|
|
.It AllLightsOn
|
|
.It On
|
|
.It Off
|
|
.It Dim
|
|
.It Bright
|
|
.It AllLightsOff
|
|
.It ExtendedCode
|
|
.It HailRequest
|
|
.It HailAcknowledge
|
|
.It PreSetDim0
|
|
.It PreSetDim1
|
|
.It ExtendedData
|
|
.It StatusOn
|
|
.It StatusOff
|
|
.It StatusRequest
|
|
.El
|
|
.Pp
|
|
Each
|
|
.I
|
|
key
|
|
may be followed by an optional numeric
|
|
.I
|
|
cnt,
|
|
which specifies the number of packets that are to be sent with that
|
|
key code without gaps. If this argument is omitted, two packets
|
|
are transmitted. The ability to specify numbers of packets other than
|
|
two is used by the X-10
|
|
.I
|
|
Dim
|
|
and
|
|
.I
|
|
Bright
|
|
commands.
|
|
.Sh SEE ALSO
|
|
.Xr xtend 8 ,
|
|
.Xr tw 4
|
|
.Sh FILES
|
|
.Bl -tag -width /var/spool/xten/Status -compact
|
|
.It Pa /dev/tw0
|
|
the TW523 special file
|
|
.El
|
|
.Sh AUTHOR
|
|
Eugene W. Stark (stark@cs.sunysb.edu)
|