ttb-node-intents
v1.0.9
Published
Intents is a unifying solution between IoT sensors and activators.
Downloads
7
Readme
Intents is a unifying solution between IoT sensors and activators.
Some Node-RED Nodes produce values on the msg flow, some nodes consumes them.
The problem is that there is no definition on how to express something in the flow.
For instance, a zwave library named OpenZWave returns "true" or "false" when a contact sensor is opened or closed.
And the PiFace board expect 0 or 1 on the flow msg payload to turn on its LED.
And the node-red-contrib-lifx
for LIFX bulb expects a payload like this one:
{
payload: {
on: true,
hue: 0xCC15,
...
}
}
to switch on a bulb.
Thus a function node is mandatory before the node-red-contrib-lifx to "translate" the flow in the expected format and the user has to use javascript just to link a switch to a bulb...
All these connot work together without function nodes that adapts the flow.
The unifying solution: Intents
Intents is a unifying solution between IoT sensors and activators.
For intance, to "open" something (understand switching a light on, turning a radio on...) the msg should contain msg.intent=1.
The intents library
Notice that these intents are never mandatory: they may exist or not.
intent intent
Some intents are coded as integers into the msg.intent.
The following intents are defined:
Open/switch On
msg.intent=1
Close/switch Off
msg.intent=0
Invert: this changes close to open and vice et versa.
More
msg.intent=2
. Use this intent to add more sound, more light...Less
msg.intent=3
NoIntent: in this case,
msg.intent === undefined
Color
msg.color
allows to set a RGBW value from a color panelIntensity: allow to set a value between 0 and 100 with a slider
There are nodes in the palette for each intents. They allow to set an intent on the flow without having to use a javascript function.
The nodes open
, close
, more
, less
set the intent into the message flow.
intent picture
If a picture is in the flow, it's absolute OS pathname should be in msg.picture
.
This is done by nodes camera
, picturepicker
and node ledmatrix
use it.
intent colors
If a color is in the flow, it's value should be in msg.color
.
intent city
If a city is in the flow, it's value should be in msg.city
.
intent message
The payload is dedicated to the next node in the flow.
Use msg.message
to set a payload equivalent message dedicated to human.
A temperature node ouputs the folowing msg:
{
payload: "20.7",
message: "The temperature of the office is 20.7 oC"
}
The Display node is intent aware: it displays the msg.message instead of the payload if it exists. But the MQTT-out node sends the payload to the broker.
intent battery
Contains the battery level as integer.
intent updated
contains the date on which the message was created.
Sample
Here is an example where the same intents are used to monitor both a sound and a hue bulb: the open starts the sound and switch on the light. Same for close. Also the intensity node sets the level of the sound as well as the intensity of the light at the same time:
Avanced
Nodes should handles intents form the more specific to the less. For instance, a sound node should search its parameter into the "sound" track first, then the "value" then the "payload".