Prerequisite

• Access to the Zoho IoT application
• A Physical Gateway device
  
• Edge Lite Installed (Optional - list of supported hardware)
  

Connecting a Gateway device with the Zoho IoT application

Adding a Gateway Device in the application

1. Add Using Product Gallery (Devices)
   
2. Add by Defining Your Own Device Product
   

• Select the appropriate communication protocol: MQTT or HTTPS in the Device Connectivity field. A device instance can communicate with only one of these protocols.
• Choose the correct Device Application. The gateway can either run the Zoho IoT Edge Agent or the default device application provided by the manufacturer. Selecting Zoho IoT Edge Agent enables remote Modbus configuration capabilities

Adding a Gateway Device Using Product Galley 

1. Access the End Application.
   
   
   
   
2. Select Devices > Devices in the left navigation pane.
   
   
   
   
3. Click Add Device.
   
   
   
   
4. Select Add Using Product Gallery (Devices) and click Proceed.
   
   
   
   
5. In the device gallery, browse, filter, or search for your device.
   
   
   
   
6. Click the required device product. For this example, TRB 245 is selected.
   
   
   
   
7. On the device product information page, click Import and Proceed.
   
   
   
   
8. In the Add Device form, provide the required information in the relevant fields.
   

   Example:
   

   Model Type: Create New Model (This toggle appears only if a device model already exists)
   

   Model Name: Gateway
   

   Name: MyTRB245
   

   Device Connectivity: MQTT
   

   Device Application : Edge Agent
   

   Authentication Type: Security Token with TLS
   
   
   
   

   

   Learn more about each field.
9. Click Proceed. A new gateway device will be added.
   
   
   

Adding a Gateway Device using the By Defining your own device product option

1. Access the End Application.
   
   
   
   
2. Select Devices > Devices in the left navigation pane.
   
   
   
   
3. Click Add Device.
   
   
   
   
4. Select Add by Defining Your Device Product and click Proceed.
   
   
   
   
5. In the Product Details section, provide information about the device product.
   

   Example:
   

   Name: EM 8000
   

   Device Type: Gateway
   

   Peripheral Protocols: MQTT, HTTPS
   Device Application: Custom
   
   
   
   

   

   Learn more about each field.

   Notes:
   Before filling in the details, it is highly recommended to read the Understanding Device Product document.
   This step defines a device product, not a device instance. 
   For Modbus devices, Peripheral Sensor must be selected as the device type.
6. Click Add. The device product will now be created.
   
   
   
   
7. Since a gateway device does not measure any parameters by itself, there is no need to add any datapoint, So, click Proceed.
   
   
   
   
8. In the new device form, provide the required details.
   

   Example:
   

   Model Type: Create New Model (This toggle appears only if a device model already exists)
   

   Model Name: Energy Meter
   Name: My EM8000
   

   Device Connectivity: MQTT
   

   Device Application : Custom Application
   

   Authentication Type: Security Token with TLS
   
   
   
   

   

   Learn more about each field.
9. Click Add. A new gateway device will be added to your application.
   
   
   
   

1. Click View device to open the device information page.
   
   
   
   
2. In the Onboarding Assistant tab, select Got an IoT device and click Proceed.
   
   
   

• Broker URL
• Broker port
• Client ID / Device ID
• Username
• Password / Authentication token
  

If Manufacturer Define or Custom Application was Selected:

1. The Device Registered Successfully dialog box will appear.
2. Click Download complete registration details, if you need a local copy of the listed information.
   
   
   
   
3. Click Ok.
   
   
   
   
4. In the Onboarding Assistant page, select Got an IoT device and click Proceed.
5. In the Prerequisite page, you can associate the required peripheral device, assets and locations of this gateway by clicking Manage > Assign > Select the required instance > Next > Confirm > Close the Connected peripheral form.
6. Once done or if not required, click Proceed.
   
   
   

• Broker URL
• Broker port
• Client ID / Device ID
• Username
• Password / Authentication token
  

​