Support for Third-Party Device in OCS360 Platform
Add Device
Perform the following steps to add a new device in OCS360 platform.
For troubleshooting assistance, see Quick Guide for Troubleshooting
- Navigate to Entities > Devices to open the Devices screen.
- Click the + (plus) sign located in the top, right corner of the Devices screen to open the Add new device popup box.
- Enter the following information in the Add new device popup box:
- In the Name field, enter the device name.
- In the MAC Address field, enter the unique MAC ID of the device LAN1 port.
- Select the Confirm MAC address box.
- Review all fields and then click Add.
Communication Mode
Select a communication mode for the device being added.
| Plan(s) | Default State |
|---|---|
| Telemetry Only |
By default “Telemetry only” is selected and the options for OCS360 Remotewill be disabled. - Selecting Telemetry only will disable the OCS360 Remote option for the device. |
| OCS360 Remote Only |
By default “OCS360 Remote only” is selected by default and the other options for telemetry are disabled. - Selecting OCS360 Remote only will disable the telemetry data push for the device. |
| Both Telemetry and OCS360 Remote |
Can choose the communication mode for the device being added. - Selecting Telemetry and OCS360 Remote will enable a telemetry data push and OCS360 Remote for the device. |
The MAC ID of the device becomes available to the Cscape user following the connection of the device; see %SR35-36.
Note: The MAC ID is also available in the System Menu > Set Networks > LAN of the device.
Image: Canvas LAN Settings
Image: Prime LAN Settings
-
After the device is connected to the OCS360 platform, confirm that the state changed to Active status on the Devices screen.
- Download the program to the device with the OCS360 configuration to begin publishing data to the OCS360 platform.
- Verify that data has been published to the device from the Latest Telemetry section at Devices > Device Details > Latest Telemetry.
-
From CS10.1SP1 and Prime/CANVAS Firmware 17:20, the same OCS device can be added in different OCS360 tenant admin accounts. The device will be ACTIVE in any of the accounts. The user must provide the account ID associated with the account in the program downloaded to the OCS device.
- In OCS360, the account ID is available under Account > Profile section.
- In the Cscape OCS360 configuration dialog, the user must provide the account ID of the tenant account to which device should be connected. The user can manually enter the account ID, or if the user is logged into Cscape then click on “Get Account ID from server” to fetch the account ID. Confirm that the user logged into Cscape has a valid OCS360 account (a valid OCS360 account is required), and Internet connectivity is functional to fetch the account ID, otherwise there will be an error.
- The Account ID option is not supported in Cscape versions older than CS10.1SP1 and Prime/CANVAS Firmware older than 17:20. For user using older Cscape and Firmware versions, the OCS device still connects to the platform without any issues if the device is added only under any one tenant account.
- In case, if the device is added under multiple accounts and the device is running with Firmware version older than 17:20, then device will get connected to the account in which it was connected lastly. To change the device connectivity to other account, clear the certificates in the device by making high %SR362.4 and power cycle the device.
- In OCS360, the account ID is available under Account > Profile section.
Deactivate Device
In the event of device failure or if the user decides to change the device to one with another MAC ID, deactivating the existing device is required.
Note: The Reactivate icon activates when a device is deactivated.
-
From the Devices tab, select the Deactivate Icon.
Reactivate Device
Reactivate a deactivated device with the same or a different MAC-ID. Reactivate icon get enabled if the device is deactivated.
Note: The Reactivate icon activates when a device is deactivated.
-
From the Devices tab, select the Reactivate icon.
Support for Third-Party Device in OCS360 Platform
The OCS360 platform supports adding third-party devices other than OCS controllers to the platform. Currently, third-party devices can be added by providing the unique IMEI number available in the device.
The third party device must be capable enough to fetch the certificates from OCS360 platform and topics to publish or subscribe telemetry data should support as per the OCS360 platform standards.