DOCA0172EN-10

Custom Models for Downstream Modbus Devices (Universal and Advanced Models)

Presentation

The Panel Server supports the use of custom models for downstream Modbus devices. A custom model can be created to manage a Modbus device that is not natively managed by the Panel Server built-in models or when a different model than the built-in one is desired.

Custom models are only dedicated to support EcoStruxure Asset AdvisorEcoStruxure Resource Advisor, and EcoStruxure Energy Hub applications and Panel Server Advanced energy server functions. On other applications, custom models can be used, but only allow the visualization of device data on the monitoring screen.

Availability

This function is available on Panel Server Universal and Advanced.

Setting the Parameters

Custom models are available on the EcoStruxure Panel Server webpages.

Use of Custom Device Model

On the Panel Server webpages:

  • To import and manage custom device models in the Panel Server, select Settings > Modbus Devices > Custom models then:

    • Click Import.

    • Select a custom device model stored locally in a zip file.

      NOTE: Before performing this import, create the custom model by using EcoStruxure Power Commission web portal and export it to a zip file.

      The custom device model must contain the following facets:

      • modelingInformation

      • productIdentification

      • measure

      • modbusMapping

      • modbusDataModel

      An error message is displayed in the webpages if the custom device model does not follow these rules.

      The custom units in the custom device model must comply with the following syntax rules:

      • Maximum number of characters: 16

      • Use only characters from the following table.

      Characters Description

      Alphanumeric characters

      • All upper case letters from A to Z
      • All lower case letters form a to z
      • All numbers from 0 to 9

      /

      forward slash

      *

      star (multiply)

      -

      minus

      +

      plus

      %

      percent

      (

      left parenthesis

      )

      right parenthesis

      .

      point

      Ω

      omega (ohm)

      μ

      mu (micro)

      ‘space’

      the space character

      °

      degrees, for example °C

      superscript characters

      • All numbers from 0 to 9
      • Plus and minus characters

  • When the custom model is successfully imported, it is listed in the custom models table with the following information:

    • custom model name

    • version

    • number of associated devices (updated when commissioning new Modbus devices)

  • You can delete a previously imported custom model only if no devices are associated with it.

  • You can export a custom model to a ZIP file.

  • To manually add a Modbus Serial device applying a custom device model from the drop-down list, select Settings > Modbus Devices > Modbus Addition > Modbus Serial > Manual Addition then:

    • Type the value for Physical server ID.

    • Select the custom device model name in Device.

  • To manually add a Modbus TCP/IP device applying a custom device model from the drop-down list, select Settings > Modbus Devices > Modbus Addition > Modbus TCP/IP > Manual Addition then:

    • Type the value for Physical Server ID.

    • Select the custom device model name in Device.

Supported Functions

Modbus functions are described in the appendix:

QR code for this page

Was this helpful?