This guide provides an overview of the Zoho IOT plugin for Node-RED, designed to connect and communicate with a Zoho IOT Application. These nodes allow seamless integration by handling device communication configurations.
Node Overview
Zoho IOT PUBLISH Node
The Zoho IOT node is used to connect with the created IoT Device in the Zoho IOT Application.
Zoho IOT Command Node
The Command node subscribes to the device command topic on the Zoho IOT Application, allowing your Node-RED flow to receive command data from your IoT devices.
Zoho IOT Command ACK Node
The Command ACK node publish the the acknowledgement message to the IOT device for the given Command execution.
Installation
To install the Zoho IoT plugin in Node-RED, follow these steps:
Open Node-RED: Launch your Node-RED instance in a browser.
Navigate to Manage Palette:
Install the Zoho IoT Plugin:
Go to the "Install" tab in the Manage Palette window.
In the search bar, type "zoho-iot".
Locate "node-red-contrib-zoho-iot" in the search results.
Click the "Install" button next to the plugin.
4.Verify Installation: Once installed, you should see the Zoho IoT nodes in the left sidebar under the nodes section.
Detailed Node Descriptions
Zoho IOT Device instance Configuration Node
Credential File: Device Credential File downloaded from Device Connection details page
Connection Type:Device Connection type in Zoho IOT Application\
1.Security Token With TLS
2.Client Certificate With TLS
3.Security Token Without TLS
SECURITY TOKEN WITH TLS:
-Credential File
-Root CA File
CLIENT CERTIFICATE WITH TLS:
-Credential File
-Root CA File
-Client Certificate File
-Private Key File
SECURITY TOKEN WITHOUT TLS:
Nodes Usage
Prerequisites:
Zoho IOT Application
- Device Instance in Zoho IOT
If you are new to Zoho IOT Application, please refer to this link below for creating your first Zoho IOT Application,
Once You got your Zoho IOT Application ready, start creating your First Device to connect with your node-red to publish your data to Zoho IOT. You can also create a device using Direct API Endpoint to onboard node-red application as a Virtual Device.
- Zoho IOT Device Credential File & Root CA File
You can download your device credential and Root CA File from the Device Page under the Connection Details Tab.
- Client Certificate File and Private Key File (For Client Certificate TLS)
If you created a Device with Authentication type of (Client Certificate with TLS), you can create your new certificate or associate the existing one. Where you are prompted to download the Client Certificate and Private Key File. While Creating a new certificate, you can choose your policy type, Once you created your Certificate, you are prompted to download all the necessary files for the connection, which cannot be retrieved later.
Setting Up Device Instance Configuration
Drag the Zoho IoT node onto your workspace, add a new Device Instance with the credential file, Root CA File downloaded from Zoho IOT Device Page, along with the required Connection type, to Publish the data, and to receive and acknowledge the commands.
Publishing the Data to Zoho IOT(ZOHO IOT PUBLISH NODE)
Once the Device Instance is added, we can use the device instance to publish the data to Zoho IOT. The Zoho IOT Node has the Single Input pin to inject our data, which is further published to your configured Zoho IOT Device Instance. Zoho IOT Node only accepts the JSON format Data.
Subscribing Commands From Zoho IOT Device (ZOHO IOT COMMAND NODE)
Zoho IOT Command Node, used to subscribe to the Command Topic of the selected device instance and pass it to the next node in the flow. When the command node receives the message from the Zoho IOT Device, it will automatically Acknowledge the Device with the "Command Received" Message.
Command Acknowledgement to Zoho IOT Device(ZOHO IOT COMMAND ACK NODE)
Zoho IOT Command ACK Node, used to publish the command acknowledgement to the received command from the Zoho IOT Device. We can choose the acknowledgement type from the drop down list, it will automatically map with the Command ACK Code to acknowledge the Device.