homieiot/convention

Changes

Changes from v3.0.0 to v3.0.1

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
n2path: https://github.com/homieiot/convention/tree/v3.0.0n2path: https://github.com/homieiot/convention/tree/v3.0.1
n4version: v3.0.0n4version: v3.0.1
5releasedate: 25. March 20185releasedate: 27. October 2018
nn32
33Properties can be **retained**.
34A property is retained by default. A non-retained property would be useful for momentary events (door bell pressed).
35
36A 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)
nn381 </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>
n432 <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>
n443 <td>Depends on $datatype</td>n457 <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>
n467homie/kitchen-light/light/power/set ← "on"n481homie/kitchen-light/light/power/set ← "true"
tt535
536----
537----