flipit - control the X10 Firecracker (CM17A)
flipit [ -h ] [ -t tty ] [ flip [house code][device number] on|off ] [ dim [house code][device number] steps ] [ brighten [house code][device number] steps ] [ commands may repeat... ]
This document describes flipit version 0.1.3.
Flipit allows you to control X10 devices with your Unix computer by means of a Firecracker (model number CM17A) plugged into a serial port.
X10 is a method of transmitting control commands to devices over regular home power lines. The Firecracker is a device manufactured by X10 Ltd. See http://www.x10.com/ for product information.
For more information, see http://www.lickey.com/flipit/.
Prints help, version and the location of the configuration file.
Set the tty flipit will use. This is usually set in the configuration file.
Flip a device on or off.
Dim a device by a given number of steps.
Brighten a device by a given number of steps.
If everything goes well, flipit will exit with a value of zero. Upon error, it will print the reason why on stderr and exit with a non-zero exit value.
The following will turn device 5 in house code B on:
flipit flip b5 on
The following will first turn device 10 in house code C off, then turn device 16 in house code A on:
flipit flip c10 off flip a16 on
flipit reads the filename of the tty device to use from the flipit.conf file. The flipit.conf file is usually in the /usr/local/etc directory, but can be changed at compile time.
This is an ALPHA version of flipit. Not all features are implemented.
A similar and more full featured program is called BottleRocket.
Flipit doesn't create any lock files when accessing the tty.
Flipit does no security checking itself. If it finds that it can open the tty device named in flipit.conf it will be happy to do so.
Matt Armstrong <matt@lickey.com> http://www.lickey.com/flipit/