SMA Cluster Controller MODBUS® Interface
Contents
1. 48 SMA Modbus Profiel Assignment Tables 29 SMA Modbus Profile Explanation oen 9 Speedwire Data Module 48 Status Values 23 SUNNY BOY cnet tiet 48 Sunny Tripower 48 Supported SMA Inverters 48 SUSY ID isi 7 15 teet 17 System stability 49 T Table Gateway 30 Joint Addresses of all SMA Devices 36 Plant 33 Return Codes General 51 Time ZONES 49 Target Groups iet 5 TEMP iid oti es 25 Time Zones eii as avek eet e euer eve 49 Identification 49 ine 49 Topology Trademarks U 1 4n EE RUNDEN I 23 eerte 23 G4 23 10 255 uan We ERRORES 13 14 Technical Description SMA Solar Technology AG CHANGE 3 kai 16 Changing ice 14 Changing Unit IDs via the Gateway 15 Changing via XML File Duplicate Unit IDS Wrong Data Unit ID 1 Unit ID 2 E A Unit ID 247 User Data 125 Modbus Registers 27 253 27 27 Register2. roten nenne 23 5 Data Formats DNO Mo 23 Data Formats and NaN Values scessessessessessessseesesneesessecsecsecaessesanesessnesesaneeseanes 23 T Bit Integer Values nena Ree i E ee eds 24 32 Bit Integer Values uia tei rd eea dette d 24 64 Bit Integer Values RR ERE EE 24 Technical Description ClusterController MODBUS TD EN124811 3 Table of Contents SMA Solar Technology AG 6 2 6 3 6 4 7 7 1 7 2 7 2 1 7 2 2 7 3 8 9 9 1 9 2 93 9 4 9 5 9 6 9 7 10 11 SMA Data aea a a 25 Addressing and Data Transfer in 27 Reading and Writing Data Modbus Registers 28 SMA Modbus Profile Assignment Tables 29 Information on the Assignment 29 SMA Cluster Controller otn tente cep kit pe pike ai ea 30 30 Plant ase UEBER Ug 33 a kone kapa 36 l sois ai ta Doo ote pi e k tete A7 Technical te eo ako ia siek sap asa Dav dide eset 48 Supported SMA Inverters wicca tco SH praed 48 Modbus Communication Port tbe dpt ns 48 Modbus Reaction Iifties eer an ande retenti ka 49 Interval of the data request and number of the values
3. 49 Number of SMA Devices uie RR aa di bot s koki ask pi M ei 49 Return Codes for Time Zones 49 General Return Codes soe te nat 5 53 MICEX ciate aunties ca ote 55 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Information on this Document 1 Information on this Document Validity This document is valid for the device type CLCON 10 GR1 It describes the Modbus interface of the SMA Cluster Controller the variant of the Modbus Application Protocol implemented by SMA and the corresponding data exchange formats for SMA devices This document does not contain any information on software with which the Modbus interface can communicate For information on such software see the manual of the respective software manu facturer Target Group This document is for skilled persons Only persons with the appropriate skills are allowed to perform the tasks set forth in this document see Section 2 2 Skills of Skilled Persons p 8 Additional information SMA documents Additional information is available in the Download area of the respective subsidiary at www SMA Solar com Document title Document type SMA Cluster Controller Installation manual SMA Cluster Controller User manual Technical Description ClusterController MODBUS TD EN 12481 1 Information on this Document SMA Solar Te
4. Interface for Modbus Communication SMA CLUSTER CONTROLLER Modbus Interface Technical Description ClusterController MODBUS TD EN124811 Version 1 1 SMA Solar Technology AG Table of Contents Table of Contents 1 2 2 1 2 2 2 3 3 3 1 3 2 3 3 3 4 4 5 5 1 5 1 1 5 1 2 5 1 3 5 1 4 5 2 6 1 6 1 1 6 1 2 6 1 3 6 1 4 Information on this Document 5 bik katsan ka taa kn ko teu ji n reed b pet ehe 8 lE oom e DU 8 Skills of Skilled Persons tatto ut e i 8 Safety Precautions a scent eris rate ka tel texte 8 Product Description etnies onon do tavodtosksossnsssd stsosdsaoc n 9 Modbus sisse a poin i ees t reser utile 9 SMA Modbus PWO A etan 9 User Defined Modbus 1 20222 0000000000000000124 9 Possible Network Topologles cte teret 10 COMMISSIONING kdk p 13 dee hx 14 Changing nib 14 Informationan Unit IDs 14 Changing Unit IDs via the Gateway 15 Changing Unit IDs via a User Defined Plant File sss 17 Restoring Default Setfinggs 19 Creating a User Defined Modbus Profile 19 Interface
5. The apparent power active power and reactive power of the devices stored under the Unit IDs 3 and 4 are to be written as consecutively running Modbus addresses from address 00000 on The number of Modbus registers per value CNT must be considered every third value equals 2 The following table is an excerpt from the SMA Modbus profile ADR Description CNT DEC return code 2 bytes Format Display Type Access Apparent power on all line conductors VA 30813 2 32 Scalar FIXO RO AC active power on all line 30775 2 32 Scalar FIXO RO conductors W Reactive power on all line conductors VAr 30805 2 532 Scalar FIX2 RO Technical Description ClusterController MODBUS TD EN 124811 21 Configuration The exact structure of the XML file looks like this lt xml version 1 0 encoding UTF 8 virtual modbusprofile channel unitid 3 source2 30813 destination 00000 gt channel unitid 3 source2 30775 destination 00002 gt channel unitid 3 source 30805 destination 00004 gt channel unitid A source2 30813 destination 00006 gt channel unitid 4 source2 30775 destination 00008 gt channel unitid A source 30805 destination 00010 gt lt virtual_modbusprofile gt 22 ClusterController MODBUS TD EN 124811 SMA Solar Technology AG Technical Description SMA Solar Techn
6. lt virtual_modbusprofile gt Explanation A user defined Modbus profile is specified within this XML structure lt channel gt Within a Channel tag a new Modbus address can be defined in a Unit ID unitid aaa Specifies the Unit ID of a device whose Modbus addresses have to be redefined Available Unit IDs for individual devices are 1 to 247 source bbbbb Specifies a Modbus address of a device selected under unitid whose value is to be used as source For information on the assignment tables see Section 7 destination ccccc Specifies the new Modbus address from which the value is to be retrieved 0 to 65535 Please consider the number of Modbus registers that are stored at the initial address The destination regis ters must not overlap If definitions are entered in invalid addresses a Modbus exception is gener ated If definitions are entered in addresses which don t have values inquiries are answered with NaN lt Part commented out Comments out an area in the XMI file e g in order to deactivate an instruction i Modbus exceptions You will find information on Modbus exceptions in the source MBAP page 5 To activate your user defined Modbus profile upload the file Usrprofile xm to the Cluster Control ler restart this and activate the customer defined Modbus profile as described below If the usage of the user defined Modbus profile
7. MBAP does not stipulate which data is to be in which data area the data areas must be defined in a device specific manner in so called Modbus pro files With knowledge of the device specific Modbus profile a Modbus master e g a SCADA system can access the data of a Modbus slave e g the SMA Cluster Controller The special Modbus profile for SMA devices is the SMA Modbus profile see Section 3 2 3 2 SMA Modbus Profile The SMA Modbus profile is a special Modbus profile for SMA devices and contains definitions for SMA devices that can be connected via Modbus The figure of the measured values and parame ters of particular SMA devices on the MODBUS is individually defined in the SMA MODBUS profile An SMU String Monitoring Unit for example only provides the information on the string currents whereas an inverter for example provides the opportunity to call up power and voltage A reduction of the available data on SMA devices such as overall and daily energy current pow ers voltages and currents was performed and this data was assigned to the respective Modbus registers This reduction and assignment between SMA device data and Modbus addresses is illustrated in an assignment table see Section 7 It is not intended to provide every SMA device with a physical Modbus interface To enable access to data of an SMA device without Modbus capability a special gateway is required via which the SMA Cluster Controller can be made avail
8. U32 Status ENUM RO 30215 Status description 885 No description nnnnn Last event number number of characters limited by device for information on event numbers see Section 8 U32 Status ENUM RO 30217 Grid contactor 5 7 Contactor closed 311 Contactor open U32 Status ENUM RO Technical Description ClusterController MODBUS TD EN 124811 37 SMA Modbus Profile Assignment Tables SMA Solar Technology AG Temperature derating 302 No derating 557 Temperature derating 30219 1704 WMax derating 2 U32 Status ENUM RO 1705 Frequency derating 1706 Derating due to PV current limitation 30225 Insulation resistance ohms 2 U32 Scalar FIXO RO Status of key switch 30227 381 Switched off 2 U32 Status ENUM RO 569 Switched on 30229 Local time of device 2 U32 Scalar DT RO Maximum possible continu ous active power fixed 30231 2 U32 Scalar FIXO RO configuration Can be greater than the nominal power W Permanent active power 30233 2 U32 Scalar FIXO RO limitation W State of DC switch 30257 51 Closed 2 U32 Status ENUM RO 311 Open Total AC energy fed in on all 30513 4 U64 Scalar FIXO RO line conductors Wh Energy fed in on the current 30517 day on all line conductors 4 U64 Scalar FIXO RO Wh Dura 30521 Operating hours s 4 U64 Scalar RO ion Dur
9. usrplant xml the system returns to the specifications saved in the file sysplant xml A modified userplant xml becomes effective a few seconds after saving to the Cluster Controller Examples for a customer specific plant file Userplant xml The Unit IDs of the following two SMA devices are to be changed to Unit ID 3 and 4 B 5000 TL21 SUSy ID 138 serial number 2178909920 current position in gateway 7 e STP 15000TL 10 SUSy ID 128 serial number 2112303920 current position in gate way 8 The exact structure of the XML file looks like this lt xml version 1 0 encoding UTF 8 plant version 001 gt device regoffs 7 susyid 138 serial 2178909920 unitid 3 gt device regoffs 8 susyid 128 serial 2112303920 unitid 4 gt plant 18 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Configuration 5 1 4 Restoring Default Settings By resetting the Cluster Controller to default settings the previously assigned Unit IDs are deleted and reassigned the sysplant xml is therefore rewritten As a result all connected SMA de vices are assigned a new Unit ID i Save data prior to restoring default settings By resetting the Cluster Controller to default settings the user defined plant file user plant xml and customer defined Modbus profile usrprofile xml are deleted If required please save these files before resetting For
10. SMA Japan com SMA Technology Korea Co Ltd www SMA Korea com SMA Middle East Ltd www SMA Me com SMA Solar Technology Portugal Unipessoal Lda www SMA Portugal com SMA Solar Thailand Co Ltd www SMA Tahiland com SMA Solar UK Ltd www SMA UK com
11. Technology AG SMA Modbus Profile Assignment Tables Displacement power factor from AC active power on all 30821 line conductors and Reac 2 U32 Scalar FIX2 RO tive power on all line conduc tors Excitation type of cos Phi 30823 1041 Overexcited 2 U32 Scalar ENUM RO 1042 Underexcited Operating mode of the reac tive power regulation 303 Off 1069 Reactive power voltage characteristic curve Q U 1070 Reactive power Q direct default setting 1071 Reactive power const Q kVAr 1072 Reactive power Q default setting via plant control 1073 Reactive power 30825 1074 cos Phi direct 2 U32 Status ENUM RO default setting 1075 cos Phi default setting via plant control 1076 cos Phi P character istic curve 1387 Reactive power Q default setting via analogue input 1388 cos Phi default setting via analogue input 1389 Reactive power voltage characteristic curve Q U with hysteresis and deadband Technical Description ClusterController MODBUS TD EN 12481 1 Al SMA Modbus Profile Assignment Tables SMA Solar Technology AG 30827 Reactive power setpoint VAr 2 32 Scalar FIXO RO 30829 Reactive power setpoint 2 32 Scalar FIX1 RO 30831 cos Phi target value 2 32 Scalar FIX2 RO Target value excitation type of cos Phi 30833 2 U32 Status ENUM RO 1041 Overexcited 1042 Underexcited Active power li
12. U32 Status ENUM RO 267 Inverter Device model For possible values see 30053 2 U32 Status ENUM RO Section Supported SMA Inverters page 48 Manufacturer specification 30055 2 U32 Status ENUM RO 461 SMA 30057 Serial number 2 U32 Scalar RAW RO 30059 Software package 2 U32 Scalar FW RO Event ID of the current event number of characters limited 30197 2 U32 Scalar FIXO RO by device for information on event numbers see Section 8 Time until grid connection Dura 2 U32 Scalar RO attempt s tion 30199 Condition 35 7 Fault 30201 303 Off 2 U32 Status ENUM RO 307 OK 455 Warning 36 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables 30203 Nominal power in mode 307 OK U32 Scalar FIXO RO 30205 Nominal power in mode 455 Warning 032 Scalar FIXO RO 30207 Nominal power in mode 35 Fault U32 Scalar FIXO RO 30209 Nominal power in mode 303 Off U32 Scalar FIXO RO 30211 Recommended action 336 Contact manvfacturer service 337 Contact electrically qualified person 338 Invalid U32 Status ENUM RO 30213 Status message 886 No message nnnnn Last event number number of characters limited by device for information on event numbers see Section 8
13. default setting via analogue input 1388 cos Phi default setting via analogue input 1389 Reactive power voltage characteristic curve Q U with hysteresis and deadband 40202 Reactive power setpoint VAr 32 Scalar FIXO RW 40204 Reactive power setpoint 32 Scalar FIX RW 40206 cos Phi target value 32 Scalar FIX2 RW 40208 Target value excitation type of cos Phi 1041 Overexcited 1042 Underexcited U32 Status ENUM RW 40210 Active power limitation oper ating mode 303 Off 1077 Active power limita tion P W 1078 Active power limita tion P 1079 Active power limita tion P via plant control 1390 Active power limita tion P via analogue input 1391 Active power limita tion P via digital inputs U32 Status ENUM RW Technical Description ClusterController MODBUS TD EN 124811 45 SMA Modbus Profile Assignment Tables SMA Solar Technology AG 40212 Active power setpoint 2 U32 Scalar FIXO RW 40214 Active power setpoint 2 U32 Scalar FIXO RW 46 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Troubleshooting 8 Troubleshooting For troubleshooting purposes use the event numbers displayed by the inverters under Modbus address 30197 i Event numbers cannot be decoded via r
14. further information on resetting to default settings and saving XML files refer to the SMA Cluster Controller user manual 5 2 Creating a User Defined Modbus Profile You can change the assignment of the Modbus addresses by creating a user defined Modbus profile In the user defined Modbus profile the address assignments that were defined in the SMA Modbus profile can be reassigned to other Modbus addresses You can use the whole Modbus address range between O and 65535 The user defined Modbus profile can be called up via the gateway like an additional device and has its own Unit ID which you can specify between 3 and 247 for rules concerning Unit IDs see Section 5 1 1 The user defined Modbus profile is defined in the file Usrprofile xml in addition to the SMA Mod bus profile One advantage of the user defined Modbus profile can be that the measured values and parame ters which are relevant for controlling your plant can be applied to consecutive Modbus addresses and can therefore be read out or set in one block The basic structure of the XML file is as follows lt xml version 1 O encoding UTF 8 virtual modbusprofile channel unitid aaa source bbbbb destination ccccc gt lt virtual_modbusprofile gt Technical Description ClusterController MODBUS TD EN 12481 1 19 Configuration Legend for XML tags and attributes SMA Solar Technology AG XML tag or attribute virtual modbusprofile
15. under Unit ID 2 Every additional SMA device e g an inverter therefore receives a Unit ID 2 3 to 247 10 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Product Description Examples for network topologies Network topology from the perspective of the SMA devices MODBUS Master i MODBUS TCP IP UDP IP Unit ID 1 STP nn000TL 10 SB nOOOTL 21 SMA fieldbus Logical assignment of SMA device to unit ID Technical Description ClusterController MODBUS TD EN124811 11 Product Description SMA Solar Technology AG Network topology from the perspective of the Modbus STP 000 10 MODBUS N eet Unit ID 1 Gateway 1 42109 Device 1 SUSy ID 42110 Device 1 Serial number 42112 Device 1 Unit ID e g 3 Serial Saber NM 42113 Device 2 SUSy ID a 42114 Device 2 Serial number 42116 Device 2 Unit ID e g 4 e s STP nOOOTL 20 Unit ID 2 Plant parameters 30513 Total yield Wh 30517 Day yield Wh p e gt Unit ID 3 SUSy ID 128 Serial number 21 123xxxxx SUSya4D 181 30513 Total yield Wh Serial number 21456xxxxx 30795 Grid current A o e u e gt Unit ID 4 SUSy ID 181 SB nOOOTL 21 Serial number 21456 e 30513 Total yield Wh 30795 Grid current SUSy ID 138 Serial number 21789xxxxx From the perspective of the Modbus an inverter is respectively assigned to a U
16. 00 New York Miami Atlanta Detroit UTC 02 00 Cairo UTC 05 00 Yekaterinburg UTC 12 00 Fiji Marshall Islands UTC 02 00 Helsinki Kiev Riga Sofia Tallinn UTC Dublin Edinburgh Lisbon London UTC 03 00 Greenland UTC Monrovia Reykjavik UTC 02 00 Athens Bucharest Istanbul UTC 10 00 Hawaii UTC 05 30 Chennai Kolkata Mumbai New TC 03 30 Tehran 02 00 Jerusalem TC 02 00 Amman TC 09 00 Seoul Kuala Lumpur Singapore 02 00 Mid Atlantic Beirut 07 00 Denver Salt Lake City Calgary 06 30 Yangon Rangoon Novosibirsk Kathmandu 12 00 Auckland Wellington 03 30 Newfoundland Irkutsk Krasnoyarsk ITC 07 00 04 00 Santiago 08 00 Pacific USA Canada 08 00 Tijuana Lower California Mexico 01 00 Brussels Copenhagen Madrid Paris U U U U U U U U U U UTC 02 00 Windhoek U U U U U U U U U U TC 03 00 Moscow St Petersburg Volgograd ClusterController MODBUS TD EN 124811 9562 9563 9565 9566 9567 9568 9569 9570 9571 9572 9573 9574 9575 9576 9577 9578 Stockho 9579 9580 9581 9582 9583 peg 9584 9585 9587 9588 9589 9591 m Vienna SMA Solar Technology AG 03 00 Buenos Aires 05 00 Bogot Lima Quito 1 1 00 Midway Islands Samoa 07 00 Bangkok Hanoi Jakarta TC 02 00 Harare Pretoria TC 05 30 Sri Jayewardenepura TC 08 00 Taipei TC 10 00 Hoba
17. 0000000 processor format U64 A quad word 64 bit 2 x DWORD in the local proc OxFFFFFFFFFFFFFFFF essor format Technical Description ClusterController MODBUS TD EN 12481 1 23 Interface Definition SMA Solar Technology AG 6 1 2 16 Bit Integer Values 16 bit integers are stored in a register in big endian sorting MODBUS register 1 Byte 0 1 Bits 8 15 0 7 U16 0 65535 Not implemented OxFFFF 16 32767 32767 Example 32 000 U16 2 01111101 00000000 6 1 3 32 Bit Integer Values Not implemented 0x8000 32 bit integers are stored in two registers in big endian sorting MODBUS register 1 2 Byte 0 1 2 3 Bits 24 31 16 23 8 15 0 7 U32 0 4294967294 Not implemented OxFFFFFFFF U32 status 24 bit O 1677212 Not implemented OxFFFFFD 32 2 147483647 2147483647 Not implemented 0x80000000 Example 136 534 944 U32 00001000 00100011 01011011 10100000 6 1 4 64 Bit Integer Values 64 bit integers are stored in four registers in big endian sorting MODBUS register 1 2 Byte 0 1 2 3 Bits 36 63 48 55 40 47 32 39 MODBUS register 3 4 Byte 4 5 6 7 Bits 24 31 16 23 8 15 0 7 064 18446744073709551614 Not implemented OxFFFFFFFFFFFFFFFF 24 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Interface Definition
18. 013 es yet 44 40020 pani saye rena 44 56 ClusterController MODBUS TD EN 124811 SMA Solar Technology AG Assignment Table Example 15 Assignment Tables 9 10 Header iiia 29 Changing Unit ID 14 16 D Data entrer 25 Data Format Statues 23 Data 23 Data 9 Data requests Upper o cient 49 5 uH 8 Technical Description SMA Solar Technology AG Data 244 4222441 25 Default Settings Saving xml Files 19 Device 36 Display Explanation DT k s ot n Duplicate Assignment e 14 DUratiOn 25 DWOR D 7 23 E 25 Event Numbers Information on Breakdown 47 Information on Breakdown 51 Exkurs Firmware 26 F Fieldbis cette 7 10 Figure SMA Devices on Modbus Data Area 9 Firmware Version 5 26 orm PIRE 25 FIX sete rhet PA 25 25 dcl 25 FIX4 Ai
19. 078 DI6 2079 DI 017 34 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables 2080 DIZ DI8 2081 216 DI8 2082 DI7 2083 DI7 DI8 2084 DI8 40001 Reading and setting the plant time UTC U32 Scalar DT RW 40003 Reading and setting the time zone For possible values see Section Return Codes Time Zones page 49 U32 Status ENUM RW 40005 Automatic daylight saving time conversion active 1129 Active 1130 Not active U32 Status ENUM RW Technical Description ClusterController MODBUS TD EN 124811 35 SMA Modbus Profile Assignment Tables SMA Solar Technology AG 7 3 SMA Devices The following table contains the measured values and parameters that you can access via Unit IDs 7 8 to 247 The table does not apply for Unit IDs 1 and 2 i Availability of the Modbus register For each inverter type only certain Modbus registers are available If a Modbus register is not available for an inverter type a Modbus exception will be generated upon accessing this register You will find information on Modbus exceptions in the source MBAP page 5 ADR Description CNT Format Display Type Access DEC return code 2 bytes 30003 SUSy ID 2 U32 Scalar RAW RO 30005 Serial number 2 U32 Scalar RAW RO Device class 30051 2
20. 2145600972 Serial number A 42112 3 Unit ID A 42113 158 SUSy ID B 42114 2145600320 Ser al number B 42116 4 Unit ID B 42117 158 SUSy ID C 42118 2145600934 Serial number C 42120 255 Unit ID G 43085 65535 SUSy ID X 43086 4294967294 Serial number X 43088 65535 Unit ID X Technical Description ClusterController MODBUS TD EN124811 15 Configuration Changing the Unit ID in the gateway assignment table SMA Solar Technology AG You change a Unit ID by writing it to the corresponding Modbus address you can do this using your Modbus master system e g a SCADA system i Changing the Unit ID in the gateway assignment table To change a Unit ID in the Gateway assignment table all three registers belonging to a device must be written in one block For the following example this means that all the data of the three Modbus addresses 42113 42114 and 42116 must be written Example for changing the Unit ID in the assignment table The following table shows an example assignment An inverter with SUSy ID 160 and serial number 1134365300 was subsequently detected as a second device in the plant Modbus ad dresses 42113 to 42116 The Unit ID of this device was manually set to 4 Modbus address After detection Modified 42113 SUSy ID 160 160 42114 Serial number 1134365300 1134365300 42116 Unit ID 255 NaN 4 16 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Co
21. 5 Create a user defined Modbus profile if required see Section 5 2 Activate the user defined Modbus profile if required see Section 5 2 Technical Description ClusterController MODBUS TD EN124811 13 Configuration SMA Solar Technology AG 5 Configuration 5 1 Changing Unit IDs 5 1 1 Information on Unit IDs You can change the Unit IDs of SMA devices A change is required for example if additional or modified SMA devices are assigned the Modbus Unit ID 255 NaN via automatic detection With this Unit ID the devices cannot be addressed and cannot be accessed via the Modbus You must assign these devices individual Unit IDs On the other hand the user may wish to restructure the plant topology so that the physical assignment of the devices can be better depicted in Mod bus Depending on whether you wish to change individual unit IDs or restructure the entire plant topol ogy you have two options for personally changing the Unit IDs of the detected devices e Changing Unit IDs via the assignment table of the gateway recommended for changing indi vidual Unit IDs e Changing Unit IDs via a user defined plant file recommended for the restructuring of the plant topology Both of these methods are described in separate Sections It is the case for both methods of modify ing Unit IDs that 247 devices can be addressed in Modbus via the Unit ID see source Modbus Serial The following table shows a summary of the reserved and fre
22. 6 2 SMA Data Types The following SMA data types describe the types of data that are transmitted The SMA data types are listed in the Type column of the assignment tables Type Explanation Duration Time period Output in seconds DT Date time Output of date time in accordance with country setting Transmission as UTC without daylight saving time in seconds since 1970 01 01 FIXO Factor 1 Output as decimal number commercially rounded no decimal places FIX Factor 0 1 Output as decimal number commercially rounded one decimal place FIX2 Factor 0 01 Output as decimal number commercially rounded two decimal places FIX3 Factor 0 001 Output as decimal number commercially rounded three decimal places FIX4 Factor 0 0001 Output as decimal number commercially rounded four decimal places FW Firmware version e g 1 12 0 R see abstract below RAW Output as text or number depending on data format of the value Numbers without decimal places and without thousand or other separation indicators ENUM This type of parameter can provide various status values The parameters are returned as code You will find the breakdown of the code in the appropriate section of the SMA MODBUS Profile assignment table TEMP Temperature The values are given in degrees Celsius The output is commercially rounded to one decimal place Technical Description ClusterController MODBUS TD EN124811 25 Inter
23. ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables 34637 Analogue current input 1 mA 32 Scalar FIX2 RO 34639 Analogue current input 2 mA 32 Scalar FIX2 RO 34641 Analogue current input 3 mA 32 Scalar FIX2 RO 34651 Analogue current input 4 V 32 Scalar FIX2 RO 34653 Digital input group 1 coded as status 311 Open 2055 DII 2056 DI2 2057 DI2 2058 011 DI2 014 2059 011 DI2 DI4 2060 011 2061 011 214 2062 011 2063 DI2 2064 DI2 DI3 2065 DI2 DI3 DI4 2066 DI2 DI4 2067 DI3 2068 DI3 DI4 2069 DI4 U32 Status ENUM RO 34655 Digital input group 2 coded as status 311 Open 2070 DI5 2071 DI5 DI6 2072 215 016 217 2073 015 016 217 018 2074 015 16 018 2075 015 017 2076 015 DI7 018 032 Status ENUM RO Technical Description ClusterController MODBUS TD EN 124811 31 SMA Modbus Profile Assignment Tables SMA Solar Technology AG 2077 DI5 DI8 2078 DI6 2079 DI6 DIZ 2080 216 DIZ DI8 2081 216 DI8 2082 DI7 2083 DI7 DI8 2084 DI8 Unit ID assignment SMA devices see also Section 5 1 42109 Device 1 SUSy ID 1 U16 Scalar
24. RAW RO 42110 Device 1 serial number 2 U32 Scalar RAW RO 42112 Device 1 Unit ID e g 3 1 U16 Scalar RAW RW 42113 Device 2 SUSy ID 016 Scalar RAW RO 42114 Device 2 serial number 2 U32 Scalar RAW RO 42116 Device 2 Unit ID e g 4 1 016 Scalar RAW RW 43085 Device 245 SUSy ID 1 U16 Scalar RAW RO 43086 Device 245 serial number 2 U32 Scalar RAW RO 43088 2 245 Unit ID leg 1 016 Scalar RAW RW For Unit ID 255 please observe Section 5 1 1 1 Changing Unit ID in the gateway To change a Unit ID in the gateway all three registers belonging to a device must be writ ten see Section 5 1 2 32 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG 7 2 2 Plant Parameters You can access the plant parameters stored in the SMA Cluster Controller via Unit ID 2 SMA Modbus Profile Assignment Tables ADR Description CNT Format Display Type 55 DEC return code 2 bytes Modbus data change meter value is increased by the 30007 2 U32 Scalar RAW RO Cluster Controller if new data is available Total AC energy fed in on all 30513 4 U64 Scalar FIXO RO line conductors Wh Energy fed in on the current 30517 day on all line conductors 4 U64 Scalar FIXO RO Wh AC active power on all line 30775 2 32 Scalar FIXO RO conductors W 34609 Ambient temperature 2 32 Scalar TEMP RO Highest measure
25. a 30525 Feed in hours s 4 U64 Scalar ji RO ion Total AC energy fed in on all 30529 2 U32 Scalar FIXO RO line conductors Wh Total AC energy fed in on all 30531 2 U32 Scalar FIXO RO line conductors KWh 38 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables Total AC energy fed in on all 30533 U32 Scalar FIXO RO line conductors MWh Energy fed in on the current 30535 day on all line conductors U32 Scalar FIXO RO Wh Energy fed in on the current 30537 day on all line conductors U32 Scalar FIXO RO kWh Energy fed in on the current 30539 day on all line conductors U32 Scalar FIXO RO MWh Dura 30541 Operating hours s U32 Scalar RO ion Dura 30543 Feed in hours 5 U32 Scalar A RO ion ting hours Dura 30545 nouns 032 Scalar RO interior fan 1 5 tion Operating hours Dura 30547 U32 Scalar RO interior fan 2 s tion Operating hours Dura 30549 U32 Scalar RO heat sink fan s tion Number of events at user 30559 U32 Scalar FIXO RO level Number of events at electri 30561 U32 Scalar FIXO RO cally qualified person level 30769 DC current input A 32 Scalar FIX3 RO 30771 DC voltage input V 32 Scalar FIX2 RO 30773 DC power input W 32 Scalar FIXO RO AC active power on all line 30775 32 Scalar FIXO RO
26. able 3 3 User Defined Modbus Profile The SMA Modbus profile can be used as the basis for a user defined Modbus profile see Section 5 2 There the address assignments that were defined in the SMA Modbus profile can be reas signed to other Modbus addresses One advantage of reassigning Modbus addresses can be that the measured values and parame ters which are relevant for controlling your plant can be applied to consecutive Modbus addresses These addresses can therefore be read and set in a block Technical Description ClusterController MODBUS TD EN124811 9 Product Description SMA Solar Technology AG 3 4 Possible Network Topologies The SMA Modbus profile has been designed for a hierarchical plant structure In this structure the Cluster Controller is a communication device which is equipped with a Modbus TCP IP and Mod bus 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 the SMA Cluster Controller represents a Modbus slave that prepares a gateway to subordinate SMA devices The subordinate SMA devices can only be addressed using this gateway via unit ID Unit ID The Unit ID is a device identification in the Modbus protocol The assignment of the SMA devices to a Unit ID is saved in the Cluster Controller in an assignment table under Unit ID 1 gateway The general plant parameters are saved
27. age 29 the return codes of the time zones are referenced at various points Here you can determine the correspond ing numerical code for the present time zone and use this to specify the time zone 973 NaN 9509 01 00 Azores 9500 UTC 04 30 Kabul 9510 UTC 06 00 Saskatchewan 9501 UTC 09 00 Alaska 9511 UTC 01 00 Cape Verde Islands 9502 UTC 03 00 Kuwait Riyadh 9512 UTC 04 00 Yerevan 9503 UTC 04 00 Abu Dhabi Muscat 9513 UTC 09 30 Adelaide 9504 UTC 03 00 Baghdad 9515 UTC 06 00 Astana Dhaka 9505 UTC 04 00 Atlantic Canada 9516 UTC O4 00 Manaus 9506 UTC 09 30 Darwin 9517 UTC 01 00 Belgrade Bratislava Budapest 9507 UTC 10 00 Canberra Melbourne Sydney Ljubljana Prague 9508 UTC 04 00 Baku 9518 UTC 01 00 Sarajevo Skopje Warsaw Zagreb Technical Description ClusterController MODBUS TD EN 12481 1 49 Technica 9519 Caledoni 9520 9522 Urumchi 9523 9524 9525 9526 9527 9528 Toronto 9529 9530 9531 9532 Vilnius 9534 9535 9536 9537 9538 9539 Delhi 9540 9541 9542 9543 9544 9545 9546 9547 9549 9550 9551 9552 9553 9554 9555 9556 9557 9558 9559 9560 9561 50 Data 1 1 00 Magadan Solomon Islands New a UTC 06 00 Central America UTC 08 00 Beijing Chongqing Hong Kong UTC 12 00 International Date Line West TC 03 00 Nairobi UTC 10 00 UTC 02 00 Minsk U U Brisbane 03 00 Brasilia TC 05
28. ated Technical Description ClusterController MODBUS TD EN 124811 29 SMA Modbus Profile Assignment Tables 7 2 SMA Cluster Controller 7 2 1 Gateway SMA Solar Technology AG You can access the parameters prepared by the gateway of the Cluster Controller via Unit ID 1 In the following table you can also find the assignment of the subordinate SMA devices to the Unit IDs ADR Description return code CNT Format Display Type Access DEC 2 bytes 3000 Version number of the SMA 2 U32 oi RAW RO Modbus profile SUSy ID SMA Cluster Con 30003 TR 2 U32 Scalar RAW RO troller Serial number SMA Cluster 30005 2 U32 Scalar RAW RO Controller Modbus data change meter value is increased by the 30007 T 2 U32 Scalar RAW RO Cluster Controller if new data is available 34609 Ambient temperature C 2 32 Scalar TEMP RO Highest measured ambient 34611 2 32 Scalar TEMP RO temperature C Total irradiation on the sensor 34613 surface W m 2 U32 Scalar FIXO RO 34621 PV cell temperature C 2 32 Scalar TEMP RO Total irradiation on the exter 34623 nal irradiation sen 2 U32 Scalar FIXO RO sor pyranometer W m 34625 Ambient temperature F 2 32 Scalar TEMP RO 34627 Ambient temperature K 2 32 Scalar TEMP RO 34629 PV cell temperature F 2 32 Scalar TEMP RO 34631 PV cell temperature K 2 32 Scalar TEMP RO 30
29. chnology AG Additional documents You can find additional information on the Modbus Application Protocol on the Internet Source initials Source IANA Internet Assigned Numbers Authority IANA Service Name and Trans port Protocol Port Number Registry hitp www iana org assignments service names portnumbers service names port numbers xml MBAP Modbus Application Protocol Specification V1 1b Modbus Organiza tion Inc PO Box 628 Hopkinton MA 01748 December 2006 Modbus Serial Modbus over Serial Line Specification and Implementation Guide V1 02 Modbus Organization Inc PO Box 628 Hopkinton MA 01748 December 2006 Symbols Symbol Explanation i Information that is important for a specific topic or goal but is not safety relevant Desired result Typographies Typography Usage Example light Elements of a user interface Read out the configured port in the Port field bold Elements to be selected Select Settings e Elements to be entered Several elements that are to be Select Settings gt Port selected Button Key link to a literature source See source MPAP e Button or key to be selected or Select Next pressed 6 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Information on this Document Abbreviations Abbreviation Designation Explanation ADR DEC MODBUS start addr
30. conductors W 30777 AC active power L1 W 32 Scalar FIXO RO 30779 AC active power L2 W 32 Scalar FIXO RO Technical Description ClusterController MODBUS TD EN 124811 39 SMA Modbus Profile Assignment Tables SMA Solar Technology AG 30781 AC active power L3 W 2 32 Scalar FIXO RO Line voltage line connector 30783 2 U32 Scalar FIX2 RO LI to N V Line voltage line connector 30785 2 U32 Scalar FIX2 RO L2 to N V Line voltage line connector 30787 2 U32 Scalar FIX2 RO L3 to N V 30795 AC current A 2 U32 Scalar FIX3 RO Line current 30797 2 U32 Scalar FIX3 RO line conductor L1 A Line current 30799 2 U32 Scalar FIX3 RO line conductor L2 A Line current 30801 2 U32 Scalar FIX3 RO line conductor L3 A 30803 Power frequency Hz 2 U32 Scalar FIX2 RO Reactive power on all line 30805 2 32 Scalar FIX2 RO conductors 30807 Reactive power L1 VAr 2 32 Scalar FIXO RO 30809 Reactive power L2 2 32 Scalar FIXO RO 30811 Reactive power L3 2 32 Scalar FIXO RO Apparent power on alll line 30813 2 32 Scalar FIXO RO conductors VA 30815 Apparent power L1 VA 2 32 Scalar FIXO RO 30817 Apparent power L2 VA 2 32 Scalar FIXO RO 30819 Apparent power L3 VA 2 32 Scalar FIXO RO 40 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar
31. ction code start address number of registers also count as user data Thus a maximum of 125 Modbus registers can be transmitted in one message This must be taken into consideration during the request Technical Description ClusterController MODBUS TD EN124811 27 Interface Definition SMA Solar Technology AG 6 4 Reading and Writing Data from Modbus Registers The following Modbus commands are supported by the implemented Modbus interface Modbus command Hexadecimal value Read Holding Registers 0x03 Read Input Registers 0x04 Write Single Register 0 06 Write Multiple Registers Ox10 Read Write Multiple Registers Ox17 i ij 28 NaN as answer If an undefined value is called up from a Modbus register NaN is returned as the answer You will find possible NaN values in section 6 1 1 Modbus exception if access to a register fails For each inverter type only certain Modbus registers are available If a Modbus register is not available for an inverter type a Modbus exception will be generated upon accessing this register Modbus exception if the setting of several registers fails If several registers in the packet are set one after another Modbus commands Ox10 and Ox17 an error occurs during setting the faulty register as well as all the following registers in the packet will not be set In the event of an error a Modbus exception will be generated Modbus exceptions You will find inf
32. ctive power voltage characteristic curve Q U 1070 Reactive power G direct default setting 1071 Reactive power const Q kVAr 1072 Reactive power Q default setting via plant control 1073 Reactive power Q P 1074 cos Phi direct default setting 1075 cos Phi specification by plant control 1076 cos Phi P characteristic curve Technical Description ClusterController MODBUS TD EN124811 51 Technical Data SMA Solar Technology AG 1077 Active power limitation P W 1078 Active power limitation P Pmax 1079 Active power limitation P via plant control 1387 Reactive power Q default setting via analogue input 1388 cos Phi default setting via analogue input 1389 Reactive power voltage characteristic curve Q U with hysteresis and deadband 1390 Active power limitation P via analogue input 1391 Active power limitation P via digital inputs 1392 Failure 1393 Wait for PV voltage 1394 Wait for valid AC grid 1395 DC range 1396 AC grid 1455 Emergency switching off 1466 Waiting 1467 Starting 1468 MPP search 1469 Shutdown 1470 Disturbance 1471 Warnning failure e mail OK 1472 Warnning failure e mail not OK 1473 Plant info e mail OK 1474 Plant info e mail not OK 1475 Failure e mail OK 1476 Failure e mail not OK 1477 Warning e mail OK 1478 Warning e mail not OK 1479 Wait after grid interruption 1480 Wait for
33. d ambient 34611 9 2 532 Scalar TEMP RO temperature C Total irradiation on the sensor 34613 surface W m 2 U32 Scalar FIXO RO 34621 PV cell temperature C 2 32 Scalar TEMP RO Total irradiation on the exter 34623 nal irradiation sen 2 U32 Scalar FIXO RO sor pyranometer W m 34625 Ambient temperature F 2 32 Scalar TEMP RO 34627 Ambient temperature K 2 32 Scalar TEMP RO 34629 PV cell temperature F 2 32 Scalar TEMP RO 34631 PV cell temperature 2 32 Scalar TEMP RO Technical Description ClusterController MODBUS TD EN 12481 1 33 SMA Modbus Profile Assignment Tables SMA Solar Technology AG 34637 Analogue current input 1 mA 32 Scalar FIX2 RO 34639 Analogue current input 2 mA 32 Scalar FIX2 RO 34641 Analogue current input 3 mA 32 Scalar FIX2 RO 34651 Analogue current input 4 V 32 Scalar FIX2 RO Digital input group 1 coded as status 311 Open 2055 DII 2056 DI1 DI2 2057 Dil DI2 2058 DI1 DI2 DI3 DI4 2059 011 012 014 2 U32 Status ENUM RO 2061 DI1 013 DIA 2062 011 014 2063 DI2 2064 DI2 DI3 2065 DI2 DI3 214 2066 DI2 014 2067 DI3 2068 213 DI4 2069 014 Digital input group 2 coded as status 311 Open 2070 DI5 2071 DI5 DI6 2072 215 016 DI7 34655 2073 DI5 DI6 DIZ DI8 2 U32 Status ENUM RO 2074 215 DI6 DI8 2075 DI5 DI7 2076 DIS DI7 DI8 2077 DI5 DI8 2
34. dentification does not mean that a product or symbol is not trade marked The Bluetooth word mark and logos are registered trademarks owned by Bluetooth SIG Inc and any use of these marks by SMA Solar Technol ogy AG is under license Modbus is a registered trademark of Schneider Electric and is licensed by the Modbus Organization Inc SMA Solar Technology AG Sonnenallee 1 34265 Niestetal Germany Tel 49 561 9522 0 Fax 49 561 9522 100 www SMA de E mail info SMA de 2012 SMA Solar Technology AG All rights reserved 54 ClusterController MODBUS TD EN12481 1 Technical Description SMA Solar Technology AG Index 11 Index 0 28 28 DET eere A 28 Oeics 28 28 RA AVAN 23 0 80000000 23 REFER uam oe n 23 455352 AAA AN AA AN 23 UE 23 OxFFFFFFFFFFFFFFFF 23 2 255 Unit a 13 14 3 Technical Description ClusterController MODBUS TD EN 124811 55 Index 30819 30821 30823 30825 30827 30829 30831 30833 30835 30837 30839 34097 34101 34105 34109 34113 34121 34125 34127 34609 34611 34613 34621 34623 34625 34627 34629 34631 34637 34639 34641 34651 34653 34655 35377 35381 40001 mentes 35 40003 40005 40007 cenit ee 43 40009 etas eis 43 40
35. e Unit IDs Unit ID Explanation 1 Reserved for the Cluster Controller gateway 2 Reserved for the plant parameters 3 to 247 Freely available i Do not assign duplicate Unit IDs You must not assign duplicate Unit IDs If there is a duplicate assignment of a Unit ID the device data that is entered in the assignment table of the gateway under the lowest Mod bus address is always read out in the event of a Modbus request of this Unit ID 14 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Configuration 5 1 2 Changing Unit IDs via the Gateway Procedure e Read out gateway e Change the Unit ID in the gateway assignment table Read out the gateway assignment table You can read out the individual Unit IDs of the SMA devices from the assignment table of the gateway via the Modbus interface You can access this table via Unit ID 1 The assignment of Unit IDs 3 to 247 is saved in the Modbus registers from address 42109 For this purpose every assignment comprises an address area of 4 Modbus registers see the following example You can find the assignment table for the gateway in Section 7 2 1 Example for an assignment table After the automatic detection of a new SMA device the assignment table in your Modbus master system may appear as follows Modbus address Content Description Device 42109 158 SUSy ID A 42110
36. electric utility company 52 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Contact 10 Contact If you have technical problems concerning our products 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 Software version of your SMA Cluster Controller of communication interface between the SMA Cluster Controller and the inverters serial numbers and software version of the inverters connected to the PV plant f you need to send in an SMA Cluster Controller remove the USB stick prior to this SMA Solar Technology AG Sonnenallee 1 34265 Niestetal Germany www SMA de SMA Service Line Inverters 49 561 9522 1499 Communication 49 561 9522 2499 Text CALL BACK to 49 176 888 222 44 Fax 49 561 9522 4699 Email ServiceLine SMA de Technical Description ClusterController MODBUS TD EN 12481 1 53 Contact SMA Solar Technology AG The information contained in these documents is 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 recognised even if not explicitly identified as such A lack of i
37. ess as decimal value CNT 2 bytes Number of assigned MODBUS registers One register contains 2 bytes Cluster Controller SMA Cluster Controller DT FW RAW SMA data types see Section SMA Data FIXn Types page 25 DWORD Data with a width of 32 bit according to IEC 61131 3 Hex Hexadecimal number MBAP Modbus Application Protocol Protocol for the Modbus from Modbus Organization Inc MPP Maximum Power Point Maximum power point NaN Not a Number No useable value is returned PV plant PV plant RO Read Only Value can only be read RW Read Write Value can be read and written SCADA Supervisory Control and Data Acquisition Concept for monitoring and controlling technical proc esses SMA Fieldbus Hardware interface for communication between SMA devices e g Speedwire For information on the various communi cation interfaces please pay attention to the respective datasheets of the SMA devices used SUSy ID SMA Update System ID 3 digit numeric value that identifies a specific SMA device type WMAX Set active power limitation The device can generate active power up to this limit WORD Data with a width of 16 bit according to IEC 61131 3 Technical Description ClusterController MODBUS TD EN 124811 7 Safety SMA Solar Technology AG 2 Safety 2 1 Intended Use The Modbus Application Protocol MBAP is designed for industrial use Read and follow this documen
38. eturn codes The event numbers are device specific Therefore you cannot decode the event numbers using the return codes listed in Section 9 7 In order to decode the event numbers observe the inverter manual You will find information on error analysis of the SMA Modbus profile in section Reading and Writing Data from Modbus Registers page 28 Technical Description ClusterController MODBUS TD EN124811 47 Technical Data SMA Solar Technology AG 9 Technical Data 9 1 Supported SMA Inverters Sunny Boy SB with Speedwire data module SB 2500TLST 21 device model 9184 SB 3000 15 21 device model 9185 SB 3000 21 device model 9074 SB 3600 21 device model 9165 SB 4000 21 device model 9075 SB 5000TL 21 device model 9076 e Sunny Tripower STP with Speedwire data module STP 8000TL 10 device model 9101 STP 10000 10 device model 9067 STP 12000 10 device model 9068 STP 15000TL 10 device model 9069 STP 17000 10 device model 9070 STP 15000 10 device model 9140 STP 20000 10 device model 9139 STP 15000TLEE 10 device model 9182 STP 20000 10 device model 9181 All inverters with retrofitted Speedwire data module You can find a list of the supported in verters in the Speedwire data module installation manual 9 2 Modbus Communication Port Communication port Default setting i Use free comm
39. face Definition SMA Solar Technology AG Firmware version extract FW Four values are extracted from the delivered DWORD The Major and Minor values are BCD coded in bytes 1 and 2 Byte 3 contains the Build value not BCD coded Byte 4 contains the Release Type value according to the following table Value Output Explanation 0 N NOREV 1 E EXPERIMENTAL 2 A ALPHA 3 B BETA 4 R RELEASE 5 S SPECIAL gt 5 As number No special interpretation Example Values from DWORD Mojor 1 Minor 5 Build 10 Release Type 4 Hex Ox1 0x5 OxA 0 4 26 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Interface Definition 6 3 Addressing and Data Transfer in Modbus The Modbus register address forms the start address of a data block A data block equates to a single data set and can consist of one or more Modbus registers The quantity of required Modbus registers is given in the assignment table 1 Addressing Modbus registers The address range O OxFFFF with 65536 addresses is available for addressing Modbus registers One register is 16 bits wide For broader data formats connected registers are used In order to avoid inconsistencies data blocks must always be read or written completely Depending on the Modbus specification a maximum of 253 bytes of user data can be transmitted during the transfer of a message Function dependent parameters e g fun
40. mitation oper ating mode 303 Off 1077 Active power limita tion P W 1078 Active power limita 30835 tion P 75 Pmax 2 U32 Status ENUM RO 1079 Active power limita tion P via plant control 1390 Active power limita tion P via analogue input 1391 Active power limita tion P via digital inputs 30837 Active power setpoint W 2 U32 Scalar FIXO RO 30839 Active power setpoint 2 U32 Scalar FIXO RO Operating hours interior fan Dura 34097 4 U64 Scalar RO 1 s tion Operating hours interior fan Dura 34101 4 U64 Scalar 5 RO 2 s tion 34105 Operating hours heat sink 4 064 Scalar Dura RO fan s tion 34109 Heat sink temperature 1 C 2 32 Scalar TEMP RO 34113 Interior temperature 1 C 2 32 Scalar TEMP RO 42 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables Transformer temperature 1 34121 2 532 Scalar TEMP RO External temperature 1 air 34125 2 532 Scalar TEMP RO supply C Highest measured external 34127 2 32 Scalar TEMP RO temperature 1 C 35377 Number of events for user 4 U64 Scalar FIXO RO Number of events for electri 35381 4 U64 Scalar FIXO RO cally qualified person Reading and setting the time zone For possible values see 40003 2 U32 Status ENUM RW Section Return Codes Time Zones page 49 Aut
41. nfiguration 5 1 3 Changing Unit IDs via a User Defined Plant File The Modbus IDs assigned during the automatic plant detection and the subsequent activation of the Modbus server are saved by the Cluster Controller in an XML file titled sysplant xml This file is an excerpt of the gateway see Section 7 2 1 If new SMA devices are added or if SMA devices are replaced these are respectively added to the available XML structure with Unit ID 255 by the Cluster Controller You specify a user defined plant topology via the plant file usrplant xml The files sysplant xml and usrplant xml have the same tag structure The basic structure of the files is as follows lt xml version7 1 0 encoding UTF 8 plant version 001 device regoffs aaa susyid bbb unitid ddd gt plant Legend for XML tags and attributes XML tag or attribute Explanation lt device gt lt device gt A device entry must be created for each Unit ID that is to be defined for a Modbus device see also the example below regoffs aaa Serial number of the SMA device in the gateway as signment table see also Section 7 2 1 There are four Modbus register addresses between two devices in the gateway assignment table Regoffs O defines the first device under the Modbus address 42109 Regoffs 244 defines the last 245th device under the Modbus address 43085 The serial number must not be as
42. nit ID in the above example This means that the inverter data is available in Modbus Unit ID 1 and Unit ID 2 repre sent the gateway to the Modbus and the plant parameters 12 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Commissioning 4 Commissioning Requirement 4 2 3 4 The devices in the plant must be connected to Cluster Controller and the plant must be commissioned see the installation manual of the Cluster Controller Activate the Modbus server s and configure the communication port if required see the Cluster Controller user manual Automatic plant detection required prior to activating the Modbus servers As a result of the activation of the TCP server and or the UDP server of the Cluster Control ler the previously detected SMA devices are assigned Unit IDs If additional SMA devices are added following the activation of one or both of the servers or if SMA devices are replaced these are automatically detected by the Cluster Controller These devices are then assigned Unit ID 255 NaN by default With this Unit ID the devices cannot be ad dressed and therefore cannot be access via the Modbus For this reason you must manu ally assign these devices individual Unit IDs see Section 5 1 IF one or both of the servers are deactivated and reactivated the previously assigned Mod bus Unit IDs are maintained Change the Unit IDs if required see Section
43. ology AG Interface Definition 6 Interface Definition 6 1 SMA Data Formats SMA data formats have a width of 16 bit 32 bit or 64 bit The width of a Modbus register is 16 bit The registers are transmitted in Motorola format big endian meaning that the high byte is transmitted first and then the low byte is transmitted i Reading and writing from Modbus registers The background to the Modbus interface described in this document is that n Modbus registers must each be read and written in one step If for example two 16 bit Modbus registers are read into a 32 bit SMA data format the 4 bytes of both registers must be read in with a read operation The SMA data formats are listed in the Format column of the assignment tables They describe the data width and the properties of the assigned values If an assignment is not implemented a Mod bus exception will be returned as an error 6 1 1 Data Formats and NaN Values The following data formats are supported by the SMA Modbus profile Format Explanation NaN value U16 A word 16 bit WORD in the local processor format OxFFFF S16 A signed word 16 bit WORD in the local processor 0 8000 format U32 A double word 32 bit DWORD in the local proces OxFFFFFFFF sor format U32 For status values only the lower 24 bit of a double OxFFFFFD word 32 bit DWORD is used in the local processor format 32 signed double word 32 bit DWORD in the local 0x8
44. omatic daylight saving 40005 time conversion active 2 U32 Status ENUM RW 1129 Active 1130 Not active Type of inverter regulation 295 MPP 443 Constant voltage 40007 2 U32 Status ENUM RW 565 Specified power output above characteristic curve Operating state 40009 381 Stop 2 U32 Status ENUM RW 569 Switched on Technical Description ClusterController MODBUS TD EN 12481 1 43 SMA Modbus Profile Assignment Tables SMA Solar Technology AG Set language 777 DE 778 779 780 ES 781 FR 40013 U32 Status ENUM RO 783 KO 784 CS 785 PT 786 NL 796 SL 797 798 PL External measurement of the 40020 insulation resistance U32 Sn ENUM RW 303 Off 308 On Operating mode of the reac tive power regulation 303 Off 1069 Reactive power voltage characteristic curve Q U 1070 Reactive power Q direct default setting 40200 1071 Reactive power U32 Status ENUM RW const 1072 Reactive power Q default setting via plant control 1073 Reactive power 1074 cos Phi direct default setting 44 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables 1075 cos Phi default setting via plant control 1076 cos Phi P character istic curve 1387 Reactive power Q
45. on the Cluster Controller is deactivated the user defined assignments are lost and only the SMA Modbus profile remains active 20 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Configuration i Uploading and downloading XML files For further information on uploading and downloading XML files via the web interface refer to the SMA Cluster Controller user manual Activating user defined Modbus profile You activate a user defined Modbus profile by creating a device entry with the attribute susyid O in the user defined plant file usrplant xml You can find more information on the user defined plant file in the previous Section 5 1 3 Example The following device entry activates a user defined Modbus profile that is entered as the tenth device in the gateway device regoffs 9 susyid 0 serial O unitid 100 gt Deactivating user defined Modbus profile You deactivate a user defined Modbus profile by commenting out in its device line in the user defined plant file usrplant xml and re uploading this to the Cluster Controller Commenting out in XML is structured as follows lt commented gt In the following example you can see a commenting out applied to the line with the customer defined Modbus profile lt lt device regoffs 0 susyid 1 28 serial 8700654300 3 gt gt Example for a customer defined Modbus profile usrprofile xml
46. ormation on Modbus exceptions in the source MBAP page 5 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG SMA Modbus Profile Assignment Tables 7 SMA Modbus Profile Assignment Tables 7 1 Information on the Assignment Tables The following subsections are sorted by Unit ID Each contains a table of the Modbus addresses which can be accessed under the corresponding unit ID This means that SMA device registers are assigned Modbus addresses under a Unit ID The tables display the following information Information ADR Explanation Decimal Modbus address see also Section 6 3 on wards Description return code Brief description of the stored numerical value and the possible return codes CNT Number of utilized Modbus registers see also Section 6 4 onwards Format Format and width of the stored values e g U32 32 bit without sign see also Section 6 1 Display Scalar or status Scalar delivers a directly interpretable numerical value the type of which is specified in the Type column Status delivers one or more code s as specified in the corresponding Description return code column Type The value type of the saved value e g DT date FIX n to n decimal places TEMP temperature see also Section 6 2 Access Access type e g RO read only access If an access type is not supported a Modbus exception will be gener
47. rt TC 09 00 Osaka Sapporo Tokyo TC 13 00 Nuku alofa 05 00 Indiana East 07 00 Arizona TC 10 00 Vladivostok TC 08 00 Perth UTC 01 00 West Central Africa TC 0 1 00 Amsterdam Berlin Bern Rome TC 05 00 Islamabad Karachi 10 00 Guam Port Moresby TC 09 00 Yakutsk TC 04 00 Caucasus Standard Time 06 00 Chicago Dallas Kansas City Winni 06 00 Guadalajara Mexico City Monterrey TC Casablanca TC 07 00 Chihuahua La Paz Mazatlan 03 00 Montevideo TC 05 00 Tashkent 04 00 Georgetown La Paz San Juan Technical Description SMA S 9 7 olar Technology AG Technical Data General Return Codes The following table contains the most commonly used return codes of the registers for SMA devices ij Event numbers The event numbers displayed by the inverters under the Modbus address 30197 are de vice specific For their breakdown please use the documentation of the respective inverter You cannot decode the event numbers using the return codes in this Section Return Meaning code 5 Closed 276 Instantaneous value 295 MPP 303 Off 308 On 309 Operation 311 Open 336 Contact manufacturer 337 Contact electrically qualified person 338 Invalid 381 Stop 455 Warning 461 SMA manvfacturer specifications 973 Not set NaN 1041 Overexcited 1042 Underexcited 1069 Rea
48. s 10 ClusterController MODBUS TD EN 124811 57 Index Network Topology SMA Cluster Controller 11 Number of SMA Devices 49 P Plant Parameters 10 Table ettet es 33 Plant Structure 10 Port pe D 48 UDP p 48 Q Qualification of Skilld Persons 8 R RAW ee Re o e rete aee bee ETE 25 Reaction Time 49 Read Holding Registers 28 Read Input Registers 28 Read out the Gateway Assignment Table ad 15 Read Write Multiple Registers 28 Reading and Writing Modbus Data 28 Reduction of Available Data Register MOdbUS hiis 27 Return Code Description eterne 29 Return Codes Generalziscce edet tvee etes 51 Time Zones eere 49 7 H 7 S 58 ClusterController MODBUS TD EN 124811 SMA Solar Technology AG SEADA en dekad a dan iii 7 Serial 15 Skills of Skilled 5 8 SMA Cluster Controller Network 1 11 SMA Data Types sos SMA SMA Inverters
49. s iere 27 User Defined Modbus Profile 9 usrplant xml iere 17 usrprofile xml essere 19 V Validity RI RR 5 Value Changes Modbus reet 49 virtual modbusprofile 20 Technical Description Index W WIMAX 7 WORD tiii iai i rnit 7 23 Write Multiple 28 Write Single 28 X XML channel nens 20 destination 20 device aee 17 SO NNA eet t verte tty ke 17 SOUICE PD 20 50 ER ses saa 17 eis Aa asse e as 17 20 virtual modbusprofile 20 XML File sysplant 3 itte inen 17 USI plants uu p 17 eme 19 XML Files Default Settings 19 ClusterController MODBUS TD EN 124811 59 SMA Solar Technology www SMA Solar com SMA Solar Technology AG www SMA de SMA Australia Pty Ltd www SMA Australia com au SMA Benelux bvba spri www SMA Benelux com SMA Beijing Commercial Co Ltd www SMA China com cn SMA Central amp Eastern Europe s r o www SMA Czech com SMA France S A S www SMA France com SMA Hellas AE www SMA Hellas com SMA Ib rica Tecnolog a Solar S L www SMA berica com SMA Solar India Pvt Ltd www SMA India com SMA Italia S r l www SMA ltalia com SMA Japan KK www
50. signed consecutively Calculation example What is being searched for is the serial number of device that is saved under the Modbus address 42189 42189 42109 80 4 Modbus registers 20 susyid bbb Defines the SUSy ID serial cccccccccc Defines the serial number unitid ddd Defines the Modbus Unit ID to be used Technical Description ClusterController MODBUS TD EN 12481 1 17 Configuration SMA Solar Technology AG You can download the sysplant xml from the Cluster Controller use it as a template for the file vsrplant xml and adjust it to your needs i Uploading and downloading XML files For further information on uploading and downloading XML files via the web interface refer to the SMA Cluster Controller user manual Activating the usrplant xml To activate your adjustments upload the file usrplant xml to the Cluster Controller For this pur pose the specifications in the file usrplant xml are transferred to the system A modified user plant xml becomes effective a few seconds after saving to the Cluster Controller Deactivating the usrplant xml To deactivate your adjustments upload a usrplant xml that does not contain any tags to the Clus ter Controller Both of the following lines show the structure of such a usrplant xml file lt xml version 1 0 encoding UTF 8 plant version 001 gt lt plant gt Without the device tags in the file
51. tation to ensure proper and optimum use of MODBUS imple mentation in SMA devices Keep this documentation in a convenient place for future reference 2 2 Skills of Skilled Persons The work described in this document must only be performed by skilled persons Skilled persons must have the following skills Knowledge of IP based network protocols e Vocational training for installation and configuration of IT systems Knowledge of and compliance with this document and all the safety precautions Skilled persons must be allowed to modify parameters of connected devices 2 3 Safety Precautions Data Security in Ethernet Networks You can connect the Cluster Controller to the Internet Note that connecting to the Internet carries the risk that unauthorised users can gain access to and manipulate the data or devices in your plant Take suitable protective measures for example Set up a firewall e Close unnecessary network ports e Only enable remote access via VPN tunnel 8 ClusterController MODBUS TD EN124811 Technical Description SMA Solar Technology AG Product Description 3 Product Description 3 1 Modbus Protocol The MODBUS Application Protocol MBAP is an industrial communication protocol that is currently mainly used in the solar sector for plant communication in PV power stations The MODBUS protocol has been developed for reading data from or writing data to clearly de fined data areas The Modbus specification
52. tor e e etur cx 25 G GAT Way citet arti ie 9 10 Table iii A e stus 30 H Hierarchical Plant Structure 10 I Identification ZONES 49 IEC 61131 3155 rtt ee 7 Technical Description Index Industrial Use 2 8 Intended cete 8 Internet eee CERE 8 J Joint Addresses of all SMA Devices Tablet ates 36 M MBAP erred rie eee 6 7 Modbus 2 2 Implementation Master System Reaction Time Read Holding Registers Read Input Read Write Multiple Registers 28 Register eese e reet 27 Specification see 27 TER POL e t 48 UDP POFL EE 48 User ree 27 Value 49 Write Multiple RegiSters 28 Write Single Register 28 Modbus Activation Background Information 13 Modbus Addresses New Order crore etie 19 Modbus Data Reading and Writing 28 Modbus 9 diea ER 9 User Defined 19 Modbus 6 iret e ROS see 7 N NaN 13 Abbreviations annsan 7 ae e ER eR 23 Network Topologie
53. unication ports You should only use free communication ports The following range is generally available 49152 to 65535 You can find additional information on occupied ports under IANA 48 ClusterController MODBUS TD EN 124811 Technical Description SMA Solar Technology AG Technical Data 9 3 Modbus Reaction Time The reaction time is the interval within which changes in value are available in the SMA devices at the Modbus interface of the SMA Cluster Controller Changes in value can therefore only be dis played in your Modbus master system e g in a SCADA system in a corresponding or larger interval The reaction time of the inverters is 5 to 10 seconds 9 4 Interval of the data request and number of the values i Limit of the data processing capacity Due to system stability the time period between data requests via the Modbus protocol should be at least 10 seconds whereupon no more than 30 values should be requested This specification is the upper limit for the SMA devices controlled via the Modbus protocol in accordance with section Number of SMA Devices 9 5 Number of SMA Devices 4 Maximum number of SMA devices A maximum of 75 SMA devices with Modbus capability can be operated on the SMA Cluster Controller 9 6 Return Codes for Time Zones The following table contains a summary of the most important time zones and their numeric codes In the tables in Section SMA Modbus Profile Assignment Tables from p
Download Pdf Manuals
Related Search