Monday, March 8, 2010

Adventures in X10 Home automation with iphone and JQTouch

This year my tax return was big. It let me afford to purchase some things that I've wanted to play with for a while now, not the least of which the cm19a X10 RF controller like this one here

http://www.thehomeautomationstore.com/cm19a.html

I think this device is probably anyone's best bet for this sort of thing as it does not interface directly with any sort of power outlet so you don't have to worry about some sort of freak occurrence happening and destroying your precious, precious computer.

This means though that you will also need to purchase the transceiver module

http://www.thehomeautomationstore.com/tm751.html

then of course you will want at least one or more lamp/appliance modules

X10 is sort of the old man at the table of home automation, so there's plenty of documentation on how it does what it does, not to mention hard ware and modules are pretty reasonable compared to the newer standards like Z-wave.

the beauty of this little device is it is supported in linux with control via the command line.

to achieve this we first get the most recent driver from here

http://lemaymd.com/drupal/node/3

extract the files to your home directory
(I'm using Ubuntu 9.10)

go ahead an plug in the device to an open USB port and confirm that the computer sees it

$ lsusb

...
Bus 005 Device 002: ID 0bc7:0002 X10 Wireless Technology, Inc. Firecracker Interface (ACPI-compliant)
...


To build the modules make sure you have the build-essential package installed

$ sudo apt-get install build-essential

then

$ cd x10-cm19a-0.1.1/

$ sudo make
$ sudo make install

if everything went well, it should compile with out any major complications or errors

if it didn't, or you feel like you need to recompile the module, be sure to run sudo make clean before trying again.


but now we are faced with some kernel confusion. Stock builds of Ubuntu will more then likely think the cm19a is some sort of ir receiver device or other kind of remote control. To set it straight we add these modules to the kernel module blacklist

$ sudo gedit /etc/modprobe.d/blacklist.conf

add these lines

blacklist lirc_atiusb
blacklist ati_remote

save and close
then remove the modules from the current state of the kernel

$ sudo rmmod lirc_atiusb
$ sudo rmmod ati_remote

then to add the cm19a module

$ sudo modprobe x10-cm19a

There may be some plugging and unplugging but you should see your new device show up in /dev

$ ls /dev/c*

/dev/cm19a0

if you don't see it here now, a reboot may solve the issue, or you can add some rules to udev to make sure it gets inserted with the right permissions and or other custom parameters. Check this post out for more on that

http://pr0gr4mm3r.com/linux/getting-your-x10-cm19a-module-working-in-linux/

if everything worked you should now be able to write commands directly to the device in this manner to turn off the X10 module with house code A unit code 5

$ echo -A5 > /dev/cm19a0

this does not give you any direct feedback though, so for debugging dmesg and syslog are your friend

open up a new terminal of your choice and run either

$ dmesg | tail

or

$ tail -f /var/log/syslog

(passing the -f flag to tail will let tail follow the file as new lines come in)

you should see something like


Mar 8 11:02:08 ubunbox kernel: [164153.964339] x10-cm19a: devf_write called with buffer length 4
Mar 8 11:02:08 ubunbox kernel: [164153.964346] x10-cm19a: got off command
Mar 8 11:02:08 ubunbox kernel: [164153.964348] x10-cm19a: house code A
Mar 8 11:02:08 ubunbox kernel: [164153.964351] x10-cm19a: unit = 1
Mar 8 11:02:08 ubunbox kernel: [164153.964354] x10-cm19a: Created HA command: off a 1
Mar 8 11:02:08 ubunbox kernel: [164153.964357] x10-cm19a: Transmitting 5 byte command:
Mar 8 11:02:08 ubunbox kernel: [164153.964360] x10-cm19a: buf[0] = 20
Mar 8 11:02:08 ubunbox kernel: [164153.964363] x10-cm19a: buf[1] = 60
Mar 8 11:02:08 ubunbox kernel: [164153.964365] x10-cm19a: buf[2] = 9F
Mar 8 11:02:08 ubunbox kernel: [164153.964368] x10-cm19a: buf[3] = 20
Mar 8 11:02:08 ubunbox kernel: [164153.964370] x10-cm19a: buf[4] = DF
Mar 8 11:02:08 ubunbox kernel: [164153.964376] x10-cm19a: wrote command
Mar 8 11:02:08 ubunbox kernel: [164153.964379] x10-cm19a: read back interrupt data
Mar 8 11:02:08 ubunbox kernel: [164153.964382] x10-cm19a: devf_write: back from x10_transmit_cmd
Mar 8 11:02:08 ubunbox kernel: [164153.966694] x10-cm19a: freeing buffer in callback (0xf685e020/0x3685e020)


So now that you have command line access to any X10 enabled appliance in your house, the next thing you want to do is set up some server side script to make access from mobile devices possible

this is a quick and dirty PHP file that takes arguments via http GET requests
By reading further you acknowledge that I am in no way responsible for any undesired effects!!!
but feel free to use it to whatever legal ends you see fit

Put this in some protected web directory in whatever php capable server you are running.

see .htaccess for more on using basic authincation to protect files and directories under apache

Some might also notice that I am using the command line backticks here. You can read up about this on the official PHP.org site to get more info on alternative methods for running cli commands and the potential security risks

<?
####
#Scott Cheezem
#03052010
###
#h - the house code
#u - the unit code
#s - the state 1 for on 0 for off
function check($ch){
#echo "checking $ch";
if (isset($_GET[$ch]) && strlen($ch) == 1){

return true;
}
}


if (check('h') && check('u') && check('s')){
$h=$_GET['h'];
$u=$_GET['u'];
$s=$_GET['s'];
if($s=="0"){
$s="-";
}else if($s=="1"){
$s="+";
}
$ts=`date`;
$command="echo ".$s.$h.$u." > /dev/cm19a0";
#echo $command;
`$command`;
$log=`echo "$ts $command" >> x10.log`;
}

?>

after that is done check to make sure everything is working as it should up to this point...

try going to

http://ip.address.of.your.computer/path/to/file/whateverYouCalledIt.php?h=A&u=1&s=1

and it should turn on house code A, unit code 1


and now the pay off!!!!

the next layer in this delicious cake of home automation is your interface.... Your iphone interface!!!

I have a working version of a webapp I call liveHouse. feel free to check it out here on your ipod touch/iphone/Safari (even windows safari works! YAY!)

http://user.theroyalwe.net/liveHouse









if you want to download the code to use on your own server go here

http://user.theroyalwe.net/liveHouse.zip


click the plus in safari and then add to home screen to install on your device











(note: in the case of webapps like this one, all the javascript CSS images and html are cached locally to your phone. when ever you run the app, it will check automatically for any updates to the code and download them. really,who needs the app sotre!?!)

this app was developed with jquery and the jqtouch extension.

more info on jqtouch here

http://code.google.com/p/jqtouch/

NOTE: this is just the first working draft. The control script url (the php file we made earlier) and optional login credentials are stored in a cookie in plain text. For anyone planning on using this from behind their home network, this should be fine. I would not recommend using this script from outside your local area network if security is an issue!!!


Cheers and Happy home-atuomating!!!