Summary

We will go through the steps to set up a ROC device in the Cloud once it’s physically installed.

Step 1: Configure ROC Parameters

ROC Parameters need to be located in ROCLINK Software or extracted

  • Controller Unit ID = Source = ROC ID (Example: 172)

  • Controller Group ID = Source = ROC GROUP (Example: 2) 

NOTE: If you cannot determine the correct controller details, you may set Controller ID to 240 and Group ID to 240 if you are directly connected to a single ROC device. Any device connected will respond when these IDs are used. Once the correct details are obtained be sure to update the 3rd Party Device settings.

Host Unit ID and Group ID are the parameters used by the IG itself and can be any number 1-240 defined by user. These should not be the same as any other ROC devices connected to the IG.

  • HOST Unit ID = Destination = IG21 ID (Example: 3)

  • HOST GROUP ID = Destination = IG21 ID (Example: 1)

ROC_diagram.png

Finding the ROC Controller ID and Group ID

If you have ROCLINK 800 software, please follow these steps to find device parameters:

  1. Connect ROC device to PC using ROCLINK Software (Direct Connect)

  2. Navigate to System > Opcode Table > #1

  3. Navigate to Point Type = System Variables > Logical Number = SYS 1

  4. Make sure the “Show Current Value” box is checked

  5. Select “0 – Device Address” and note the current value as the Device ID

  6. Select “1 – Device Group” and note the current value as the Device Group 

If you do not have ROCLINK software, please follow these steps:

  1. Confirm ROC device LOI port is wired to the IG21

  2. Set Device Address to 240

  3. Set Device Group to 240

  4. Add TLP 15,0,0 – This will report the Device Address

  5. Add TLP 15,0,1 – This will report the Device Group

  6. Update Device Address, and Device Group to reported values 

Step 2: Add the Device in the Cloud

  1. In the Samsara Cloud, navigate to 3rd Party Devices and select “Add New Device

  2. Fill in the required fields (Use Step 1 to fill in Controller and Host information)

  3. Create Device 

Step 3: Create TLPs

(NOTE: TLP = point Type, Logical Number, Parameter, this is the name given to datapoints within the ROC device)

  1. Create a new register in the 3rd party device

  2. Remember TLP, these are found in the OpCode Table in the ROCLINK800 Software

  3. Fill in required fields to create registers (12,0,0 is the internal clock’s seconds counter)

  4. Create accompanying Data inputs so we can monitor the register values

Troubleshooting

  1. Data Inputs are reporting “0.0” – if data is reporting 0 then we likely missed a parameter. Everything must be correctly correlated for connection to work. Go back and double-check these items:

    • Controller ID, Controller Group – Set these to 240 and 240 temporarily and see if data starts streaming

    • Rx,Tx pins – try swapping these wires

    • Confirm in ROCLINK Software that ports are enabled and available – COMM2 port is optional in many devices which is why this manual uses the LOI port

  2. My data is streaming but it is wrong – if data is wrong, it is likely that the data type is incorrect. Use these steps to confirm data type: 

    • Navigate to OpCode table in ROCLINK Software

    • Select the TLP of choice

    • Confirm the reported data type is what you have in the register