# Documentation

_xAAL Specifications_

---

## Specification
### Latest Stable
- [xAAL v0.7r2 (en)](xAAL-v07r2.pdf)

### Former
- [xAAL v0.7r1b (en)](xAAL-v07r1b.pdf)
- [xAAL v0.7r1 (en)](xAAL-v07r1.pdf): using cbor for messages
- [xAAL v0.6 (en)](xAAL-v06.pdf): using cbor for messages
- [xAAL v0.5r2 (en)](xAAL-v05r2.pdf): Legacy stable
- [xAAL v0.5r1 (en)](xAAL-v05r1.pdf): adding security to xAAL v0.4
- [xAAL v0.4 (en)](xAAL-v04r3.pdf)
- [xAAL v0.3 (en)](xAAL-v03.pdf)
- [xAAL v0.2 (en)](xAAL-v02_en.pdf)
- [xAAL v0.2 (fr)](xAAL-v02_fr.pdf)
- [xAAL v0.1-json (fr)](xAAL-v01-json_fr.pdf)
- [xAAL v0.1-bin (fr)](xAAL-v01-bin_fr.pdf)


## Available components
Several xAAL components are already [coded and available](../software/).

Current home-automation protocols supported by our elementary gateways: X10, Z-Wave, Enocean, KNX, RFXcom, Aqara, Tuya, etc.
(Run those you need.)

Several HMI (web) are also proposed.



## Protocol
Following format specifications are provided to check the form of xAAL messages (i.e., for debugging purpose).

- xAAL v0.7: [xAAL_07_security-layer.cddl](xAAL_07_security-layer.cddl) and [xAAL_07_application-layer.cddl](xAAL_07_application-layer.cddl) (CDDL)
- xAAL v0.6: [xAAL_06_security-layer.cddl](xAAL_06_security-layer.cddl) and [xAAL_06_application-layer.cddl](xAAL_06_application-layer.cddl) (CDDL)
- xAAL v0.5: [xAAL_05_security-layer](xAAL_05_security-layer) and [xAAL_05_application-layer](xAAL_05_application-layer) (Json Schemas)
- xAAL v0.4: [xAAL_04_message](xAAL_04_message) (Json Schema)



## Schemas
xAAL devices are described by _schemas_. These are Json object of a specific form that must validates a given template: 

- xAAL v0.7: [xAAL_07_schema.cddl](xAAL_07_schema.cddl) This is a [CDDL](https://tools.ietf.org/html/rfc8610) specification.
- xAAL v0.4 to v0.6: [xAAL_05_schema](xAAL_05_schema) This is a [Json Schema](http://json-schema.org/). 

Each xAAL devices vendor has the responsability to provide consistent schemas. 


### Latest Stable Schemas (xAAL 0.7)
Details on the dedicated [svn repository](https://redmine.telecom-bretagne.eu/svn/xaal/schemas/branches/schemas-0.7)