Integrating a Third-Party Device Types

Scenario: You want to integrate a third party device with the management platform.

 

Reference: For background information, see the reference section.

 

Workflow diagram:

 

 

Prerequisites:

  • The powermanager extension and associated extensions are installed and configured in the project.
    For step by step instructions cover the full installation of powermanager extension using post-installation steps and a preconfigured backup project, please refer to the Powermanager Quick Installation Guide .pdf file available at the path
    …\InstallFiles\Upgrades\EP\EM\Powermanager\AddSW\PowerManagerInstallation.
    NOTE: The instructions are applicable only for V4.2 as there are planned improvements and automations for future versions.
  • You have logged into the Desigo CC Client and have configured a user group and assigned Scope rights and application rights to the user group for working with the powermanager extension. (See Assign Scope to a User Group in Security)
  • You have created a Modbus driver, a Modbus network and started them.
  • You have associated the Modbus driver with the Modbus network. (See Modbus)
  • You have created the application for Web services and D3 Visualization in the SMC and their respective URLs are available.
  • System Manager is in Engineering mode.
  • In System Browser, Application View is selected.
  • You have configured and saved the JSON file consisting of the device type configuration of the third party device type.

 

Steps:

1 – Create Third Party Device Type
  1. Select Applications > Powermanager.
  • The System tab displays.
  1. Select the Third Party Device Type expander and proceed as follows:
    a. Enter the library name in the Library Name field.
    b. Click Browse to select the JSON file.
    c. In the Open dialog box displays, select the required JSON file from the location and click Open.
    d. Click Create Device.
  • The third party device type is created.

 

2 – Create an Area
  1. Select Applications > Powermanager.
  1. Click the System tab.
  1. Click Create and select Create area.
  1. In the New object dialog box, enter a name and description for the area.
  1. Click OK.
  • The area is created, displays in System Browser under the Powermanager root node and is selected by default.

 

3 – (Optional) Create a Sector
  1. Select Applications > Powermanager > [area].
  1. Click the Area tab.
  1. Click Create and select Create Sector.
  1. In the New object dialog box, enter a name and description.
  1. Click OK.
  • The sector is created and selected by default.

 

4 – Create, Configure, and Save a Third-Party Device

You can create a new third party device in an area or within a sector that you have created. Alternatively, you can copy an existing device.

  1. Select Applications > Powermanager > [area] OR [sector].
  1. Click the Area/Sector tab.
  1. Click Create and select Create Device.
  • A list of device groups display in a tabular format. By default, Power Devices is selected.
  1. Select the Third Party Devices tab.
  • The list of available third party device types is displayed.
  1. Configure the parameters for the device by entering information in the expanders in the Area tab.
  1. Click Save .
  • The Save Object As dialog box displays.
  1. Enter a name and description for the device. Do not use the characters “ / ” or “ \ ” in the device name.
  • The device is created and configured and is added to the System Browser under the selected area or sector.
  1. Navigate back to Applications > Powermanager.
  • The System tab displays.
  1. Configure the following expanders in the System tab, if required:
  • Favorites
  • Poll Groups
  • Synchronization
  • Tariff
  1. Click Save .
  • The third party device configuration is complete.

As a next step, you need to establish the communication between the management platform and devices.