1 .\" Copyright (c) 1992, 1993 Eugene W. Stark
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by Eugene W. Stark.
15 .\" 4. The name of the author may not be used to endorse or promote products
16 .\" derived from this software without specific prior written permission.
18 .\" THIS SOFTWARE IS PROVIDED BY EUGENE W. STARK (THE AUTHOR) ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
22 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 .\" $FreeBSD: src/usr.sbin/xten/xten.1,v 1.9.2.3 2002/06/21 16:42:43 charnier Exp $
37 .Nd transmit X-10 commands
42 .Ar key Ns Op : Ns Ar cnt
45 .Ar key Ns Op : Ns Ar cnt
51 utility is a command-line interface to the X-10 daemon.
52 When invoked with a one-letter house code (A-P) and a series of key/unit
53 codes as arguments, it requests the X-10 daemon to transmit a corresponding
54 series of X-10 packets. The X-10 daemon makes its best effort to ensure
55 that the packets are all transmitted correctly, though in general it is
56 not possible to tell whether the commands were actually received and
57 executed by the remote X-10 devices.
59 When invoked with the single argument
62 enters an interactive mode in which a line is repeatedly read from the
63 standard input, sent to the X-10 daemon, and the one-line response from
64 the daemon printed on the standard output.
68 argument is a one-letter house code in the range A-P.
69 All the X-10 requests generated will refer to this house code.
72 is either a numeric unit code in the range 1-16, or else
73 is a string that specifies an X-10 function. The possible
74 function code strings are:
96 may be followed by an optional numeric
98 which specifies the number of packets that are to be sent with that
99 key code without gaps. If this argument is omitted, two packets
100 are transmitted. The ability to specify numbers of packets other than
101 two is used by the X-10
110 .Bl -tag -width /var/spool/xten/Status -compact
112 the TW523 special file
115 .An Eugene W. Stark Aq stark@cs.sunysb.edu