RE: X10

["Edward Pearson" <edward.mailgroup@xxxxxxxxxxxxxxxx>]

------=_NextPart_000_0020_01C44CF3.09DD52C0
Content-Type: text/plain;
charset="US-ASCII"
Content-Transfer-Encoding: quoted-printable

Stuart has shamed me into doing a little schema documentation :-/
=20
(Patrick, please comment on any inaccuracies, this was determined by a
combination of your documentation and source code)
=20

There are currently (June 2004) two xAP X10 connectors,
both of which support the CM11 and CM12 X10 adaptors.
=20
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
=20
both connectors support the following core schema:
=20
class=3Dxap-x10.request
=20
-- sent from xAP to X10
=20
xap-x10.request=20
{=20
command=3D(on  off)
-- mandatory
device=3D(X10 device being addressed eg, A1  B8  M10 etc)=20
-- mandatory
}
or
xap-x10.request=20
{
command=3D(bright  dim)
-- mandatory
device=3D(X10 device being addressed eg, A1  B8  M10 etc)=20
-- mandatory
count=3D(0-100)
-- mandatory
}
=20
class=3Dxap-x10.event
=20
-- sent from X10 to xAP
=20=20=20=20
xap-x10.event=20
{=20
event=3D(on  off)=20
-- mandatory
device=3D(X10 device active eg, A1  B8  M10 etc)=20
-- mandatory
}
or=20
xap-x10.event
{=20
event=3D(dim  bright)=20
-- mandatory
device=3D(X10 device active eg, A1  B8  M10 etc)=20
-- mandatory
count=3D(0-100)=20
-- mandatory
}
=20
Patrick's connector also reports the following events:
=20
all_lights_on, all_lights_off, all_units_off
=20
Due to a pointless clash of keyword styles, Edward's connector reports
thes=
e
as:
=20
AllLightsOn, AllLightsOff, AllUnitsOff
=20
apologies, these will be brought into line shortly :-/
=20

Edward's connector supports the following extension to the core schema:
=20
1) Multiple xAP addressed devices
=20
A comma separated list of devices can be specified for the device parameter
of the request message. For example:
=20
xap-x10.request=20
{=20
command=3Don
device=3DA1,A2,B7,M10=20
}
=20
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.
=20
2) Consolidation of multiple X10 addressed devices
=20
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:
=20
xap-x10.event=20
{=20
command=3Don
device=3DB3,B5=20
}
=20
=20

-----Original Message-----
From: Stuart Booth [mailto:lists@xxxxxxx]=20
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 o=
f
>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=3DDownloads
<http://www.xapframework.net/modules.php?name=3DDownloads&d_op=3Dviewdownlo=
ad&ci
d=3D44> &d_op=3Dviewdownload&cid=3D44

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=3DSections
<http://www.xapautomation.org/modules.php?name=3DSections&op=3Dlistarticles=
&seci
d=3D1> &op=3Dlistarticles&secid=3D1

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
--=20
Stuart Booth <stuart@xxxxxxx>
xAPFramework.NET - a xAP software development framework for .NET

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