Comments (5)
We should also provide some parsing tips for developers. Ideally, we could also implement a simple Web UI where we could create devices, nodes and properties and see the resulting MQTT messages, for reference.
from convention.
from convention.
Here's the WIP branch: https://github.com/marvinroger/homie/tree/redesign
What do you think?
from convention.
A few small details I'd like to mention:
-
"Homie convention" - should the "C" be capitalized as in a keyword or lowercase because "Homie" is the brand and convention is just an addition to clarify the topic?
-
topic → "message"
ortopic ← "message"
are neat ways to indicate communication direction. However I fear that the meaning is not always clear. Especially as it depends on the perspective of a user. The IoT device developer might want to publish the$nodes
topic while a client developer wants to subscribe to these. Hence:IoT POV: homie/686f6d6965/$nodes ← "message" Client POV: homie/686f6d6965/$nodes → "message"
-
I agree, we should give practical recommendations for developers of both worlds.
-
We need one good example. I don't think "686f6d6965" is easy to comprehend and the LED example should rather be replaced by something related to the one example. How do you feel about discarding the weather station example. It has a few issues. Mostly numbers, no settable properties, it's boring 😄 Can you think of a good example. My coffee machine actually has almost everything we need (no array).
from convention.
-
I think "Homie Convention" is better, indeed
-
Well, I we cannot cover both sides (a client and an IoT controller), because the document would be too heavy, right? It seems pretty obvious that if a device publishes to
$nodes
, a controller should instead subscribe to it. -
Definitely 😊
-
I agree! What about a car?
Car
- wheels node:
- angle property (-45 to 45°)
- engine node
- speed property (0 to 50 km/h)
- direction property (forward,backward)
- lights array node ([0-1] (0 front light, 1 back light)
- intensity (0 to 100 %)
- color (color, RGB)
This is obviously a simplified car (an engine cannot be set to "50km/h"), but I think it works pretty well.
from convention.
Related Issues (20)
- $state and $homie can be empty HOT 1
- Human readable types vs machine optimzied types HOT 14
- Please add Java implementation to the list
- Clarify handling of empty strings HOT 13
- add a 'format' for booleans
- Matrix room for project chat HOT 1
- How can I create a settable property, which takes two arguments? HOT 2
- Homie future? HOT 52
- New firmware - GrowNode
- drop the Percent type HOT 1
- add a "step" or "precision" element to the number formats HOT 3
- drop the `node.$type` field
- QoS of non-retained messages HOT 3
- using `set` with retained messages HOT 1
- Define a way to handle NULL values HOT 3
- Protocol Buffer for the payload? HOT 4
- Add location format attribute to Homie V5
- Support streams or binary data HOT 7
- Arrays got removed, but specification uses one as example HOT 10
- Color bug (Homie 5): xyz does not include brightness HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from convention.