Search the web
Sign In
New User? Sign Up
xAP_developer
? Already a member? Sign in to Yahoo!

Yahoo! Groups Tips

Did you know...
Hear how Yahoo! Groups has changed the lives of others. Take me there.

Best of Y! Groups

   Check them out and nominate your group.
Having problems with message search? Fill out this form to ensure your group is one of the first to be migrated to the new message search system.

Messages

  Messages Help
Advanced
version 1.3 of xAP documents   Message List  
Reply | Forward Message #1971 of 2025 |
Re: [xAP_developer] Re: version 1.3 of xAP documents

Hi Daniel,

Yes the ID field remains in BSC bodies - it can now be longer of
course to support the longer sub addresses in v1.3 and should be an even
number of uppercase hex digits, or a '*'.

Yes , all schema permit the multi-block format, unless they
specifically forbid it , which allows for coincident changes to be made
to several endpoints. Multi-block also guarantees that either all
changes or none are actioned (in the extremely unlikley event that a
message be lost). If the blocks are of the same type then you should
index the blocknames ie block.1 block.2 etc as block names must be
unique within one xAP message. A listener should therefore recognise
either 'block' or 'block.1' 'block.2' etc. This is especially
prevalent in the BSC schema as you mention.

One other thing that has changed in xAP v1.3 is that it is now not
permitted to include target= lines within each of the different
multi-block bodies or indeed in any body. A target= line is now only
permitted in the xAP header. In xAP v1.2 separately targeting blocks
was permitted although AFAIK no-one every implemented it, or handled it
correctly, because you had to logically AND the two target= addresses,
which with wildcards was complex and messy. So it's now deprecated.

Just to recap also that in xAP v1.3 heartbeats can have bodies,
bodies can be empty, and you should gracefully ignore any unexpected
parameter/values found within headers or bodies - which allows for
expansion of existing schema or headers. Addresses used in target= or
source= are case insensitive.

cheers Kevin

Daniel Berenguer wrote:
> Kevin,
>
> Do the xAP BSC commands still contain the "ID" field in the body? Do these
messages keep the multi-block body feature after the new xAP spec?
>
> Thanks,
>
> Daniel.
>
>
> --- In xAP_developer@yahoogroups.com, Kevin Hawkins <yahoogroupskh@...> wrote:
>
>> Steve, one more thing I forgot to mention....
>>
>> xAP v1.2 supported target= lines within the body(ies) of messages -
>> effectively allowing the various body sections within a single message
>> to be addressed to different devices. This AFAIK has never been used by
>> any applications and is awkward to implement as there are then two
>> target filters in use. Nor do I know of any listener application that
>> correctly handled it either. ......
>>
>> So... from xAP v1.3 this feature is now deprecated.
>>
>> K
>>
>> stevejbauer wrote:
>>
>>> Thanks... That's what I have been looking for!
>>>
>>> Steve
>>>
>>> --- In xAP_developer@yahoogroups.com, Kevin Hawkins <yahoogroupskh@> wrote:
>>>
>>>
>>>> Hi Steven,
>>>>
>>>> There's a formal spec, plus a rewrite of the v1.2 spec imminent.
>>>> It's been delayed due to some aspects of the specification that haven't
>>>> been finalised and so will now be deferred to a future v1.4 (not
>>>> anytime soon). The deferred aspects are not impacting typical usage but
>>>> are desireable for some more demanding applications and include long
>>>> messages, message continuations, sequencing, acknowledges,
>>>> re-transmissions, authentication, security, discovery and configuration
>>>> aspects. These are essentially impemented using a higher protocol layer
>>>> sitting on top of the v1.3 protocol and so will be totally backward
>>>> compatible. There are outline proposals for many of these allowing for
>>>> experimentation within xAP v1.3.
>>>>
>>>> The aspects that have been finalised for v1.3 include various header
>>>> and body flexibility changes - which are backwards compatible with v1.2.
>>>> The v1.3 UID format change however is mostly compatible in that it is
>>>> transparent to nearly every existing xAP application except those using
>>>> the xAP BSC or TSC schema which might need updating. Most affected
>>>> applications have already been updated . A xAP v1.3 application must
>>>> support existing v1.2 messages and UID formats transparently so that
>>>> ensures forward compatibility.
>>>>
>>>> Re the UID it has been changed from the v1.2 fixed length NNAAAASS
>>>> format to NN.AAAA:SS in v1.3.
>>>> ie a '.' and ':' delimiting the three segments has been added which
>>>> now allows any of these segments to be any (even) length of uppercase
>>>> hex digits.
>>>> The main reason for this was to allow expansion of the sub address
>>>> field SS from the v1.2 two hex digits to longer as many applications
>>>> required.
>>>> In all segments values of all 0's or all F's are reserved or have
>>>> special meaning.
>>>>
>>>> NN - network number - usually the special all F's representing the
>>>> local network
>>>> AA - application/device ID (unique on the network)
>>>> SS - sub address (if the application or device implements multiple
>>>> endpoints) . All 0's represents the application itself rather than an
>>>> endpoint within it.
>>>>
>>>> Having previously said that any even number of characters is now
>>>> permissable in any segment there are some recommended formats that
>>>> suffice for most needs.
>>>> NN usually always two characters
>>>> AAAA usually four, six or rarely eight characters
>>>> SS usually two, four, six or eight characters - although some
>>>> implementations have used longer sub addresses..(eg 1-wire 64bit 16chars)
>>>> All leading 0's must be included to maintain consistent segment length
>>>> for the application
>>>>
>>>> A v1.2 UID of FF1234A2 is directly equivalent to a v1.3 UID of FF.1234:A2
>>>>
>>>> Examples of v1.3 UID's:
>>>>
>>>> UID=FF.1234:00A6
>>>> UID=FF.AB34:67A203
>>>> UID=FF.000032:5C
>>>>
>>>> There are ramifications to the xAPBSC v1.3 Basic Status and Control
>>>> schema (and xAPTSC) but these are self evident I hope as you read the
>>>> specification.
>>>>
>>>> Any questions .. ask away....
>>>>
>>>> Cheers Kevin
>>>>
>>>>
>>>> Bauer, Steven J. wrote:
>>>>
>>>>
>>>>> Is there anyplace where a person can find (even the draft spec) of the
>>>>> version 1.3 xAP?? I would like to support the extended uid correctly
>>>>> in the programs that I am writing?
>>>>>
>>>>> Thanks!
>>>>>
>>>>> Steve Bauer
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>
>>>
>>> ------------------------------------
>>>
>>> Yahoo! Groups Links
>>>
>>>
>>>
>>>
>>>
>>>
>
>
>
>
> ------------------------------------
>
> Yahoo! Groups Links
>
>
>
>
>




