NAME

plmpower - control Insteon/X10 devices via SmartLabs PLM 2412S

SYNOPSIS

plmpower --device serial-port

DESCRIPTION

plmpower is a helper program for powerman which enables communication with Insteon/X10 devices via SmartLabs Power Line Modem, model 2412S. It is run interactively by the powerman daemon. It can also be useful as a standalone tool for debugging X10/Insteon networks based on the above device.

NETWORK SETUP

Note the addresses of your Insteon/X10 devices. Plug the PLM into an AC outlet, preferably on the same electrical phase as the devices under control. Devices are available to bridge phases if this is not possible.

Attach the PLM's serial port to your computer, and ensure that nothing else is using the serial port such as the system console or getty(8). Run plmpower and try the interactive commands below to see if the devices respond reliably.

Once everything is working, configure powermand to run plmpower as a coprocess as described in powerman.conf(5).

OPTIONS

-d, --device serial-port: Specify the path to the special file connected to the PLM's serial port.
-t, --timeout msec: Set the Insteon timeout to the specified number of milliseconds (default 1000).
-x, --x10-attempts number: Set the number of times to run every X10 command (default 3). X10 does not provide an ACK/NAK mechanism like Insteon so we cannot be certain that any particular X10 command completed, therefore X10 commands are issued multiple times to increase confidence.

INTERACTIVE COMMANDS

The following commands are accepted at the plmpower> prompt. Address arguments may be Insteon (e.g. 1A.2B.3C) or X10 (e.g. G12).

help: Display help on the available commands.
info: Get info about the PLM.
reset: Reset the PLM (clears the all-link db).
on addr: Turn on device.
off addr: Turn off device.
status addr: Query status of device (Insteon only).
ping addr: Time round trip request/response to device (Insteon only).

FILES

/usr/local/sbin/plmpower
/usr/local/etc/powerman/powerman.conf

ORIGIN

PowerMan was originally developed by Andrew Uselton on LLNL's Linux clusters. This software is open source and distributed under the terms of the GNU GPL.