Experimental Node-RED package for discovery in the Web of Things (WoT).
It provides a wot-discovery
node that can be used for discovering and storing WoT Thing Descriptions (TDs) as well as a wot-scripting
node that serves as an interface to node-wot
for triggering interaction affordances.
As a latest addition, a wot-fetch
node provides a way to retrieve TDs directly from URLs using HTTP(S) or CoAP(S).
The fetch node can retrieve TDs from URLs which can either be specified in the node itself or as a message property (using the field msg.tdUrl
).
It supports the URL schemes http(s)
and coap(s)
.
The discovery node can obtain TDs from the local network (using CoAP) or from a MQTT broker and save them either in the context or in the original message object that was passed to the node.
When using CoAP, you can choose between a number of different methods for obtaining TDs, all of which use IP multicast (both IPv4 and IPv6). You can choose between the multicast addresses for all IPv4/IPv6 nodes or the respective addresses for "All CoAP Nodes".
Supported methods for CoAP so far include:
- Discovery from
/.well-known/wot
. - Discovery using the CoRE Link Format and
/.well-known/core
(the correct content type and resource type has to be set in the list of links). - Discovery from CoRE Resource Directories. For this method, available Resource Directories are discovered first which are then queried for links pointing to TDs.
For MQTT, WoT producers have to publish their TDs to a topic with the prefix wot/td
which can then be queried by the discovery node.
The scripting node consumes TDs that are passed in inside a message object (in the field thingDescription
).
You can choose which kind of affordance type should be triggered and define a filter (either by affordance name or by the semantic @type
).
If an affordance returns an output, you can choose where this output should be saved (either in the message or the context) and which field should be used.