Wed Jul 15, 2009 11:08 am

ukusaconsulting
Offline Offline
Send Email Send Email

Forward
Message #1971 of 2025 |
Expand Messages Author Sort by Date

Is there anyplace where a person can find (even the draft spec) of the version 1.3 xAP?? I would like to support the extended uid correctly in the programs...
Bauer, Steven J.
stevejbauer
Offline Send Email
Apr 27, 2009
11:00 am

Hi Steven, There's a formal spec, plus a rewrite of the v1.2 spec imminent. It's been delayed due to some aspects of the specification that haven't been...
Kevin Hawkins
ukusaconsulting
Offline Send Email
Apr 27, 2009
12:14 pm

Thanks... That's what I have been looking for! Steve...
stevejbauer
Offline Send Email
May 18, 2009
10:34 am

Steve, one more thing I forgot to mention.... xAP v1.2 supported target= lines within the body(ies) of messages - effectively allowing the various body...
Kevin Hawkins
ukusaconsulting
Offline Send Email
May 18, 2009
10:49 am

Thanks for the heads up.. That does simplify things. Steve From: xAP_developer@yahoogroups.com [mailto:xAP_developer@yahoogroups.com] On Behalf Of Kevin...
Bauer, Steven J.
stevejbauer
Offline Send Email
May 18, 2009
2:37 pm

Kevin, Do the xAP BSC commands still contain the "ID" field in the body? Do these messages keep the multi-block body feature after the new xAP spec? Thanks, ...
Daniel Berenguer
estratosapiens
Offline Send Email
Jul 15, 2009
10:38 am

Hi Daniel, Yes the ID field remains in BSC bodies - it can now be longer of course to support the longer sub addresses in v1.3 and should be an even number of...
Kevin Hawkins
ukusaconsulting
Offline Send Email
Jul 15, 2009
11:10 am

I have another question: For new designs that don't need the additional features provided by xAP v1.3, could we still use the old v1.2 format (with shorter...
Daniel Berenguer
estratosapiens
Offline Send Email
Jul 17, 2009
5:21 pm

xAP v1.3 totally supports* xAP v1.2 so you can, should you wish still write xAP v1.2 applications - but I would make them tolerant of xAP v1.3 applications...
Kevin Hawkins
ukusaconsulting
Offline Send Email
Jul 17, 2009
5:57 pm

Thanks Kevin! Daniel....
Daniel Berenguer
estratosapiens
Offline Send Email
Jul 17, 2009
8:00 pm
Advanced

Copyright © 2009 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Guidelines - Help