Vexed Logic!? - C#

.NET X10 CM17A (FireCracker) Control

Last year I started to explore different home automation possibilities and stumbled upon X10.  This looked like a cool solution since it doesn’t require any new wiring in the house, which I couldn’t do anyways since I’m renting.  It was also quite inexpensive, and there were plenty of sellers on eBay selling them for cheaper than X10.com.

My main purpose for this was just to control the lighting in my living room.  Since none of the lamps are on light switches, I was looking for a better way to turn them on and off.  With X10, I am able to use a remote to turn the lamps on/off and also brighten and dim them, which totally beats needing to turn each lamp on individually.

This was great, until I discovered…

FireCracker

So, yeah, the remote thing was cool, but then I found that there’s an X10 component called the FireCracker, which is a serial device that connects to a computer and is able to send X10 commands to the transceiver, much like the X10 remote does!

This definitely opens up some opportunities to further automate some tasks using X10, since I don’t even need to use the remote.

X10 provides some software that comes with the FireCracker; however, I figured if it was as visually-appealing and user-friendly as the X10 website, I’d look around for other options.  Thankfully, X10 published the specification for communicating with the FireCracker here.  This makes third party development much simpler :).

I looked around for some .NET libraries that I could just use, but a couple of them didn’t work, and one of them was written back in 2001 (here).  I ended up basing my development off of the one that was written in 2001.  This one actually did seem to work; it just had some outdated code in it.

VexedLogic.X10

So, after a couple of hours of updating some of the code to use the .NET Framework provided components to communicate with the serial port and various other tweaks, I have come up with a console application and library that is able to send X10 commands using the FireCracker.

FireCrackerCtl.exe

FirecrackerCtl.exe <ComPort> <HouseCode> <DeviceCode> <Command>

Available COM Ports: 1 2
HouseCodes: A-P
DeviceCodes: 1-16
Commands: On Off Bright Dim

The console application is straightforward.  Execute it providing the COM Port that the FireCracker is connected to, the house code and device code of the device, and the command to send to the device.

VexedLogic.X10.dll

The console application is essentially just a wrapper around the VexedLogic.X10.dll library.  This library can be referenced in any .NET 3.5 (or higher) application.

Here’s a sample usage of the DLL that turns device A1 on using a FireCracker on COM1:

public class Program
{
    private static void Main(string[] args)
    {
        X10Command cmd = new X10Command {
            HouseCode = 'A',
            DeviceCode = 1,
            Command = Firecracker.Commands.On };

        using (Firecracker firecracker = new Firecracker(1))
        {
            firecracker.SendCommand(cmd);
        }
    }
}

Download FirecrackerCtl.exe and VexedLogic.X10.dll

Posted in: C#

Tags: API, automation, C#, firecracker, x10

This entry was posted on Saturday, June 4th, 2011 at 3:02 pm and is filed under C#. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.