Technical Information: SMA Modbus Interface For Sunny Boy / Sunny Tripower
Technical Information: SMA Modbus Interface For Sunny Boy / Sunny Tripower
Technical Information: SMA Modbus Interface For Sunny Boy / Sunny Tripower
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 Organiza-
tion, Inc.
Table of Contents
1 Information on this Document ................................................................. 5
2 Safety .......................................................................................................... 8
2.1 Intended Use ...............................................................................................................8
2.2 Skills of Qualified Persons .........................................................................................8
2.3 Safety Information ......................................................................................................9
2.4 Information on Data Security ....................................................................................9
2.5 SMA Grid Guard Code ......................................................................................... 10
2.6 Supported SMA Inverters ....................................................................................... 10
6 Troubleshooting .......................................................................................67
7 Technical Data .........................................................................................71
7.1 Modbus Communication Ports............................................................................... 71
7.2 Data Processing and Time Behavior ..................................................................... 72
7.3 Number Codes of the Time Zones ........................................................................ 72
8 Contact ......................................................................................................75
Target Group
This document is intended for qualified persons. Only skilled persons with appropriate qualifications
are allowed to perform the tasks set forth in this document (see Section 2.2 "Skills of Qualified
Persons", page 8).
Additional Information
SMA Documents
Additional information is available at www.SMA-Solar.com (not all documents are available in all
languages):
Order Form for the SMA Grid Guard Code Order Form
Additional Documents
Symbols
Symbol Explanation
Typographies
Typography Application Example
Nomenclature
Complete designation Designation in this document
Abbreviations
Abbreviation Designation Explanation
GFDI Ground-Fault Detection and Detection of the grounding error and subsequent
Interruption interruption of the electric circuit.
MPP Maximum Power Point Peak point of power curve
NaN Not a Number No valid value is available.
GMS Grid management services Grid management services are functions that enable
control of the grid operation to ensure an unlimited
electricity supply at all times.
Power Balancer - The Power Balancer is a function in SMA devices for
controlling three-phase grid feed-in; for example, to
avoid unbalanced loads.
SOH State Of Health State of health of the battery.
Speedwire - Speedwire is a cable-based type of communication
based on the Ethernet standard and an SMA com-
munication protocol. This enables inverter-optimized
10/100 Mbit data transmission between SMA
devices with Speedwire/Webconnect interfaces in PV
systems.
SUSy-ID SMA update system ID Numeric value that identifies a specific SMA device
type, e.g. 128 = STP nn000TL-10.
WMAX Set active power limit The device can generate active power up to this limit.
2 Safety
2.1 Intended Use
The Modbus interface of the supported SMA devices 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 TCP and via UDP. With UDP, no answers are generated.
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.
You can connect the supported SMA devices to the Internet. When connecting to the Inter-
net, 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
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 was 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 device-specific
Modbus profile, a Modbus client (e.g. a SCADA system) can access the data of a Modbus server
(e.g. SMA devices with Modbus interface).
The special Modbus profile for SMA devices is the SMA Modbus profile.
U32 For status values, only the lower 24 bits of a double word (32-bit) are used. 0xFFFF FD
1
Number of Modbus registers transferable as data block per command
Coded numerical values. The breakdown of the possible codes can be found
ENUM directly under the designation of the Modbus register in the SMA Modbus
profile – assignment tables.
The date saved in the register will be transmitted in the event of a change to a
function and starts this. After execution of the function, no status value is set.
FUNCTION_SEC
A security question must be executed in the client software prior to execution
of the function.
FW Firmware version (see Section 3.8, "SMA Firmware Data Format (FW)", 15)
Outline Purchase
Revision number of the form 2.3.4.5.
Agreement
0 N No revision number
1 E Experimental release
2 A Alpha release
3 B Beta release
4 R Release
5 S Special release
>5 As number No special interpretation
Example:
Firmware version of the product: 1.05.10.R
Values from DWORD: Major: 1, Minor: 05, Build: 10, Release type: 4
(Hex: 0x1 0x5 0xA 0x4)
Procedure:
1. Establish a connection to the user interface (see the inverter manual).
2. Log into the user interface as an installer.
3. Select the Device Parameters tab.
4. Select [Edit parameters].
5. Select the parameter group External Communication.
6. To activate the TCP server, make the following settings in the group Modbus > TCP Server:
• In the Activated drop-down list, select the entry Yes.
• If required, change the port in the field Port (default setting: 502).
7. To activate the UDP server, make the following settings in the group
Modbus > UDP Server:
• In the Activated drop-down list, select the entry Yes.
• If required, change the port in the field Port (default setting: 502).
8. Select [Save all].
Procedure:
1. Start Sunny Explorer on the computer and a create Speedwire plant (see Sunny Explorer user
manual).
2. Log into the Speedwire system as Installer.
3. Select the SMA inverter to be configured in the system directory.
4. Select the tab Settings.
5. Select the parameter group External Communication.
6. Select [Edit].
7. To activate the TCP server, make the following settings in the group Modbus > TCP Server:
• In the Activated drop-down list, select the entry Yes.
• If required, change the port in the field Port (default setting: 502).
8. To activate the UDP server, make the following settings in the group Modbus > UDP Server:
• In the Activated drop-down list, select the entry Yes.
• If required, change the port in the field Port (default setting: 502).
9. Select [Save].
Information Explanation
ADR (DEC) Decimal Modbus address (see Section 3.4.3, page 12 onwards).
Description/ Short description of the Modbus register and the number codes used.
number code(s)
Type Data type, e.g. U32 = 32 bits without prefix (see Section 3.6, page 13).
Format Data format of saved value, e.g. DT = date, FIX n = output with n decimal
places, TEMP = output as temperature (see Section 3.7, page 14).
Fallback Fallback settings can be defined for the parameters marked with an X.
A change to the network configuration will only be adopted by the SMA device if each of
the registers 40157, 40159, 40167, 40175 and 40513 are sent. If, for example, you
change the automatic Speedwire configuration with the register 40157 to the value 1130
(no, manual configuration) and would like to change the IP address with the register 40159,
you must change the other three registers within 60 seconds, or reset them to the same
values.
In the following table you will find all the measured values and parameters of the SMA Modbus
Profile to which you have access without Grid Guard code.
ADR (DEC)
Description/Number code
Format
Access
Type
30001 Version number of the SMA Modbus profile U32 RAW RO
30003 SUSy-ID U32 RAW RO
30005 Serial number U32 RAW RO
Modbus data change: Counter value is increased if new data
30007 U32 RAW RO
is available.
Device class:
8000 = All devices
8001 = PV inverter
8002 = Wind power inverter
30051 8007 = battery inverter U32 ENUM RO
8033 = Load
8064 = Sensor technology general
8065 = Energy meter
8128 = Communication products
Numerical identification of the device type (information on
30053 U32 ENUM RO
breakdown see technical information SMA Modbus interface)
Manufacturer specification:
30055 U32 ENUM RO
461 = SMA
30057 Serial number U32 RAW RO
30059 Software package U32 FW RO
Generator status:
303 = Off
1392 = Error
1787 = Initialization
1788 = Ready
1789 = Warm-up
30917 1790 = Synchronize U32 ENUM RO
1791 = Activated
1792 = Re-synchronize
1793 = Generator separation
1794 = Shut-off delay
1795 = Blocked
1796 = Blocked after error
Data transfer rate of network terminal A:
1720 = 10 MBit
30925 U32 ENUM RO
1721 = 100 MBit
1725 = Not connected
Duplex mode of network terminal A:
1725 = Not connected
30927 U32 ENUM RO
1726 = Half-duplex
1727 = Full duplex
Speedwire connection status of network terminal A:
35 = Alarm
30929 307 = Ok U32 ENUM RO
455 = Warning
1725 = Not connected
Data transfer rate of network terminal B:
1720 = 10 MBit
30931 U32 ENUM RO
1721 = 100 MBit
1725 = Not connected
Duplex mode of network terminal B:
1725 = Not connected
30933 U32 ENUM RO
1726 = Half-duplex
1727 = Full duplex
Speedwire connection status of network terminal B:
35 = Alarm
30935 307 = Ok U32 ENUM RO
455 = Warning
1725 = Not connected
40089 Cell charging set voltage for equalization charge (V) U32 FIX2 RW
40091 Cell charging set voltage for float charge (V) U32 FIX2 RW
40097 Voltage monitoring hysteresis, minimum threshold (V) U32 FIX2 RW
40099 Voltage monitoring hysteresis, maximum threshold (V) U32 FIX2 RW
40105 Frequency monitoring hysteresis, minimum threshold (Hz) 32 FIX2 RW
40107 Frequency monitoring hysteresis, maximum threshold (Hz) 32 FIX2 RW
Set country standard:
27 = Special setting
42 = AS4777.3
305 = Stand-alone mode
333 = PPC
343 = RD1663
438 = VDE0126-1-1
560 = EN50438
561 = EN50438-CZ
1013 = Other standard
1199 = PPDS
40109 7510 = VDE-AR-N4105 U32 ENUM RO
7513 = VDE-AR-N4105-MP
7514 = VDE-AR-N4105-HP
7517 = CEI 0-21 internal
7518 = CEI 0-21 external
7522 = NEN-EN50438
7523 = C10/11/2012
7524 = RD1699
7525 = G83/2
7527 = VFR2014
7528 = G59/3
7529 = SI4777_HS131_Pf
40111 Voltage monitoring generator, minimum threshold (V) U32 FIX2 RW
Voltage monitoring generator
40113 U32 FIX2 RW
maximum threshold (V)
Voltage monitoring generator hysteresis, minimum threshold
40115 U32 FIX2 RW
(V)
Voltage monitoring generator hysteresis, maximum threshold
40117 U32 FIX2 RW
(V)
40119 Frequency monitoring generator, minimum threshold (Hz) U32 FIX2 RW
40121 Frequency monitoring generator, maximum threshold (Hz) U32 FIX2 RW
Generator request:
40535 1438 = Automatic U32 ENUM RW
1744 = Manual control
40537 Battery state of charge limit, generator start (%) U32 FIX0 RW
40539 Battery state of charge limit, generator shutdown (%) U32 FIX0 RW
40541 Start time additional time period, generator request U32 TM RW
40543 End time additional time period, generator request U32 TM RW
Battery state of charge limit, generator shutdown in additional
40545 U32 FIX0 RW
time period (%)
Battery state of charge limit, generator start in additional time
40547 U32 FIX0 RW
period (%)
Time-controlled generator operation:
40549 1129 = Yes U32 ENUM RW
1130 = No
40551 Start time for time-controlled generator operation U32 DT RW
40553 Runtime for time-controlled generator operation (s) U32 Duration RW
Repetition cycle of the time-controlled generator operation:
1189 = Daily
40555 U32 ENUM RW
2622 = Once
2623 = Weekly
Generator request in configured charge mode:
303 = Off
40557 1768 = Full charge U32 ENUM RW
1769 = Equalization charge
1736 = Full- and equalization charge
Reaction to digital input of the generator request:
40559 303 = Off U32 ENUM RW
308 = On
Averaging time for load-dependent generator request based
40561 U32 Duration RW
on power (s)
40563 Minimum run time of the generator (s) U32 Duration RW
40565 Minimum idle time of the generator (s) U32 Duration RW
40567 Cool-down time of the generator (s) U32 Duration RW
40569 Idle time after generator error (s) U32 Duration RW
40571 Warm-up time of the generator (s) U32 Duration RW
40573 Nominal generator frequency (Hz) U32 FIX2 RW
TION_SEC
568 = Execute all available functions
FUNC-
40853 1456 = Consumption U32 RW
1581 = Grid feed-in
3127 = Fuel Save meter
40915 Currently set active power limit, in W U32 FIX0 RW
41001 Maximum achievable reactive power in quadrant 1, in var S32 FIX0 RO
41007 Maximum achievable reactive power in quadrant 4, in var S32 FIX0 RO
41009 Minimum achievable cos φ in quadrant 1 S32 FIX3 RO
41015 Minimum achievable cos φ in quadrant 4 S32 FIX3 RO
41131 Minimum voltage Input 1, in V U32 FIX2 RW
41133 Minimum voltage Input 2, in V U32 FIX2 RW
41135 Minimum voltage Input 3, in V U32 FIX2 RW
41155 Start delay Input 1, in s U32 FIX0 RW
41157 Start delay Input 2, in s U32 FIX0 RW
41159 Start delay Input 3, in s U32 FIX0 RW
41171 Set total yield in kWh U32 FIX0 RW
41173 Set total operating time at the grid-connection point, in h U32 Duration RW
Source of the reference measurement for the reactive/active
power control mode
41187 U32 ENUM RW
3053 = SMA Energy Meter
3547 = Inverter
Set active power limit at the grid-connection point, in % of the
41199 U32 FIX0 RW
system's nominal power
41203 Nominal PV system power, in W U32 FIX0 RW
41205 Hardware version of battery management system U32 HW RO
41217 Set active power limit at the grid-connection point, in W U32 FIX0 RW
41219 Reactive power for absent control operating mode U32 ENUM RW
Description/Number code
Format
Access
Type
Operating mode of Power Balancer:
303 = Off
30239 1442 = PhaseGuard U32 ENUM RO
1443 = PowerGuard
1444 = FaultGuard
Operating mode of the reactive power regulation:
303 = Off
1069 = Reactive power/voltage characteristic curve Q(U)
1070 = Reactive power Q, direct spec.
1071 = React. power const. Q, in kvar
1072 = Q specified by PV system control
1073 = Reactive power Q(P)
30825 U32 ENUM RO
1074 = cos φ, direct specific.
1075 = cos φ, specified by PV system control
1076 = cos φ(P) characteristic
1387 = Reactive power Q, specific. via analogue input
1388 =cos φ specific. analog input
1389 = Reactive power/volt. char. Q(U) param.
2899 = Reactive power/voltage param with activation power
30827 Reactive power setpoint (VAr) S32 FIX0 RO
30829 Reactive power setpoint (%) S32 FIX1 RO
30831 Setpoint of cos φ S32 FIX2 RO
Setpoint, excitation type of cos φ:
30833 1041 = Leading U32 ENUM RO
1042 = Lagging
40226 Configuration of the cos φ (P) characteristic curve, cos φ of U32 FIX2 RW
the end point
Test the operating mode "System control" via the Modbus protocol
Using the following Modbus registers, you can check for the SMA device with Speedwire
interface whether the setpoint via system control is activated:
‒ Reactive power (if supported by the device): Read Modbus register 30825. If the value
1072 can be read from this register, the reactive power is specified via system control.
‒ Cos φ (if supported by the device): Read Modbus register 30825. If the value 1075 can
be read from this register, the power factor is specified via system control.
‒ Active power: Read Modbus register 30835. If the value 1079 can be read from this
register, the active power is specified via system control.
Test the operating mode "System control" via the Modbus protocol
Using the following Modbus registers, you can check for the SMA device with Speedwire
interface whether the setpoint via system control is activated:
‒ Reactive power (if supported by the device): Read Modbus register 30825. If the value
1072 can be read from this register, the reactive power is specified via system control.
‒ Cos φ (if supported by the device): Read Modbus register 30825. If the value 1075
can be read from this register, the power factor is specified via system control.
‒ Active power: Read Modbus register 30835. If the value 1079 can be read from this
register, the active power is specified via system control.
Each register of 40236, 40793, 40795, 40797, 40799 and 40801 has to be sent when
adjusting the charge and discharge setpoints in a SMA battery inverter
(i.e. Sunny Boy Storage) If, for example, you only would like to change one of the men-
tioned registers, you must change the other three registers within 60 seconds, or reset them
to the same values.
In the following table you can find the parameters for the grid management services that you can
access:
ADR (DEC)
Fallback
Description/Number code
Format
Access
Type
Reactive power setpoint Q, in % of the maximum
active power (PMAX) of the inverter.
Value range:
40015 S16 FIX0 WO X
-100% to -1% = load
0% = no reactive power
+1% to +100% = generator
Active power setpoint P, in % of the maximum active
power (PMAX) of the inverter.
Value range:
40016 S16 FIX0 WO X
-100% to -1% = load
0% = no active power
+1% to +100% = generator
Quick shut-down of the inverter:
381 = Stop (AC side)
40018 U32 ENUM WO
1467 = Start
1749 = Full stop (AC and DC side)
Direct marketer:
Reactive power setpoint Q, in % of the maximum
active power (PMAX) of the PV plant.
40492 Value range: S16 FIX2 WO
-100.00% to < 0% = load
0% = no reactive power
< 0% to +100.00% = generator
Direct marketer:
Active power setpoint P, in % of the maximum active
power (PMAX) of the PV plant.
40493 Value range: S16 FIX2 WO
-100.00% to < 0% = load
0% = no active power
< 0% to +100.00% = generator
Direct marketer:
40494 Displacement power factor cos (phi): 0.0000 to U16 FIX4 WO
1.0000
Direct marketer:
Excitation type of cos φ:
40495 U32 ENUM WO
1041 = Leading
1042 = Lagging
40793 Minimum battery charging power (W) U32 FIX0 WO
40795 Maximum battery charging power (W) U32 FIX0 WO
40797 Minimum battery discharging power (W) U32 FIX0 WO
40799 Maximum battery discharging power (W) U32 FIX0 WO
40801 Gird transfer power setpoint (W) U32 FIX0 WO
40999 Cos (phi) setpoint in accordance with EEI convention S32 FIX4 WO
Voltage monitoring (for disconnection):
41111 U32 FIX2 WO
Lower minimum threshold as RMS value
Voltage monitoring (for disconnection):
41113 U32 FIX0 WO
Lower minimum threshold as RMS value, tripping time
6 Troubleshooting
Problem Cause and corrective measures
The SMA device with Speed- The necessary Modbus server in the SMA device with Speedwire
wire interface is not available interface may not be enabled.
for the Modbus client. Corrective measures:
• Ensure that the required Modbus server is enabled (see
Section 4 "Commissioning and Configuration", page 16).
The correct IP address for the SMA device with Speedwire inter-
face may not be set in the Modbus client.
Corrective measures:
• Read off the IP address of the SMA device with Speedwire
interface (see router manual).
• Ensure that the correct IP address for the SMA device with
Speedwire interface is set in the Modbus client (see the
Modbus client manufacturer manual).
The SMA device with Speed- The Modbus server of the SMA device may be currently over-
wire interface does not send a loaded.
reply within the response time Corrective measures:
specified by the Modbus client.
• Extend the response time set in the Modbus client succes-
sively by one second respectively.
A NaN value is reported in the You may be trying to read from a Modbus register that is not
Modbus client (see Section 3.6 supported by the inverter.
"SMA Data Types and NaN Corrective measures:
Values", page 13).
• Contrast and compare the available measured values for
your SMA device with the requested Modbus registers
(see technical information SMA Modbus interface at
www.SMA-Solar.com").
Modbus exception 1 "Illegal You may be trying to write to a data block whose target address
Function" is reported in the range has registers that are not writable.
Modbus client. Corrective measures:
• Check whether all registers to be written to are writable.
Modbus exception 2 "Illegal You may be trying to write to a Modbus register that is not de-
Data Address" is reported in fined in the SMA Modbus profile.
the Modbus client. Corrective measures:
• Check the Modbus address to be written to in the Modbus
client for errors.
You may be trying to write to a data block and one of the regis-
ters to be written to are not supported by the device.
Corrective measures:
• Check that the register to be written to is provided by your
SMA device (see Technical Information SMA Modbus In-
terface at www.SMA-Solar.com).
Modbus exception 3 "Illegal You may be trying to write to a data block (Modbus commands
Data Value" is reported in the 0x10 and 0x17) and one of the values has a data type that is
Modbus client. not permitted.
Corrective measures:
• Read off the data type of the register to be written to from
the "Type" column of the corresponding assignment table
and correct it in the Modbus client.
Modbus exception 4 "Slave You may be trying to read or write to a register of a device, but
Device Failure" is reported in are using a unit ID that is not permitted.
the Modbus client. Corrective measures:
• Set the Unit ID = 3 in the Modbus client for the desired
SMA device with Speedwire interface.
7 Technical Data
7.1 Modbus Communication Ports
The following table shows the default setting of the supported network protocols:
SMA Modbus Profile - Register Overview", from page 20, with specification of the time zone, this
table is referenced. In addition, take account of local regulations for summer/winter time.
8 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:
United Arab SMA Middle East LLC India SMA Solar India Pvt. Ltd.
Emirates Abu Dhabi Mumbai
+971 2234 6177 +91 22 61713888
대한민국 SMA Technology Korea Co., Ltd. SMA Solar (Thailand) Co., Ltd.
서울
+82-2-520-2666 +66 2 670 6999
South Africa SMA Solar Technology Argentina SMA South America SPA
South Africa Pty Ltd. Brazil Santiago
Cape Town Chile +562 2820 2101
08600SUNNY (08600 78669) Perú
International:
+27 (0)21 826 0600
Australia SMA Australia Pty. Ltd. Other countries International SMA Service Line
Sydney Niestetal, Germany
Toll free for Australia: 1800 00800 SMA SERVICE
SMA AUS (+800 762 7378423)
(1800 762 287)
International: +61 2 9491 4200
www.SMA-Solar.com