RE: X10

["Patrick Lidstone \(Personal e-mail\)" <patrick@xxxxxxxxxxxx>]

------=_NextPart_000_0003_01C4508E.14E64570
Content-Type: text/plain;
charset="US-ASCII"
Content-Transfer-Encoding: 7bit


To turn device L1 on, you need to send a message which looks like this:

xap-header
{
v=12
hop=1
uid=FF123400
class=xap-x10.request
source=acme.my.controller
target=rocket.cm12u.home
}
xap-x10.request
{
command=on
device=L1
}

or to turn device L1 off you need to send a message which looks like
this:

xap-header
{
v=12
hop=1
uid=FF123400
class=xap-x10.request
source=acme.my.controller
target=rocket.cm12u.home
}
xap-x10.request
{
command=off
device=L1
}

You can use xap-send to originate messages like this from a text file.
The docs folder for
my CM12U connector contains these messages as text files which you can
send direct
from the command line using:

xap-send L1_on.xap

or

xap-send L1_off.xap

You can invoke either of these as a scheduled event under windows using
the windows
scheduler (or a cron job under linux). I wrote a simple scheduler
program as well as while
back, which will also do the same job - let me know if you want
instruction on how to
set it up.

Patrick

-----Original Message-----
From: Steve Nye [mailto:steve@xxxxxxx]
Sent: 12 June 2004 14:42
To: xap_automation@xxxxxxx
Subject: RE: [xap_automation] X10


Given I am new to thsi how do I send a message to turn a particular
device on or off?

Is it possible to set up a schedule of events that turn lights on and
off?

Steve

-----Original Message-----
From: Edward Pearson [mailto:edward.mailgroup@xxxxxxx]
Sent: 08 June 2004 00:54
To: xap_automation@xxxxxxx
Subject: RE: [xap_automation] X10


Stuart has shamed me into doing a little schema documentation :-/

(Patrick, please comment on any inaccuracies, this was determined by a
combination of your documentation and source code)



There are currently (June 2004) two xAP X10 connectors,
both of which support the CM11 and CM12 X10 adaptors.

1) by Patrick Lidstone is written for Linux (or Windows via CYGWin)
2) by Edward Pearson for Windows .NET v1.1 using xAP Framework by Stuart
Booth

both connectors support the following core schema:

class=xap-x10.request

-- sent from xAP to X10

xap-x10.request
{
command=(on  off)
-- mandatory
device=(X10 device being addressed eg, A1  B8  M10 etc)
-- mandatory
}
or
xap-x10.request
{
command=(bright  dim)
-- mandatory
device=(X10 device being addressed eg, A1  B8  M10 etc)
-- mandatory
count=(0-100)
-- mandatory
}

class=xap-x10.event

-- sent from X10 to xAP

xap-x10.event
{
event=(on  off)
-- mandatory
device=(X10 device active eg, A1  B8  M10 etc)
-- mandatory
}
or
xap-x10.event
{
event=(dim  bright)
-- mandatory
device=(X10 device active eg, A1  B8  M10 etc)
-- mandatory
count=(0-100)
-- mandatory
}

Patrick's connector also reports the following events:

all_lights_on, all_lights_off, all_units_off

Due to a pointless clash of keyword styles, Edward's connector reports
these as:

AllLightsOn, AllLightsOff, AllUnitsOff

apologies, these will be brought into line shortly :-/


Edward's connector supports the following extension to the core schema:

1) Multiple xAP addressed devices

A comma separated list of devices can be specified for the device
parameter
of the request message. For example:

xap-x10.request
{
command=on
device=A1,A2,B7,M10
}

Devices on the same house code will be addressed as a set and then
'commanded',
devices on separate house codes will be treated in alphabetical order.

2) Consolidation of multiple X10 addressed devices

Multiple devices will also be reported for event messages if more than
one
device is addressed and commanded (on a single house code) by another
X10 controller, eg:

xap-x10.event
{
command=on
device=B3,B5
}



-----Original Message-----
From: Stuart Booth [mailto:lists@xxxxxxx]
Sent: 07 June 2004 20:46
To: xap_automation@xxxxxxx
Subject: Re: [xap_automation] X10


Hi Steve,

I'm not sure how much you've worked out yet already, so I'll pop in
with some answers you may or may not already know. Hope at least a bit
of this will be useful !!

On Mon, 7 Jun 2004 20:25:49 +0100, "Steve Nye"
<steve@xxxxxxx> wrote:

>I am new to this and like the concept of multiple applications being
able to
>exchange information via a central hub.

In actual fact the central hub is only required on a PC running
multiple applications, so that all applications can hear the same
thing. You'll of course need one per PC on the network. Other
xAP-enabled devices plugged into the network (be it an Ethernet,
serial cable link, or wireless network) can send and receive messages
independently because everybody broadcasts their messages to
absolutely everybody else.

> However I am not really sure how to
>get started. I suppose for me control of my X10 devices would seem a
good
>intitial step forward.

If you've not played with any xAPplications yet, my own 'getting
started with some useful tools' was posted here:

http://groups.yahoo.com/group/xap_automation/message/714

This details getting the Hub going (which based upon your comments
earlier I guess you've already sussed :-), Viewer to see messages and
Send to send xAP messages in text files.

This gives an easy way to write a xAP message and have it sent, and
hopefully processed by something else to be added...

> Howeve I am not sure what I need and how to connect
>it all up. I do have an operating X10 environment via a CM12 with a
>combination of wall and plugin units on a single housecode.  Is there a
>'get-you-started' set of instructions as to how to control my X10
>environment that I can master before looking at how to expand to do
some of
>the other things I am interested in?

Ummm, the next best thing I can do is point you at the xAP X10
Connector as written by Edward Pearson.

http://www.xapframework.net/modules.php?name=Downloads
<http://www.xapframework.net/modules.php?name=Downloads&d_op=viewdownloa
d&cid=44> &d_op=viewdownload&cid=44

This currently doesn't include any schema documentation (which would
allow you to form xAP messages in text files that you can transmit via
the Send app detailed above) as I'm not sure what it's using exactly.

Once I get some details on that I can tart it up as HTML and post it
in the usual places. Patrick has some related apps here

...or the version by Patrick:

http://patrick.lidstone.net/ha/xAP/xAP%20Projects/Applications/cm12u

There are a lot of xAP message schema detailed below, but this list
isn't complete at the moment (some new ones have come along such as IR
and others I'm sure).

http://www.xapautomation.org/modules.php?name=Sections
<http://www.xapautomation.org/modules.php?name=Sections&op=listarticles&;
secid=1> &op=listarticles&secid=1

Patrick has a simple X10 schema but I don't know if this matches
Edward's uses:

http://patrick.lidstone.net/ha/xAP/Schema/X-10

HTH. Fire away with queries!

S
--
Stuart Booth <stuart@xxxxxxx>
xAPFramework.NET - a xAP software development framework for .NET

http://www.xapautomation.org/ 
     http://www.xapframework.net/