Exif node improve popup info

to include css bugfix

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,34 @@
+<!--
+## Before you hit that Submit button....
+
+This issue tracker is for problems with the extra nodes maintained by the Node-RED project.
+
+If your issue is:
+  - a general 'how-to' type question,
+  - a feature request or suggestion for a change,
+  - or problems with 3rd party (`node-red-contrib-`) nodes
+
+please use the [Node-RED Forum](https://discourse.nodered.org) or [slack team](https://nodered.org/slack), or ask a question on [Stack Overflow](https://stackoverflow.com/questions/tagged/node-red) and tag it `node-red`.
+
+That way the whole Node-RED user community can help, rather than rely on the core development team.
+
+## So you have a real issue to raise...
+
+To help us understand the issue, please fill-in as much of the following information as you can:
+-->
+
+### Which node are you reporting an issue on?
+
+### What are the steps to reproduce?
+
+### What happens?
+
+### What do you expect to happen?
+
+### Please tell us about your environment:
+
+- [ ] Node-RED version:
+- [ ] node.js version:
+- [ ] npm version:
+- [ ] Platform/OS:
+- [ ] Browser:

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,37 @@
+<!--
+## Before you hit that Submit button....
+
+Please read our [contribution guidelines](https://github.com/node-red/node-red-nodes/blob/master/CONTRIBUTING.md)
+before submitting a pull-request.
+
+## Types of changes
+
+What types of changes does your code introduce?
+Put an `x` in the boxes that apply
+-->
+
+- [ ] Bugfix (non-breaking change which fixes an issue)
+- [x] New feature (non-breaking change which adds functionality)
+
+<!--
+If you want to raise a pull-request with a new feature, or a refactoring
+of existing code, it **may well get rejected** if it hasn't been discussed on
+the [forum](https://discourse.nodered.org) or
+[slack team](https://nodered.org/slack) first.
+
+-->
+
+## Proposed changes
+
+<!-- Describe the nature of this change. What problem does it address? -->
+
+Adds authentication option to the Email node (node-red-node-email) to use OAuth and XOAuth2
+********** This version: IMAP ONLY **********
+
+## Checklist
+<!-- Put an `x` in the boxes that apply -->
+
+- [x] I have read the [contribution guidelines](https://github.com/node-red/node-red-nodes/blob/master/CONTRIBUTING.md)
+- [x] For non-bugfix PRs, I have discussed this change on the forum/slack team.
+- [x] I have run `grunt` to verify the unit tests pass
+- [x] I have added suitable unit tests to cover the new/changed functionality

.gitignore

@@ -0,0 +1,11 @@
+npm-debug.log
+node_modules
+.npm
+coverage
+puball.sh
+setenv.sh
+/.project
+package-lock.json
+social/xmpp/92-xmpp.old
+*.tgz
+.DS_Store

.jscsrc

@@ -0,0 +1,24 @@
+{
+    "fileExtensions": [ ".js", "jscs" ],
+    "excludeFiles": [ "node_modules/**" ],
+    "validateIndentation": 4,
+    "disallowKeywordsOnNewLine": [],
+    "disallowMixedSpacesAndTabs": true,
+    "disallowMultipleSpaces": {"allowEOLComments": true},
+    "disallowNewlineBeforeBlockStatements": true,
+    "disallowTabs": true,
+    "disallowTrailingWhitespace": true,
+    "requireCurlyBraces": true,
+    //"requireKeywordsOnNewLine": ["else", "catch"],
+    //"requireSemicolons": true,
+    //"requireSpaceAfterBinaryOperators": true,
+    //"requireSpaceAfterComma": {"allExcept": ["trailing"]},
+    "requireSpaceAfterKeywords": ["do","for","if","else","switch","case","try","while"],
+    "requireSpaceBeforeBlockStatements": 1,
+    "requireSpaceBeforeObjectValues": false,
+    "requireSpacesInForStatement": true,
+    "requireSpacesInFunction": { "beforeOpeningCurlyBrace": true },
+    //"validateParameterSeparator": ", ",
+    //"validateQuoteMarks": false,
+    "maximumLineLength": 280
+}

.jshintrc

@@ -0,0 +1,15 @@
+{
+    "asi": true,
+    "curly": true,
+    "eqnull": true,
+    "freeze": true,
+    "indent": 4,
+    "forin": true,
+    "immed": true,
+    "nonbsp": true,
+    "loopfunc": true,
+    "shadow": true,
+    "sub": true,
+    "proto": true,
+    "esversion": 8
+}

.travis.yml

@@ -0,0 +1,31 @@
+sudo: false
+language: node_js
+matrix:
+  # allow_failures:
+  #   - node_js: 16
+  include:
+    - node_js: 16
+    - node_js: 14
+    - node_js: 12
+    # - python: 2.7
+    #   language: python
+    #   before_script: pip install flake8
+    #   script: flake8 . --count --select=E901,E999,F821,F822,F823 --show-source --statistics
+    - python: 3.7
+      language: python
+      dist: xenial    # required for Python 3.7 (travis-ci/travis-ci#9069)
+      sudo: required  # required for Python 3.7 (travis-ci/travis-ci#9069)
+      before_script: pip install flake8
+      script: flake8 . --count --select=E901,E999,F821,F822,F823 --show-source --statistics
+before_install:
+  - npm i -g npm
+before_script:
+  # Remove the './node_modules/.bin:' entry, see https://github.com/travis-ci/travis-ci/issues/8813
+  - export PATH=`echo ${PATH} | sed -re 's,(^|:)(./)?node_modules/.bin($|:),\1,'`
+  - npm install -g nyc grunt-cli coveralls
+  - npm install node-red
+script:
+  # - istanbul cover grunt --report lcovonly && istanbul report text && ( cat coverage/lcov.info | $(npm get prefix)/bin/coveralls || true ) && rm -rf coverage
+  # - nyc --check-coverage --reporter=text --reporter=lcovonly --reporter=html grunt
+  # - nyc grunt && rm -rf coverage .nyc_output
+  - nyc grunt && nyc report --reporter=text-lcov | coveralls

99-sample.html.demo

@@ -1,50 +1,36 @@
-<!--
-  Copyright 2013 IBM Corp.
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
--->
 
 <!-- Sample html file that corresponds to the 99-sample.js file              -->
 <!-- This creates and configures the onscreen elements of the node           -->
 
-<!-- If you use this as a template, replace IBM Corp. with your own name.    -->
+<!-- If you use this as a template, update the copyright with your own name. -->
 
 <!-- First, the content of the edit dialog is defined.                       -->
 
-<script type="text/x-red" data-template-name="sample">
+<script type="text/html" data-template-name="sample">
    <!-- data-template-name identifies the node type this is for              -->
 
    <!-- Each of the following divs creates a field in the edit dialog.       -->
    <!-- Generally, there should be an input for each property of the node.   -->
    <!-- The for and id attributes identify the corresponding property        -->
    <!-- (with the 'node-input-' prefix).                                     -->
-   <!-- The available icon classes are defined in Twitter Bootstrap          -->
+   <!-- The available icon classes are defined Font Awesome Icons (FA Icons) -->
     <div class="form-row">
-        <label for="node-input-topic"><i class="icon-tasks"></i> Topic</label>
+        <label for="node-input-topic"><i class="fa fa-tasks"></i> Topic</label>
         <input type="text" id="node-input-topic" placeholder="Topic">
     </div>
 
+    <br/>
     <!-- By convention, most nodes have a 'name' property. The following div -->
-    <!-- provides the necessary field.                                       -->
+    <!-- provides the necessary field. Should always be the last option      -->
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
 
 
 <!-- Next, some simple help text is provided for the node.                   -->
-<script type="text/x-red" data-help-name="sample">
+<script type="text/html" data-help-name="sample">
    <!-- data-help-name identifies the node type this help is for             -->
    <!-- This content appears in the Info sidebar when a node is selected     -->
    <!-- The first <p> is used as the pop-up tool tip when hovering over a    -->
@@ -64,10 +50,11 @@
             name: {value:""},   //  along with default values.
             topic: {value:"", required:true}
         },
-        inputs:0,                // set the number of inputs - only 0 or 1
-        outputs:1,               // set the number of outputs - 0 to n
-        icon: "arrow-in.png",    // set the icon (held in public/icons)
-        label: function() {      // sets the default label contents
+        inputs:1,               // set the number of inputs - only 0 or 1
+        outputs:1,              // set the number of outputs - 0 to n
+        // set the icon (held in icons dir below where you save the node)
+        icon: "myicon.png",     // saved in  icons/myicon.png
+        label: function() {     // sets the default label contents
             return this.name||this.topic||"sample";
         },
         labelStyle: function() { // sets the class to apply to the label

99-sample.js.demo

@@ -1,52 +1,53 @@
-/**
- * Copyright 2013 IBM Corp.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- **/
 
-// If you use this as a template, replace IBM Corp. with your own name.
+// If you use this as a template, update the copyright with your own name.
 
 // Sample Node-RED node file
 
-// Require main module
-var RED = require(process.env.NODE_RED_HOME+"/red/red");
 
-// The main node definition - most things happen in here
-function SampleNode(n) {
-    // Create a RED node
-    RED.nodes.createNode(this,n);
+module.exports = function(RED) {
+    "use strict";
+    // require any external libraries we may need....
+    //var foo = require("foo-library");
 
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;
+    // The main node definition - most things happen in here
+    function SampleNode(n) {
+        // Create a RED node
+        RED.nodes.createNode(this,n);
 
-    // Do whatever you need to do in here - declare callbacks etc
-    // Note: this sample doesn't do anything much - it will only send
-    // this message once at startup...
-    // Look at other real nodes for some better ideas of what to do....
-    var msg = {};
-    msg.topic = this.topic;
-    msg.payload = "Hello world !"
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;
 
-    // send out the message to the rest of the workspace.
-    this.send(msg);
+        // copy "this" object in case we need it in context of callbacks of other functions.
+        var node = this;
+
+        // Do whatever you need to do in here - declare callbacks etc
+        // Note: this sample doesn't do anything much - it will only send
+        // this message once at startup...
+        // Look at other real nodes for some better ideas of what to do....
+        var msg = {};
+        msg.topic = this.topic;
+        msg.payload = "Hello world !"
+
+        // send out the message to the rest of the workspace.
+        // ... this message will get sent at startup so you may not see it in a debug node.
+        this.send(msg);
+
+        // respond to inputs....
+        this.on('input', function (msg) {
+            node.warn("I saw a payload: "+msg.payload);
+            // in this example just send it straight on... should process it here really
+            node.send(msg);
+        });
+
+        this.on("close", function() {
+            // Called when the node is shutdown - eg on redeploy.
+            // Allows ports to be closed, connections dropped etc.
+            // eg: node.client.disconnect();
+        });
+    }
+
+    // Register the node by name. This must be called before overriding any of the
+    // Node functions.
+    RED.nodes.registerType("sample",SampleNode);
 
-    this.on("close", function() {
-        // Called when the node is shutdown - eg on redeploy.
-        // Allows ports to be closed, connections dropped etc.
-        // eg: this.client.disconnect();
-    });
 }
-
-// Register the node by name. This must be called before overriding any of the
-// Node functions.
-RED.nodes.registerType("sample",SampleNode);

CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing to Node-RED
+
+We welcome contributions, but request you follow these guidelines.
+
+ - [Raising issues](#raising-issues)
+ - [Feature requests](#feature-requests)
+ - [Pull-Requests](#pull-requests)
+   - [Contributor License Agreement](#contributor-license-agreement)
+
+This project adheres to the [Contributor Covenant 1.4](http://contributor-covenant.org/version/1/4/).
+By participating, you are expected to uphold this code. Please report unacceptable
+behavior to any of the [project's core team](https://github.com/orgs/node-red/teams/core).
+
+## Raising issues
+
+Please raise any bug reports on the relevant project's issue tracker. Be sure to
+search the list to see if your issue has already been raised.
+
+A good bug report is one that make it easy for us to understand what you were
+trying to do and what went wrong.
+
+Provide as much context as possible so we can try to recreate the issue.
+If possible, include the relevant part of your flow. To do this, select the
+relevant nodes, press Ctrl-E and copy the flow data from the Export dialog.
+
+At a minimum, please include:
+
+ - Version of Node-RED - either release number if you downloaded a zip, or the first few lines of `git log` if you are cloning the repository directly.
+ - Version of node.js - what does `node -v` say?
+
+## Feature requests
+
+For feature requests, please raise them on the [Node-RED Forum](https://discourse.nodered.org).
+
+## Pull-Requests
+
+If you want to raise a pull-request with a new feature, or a refactoring
+of existing code, it may well get rejected if you haven't discussed it on
+the [Node-RED Forum](https://discourse.nodered.org) first.
+
+### Contributor License Agreement
+
+All contributors need to sign the JS Foundation's Contributor License Agreement.
+It is an online process and quick to do. You can read the details of the agreement
+here: https://cla.js.foundation/node-red/node-red.
+
+If you raise a pull-request without having signed the CLA, you will be prompted
+to do so automatically.
+
+### Coding standards
+
+Please ensure you follow the coding standards used through-out the existing
+code base. Some basic rules include:
+
+ - indent with 4-spaces, no tabs. No arguments.
+ - opening brace on same line as `if`/`for`/`function` and so on, closing brace
+ on its own line.
+ - There are .jshintrc and .jscsrc files included in the project which may help

Gruntfile.js

@@ -0,0 +1,68 @@
+
+// Configuration for Node-RED-nodes project
+module.exports = function(grunt) {
+
+    // Project configuration.
+    grunt.initConfig({
+        pkg: grunt.file.readJSON('package.json'),
+        simplemocha: {
+            options: {
+                globals: ['expect'],
+                timeout: 3000,
+                ignoreLeaks: false,
+                ui: 'bdd',
+                reporter: 'spec'
+            },
+            all: { src: ['test/*/*/*_spec.js'] }
+        },
+        jshint: {
+            options: {
+                jshintrc:true     // Use external jshinrc file configured as below
+                // http://www.jshint.com/docs/options/
+                //"asi": true,      // allow missing semicolons
+                //"curly": true,    // require braces
+                //"eqnull": true,   // ignore ==null
+                //"forin": true,    // require property filtering in "for in" loops
+                //"immed": true,    // require immediate functions to be wrapped in ( )
+                //"nonbsp": true,   // warn on unexpected whitespace breaking chars
+                ////"strict": true, // commented out for now as it causes 100s of warnings, but want to get there eventually
+                //"loopfunc": true, // allow functions to be defined in loops
+                //"sub": true       // don't warn that foo['bar'] should be written as foo.bar
+            },
+            all: {
+                src: ['*/*/*.js'],
+                filter: function(filepath) { // on some developer machines the test coverage HTML report utilities cause further failures
+                    if ((filepath.indexOf("coverage/") !== -1) || (filepath.indexOf("node_modules") !== -1)) {
+                        console.log( "\033[30m  filtered out \033[32m:\033[37m " + filepath + "\033[0m");
+                        return false;
+                    } else {
+                        return true;
+                    }
+                }
+            },
+        },
+        inlinelint: {
+            html: ['*/*/*.html', '!node_modules/*/*.html', '!*/node_modules/*.html'],
+            options: {
+                jshintrc: ".jshintrc"
+                //,reporter: require('jshint-stylish')
+            }
+        },
+        jscs: {
+            src: "*/*/*.js",
+            options: {
+                config: ".jscsrc",
+                reporter: "inline"
+                //,fix: true
+            }
+        }
+    });
+
+    grunt.loadNpmTasks('grunt-simple-mocha');
+    grunt.loadNpmTasks('grunt-contrib-jshint');
+    grunt.loadNpmTasks('grunt-lint-inline');
+    grunt.loadNpmTasks('grunt-jscs');
+
+    grunt.registerTask('default', ['jshint:all', 'inlinelint:html', 'simplemocha:all']);
+    grunt.registerTask('style', ['jscs']);
+};

LICENSE

@@ -1,191 +1,14 @@
-Apache License
-Version 2.0, January 2004
-http://www.apache.org/licenses/
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
 
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
 
-1. Definitions.
+http://www.apache.org/licenses/LICENSE-2.0
 
-"License" shall mean the terms and conditions for use, reproduction, and
-distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright
-owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities
-that control, are controlled by, or are under common control with that entity.
-For the purposes of this definition, "control" means (i) the power, direct or
-indirect, to cause the direction or management of such entity, whether by
-contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising
-permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications, including
-but not limited to software source code, documentation source, and configuration
-files.
-
-"Object" form shall mean any form resulting from mechanical transformation or
-translation of a Source form, including but not limited to compiled object code,
-generated documentation, and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form, made
-available under the License, as indicated by a copyright notice that is included
-in or attached to the work (an example is provided in the Appendix below).
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that
-is based on (or derived from) the Work and for which the editorial revisions,
-annotations, elaborations, or other modifications represent, as a whole, an
-original work of authorship. For the purposes of this License, Derivative Works
-shall not include works that remain separable from, or merely link (or bind by
-name) to the interfaces of, the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including the original version
-of the Work and any modifications or additions to that Work or Derivative Works
-thereof, that is intentionally submitted to Licensor for inclusion in the Work
-by the copyright owner or by an individual or Legal Entity authorized to submit
-on behalf of the copyright owner. For the purposes of this definition,
-"submitted" means any form of electronic, verbal, or written communication sent
-to the Licensor or its representatives, including but not limited to
-communication on electronic mailing lists, source code control systems, and
-issue tracking systems that are managed by, or on behalf of, the Licensor for
-the purpose of discussing and improving the Work, but excluding communication
-that is conspicuously marked or otherwise designated in writing by the copyright
-owner as "Not a Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
-of whom a Contribution has been received by Licensor and subsequently
-incorporated within the Work.
-
-2. Grant of Copyright License.
-
-Subject to the terms and conditions of this License, each Contributor hereby
-grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
-irrevocable copyright license to reproduce, prepare Derivative Works of,
-publicly display, publicly perform, sublicense, and distribute the Work and such
-Derivative Works in Source or Object form.
-
-3. Grant of Patent License.
-
-Subject to the terms and conditions of this License, each Contributor hereby
-grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
-irrevocable (except as stated in this section) patent license to make, have
-made, use, offer to sell, sell, import, and otherwise transfer the Work, where
-such license applies only to those patent claims licensable by such Contributor
-that are necessarily infringed by their Contribution(s) alone or by combination
-of their Contribution(s) with the Work to which such Contribution(s) was
-submitted. If You institute patent litigation against any entity (including a
-cross-claim or counterclaim in a lawsuit) alleging that the Work or a
-Contribution incorporated within the Work constitutes direct or contributory
-patent infringement, then any patent licenses granted to You under this License
-for that Work shall terminate as of the date such litigation is filed.
-
-4. Redistribution.
-
-You may reproduce and distribute copies of the Work or Derivative Works thereof
-in any medium, with or without modifications, and in Source or Object form,
-provided that You meet the following conditions:
-
-You must give any other recipients of the Work or Derivative Works a copy of
-this License; and
-You must cause any modified files to carry prominent notices stating that You
-changed the files; and
-You must retain, in the Source form of any Derivative Works that You distribute,
-all copyright, patent, trademark, and attribution notices from the Source form
-of the Work, excluding those notices that do not pertain to any part of the
-Derivative Works; and
-If the Work includes a "NOTICE" text file as part of its distribution, then any
-Derivative Works that You distribute must include a readable copy of the
-attribution notices contained within such NOTICE file, excluding those notices
-that do not pertain to any part of the Derivative Works, in at least one of the
-following places: within a NOTICE text file distributed as part of the
-Derivative Works; within the Source form or documentation, if provided along
-with the Derivative Works; or, within a display generated by the Derivative
-Works, if and wherever such third-party notices normally appear. The contents of
-the NOTICE file are for informational purposes only and do not modify the
-License. You may add Your own attribution notices within Derivative Works that
-You distribute, alongside or as an addendum to the NOTICE text from the Work,
-provided that such additional attribution notices cannot be construed as
-modifying the License.
-You may add Your own copyright statement to Your modifications and may provide
-additional or different license terms and conditions for use, reproduction, or
-distribution of Your modifications, or for any such Derivative Works as a whole,
-provided Your use, reproduction, and distribution of the Work otherwise complies
-with the conditions stated in this License.
-
-5. Submission of Contributions.
-
-Unless You explicitly state otherwise, any Contribution intentionally submitted
-for inclusion in the Work by You to the Licensor shall be under the terms and
-conditions of this License, without any additional terms or conditions.
-Notwithstanding the above, nothing herein shall supersede or modify the terms of
-any separate license agreement you may have executed with Licensor regarding
-such Contributions.
-
-6. Trademarks.
-
-This License does not grant permission to use the trade names, trademarks,
-service marks, or product names of the Licensor, except as required for
-reasonable and customary use in describing the origin of the Work and
-reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty.
-
-Unless required by applicable law or agreed to in writing, Licensor provides the
-Work (and each Contributor provides its Contributions) on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
-including, without limitation, any warranties or conditions of TITLE,
-NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
-solely responsible for determining the appropriateness of using or
-redistributing the Work and assume any risks associated with Your exercise of
-permissions under this License.
-
-8. Limitation of Liability.
-
-In no event and under no legal theory, whether in tort (including negligence),
-contract, or otherwise, unless required by applicable law (such as deliberate
-and grossly negligent acts) or agreed to in writing, shall any Contributor be
-liable to You for damages, including any direct, indirect, special, incidental,
-or consequential damages of any character arising as a result of this License or
-out of the use or inability to use the Work (including but not limited to
-damages for loss of goodwill, work stoppage, computer failure or malfunction, or
-any and all other commercial damages or losses), even if such Contributor has
-been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability.
-
-While redistributing the Work or Derivative Works thereof, You may choose to
-offer, and charge a fee for, acceptance of support, warranty, indemnity, or
-other liability obligations and/or rights consistent with this License. However,
-in accepting such obligations, You may act only on Your own behalf and on Your
-sole responsibility, not on behalf of any other Contributor, and only if You
-agree to indemnify, defend, and hold each Contributor harmless for any liability
-incurred by, or claims asserted against, such Contributor by reason of your
-accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work
-
-To apply the Apache License to your work, attach the following boilerplate
-notice, with the fields enclosed by brackets "[]" replaced with your own
-identifying information. (Don't include the brackets!) The text should be
-enclosed in the appropriate comment syntax for the file format. We also
-recommend that a file or class name and description of purpose be included on
-the same "printed page" as the copyright notice for easier identification within
-third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-     http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

README.md

@@ -4,110 +4,188 @@ A collection of nodes for [Node-RED](http://nodered.org). See below for a list.
 
 ## Installation
 
-Eventually, the nodes will be npm-installable, but we're not there yet. Until then:
+All of these nodes are available as individual npm packages. See the list below for the
+npm package names, or [search npm](https://www.npmjs.org/search?q=node-red-node-).
+
+This repository acts as an overall store for these nodes - and is not
+intended as a way to install them - unless you really do want some development.
+
+To install - either use the manage palette option in the editor, or change to your Node-RED user directory.
+
+        cd ~/.node-red
+        npm install node-red-node-{filename}
+
+To manually install using this repo:
 
 1. cd into the `nodes` directory of Node-RED
 2. Either:
-  - download the zip of the repository and extract it
-  - run `git clone https://github.com/node-red/node-red-nodes.git`
-3. npm install any of the individual node dependencies
+    - download the zip of the repository and extract it
+    - run `git clone https://github.com/node-red/node-red-nodes.git`
+3. run `npm install` in any of the node subfolders to install individual node's dependencies
 
-This is all too manual, so the sooner we npm-enable this stuff the better
+## Running Tests
+
+Node.js v6 or newer is required. To run tests on all of the nodes you will need the node-red runtime:
+
+    npm i node-red-nodes
+    npm test
 
 ## Contributing
 
-Please read the Contributing section of the main project [README](https://github.com/node-red/node-red/blob/master/README.md)
-
-The key points are:
- - try to follow the conventions we use (all undocumented at the moment just to make it interesting)
- - focus on the UX of the node - make it simple to do simple things and simple to do advanced things. Don't
-   force a user wanting to do simple things have to wade through the advanced things.
- - avoid duplication
-
-### Contributor License Agreement
-
-In order for us to accept pull-requests, the contributor must first complete
-a Contributor License Agreement (CLA). This clarifies the intellectual
-property license granted with any contribution. It is for your protection as a
-Contributor as well as the protection of IBM and its customers; it does not
-change your rights to use your own Contributions for any other purpose.
-
-Once you have created a pull-request, we'll provide a link to the appropriate
-CLA document.
-
-If you are an IBMer, please contact us directly as the contribution process is
-slightly different.
+Now that we support npm installation of nodes we recommend people post their own
+nodes via [npm](https://www.npmjs.org/). Please read the
+[packaging guide notes](http://nodered.org/docs/creating-nodes/packaging.html).
 
+For simple typos and single line fixes please just raise an issue pointing out
+our mistakes. If you need to raise a pull request please read our
+[contribution guidelines](https://github.com/node-red/node-red/blob/master/CONTRIBUTING.md)
+before doing so.
 
 ## Copyright and license
 
-Copyright 2013 IBM Corp. under [the Apache 2.0 license](LICENSE).
+Copyright JS Foundation and other contributors, http://js.foundation under [the Apache 2.0 license](LICENSE).
 
 # Extra Node Information
 
-### Analysis
-
-**72-wordpos** - Analyses the payload and classifies the part-of-speech of each word. The resulting message has msg.pos added with the results. A word may appear in multiple categories (eg, 'great' is both a noun and an adjective).
-
-**74-swearfilter** - Analyses the payload and tries to filter out any messages containing bad swear words. This only operates on payloads of type string. Everything else is blocked.
-
-### Hardware
-
-**37-rpi-piface** - Adds support for the PiFace interface module for Raspberry Pi.
-
-**78-ledborg** - A simple driver for the LEDborg plug on module for Raspberry Pi.
-
-**60-wemo** - Basic node to drive a WeMo socket and switch. Does not use discovery.
-
-**76-blinkstick** - Provides support for the BlinkStick USB LED device.
-
-**77-blink1** - Provides support for the Blink1 USB LED from ThingM.
-
-**78-digiRGB** - Provides support for the DigiSpark RGB USB LED.
-
-**79-sensorTag** - Reads data from the Ti BLE SensorTag device.
-
-**100-heatmiser-in** - Writes settings for temperature and frost protection to Heatmiser thermostats.
-
-**101-heatmiser-out** - Reads settings from Heatmiser thermostats at a polling interval.
-
-**101-scanBLE** - Scans for a particular Bluetooth Low Energy (BLE) device.
-
-**145-BBB-hardware** - A collection of analogue & digital input & output nodes for the Beaglebone Black
-
-### IO
-
-**26-rawserial** - Only really needed for Windows boxes without serialport npm module installed.
-Uses a simple read of the serial port as a file to input data. You **must** set the baud rate etc externally *before* starting Node-RED. This node does not implement pooling of connections so only one instance of each port may be used - so in **or** out but **not** both.
-
-**39-wol** - Sends a Wake-On-LAN magic packet to the mac address specified. You may instead set msg.mac to dynamically set the target device mac to wake up.
-
-**88-ping** - Pings a machine and returns the trip time in mS. Returns false if no response received within 3 seconds, or if the host is unresolveable. Default ping is every 20 seconds but can be configured.
-
-### Social
-
-**69-mpd** - MPD music control nodes. Output node expects payload to be a valid mpc command. Currently only simple commands that expect no reply are supported. Input node creates a payload object with Artist, Album, Title, Genre and Date.
-
-**57-notify** - Uses Growl to provide a desktop popup containing the payload. Only useful on the local machine.
-
-**57-prowl** - Uses Prowl to push the payload to an Apple device that has the Prowl app installed.
-
-**57-pushbullet** - Uses PushBullet to push the payload to an Android device that has the PushBullet app installed.
-
-**92-xmpp** - Connects to an XMPP server to send and receive messages.
-
-### Storage
-
-**67-leveldb** - Uses LevelDB for a simple key value pair database.
-
-**68-mysql** - Allows basic access to a MySQL database. This node uses the **query** operation against the configured database. This does allow both INSERTS and DELETES. By it's very nature it allows SQL injection... *so be careful out there...*
-
-**69-ddbout** - Support output to Amazon DynamoDB.
-
-### Time
-
-**79-suncalc** - Uses the suncalc module to generate an output at sunrise and sunset based on a specified location. Several choices of definition of sunrise and sunset are available,
+**NPM name** - *File-link* - Description
 
 ### Misc
 
-**99-sample** - A sample node with more comments than most to try to help you get started without any other docs...
+**N/A** - *[99-sample](./)* - A sample node with more comments than most to try to help you get started without any other docs...
+
+### Analysis
+
+**node-red-node-badwords** - *[74-swearfilter](analysis/swearfilter)* - Analyses the payload and tries to filter out any messages containing bad swear words. This only operates on payloads of type string. Everything else is blocked.
+
+**node-red-node-wordpos** - *[72-wordpos](analysis/wordpos)* - Analyses the payload and classifies the part-of-speech of each word. The resulting message has msg.pos added with the results. A word may appear in multiple categories (eg, 'great' is both a noun and an adjective).
+
+### Function
+
+**node-red-node-datagenerater** - *[datagenerator](function/datagenerator)*  - A node that can generate dummy data in various formats, names, addresses, emails, numbers, words, etc
+
+**node-red-node-pidcontrol** - *[pidcontrol](function/PID)*  - A PID control node for numeric inputs - provides simple contoll loop feedback capability.
+
+**node-red-node-random** - *[random](function/random)*  - A simple random number generator - can generate integers for x to y - or floats between x and y.
+
+**node-red-node-rbe** - *[rbe](function/rbe)*  - A simple node to provide report by exception and deadband / bandgap capability for simple inputs.
+
+**node-red-node-smooth** - *[17-smooth](function/smooth)*  - A simple node to provide various functions across several previous values, including max, min, mean, high and low pass filters.
+
+
+### Hardware
+
+**node-red-node-arduino** - *[35-arduino](hardware/Arduino)* - A collection of analogue & digital input & output nodes for the Arduino board - uses firmata protocol to talk to the board.
+
+**node-red-node-beaglebone** - *[145-BBB-hardware](hardware/BBB)* - A collection of analogue & digital input & output nodes for the [Beaglebone Black](http://beagleboard.org/black).
+
+**node-red-node-blink1** - *[77-blink1](hardware/blink1)* - Provides support for the [Blink1](http://blink1.thingm.com/) USB LED from ThingM.
+
+**node-red-node-blinkstick** - *[76-blinkstick](hardware/blinkstick)* - Provides support for the [BlinkStick](http://www.blinkstick.com/) USB LED device.
+
+**node-red-node-digirgb** - *[78-digiRGB](hardware/digiRGB)* - Provides support for the DigiSpark RGB USB LED.
+
+**node-red-node-heatmiser** - *[100-heatmiser-in](hardware/heatmiser)* - Read and writes settings for temperature and frost protection to Heatmiser thermostats.
+
+**node-red-node-intel-galileo** - *[mraa-spio](hardware/intel)* - A collection of analogue & digital input & output nodes for the Intel Galileo and Edison.
+
+**node-red-node-ledborg** - *[78-ledborg](hardware/LEDborg)* - A simple driver for the [LEDborg](https://www.piborg.org/ledborg) plug on module for Raspberry Pi.
+
+**node-red-node-makeymakey** - *[42-makey](hardware/makey)* - A Node-RED node to read from a [MakeyMakey](http://www.makeymakey.com/) input device.
+
+**node-red-node-pi-gpiod** - *[pigpiod](hardware/pigpiod)* - An alternative to the default PI GPIO nodes that allows remote access - so a host machine can access a remote Pi (via network) and is better for driving multiple servos.
+
+**node-red-node-pi-mcp3008** - *[pimcp3008](hardware/mcp3008)* - Allows A Raspberry Pi to node to read from MCP300x series Analogue to Digital Converter chips via the SPI bus.
+
+**node-red-node-pi-neopixel** - *[neopixel](hardware/neopixel)* - Allows A Raspberry Pi to drive a strip of NeoPixels directly.
+
+**node-red-node-pi-unicorn-hat** - *[unicorn](hardware/unicorn)* - Lets a Raspbeery Pi control a Pimorini Unicorn HAT 8x8 LED display.
+
+**node-red-node-pibrella** - *[38-rpi-pibrella](hardware/Pibrella)* - Controls a [Pibrella](http://pibrella.com/) add-on board for a Raspberry-Pi.
+
+**node-red-node-piface** - *[37-rpi-piface](hardware/PiFace)* - Adds support for the [PiFace](http://www.piface.org.uk/) interface module for Raspberry Pi.
+
+**node-red-node-piliter** - *[39-rpi-piliter](hardware/PiLiter)* - Controls a Pimorini Pi-LITEr 8 LED add-on board for a Raspberry-Pi.
+
+**node-red-node-sensortag** - *[79-sensorTag](hardware/sensorTag)* - Reads data from the Ti Bluetooh Low Energy (BLE) SensorTag device.
+
+**node-red-node-wemo** - *[60-wemo](hardware/wemo)* - Basic node to drive a [WeMo](http://www.belkin.com/us/Products/home-automation/c/wemo-home-automation/) socket and switch. Does not use discovery.
+
+**N/A** - *[101-scanBLE](hardware/scanBLE)* - Scans for a particular Bluetooth Low Energy (BLE) device.
+
+### I/O
+
+**node-red-node-discovery** - *[mdns](io/mdns)* - discovers other Avahi/Bonjour services on the network.
+
+**node-red-node-emoncms** - *[88-emoncms](io/emoncms)* - Adds node to post to an [Emoncms](http://emoncms.org/) server.
+
+**node-red-node-mqlight** - *[mqlight](io/mqlight)* - Adds nodes to send and receive using MQlight.
+
+**node-red-node-ping** - *[88-ping](io/ping)* - Pings a machine and returns the trip time in mS. Returns false if no response received within 3 seconds, or if the host is unresolveable. Default ping is every 20 seconds but can be configured.
+
+**node-red-node-serialport** - *[25-serial](io/serialport)* - Node to send messages to and receive messages from a physical serial port.
+
+**node-red-node-snmp** - *[snmp](io/snmp)* - Adds simple snmp receivers for single OIDs or OID tables.
+
+**node-red-node-stomp** - *[18-stomp](io/stomp)* - A Node-RED node to publish and subscribe to and from a [STOMP server](https://stomp.github.io/implementations.html#STOMP_Servers).
+
+**node-red-node-wol** - *[39-wol](io/wol)* - Sends a Wake-On-LAN magic packet to the mac address specified. You may instead set msg.mac to dynamically set the target device mac to wake up.
+
+
+### Parsers
+
+**node-red-node-base64** - *[70-base64.js](parsers/base64)* - Converts a payload to/from base64 encoded format.
+
+**node-red-node-geohash** - *[70-geohash.js](parsers/geohash)* - Converts a lat, lon payload to/from geohash format.
+
+**node-red-node-msgpack** - *[70-msgpack.js](parsers/msgpack)* - Converts a payload to/from msgpack binary packed format.
+
+**node-red-node-what3words** - *[what3words.js](parsers/what3words)* - Encodes or Decodes a lat, lon position into what3words text format.
+
+### Social
+
+**node-red-node-dweetio** - *[55-dweetio](social/dweetio)* - Uses [dweetio](https://dweet.io/) to send/receive messages.
+
+**node-red-node-email** - *[61-email](social/email)* - Sends and receives simple emails from services like gmail or smtp or imap servers.
+
+**node-red-node-feedparser** - *[32-feedparse](social/feedparser)* - Reads messages from an atom or rss feed.
+
+**node-red-node-irc** - *[91-irc](social/irc)* - Connects to an IRC server to send and receive messages.
+
+**node-red-node-nma** - *[57-nma](social/nma)* - DEPRECATED as NMA closed down operations.
+
+**node-red-node-notify** - *[57-notify](social/notify)* - Uses [Growl](http://growl.info/) to provide a desktop popup containing the payload. Only useful on the local Apple machine.
+
+**node-red-node-prowl** - *[57-prowl](social/prowl)* - Uses [Prowl](http://www.prowlapp.com/) to push the payload to an Apple device that has the Prowl app installed.
+
+**node-red-node-pushbullet** - *[57-pushbullet](social/pushbullet)* - Uses [PushBullet](https://www.pushbullet.com/) to push the payload to an Android device that has the [PushBullet](https://www.pushbullet.com/) app installed.
+
+**node-red-node-pusher** - *[114-pusher](social/pusher)* - Publish-Subscribe to a [Pusher](http://pusher.com/) channel/event.
+
+**node-red-node-pushover** - *[57-pushover](social/pushover)* - Sends alerts via [Pushover](https://pushover.net/).
+
+**node-red-node-twilio** - *[56-twilio](social/twilio)* - Uses [Twilio](https://www.twilio.com/) service to send/receive text messages.
+
+**node-red-node-twitter** - *[27-twitter](social/twitter)* - Listens to Twitter feeds and can also send tweets. (**NOTE**: this will break soon when Twitter remove their streaming API)
+
+**node-red-node-xmpp** - *[92-xmpp](social/xmpp)* - Connects to an XMPP server to send and receive messages.
+
+
+### Storage
+
+**node-red-node-leveldb** - *[67-leveldb](storage/leveldb)* - Uses LevelDB for a simple key value pair database.
+
+**node-red-node-mysql** - *[68-mysql](storage/mysql)* - Allows basic access to a MySQL database. This node uses the **query** operation against the configured database. This does allow both INSERTS and DELETES. By it's very nature it allows SQL injection... *so be careful out there...*
+
+**node-red-node-sqlite** - *[sqlite](storage/sqlite)* - Supports read and write to a local sqlite database.
+
+### Time
+
+**node-red-node-suncalc** - *[79-suncalc](time/suncalc)* - Uses the suncalc module to generate an output at sunrise and sunset based on a specified location. Several choices of definition of sunrise and sunset are available.
+
+**node-red-node-timeswitch** - *[timeswitch](time/timeswitch)* - Lets the user set simple repeating timers for example for simple heating control, etc.
+
+### Utility
+
+**node-red-node-daemon** - *[daemon](utility/daemon)* - starts up (calls) a long running system program and pipes STDIN, STDOUT and STDERR to and from that process. Good for monitoring long running command line applications,
+
+**node-red-node-exif** - *[94-exif](utility/exif)* - Extracts GPS and other EXIF information from a passed in jpeg image,

analysis/mlsentiment/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2019 JS Foundation and other contributors, https://js.foundation/
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

analysis/mlsentiment/README.md

@@ -0,0 +1,33 @@
+node-red-node-multilang-sentiment
+=================================
+
+A <a href="http://nodered.org" target="new">Node-RED</a> node that scores incoming words
+using the AFINN-165 wordlist and attaches a sentiment.score property to the msg.
+
+This is similar to the default sentiment node but supports many more languages at the cost of using more disk space. (approx 11MB)
+
+Install
+-------
+
+Either use the Menu - Manage palette - Install option in the editor or run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-multilang-sentiment
+
+
+Usage
+-----
+
+Uses the AFINN-165 wordlist to attempt to assign scores to words in text.
+
+Attaches `msg.sentiment` to the msg and within that `msg.sentiment.score` holds the score.
+
+Supports multiple languages. These can be preselected in the node configuration. You can also set it so that `msg.lang` can be used to set the language dynamically if required. The cldr language codes supported are:
+
+    af, am, ar, az, be, bg, bn, bs, ca, ceb, co, cs, cy, da, de, el, en, eo, es, et, eu, fa, fi,
+    fr, fy, ga, gd, gl, gu, ha, haw, hi, hmn, hr, ht, hu, hy, id, ig, is, it, iw, ja, jw, ka, kk, km, kn, ko, ku, ky, la, lb, lo, lt,
+    lv, mg, mi, mk, ml, mn, mr, ms, mt, my, ne, nl, no, ny, pa, pl, ps, pt, ro, ru, sd, si, sk, sl, sm, sn, so, sq, sr, st, su, sv,
+    sw, ta, te, tg, th, tl, tr, uk, ur, uz, vi, xh, yi, yo, zh, zh-tw, zu
+
+A score greater than zero is positive and less than zero is negative. The score typically ranges from -5 to +5, but can go higher and lower.
+
+See the <a href="https://github.com/marcellobarile/multilang-sentiment/blob/develop/README.md" target="_blank">Multilang Sentiment docs here</a>.</p>

analysis/mlsentiment/locales/de/mlsentiment.json

@@ -0,0 +1,8 @@
+{
+    "mlsentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "Sprache"
+        }
+    }
+}

analysis/mlsentiment/locales/en-US/mlsentiment.html

@@ -0,0 +1,31 @@
+
+<script type="text/html" data-help-name="mlsentiment">
+    <p>Analyses the chosen property, default <code>payload</code>, and adds a <code>sentiment</code> object.</p>
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>sentiment <span class="property-type">object</span></dt>
+        <dd>contains the resulting AFINN-165 sentiment.</dd>
+        <dt>sentiment.score <span class="property-type">number</span></dt>
+        <dd>the sentiment score.</dd>
+    </dl>
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>words <span class="property-type">object</span></dt>
+        <dd>besides sending a raw string in msg.payload, an object of words and scores to override or add words can be supplied - <code>{ word:score,... }</code>.</dd>
+        <dt>tokens <span class="property-type">object</span></dt>
+        <dd>a `tokens` object allows custom tokenizers which may be required by some languages - <code>{ ['世界',...] }</code>.</dd>
+    </dl>
+    <dl class="message-properties">
+        <dt>lang <span class="property-type">string</span></dt>
+        <dd>Two letter cldr code to specify the language to use - from the list below</dd>
+    </dl>
+    <h3>Details</h3>
+    <p>A score greater than zero is positive and less than zero is negative.</p>
+    <p>The score typically ranges from -5 to +5, but can go higher and lower.</p>
+    <p>See <a href="https://github.com/marcellobarile/multilang-sentiment/blob/develop/README.md" target="_blank">the Sentiment docs here</a>.</p>
+    <p>The node can also be configured to let the language be specified by setting <code>msg.lang</code> to one of the codes below</p>
+    <p>The language codes supported are - af, am, ar, az, be, bg, bn, bs, ca, ceb, co, cs, cy, da, de, el, en, eo, es, et, eu, fa, fi,
+    fr, fy, ga, gd, gl, gu, ha, haw, hi, hmn, hr, ht, hu, hy, id, ig, is, it, iw, ja, jw, ka, kk, km, kn, ko, ku, ky, la, lb, lo, lt,
+    lv, mg, mi, mk, ml, mn, mr, ms, mt, my, ne, nl, no, ny, pa, pl, ps, pt, ro, ru, sd, si, sk, sl, sm, sn, so, sq, sr, st, su, sv,
+    sw, ta, te, tg, th, tl, tr, uk, ur, uz, vi, xh, yi, yo, zh, zh-tw, zu</p>
+</script>

analysis/mlsentiment/locales/en-US/mlsentiment.json

@@ -0,0 +1,8 @@
+{
+    "mlsentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "Language"
+        }
+    }
+}

analysis/mlsentiment/locales/ja/mlsentiment.html

@@ -0,0 +1,22 @@
+
+<script type="text/html" data-help-name="mlsentiment">
+    <p>指定したプロパティ(デフォルトは<code>payload</code>)を分析し、<code>sentiment</code>オブジェクトを追加します。</p>
+    <h3>出力</h3>
+    <dl class="message-properties">
+        <dt>sentiment <span class="property-type">オブジェクト</span></dt>
+        <dd>AFINN-165による感情分析の結果</dd>
+        <dt>sentiment.score <span class="property-type">数値</span></dt>
+        <dd>感情分析スコア</dd>
+    </dl>
+    <h3>入力</h3>
+    <dl class="message-properties">
+        <dt>words <span class="property-type">オブジェクト</span></dt>
+        <dd>単語スコアの上書きをするためのオブジェクト - <code>{ word:score,... }</code></dd>
+        <dt>tokens <span class="property-type">object</span></dt>
+        <dd>一部の言語で必要となるカスタム トークナイザーが可能になります - <code>{ ['世界',...] }</code>.</dd>
+    </dl>
+    <h3>詳細</h3>
+    <p>ゼロ以上のスコアはポジティブ、ゼロ以下はネガティブを意味します。</p>
+    <p>スコアの範囲は通常-5から+5ですが、より大きかったり小さかったりすることもあります。</p>
+    <p>詳細は<a href="https://github.com/marcellobarile/multilang-sentiment/blob/develop/README.md" target="_blank">the Multilang-Sentiment docs here</a>を参照してください。</p>
+</script>

analysis/mlsentiment/locales/ja/mlsentiment.json

@@ -0,0 +1,8 @@
+{
+    "mlsentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "言語"
+        }
+    }
+}

analysis/mlsentiment/mlsentiment.html

@@ -0,0 +1,147 @@
+
+<script type="text/html" data-template-name="mlsentiment">
+    <div class="form-row">
+        <label for="node-input-lang"><i class="fa fa-language"></i> <span data-i18n="mlsentiment.label.language"></span></label>
+        <select type="text" id="node-input-lang" style="width:70%;">
+            <option value="">set by msg.lang</option>
+            <option value="af">Afrikaans</option>
+            <option value="sq">Albanian</option>
+            <option value="am">Amharic</option>
+            <option value="ar">Arabic</option>
+            <option value="hy">Armenian</option>
+            <option value="az">Azerbaijani</option>
+            <option value="bn">Bangla</option>
+            <option value="eu">Basque</option>
+            <option value="be">Belarusian</option>
+            <option value="bs">Bosnian</option>
+            <option value="bg">Bulgarian</option>
+            <option value="my">Burmese</option>
+            <option value="ca">Catalan</option>
+            <option value="ceb">Cebuano</option>
+            <option value="zh">Chinese</option>
+            <option value="zh-tw">Chinese (Taiwanese)</option>
+            <option value="co">Corsican</option>
+            <option value="hr">Croatian</option>
+            <option value="cs">Czech</option>
+            <option value="da">Danish</option>
+            <option value="nl">Dutch</option>
+            <option value="en">English</option>
+            <option value="eo">Esperanto</option>
+            <option value="et">Estonian</option>
+            <option value="fi">Finnish</option>
+            <option value="fr">French</option>
+            <option value="fy">Frisian</option>
+            <option value="gl">Galician</option>
+            <option value="ka">Georgian</option>
+            <option value="de">German</option>
+            <option value="el">Greek</option>
+            <option value="gu">Gujarati</option>
+            <option value="ht">Haitian Creole</option>
+            <option value="ha">Hausa</option>
+            <option value="haw">Hawaiian</option>
+            <option value="hi">Hindi</option>
+            <option value="hmn">Hmong</option>
+            <option value="hu">Hungarian</option>
+            <option value="is">Icelandic</option>
+            <option value="ig">Igbo</option>
+            <option value="id">Indonesian</option>
+            <option value="ga">Irish</option>
+            <option value="it">Italian</option>
+            <option value="ja">Japanese</option>
+            <option value="kn">Kannada</option>
+            <option value="kk">Kazakh</option>
+            <option value="km">Khmer</option>
+            <option value="ko">Korean</option>
+            <option value="ku">Kurdish</option>
+            <option value="ky">Kyrgyz</option>
+            <option value="lo">Lao</option>
+            <option value="la">Latin</option>
+            <option value="lv">Latvian</option>
+            <option value="lt">Lithuanian</option>
+            <option value="lb">Luxembourgish</option>
+            <option value="mk">Macedonian</option>
+            <option value="mg">Malagasy</option>
+            <option value="ms">Malay</option>
+            <option value="ml">Malayalam</option>
+            <option value="mt">Maltese</option>
+            <option value="mi">Maori</option>
+            <option value="mr">Marathi</option>
+            <option value="mn">Mongolian</option>
+            <option value="ne">Nepali</option>
+            <option value="no">Norwegian</option>
+            <option value="ny">Nyanja</option>
+            <option value="ps">Pashto</option>
+            <option value="fa">Persian</option>
+            <option value="pl">Polish</option>
+            <option value="pt">Portuguese</option>
+            <option value="pa">Punjabi</option>
+            <option value="ro">Romanian</option>
+            <option value="ru">Russian</option>
+            <option value="sm">Samoan</option>
+            <option value="gd">Scottish Gaelic</option>
+            <option value="sr">Serbian</option>
+            <option value="sn">Shona</option>
+            <option value="sd">Sindhi</option>
+            <option value="si">Sinhala</option>
+            <option value="sk">Slovak</option>
+            <option value="sl">Slovenian</option>
+            <option value="so">Somali</option>
+            <option value="st">Southern Sotho</option>
+            <option value="es">Spanish</option>
+            <option value="su">Sundanese</option>
+            <option value="sw">Swahili</option>
+            <option value="sv">Swedish</option>
+            <option value="tl">Tagalog</option>
+            <option value="tg">Tajik</option>
+            <option value="ta">Tamil</option>
+            <option value="te">Telugu</option>
+            <option value="th">Thai</option>
+            <option value="tr">Turkish</option>
+            <option value="uk">Ukrainian</option>
+            <option value="ur">Urdu</option>
+            <option value="uz">Uzbek</option>
+            <option value="vi">Vietnamese</option>
+            <option value="cy">Welsh</option>
+            <option value="xh">Xhosa</option>
+            <option value="yi">Yiddish</option>
+            <option value="yo">Yoruba</option>
+            <option value="zu">Zulu</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-property"><i class="fa fa-ellipsis-h"></i> <span data-i18n="node-red:common.label.property"></span></label>
+        <input type="text" id="node-input-property" style="width:70%;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('mlsentiment',{
+        category: 'analysis-function',
+        color:"#E6E0F8",
+        defaults: {
+            name: {value:""},
+            property: {value:"payload",required:true},
+            lang: {value:"en"}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "arrow-in.png",
+        paletteLabel: "multilang sentiment",
+        label: function() {
+            return this.name||"multilang sentiment";
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        },
+        oneditprepare: function() {
+            if (this.property === undefined) {
+                $("#node-input-property").val("payload");
+            }
+            $("#node-input-property").typedInput({default:'msg',types:['msg']});
+        }
+    });
+</script>

analysis/mlsentiment/mlsentiment.js

@@ -0,0 +1,25 @@
+
+module.exports = function (RED) {
+    "use strict";
+    var multilangsentiment = require('multilang-sentiment');
+
+    function MultiLangSentimentNode(n) {
+        RED.nodes.createNode(this, n);
+        this.lang = n.lang;
+        this.property = n.property || "payload";
+        var node = this;
+
+        this.on("input", function (msg) {
+            var value = RED.util.getMessageProperty(msg, node.property);
+            if (value !== undefined) {
+                multilangSentiment(value, node.lang || msg.lang || 'en', { 'words': msg.words || null, 'tokens': msg.tokens || null }, function (err, result) {
+                    msg.sentiment = result;
+                    msg.sentiment.comparative = msg.sentiment.score / msg.sentiment.tokens.length;      // temporarily addresses an issue in v2.0.0: https://github.com/marcellobarile/multilang-sentiment/issues/10
+                    node.send(msg);
+                });
+            }
+            else { node.send(msg); } // If no matching property - just pass it on.
+        });
+    }
+    RED.nodes.registerType("mlsentiment", MultiLangSentimentNode);
+}

analysis/mlsentiment/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "node-red-node-multilang-sentiment",
+    "version": "0.2.0",
+    "description": "A Node-RED node that uses the AFINN-165 wordlists for sentiment analysis of words translated into multiple languages including emoji.",
+    "dependencies": {
+        "multilang-sentiment": "^2.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/analysis/mlsentiment"
+    },
+    "license": "Apache-2.0",
+    "keywords": [
+        "node-red",
+        "sentiment",
+        "anaylsis",
+        "AFINN",
+        "emoji"
+    ],
+    "node-red": {
+        "nodes": {
+            "mlsentiment": "mlsentiment.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    },
+    "contributors" : [
+        "Chuan Khoo <khoo.chuan@gmail.com> (https://chuank.com)"
+    ]
+}

analysis/sentiment/72-sentiment.html

@@ -0,0 +1,36 @@
+<script type="text/html" data-template-name="sentiment">
+    <div class="form-row">
+        <label for="node-input-property"><i class="fa fa-ellipsis-h"></i> <span data-i18n="node-red:common.label.property"></span></label>
+        <input type="text" id="node-input-property" style="width:70%;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('sentiment',{
+        category: 'analysis-function',
+        color:"#E6E0F8",
+        defaults: {
+            name: {value:""},
+            property: {value:"payload",required:true}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "arrow-in.png",
+        label: function() {
+            return this.name||"sentiment";
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        },
+        oneditprepare: function() {
+            if (this.property === undefined) {
+                $("#node-input-property").val("payload");
+            }
+            $("#node-input-property").typedInput({default:'msg',types:['msg']});
+        }
+    });
+</script>

analysis/sentiment/72-sentiment.js

@@ -0,0 +1,22 @@
+module.exports = function(RED) {
+    "use strict";
+    var sentiment = require('sentiment');
+
+    function SentimentNode(n) {
+        RED.nodes.createNode(this,n);
+        this.property = n.property||"payload";
+        var node = this;
+
+        this.on("input", function(msg) {
+            var value = RED.util.getMessageProperty(msg,node.property);
+            if (value !== undefined) {
+                sentiment(value, msg.overrides || null, function (err, result) {
+                    msg.sentiment = result;
+                    node.send(msg);
+                });
+            }
+            else { node.send(msg); } // If no matching property - just pass it on.
+        });
+    }
+    RED.nodes.registerType("sentiment",SentimentNode);
+}

analysis/sentiment/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016, 2019 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

analysis/sentiment/README.md

@@ -0,0 +1,26 @@
+node-red-node-sentiment
+========================
+
+A <a href="http://nodered.org" target="new">Node-RED</a> node that scores incoming words
+using the AFINN-165 wordlist and attaches a sentiment.score property to the msg.
+
+NOTE: There is also a multi-language version available - **node-red-node-multilang-sentiment**.
+
+Install
+-------
+
+This is a node that should be installed by default by Node-RED so you should not have to install it manually. If you do then run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-sentiment
+
+
+Usage
+-----
+
+Uses the AFINN-165 wordlist to attempt to assign scores to words in text.
+
+Attaches `msg.sentiment` to the msg and within that `msg.sentiment.score` holds the score.
+
+A score greater than zero is positive and less than zero is negative. The score typically ranges from -5 to +5, but can go higher and lower.
+
+See the <a href="https://github.com/thisandagain/sentiment/blob/develop/README.md" target="_blank">Sentiment docs here</a>.</p>

analysis/sentiment/locales/de/72-sentiment.json

@@ -0,0 +1,8 @@
+{
+    "sentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "Sprache"
+        }
+    }
+}

analysis/sentiment/locales/en-US/72-sentiment.html

@@ -0,0 +1,20 @@
+<script type="text/html" data-help-name="sentiment">
+    <p>Analyses the chosen property, default <code>payload</code>, and adds a <code>sentiment</code> object.</p>
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>sentiment <span class="property-type">object</span></dt>
+        <dd>contains the resulting AFINN-111 sentiment.</dd>
+        <dt>sentiment.score <span class="property-type">number</span></dt>
+        <dd>the sentiment score.</dd>
+    </dl>
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>overrides <span class="property-type">object</span></dt>
+        <dd>an object of word score overrides can be supplied - <code>{ word:score,... }</code>.</dd>
+    </dl>
+    <h3>Details</h3>
+    <p>A score greater than zero is positive and less than zero is negative.</p>
+    <p>The score typically ranges from -5 to +5, but can go higher and lower.</p>
+    <p>See <a href="https://github.com/thisandagain/sentiment/blob/master/README.md" target="_blank">the Sentiment docs here.</a>.</p>
+    <p><b>Note</b>: There is also a multi-language version available - <b>node-red-node-multilang-sentiment</b></p>
+</script>

analysis/sentiment/locales/en-US/72-sentiment.json

@@ -0,0 +1,8 @@
+{
+    "sentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "Language"
+        }
+    }
+}

analysis/sentiment/locales/ja/72-sentiment.html

@@ -0,0 +1,35 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="sentiment">
+    <p>指定したプロパティ(デフォルトは<code>payload</code>)を分析し、<code>sentiment</code>オブジェクトを追加します。</p>
+    <h3>出力</h3>
+    <dl class="message-properties">
+        <dt>sentiment <span class="property-type">オブジェクト</span></dt>
+        <dd>AFINN-111による感情分析の結果</dd>
+        <dt>sentiment.score <span class="property-type">数値</span></dt>
+        <dd>感情分析スコア</dd>
+    </dl>
+    <h3>入力</h3>
+    <dl class="message-properties">
+        <dt>overrides <span class="property-type">オブジェクト</span></dt>
+        <dd>単語スコアの上書きをするためのオブジェクト - <code>{ word:score,... }</code></dd>
+    </dl>
+    <h3>詳細</h3>
+    <p>ゼロ以上のスコアはポジティブ、ゼロ以下はネガティブを意味します。</p>
+    <p>スコアの範囲は通常-5から+5ですが、より大きかったり小さかったりすることもあります。</p>
+    <p>詳細は<a href="https://github.com/thisandagain/sentiment/blob/master/README.md" target="_blank">the Sentiment docs here</a>を参照してください。</p>
+</script>

analysis/sentiment/locales/ja/72-sentiment.json

@@ -0,0 +1,8 @@
+{
+    "sentiment": {
+        "sentiment": "sentiment",
+        "label": {
+            "language": "言語"
+        }
+    }
+}

analysis/sentiment/package.json

@@ -0,0 +1,25 @@
+{
+    "name"          : "node-red-node-sentiment",
+    "version"       : "0.1.6",
+    "description"   : "A Node-RED node that uses the AFINN-165 wordlists for sentiment analysis of words.",
+    "dependencies"  : {
+        "sentiment" : "2.1.0"
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory" : "tree/master/analysis/sentiment"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "sentiment", "anaylsis", "AFINN" ],
+    "node-red" : {
+        "nodes" : {
+            "sentiment": "72-sentiment.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

analysis/swearfilter/74-swearfilter.html

@@ -1,28 +1,13 @@
-<!--
-  Copyright 2013 IBM Corp.
 
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
--->
-
-<script type="text/x-red" data-template-name="badwords">
+<script type="text/html" data-template-name="badwords">
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="badwords">
-    <p>Analyses the <b>msg.payload</b> and tries to filter out any messages containing bad swear words...</p>
+<script type="text/html" data-help-name="badwords">
+    <p>Analyses the <code>msg.payload</code> and tries to filter out any messages containing bad swear words...</p>
     <p><b>Note:</b> this only operates on payloads of type <b>string</b>. Everything else is blocked.</p>
 </script>
 

analysis/swearfilter/74-swearfilter.js

@@ -1,31 +1,17 @@
-/**
- * Copyright 2013 IBM Corp.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- **/
 
-var RED = require(process.env.NODE_RED_HOME+"/red/red");
-var badwords = require('badwords');
-if (badwords.length == 0 ) { return; }
-var badwordsRegExp = require('badwords/regexp');
+module.exports = function(RED) {
+    "use strict";
 
-function BadwordsNode(n) {
-    RED.nodes.createNode(this,n);
-    var node = this;
-    this.on("input", function(msg) {
-        if (typeof msg.payload === "string") {
-            if ( !badwordsRegExp.test(msg.payload) ) { node.send(msg); }
-        }
-    });
+    function BadwordsNode(n) {
+        RED.nodes.createNode(this,n);
+        var badwordsRegExp = require('badwords/regexp');
+        var node = this;
+        node.on("input", function(msg) {
+            if (typeof msg.payload === "string") {
+                badwordsRegExp.lastIndex = 0
+                if ( !badwordsRegExp.test(msg.payload) ) { node.send(msg); }
+            }
+        });
+    }
+    RED.nodes.registerType("badwords",BadwordsNode);
 }
-RED.nodes.registerType("badwords",BadwordsNode);

analysis/swearfilter/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

analysis/swearfilter/README.md

@@ -0,0 +1,21 @@
+node-red-node-badwords
+======================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that attempts to filter out messages containing swearwords.
+
+Install
+-------
+
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-badwords
+
+
+Usage
+-----
+
+Uses the badwords npm to attempt to filter out messages containing swearwords.
+
+Analyses the `msg.payload` and tries to filter out any messages containing bad swear words. If the payload contains a bad word then the whole message is blocked.
+
+**Note** : this only operates on payloads of type <b>string</b>. Everything else is blocked.

analysis/swearfilter/package.json

@@ -0,0 +1,25 @@
+{
+    "name"          : "node-red-node-badwords",
+    "version"       : "0.1.0",
+    "description"   : "A Node-RED node that attempts to filter out messages containing swearwords.",
+    "dependencies"  : {
+        "badwords"   : "^1.0.0"
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/analysis/swearfilter"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "badwords", "swearfilter" ],
+    "node-red"      : {
+        "nodes"     : {
+            "badwords": "74-swearfilter.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

analysis/wordpos/72-wordpos.html

@@ -1,31 +1,16 @@
-<!--
-  Copyright 2013 IBM Corp.
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
--->
 
 <script type="text/x-red" data-template-name="wordpos">
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
-    <div class="form-tips">Adds <b>msg.pos</b> as the anaylsis result.
+    <div class="form-tips">Adds <code>msg.pos</code> as the anaylsis result.
     </div>
 </script>
 
 <script type="text/x-red" data-help-name="wordpos">
-    <p>Analyses <b>msg.payload</b> and classifies the part-of-speech of each word.</p>
-    <p>The resulting message has <b>msg.pos</b> added with the results:</p>
+    <p>Analyses <code>msg.payload</code> and classifies the part-of-speech of each word.</p>
+    <p>The resulting message has <code>msg.pos</code> added with the results:</p>
     <pre>{
     nouns:[],
     verbs:[],

analysis/wordpos/72-wordpos.js

@@ -1,31 +1,18 @@
-/**
- * Copyright 2013 IBM Corp.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- **/
 
-var RED = require(process.env.NODE_RED_HOME+"/red/red");
-var WordPos = require('wordpos');
-var wordpos = new WordPos();
+module.exports = function(RED) {
+    "use strict";
+    var WordPos = require('wordpos');
+    var wordpos = new WordPos();
 
-function WordPOSNode(n) {
-    RED.nodes.createNode(this,n);
-    this.on("input", function(msg) {
-        var node = this;
-        wordpos.getPOS(msg.payload, function (result) {
-            msg.pos = result;
-            node.send(msg);
+    function WordPOSNode(n) {
+        RED.nodes.createNode(this,n);
+        this.on("input", function(msg) {
+            var node = this;
+            wordpos.getPOS(msg.payload, function (result) {
+                msg.pos = result;
+                node.send(msg);
+            });
         });
-    });
+    }
+    RED.nodes.registerType("wordpos",WordPOSNode);
 }
-RED.nodes.registerType("wordpos",WordPOSNode);

analysis/wordpos/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

analysis/wordpos/README.md

@@ -0,0 +1,27 @@
+node-red-node-wordpos
+=====================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that breaks a sentence into the various parts of (English) speech.
+
+Install
+-------
+
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-wordpos
+
+
+Usage
+-----
+
+Uses the wordpos npm to analyse the `msg.payload` and classify the part-of-speech of each word.
+
+The resulting message has a `msg.pos` object added with the results split into the following:
+
+    nouns:[],
+    verbs:[],
+    adjectives:[],
+    adverbs:[],
+    rest:[]
+
+**Note:** a word may appear in multiple POS (eg, 'great' is both a noun and an adjective).

analysis/wordpos/package.json

@@ -0,0 +1,25 @@
+{
+    "name"          : "node-red-node-wordpos",
+    "version"       : "0.0.4",
+    "description"   : "A Node-RED node that breaks a sentence into the various parts of (English) speech.",
+    "dependencies"  : {
+        "wordpos"   : "0.1.*"
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory" : "tree/master/analysis/wordpos"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "wordpos" ],
+    "node-red"      : {
+        "nodes"     : {
+            "wordpos": "72-wordpos.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

coverall

@@ -0,0 +1,3 @@
+# check coverage of tests... and browse report
+nyc --check-coverage --reporter=html grunt
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome coverage/index.html

function/PID/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

function/PID/README.md

@@ -0,0 +1,26 @@
+node-red-node-pidcontrol
+========================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that provides a simple PID controller.
+
+Install
+-------
+
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+        npm i node-red-node-pidcontrol
+
+
+Usage
+-----
+
+PID controller node.
+
+This node ONLY expects a numeric `msg.payload` containing the current reading.
+
+It will output the correction that needs to be applied in order to move to the preset **set point** value.
+
+The damping factors are typically in the range 0 - 1.
+See <a href="https://en.wikipedia.org/wiki/PID_controller" target="_new">Wikipedia</a> for more details on PID controllers.
+
+The **set point** may be overridden by `msg.setpoint`. If you do so the edit box value can be used as the initial value.

function/PID/locales/en-US/pidcontrol.html

@@ -0,0 +1,8 @@
+
+<script type="text/html" data-help-name="PID control">
+    <p>A PID controller node.</p>
+    <p>This node ONLY expects a numeric <code>msg.payload</code> containing the current reading.
+    It will output the correction that needs to be applied in order to move to the preset <i>set point</i> value.</p>
+    <p>See <a href="https://en.wikipedia.org/wiki/PID_controller" target="_new">Wikipedia</a> for more details.</p>
+    <p>The <i>set point</i> may be overridden by <code>msg.setpoint</code>. If you do so the edit box value can be used as the initial value.</p>
+</script>

function/PID/package.json

@@ -0,0 +1,25 @@
+{
+    "name"          : "node-red-node-pidcontrol",
+    "version"       : "0.0.4",
+    "description"   : "A Node-RED node that that provides a simple PID controller.",
+    "dependencies"  : {
+    "node-pid-controller": "0.0.3"
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/function/PID"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "PID", "control" ],
+    "node-red"      : {
+        "nodes"     : {
+            "PID control": "pidcontrol.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

function/PID/pidcontrol.html

@@ -0,0 +1,48 @@
+
+<script type="text/html" data-template-name="PID control">
+    <div class="form-row">
+        <label for="node-input-target" style="width:120px;"><i class="fa fa-dot-circle-o"></i> Set Point</label>
+        <input type="text" id="node-input-target" placeholder="target value" style="width:60%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-kp" style="width:120px;"><font size=+1>K<sub>proportional</sub></font></label>
+        <input type="text" id="node-input-kp" placeholder="proportional gain constant - Kp" style="width:60%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-ki" style="width:120px;"><font size=+1>K<sub>integral</sub></font></label>
+        <input type="text" id="node-input-ki" placeholder="integral gain constant - Ki" style="width:60%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-kd" style="width:120px;"><font size=+1>K<sub>differential</sub></font></label>
+        <input type="text" id="node-input-kd" placeholder="differential gain constant - Kd" style="width:60%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-name" style="width:120px;"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name" style="width:60%;">
+    </div>
+    <div class="form-tips"><b>Tip:</b> This node ONLY works on numbers<br>
+    The damping factors are typically in the range 0 - 1.<br></div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('PID control',{
+        color:"#d6ba48",
+        category: 'function',
+        defaults: {
+            name: {value:""},
+            target: {value:"",validate:RED.validators.regex(/^(\d*|)$/)},
+            kp: {value:"",required:true,validate:RED.validators.number()},
+            ki: {value:"",required:true,validate:RED.validators.number()},
+            kd: {value:"",required:true,validate:RED.validators.number()}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "function.png",
+        label: function() {
+            return this.name||"PID";
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        }
+    });
+</script>

function/PID/pidcontrol.js

@@ -0,0 +1,33 @@
+
+module.exports = function(RED) {
+    "use strict";
+    var Controller = require('node-pid-controller');
+
+    function PIDcontrolNode(n) {
+        RED.nodes.createNode(this,n);
+        this.target = n.target;
+        this.kp = n.kp;
+        this.ki = n.ki;
+        this.kd = n.kd;
+        var node = this;
+        node.ctr = new Controller(node.kp, node.ki, node.kd);
+        node.ctr.setTarget(node.target);
+        this.status({fill:"blue",shape:"dot",text:"set point:"+node.target});
+        var tgt = node.target;
+
+        this.on("input",function(msg) {
+            if (msg.hasOwnProperty("setpoint")) {
+                tgt = Number(msg.setpoint);
+                node.ctr.setTarget(tgt);
+                this.status({fill:"blue",shape:"dot",text:"set point:"+tgt});
+            }
+            else if (!isNaN(msg.payload)) {
+                msg.payload = node.ctr.update(Number(msg.payload));
+                msg.topic = "pid";
+                node.send(msg);
+            }
+            else { node.warn("Non numeric input"); }
+        });
+    }
+    RED.nodes.registerType("PID control",PIDcontrolNode);
+}

function/datagenerator/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

function/datagenerator/README.md

@@ -0,0 +1,53 @@
+node-red-node-web-data-generator
+================================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node to create dummy
+data values from a template. Useful for building test-cases.
+
+Install
+-------
+
+Either use the Manage Palette option in the Node-RED Editor menu, or run the following command in your Node-RED user directory - typically `~/.node-red`
+
+        npm i node-red-node-data-generator
+
+Usage
+-----
+
+Creates dummy data based on a handlebars-style template.
+
+Uses the <i><a href="https://github.com/webroo/dummy-json/blob/master/README.md" target="_new">dummy-json</a></i>
+module, which can create rich sets of dummy data for testing or other uses.
+
+It will build a **string**, or a **parsed JSON object**, creating values based
+on the helper names below:
+
+    title, firstName, lastName, company, domain, tld, email,
+    street, city, country, countryCode, zipcode, postcode,
+    lat, long, phone "+xx (x) xxxx xxx xxx", color, hexColor, guid,
+    ipv4, ipv6, lorem nn, date, time,
+    lowercase (helper), uppercase (helper), int, float, boolean
+
+Multiple values can be generated by use of the `repeat` syntax.
+
+In addition any properties passed in on the `msg` object can also be used - for example {{payload}}.
+
+Finally `msg.seed` can be used to preset the pseudo-random seed to ensure repeatability across calls.
+
+Example
+-------
+
+The example flow below produces a JSON string which is then converted into an object, for example:
+
+    {
+        "name": "Theo Cumbie",
+        "work": "CoreXTS",
+        "email": "theo.cumbie@corexts.gov",
+        "address": "83 Sherman Road",
+        "country": "Angola",
+        "text": "Sagittis orci elementum e vel scelerisque. Amet ac tristique lectus. Morbi e suscipit scelerisque auctor curabitur velit metus gravida quis."
+    }
+
+Example flow
+
+[{"id":"325b6a4a.cf1706","type":"inject","z":"4affede3.af6f44","name":"","topic":"","payload":"","payloadType":"str","repeat":"","crontab":"","once":false,"x":110,"y":300,"wires":[["9d14acc0.c8d9d"]]},{"id":"96c9a04e.35232","type":"debug","z":"4affede3.af6f44","name":"","active":true,"console":"false","complete":"false","x":513,"y":300,"wires":[]},{"id":"9d14acc0.c8d9d","type":"data-generator","z":"4affede3.af6f44","name":"","field":"payload","fieldType":"msg","syntax":"json","template":"{\n    \"name\": \"{{firstName}} {{lastName}}\",\n    \"work\": \"{{company}}\",\n    \"email\": \"{{email}}\",\n    \"address\": \"{{int 1 100}} {{street}}\",\n    \"country\": \"{{country}}\",\n    \"countryCode\": \"{{countryCode}}\",\n    \"text\":\"{{lorem 20}}\"\n}","x":280,"y":300,"wires":[["96c9a04e.35232"]]}]

function/datagenerator/datagenerator.html

@@ -0,0 +1,94 @@
+
+<script type="text/html" data-template-name="data-generator">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-field"><i class="fa fa-edit"></i> <span data-i18n="node-red:template.label.property"></span></label>
+        <input type="text" id="node-input-field" placeholder="payload" style="width:275px;">
+        <input type="hidden" id="node-input-fieldType">
+    </div>
+    <div class="form-row" style="position: relative; margin-bottom: 0px;">
+        <label for="node-input-template"><i class="fa fa-file-code-o"></i> <span data-i18n="node-red:template.label.template"></span></label>
+        <input type="hidden" id="node-input-template" autofocus="autofocus">
+    </div>
+    <div class="form-row node-text-editor-row">
+        <div style="height:250px;" class="node-text-editor" id="node-input-template-editor"></div>
+    </div>
+    <div class="form-row">
+        <label for="node-input-syntax"><i class="fa fa-code"></i> <span data-i18n="datagen.label.syntax"></span></label>
+        <select id="node-input-syntax" style="width:180px;">
+            <option value="text" data-i18n="datagen.label.text"></option>
+            <option value="json" data-i18n="datagen.label.json"></option>
+        </select>
+    </div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('data-generator',{
+        color:"rgb(243, 181, 103)",
+        category: 'function',
+        defaults: {
+            name: {value:""},
+            field: {value:"payload"},
+            fieldType: {value:"msg"},
+            syntax: {value:"text"},
+            template: {value:"{\n    \"name\": \"{{firstName}} {{lastName}}\",\n    \"work\": \"{{company}}\",\n    \"email\": \"{{email}}\",\n    \"address\": \"{{int 1 100}} {{street}}\",\n    \"country\": \"{{country}}\"\n}"}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "template.png",
+        paletteLabel: function() {
+            return this._("datagen.datagen");
+        },
+        label: function() {
+            return this.name || "data generator";
+        },
+        outputLabels: function() { return this.syntax === "json" ? "object" : "string"; },
+        oneditprepare: function() {
+            var that = this;
+            if (!this.fieldType) {
+                this.fieldType = 'msg';
+            }
+            $("#node-input-field").typedInput({
+                default: 'msg',
+                types: ['msg','flow','global'],
+                typeField: $("#node-input-fieldType")
+            });
+
+            this.editor = RED.editor.createEditor({
+                id: 'node-input-template-editor',
+                mode: 'ace/mode/handlebars',
+                value: $("#node-input-template").val()
+            });
+            RED.library.create({
+                url:"functions", // where to get the data from
+                type:"function", // the type of object the library is for
+                editor:that.editor, // the field name the main text body goes to
+                fields:['name','outputs']
+            });
+            this.editor.focus();
+        },
+        oneditsave: function() {
+            $("#node-input-template").val(this.editor.getValue());
+            this.editor.destroy();
+            delete this.editor;
+        },
+        oneditcancel: function() {
+            this.editor.destroy();
+            delete this.editor;
+        },
+        oneditresize: function(size) {
+            var rows = $("#dialog-form>div:not(.node-text-editor-row)");
+            var height = $("#dialog-form").height();
+            for (var i=0; i<rows.size(); i++) {
+                height -= $(rows[i]).outerHeight(true);
+            }
+            var editorRow = $("#dialog-form>div.node-text-editor-row");
+            height -= (parseInt(editorRow.css("marginTop"))+parseInt(editorRow.css("marginBottom")));
+            $("#dialog-form .node-text-editor").css("height",height+"px");
+            this.editor.resize();
+        }
+    });
+</script>

function/datagenerator/datagenerator.js

@@ -0,0 +1,39 @@
+
+module.exports = function(RED) {
+    "use strict";
+    var dummyjson = require('dummy-json');
+
+    function DataGeneratorNode(n) {
+        RED.nodes.createNode(this,n);
+        this.field = n.field || "payload";
+        this.template = n.template;
+        this.fieldType = n.fieldType || "msg";
+        this.syntax = n.syntax || "text";
+        var node = this;
+        node.on("input", function(msg) {
+            if (msg.seed) { dummyjson.seed = msg.seed; }
+            try {
+                var value = dummyjson.parse(node.template, {mockdata: msg});
+                if (node.syntax === "json") {
+                    try { value = JSON.parse(value); }
+                    catch(e) { node.error(RED._("datagen.errors.json-error")); }
+                }
+                if (node.fieldType === 'msg') {
+                    RED.util.setMessageProperty(msg,node.field,value);
+                }
+                else if (node.fieldType === 'flow') {
+                    node.context().flow.set(node.field,value);
+                }
+                else if (node.fieldType === 'global') {
+                    node.context().global.set(node.field,value);
+                }
+                node.send(msg);
+            }
+            catch(e) {
+                node.error(e.message);
+            }
+        });
+    }
+    RED.nodes.registerType("data-generator",DataGeneratorNode);
+    RED.library.register("datagenerator");
+}

function/datagenerator/locales/de/datagenerator.json

@@ -0,0 +1,13 @@
+{
+    "datagen": {
+        "datagen": "data generator",
+        "label": {
+            "syntax": "Rückgabe",
+            "text": "ein Text-String",
+            "json": "ein analysiertes (parsed) JSON-Objekt"
+        },
+        "errors": {
+            "json-error": "Fehler beim Versuch, String zu JSON zu analysieren (parsen)"
+        }
+    }
+}

function/datagenerator/locales/en-US/datagenerator.html

@@ -0,0 +1,11 @@
+
+<script type="text/html" data-help-name="data-generator">
+    <p>Creates dummy data strings based on a handlebars-style template.</p>
+    <p>Uses the <i><a href="https://github.com/webroo/dummy-json/blob/master/README.md" target="_new">dummy-json</a></i>
+    module, which can create rich sets of dummy data for testing or other uses.</p>
+    <p>Will build a string or a parsed JSON object, creating values based on the helper names below:
+    <pre style="word-break:normal">title, firstName, lastName, company, domain, tld, email, street, city, country, countryCode, zipcode, postcode, lat, long, phone, color, hexColor, guid, ipv4, ipv6, lorem [nn], date, time, lowercase, uppercase, int, float, boolean</pre>
+    <p>Multiple values can be generated by use of the <i>repeat</i> syntax.</p>
+    <p>In addition any properties passed in on <code>msg</code> can also be used - for example <code>{{payload}}</code>.</p>
+    <p>Finally <code>msg.seed</code> can be used to preset the pseudo-random seed to ensure repeatability across calls.</p>
+</script>

function/datagenerator/locales/en-US/datagenerator.json

@@ -0,0 +1,13 @@
+{
+    "datagen": {
+        "datagen": "data generator",
+        "label": {
+            "syntax": "Return",
+            "text": "a text string",
+            "json": "a parsed JSON object"
+        },
+        "errors": {
+            "json-error": "error trying to parse string to JSON"
+        }
+    }
+}

function/datagenerator/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "node-red-node-data-generator",
+    "version": "1.0.2",
+    "description": "A Node-RED node to create a string of dummy data values from a template. Useful for test-cases.",
+    "dependencies": {
+        "dummy-json": "^3.0.5"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/function/data-generator"
+    },
+    "license": "Apache-2.0",
+    "keywords": [
+        "node-red",
+        "data-generator",
+        "dummy-json"
+    ],
+    "node-red": {
+        "nodes": {
+            "data-generator": "datagenerator.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "dceejay@gmail.com",
+        "url": "http://nodered.org"
+    }
+}

function/random/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016,2020 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

function/random/README.md

@@ -0,0 +1,24 @@
+# node-red-node-random
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that when triggered generates a random number between two values.
+
+## Install
+
+Either use the Manage Palette option in the Node-RED Editor menu, or run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm i node-red-node-random
+
+
+## Usage
+
+A simple node to generate a random number when triggered.
+
+If set to return an integer it can include both the low and high values.
+`min <= n <= max` - so selecting 1 to 6 will return values 1,2,3,4,5 or 6.
+
+If set to return a floating point value it will be from the low value, up to, but
+**not** including the high value. `min <= n < max` - so selecting 1 to 6 will return values 1 <= n < 6 .
+
+You can dynamically pass in the 'From' and 'To' values to the node using msg.to and/or msg.from. **NOTE:** hard coded values in the node **always take precedence**.
+
+**Note:** This returns numbers - objects of type **number**.

function/random/locales/de/random.json

@@ -0,0 +1,13 @@
+{
+    "random": {
+        "label": {
+            "generate": "Generiere",
+            "wholeNumber": "eine Ganzzahl (integer)",
+            "realNumber": "eine reelle Zahl (floating point)",
+            "from": "Von",
+            "lowestNumber": "kleinste Zahl",
+            "to": "Bis",
+            "highestNumber": "größte Zahl"
+        }
+    }
+}

function/random/locales/en-US/random.html

@@ -0,0 +1,16 @@
+<script type="text/html" data-help-name="random">
+    <p>Generates a random number between a low and high value. Defaults to 1 to 10.</p>
+    <p>If left blank <code>from</code> and <code>to</code> can be set dynamically as below.</p>
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>from <span class="property-type">number</span></dt>
+        <dd>containing the low value to be used.</dd>
+        <dt>to <span class="property-type">number</span></dt>
+        <dd>containing the high value to be used.</dd>
+    </dl>
+    <h3>Details</h3>
+    <p>If set to return an integer it can <i>include</i> both the low and high values.
+        <code>min <= n <= max</code></p>
+    <p>If set to return a floating point value it will be from the low value, up to, but
+        not including the high value. <code>min <= n < max</code></p>
+</script>

function/random/locales/en-US/random.json

@@ -0,0 +1,13 @@
+{
+    "random": {
+        "label": {
+            "generate": "Generate",
+            "wholeNumber": "a whole number - integer",
+            "realNumber": "a real number - floating point",
+            "from": "From",
+            "lowestNumber": "lowest number",
+            "to": "To",
+            "highestNumber": "highest number"
+        }
+    }
+}

function/random/locales/ja/random.html

@@ -0,0 +1,16 @@
+<script type="text/html" data-help-name="random">
+    <p>最小値と最大値との間の乱数を生成します。デフォルトは1から10です。</p>
+    <p><code>最小</code> や <code>最大</code> を空にした場合は、以下の様に動的に値を設定できます。</p>
+    <h3>入力</h3>
+    <dl class="message-properties">
+        <dt>from <span class="property-type">数値</span></dt>
+        <dd>使用する最小値を含みます。</dd>
+        <dt>to <span class="property-type">数値</span></dt>
+        <dd>使用する最大値を含みます。</dd>
+    </dl>
+    <h3>詳細</h3>
+    <p>整数値を返すように設定した場合は、乱数には最大値と最小値の両方が<i>含まれます</i>。
+        <code>min <= n <= max</code></p>
+    <p>浮動小数点値を返すように設定した場合、乱数は最小値から最大値未満の値を含み、最大値は含まれません。
+        <code>min <= n < max</code></p>
+</script>

function/random/locales/ja/random.json

@@ -0,0 +1,13 @@
+{
+    "random": {
+        "label": {
+            "generate": "生成",
+            "wholeNumber": "整数 - 整数値",
+            "realNumber": "実数 - 浮動小数点",
+            "from": "最小",
+            "lowestNumber": "最小値",
+            "to": "最大",
+            "highestNumber": "最大値"
+        }
+    }
+}

function/random/package.json

@@ -0,0 +1,27 @@
+{
+    "name"          : "node-red-node-random",
+    "version"       : "0.4.1",
+    "description"   : "A Node-RED node that when triggered generates a random number between two values.",
+    "dependencies"  : {
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/function/random"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "random" ],
+    "node-red"      : {
+        "nodes"     : {
+            "random": "random.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    },
+    "contributors": [
+        {"name": "@zenofmud"}
+    ]
+}

function/random/random.html

@@ -0,0 +1,55 @@
+<script type="text/html" data-template-name="random">
+    <div class="form-row">
+        <label for="node-input-property"><i class="fa fa-ellipsis-h"></i> <span data-i18n="node-red:common.label.property"></span></label>
+        <input type="text" id="node-input-property" style="width:70%;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-input-inte"><i class="fa fa-random"></i> <span data-i18n="random.label.generate"></label>
+        <select type="text" id="node-input-inte" style="width:70%;">
+            <option value="true" data-i18n="random.label.wholeNumber"></option>
+            <option value="false" data-i18n="random.label.realNumber"></option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-low"><i class="fa fa-arrow-down"></i> <span data-i18n="random.label.from"></label>
+        <input type="text" id="node-input-low" data-i18n="[placeholder]random.label.lowestNumber" style="width:70%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-high"><i class="fa fa-arrow-up"></i> <span data-i18n="random.label.to"></label>
+        <input type="text" id="node-input-high" data-i18n="[placeholder]random.label.highestNumber" style="width:70%;">
+    </div>
+    <br/>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name" style="width:70%;">
+    </div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('random',{
+        category: 'function',
+        color:"#E2D96E",
+        defaults: {
+            name: {value:""},
+            low:  {value: 1,validate:function(v) { return  !isNaN(v) || v.length === 0;} },
+            high: {value: 10,validate:function(v) { return  !isNaN(v) || v.length === 0;} },
+            inte: {value:"true"},
+            property: {value:"payload",required:true}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "debug.png",
+        label: function() {
+            return this.name||"random";
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        },
+        oneditprepare: function() {
+            if (this.property === undefined) {
+                $("#node-input-property").val("payload");
+            }
+            $("#node-input-property").typedInput({default:'msg',types:['msg']});
+        }
+    });
+</script>

function/random/random.js

@@ -0,0 +1,74 @@
+
+module.exports = function(RED) {
+    "use strict";
+    function RandomNode(n) {
+        RED.nodes.createNode(this,n);
+
+        this.low = n.low
+        this.high = n.high
+        this.inte = n.inte || false;
+        this.property = n.property||"payload";
+        var node = this;
+        var tmp = {};
+
+        this.on("input", function(msg) {
+
+            tmp.low = 1                 // set this as the default low value
+            tmp.low_e = ""
+            if (node.low) {             // if the the node has a value use it
+                tmp.low = Number(node.low);
+            } else if ('from' in msg) { // else see if a 'from' is in the msg
+                tmp.low = Number(msg.from);
+                if (isNaN(msg.from)) { // if it isn't a number setup NaN error
+                    tmp.low = NaN;
+                    tmp.low_e = " From: " + msg.from; // setup to show bad incoming msg.from
+                }
+            }
+
+            tmp.high = 10               // set this as the default high value
+            tmp.high_e = "";
+            if (node.high) {            // if the the node has a value use it
+                tmp.high = Number(node.high);
+            } else if ('to' in msg) {   // else see if a 'to' is in the msg
+                tmp.high = Number(msg.to);
+                if (isNaN(msg.to)) {   // if it isn't a number setup NaN error
+                    tmp.high = NaN
+                    tmp.high_e = " To: " + msg.to // setup to show bad incoming msg.to
+                }
+            }
+
+            // if tmp.low or high are not numbers, send an error msg with bad values
+            if ( (isNaN(tmp.low)) || (isNaN(tmp.high)) ) {
+                this.error("Random: one of the input values is not a number. " + tmp.low_e + tmp.high_e);
+            } else {
+                // at this point we have valid values so now to generate the random number!
+
+                // flip the values if low > high so random will work
+                var value = 0;
+                if (tmp.low > tmp.high) {
+                    value = tmp.low
+                    tmp.low = tmp.high
+                    tmp.high = value
+                }
+
+                // if returning an integer, do a math.ceil() on the low value and a
+                // Math.floor()high value before generate the random number. This must be
+                // done to insure the rounding doesn't round up if using something like 4.7
+                // which would end up with 5
+                if ( (node.inte == "true") || (node.inte === true) ) {
+                    tmp.low  = Math.ceil(tmp.low);
+                    tmp.high = Math.floor(tmp.high);
+                    // use this to round integers
+                    value = Math.round(Math.random() * (tmp.high - tmp.low + 1) + tmp.low - 0.5);
+                } else {
+                    // use this to round floats
+                    value = (Math.random() * (tmp.high - tmp.low)) + tmp.low;
+                }
+
+                RED.util.setMessageProperty(msg,node.property,value);
+                node.send(msg);
+            }
+        });
+    }
+    RED.nodes.registerType("random",RandomNode);
+}

function/rbe/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

function/rbe/README.md

@@ -0,0 +1,56 @@
+node-red-node-rbe
+=================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that 
+provides report-by-exception (RBE) and deadband capability.
+
+The node blocks unless the incoming value changes - RBE mode, or
+changes by more than a certain amount (absolute value or percentage) - bandgap modes.
+
+Install
+-------
+
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm i node-red-node-rbe
+
+
+Usage
+-----
+
+A simple node to provide report by exception (RBE) and bandgap functions
+- only passes on data if it has changed.
+
+This works on a per `msg.topic` basis. This means that a single rbe node can
+handle multiple topics at the same time.
+
+### RBE mode
+
+The node doesn't send any output until the `msg.payload` is different to the previous one.
+Works on numbers and strings. Useful for filtering out repeated messages of the
+same value. Saves bandwidth, etc...
+
+### Deadband and Narrowband modes
+
+In deadband modes the incoming payload should contain a parseable *number* and is
+output only if greater than + or - the *band gap* away from the previous output.
+
+The narrowband modes will block if the incoming value change is greater than + or - the band gap
+away from the previous value. Useful for ignoring outliers from a faulty sensor for example.
+
+You can specify compare with *previous valid output value* or *previous input value*.
+The former ignores any values outside the valid range, whereas the latter allows
+two "bad" readings in a row to reset the range based on those values.
+For example a valid step change.
+
+The deadband value can be specified as a fixed number, or a percentage. E.g. 10
+or 5% . If % mode is used then the output will only get sent if the input payload
+value is equal or more than the specified % away from the previously sent value.
+
+For example - if last sent value was 100, and deadband is set to 10% - a value
+of 110 will pass - then the next value has to be 121 in order to pass (= 110 + 10% = 121).
+
+This is mainly useful if you want to operate across multiple topics at the same
+time that may have widely differing input ranges.
+
+Will only accept numbers, or parseable strings like  "18.4 C"  or "$500"

function/rbe/locales/de/rbe.html

@@ -0,0 +1,40 @@
+<script type="text/html" data-help-name="rbe">
+    <p>Report by Exception (RBE) - Daten-Weiterleitung nur bei Änderung der Nutzdaten (Payload).
+       Der Node kann auch blockieren oder weiterleiten, wenn die Wertänderung eine Grenze überschreitet (Totband- und Nahband-Modus).</p>
+    <h3>Eingangsdaten</h3>
+    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">number | string | (object)</span>
+        </dt>
+        <dd>Der RBE-Modus mit Prüfung auf Wertänderung akzeptiert Zahlen (numbers), Zeichenfolgen (string) und einfache Objekte (object).
+            Bei den anderen wertvergleichenden Modies müssen analysierbare (parseable) Zahlenwerte übergeben werden.</dd>
+        <dt class="optional">topic <span class="property-type">string</span>
+        </dt>
+        <dd>Wenn vorgegeben erfolgt die Auswertung separat für jedes Topic</dd>
+        <dt class="optional">reset<span class="property-type">any</span></dt>
+        <dd>Wenn gesetzt wird/werden der/die gespeicherte(n) Wert(e) rückgesetzt</dd>
+    </dl>
+    <h3>Ausgangsdaten</h3>
+    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">wie Eingangsdaten</span>
+        </dt>
+        <dd>Wenn Bedingung erfüllt, sind die Ausgangsdaten gleich den Eingangsdaten</dd>
+    </dl>
+    <h3>Details</h3>
+    <p>Im <i>RBE</i>-Modus mit Prüfung auf Wertänderung blockiert dieser Node die Datenweitergabe bis
+       <code>msg.payload</code> (oder die eingestellte Eigenschaft) verändert ist gegenüber dessen vorherigen Wert.
+       Wenn benötigt, wird der Anfangswert ignoriert, sodass beim Start nichts gesendet wird.</p>
+    <p>In den <i>Totband</i>-Modies werden die Eingangswerte geblockt,
+       <i>bis</i> die Wertänderung größer oder größer-gleich ist als &plusmn; des Bandes um den voherigen Wert.</p>
+    <p>In den <i>Nahband</i>-Modies werden die Eingangswerte geblockt,
+       <i>wenn</i> die Wertänderung größer oder größer-gleich ist als &plusmn; des Bandes um den voherigen Wert.
+       Dies ist beispielsweise nützlich, um Ausreißer eines fehlerhaften Sensors zu ignorieren.</p>
+    <p>In den Totband und Nahband-Modies müssen die Eingangswerte analysierbare (parseable) Zahlenwerte sein und
+       beide unterstützen auch % (prozentuale Angabe), d.h. der Node sendet nur, wenn der Eingangswert mehr als x% vom vorherigen Wert abweicht.</p>
+    <p>Die Totband- und Nahband-Modies erlauben den Vergleich entweder gegen den letzten gültigen Ausgangswert,
+       dieses zum Ignorieren von Werten außerhalb des gültigen Bereichs, oder gegen den des vorherigen Eingangswertes,
+       welches den Sollwert rücksetzt, was einen allmähligen Drift (Totband) oder einen eine schrittweise Veränderung (Nahband) ermöglicht.</p>
+    <p><b>Hinweis</b>: Dieser Node arbeitet auf per-<code>msg.topic</code>-Basis.
+       Dies bedeutet, dass ein einzelner rbe-Node mehrere verschiedene Topics parallel bearbeiten kann.</p>
+</script>

function/rbe/locales/de/rbe.json

@@ -0,0 +1,29 @@
+{
+    "rbe": {
+        "rbe": "rbe",
+        "label": {
+            "func": "Modus",
+            "init": "Sende Anfangswert",
+            "start": "Startwert",
+            "name": "Name",
+            "septopics": "Modus für jedes msg.topic separat anwenden"
+        },
+        "placeholder":{
+            "bandgap": "z.B. 10 oder 5%",
+            "start": "Leer lassen, um erste empfangenen Daten zu nutzen"
+        },
+        "opts": {
+            "rbe": "Blockieren bis Wertänderung",
+            "rbei": "Blockieren bis Wertänderung (Anfangswert ignorieren)",
+            "deadband": "Blockieren bis Wertänderung ist größer als",
+            "deadbandEq": "Blockieren bis Wertänderung ist größer-gleich",
+            "narrowband": "Blockieren wenn Wertänderung ist größer als",
+            "narrowbandEq": "Blockieren wenn Wertänderung ist größer-gleich",
+            "in": "verglichen mit letzten Eingangswert",
+            "out": "verglichen mit letzten gültigen Ausgangswert"
+        },
+        "warn": {
+            "nonumber": "Keine Zahl gefunden in den Nutzdaten (Payload)"
+        }
+    }
+}

function/rbe/locales/en-US/rbe.html

@@ -0,0 +1,41 @@
+<script type="text/html" data-help-name="rbe">
+    <p>Report by Exception (RBE) node - only passes on data if the payload has changed.
+       It can also block unless, or ignore if the value changes by a specified amount (Dead- and Narrowband mode).</p>
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">number | string | (object)</span>
+        </dt>
+        <dd>RBE mode will accept numbers, strings, and simple objects.
+            Other modes must provide a parseable number.</dd>
+        <dt class="optional">topic <span class="property-type">string</span>
+        </dt>
+        <dd>if specified the function will work on a per topic basis. This property can be set by configuration.</dd>
+        <dt class="optional">reset<span class="property-type">any</span></dt>
+        <dd>if set clears the stored value for the specified msg.topic, or
+            all topics if msg.topic is not specified.</dd>
+    </dl>
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">as per input</span>
+        </dt>
+        <dd>If triggered the output will be the same as the input.</dd>
+    </dl>
+    <h3>Details</h3>
+    <p>In RBE mode this node will block until the <code>msg.payload</code>,
+       (or selected property) value is different to the previous one.
+       If required it can ignore the intial value, so as not to send anything at start.</p>
+    <p>The <a href="https://en.wikipedia.org/wiki/Deadband" target="_blank">Deadband</a> modes will block the incoming value
+       <i>unless</i> its change is greater or greater-equal than &plusmn; the band gap away from a previous value.</p>
+    <p>The Narrowband modes will block the incoming value,
+       <i>if</i> its change is greater or greater-equal than &plusmn; the band gap away from the previous value.
+       It is useful for ignoring outliers from a faulty sensor for example.</p>
+    <p>Both in Deadband and Narrowband modes the incoming value must contain a parseable number and
+       both also supports % - only sends if/unless the input differs by more than x% of the original value.</p>
+    <p>Both Deadband and Narrowband allow comparison against either the previous valid output value, thus
+    ignoring any values out of range, or the previous input value, which resets the set point, thus allowing
+    gradual drift (deadband), or a step change (narrowband).</p>
+    <p><b>Note:</b> This works on a per <code>msg.topic</code> basis, though this can be changed to another property if desired.
+       This means that a single rbe node can handle multiple different topics at the same time.</p>
+</script>

function/rbe/locales/en-US/rbe.json

@@ -0,0 +1,29 @@
+{
+    "rbe": {
+        "rbe": "rbe",
+        "label": {
+            "func": "Mode",
+            "init": "Send initial value",
+            "start": "Start value",
+            "name": "Name",
+            "septopics": "Apply mode separately for each "
+        },
+        "placeholder":{
+            "bandgap": "e.g. 10 or 5%",
+            "start": "leave blank to use first data received"
+        },
+        "opts": {
+            "rbe": "block unless value changes",
+            "rbei": "block unless value changes (ignore initial value)",
+            "deadband": "block unless value change is greater than",
+            "deadbandEq": "block unless value change is greater or equal to",
+            "narrowband": "block if value change is greater than",
+            "narrowbandEq": "block if value change is greater or equal to",
+            "in": "compared to last input value",
+            "out": "compared to last valid output value"
+        },
+        "warn": {
+            "nonumber": "no number found in payload"
+        }
+    }
+}

function/rbe/locales/ja/rbe.html

@@ -0,0 +1,31 @@
+<!-- Source revision: https://github.com/node-red/node-red-nodes/commit/467907776088422882076f46d85e25601449564d -->
+
+<script type="text/html" data-help-name="rbe">
+    <p>Report by Exception(例外データの報告)ノード - ペイロードの値が変化した場合だけデータを送信。</p>
+    <p>値が指定した量変化するまでブロックすることもできます- 不感帯(deadband)モード。</p>
+    <h3>入力</h3>    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">数値 | 文字列 | (オブジェクト)</span>
+        </dt>
+        <dd>RBEモードでは数値、文字列、シンプルなオブジェクトを受け付けます。他のモードではパース可能な数値を指定します。</dd>
+        <dt class="optional">topic <span class="property-type">文字列</span>
+        </dt>
+        <dd>指定すると、トピックごとに動作します。</dd>
+        <dt class="optional">reset<span class="property-type">任意</span></dt>
+        <dd>値を設定すると、保存した値をクリアします。msg.topicを指定した場合は対応する値、指定しなければ全てのトピックが対象となります。</dd>
+    </dl>
+    <h3>出力</h3>
+    <dl class="message-properties">
+        <dt>payload
+            <span class="property-type">入力と同じ</span>
+        </dt>
+        <dd>トリガー条件を満たした場合、入力を出力として送信。</dd>
+    </dl>
+    <h3>詳細</h3>
+    <p>RBEモードでは、<code>msg.payload</code>が前の値から変化するまでブロックします。</p>
+    <p>不感帯モードでは、入力データはパース可能な数値でなければなりません。以前の入力値に対する差分が指定値より大きな場合にのみメッセージを出力します。</p>
+    <p>不感帯モードでは%による指定もサポートしています。入力と前の値の差分がX%より大きな場合に出力を行います。</p>
+    <p>狭帯域(narrowband)モードでは、前の値に対する差分が一定値より大きな場合に入力ペイロードをブロックします。このモードは、故障したセンサから発生する外れ値を無視する時などに有用です。</p>
+    <p>不感帯モードと狭帯域モードでは、以前の有効出力値、もしくは、以前の入力値との比較ができます。有効出力値を用いると範囲外の値を無視することが、入力値を用いると設定点がリセットされるため漸次的変化(不感帯モード)もしくは段階的変化(狭帯域モード)が可能です。</p>
+    <p><b>注:</b> このノードは<code>msg.topic</code>毎に動作します。そのため、ひとつのrbeノードで複数の異なるトピックを同時に扱うことができます。</p>
+</script>

function/rbe/locales/ja/rbe.json

@@ -0,0 +1,27 @@
+{
+    "rbe": {
+        "label": {
+            "func": "動作",
+            "init": "初期値を送付",
+            "start": "初期値",
+            "name": "名前"
+        },
+        "placeholder": {
+            "bandgap": "例:10、5%",
+            "start": "最初に受け取った値を用いる場合は空欄"
+        },
+        "opts": {
+            "rbe": "値が変化した時のみメッセージを中継",
+            "rbei": "値が変化した時のみメッセージを中継(初期値を無視)",
+            "deadband": "値が指定した変化量を超える時のみメッセージを中継",
+            "deadbandEq": "値が指定した変化量以上の時のみメッセージを中継",
+            "narrowband": "値が指定した変化量を超えない時のみメッセージを中継",
+            "narrowbandEq": "値が指定した変化量以上でない時のみメッセージを中継",
+            "in": "最後の入力値と比較",
+            "out": "最後の出力値と比較"
+        },
+        "warn": {
+            "nonumber": "ペイロードに数値が含まれていません"
+        }
+    }
+}

function/rbe/package.json

@@ -0,0 +1,24 @@
+{
+    "name"          : "node-red-node-rbe",
+    "version"       : "0.6.0",
+    "description"   : "A Node-RED node that provides report-by-exception (RBE) and deadband capabilities.",
+    "dependencies"  : {
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/function/rbe"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "rbe", "bandgap", "deadband" ],
+    "node-red"      : {
+        "nodes"     : {
+            "rbe": "rbe.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

function/rbe/rbe.html

@@ -0,0 +1,92 @@
+
+<script type="text/html" data-template-name="rbe">
+    <div class="form-row">
+        <label for="node-input-func"><i class="fa fa-wrench"></i> <span data-i18n="rbe.label.func"></span></label>
+        <select type="text" id="node-input-func" style="width:70%;">
+            <option value="rbe" data-i18n="rbe.opts.rbe"></option>
+            <option value="rbei" data-i18n="rbe.opts.rbei"></option>
+            <option value="deadbandEq" data-i18n="rbe.opts.deadbandEq"></option>
+            <option value="deadband" data-i18n="rbe.opts.deadband"></option>
+            <option value="narrowbandEq" data-i18n="rbe.opts.narrowbandEq"></option>
+            <option value="narrowband" data-i18n="rbe.opts.narrowband"></option>
+        </select>
+    </div>
+    <div class="form-row" id="node-bandgap">
+        <label for="node-input-gap">&nbsp;</label>
+        <input type="text" id="node-input-gap" data-i18n="[placeholder]rbe.placeholder.bandgap" style="width:95px;">
+        <select type="text" id="node-input-inout" style="width:54%;">
+            <option value="out" data-i18n="rbe.opts.out"></option>
+            <option value="in" data-i18n="rbe.opts.in"></option>
+        </select>
+    </div>
+    <div class="form-row" id="node-startvalue">
+        <label for="node-input-start"><i class="fa fa-thumb-tack"></i> <span data-i18n="rbe.label.start"></span></label>
+        <input type="text" id="node-input-start" data-i18n="[placeholder]rbe.placeholder.start" style="width:70%;">
+    </div>
+    <div class="form-row">
+        <label for="node-input-property"><i class="fa fa-ellipsis-h"></i> <span data-i18n="node-red:common.label.property"></span></label>
+        <input type="text" id="node-input-property" style="width:70%;"/>
+    </div>
+    <div class="form-row">
+        <label> </label>
+        <input type="checkbox" id="node-input-septopics" style="display:inline-block; width:20px; vertical-align:baseline;">
+        <span data-i18n="rbe.label.septopics"></span> <input type="text" id="node-input-topi" style="width:27%;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="rbe.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]rbe.label.name" style="width:70%;">
+    </div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType("rbe", {
+        color:"#E2D96E",
+        category: 'function',
+        defaults: {
+            name: {value:""},
+            func: {value:"rbe"},
+            gap: {value:"",validate:RED.validators.regex(/^(\d*[.]*\d*|)(%|)$/)},
+            start: {value:""},
+            inout: {value:"out"},
+            septopics: {value:true},
+            property: {value:"payload",required:true},
+            topi: {value:"topic",required:true}
+        },
+        inputs:1,
+        outputs:1,
+        icon: "rbe.png",
+        label: function() {
+            var ll = (this.func||"").replace("Eq","").replace("rbei","rbe")||this._("rbe.rbe");
+            return this.name||ll||this._("rbe.rbe");
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        },
+        oneditprepare: function() {
+            if (this.property === undefined) {
+                $("#node-input-property").val("payload");
+            }
+            if (this.septopics === undefined) {
+                $("#node-input-septopics").prop('checked', true);
+            }
+            $("#node-input-property").typedInput({default:'msg',types:['msg']});
+            $("#node-input-topi").typedInput({default:'msg',types:['msg']});
+            //$( "#node-input-gap" ).spinner({min:0});
+            if ($("#node-input-inout").val() === null) {
+                $("#node-input-inout").val("out");
+            }
+            $("#node-input-func").on("change",function() {
+                if (($("#node-input-func").val() === "rbe")||($("#node-input-func").val() === "rbei")) {
+                    $("#node-bandgap").hide();
+                } else {
+                    $("#node-bandgap").show();
+                }
+                if (($("#node-input-func").val() === "narrowband")||($("#node-input-func").val() === "narrowbandEq")) {
+                    $("#node-startvalue").show();
+                } else {
+                    $("#node-startvalue").hide();
+                }
+            });
+        }
+    });
+</script>

function/rbe/rbe.js

@@ -0,0 +1,97 @@
+
+module.exports = function(RED) {
+    "use strict";
+    function RbeNode(n) {
+        RED.nodes.createNode(this,n);
+        this.func = n.func || "rbe";
+        this.gap = n.gap || "0";
+        this.start = n.start || '';
+        this.inout = n.inout || "out";
+        this.pc = false;
+        if (this.gap.substr(-1) === "%") {
+            this.pc = true;
+            this.gap = parseFloat(this.gap);
+        }
+        this.g = this.gap;
+        this.property = n.property || "payload";
+        this.topi = n.topi || "topic";
+        this.septopics = true;
+        if (n.septopics !== undefined && n.septopics === false) {
+            this.septopics = false;
+        }
+
+        var node = this;
+
+        node.previous = {};
+        this.on("input",function(msg) {
+            var topic;
+            try {
+                topic = RED.util.getMessageProperty(msg,node.topi);
+            }
+            catch(e) { }
+            if (msg.hasOwnProperty("reset")) {
+                if (node.septopics && topic && (typeof topic === "string") && (topic !== "")) {
+                    delete node.previous[msg.topic];
+                }
+                else { node.previous = {}; }
+            }
+            var value = RED.util.getMessageProperty(msg,node.property);
+            if (value !== undefined) {
+                var t = "_no_topic";
+                if (node.septopics) { t = topic || t; }
+                if ((this.func === "rbe") || (this.func === "rbei")) {
+                    var doSend = (this.func !== "rbei") || (node.previous.hasOwnProperty(t)) || false;
+                    if (typeof(value) === "object") {
+                        if (typeof(node.previous[t]) !== "object") { node.previous[t] = {}; }
+                        if (!RED.util.compareObjects(value, node.previous[t])) {
+                            node.previous[t] = RED.util.cloneMessage(value);
+                            if (doSend) { node.send(msg); }
+                        }
+                    }
+                    else {
+                        if (value !== node.previous[t]) {
+                            node.previous[t] = RED.util.cloneMessage(value);
+                            if (doSend) { node.send(msg); }
+                        }
+                    }
+                }
+                else {
+                    var n = parseFloat(value);
+                    if (!isNaN(n)) {
+                        if ((typeof node.previous[t] === 'undefined') && (this.func === "narrowband")) {
+                            if (node.start === '') { node.previous[t] = n; }
+                            else { node.previous[t] = node.start; }
+                        }
+                        if (node.pc) { node.gap = Math.abs(node.previous[t] * node.g / 100) || 0; }
+                        else { node.gap = Number(node.gap); }
+                        if ((node.previous[t] === undefined) && (node.func === "narrowbandEq")) { node.previous[t] = n; }
+                        if (node.previous[t] === undefined) { node.previous[t] = n - node.gap - 1; }
+                        if (Math.abs(n - node.previous[t]) === node.gap) {
+                            if ((this.func === "deadbandEq")||(this.func === "narrowband")) {
+                                if (node.inout === "out") { node.previous[t] = n; }
+                                node.send(msg);
+                            }
+                        }
+                        else if (Math.abs(n - node.previous[t]) > node.gap) {
+                            if (this.func === "deadband" || this.func === "deadbandEq") {
+                                if (node.inout === "out") { node.previous[t] = n; }
+                                node.send(msg);
+                            }
+                        }
+                        else if (Math.abs(n - node.previous[t]) < node.gap) {
+                            if ((this.func === "narrowband")||(this.func === "narrowbandEq")) {
+                                if (node.inout === "out") { node.previous[t] = n; }
+                                node.send(msg);
+                            }
+                        }
+                        if (node.inout === "in") { node.previous[t] = n; }
+                    }
+                    else {
+                        node.warn(RED._("rbe.warn.nonumber"));
+                    }
+                }
+            } // ignore msg with no payload property.
+        });
+    }
+    RED.nodes.registerType("rbe",RbeNode);
+}

function/smooth/17-smooth.html

@@ -0,0 +1,100 @@
+
+<script type="text/html" data-template-name="smooth">
+    <div class="form-row">
+        <label for="node-input-property"><i class="fa fa-ellipsis-h"></i> <span data-i18n="node-red:common.label.property"></span></label>
+        <input type="text" id="node-input-property" style="width:70%;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-input-action"><i class="fa fa-bolt"></i> Action</label>
+        <select id="node-input-action" style="width:60%; margin-right:5px;">
+            <option value="max">Return the maximum value seen</option>
+            <option value="min">Return the minimum value seen</option>
+            <option value="mean">Return the mean value</option>
+            <option value="sd">Return the standard deviation</option>
+            <option value="low">Perform low pass filter</option>
+            <option value="high">Perform high pass filter</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-count">&nbsp;</label>
+        <span id="node-over">over the most recent </span>
+        <input type="text" id="node-input-count" placeholder="10" style="width:50px;"/>
+        <span id="node-over2"> values</span>
+    </div>
+    <div class="form-row">
+        <label for="node-input-round">(optionally)</label>
+        round to <input type="text" id="node-input-round" placeholder="ignore" style="width:50px;"/> decimal places
+    </div>
+    <div class="form-row">
+    <label for="node-input-mult">Treat</label>
+        <select id="node-input-mult" style="width:60%; margin-right:5px;">
+            <option value="single">All msg as one stream.</option>
+            <option value="multi">Different msg.topic as individual streams.</option>
+        </select>
+    </div>
+    <div class="form-row" id="row-input-reduce">
+        <label for="node-input-reduce"><i class="fa fa-compress"></i> Reduce</label>
+        <input type="checkbox" id="node-input-reduce" style="display:inline-block; width:20px; vertical-align:baseline;">
+        only emit one message per most recent N values
+    </div>
+    <br/>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+    <div class="form-tips" id="node-tip">Tip: This node ONLY works with numbers.</div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('smooth', {
+        color: "#E2D96E",
+        category: 'function',
+        defaults: {
+            name: {value:""},
+            property: {value:"payload",required:true},
+            action: {value:"mean"},
+            count: {value:"10",required:true,validate:RED.validators.number()},
+            round: {value:""},
+            mult: {value:"single"},
+            reduce: {value:false}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "smooth.png",
+        label: function() {
+            return this.name || "smooth";
+        },
+        labelStyle: function() {
+            return this.name ? "node_label_italic" : "";
+        },
+        outputLabels: function() { return this.reduce === true ? (this.action+" of "+this.count) : (this.action); },
+        oneditprepare: function() {
+            if (this.property === undefined) {
+                $("#node-input-property").val("payload");
+            }
+            $("#node-input-property").typedInput({default:'msg',types:['msg']});
+            $("#node-input-count").spinner({
+                min:1
+            });
+            $("#node-input-round").spinner({
+            });
+            $("#node-input-action").change( function() {
+                var a = $("#node-input-action").val();
+                if ((a === "high") ||  ( a === "low" )) {
+                    $("#node-over").html("with a smoothing factor of ");
+                    $("#node-over2").html("");
+                    $("#row-input-reduce").hide();
+                }
+                else {
+                    $("#node-over").html("over the most recent ");
+                    $("#node-over2").html(" values");
+                    $("#row-input-reduce").show();
+                }
+            });
+            $("#node-input-action").change();
+            if ($("#node-input-round").val() === "true") {
+                $("#node-input-round").val(0);
+            }
+        }
+    });
+</script>

function/smooth/17-smooth.js

@@ -0,0 +1,80 @@
+
+module.exports = function(RED) {
+    "use strict";
+
+    function SmoothNode(n) {
+        RED.nodes.createNode(this, n);
+        this.action = n.action;
+        this.round = n.round || false;
+        if (this.round == "true") { this.round = 0; }
+        this.count = Number(n.count);
+        this.mult = n.mult || "single";
+        this.reduce = n.reduce || false;
+        this.property = n.property || "payload";
+        var node = this;
+        var v = {};
+
+        this.on('input', function (msg) {
+            var value = RED.util.getMessageProperty(msg,node.property);
+            var top = msg.topic || "_my_default_topic";
+            var reduce = node.reduce;
+            if (this.mult === "single") { top = "a"; }
+
+            if ((v.hasOwnProperty(top) !== true) || msg.hasOwnProperty("reset")) {
+                v[top] = {};
+                v[top].a = [];
+                v[top].tot = 0;
+                v[top].tot2 = 0;
+                v[top].pop = 0;
+                v[top].old = null;
+                v[top].count = this.count;
+                v[top].iter = 0;
+            }
+            if (value !== undefined) {
+                var n = Number(value);
+                if (!isNaN(n)) {
+                    v[top].iter++;
+                    if ((node.action === "low") || (node.action === "high")) {
+                        if (v[top].old == null) { v[top].old = n; }
+                        v[top].old = v[top].old + (n - v[top].old) / v[top].count;
+                        if (node.action === "low") { value = v[top].old; }
+                        else { value = n - v[top].old; }
+                        reduce = false;
+                    }
+                    else {
+                        v[top].a.push(n);
+                        if (v[top].a.length > v[top].count) { v[top].pop = v[top].a.shift(); }
+                        if (node.action === "max") {
+                            value = Math.max.apply(Math, v[top].a);
+                        }
+                        if (node.action === "min") {
+                            value = Math.min.apply(Math, v[top].a);
+                        }
+                        if (node.action === "mean") {
+                            v[top].tot = v[top].tot + n - v[top].pop;
+                            value = v[top].tot / v[top].a.length;
+                        }
+                        if (node.action === "sd") {
+                            v[top].tot = v[top].tot + n - v[top].pop;
+                            v[top].tot2 = v[top].tot2 + (n*n) - (v[top].pop * v[top].pop);
+                            if (v[top].a.length > 1) {
+                                value = Math.sqrt((v[top].a.length * v[top].tot2 - v[top].tot * v[top].tot)/(v[top].a.length * (v[top].a.length - 1)));
+                            }
+                            else { value = 0; }
+                        }
+                    }
+                    if (node.round !== false) {
+                        value = Math.round(value * Math.pow(10, node.round)) / Math.pow(10, node.round);
+                    }
+                    if (reduce == false || v[top].iter == v[top].count) {
+                        v[top].iter = 0;
+                        RED.util.setMessageProperty(msg,node.property,value);
+                        node.send(msg);
+                    }
+                }
+                else { node.log("Not a number: " + value); }
+            } // ignore msg with no payload property.
+        });
+    }
+    RED.nodes.registerType("smooth", SmoothNode);
+}

function/smooth/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

function/smooth/README.md

@@ -0,0 +1,39 @@
+node-red-node-smooth
+====================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node that provides
+several simple smoothing algorithms for incoming data values. These include
+
+ - Minimum
+ - Maximum
+ - Mean
+ - Standard Deviation
+ - High Pass Smoothing
+ - Low Pass Smoothing
+
+Install
+-------
+
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-smooth
+
+
+Usage
+-----
+
+A simple node to provide various functions across several previous values,
+including max, min, mean, standard deviation, high and low pass filters.
+
+Max, Min, Mean and Standard Deviation work over a rolling window, based on a
+specified number of previous values.
+
+The High and Low pass filters use a smoothing factor. The higher the number
+the more the smoothing. E.g. a value of 10 is similar to an &alpha; of 0.1.
+It is analogous to an RC time constant - but there is no time component to
+this as the code is based on events arriving.
+
+If `msg.reset` is received (with any value), all the counters and intermediate values are reset to an initial state.
+
+**Note:** This node only operates on **numbers**. Anything else will try to be
+made into a number and rejected if that fails.

function/smooth/locales/en-US/17-smooth.html

@@ -0,0 +1,10 @@
+
+<script type="text/html" data-help-name="smooth">
+    <p>A simple node to provide various functions across several previous values, including max, min, mean, high and low pass filters.</p>
+    <p>Messages arriving with different <code>msg.topic</code> can be treated as separate streams if so configured.</p>
+    <p>Max, Min and Mean work over a specified number of previous values.</p>
+    <p>The High and Low pass filters use a smoothing factor. The higher the number the more the smoothing. E.g. a value of 10 is similar to an &alpha; of 0.1. It is analagous to an RC time constant - but there is no time component to this as the time is based on events arriving.</p>
+    <p>Enabling the Reduce option causes the node to only emit one message per N values (available for the Max, Min and Mean functions). E.g. if set to Mean over 10 values, there will only be one outgoing message per 10 incoming ones.</p>
+    <p>If <code>msg.reset</code> is received (with any value), all the counters and intermediate values are reset to an initial state.</p>
+    <p><b>Note:</b> This only operates on <b>numbers</b>. Anything else will try to be made into a number and rejected if that fails.</p>
+</script>

function/smooth/package.json

@@ -0,0 +1,25 @@
+{
+    "name"          : "node-red-node-smooth",
+    "version"       : "0.1.2",
+    "description"   : "A Node-RED node that provides several simple smoothing algorithms for incoming data values.",
+    "dependencies"  : {
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/function/smooth"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "smooth", "average", "standard deviation" ],
+    "node-red"      : {
+        "nodes"     : {
+            "smooth": "17-smooth.js"
+        }
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    },
+    "contributors" : [ "@clickworkorange" ]
+}

hardware/Arduino/35-arduino.html

@@ -0,0 +1,151 @@
+
+<script type="text/html" data-template-name="arduino in">
+    <div class="form-row">
+        <label for="node-input-arduino"><i class="fa fa-tasks"></i> Arduino</label>
+        <input type="text" id="node-input-arduino">
+    </div>
+    <div class="form-row">
+        <label for="node-input-state"><i class="fa fa-wrench"></i> <span data-i18n="arduino.label.type"></span></label>
+        <select type="text" id="node-input-state" style="width:200px;">
+            <option value="INPUT" data-i18n="arduino.state.in.digital"></option>
+            <option value="PULLUP" data-i18n="arduino.state.in.pullup"></option>
+            <option value="ANALOG" data-i18n="arduino.state.in.analogue"></option>
+            <option value="STRING" data-i18n="arduino.state.in.string"></option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-pin"><i class="fa fa-circle"></i> <span data-i18n="arduino.label.pin"></span></label>
+        <input type="text" id="node-input-pin" placeholder="2">
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+    <div class="form-tips"><span data-i18n="[html]arduino.tip.io"></span></div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('arduino in',{
+        category: 'Arduino',
+        color:"#3fadb5",
+        defaults: {
+            name: {value:""},
+            pin: {value:"",validate: function(v) {
+                    var ct = $("#node-input-state").val() || this.state;
+                    return ct === 'STRING' || (v !== '');
+                }},
+            state: {value:"INPUT",required:true},
+            arduino: {type:"arduino-board"}
+        },
+        inputs:0,
+        outputs:1,
+        icon: "arduino.png",
+        label: function() {
+            if (this.state === "STRING") { return "String"; }
+            var a = "";
+            if (this.state === "ANALOG") { a = "A"; }
+            return this.name||"Pin: "+a+this.pin;
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="arduino out">
+    <div class="form-row">
+        <label for="node-input-arduino"><i class="fa fa-tasks"></i> Arduino</label>
+        <input type="text" id="node-input-arduino">
+    </div>
+    <div class="form-row">
+        <label for="node-input-state"><i class="fa fa-wrench"></i> <span data-i18n="arduino.label.type"></span></label>
+        <select type="text" id="node-input-state" style="width:200px;">
+            <option value="OUTPUT" data-i18n="arduino.state.out.digital"></option>
+            <option value="PWM" data-i18n="arduino.state.out.analogue"></option>
+            <option value="SERVO" data-i18n="arduino.state.out.servo"></option>
+            <option value="STRING" data-i18n="arduino.state.out.string"></option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-pin"><i class="fa fa-circle"></i> <span data-i18n="arduino.label.pin"></span></label>
+        <input type="text" id="node-input-pin" placeholder="13">
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+    <div class="form-tips"><span data-i18n="[html]arduino.tip.io"></span></div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('arduino out', {
+        category: 'Arduino',
+        color:"#3fadb5",
+        defaults: {
+            name: {value:""},
+            pin: {value:"",validate: function(v) {
+                    var ct = $("#node-input-state").val() || this.state;
+                    return ct === 'STRING' || (v !== '');
+                }},
+            state: {value:"",required:true},
+            arduino: {type:"arduino-board"}
+        },
+        inputs:1,
+        outputs:0,
+        icon: "arduino.png",
+        align: "right",
+        label: function() {
+            if (this.state === "STRING") { return "String"; }
+            return this.name||"Pin: "+this.pin;
+        },
+        labelStyle: function() {
+            return this.name?"node_label_italic":"";
+        }
+    });
+</script>
+
+
+<script type="text/html" data-template-name="arduino-board">
+    <div class="form-row">
+        <label for="node-config-input-device"><i class="fa fa-random"></i> <span data-i18n="arduino.label.port"></span></label>
+        <input type="text" id="node-config-input-device" style="width:60%;" data-i18n="[placeholder]arduino.placeholder.port"/>
+        <a id="node-config-lookup-serial" class="red-ui-button"><i id="node-config-lookup-serial-icon" class="fa fa-search"></i></a>
+    </div>
+    <div class="form-tips"><span data-i18n="[html]arduino.tip.conf"></span></div>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('arduino-board',{
+        category: 'config',
+        defaults: {
+            device: {value:""}
+        },
+        label: function() {
+            return this.device||"arduino";
+        },
+        oneditprepare: function() {
+            try {
+                $("#node-config-input-device").autocomplete( "destroy" );
+            } catch(err) { }
+            $("#node-config-lookup-serial").click(function() {
+                $("#node-config-lookup-serial-icon").removeClass('fa-search');
+                $("#node-config-lookup-serial-icon").addClass('spinner');
+                $("#node-config-lookup-serial").addClass('disabled');
+
+                $.getJSON('arduinoports',function(data) {
+                    $("#node-config-lookup-serial-icon").addClass('fa-search');
+                    $("#node-config-lookup-serial-icon").removeClass('spinner');
+                    $("#node-config-lookup-serial").removeClass('disabled');
+                    var ports = data || [];
+                    $("#node-config-input-device").autocomplete({
+                        source:ports,
+                        minLength:0,
+                        close: function( event, ui ) {
+                            $("#node-config-input-device").autocomplete( "destroy" );
+                        }
+                    }).autocomplete("search","");
+                });
+            });
+        }
+    });
+</script>

hardware/Arduino/35-arduino.js

@@ -0,0 +1,219 @@
+
+module.exports = function(RED) {
+    "use strict";
+
+    var Board = require('firmata');
+    var SP = require('serialport');
+
+    // The Board Definition - this opens (and closes) the connection
+    function ArduinoNode(n) {
+        RED.nodes.createNode(this,n);
+        this.device = n.device || null;
+        this.running = false;
+        this.reported = false;
+        var node = this;
+
+        var startup = function() {
+            node.board = new Board(node.device, function(e) {
+                if ((e !== undefined) && (e.toString().indexOf("cannot open") !== -1) ) {
+                    if (node.reported === false) {
+                        node.error(RED._("arduino.errors.portnotfound",{device:node.device}));
+                        node.reported = true;
+                    }
+                }
+                else if (e === undefined) {
+                    node.running = true;
+                    node.reported = false;
+                    node.board.once('ready', function() {
+                        node.log(RED._("arduino.status.connected",{device:node.board.sp.path}));
+                        if (RED.settings.verbose) {
+                            node.log(RED._("arduino.status.version",{version:node.board.firmware.name+"-"+node.board.version.major+"."+node.board.version.minor}));
+                        }
+                    });
+                    node.board.once('close', function() {
+                        node.error(RED._("arduino.status.portclosed"));
+                    });
+                    node.board.once('disconnect', function() {
+                        if (node.running === true) { setTimeout(function() { node.running = false; startup(); }, 5000); }
+                    });
+                }
+            });
+            setTimeout(function() { if (node.running === false) { startup(); } }, 5000);
+        };
+        startup();
+
+        node.on('close', function(done) {
+            node.running = false;
+            if (node.board) {
+                try {
+                    node.board.transport.close(function() {
+                        if (RED.settings.verbose) { node.log(RED._("arduino.status.portclosed")); }
+                        done();
+                    });
+                }
+                catch(e) { done(); }
+            }
+            else { done(); }
+        });
+    }
+    RED.nodes.registerType("arduino-board",ArduinoNode);
+
+
+    // The Input Node
+    function DuinoNodeIn(n) {
+        RED.nodes.createNode(this,n);
+        this.buttonState = -1;
+        this.pin = n.pin;
+        this.state = n.state;
+        this.arduino = n.arduino;
+        this.serverConfig = RED.nodes.getNode(this.arduino);
+        this.running = false;
+        var node = this;
+        if (typeof this.serverConfig === "object") {
+            var startup = function() {
+                node.board = node.serverConfig.board;
+                node.board.setMaxListeners(0);
+                node.oldval = "";
+                node.status({fill:"grey",shape:"ring",text:"node-red:common.status.connecting"});
+                var doit = function() {
+                    node.running = true;
+                    if (node.state === "ANALOG") { node.board.pinMode(node.pin, 0x02); }
+                    if (node.state === "INPUT") { node.board.pinMode(node.pin, 0x00); }
+                    if (node.state === "PULLUP") { node.board.pinMode(node.pin, 0x0B); }
+                    node.status({fill:"green",shape:"dot",text:"node-red:common.status.connected"});
+                    if (node.state === "ANALOG") {
+                        node.board.analogRead(node.pin, function(v) {
+                            if (v !== node.oldval) {
+                                node.oldval = v;
+                                node.send({payload:v, topic:"A"+node.pin});
+                            }
+                        });
+                    }
+                    if (node.state === "INPUT") {
+                        node.board.digitalRead(node.pin, function(v) {
+                            if (v !== node.oldval) {
+                                node.oldval = v;
+                                node.send({payload:v, topic:node.pin});
+                            }
+                        });
+                    }
+                    if (node.state === "PULLUP") {
+                        node.board.digitalRead(node.pin, function(v) {
+                            if (v !== node.oldval) {
+                                node.oldval = v;
+                                node.send({payload:v, topic:node.pin});
+                            }
+                        });
+                    }
+                    if (node.state == "STRING") {
+                        node.board.on('string', function(v) {
+                            if (v !== node.oldval) {
+                                node.oldval = v;
+                                node.send({payload:v, topic:"string"});
+                            }
+                        });
+                    }
+                    node.board.once('disconnect', function() {
+                        node.status({fill:"red",shape:"ring",text:"node-red:common.status.not-connected"});
+                        if (node.running) { setTimeout(function() { node.running = false; startup(); }, 5500); }
+                    });
+                }
+                if (node.board.isReady) { doit(); }
+                else { node.board.once("ready", function() { doit(); }); }
+                setTimeout(function() { if (node.running === false) { startup(); } }, 4500);
+            }
+            startup();
+        }
+        else {
+            node.warn(RED._("arduino.errors.portnotconf"));
+        }
+        node.on('close', function() {
+            node.running = false;
+        });
+    }
+    RED.nodes.registerType("arduino in",DuinoNodeIn);
+
+
+    // The Output Node
+    function DuinoNodeOut(n) {
+        RED.nodes.createNode(this,n);
+        this.buttonState = -1;
+        this.pin = n.pin;
+        this.state = n.state;
+        this.arduino = n.arduino;
+        this.serverConfig = RED.nodes.getNode(this.arduino);
+        this.running = false;
+        var node = this;
+        if (typeof node.serverConfig === "object") {
+            var startup = function() {
+                node.board = node.serverConfig.board;
+                node.board.setMaxListeners(0);
+                node.status({fill:"grey",shape:"ring",text:"node-red:common.status.connecting"});
+                var doit = function() {
+                    node.running = true;
+                    if (node.state === "OUTPUT") { node.board.pinMode(node.pin, 0x01); }
+                    if (node.state === "PWM") { node.board.pinMode(node.pin, 0x03); }
+                    if (node.state === "SERVO") { node.board.pinMode(node.pin, 0x04); }
+                    node.status({fill:"green",shape:"dot",text:"node-red:common.status.connected"});
+                    node.on("input", function(msg) {
+                        if (node.board.isReady) {
+                            if (node.state === "OUTPUT") {
+                                if ((msg.payload === true)||(msg.payload.toString() == "1")||(msg.payload.toString().toLowerCase() == "on")) {
+                                    node.board.digitalWrite(node.pin, node.board.HIGH);
+                                }
+                                if ((msg.payload === false)||(msg.payload.toString() == "0")||(msg.payload.toString().toLowerCase() == "off")) {
+                                    node.board.digitalWrite(node.pin, node.board.LOW);
+                                }
+                            }
+                            if (node.state === "PWM") {  
+                                msg.payload = parseInt((msg.payload * 1) + 0.5);
+                                if ((msg.payload >= 0) && (msg.payload <= 255)) {
+                                    node.board.analogWrite(node.pin, msg.payload);
+                                }
+                            }
+                            if (node.state === "SERVO") {
+                                msg.payload = parseInt((msg.payload * 1) + 0.5);
+                                if ((msg.payload >= 0) && (msg.payload <= 180)) {
+                                    node.board.servoWrite(node.pin, msg.payload);
+                                }
+                            }
+                            if (node.state === "SYSEX") {
+                                node.board.sysexCommand(msg.payload);
+                            }
+                            if (node.state === "STRING") {
+                                node.board.sendString(msg.payload.toString());
+                            }
+                        }
+                    });
+                    node.board.once('disconnect', function() {
+                        node.status({fill:"red",shape:"ring",text:"node-red:common.status.not-connected"});
+                        if (node.running === true) { setTimeout(function() { node.running = false; startup(); }, 5500); }
+                    });
+                }
+                if (node.board.isReady) { doit(); }
+                else { node.board.once("ready", function() { doit(); }); }
+                setTimeout(function() { if (node.running === false) { startup(); } }, 4500);
+            }
+            startup();
+        }
+        else {
+            node.warn(RED._("arduino.errors.portnotconf"));
+        }
+        node.on('close', function() {
+            node.running = false;
+        });
+    }
+    RED.nodes.registerType("arduino out",DuinoNodeOut);
+
+    RED.httpAdmin.get("/arduinoports", RED.auth.needsPermission("arduino.read"), function(req,res) {
+        SP.list().then(
+            ports => {
+                const a = ports.map(p => p.comName);
+                res.json(a);
+            },
+            err => {
+                this.log('Error listing serial ports', err)
+            }
+        )
+    });
+}

hardware/Arduino/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

hardware/Arduino/README.md

@@ -0,0 +1,51 @@
+node-red-node-arduino
+=====================
+
+A <a href="http://nodered.org" target="_new">Node-RED</a> node to talk to an
+Arduino running standard firmata 2.2 or better.
+
+Install
+-------
+
+Either use the Menu - Manage Palette option or run the following command in your Node-RED user directory - typically `~/.node-red`
+
+        npm i --unsafe-perm node-red-node-arduino
+
+Usage
+-----
+
+The Firmata firmware must be loaded into the Arduino.
+
+See the [main documentation](http://nodered.org/docs/hardware/arduino.html) for
+details and examples of how to use this node.
+
+### Input Node
+
+Connects to local Arduino and monitors the selected pin for changes.
+
+You can select either **Digital**, **Pullup**, **Analogue**, or **String** input type.
+Outputs the value read as `msg.payload` and the pin number as `msg.topic`.
+
+It only outputs on a change of value - fine for digital inputs, but you can get a lot of data from analogue pins which you must then handle. For example you could use a `delay` node set to rate limit and drop intermediate values, or an `rbe` node to only report when it changes by a certain amount.
+
+### Output Node
+
+Connects to local Arduino and writes to the selected pin.
+
+You can select
+
+ - **Digital** - accepts 0, 1, true, false, on, off
+ - **Analogue** (PWM) - accepts Integer 0 to 255
+ - **Servo** - accepts Integer 0 - 180
+ - **String** - to send a *String* to the Arduino
+
+Expects a numeric value in `msg.payload`. The pin number is set in the properties panel.
+
+*Note* - some servos will not travel a full 180 degree range so may only accept 30 - 150 degrees for example.
+Please use the `range` node to scale the input appropriately.
+
+### Example
+
+Simple flow to blink Pin 13
+
+        [{"id":"d7663aaf.47194","type":"arduino-board","device":""},{"id":"dae8234f.2517e","type":"inject","name":"0.5s tick","topic":"","payload":"","payloadType":"date","repeat":"0.5","crontab":"","once":false,"x":150,"y":100,"z":"359a4b52.ca65b4","wires":[["56a6f8f2.a95908"]]},{"id":"2db61802.d249e8","type":"arduino out","name":"","pin":"13","state":"OUTPUT","arduino":"d7663aaf.47194","x":570.5,"y":100,"z":"359a4b52.ca65b4","wires":[]},{"id":"56a6f8f2.a95908","type":"function","name":"Toggle output on input","func":"\n// If it does exist make it the inverse of what it was or else initialise it to false\n// (context variables persist between calls to the function)\ncontext.level = !context.level || false;\n\n// set the payload to the level and return\nmsg.payload = context.level;\nreturn msg;","outputs":1,"noerr":0,"x":358,"y":100,"z":"359a4b52.ca65b4","wires":[["2db61802.d249e8"]]}]

hardware/Arduino/locales/de/35-arduino.json

@@ -0,0 +1,42 @@
+{
+    "arduino": {
+        "label": {
+            "pin": "Pin",
+            "type": "Typ",
+            "port": "Port"
+        },
+        "placeholder": {
+            "port": "z. B. /dev/ttyUSB0 COM1"
+        },
+        "status": {
+            "connectfirst": "Verbinde mit zuerst gefundenen Board",
+            "connect": "Verbinde mit __device__",
+            "connected": "Verbunden mit __device__",
+            "version": "Version: __version__",
+            "portclosed": "Serieller Arduino-Port geschlossen"
+        },
+        "state": {
+            "in": {
+                "digital": "Digitaler Pin",
+                "pullup": "Digitaler Pin mit Pullup",
+                "analogue": "Analoger Pin",
+                "string": "String"
+            },
+            "out": {
+                "digital": "Digital (0/1)",
+                "analogue": "Analog (0-255)",
+                "servo": "Servo (0-180)",
+                "string": "String"
+            }
+        },
+        "tip": {
+            "io": "<b>Hinweis:</b> Derselbe Pin kann nicht gleichzeitig als Ausgang und Eingang verwendet werden",
+            "conf": "<b>Tipp:</b> Zur automatischen Erkennung des seriellen Ports die Suche verwenden"
+        },
+        "errors": {
+            "portnotconf": "Port nicht konfiguriert",
+            "portnotfound": "Port nicht gefunden: __device__",
+            "devnotfound": "Device __dev__ nicht gefunden. Versuche Board zu finden."
+        }
+    }
+}

hardware/Arduino/locales/en-US/35-arduino.html

@@ -0,0 +1,16 @@
+
+<script type="text/html" data-help-name="arduino in">
+    <p>Arduino input node. Connects to a local Arduino and monitors the selected pin for changes. Uses <a href="http://firmata.org/" target="_new"><i>Firmata</i>.</a></p>
+    <p>The Arduino must be loaded with the Standard Firmata sketch available in the Arduino examples.</p>
+    <p>You can select either Digital or Analogue input. Outputs the value read as <code>msg.payload</code> and the pin number as <code>msg.topic</code>.</p>
+    <p>It only outputs on a change of value - fine for digital inputs, but you can get a lot of data from analogue pins which you must then handle.</p>
+    <p>For example you could use a <code>delay</code> node set to rate limit and drop intermediate values, or an <code>rbe</code> node to only report when it changes by a certain amount.</p>
+</script>
+
+<script type="text/html" data-help-name="arduino out">
+    <p>Arduino output node. Connects to local Arduino and writes to the selected digital
+    pin. Uses <a href="http://firmata.org/" target="_new"><i>Firmata</i>.</a></p>
+    <p>The Arduino must be loaded with the Standard Firmata sketch available in the Arduino examples.</p>
+    <p>You can select Digital, Analogue (PWM) or Servo type outputs. Expects an integer numeric
+    value in <code>msg.payload</code>. The pin number is set in the properties panel.</p>
+</script>

hardware/Arduino/locales/en-US/35-arduino.json

@@ -0,0 +1,42 @@
+{
+    "arduino": {
+        "label": {
+            "pin": "Pin",
+            "type": "Type",
+            "port": "Port"
+        },
+        "placeholder": {
+            "port": "e.g. /dev/ttyUSB0  COM1"
+        },
+        "status": {
+            "connectfirst": "connecting to first board found",
+            "connect": "connecting to __device__",
+            "connected": "connected to __device__",
+            "version": "version: __version__",
+            "portclosed": "Arduino serial port closed"
+        },
+        "state": {
+            "in": {
+                "digital": "Digital pin",
+                "pullup": "Digital pin with pullup",
+                "analogue": "Analogue pin",
+                "string": "String"
+            },
+            "out": {
+                "digital": "Digital (0/1)",
+                "analogue": "Analogue (0-255)",
+                "servo": "Servo (0-180)",
+                "string": "String"
+            }
+        },
+        "tip": {
+            "io": "<b>Note:</b> You cannot use the same pin for both output and input.",
+            "conf": "<b>Tip:</b> Use search to try to auto-detect serial port."
+        },
+        "errors": {
+            "portnotconf": "port not configured",
+            "portnotfound": "port not found : __device__",
+            "devnotfound": "device __dev__ not found. Trying to find board."
+        }
+    }
+}

hardware/Arduino/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "node-red-node-arduino",
+    "version": "0.3.1",
+    "description": "A Node-RED node to talk to an Arduino running firmata",
+    "dependencies": {
+        "firmata": "^2.3.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/hardware/Arduino"
+    },
+    "license": "Apache-2.0",
+    "keywords": [
+        "node-red",
+        "arduino",
+        "firmata"
+    ],
+    "node-red": {
+        "nodes": {
+            "arduino": "35-arduino.js"
+        }
+    },
+    "engines": {
+        "node": ">=8"
+    },
+    "author": {
+        "name": "Dave Conway-Jones",
+        "email": "ceejay@vnet.ibm.com",
+        "url": "http://nodered.org"
+    }
+}

hardware/BBB/145-BBB-hardware.html

@@ -1,23 +1,8 @@
-<!--
-  Copyright 2014 Maxwell R Hadley
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
--->
 
 <!-- Edit dialog for bbb-analogue-in -->
 <script type="text/x-red" data-template-name="bbb-analogue-in">
    <div class="form-row">
-       <label for="node-input-pin"><i class="icon-asterisk"></i>Input pin</label>
+       <label for="node-input-pin"><i class="fa fa-asterisk"></i>Input pin</label>
        <select type="text" id="node-input-pin" style="width: 150px;">
            <option value="">select pin</option>
            <option value="P9_39">AIN0 (P9 pin 39)</option>
@@ -30,7 +15,7 @@
        </select>
    </div>
     <div class="form-row">
-        <label for="node-input-topic"><i class="icon-tasks"></i> Topic</label>
+        <label for="node-input-topic"><i class="fa fa-tasks"></i> Topic</label>
         <input type="text" id="node-input-topic" placeholder="Topic">
     </div>
     <div class="form-row">
@@ -43,13 +28,13 @@
         </div>
     </div>
     <div class="form-row">
-        <a href="#" class="btn btn-mini" id="node-input-add-breakpoint" style="margin-top: 4px;"><i class="icon-plus"></i> Add Breakpoint</a>
+        <a href="#" class="btn btn-mini" id="node-input-add-breakpoint" style="margin-top: 4px;"><i class="fa fa-plus"></i> Add Breakpoint</a>
         <span style="float:right; margin-top:4px">
             <input type="checkbox" id="node-input-averaging" style="display:inline-block; width:auto; vertical-align:top;"> Averaging&nbsp;
-        </span> 
+        </span>
     </div>
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
@@ -78,7 +63,7 @@ voltage ten times in rapid succession for each input message and output the mean
 <!-- Register bbb-analogue-in node -->
 <script type="text/javascript">
     RED.nodes.registerType('bbb-analogue-in', {
-        category: 'advanced-input', // the palette category
+        category: 'Beaglebone', // the palette category
         color:"#de7224",
         defaults: {                 // defines the editable properties of the node
             pin: { value:"", required:true },
@@ -124,11 +109,11 @@ voltage ten times in rapid succession for each input message and output the mean
                             });
                     } else {
                         mutableFlag.attr("mutable", "false");
-                    }                   
+                    }
                     if (insert === true) {
                         var last = $("#node-input-breakpoint-container").children().last();
                         var prev = last.prev();
-                        inputValueField.val((Number(last.find(".node-input-breakpoint-input-value").val()) + 
+                        inputValueField.val((Number(last.find(".node-input-breakpoint-input-value").val()) +
                                                 Number(prev.find(".node-input-breakpoint-input-value").val()))/2);
                         outputValueField.val((Number(last.find(".node-input-breakpoint-output-value").val()) +
                                                 Number(prev.find(".node-input-breakpoint-output-value").val()))/2);
@@ -139,21 +124,21 @@ voltage ten times in rapid succession for each input message and output the mean
                         $("#node-input-breakpoint-container").append(container);
                     }
                 }
-                
+
                 $("#node-input-add-breakpoint").click(function () {
                         generateBreakpoint({input:0, output:0, mutable:true}, true);
                         $("#node-input-breakpoint-container-div").scrollTop($("#node-input-breakpoint-container-div").get(0).scrollHeight);
                     });
-                    
+
                 for (var i = 0; i < this.breakpoints.length; i++) {
                     var breakpoint = this.breakpoints[i];
                     generateBreakpoint(breakpoint, false);
                 }
-                
+
                 // Handle resizing the Input Scaling div when the dialog is resized - this isn't quite right!
                 function switchDialogResize(ev, ui) {
                     $("#node-input-breakpoint-container-div").css("height", (ui.size.height - 299) + "px");
-                };
+                }
 
                 $("#dialog").on("dialogresize", switchDialogResize);
                 $("#dialog").one("dialogopen", function (ev) {
@@ -186,7 +171,7 @@ voltage ten times in rapid succession for each input message and output the mean
 <!-- Edit dialog for bbb-discrete-in -->
 <script type="text/x-red" data-template-name="bbb-discrete-in">
    <div class="form-row">
-       <label for="node-input-pin"><i class="icon-asterisk"></i>Input pin</label>
+       <label for="node-input-pin"><i class="fa fa-asterisk"></i>Input pin</label>
        <select type="text" id="node-input-pin" style="width: 200px;">
            <option value="">select pin</option>
            <option value="P8_7">GPIO2_2 (P8 pin 7)</option>
@@ -228,7 +213,7 @@ voltage ten times in rapid succession for each input message and output the mean
     </div>
     <div class="form-row">
         <label for="node-input-debounce">Debounce</label>
-        <input type="checkbox" id="node-input-debounce" style="display:inline-block; width:auto; vertical-align:top;">
+        <input type="text" id="node-input-debounce" placeholder="debounce time in mS" style="width: 160px"> mS
     </div>
     <div class="form-row">
         <label for="node-input-outputOn">Output on</label>
@@ -239,16 +224,16 @@ voltage ten times in rapid succession for each input message and output the mean
         </select>
     </div>
     <div class="form-row">
-        <label for="node-input-updateInterval"><i class="icon-repeat"></i> Update at</label>
+        <label for="node-input-updateInterval"><i class="fa fa-repeat"></i> Update at</label>
         <input id="node-input-updateInterval" type="text" style="width: 65px">
         <label>sec intervals</label>
     </div>
     <div class="form-row">
-        <label for="node-input-topic"><i class="icon-tasks"></i> Topic</label>
+        <label for="node-input-topic"><i class="fa fa-tasks"></i> Topic</label>
         <input type="text" id="node-input-topic" placeholder="Topic">
     </div>
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
@@ -279,12 +264,12 @@ press. When using buttons or switches, enable debouncing to improve reliability.
 <!-- Register bbb-discrete-in node -->
 <script type="text/javascript">
     RED.nodes.registerType('bbb-discrete-in', {
-        category: 'advanced-input', // the palette category
+        category: 'Beaglebone', // the palette category
         color:"#de7224",
         defaults: {                 // defines the editable properties of the node
             pin: { value:"", required:true },
             activeLow: { value:false, required:true },
-            debounce: { value:false, required:true },
+            debounce: { value:0, required:true },
             outputOn: { value:"both", required:true },
             updateInterval: { value:60, required:true, validate:RED.validators.number() },
             topic: { value:"" },
@@ -305,7 +290,7 @@ press. When using buttons or switches, enable debouncing to improve reliability.
 <!-- Edit dialog for bbb-pulse-in -->
 <script type="text/x-red" data-template-name="bbb-pulse-in">
    <div class="form-row">
-       <label for="node-input-pin"><i class="icon-asterisk"></i>Input pin</label>
+       <label for="node-input-pin"><i class="fa fa-asterisk"></i>Input pin</label>
        <select type="text" id="node-input-pin" style="width: 200px;">
            <option value="">select pin</option>
            <option value="P8_7">GPIO2_2 (P8 pin 7)</option>
@@ -359,16 +344,16 @@ press. When using buttons or switches, enable debouncing to improve reliability.
         <label style="width: 60%"> units per count/second</label>
     </div>
     <div class="form-row">
-        <label for="node-input-updateInterval"><i class="icon-repeat"></i> Update at</label>
+        <label for="node-input-updateInterval"><i class="fa fa-repeat"></i> Update at</label>
         <input id="node-input-updateInterval" type="text" style="width: 65px">
         <label>sec intervals</label>
     </div>
     <div class="form-row">
-        <label for="node-input-topic"><i class="icon-tasks"></i> Topic</label>
+        <label for="node-input-topic"><i class="fa fa-tasks"></i> Topic</label>
         <input type="text" id="node-input-topic" placeholder="Topic">
     </div>
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
@@ -390,7 +375,7 @@ any other input message will reset it to zero.
 <!-- Register bbb-pulse-in node -->
 <script type="text/javascript">
     RED.nodes.registerType('bbb-pulse-in', {
-        category: 'advanced-input', // the palette category
+        category: 'Beaglebone', // the palette category
         color:"#de7224",
         defaults: {                 // defines the editable properties of the node
             pin: { value:"", required:true },
@@ -416,7 +401,7 @@ any other input message will reset it to zero.
 <!-- Edit dialog for bbb-discrete-out -->
 <script type="text/x-red" data-template-name="bbb-discrete-out">
    <div class="form-row">
-       <label for="node-input-pin"><i class="icon-asterisk"></i>Output pin</label>
+       <label for="node-input-pin"><i class="fa fa-asterisk"></i>Output pin</label>
        <select type="text" id="node-input-pin" style="width: 200px;">
            <option value="">select pin</option>
            <option value="P8_7">GPIO2_2 (P8 pin 7)</option>
@@ -472,7 +457,7 @@ any other input message will reset it to zero.
         </select>
     </div>
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
@@ -501,7 +486,7 @@ the Inverting property is not applied to this value.
 <!-- Register bbb-discrete-out node -->
 <script type="text/javascript">
     RED.nodes.registerType('bbb-discrete-out', {
-        category: 'advanced-input', // the palette category
+        category: 'Beaglebone', // the palette category
         color:"#de7224",
         defaults: {                 // defines the editable properties of the node
             pin: { value:"", required:true },
@@ -526,7 +511,7 @@ the Inverting property is not applied to this value.
 <!-- Edit dialog for bbb-pulse-out -->
 <script type="text/x-red" data-template-name="bbb-pulse-out">
    <div class="form-row">
-       <label for="node-input-pin"><i class="icon-asterisk"></i>Output pin</label>
+       <label for="node-input-pin"><i class="fa fa-asterisk"></i>Output pin</label>
        <select type="text" id="node-input-pin" style="width: 200px;">
            <option value="">select pin</option>
            <option value="P8_7">GPIO2_2 (P8 pin 7)</option>
@@ -567,7 +552,7 @@ the Inverting property is not applied to this value.
         </select>
     </div>
     <div class="form-row">
-        <label for="node-input-pulseTime"><i class="icon-repeat"></i> Pulse time</label>
+        <label for="node-input-pulseTime"><i class="fa fa-repeat"></i> Pulse time</label>
         <input id="node-input-pulseTime" type="text" style="width: 65px">
         <label> seconds</label>
     </div>
@@ -583,7 +568,7 @@ the Inverting property is not applied to this value.
         </select>
     </div>
     <div class="form-row">
-        <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
 </script>
@@ -614,7 +599,7 @@ the pin changes state: its payload is the new state (0 or 1).
 <!-- Register bbb-pulse-out node -->
 <script type="text/javascript">
     RED.nodes.registerType('bbb-pulse-out', {
-        category: 'advanced-input', // the palette category
+        category: 'Beaglebone', // the palette category
         color:"#de7224",
         defaults: {                 // defines the editable properties of the node
             pin: { value:"", required:true },
@@ -635,4 +620,3 @@ the pin changes state: its payload is the new state (0 or 1).
         }
     });
 </script>
-

hardware/BBB/145-BBB-hardware.js

@@ -1,155 +1,185 @@
-/**
- * Copyright 2014 Maxwell R Hadley
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- **/
 
-// Require main module
-var RED = require(process.env.NODE_RED_HOME + "/red/red");
-var bonescript = require("bonescript");
-
-// Node constructor for bbb-analogue-in
-function AnalogueInputNode(n) {
-    // Create a RED node
-    RED.nodes.createNode(this, n);
-
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;
-    this.pin = n.pin;
-    this.breakpoints = n.breakpoints;
-    this.averaging = n.averaging;
-    if (this.averaging) {
-        this.averages = 10;
-    } else {
-        this.averages = 1;
+module.exports = function (RED) {
+    "use strict";
+    var bonescript, adjustName, setPinMode;
+    var analogInputPins = ["P9_39", "P9_40", "P9_37", "P9_38", "P9_33", "P9_36", "P9_35"];
+    var gpioPins = ["P8_7", "P8_8", "P8_9", "P8_10", "P8_11", "P8_12", "P8_13", "P8_14", "P8_15",
+        "P8_16", "P8_17", "P8_18", "P8_19", "P8_26", "P9_11", "P9_12", "P9_13", "P9_14",
+        "P9_15", "P9_16", "P9_17", "P9_18", "P9_21", "P9_22", "P9_23", "P9_24", "P9_26",
+        "P9_27", "P9_30", "P9_41", "P9_42"];
+    var usrLEDs = ["USR0", "USR1", "USR2", "USR3"];
+    // Load the hardware library and set up polymorphic functions to suit it. Prefer
+    // octalbonescript (faster & less buggy) but drop back to bonescript if not available
+    bonescript = require("octalbonescript");
+    adjustName = function (pin) {
+        if (pin === "P8_7") {
+            pin = "P8_07";
+        }
+        else if (pin === "P8_8") {
+            pin = "P8_08";
+        }
+        else if (pin === "P8_9") {
+            pin = "P8_09";
+        }
+        return pin;
+    };
+    setPinMode = function (pin, mode, callback) {
+        bonescript.pinMode(pin, mode, callback);
     }
 
-    // Define 'node' to allow us to access 'this' from within callbacks
-    var node = this;
+    // Node constructor for bbb-analogue-in
+    function AnalogueInputNode(n) {
+        RED.nodes.createNode(this, n);
+        var node = this;
 
-    // Variables used for input averaging
-    var sum;    // accumulates the input readings to be averaged
-    var count;  // keep track of the number of measurements made
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;
+        this.pin = n.pin;                               // The Beaglebone Black pin identifying string
+        this._pin = adjustName(this.pin);               // Adjusted for Octal if necessary
+        this.breakpoints = n.breakpoints;
+        this.averaging = n.averaging;
+        if (this.averaging) {
+            this.averages = 10;
+        }
+        else {
+            this.averages = 1;
+        }
 
-    // The callback function for analogRead. Accumulates the required number of
-    // measurements, then divides the total number, applies output scaling and
-    // sends the result
-    var analogReadCallback = function (x) {
-            sum = sum + x.value;
+        // Variables used for input averaging
+        var sum;    // accumulates the input readings to be averaged
+        var count;  // keep track of the number of measurements made
+
+        // The callback function for analogRead. Accumulates the required number of
+        // measurements, then divides the total number, applies output scaling and
+        // sends the result
+        var analogReadCallback = function (err, x) {
+            sum = sum + Number(x);
             count = count - 1;
             if (count > 0) {
-                bonescript.analogRead(node.pin, analogReadCallback);
-            } else {
+                bonescript.analogRead(node._pin, analogReadCallback);
+            }
+            else {
                 var msg = {};
                 msg.topic = node.topic;
                 sum = sum/node.averages;
                 // i is the index of the first breakpoint where the 'input' value is strictly
                 // greater than the measurement (note: a measurement can never be == 1)
-                var i = node.breakpoints.map(function (breakpoint) { return sum >= breakpoint.input; }).indexOf(false);
-                msg.payload = node.breakpoints[i-1].output + (node.breakpoints[i].output - node.breakpoints[i-1].output) *
-                                (sum - node.breakpoints[i-1].input)/(node.breakpoints[i].input - node.breakpoints[i-1].input);
+                var i = node.breakpoints.map(function (breakpoint) {
+                    return sum >= breakpoint.input;
+                }).indexOf(false);
+                msg.payload = node.breakpoints[i - 1].output + (node.breakpoints[i].output - node.breakpoints[i - 1].output)*
+                (sum - node.breakpoints[i - 1].input)/(node.breakpoints[i].input - node.breakpoints[i - 1].input);
                 node.send(msg);
             }
         };
 
-    // If we have a valid pin, set the input event handler to Bonescript's analogRead
-    if (["P9_39", "P9_40", "P9_37", "P9_38", "P9_33", "P9_36", "P9_35"].indexOf(node.pin) >= 0) {
-        node.on("input", function (msg) {
+        // If we have a valid pin, set the input event handler to Bonescript's analogRead
+        if (analogInputPins.indexOf(node.pin) >= 0) {
+            node.on("input", function () {
                 sum = 0;
                 count = node.averages;
-                bonescript.analogRead(node.pin, analogReadCallback);
+                bonescript.analogRead(node._pin, analogReadCallback);
             });
-    } else {
-        node.error("Unconfigured input pin");
-    }
-}
-
-// Node constructor for bbb-discrete-in
-function DiscreteInputNode(n) {
-    RED.nodes.createNode(this, n);
-
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;                           // the topic is not currently used
-    this.pin = n.pin;                               // The Beaglebone Black pin identifying string
-    if (n.activeLow)                                // Set the 'active' state 0 or 1 as appropriate
-        this.activeState = 0;
-    else
-        this.activeState = 1;
-    this.updateInterval = n.updateInterval * 1000;  // How often to send totalActiveTime messages
-    this.debounce = n.debounce;                     // Enable switch contact debouncing algorithm
-    if (n.outputOn === "rising") {
-        this.activeEdges = [false, true];
-    } else if (n.outputOn === "falling") {
-        this.activeEdges = [true, false];
-    } else if (n.outputOn === "both") {
-        this.activeEdges = [true, true];
-    } else {
-        node.error("Invalid edge type: " + n.outputOn);
+        }
+        else {
+            node.error("Unconfigured input pin");
+        }
     }
 
-    // Working variables
-    this.interruptAttached = false; // Flag: should we detach interrupt when we are closed?
-    this.intervalId = null;         // Remember the timer ID so we can delete it when we are closed
-    this.currentState = 0;          // The pin input state "1" or "0"
-    this.lastActiveTime = NaN;      // The date (in ms since epoch) when the pin last went high
-                                    // switch to process.hrtime()
-    this.totalActiveTime = 0;       // The total time in ms that the pin has been high (since reset)
-    this.starting = true;
-    this.debouncing = false;        // True after a change of state while waiting for the 7ms debounce time to elapse
-    this.debounceTimer = null;
+    // Node constructor for bbb-discrete-in
+    function DiscreteInputNode(n) {
+        RED.nodes.createNode(this, n);
+        var node = this;
 
-    // Define 'node' to allow us to access 'this' from within callbacks
-    var node = this;
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;                           // the topic is not currently used
+        this.pin = n.pin;                               // The Beaglebone Black pin identifying string
+        this._pin = adjustName(this.pin);               // Adjusted for Octal if necessary
+        if (n.activeLow) {                              // Set the 'active' state 0 or 1 as appropriate
+            this.activeState = 0;
+        }
+        else {
+            this.activeState = 1;
+        }
+        this.updateInterval = n.updateInterval*1000;    // How often to send totalActiveTime messages
+        this.debounce = n.debounce || null;             // Enable switch contact debouncing algorithm
+        if (n.outputOn === "rising") {
+            this.activeEdges = [false, true];
+        }
+        else if (n.outputOn === "falling") {
+            this.activeEdges = [true, false];
+        }
+        else if (n.outputOn === "both") {
+            this.activeEdges = [true, true];
+        }
+        else {
+            node.error("Invalid edge type: " + n.outputOn);
+        }
 
-    // This function is called by the input pin change-of-state interrupt. If
-    // debounce is disabled, send the output message. Otherwise, if we are
-    // currently debouncing, ignore this interrupt. If we are not debouncing,
-    // schedule a re-read of the input pin in 7ms time, and set the debouncing flag
-    // Note: this function gets called spuriously when the interrupt is first enabled:
-    // in this case x.value is undefined - we must test for this
-    var interruptCallback = function (x) {
-            if (x.value !== undefined && node.currentState !== Number(x.value)) {
+        // Working variables
+        this.interruptAttached = false; // Flag: should we detach interrupt when we are closed?
+        this.intervalId = null;         // Remember the timer ID so we can delete it when we are closed
+        this.currentState = 0;          // The pin input state "1" or "0"
+        this.lastActiveTime = NaN;      // The date (in ms since epoch) when the pin last went high
+        // switch to process.hrtime()
+        this.totalActiveTime = 0;       // The total time in ms that the pin has been high (since reset)
+        this.starting = true;
+        this.debouncing = false;        // True after a change of state while waiting for the 7ms debounce time to elapse
+        this.debounceTimer = null;
+
+        // This function is called by the input pin change-of-state interrupt. If
+        // debounce is disabled, send the output message. Otherwise, if we are
+        // currently debouncing, ignore this interrupt. If we are not debouncing,
+        // schedule a re-read of the input pin in 7ms time, and set the debouncing flag
+        // Note: if x has an 'attached' field and no 'value' field, the callback is reporting
+        // the success or failure of attaching the interrupt - we must handle this
+        var interruptCallback = function (err, x) {
+            if (x === undefined) {
+                if (x.attached === true) {
+                    node.interruptAttached = true;
+                    node.on("input", inputCallback);
+                    node.intervalId = setInterval(timerCallback, node.updateInterval);
+                }
+                else {
+                    node.error("Failed to attach interrupt");
+                }
+            }
+            else if (node.currentState !== Number(x)) {
                 if (node.debounce) {
                     if (node.debouncing === false) {
                         node.debouncing = true;
-                        node.debounceTimer = setTimeout(function () { bonescript.digitalRead(node.pin, debounceCallback); }, 7);
+                        node.debounceTimer = setTimeout(function () {
+                            bonescript.digitalRead(node._pin, debounceCallback);
+                        }, Number(node.debounce));
                     }
-                } else {
+                }
+                else {
                     sendStateMessage(x);
                 }
             }
         };
 
-    // This function is called approx 7ms after a potential change-of-state which is
-    // being debounced. Terminate the debounce, and send a message if the state has
-    // actually changed
-    var debounceCallback = function (x) {
+        // This function is called approx 7ms after a potential change-of-state which is
+        // being debounced. Terminate the debounce, and send a message if the state has
+        // actually changed
+        var debounceCallback = function (err, x) {
             node.debounceTimer = null;
             node.debouncing = false;
-            if (x.value !== undefined && node.currentState !== Number(x.value)) {
+            if (x !== undefined && node.currentState !== Number(x)) {
                 sendStateMessage(x);
             }
         };
 
-    // This function is called when either the interruptCallback or the debounceCallback
-    // have determined we have a 'genuine' change of state. Update the currentState and
-    // ActiveTime variables, and send a message on the first output with the new state
-    var sendStateMessage = function (x) {
-            node.currentState = Number(x.value);
+        // This function is called when either the interruptCallback or the debounceCallback
+        // have determined we have a 'genuine' change of state. Update the currentState and
+        // ActiveTime variables, and send a message on the first output with the new state
+        var sendStateMessage = function (x) {
+            node.currentState = Number(x);
             var now = Date.now();
             if (node.currentState === node.activeState) {
                 node.lastActiveTime = now;
-            } else if (!isNaN(node.lastActiveTime)) {
+            }
+            else if (!isNaN(node.lastActiveTime)) {
                 node.totalActiveTime += now - node.lastActiveTime;
             }
             if (node.activeEdges[node.currentState]) {
@@ -160,9 +190,9 @@ function DiscreteInputNode(n) {
             }
         };
 
-    // This function is called by the timer. It updates the ActiveTime variables, and sends a
-    // message on the second output with the latest value of the total active time, in seconds
-    var timerCallback = function () {
+        // This function is called by the timer. It updates the ActiveTime variables, and sends a
+        // message on the second output with the latest value of the total active time, in seconds
+        var timerCallback = function () {
             if (node.currentState === node.activeState) {
                 var now = Date.now();
                 node.totalActiveTime += now - node.lastActiveTime;
@@ -170,23 +200,24 @@ function DiscreteInputNode(n) {
             }
             var msg = {};
             msg.topic = node.topic;
-            msg.payload = node.totalActiveTime / 1000;
+            msg.payload = node.totalActiveTime/1000;
             node.send([null, msg]);
             // Re-synchronise the pin state if we have missed a state change interrupt for some
             // reason, and we are not in the process of debouncing one
             if (node.debouncing === false) {
-                bonescript.digitalRead(node.pin, interruptCallback);
+                bonescript.digitalRead(node._pin, interruptCallback);
             }
         };
 
-    // This function is called when we receive an input message. If the topic contains
-    // 'load' (case insensitive) set the totalActiveTime to the numeric value of the
-    // payload, if possible. Otherwise clear the totalActiveTime (so we start counting
-    // from zero again)
-    var inputCallback = function (ipMsg) {
-            if (String(ipMsg.topic).search(/load/i) < 0 || isFinite(ipMsg.payload) == false) {
+        // This function is called when we receive an input message. If the topic contains
+        // 'load' (case insensitive) set the totalActiveTime to the numeric value of the
+        // payload, if possible. Otherwise clear the totalActiveTime (so we start counting
+        // from zero again)
+        var inputCallback = function (ipMsg) {
+            if (String(ipMsg.topic).search(/load/i) < 0 || isFinite(ipMsg.payload) === false) {
                 node.totalActiveTime = 0;
-            } else {
+            }
+            else {
                 node.totalActiveTime = Number(ipMsg.payload);
             }
             if (node.currentState === node.activeState) {
@@ -198,305 +229,337 @@ function DiscreteInputNode(n) {
                 node.starting = false;
                 var msg;
                 if (node.activeEdges[0] && node.activeEdges[1]) {
-                    msg = [{topic:node.topic}, {topic:node.topic}];
+                    msg = [{topic: node.topic}, {topic: node.topic}];
                     msg[0].payload = node.currentState;
-                } else {
-                    msg = [null, {topic:node.topic}];
+                }
+                else {
+                    msg = [null, {topic: node.topic}];
                 }
                 msg[1].payload = node.totalActiveTime;
                 node.send(msg);
             }
         };
 
-    // If we have a valid pin, set it as an input and read the (digital) state
-    if (["P8_7", "P8_8", "P8_9", "P8_10", "P8_11", "P8_12", "P8_13", "P8_14", "P8_15",
-         "P8_16", "P8_17", "P8_18", "P8_19", "P8_26", "P9_11", "P9_12", "P9_13", "P9_14",
-         "P9_15", "P9_16", "P9_17", "P9_18", "P9_21", "P9_22", "P9_23", "P9_24", "P9_26",
-         "P9_27", "P9_30", "P9_41", "P9_42"].indexOf(node.pin) >= 0) {
-        // Don't set up interrupts & intervals until after the close event handler has been installed
-        bonescript.detachInterrupt(node.pin);
-        process.nextTick(function () {
-            bonescript.pinMode(node.pin, bonescript.INPUT);
-            bonescript.digitalRead(node.pin, function (x) {
-                        // Initialise the currentState and lastActveTime variables based on the value read
-                        node.currentState = Number(x.value);
-                        if (node.currentState === node.activeState) {
-                            node.lastActiveTime = Date.now();
-                            // switch to process.hrtime()
-                        }
-                        // Attempt to attach a change-of-state interrupt handler to the pin. If we succeed,
-                        // set the input event and interval handlers, then send an initial message with the
-                        // pin state on the first output
-                        if (bonescript.attachInterrupt(node.pin, true, bonescript.CHANGE, interruptCallback)) {
-                            node.interruptAttached = true;
-                            node.on("input", inputCallback);
-                            node.intervalId = setInterval(timerCallback, node.updateInterval);
-                        } else {
-                            node.error("Failed to attach interrupt");
-                        }
-                        setTimeout(function () { node.emit("input", {}); }, 50);
-                    });
+        // If we have a valid pin, set it as an input and read the (digital) state
+        if (gpioPins.indexOf(node.pin) >= 0) {
+            // Don't set up interrupts & intervals until after the close event handler has been installed
+            bonescript.detachInterrupt(node._pin);
+            process.nextTick(function () {
+                setPinMode(node._pin, bonescript.INPUT, function (response, pin) {
+                    if (!response) {
+                        bonescript.digitalRead(node._pin, function (err, x) {
+                            // Initialise the currentState and lastActiveTime variables based on the value read
+                            node.currentState = Number(x);
+                            if (node.currentState === node.activeState) {
+                                node.lastActiveTime = Date.now();
+                            }
+                            // Attempt to attach a change-of-state interrupt handler to the pin. If we succeed,
+                            // the input event and interval handlers will be installed by interruptCallback
+                            bonescript.attachInterrupt(node._pin, bonescript.CHANGE, interruptCallback);
+                            // Send an initial message with the pin state on the first output
+                            setTimeout(function () {
+                                node.emit("input", {});
+                            }, 50);
+                        });
+                    }
+                    else {
+                        node.error("Unable to set " + pin + " as input: " + response);
+                    }
                 });
-    } else {
-        node.error("Unconfigured input pin");
+            });
+        }
+        else {
+            node.error("Unconfigured input pin");
+        }
     }
-}
 
-// Node constructor for bbb-pulse-in
-function PulseInputNode(n) {
-    RED.nodes.createNode(this, n);
+    // Node constructor for bbb-pulse-in
+    function PulseInputNode(n) {
+        RED.nodes.createNode(this, n);
+        var node = this;
 
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;                           // the topic is not currently used
-    this.pin = n.pin;                               // The Beaglebone Black pin identifying string
-    this.updateInterval = n.updateInterval * 1000;  // How often to send output messages
-    this.countType = n.countType;                   // Sets either 'edge' or 'pulse' counting
-    this.countUnit = n.countUnit;                   // Scaling appling to count output
-    this.countRate = n.countRate;                   // Scaling applied to rate output
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;                           // the topic is not currently used
+        this.pin = n.pin;                               // The Beaglebone Black pin identifying string
+        this._pin = adjustName(this.pin);               // Adjusted for Octal if necessary
+        this.updateInterval = n.updateInterval*1000;    // How often to send output messages
+        this.countType = n.countType;                   // Sets either 'edge' or 'pulse' counting
+        this.countUnit = n.countUnit;                   // Scaling applied to count output
+        this.countRate = n.countRate;                   // Scaling applied to rate output
 
-    // Working variables
-    this.interruptAttached = false;                 // Flag: should we detach interrupt when we are closed?
-    this.intervalId = null;                         // Remember the timer ID so we can delete it when we are closed
-    this.pulseCount = 0;                            // (Unscaled) total pulse count
-    // Hold the hrtime of the last two pulses (with ns resolution)
-    this.pulseTime = [[NaN, NaN], [NaN, NaN]];
+        // Working variables
+        this.interruptAttached = false;                 // Flag: should we detach interrupt when we are closed?
+        this.intervalId = null;                         // Remember the timer ID so we can delete it when we are closed
+        this.pulseCount = 0;                            // (Unscaled) total pulse count
+        // Hold the hrtime of the last two pulses (with ns resolution)
+        this.pulseTime = [[NaN, NaN], [NaN, NaN]];
 
-    // Define 'node' to allow us to access 'this' from within callbacks
-    var node = this;
-
-    // Called by the edge or pulse interrupt. If this is a valid interrupt, record the
-    // pulse time and count the pulse
-    var interruptCallback = function (x) {
-            if (x.value !== undefined) {
+        // Called by the edge or pulse interrupt. Record the pulse time and count the pulse
+        // Note: if x has an 'attached' field and no 'value' field, the callback is reporting
+        // the success or failure of attaching the interrupt - we must handle this
+        var interruptCallback = function (x) {
+            if (x === undefined) {
+                if (x.attached === true) {
+                    node.interruptAttached = true;
+                    node.on("input", inputCallback);
+                    node.intervalId = setInterval(timerCallback, node.updateInterval);
+                }
+                else {
+                    node.error("Failed to attach interrupt");
+                }
+            }
+            else {
                 node.pulseTime = [node.pulseTime[1], process.hrtime()];
                 node.pulseCount = node.pulseCount + 1;
             }
         };
 
-    // Called when an input message arrives. If the topic contains 'load' (case
-    // insensitive) and the payload is a valid number, set the count to that
-    // number, otherwise set it to zero
-    var inputCallback = function (msg) {
-            if (String(msg.topic).search(/load/i) < 0 || isFinite(msg.payload) == false) {
+        // Called when an input message arrives. If the topic contains 'load' (case
+        // insensitive) and the payload is a valid number, set the count to that
+        // number, otherwise set it to zero
+        var inputCallback = function (msg) {
+            if (String(msg.topic).search(/load/i) < 0 || isFinite(msg.payload) === false) {
                 node.pulseCount = 0;
-            } else {
+            }
+            else {
                 node.pulseCount = Number(msg.payload);
             }
         };
 
-    // Called by the message timer. Send two messages: the scaled pulse count on
-    // the first output and the scaled instantaneous pulse rate on the second.
-    // The instantaneous pulse rate is the reciprocal of the larger of either the
-    // time interval between the last two pulses, or the time interval since the last pulse.
-    var timerCallback = function () {
+        // Called by the message timer. Send two messages: the scaled pulse count on
+        // the first output and the scaled instantaneous pulse rate on the second.
+        // The instantaneous pulse rate is the reciprocal of the larger of either the
+        // time interval between the last two pulses, or the time interval since the last pulse.
+        var timerCallback = function () {
             var now = process.hrtime();
-            var lastTime = node.pulseTime[1][0] - node.pulseTime[0][0] + (node.pulseTime[1][1] - node.pulseTime[0][1]) / 1e9;
-            var thisTime = now[0] - node.pulseTime[1][0] + (now[1] - node.pulseTime[1][1]) / 1e9;
-            var msg = [{ topic:node.topic }, { topic:node.topic }];
-            msg[0].payload = node.countUnit * node.pulseCount;
+            var lastTime = node.pulseTime[1][0] - node.pulseTime[0][0] + (node.pulseTime[1][1] - node.pulseTime[0][1])/1e9;
+            var thisTime = now[0] - node.pulseTime[1][0] + (now[1] - node.pulseTime[1][1])/1e9;
+            var msg = [{topic: node.topic}, {topic: node.topic}];
+            msg[0].payload = node.countUnit*node.pulseCount;
             // At startup, pulseTime contains NaN's: force the rate output to 0
-            msg[1].payload = node.countRate / Math.max(thisTime, lastTime) || 0;
+            msg[1].payload = node.countRate/Math.max(thisTime, lastTime) || 0;
             node.send(msg);
         };
 
-    // If we have a valid pin, set it as an input and read the (digital) state
-    if (["P8_7", "P8_8", "P8_9", "P8_10", "P8_11", "P8_12", "P8_13", "P8_14", "P8_15",
-         "P8_16", "P8_17", "P8_18", "P8_19", "P8_26", "P9_11", "P9_12", "P9_13", "P9_14",
-         "P9_15", "P9_16", "P9_17", "P9_18", "P9_21", "P9_22", "P9_23", "P9_24", "P9_26",
-         "P9_27", "P9_30", "P9_41", "P9_42"].indexOf(node.pin) >= 0) {
-        // Don't set up interrupts & intervals until after the close event handler has been installed
-        bonescript.detachInterrupt(node.pin);
-        process.nextTick(function () {
-                bonescript.pinMode(node.pin, bonescript.INPUT);
-                bonescript.digitalRead(node.pin, function (x) {
-                        // Initialise the currentState based on the value read
-                        node.currentState = Number(x.value);
-                        // Attempt to attach an interrupt handler to the pin. If we succeed,
-                        // set the input event and interval handlers
-                        var interruptType;
-                        if (node.countType === "pulse") {
-                            // interruptType = bonescript.FALLING; <- doesn't work in v0.2.4
-                            interruptType = bonescript.RISING;
-                        } else {
-                            interruptType = bonescript.CHANGE;
-                        }
-                        if (bonescript.attachInterrupt(node.pin, true, interruptType, interruptCallback)) {
-                            node.interruptAttached = true;
-                            node.on("input", inputCallback);
-                            node.intervalId = setInterval(timerCallback, node.updateInterval);
-                        } else {
-                            node.error("Failed to attach interrupt");
-                        }
-                    });
+        // If we have a valid pin, set it as an input and read the (digital) state
+        if (gpioPins.indexOf(node.pin) >= 0) {
+            // Don't set up interrupts & intervals until after the close event handler has been installed
+            bonescript.detachInterrupt(node._pin);
+            process.nextTick(function () {
+                setPinMode(node._pin, bonescript.INPUT, function (response, pin) {
+                    if (!response) {
+                        bonescript.digitalRead(node._pin, function (err, x) {
+                            // Initialise the currentState based on the value read
+                            node.currentState = Number(x);
+                            // Attempt to attach an interrupt handler to the pin. If we succeed,
+                            // set the input event and interval handlers
+                            var interruptType;
+                            if (node.countType === "pulse") {
+                                // interruptType = bonescript.FALLING; <- doesn't work in v0.2.4
+                                interruptType = bonescript.RISING;
+                            }
+                            else {
+                                interruptType = bonescript.CHANGE;
+                            }
+                            // Attempt to attach the required interrupt handler to the pin. If we succeed,
+                            // the input event and interval handlers will be installed by interruptCallback
+                            bonescript.attachInterrupt(node._pin, interruptType, interruptCallback)
+                        });
+                    }
+                    else {
+                        node.error("Unable to set " + pin + " as input: " + response);
+                    }
+                });
             });
-    } else {
-        node.error("Unconfigured input pin");
+        }
+        else {
+            node.error("Unconfigured input pin");
+        }
     }
-}
 
-// Node constructor for bbb-discrete-out
-function DiscreteOutputNode(n) {
-    RED.nodes.createNode(this, n);
+    // Node constructor for bbb-discrete-out
+    function DiscreteOutputNode(n) {
+        RED.nodes.createNode(this, n);
+        var node = this;
 
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;                           // the topic is not currently used
-    this.pin = n.pin;                               // The Beaglebone Black pin identifying string
-    this.defaultState = Number(n.defaultState);     // What state to set up as
-    this.inverting = n.inverting;
-    this.toggle = n.toggle;
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;                           // the topic is not currently used
+        this.pin = n.pin;                               // The Beaglebone Black pin identifying string
+        this._pin = adjustName(this.pin);               // Adjusted for Octal if necessary
+        this.defaultState = Number(n.defaultState);     // What state to set up as
+        this.inverting = n.inverting;
+        this.toggle = n.toggle;
 
-    // Working variables
-    this.currentState = this.defaultState;
+        // Working variables
+        this.currentState = this.defaultState;
 
-    var node = this;
-
-    // If the input message paylod is numeric, values > 0.5 are 'true', otherwise use
-    // the truthiness of the payload. Apply the inversion flag before setting the output
-    var inputCallback = function (msg) {
+        // If the input message payload is numeric, values > 0.5 are 'true', otherwise use
+        // the truthiness of the payload. Apply the inversion flag before setting the output
+        var inputCallback = function (msg) {
             var newState;
             if (node.toggle) {
                 newState = node.currentState === 0 ? 1 : 0;
-            } else {
+            }
+            else {
                 if (isFinite(Number(msg.payload))) {
-                    newState = Number(msg.payload) > 0.5 ? true : false;
-                } else if (msg.payload) {
+                    newState = Number(msg.payload) > 0.5;
+                }
+                else if (msg.payload) {
                     newState = true;
-                } else {
+                }
+                else {
                     newState = false;
                 }
                 if (node.inverting) {
                     newState = !newState;
                 }
             }
-            bonescript.digitalWrite(node.pin, newState ? 1 : 0);
-            node.send({ topic:node.topic, payload:newState });
-            node.currentState = newState;
+            bonescript.digitalWrite(node._pin, newState ? 1 : 0, function() {
+                node.send({topic: node.topic, payload: newState});
+                node.currentState = newState;
+            });
         };
 
-    // If we have a valid pin, set it as an output and set the default state
-    if (["P8_7", "P8_8", "P8_9", "P8_10", "P8_11", "P8_12", "P8_13", "P8_14", "P8_15",
-         "P8_16", "P8_17", "P8_18", "P8_19", "P8_26", "P9_11", "P9_12", "P9_13", "P9_14",
-         "P9_15", "P9_16", "P9_17", "P9_18", "P9_21", "P9_22", "P9_23", "P9_24", "P9_26",
-         "P9_27", "P9_30", "P9_41", "P9_42", "USR0", "USR1", "USR2", "USR3"].indexOf(node.pin) >= 0) {
-        // Don't set up interrupts & intervals until after the close event handler has been installed
-        bonescript.detachInterrupt(node.pin);
-        process.nextTick(function () {
-                bonescript.pinMode(node.pin, bonescript.OUTPUT);
-                node.on("input", inputCallback);
-                setTimeout(function () { bonescript.digitalWrite(node.pin, node.defaultState); }, 50);
+        // If we have a valid pin, set it as an output and set the default state
+        if (gpioPins.concat(usrLEDs).indexOf(node.pin) >= 0) {
+            // Don't set up interrupts & intervals until after the close event handler has been installed
+            if (node._pin) { bonescript.detachInterrupt(node._pin); }
+            process.nextTick(function () {
+                setPinMode(node._pin, bonescript.OUTPUT, function (response, pin) {
+                    if (response) {
+                        node.error("Unable to set " + pin + " as output: " + response.err);
+                    }
+                    else {
+                        node.on("input", inputCallback);
+                        setTimeout(function () {
+                            bonescript.digitalWrite(node._pin, node.defaultState, function() {});
+                        }, 50);
+                    }
+                });
             });
-    } else {
-        node.error("Unconfigured output pin");
+        }
+        else {
+            node.error("Unconfigured output pin");
+        }
     }
-}
 
-// Node constructor for bbb-pulse-out
-function PulseOutputNode(n) {
-    RED.nodes.createNode(this, n);
+    // Node constructor for bbb-pulse-out
+    function PulseOutputNode(n) {
+        RED.nodes.createNode(this, n);
+        var node = this;
 
-    // Store local copies of the node configuration (as defined in the .html)
-    this.topic = n.topic;                           // the topic is not currently used
-    this.pin = n.pin;                               // The Beaglebone Black pin identifying string
-    this.pulseState = Number(n.pulseState);         // What state the pulse will be..
-    this.defaultState = this.pulseState === 1 ? 0 : 1;
-    this.retriggerable = n.retriggerable;
-    this.pulseTime = n.pulseTime * 1000;          // Pulse width in milliseconds
+        // Store local copies of the node configuration (as defined in the .html)
+        this.topic = n.topic;                           // the topic is not currently used
+        this.pin = n.pin;                               // The Beaglebone Black pin identifying string
+        this._pin = adjustName(this.pin);               // Adjusted for Octal if necessary
+        this.pulseState = Number(n.pulseState);         // What state the pulse will be..
+        this.defaultState = this.pulseState === 1 ? 0 : 1;
+        this.retriggerable = n.retriggerable;
+        this.pulseTime = n.pulseTime*1000;              // Pulse width in milliseconds
 
-    // Working variables
-    this.pulseTimer = null;                         // Non-null while a pulse is being generated
+        // Working variables
+        this.pulseTimer = null;                         // Non-null while a pulse is being generated
 
-    var node = this;
-
-    // Generate a pulse in response to an input message. If the topic includes the text
-    // 'time' (case insensitive) and the payload is numeric, use this value as the
-    // pulse time. Otherwise use the value from the properties dialog.
-    // If the resulting pulse time is < 1ms, do nothing.
-    // If the pulse mode is not retriggerable, then if no pulseTimer is active, generate
-    // a pulse. If the pulse mode is retriggerable, and a pulseTimer is active, cancel it.
-    // If no timer is active, set the pulse output. In both cases schedule a new pulse
-    // timer.
-    var inputCallback = function (msg) {
+        // Generate a pulse in response to an input message. If the topic includes the text
+        // 'time' (case insensitive) and the payload is numeric, use this value as the
+        // pulse time. Otherwise use the value from the properties dialog.
+        // If the resulting pulse time is < 1ms, do nothing.
+        // If the pulse mode is not retriggerable, then if no pulseTimer is active, generate
+        // a pulse. If the pulse mode is retriggerable, and a pulseTimer is active, cancel it.
+        // If no timer is active, set the pulse output. In both cases schedule a new pulse
+        // timer.
+        var inputCallback = function (msg) {
             var time = node.pulseTime;
             if (String(msg.topic).search(/time/i) >= 0 && isFinite(msg.payload)) {
-                time = msg.payload * 1000;
+                time = msg.payload*1000;
             }
             if (time >= 1) {
                 if (node.retriggerable === false) {
                     if (node.pulseTimer === null) {
                         node.pulseTimer = setTimeout(endPulseCallback, time);
-                        bonescript.digitalWrite(node.pin, node.pulseState);
-                        node.send({ topic:node.topic, payload:node.pulseState });
+                        bonescript.digitalWrite(node._pin, node.pulseState, function() {
+                            node.send({topic: node.topic, payload: node.pulseState});
+                        });
                     }
-                } else {
+                }
+                else {
                     if (node.pulseTimer !== null) {
                         clearTimeout(node.pulseTimer);
-                    } else {
-                        bonescript.digitalWrite(node.pin, node.pulseState);
-                        node.send({ topic:node.topic, payload:node.pulseState });
+                    }
+                    else {
+                        bonescript.digitalWrite(node._pin, node.pulseState, function() {
+                            node.send({topic: node.topic, payload: node.pulseState});
+                        });
                     }
                     node.pulseTimer = setTimeout(endPulseCallback, time);
                 }
             }
         };
 
-    // At the end of the pulse, restore the default state and set the timer to null
-    var endPulseCallback = function () {
+        // At the end of the pulse, restore the default state and set the timer to null
+        var endPulseCallback = function () {
             node.pulseTimer = null;
-            bonescript.digitalWrite(node.pin, node.defaultState);
-            node.send({ topic:node.topic, payload:node.defaultState });
+            bonescript.digitalWrite(node._pin, node.defaultState, function() {
+                node.send({topic: node.topic, payload: node.defaultState});
+            });
         };
 
-    // If we have a valid pin, set it as an output and set the default state
-    if (["P8_7", "P8_8", "P8_9", "P8_10", "P8_11", "P8_12", "P8_13", "P8_14", "P8_15",
-         "P8_16", "P8_17", "P8_18", "P8_19", "P8_26", "P9_11", "P9_12", "P9_13", "P9_14",
-         "P9_15", "P9_16", "P9_17", "P9_18", "P9_21", "P9_22", "P9_23", "P9_24", "P9_26",
-         "P9_27", "P9_30", "P9_41", "P9_42", "USR0", "USR1", "USR2", "USR3"].indexOf(node.pin) >= 0) {
-        // Don't set up interrupts & intervals until after the close event handler has been installed
-        bonescript.detachInterrupt(node.pin);
-        process.nextTick(function () {
-                bonescript.pinMode(node.pin, bonescript.OUTPUT);
-                node.on("input", inputCallback);
-                // Set the pin to the default stte once the dust settles
-                setTimeout(endPulseCallback, 50);
+        // If we have a valid pin, set it as an output and set the default state
+        if (gpioPins.concat(usrLEDs).indexOf(node.pin) >= 0) {
+            // Don't set up interrupts & intervals until after the close event handler has been installed
+            bonescript.detachInterrupt(node._pin);
+            process.nextTick(function () {
+                setPinMode(node._pin, bonescript.OUTPUT, function (response, pin) {
+                    if (!response) {
+                        node.on("input", inputCallback);
+                        // Set the pin to the default state once the dust settles
+                        setTimeout(endPulseCallback, 50);
+                    }
+                    else {
+                        node.error("Unable to set " + pin + " as output: " + response.err);
+                    }
+                });
             });
-    } else {
-        node.error("Unconfigured output pin");
+        }
+        else {
+            node.error("Unconfigured output pin");
+        }
     }
-}
 
-// Register the nodes by name. This must be called before overriding any of the Node functions.
-RED.nodes.registerType("bbb-analogue-in", AnalogueInputNode);
-RED.nodes.registerType("bbb-discrete-in", DiscreteInputNode);
-RED.nodes.registerType("bbb-pulse-in", PulseInputNode);
-RED.nodes.registerType("bbb-discrete-out", DiscreteOutputNode);
-RED.nodes.registerType("bbb-pulse-out", PulseOutputNode);
+    // Register the nodes by name. This must be called before overriding any of the Node functions.
+    RED.nodes.registerType("bbb-analogue-in", AnalogueInputNode);
+    RED.nodes.registerType("bbb-discrete-in", DiscreteInputNode);
+    RED.nodes.registerType("bbb-pulse-in", PulseInputNode);
+    RED.nodes.registerType("bbb-discrete-out", DiscreteOutputNode);
+    RED.nodes.registerType("bbb-pulse-out", PulseOutputNode);
 
-// On close, detach the interrupt (if we attached one) and clear any active timers
-DiscreteInputNode.prototype.close = function () {
-    if (this.interruptAttached) {
-        bonescript.detachInterrupt(this.pin);
-    }
-    if (this.intervalId !== null) {
-        clearInterval(this.intervalId);
-    }
-    if (this.debounceTimer !== null) {
-        clearTimeout(this.debounceTimer);
-    }
-};
-
-// On close, detach the interrupt (if we attached one) and clear the interval (if we set one)
-PulseInputNode.prototype.close = function () {
-    if (this.interruptAttached) {
-        bonescript.detachInterrupt(this.pin);
-    }
-    if (this.intervalId !== null) {
-        clearInterval(this.intervalId);
-    }
-};
-
-// On close, clear an active pulse timer
-PulseOutputNode.prototype.close = function () {
-    if (this.pulseTimer !== null) {
-        clearTimeout(this.pulseTimer);
-    }
+    // On close, detach the interrupt (if we attached one) and clear any active timers
+    DiscreteInputNode.prototype.close = function () {
+        if (this.interruptAttached) {
+            bonescript.detachInterrupt(this._pin);
+        }
+        if (this.intervalId !== null) {
+            clearInterval(this.intervalId);
+        }
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+        }
+    };
+
+    // On close, detach the interrupt (if we attached one) and clear the interval (if we set one)
+    PulseInputNode.prototype.close = function () {
+        if (this.interruptAttached) {
+            bonescript.detachInterrupt(this._pin);
+        }
+        if (this.intervalId !== null) {
+            clearInterval(this.intervalId);
+        }
+    };
+
+    // On close, clear an active pulse timer
+    PulseOutputNode.prototype.close = function () {
+        if (this.pulseTimer !== null) {
+            clearTimeout(this.pulseTimer);
+        }
+    };
 };

hardware/BBB/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2016 JS Foundation and other contributors, https://js.foundation/
+Copyright 2013-2016 IBM Corp.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

hardware/BBB/README.md

@@ -0,0 +1,101 @@
+node-red-node-beaglebone
+========================
+A set of <a href="http://nodered.org" target="_new">Node-RED</a> nodes to
+interface with the GPIO pins of a <a href="http://http://beagleboard.org/black/" target="_new">Beaglebone Black</a>.
+
+Pre-requisites
+--------------
+
+Only of use on a BeagleboneBlack board. Should ideally be running the
+<a href="http://beagleboard.org/latest-images/" target="_new"> latest Debian</a>
+images - as they have node.js v0.10.x preinstalled.
+
+Install
+-------
+
+For Debian **Jessie** with kernel 4.1 run the following command in your
+Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-beaglebone
+
+For previous versions of Debian, for example **Wheezy** - use the older version
+of this node.
+
+    npm install node-red-node-beaglebone@0.0.8
+
+Usage
+-----
+
+This package provides 5 nodes for use with the BeagleboneBlack board.
+
+### Analogue Input
+
+Reads an analogue pin when triggered by
+a message.
+
+The output message topic is the node topic: the output message value is the
+scaled analogue input or NaN if a read error occurs.
+
+
+Simple linear scaling is defined by setting the output values required for input
+values of 0 and 1. You can apply more complicated scaling, e.g. for sensor linearisation,
+by defining breakpoints at intermediate input values, with the desired output for
+each. Values between breakpoints are linearly interpolated.
+
+
+To reduce the effect of noise, enable averaging. This will read the input pin
+voltage ten times in rapid succession for each input message and output the mean value.
+
+### Digital Input
+
+Sends a message with payload 0 or 1 on the first output when the pin changes state, and logs the total time in the active state.
+
+Sends a message with a payload of the current total active time
+(in seconds) on the second output at selectable intervals. An input message with topic 'load'
+and a numeric payload will set the total active time to that value: any other input message
+will reset it to zero.
+
+The active state may be set to be high or low: this only affects the calculation
+of the active time, not the pin state value sent on the first output.
+
+The pin state messages may be generated for both directions of change, or for just 0 to 1
+or just 1 to 0 changes. This is useful to generate a single message from a button
+press. When using buttons or switches, enable debouncing to improve reliability.
+
+### Pulse Input
+
+Pulse input for the Beaglebone Black. Counts input pulses or pulse edges: outputs
+total counts and the rate of counts/sec, with scaling.
+
+Sends the total count message on the first output, and the current count
+rate message on the second output, at the chosen interval. An input message with topic 'load'
+and a numeric payload will set the total count to that value (no scaling is applied):
+any other input message will reset it to zero.
+
+### Digital Output
+
+Sets the output pin high or low depending on the payload of the input message. Numeric
+payloads > 0.5 are 'high' (1), payloads <= 0.5 are 'low' (0). Other payloads which
+evaluate to true are 'high', if not then 'low'. Selecting the Inverting checkbox will
+switch the sense of the pin output.
+
+If the Toggle state checkbox is checked, the message content is ignored: successive
+messages cause the pin to toggle between 0 and 1.
+
+The pin will be initially set to the given Startup state until the first message arrives:
+the Inverting property is not applied to this value.
+
+### Pulse Output
+
+Pulses the output pin for the set time after receiving an input message, unless the
+message has a topic including the text 'time' and a numeric payload. In this case, the
+the pulse time will be the value of the payload in seconds. If the time from either
+source is < 0.001 seconds, no pulse is generated.
+
+In retriggerable mode, a second message within the pulse period will extend the duration
+of the pulse by the time value: in non-retriggerable mode, input messages arriving during
+the duration of the pulse are ignored.
+
+The pin state of the pulse may be set to either 0 or 1: the output pin will switch
+back to the other state after the pulse time. An output message is generated each time
+the pin changes state: its payload is the new state (0 or 1).

hardware/BBB/package.json

@@ -0,0 +1,24 @@
+{
+    "name"          : "node-red-node-beaglebone",
+    "version"       : "0.1.9",
+    "description"   : "A set of Node-RED nodes to interface to the GPIO pins of a Beaglebone Black board",
+    "dependencies"  : {
+        "octalbonescript":"^1.2.2"
+    },
+    "repository" : {
+        "type":"git",
+        "url":"https://github.com/node-red/node-red-nodes.git",
+        "directory": "tree/master/hardware/BBB"
+    },
+    "license": "Apache-2.0",
+    "keywords": [ "node-red", "beagleboneblack", "beaglebone", "bbb", "octalbonescript" ],
+    "node-red"      : {
+        "nodes"     : {
+            "bbb": "145-BBB-hardware.js"
+        }
+    },
+    "contributors": [
+        {"name": "Max Hadley"},
+        {"name": "Dave Conway-Jones"}
+    ]
+}