Changes
Commits
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 | ---- |