Difference between revisions of "WISE-PaaS 2.0 NodeRed"
From ESS-WIKI
Chihyu.yeh (talk | contribs) |
|||
(14 intermediate revisions by one other user not shown) | |||
Line 3: | Line 3: | ||
[http://nodered.org/ Node-RED] is a visual wiring tool for the Internet of Things and is provided by [https://www.ibm.com/blogs/emerging-technology/ IBM Emerging Technologies]. [http://nodered.org/ Node-Red] has several features, including browser-based flow editing, built on [https://nodejs.org/en/ Node.js] and social development. Because of browser-based, the user can use it more easily. [http://nodered.org/ Node-Red] is based on [https://nodejs.org/en/ Node.js], so user can use its nodes by using JavaScript. [http://nodered.org/ Node-Red] also have many active communities. If the user finds bugs, he can find a solution and fix it easily. The user can use JSON format string to import or export the created flow easily. | [http://nodered.org/ Node-RED] is a visual wiring tool for the Internet of Things and is provided by [https://www.ibm.com/blogs/emerging-technology/ IBM Emerging Technologies]. [http://nodered.org/ Node-Red] has several features, including browser-based flow editing, built on [https://nodejs.org/en/ Node.js] and social development. Because of browser-based, the user can use it more easily. [http://nodered.org/ Node-Red] is based on [https://nodejs.org/en/ Node.js], so user can use its nodes by using JavaScript. [http://nodered.org/ Node-Red] also have many active communities. If the user finds bugs, he can find a solution and fix it easily. The user can use JSON format string to import or export the created flow easily. | ||
− | + | According to the restful API of WISE-PaaS 2.0, we created several nodes. | |
[[File:Nodered01.png|RTENOTITLE]] | [[File:Nodered01.png|RTENOTITLE]] | ||
− | + | = How to install Node-Red Plug-ins for WISE-PaaS 2.0 = | |
− | |||
− | = How to install | ||
*Install [https://nodejs.org Node.js] | *Install [https://nodejs.org Node.js] | ||
− | *#Download installer from [https://nodejs.org | + | *#Download installer from [https://nodejs.org Node.js] |
*#Double-click to install [https://nodejs.org Node.js] | *#Double-click to install [https://nodejs.org Node.js] | ||
Line 44: | Line 42: | ||
node red.js | node red.js | ||
+ | = Node-Red Plug-ins Categories = | ||
− | + | {| border="1" cellspacing="1" cellpadding="1" style="width: 1065px;" | |
− | |||
− | |||
− | {| | ||
|- | |- | ||
− | + | | style="text-align: center; width: 80px;" | '''Category'''<br/> | |
− | + | | style="text-align: center; width: 812px;" | '''Description'''<br/> | |
− | + | | style="text-align: center; width: 150px;" | '''Nodes'''<br/> | |
|- | |- | ||
− | | General | + | | style="width: 80px; text-align: center;" | General<br/> |
− | | The settings of IP address, port number, login username/password of WISE-PaaS server. Retrieval of device and sensor information. | + | | style="width: 812px;" | The settings of IP address, port number, login username/password of WISE-PaaS server. Retrieval of device and sensor information.<br/> |
− | | | + | | style="width: 150px;" | |
− | + | #ServerConfig | |
|- | |- | ||
− | | Common | + | | style="width: 80px; text-align: center;" | Common |
− | | Query the data | + | | style="width: 812px;" | Query the data and the information of devices, plugins and sensors |
− | | | + | | style="width: 150px;" | |
− | + | #DevicesQuery | |
+ | #PluginsQuery | ||
+ | #SensorsQuery | ||
+ | #DataQuery | ||
− | + | |} | |
− | + | = Node-Red Plug-ins Description = | |
− | |||
− | |||
+ | {| border="1" cellspacing="1" cellpadding="1" style="width: 1348px;" | ||
+ | |- | ||
+ | | style="text-align: center;" | '''Node Name''' | ||
+ | | style="text-align: center; width: 551px;" | '''Description'''<br/> | ||
+ | | style="text-align: center; width: 214px;" | '''Input'''<br/> | ||
+ | | style="text-align: center; width: 439px;" | '''Output'''<br/> | ||
+ | |- | ||
+ | | style="text-align: center;" | ServerConfig | ||
+ | | style="width: 551px;" | ''Set url, port, username and password for '''WISE-PaaS 2.0''' server. The node provides '''Basic '''type and '''SSO '''type.''<br/> | ||
+ | | style="width: 214px;" | ''A timestamp trigger or button trigger.''<br/> | ||
+ | | style="width: 439px;" | ''msg.url, msg.port, msg.encodestr.''<br/> | ||
+ | |- | ||
+ | | style="text-align: center;" | DevicesQuery<br/> | ||
+ | | style="width: 551px;" | ''Retrieve devices information from '''WISE-PaaS 2.0''' server. User can fill a specific device id. The text of DeviceID can be blank if user wants to retrieve all devices.''<br/> | ||
+ | | style="width: 214px;" | '''''ServerConfig '''''<i>Node.</i><br/> | ||
+ | | style="width: 439px;" | '''''Devices '''information list.''<br/> | ||
+ | |- | ||
+ | | style="text-align: center;" | PluginsQuery<br/> | ||
+ | | style="width: 551px;" | ''Retrieve plugins by Device ID within a time range. The maximum number of values is 10000 from '''WISE-PaaS 2.0''' server. User can set the conditions about plugins here. Ex: Device ID, Agent ID, begin timestamp, end timestamp, amount and type.''<br/> | ||
+ | | style="width: 214px;" | '''''ServerConfig '''''<i>Node.</i><br/> | ||
+ | | style="width: 439px;" | '''''Plugins '''Information list.''<br/> | ||
+ | |- | ||
+ | | style="text-align: center;" | SensorsQuery<br/> | ||
+ | | style="width: 551px;" | ''Retrieve sensors by Device ID & plugin within a time range. The maximum number of values is 10000 from '''WISE-PaaS 2.0''' server. User can set the conditions about sensor here. Ex: Device ID, Agent ID, Plugin Name, begin timestamp, end timestamp, amount and type.''<br/> | ||
+ | | style="width: 214px;" | '''''ServerConfig '''''<i>Node.</i><br/> | ||
+ | | style="width: 439px;" | '''''Sensors '''Information list.''<br/> | ||
+ | |- | ||
+ | | style="text-align: center;" | DataQuery<br/> | ||
+ | | style="width: 551px;" | ''Retrieve data from '''WISE-PaaS 2.0''' server. The node provides three types, they are '''history''', '''latest''' and '''statistic'''''<br/> | ||
+ | | style="width: 214px;" | '''''ServerConfig '''''<i>Node.</i><br/> | ||
+ | | style="width: 439px;" | ''The data of'''history''', '''statistic '''or'''latest''' by specific device Id within a time range.''<br/> | ||
|} | |} | ||
+ | = Document = | ||
− | + | [http://ess-wiki.advantech.com.tw/wiki/images/2/23/NodeRed_for_WISE-PaaS.pdf Node-Red Plug-ins User Menual Doc for WISE-PaaS 2.0] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 11:11, 8 January 2018
Contents
Introduction
Node-RED is a visual wiring tool for the Internet of Things and is provided by IBM Emerging Technologies. Node-Red has several features, including browser-based flow editing, built on Node.js and social development. Because of browser-based, the user can use it more easily. Node-Red is based on Node.js, so user can use its nodes by using JavaScript. Node-Red also have many active communities. If the user finds bugs, he can find a solution and fix it easily. The user can use JSON format string to import or export the created flow easily.
According to the restful API of WISE-PaaS 2.0, we created several nodes.
How to install Node-Red Plug-ins for WISE-PaaS 2.0
- Clone EI-NodeRed from GitLab
- Open cmd.exe and navigate to ./EI-NodeRed folder
cd ./EI-NodeRed
- Type command line"npm install" to install the node-red dependencies
npm install
- Type command line"npm run build" to build the code of Node-Red
npm run build
- Type command line"npm start" or "node red.js" to run Node-Red
npm start
or
node red.js
Node-Red Plug-ins Categories
Category |
Description |
Nodes |
General |
The settings of IP address, port number, login username/password of WISE-PaaS server. Retrieval of device and sensor information. |
|
Common | Query the data and the information of devices, plugins and sensors |
|
Node-Red Plug-ins Description
Node Name | Description |
Input |
Output |
ServerConfig | Set url, port, username and password for WISE-PaaS 2.0 server. The node provides Basic type and SSO type. |
A timestamp trigger or button trigger. |
msg.url, msg.port, msg.encodestr. |
DevicesQuery |
Retrieve devices information from WISE-PaaS 2.0 server. User can fill a specific device id. The text of DeviceID can be blank if user wants to retrieve all devices. |
ServerConfig Node. |
Devices information list. |
PluginsQuery |
Retrieve plugins by Device ID within a time range. The maximum number of values is 10000 from WISE-PaaS 2.0 server. User can set the conditions about plugins here. Ex: Device ID, Agent ID, begin timestamp, end timestamp, amount and type. |
ServerConfig Node. |
Plugins Information list. |
SensorsQuery |
Retrieve sensors by Device ID & plugin within a time range. The maximum number of values is 10000 from WISE-PaaS 2.0 server. User can set the conditions about sensor here. Ex: Device ID, Agent ID, Plugin Name, begin timestamp, end timestamp, amount and type. |
ServerConfig Node. |
Sensors Information list. |
DataQuery |
Retrieve data from WISE-PaaS 2.0 server. The node provides three types, they are history, latest and statistic |
ServerConfig Node. |
The data ofhistory, statistic orlatest by specific device Id within a time range. |