Changes
Commits
| Commit title | Date | Hash |
|---|---|---|
| Stateful attribute for properties (#108) | 2018-10-27 15:22:20 +0200 | 730357e |
| Remove regex requirement (#88) | 2018-04-29 14:32:39 +0200 | 081214d |
| Use “true” instead of “on” (#89) | 2018-04-27 14:51:40 +0200 | 5cbe5ee |
| Add FAQ, discuss getter topic (#87) | 2018-04-27 14:29:27 +0200 | fb8d153 |
| Add my ESP32 IDF implementation (#73) | 2018-04-23 15:25:24 -0700 | 7d9f236 |
Differences
| v3.0.0 | v3.0.1 | ||||
|---|---|---|---|---|---|
| n | 2 | path: https://github.com/homieiot/convention/tree/v3.0.0 | n | 2 | path: https://github.com/homieiot/convention/tree/v3.0.1 |
| n | 4 | version: v3.0.0 | n | 4 | version: v3.0.1 |
| 5 | releasedate: 25. March 2018 | 5 | releasedate: 27. October 2018 | ||
| n | n | 32 | |||
| 33 | Properties can be **retained**. | ||||
| 34 | A property is retained by default. A non-retained property would be useful for momentary events (door bell pressed). | ||||
| 35 | |||||
| 36 | A combination of those flags compiles into this list: | ||||
| 37 | |||||
| 38 | * **retained + non-settable**: The node publishes a property state (temperature sensor) | ||||
| 39 | * **retained + settable**: The node publishes a property state, and can receive commands for the property (by controller or other party) (lamp power) | ||||
| 40 | * **non-retained + non-settable**: The node publishes momentary events (door bell pressed) | ||||
| 41 | * **non-retained + settable**: The node publishes momentary events, and can receive commands for the property (by controller or other party) (brew coffee) | ||||
| n | n | 381 | </tr> | ||
| 382 | <tr> | ||||
| 383 | <td>$retained</td> | ||||
| 384 | <td>Device → Controller</td> | ||||
| 385 | <td>Specifies whether the property is retained (<code>true</code>) or non-retained (<code>false</code>). Publishing to a non-retained property topic MUST always happen with the MQTT 'retain' flag off.</td> | ||||
| 386 | <td><code>true</code> or <code>false</code></td> | ||||
| 387 | <td>Yes</td> | ||||
| 388 | <td>No (<code>true</code>)</td> | ||||
| n | 432 | <code>regex:pattern</code> to provide a regex that can be used to match the value. e.g. <code>regex:[A-Z][0-9]+</code>. | n | ||
| 433 | <br>Valid for datatype <code>string</code> | ||||
| 434 | </li> | ||||
| 435 | <li> | ||||
| n | 443 | <td>Depends on $datatype</td> | n | 457 | <td>No for $datatype <code>string</code>,<code>integer</code>,<code>float</code>,<code>boolean</code>. Yes for <code>enum</code>,<code>color</code></td> |
| n | 467 | homie/kitchen-light/light/power/set ← "on" | n | 481 | homie/kitchen-light/light/power/set ← "true" |
| t | t | 535 | |||
| 536 | ---- | ||||
| 537 | ---- | ||||