Overview

If you’re new to Node-RED but have not yet worked through the Hello, world! example, please do so now.

In this section, we’ll add a groov Read node, configure the groov project and address, and run the flow.

Step 1 - Add a groov Read Node

  1. Drag out an Inject node, a groov Read node, and a Debug node.
  2. Wire them together, as shown below.
Static Image
Click the image to start and stop the animation.

Step 2 - Configure the groov Data Store and Project

The groov nodes have two items that must be configured: one is for the groov project and the other is for the Data Store device. They only need to be configured once, and are then shared between the read and write nodes.

Configure the Project

To configure a groov project in Node-RED, we need to click through a Read or Write node and the Data Store configuration view.

To get to the project configuration view:

  1. Double-click on the groov Read node to open the “Edit groov read node” view.
  2. Click the pencil icon next to Data Store to open the “Add new groov-data-store config node” view.
  3. Click the pencil icon next to Groov Project to open the “Add new groov-project config node” view.

To configure the groov project:

  1. For the Groov Address fields, enter the hostname or IP address of the controller.
    • If using Node-RED and groov on the same device (such as a GROOV-AR1), then enter “localhost” for the address.
    • Do not include HTTPS:// as a part of the address.
  2. For the API Key field, enter a valid API key from the groov project.
  3. Configure the SSL Certificates fields.

    If groov and Node-RED are on different devices, then you must configure Node-RED to use groov’s public key SSL certificate.

    • If using a self-signed certificate, then enter the certificate’s filename or full path in the “CA or Self-Signed” field.
      • If using a GROOV-AR1, just enter the filename of a certificate you uploaded using Node-RED Admin.
      • If using Node-RED on a computer, enter the path and filename of a certificate on the same computer.
    • If using a CA-signed certificate, then enter the CA’s certificate’s filename or full path in the “CA or Self-Signed” field and groov’s public key in the “Public Key” field.
      • If using a GROOV-AR1, just enter the filenames of the certificates you uploaded using Node-RED Admin.
      • If using Node-RED on a computer, enter the path and filenames of the certificates on the same computer.
  4. Click Add to return to the “Add new groov-data-store config node” view.

Configure the groov project in Node-RED

To configure the Data Store:

  1. In the Data Store Name field, enter the exact name of a Data Store from the groov project.
  2. Click Done to return to the “Edit groov read node” view.

Configure the groov project in Node-RED

To configure the Read node:

  1. For the Tag Name field, enter a valid Data Store tag name from the groov project.
  2. Click Done.

Configure the groov project in Node-RED

Step 3 - Deploy and Run

  1. Click Deploy.
  2. Make sure the Debug tab is viewable in the right-hand sidebar.
  3. Click the Inject node’s button.
  4. The Debug tab should show a new message with the current value of the Data Store tag.

Deploy and run

If that worked for you, then your Node-RED installation is successfully communicating with your groov project!

Next Step

Continue on to reading Data Store tags.