Page 1
Technical Information ® SMA CLUSTER CONTROLLER Modbus Interface ClusterController_Modbus-TI-en-18 | Version 1.8 ENGLISH...
Page 2
SMA Solar Technology AG Legal Provisions The information contained in these documents is the property of SMA Solar Technology AG. Any publication, whether in whole or in part, requires prior written approval by SMA Solar Technology AG. Internal reproduction used solely for the purpose of product evaluation or other proper use is allowed and does not require prior approval.
3.5.4 Address Range for Modbus Register ..............13 3.5.5 Data Transmission ....................13 3.6 Reading and Writing of Data ................14 3.7 SMA Data Types and NaN Values ..............15 3.8 SMA Data Formats ....................15 Commissioning and Configuration ............17 4.1 Commissioning Steps and Requirements ..............
Page 4
Troubleshooting ..................33 Technical Data ..................34 8.1 Supported SMA Inverters ..................34 8.2 Number of SMA Devices ..................34 8.3 Modbus Communication Ports................34 8.4 Data Processing and Time Behavior ..............35 8.5 Number Codes of the Time Zones ................ 36 8.6 Frequently Used Number Codes (ENUM) ............
1 Information on this Document Validity This document is applicable for device type "CLCON-10" and device type "CLCON-S-10"* (SMA Cluster Controller). It describes the Modbus interface of the SMA Cluster Controller, the variant of the "Modbus ® Application Protocol" implemented by SMA, and the corresponding pa- rameters, measured values and data exchange formats.
Page 6
SMA fieldbus Hardware interface for communication be- tween SMA devices (e.g. Speedwire). For information on the supported communication interfaces, refer to the datasheet of the SMA device being used. SUSy ID SMA update system ID Numeric value that identifies a specific SMA device type, e.g.
• Device parameters must not be changed cyclically. Contact the SMA Service Line if you would like to automate the remote control of your PV system (see Section 9 "Contact", page 39).
Safety SMA Solar Technology AG 2.4 Information on Data Security Data security in Ethernet networks You can connect the Cluster Controller to the Internet. When connecting to the Internet, there is a risk that unauthorized users can access and manipulate the data of your PV sys- tem.
SMA Modbus profile and these can be addressed via unit IDs (see Section 3.5 "Addressing and Data Transmission in the Modbus Protocol", page 12). To enable access to data of an SMA device, a special gateway is required and this is provided by way of the Cluster Controller.
Page 10
Product Description SMA Solar Technology AG Example 1: PV System Topology from the Perspective of the SMA Devices Line Explanation IP network connection between SCADA system and Cluster Controller (PV system router) SMA fieldbus Logical assignment of SMA device to unit ID...
Page 11
SMA Solar Technology AG Product Description Example 2: PV System Topology from the Perspective of the Modbus Protocol In the following example, an inverter is assigned to a unit ID between 3 and 247 in each case. This way the inverter data can be addressed in the Modbus protocol. Unit ID 1 represents the gateway to the Modbus protocol and unit ID 2, the PV system parameters.
3.5.1 Unit IDs The Unit ID is a superordinate addressing type in the Modbus protocol. The SMA Modbus protocol has 247 unit IDs, of which, 245 can be assigned to individual devices. If a unit ID is assigned to a device, then the parameters and measured values of this device can be accessed.
In the assignment table "SMA devices (unit ID = 3 to 247)", the parameters and measured values intended for all SMA devices are stored. The individual SMA devices use a subset of these for their device-specific parameters and measured values. Information on firmware versions and device- specific Modbus registers of SMA products can be found on our product pages or Modbus page at www.SMA-Solar.com.
To prevent inconsistencies, data blocks of associated registers or register ranges must be read or written consecutively. The 4 bytes of a 64-bit Modbus register must, for example, be read with an operation in a 64-bit SMA data type. Error message on writing multiple Modbus registers as a data block...
3.7 SMA Data Types and NaN Values The following table shows the data types used in the SMA Modbus profile and compares these to possible NaN values. The SMA data types are listed in the assignment tables in the Type column.
Page 16
Product Description SMA Solar Technology AG FIX2 Decimal number, commercially rounded, two decimal places. FIX3 Decimal number, commercially rounded, three decimal places. Firmware version (see "Firmware version extract" below) 4-byte IP address (IPv4) of the form XXX.XXX.XXX.XXX. Text or number. A RAW number has no decimal places and no thousand or other separation indicators.
4.2 Information on Changing Unit IDs You can change the unit IDs of SMA devices. A change is required, for example, if additional or changed SMA devices are connected to the Cluster Controller after activation of the Modbus servers. By way of the automatic detection of the PV system, additional or changed devices are assigned the Modbus unit ID = 255 (NaN).
4.3 Changing Unit IDs via the Gateway 4.3.1 Reading Out the Gateway You can read out the individual unit IDs of the SMA devices from the gateway, for example, using a SCADA system. Accessing the gateway You access the gateway via the IP address of the Cluster Controller, under the unit ID = 1.
SMA Solar Technology AG Commissioning and Configuration 4.3.2 Changing A Unit ID in the Gateway You change a unit ID by writing it to the relevant Modbus address. All three of the Modbus regis- ters that belong to a device-unit-ID assignment must be transmitted in a single data block, although only the register with the unit ID is writable.
This file contains an excerpt of the gateway (see Section 5.2 "Gateway (Unit ID = 1)", page 24). If new SMA devices are added or if SMA devices are replaced, these are respec- tively added to the available XML structure of this file with unit ID = 255 by the Cluster Controller.
Unit ID of the device Example of the file usrplant.xml The unit IDs of the following two SMA devices are to be changed to unit ID 3 and 4: • SB 5000 TL-21, SUSy ID = 138, Serial number = 2178909920, current position in gateway = 7 •...
4.5 Resetting the Cluster Controller to the Default Settings By resetting the Cluster Controller to the default settings, the previously assigned unit IDs are delet- ed and reassigned – file sysplant.xml is therefore rewritten. As a result, all connected SMA de- vices are assigned a new unit ID.
Number of assigned Modbus registers. Type Data type, e.g. V32 = 32 bits without prefix (see Section 3.7 "SMA Data Types and NaN Values", page 15). Format Data format of saved value, e.g. DT = date, FIX n = output with n decimal places, TEMP = output as temperature (see Section 3.8 "SMA Data For-...
In the following table you can find the parameters and measured values provided by the gateway, which you can access under unit ID = 1as well as the assignment of the SMA devices to the unit IDs. You can access the gateway via the IP address of the Cluster Controller:...
Page 25
2083 = DI7 DI8 2075 = DI5 DI7 2084 = DI8 40001 Set UTC system time, in s Unit ID assignment – SMA devices: 42109 Device 1: SUSy ID 42110 Device 1: Serial number 42112 Device 1: Unit ID (e.g. 3)
Modbus exception on accessing empty assignments If, in the address range 42109 to 43088, individual Modbus registers or a data block are accessed which do not contain any assignment of unit IDs to SMA devices, a Modbus ex- ception is generated.
Page 27
SMA Solar Technology AG SMA Modbus Profile—Assignment Tables Specification Modbus Electric utility company Active power setpoint in %s 31241 FIX2 Specification Modbus Direct marketing Resulting setpoint in % 31243 FIX2 (minimum value definition of all specifications) Current utility grid export active power P in W (actual...
Page 28
SMA Modbus Profile—Assignment Tables SMA Solar Technology AG 34641 Analog current input 3 (mA) FIX2 34643 Analog current input 4 (mA) FIX2 34645 Analog voltage input 1 (V) FIX2 34647 Analog voltage input 2 (V) FIX2 34649 Analog voltage input 3 (V)
Page 29
SMA Solar Technology AG SMA Modbus Profile—Assignment Tables Direct marketer: Active power setpoint P, in % of the maximum active power (PMAX) of the PV plant. 40493 Value range: FIX2 -100.00% to < 0% = Load = No active power <...
SMA Solar Technology AG 6 User-Defined Modbus Profile With the user-defined Modbus profile, the Modbus addresses that are available in the SMA Mod- bus profile for the individual unit IDs can be assigned to different Modbus addresses. You can use the entire Modbus address range from 0 to 65535.
The Modbus registers for apparent power, active power and reactive power of the devices stored under unit IDs 3 and 4 are to be retrievable in a user-defined Modbus profile from address 0 at consecutive Modbus addresses (the following table is an excerpt from the SMA Modbus profile): Description/number code(s)
Modbus profile as described below. If the usage of the user-defined Modbus profile on the Cluster Controller is deactivated, the user- defined assignments are lost and only the SMA Modbus profile remains active. Uploading and downloading XML files For more information on uploading and downloading XML files via the user interface, see the SMA Cluster Controller user manual.
Troubleshooting 7 Troubleshooting You can find information on error analysis of the SMA Modbus profile in Section 3.6 "Reading and Writing of Data", page 14. For troubleshooting of the SMA devices, go to Modbus address 30197 and use the event numbers displayed here.
Speedwire/Webconnect interface can be found on the product page of the re- spective inverter at www.SMA-Solar.com. 8.2 Number of SMA Devices The following table contains details on the maximum number of SMA devices that can be operated with the Cluster Controller. Device type...
• Device parameters must not be changed cyclically. Contact the SMA Service Line if you would like to automate the remote control of your PV system (see Section 9 "Contact", page 39).
8.5 Number Codes of the Time Zones The following table contains the most important time zones and their number codes in the SMA Modbus profile. If the location is known, you can determine the numerical key (code) and the time zone.
Page 37
SMA Solar Technology AG Technical Data Montevideo 9588 UTC-03:00 Moscow, St. Petersburg, Volgograd 9561 UTC+03:00 Nairobi 9524 UTC+03:00 Newfoundland 9554 UTC-03:30 New York, Miami, Atlanta, Detroit, 9528 UTC-05:00 Toronto Novosibirsk 9550 UTC+06:00 Nuku'alofa 9572 UTC+13:00 Osaka, Sapporo, Tokyo 9571 UTC+09:00 Pacific (U.S., Canada)
8.6 Frequently Used Number Codes (ENUM) The following table contains number codes which, as function coding in data format ENUM, are frequently used in the SMA Modbus profile. Event Numbers The event numbers displayed by the inverters under the Modbus address 30197 are device- specific.
SMA Solar Technology AG Contact 9 Contact If you have technical problems with our products, please contact the SMA Service Line. We require the following information in order to provide you with the necessary assistance: • Modbus master software or hardware used •...
Page 40
SMA France S.A.S. Ελλάδα SMA Service Partner Lyon Κύπρος AKTOR FM. +33 472 22 97 00 Αθήνα SMA Online Service Center : +30 210 8184550 www.SMA-Service.com SMA Online Service Center www.SMA-Service.com España SMA Ibérica Tecnología Solar, United SMA Solar UK Ltd.
Page 41
SMA Solar Technology AG Contact South Africa SMA Solar Technology Argentina SMA South America SPA South Africa Pty Ltd. Brasil Santiago de Chile Cape Town Chile +562 2820 2101 08600SUNNY Perú (08600 78669) International: +27 (0)21 826 0600 SMA Online Service Center www.SMA-Service.com...
Need help?
Do you have a question about the CLCON-10 and is the answer not in the manual?
Questions and answers