Getting started with DCM - Cumulocity Iot Cloud
  • 07 Apr 2021
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Getting started with DCM - Cumulocity Iot Cloud

  • Dark
    Light
  • PDF

Article summary

The purpose of this article is to guide you through a Proof of Concept setup.
This setup is meant to be an easy way of getting, at first, simulated data to Cumulocity IoT and then later you can add setup for your own devices eg PLC's, HMI's etc. for data collection from those.

Prerequisites:

  1. Knowledge of SiteManager configuration. See SiteManager getting started guides.
  2. A Cumulocity IoT cloud account ( Setup a free 30 day trial here )
  3. A SiteManager with release 9.0 or higher (Latest version is recommended)
Note: From version 9.0.17 (19192) DCM requires NTP to be enabled in the SiteManager.
See more info here.
  1. Create agent with DCM enabled
    (Choose a Generic / Data Collector Module device)
    image.png

  2. Add a DCM collector name (dcmcn) for associating the Agent and the DCM collector config.
    image.png

  3. Configure the Cloud settings (here it’s the Cumulocity)

Download and unpack this zip file

cumulocity.com.cert.zip

b. Goto SiteManager GUI > DCM > Certs and add the Certificate file
image.png

c. Name the certificate entry, the name is used in the DCM config dataserver section.

  1. Go to SiteManager GUI > DCM > Edit and copy paste this example file into the window (replacing the previous content):
{
  "ConfigName": "C8YTest",
  "ConfigDescription": "Test configuration for Cumulocity",
  "CheckpointInterval": 600,
  "Collectors": [
    {
      "CollectorDescription": "SDCM Internal Simulation Server",
      "CollectorName": "TVOsim",
      "Protocol": "Simulator",
      "SamplePoints": [
        {
          "SampleDataType": "double",
          "SampleDescription": "SDCM simulation of sine curve",
          "SampleLimitAlarm": true,
          "SampleLimitDiscard": false,
          "SampleLowerLimit": -1000,
          "SampleName": "sine",
          "SampleUpperLimit": 1000,
          "SamplesSaved": 3,
          "SimulatorData": {
            "SimulatorFunction": "sine",
            "SimulatorIncValue": 100,
            "SimulatorInitValue": 1000,
            "SimulatorSampleInterval": 1
          }
        }
      ]
    }
  ],
  "DataServers": [
    {
      "DatasrvName": "secomea_c8y",
      "DatasrvProtocol": "C8Y/REST",
      "ConnectRetryMin": 2,
      "ConnectRetryMax": 10,
      "C8YParams": {
        "C8YRegisterURL": "https://SecomeaPresales.cumulocity.com",
        "RegName": "c8yreg",
        "C8YRootCAName": "cumulocityROOTCA",
        "PushInterval": 30
      }
    }
  ]
}

  1. Goto SiteManager GUI > DCM > Edit and change the following settings:
    image.png

image.png

  1. Goto SiteManager GUI > DCM > Status > Details > Subsystem Configuration > and copy the Edge ID
    image.png

  2. Go to your Cumulocity Device administration >registration and register the SiteManager Edge ID
    image.png

  3. Goto SiteManager GUI > DCM > Restart and restart the DCM.

a. When a device is registred in the cloud a second certificate will appear from Cumulocity in SiteManager GUI > DCM > Certs.

Now it's time to learn more about the DCM config file and how to set it up for your devices:

JSON config file basic structure


Was this article helpful?