SMA CLCON-10,CLCON-S-10 Technical Information
Technical Information
SMA CLUSTER CONTROLLER Modbus® Interface
ClusterController_Modbus-TI-en-18 | Version 1.8 ENGLISH
Legal Provisions 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.
Trademarks
All trademarks are recognized, even if not explicitly identified as such. Missing designations do not
mean that a product or brand is not a registered trademark.
Modbus® is a registered trademark of Schneider Electric and is licensed by the Modbus Organization, Inc.
SMA SOLAR TECHNOLOGY AG
Sonnenallee 1
34266 Niestetal
Germany
Tel. +49 561 9522-0
Fax +49 561 9522-100
www.SMA.de
E-Mail: info@SMA.de
Copyright © 2017 SMA Solar Technology AG. All rights reserved.
2 ClusterController_Modbus-TI-en-18 Technical Information
SMA Solar Technology AG Table of Contents
Table of Contents
1 Information on this Document ................................................................. 5
2 Safety .......................................................................................................... 7
2.1 Intended Use ............................................................................................................... 7
2.2 Skills of Qualified Persons ......................................................................................... 7
2.3 Safety Information ...................................................................................................... 7
2.4 Information on Data Security .................................................................................... 8
3 Product Description ................................................................................... 9
3.1 Modbus Protocol ........................................................................................................ 9
3.2 SMA Modbus Profile ................................................................................................. 9
3.3 User-Defined Modbus Profile .................................................................................... 9
3.4 PV System Topology................................................................................................... 9
3.5 Addressing and Data Transmission in the Modbus Protocol ............................. 12
3.5.1 Unit IDs ................................................................................................................. 12
3.5.2 Assignment of the Modbus Register to Unit IDs ................................................. 13
3.5.3 Modbus Register Address, Register Width and Data Block ............................. 13
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
4 Commissioning and Configuration .......................................................17
4.1 Commissioning Steps and Requirements .............................................................. 17
4.2 Information on Changing Unit IDs ........................................................................ 17
4.3 Changing Unit IDs via the Gateway ..................................................................... 18
4.3.1 Reading Out the Gateway .................................................................................. 18
4.3.2 Changing A Unit ID in the Gateway .................................................................. 19
4.4 Changing Unit IDs via the XML File usrplant.xml ................................................ 20
4.4.1 Overview .............................................................................................................. 20
4.4.2 Structure of the XML File usrplant.xml ................................................................. 20
4.4.3 Activating and Deactivating usrplant.xml ........................................................... 21
Technical Information ClusterController_Modbus-TI-en-18 3
Table of Contents SMA Solar Technology AG
4.5 Resetting the Cluster Controller to the Default Settings ...................................... 22
5 SMA Modbus Profile—Assignment Tables ...........................................23
5.1 Information on the Assignment Tables .................................................................. 23
5.2 Gateway (Unit ID = 1) ........................................................................................... 24
5.3 System Parameters (Unit ID = 2) ........................................................................... 26
6 User-Defined Modbus Profile ................................................................30
6.1 Structure of the XML File for the User-Defined Modbus Profile ......................... 30
6.2 Example of a User-Defined Modbus Profile ........................................................ 31
6.3 Activating and Deactivating User-Defined Modbus Profile ............................... 32
7 Troubleshooting .......................................................................................33
8 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) .......................................................... 38
9 Contact ......................................................................................................39
4 ClusterController_Modbus-TI-en-18 Technical Information
SMA Solar Technology AG Information on this Document
Icon
Explanation
Indicates a hazardous situation that, if not avoided, will result in
death or serious injury.
Indicates a hazardous situation that, if not avoided, can result in
death or serious injury.
Indicates a hazardous situation that, if not avoided, can result in
minor or moderate injury.
Indicates a situation that, if not avoided, can result in property damage.
Information that is important for a specific topic or goal, but is not
safety-relevant.
◻
Indicates a requirement for meeting a specific goal.
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 parameters, measured values and data exchange formats.
* Not available in all countries (see the SMA Cluster Controller product page at
www.SMA-Solar.com)
This document does not contain any information on software which can communicate with the
Modbus interface (see the software manufacturer's manual).
Target Group
This document is intended for qualified persons. Only persons with appropriate skills are allowed to
perform the tasks described in this document (see Section 2.2 "Skills of Qualified Persons", page 7)
Symbols
Technical Information ClusterController_Modbus-TI-en-18 5
Information on this Document SMA Solar Technology AG
Typography
Application
Example
bold
• Elements to be selected
• Elements on a user interface
• File names
• Parameters
• Select Settings.
• Control via communication.
• The file usrprofile.xml
• The values Major and Minor
Complete designation
Designation in this document
Modbus register
Register
Photovoltaic system
PV system
SMA Cluster Controller
Cluster Controller
Abbreviation
Designation
Explanation
GFDI
Ground-Fault Detection and
Interruption
Detection of the grounding error and subsequent interruption of the electric circuit.
PMAX
Set active power limit
The device can generate active power up to
this limit.
Power Balancer
-
The Power Balancer is a function in
Sunny Mini Central devices for controlling
three-phase grid feed-in, for example, to avoid
unbalanced loads.
SMA fieldbus
-
Hardware interface for communication between 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.
128 = STP nn000TL-10.
Typographies
Nomenclature
Abbreviations
6 ClusterController_Modbus-TI-en-18 Technical Information
SMA Solar Technology AG Safety
Damage to SMA inverters
The parameters of the SMA inverters that can be changed with writable Modbus registers (RW)
are intended for long-term storage of device settings. Cyclical changing of these parameters leads
to destruction of the flash memory of the devices.
• 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).
2 Safety
2.1 Intended Use
The Modbus interface of the SMA Cluster Controller is designed for industrial use and has the
following tasks:
• Remote control of the grid management services of a PV system.
• Remote-controlled querying of the measured values of a PV system.
• Remote-controlled changing of the parameters of a PV system.
The Modbus interface can be used via the protocol Modbus TCP and
by the protocol Modbus UDP.
The enclosed documentation is an integral part of this product:
• Read and observe the documentation.
• Keep the documentation in a convenient place for future reference.
2.2 Skills of Qualified Persons
The activities described in this document must only be performed by qualified persons.
Qualified persons must have the following skills:
• Knowledge of IP-based network protocols
• Training in the installation and configuration of IT systems
• Knowledge of and compliance with this document and all safety information
2.3 Safety Information
This section contains safety information that must be observed at all times when working on or with
the product. To prevent personal injury and property damage and to ensure long-term operation of
the product, read this section carefully and observe all safety information at all times.
Technical Information ClusterController_Modbus-TI-en-18 7
Safety SMA Solar Technology AG
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 system.
• Take appropriate protective measures, for example:
• Set up a firewall
• Close unnecessary network ports
• Only enable remote access via VPN tunnel
• Do not set up port forwarding at the Modbus port in use
2.4 Information on Data Security
8 ClusterController_Modbus-TI-en-18 Technical Information
SMA Solar Technology AG Product Description
3 Product Description
3.1 Modbus Protocol
The Modbus Application Protocol is an industrial communication protocol that is currently used in
the solar sector mainly for system communication in PV power plants.
The Modbus protocol has been developed for reading data from or writing data to clearly defined
data areas. The Modbus specification does not prescribe what data is within which data area. The
data areas must be defined device-specifically in Modbus profiles. With knowledge of the devicespecific Modbus profile, a Modbus master (e.g. SCADA system) can access the data of a Modbus
slave (e.g. SMA Cluster Controller). 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.
The special Modbus profile for SMA devices is the SMA Modbus profile.
3.2 SMA Modbus Profile
The SMA Modbus profile contains definitions for SMA devices. A reduction of the available data
on SMA devices was carried out for the definition and this was then assigned to the corresponding
Modbus registers. The SMA Modbus profile contains, for example, the total and daily energy,
current power, voltage and current levels. The assignment between SMA device data and Modbus
addresses is split into ranges in the 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.
3.3 User-Defined Modbus Profile
The user-defined Modbus profile enables you to reassign Modbus addresses of the SMA Modbus
profile. One advantage of reassigning Modbus addresses is, for example, that you can arrange
relevant measured values and parameters in sequence for a specific purpose. These addresses can
then be read and written in a single data block.
3.4 PV System Topology
The SMA Modbus profile was developed for a hierarchical system structure. In this structure, the
Cluster Controller is a communication device which is equipped with a Modbus TCP/IP and Modbus UDP/IP interface. All additional SMA devices that are connected to the Cluster Controller via
the SMA fieldbus are subordinate to the Cluster Controller. From the perspective of the Modbus
protocol, the Cluster Controller represents a Modbus slave that provides a gateway to SMA devices. The SMA devices can only be addressed using this gateway per unit ID.
Technical Information ClusterController_Modbus-TI-en-18 9
Product Description SMA Solar Technology AG
Line
Explanation
IP network connection between SCADA system and Cluster Controller
(PV system router)
SMA fieldbus
Logical assignment of SMA device to unit ID
Example 1: PV System Topology from the Perspective of the SMA Devices
10 ClusterController_Modbus-TI-en-18 Technical Information
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.
Technical Information ClusterController_Modbus-TI-en-18 11
Product Description SMA Solar Technology AG
Unit ID
Explanation
1
This unit ID is reserved for the gateway of the Cluster Controller.
2
This unit ID is reserved for the system parameters.
3 to 247
The unit IDs 3 to 247 are used for addressing individual devices and for the userdefined Modbus profile. 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. You can change the assignment of these unit IDs (see Section 4.2 "Information on Changing Unit IDs", 17).
255
Devices which are assigned to this unit ID, were connected to the Cluster Controller or
replaced after activation of the Modbus server. The devices cannot be addressed with
this unit ID. You must assign unit IDs from the range 3 to 247 to these devices (see
Section 4.2 "Information on Changing Unit IDs", page 17).
3.5 Addressing and Data Transmission in the Modbus Protocol
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.
The following table shows an overview of the unit IDs in the SMA Modbus profile:
12 ClusterController_Modbus-TI-en-18 Technical Information
SMA Solar Technology AG Product Description
3.5.2 Assignment of the Modbus Register to Unit IDs
The assignment of the parameters and measured values of the SMA devices to Modbus register
addresses is achieved using assignment tables and is also shown in this document (see Section 5
"SMA Modbus Profile—Assignment Tables", page 23).
In the assignment table "Gateway (unit ID = 1)", the assignment of SMA devices to individual
unit IDs is saved in the Modbus registers from address 42109. Each assignment has an address
range of four Modbus registers, although only the corresponding register is writable with the
unit ID.
In the assignment table "PV System Parameters (unit ID = 2)", parameters and measured values of
the Cluster Controller and the PV system are stored.
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 devicespecific Modbus registers of SMA products can be found on our product pages or Modbus page
at www.SMA-Solar.com.
3.5.3 Modbus Register Address, Register Width and Data Block
A Modbus register is 16 bits wide. For wider data items, connected Modbus registers are used and
considered as data blocks. The number of connected Modbus registers is indicated in the assignment tables. The address of the first Modbus register in a data block is the start address of the data
block.
3.5.4 Address Range for Modbus Register
For addressing Modbus registers, the address range 0 to 0xFFFF is available with 65536 addresses.
3.5.5 Data Transmission
In accordance with the Modbus specification, only a specific volume of data can be transported in
a single data transmission in a simple protocol data unit (PDU). The data also contains functiondependent parameters such as the function code, start address or number of Modbus registers to
be transmitted. The amount of data depends on the Modbus command used and has to be taken
into account during data transmission. You can find the number of possible Modbus registers per
command in section 3.6.
With data storage in the Motorola format "Big Endian", data transmission begins with the high byte
and then the low byte of the Modbus register.
Technical Information ClusterController_Modbus-TI-en-18 13
Loading...