Professional Documents
Culture Documents
ENGLISH
Legal Provisions
Legal Provisions
Copyright 2014-2015 SMA America, LLC. All rights reserved.
No part of this document may be reproduced, stored in a retrieval system, or transmitted, in any
form or by any means, electronic, mechanical, photographic, magnetic or otherwise, without the
prior written permission of SMA America, LLC.
Neither SMA America, LLC nor SMA Solar Technology Canada Inc. makes representations, express or implied, with respect to this documentation or any of the equipment and/or software it may
describe, including (with no limitation) any implied warranties of utility, merchantability, or fitness
for any particular purpose. All such warranties are expressly disclaimed. Neither SMA America, LLC nor its distributors or dealers nor SMA Solar Technology Canada Inc. nor its distributors or
dealers shall be liable for any indirect, incidental, or consequential damages under any circumstances.
(The exclusion of implied warranties may not apply in all cases under some statutes, and thus the
above exclusion may not apply.)
Specifications are subject to change without notice. Every attempt has been made to make this
document complete, accurate and up-to-date. Readers are cautioned, however, that
SMA America, LLC and SMA Solar Technology Canada Inc. reserve the right to make changes
without notice and shall not be responsible for any damages, including indirect, incidental or consequential damages, caused by reliance on the material presented, including, but not limited to,
omissions, typographical errors, arithmetical errors or listing errors in the content material.
All trademarks are recognized even if these are not marked separately. 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_Modbus-TB-US-en-13
Technical Description
Description
DANGER Indicates a hazardous situation which, if not avoided,
will result in death or serious injury
WARNING Indicates a hazardous situation which, if not avoided,
could result in death or serious injury
CAUTION Indicates a hazardous situation which, if not avoided,
could result in minor or moderate injury
NOTICE Indicates a situation which, if not avoided, could result in
property damage
Technical Description
SMA_Modbus-TB-US-en-13
Table of Contents
Table of Contents
1
2
4
5
2.1
2.2
2.3
2.4
2.5
2.6
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
3.4.1
3.4.2
3.4.3
Troubleshooting .......................................................................................56
SMA_Modbus-TB-US-en-13
Technical Description
Table of Contents
Contact ......................................................................................................63
Technical Description
SMA_Modbus-TB-US-en-13
This document is valid for the device types listed in Section 2.6 "Supported SMA Inverters",
page 11. It describes how the data points of the SMA data model are displayed in the SMA Modbus profile.
This document does not contain any information on the Modbus registers provided in detail by the
SMA inverters and which minimum firmware versions have to be installed on the devices (firmware
version and device-specific Modbus registers, see technical information SMA Modbus Interface).
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", P. 9).
Additional Information
SMA Documents
Additional information is available at www.SMA-Solar.com (not all documents are available in all
languages):
Document title
Document type
Order form
Technical information
Technical information
Installation manual
Installation manual
Sunny Explorer
User manual
SMA_Modbus-TB-US-en-13
Technical Description
Additional Documents
Document title
Source
http://www.modbus.org/specs.php
http://www.modbus.org/specs.php
http://www.iana.org/assignments/service-names-portnumbers/service-names-port-numbers.xml
Symbols
Symbol
Explanation
Information that is important for a specific topic or goal, but is not safetyrelevant.
Typographies
Typography
Use
Example
bold
File names
Parameters
>
[Button/Key]
Select [Save].
Nomenclature
Complete designation
Modbus register
Register
Photovoltaics system
PV system
Technical Description
SMA_Modbus-TB-US-en-13
SMA Inverter
Inverter
Speedwire
Abbreviations
Abbreviation
Designation
Explanation
GFDI
Detection of the grounding error and subsequent interruption of the electric circuit.
MPP
NaN
Not a Number
Power Balancer -
SOH
State Of Health
Speedwire
SUSy ID
WMAX
SMA_Modbus-TB-US-en-13
Technical Description
Safety
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
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.
2.2
The tasks described in this document must be performed by qualified persons only. Qualified persons must have the following skills:
Knowledge of IP-based network protocols
Knowledge of and compliance with this document and all safety precautions
2.3
Safety Precautions
This section contains safety precautions 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 follow all safety precautions at all times.
Damage to SMA inverters
The parameters of the SMA inverters that can be changed with writable Modbus registers
(RW/WO) 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 wish an automated control of your PV plant (see Section 8
"Contact", page 63).
Technical Description
SMA_Modbus-TB-US-en-13
Safety
2.4
2.5
Certain parameters are protected via the SMA Grid Guard code. If you would like to changes
these parameters, you must first unlock the individual inverters via a personal SMA Grid Guard
code. When unlocked, the inverter changes its configuration mode to the Grid Guard mode.
SMA Grid Guard code
You can obtain the SMA Grid Guard code via SMA Service or via the "Order Form for the
SMA Grid Guard Code" at www.SMA-Solar.com (see Section 8 "Contact", page 63).
Further information about logging into a device with the Grid Guard code and Sunny Explorer see user manual of Sunny Explorer.
Parameter overview SMA Grid Guard code
You will find an overview of the parameters that can be changed with an activated SMA
Grid Guard code in Section 5.3 "SMA Modbus Profile Grid Guard Parameters", page
49.
10
SMA_Modbus-TB-US-en-13
Technical Description
Safety
The SMA Grid Guard code as well as the code for logging out of the Grid Guard mode are
described in the Modbus register 43090 under the Unit ID = 3.
Login with the Grid Guard code is only possible with the IP address used during login.
Inverter-restart during Grid Guard mode
If an inverter is restarted during Grid Guard mode, the Grid Guard code must be transmitted
again.
2.6
You will find information on which SMA inverters with integrated Speedwire interface or a retrofitted Speedwire/Webconnect data module are supported by the Modbus interface in the technical
information SMA Modbus Interface at www.SMA-Solar.com. Moreover, this document shows the
minimum firmware versions that have to be installed on the devices.
Technical Description
SMA_Modbus-TB-US-en-13
11
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 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.
3.2
The SMA Modbus profile contains definitions for SMA devices. All available data on SMA devices
was assigned to the corresponding Modbus registers for the definition. Not all SMA inverters
support all data points of the SMA Modbus profile.
Therefore, the device-specific data points available for an SMA inverter are listed in a separate
document (device-specific Modbus register see technical information SMA Modbus Interface at
www.SMA-Solar.com).
3.3
PV System Topology
An SMA device with Speedwire interface is connected with the SCADA system of the electric utility
company or the grid operator via Ethernet. The Speedwire interface also enables communication
via the Modbus protocol.
From the perspective of the Modbus protocol, an SMA device with Speedwire interface constitutes
a Modbus server that supports the SMA Modbus profile.
3.4
3.4.1
Unit IDs
The Unit ID is a higher level addressing type in the Modbus protocol. The SMA Modbus profile is
set to the Unit ID = 3.
12
SMA_Modbus-TB-US-en-13
Technical Description
3.4.2
Product Description
A Modbus register is 16 bits wide. For broader data items, connected Modbus registers are used
and considered as data blocks. The address of the first Modbus register in a data block is the start
address of the data block. The quantity of connected Modbus registers arises from the data type
and the offset between the register addresses. Several Modbus registers with different start addresses that can only be processed as data blocks are specially marked. Larger data blocks can
then be formed.
3.4.3
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.5.
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.
3.5
The Modbus interface can be used via the protocol Modbus TCP and by the protocol Modbus
UDP. Using Modbus TCP enables read- and write access (RW) and using Modbus UDP enables
only write access (WO) to the RW Modbus registers.
The following Modbus commands are supported by the implemented Modbus interface:
Modbus command
Hexadecimal value
0x03
1 to 125
0x04
1 to 125
0x06
0x10
1 to 123
0x17
Technical Description
SMA_Modbus-TB-US-en-13
13
Product Description
3.6
The following table shows the data types used in the SMA Modbus profile and the possible NaN
values. The SMA data types are listed in the Type column of the assignment tables. They describe
the data widths of the assigned values:
Type
Description
NaN value
S16
0x8000
S32
0x8000 0000
STR32
ZERO
U16
A word (16-bit).
0xFFFF
U32
0xFFFF FFFF
U32
For status values, only the lower 24 bits of a double word (32bit) are used.
0xFFFF FD
U64
3.7
The following SMA data formats describe how SMA data is to be interpreted. The data formats are
important, for example, for the display of data or for its further processing. The SMA data formats
are listed in the Format column of the assignment tables.
Format
Explanation
Duration
DT
ENUM
Coded numerical values. The breakdown of the possible codes can be found
directly under the designation of the Modbus register in the SMA Modbus
profile assignment tables.
FIX0
FIX1
FIX2
14
SMA_Modbus-TB-US-en-13
Technical Description
Product Description
FIX3
FUNCTION_SEC
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, all status values are
"not set". A security question must be confirmed prior to execution of the
function.
FW
HW
IP4
RAW
REV
TEMP
TM
UTF8
Technical Description
SMA_Modbus-TB-US-en-13
15
Product Description
3.8
The SMA firmware data format (abbreviation: FW) describes how SMA firmware data is to be
interpreted. The SMA firmware data format is used, for example, in register 30059.
Four values are extracted from the delivered DWORD. The Major and Minor values are contained 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:
Release type Release-type coding
Explanation
No revision number
Experimental release
Alpha release
Beta release
Release
Special release
>5
As number
No special interpretation
Example:
16
SMA_Modbus-TB-US-en-13
1.05.10.R
Major: 1, Minor: 05, Build: 10, Release type: 4
(Hex: 0x1 0x5 0xA 0x4)
Technical Description
All SMA devices with Speedwire interface must be commissioned (see installation manual of
the inverter or of the retrofitted Speedwire installation).
Sunny Explorer must be installed on the computer (Sunny Explorer is available free of
charge at www.SMA-Solar.com).
Access to data points after activation of the Modbus interface
After activation of the Modbus interface accessing all of the data points that are not protected by SMA Grid Guard code is possible without entering a further password via Modbus.
After a reset of the inverter to factory settings please check whether the Modbus interface is
still active.
Procedure:
1.
2.
Start Sunny Explorer on the computer and create a Speedwire PV system (see Sunny Explorer user manual).
Log into the Speedwire PV system as "Installer".
3.
5.
4.
6.
7.
8.
You will see the categories TCP Server and UDP Server under the parameter group
Modbus.
To activate the TCP server, make the following settings in the group Modbus > TCP Server:
If necessary, change the port in the Port field (default setting: 502).
To activate the UDP server, make the following settings in the group Modbus > UDP Server:
If necessary, change the port in the Port field (default setting: 502).
Select [Save].
Technical Description
SMA_Modbus-TB-US-en-13
17
The SMA Modbus profile allocation tables listed in the next Sections provides the following information:
Information
Explanation
ADR (DEC)
Description/Number
Code(s)
Short description of the Modbus register and the number codes used.
Type
Data type, e.g. U32 = 32 bits without prefix (see Section 3.6, page
14).
Format
Access
Access type:
RW: Read and write (only Modbus TCP). All RW registers are only
writeable under Modbus UDP (WO registers).
WO: Write only
The parameters of the SMA inverters that can be changed with writable Modbus registers
(RW/WO) 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 wish an automated control of your PV plant (see Section 8
"Contact", page 63).
18
SMA_Modbus-TB-US-en-13
Technical Description
Technical Description
SMA_Modbus-TB-US-en-13
19
5.2
ADR (DEC)
In the following table you will find all measured values and parameters of the SMA Modbus profile
that you can access without a Grid Guard code.
Type
Format
Access
Description/number code
U32
RAW
RO
30003 SUSy ID
U32
RAW
RO
U32
RAW
RO
U32
RAW
RO
Device class:
8000 = All devices
8001 = PV inverter
8002 = Wind power inverter
30051 8007 = Battery inverter
8033 = Load
8064 = Sensor technology general
8065 = Energy meter
8128 = Communication products
U32
ENUM
RO
30053
U32
ENUM
RO
30055
Manufacturer specification:
461 = SMA
U32
ENUM
RO
U32
RAW
RO
U32
FW
RO
20
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX0
RO
U32
Duration
RO
U32
ENUM
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
Recommended action:
336 = Contact manufacturer
30211 337 = Contact installer
338 = Invalid
887 - No recommended action
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
Technical Description
SMA_Modbus-TB-US-en-13
21
Temperature derating:
302 = No derating
557 = Temperature derating
30219 884 = Not active
1704 = WMAX derating
1705 = Frequency derating
1706 = Derating due to PV current limitation
U32
ENUM
RO
U32
FIX0
RO
U32
ENUM
RO
U32
DT
RO
U32
FIX0
RO
U32
FIX0
RO
U32
ENUM
RO
Grid type:
1433 = 277 V
1434 = 208 V
30237
1435 = 240 V
1436 = 208 V without neutral conductor
1437 = 240 V without neutral conductor
U32
ENUM
RO
U32
FIX0
RO
U32
ENUM
RO
U32
ENUM
RO
30247
22
SMA_Modbus-TB-US-en-13
Technical Description
State of DC switch:
30257 51 = Closed
311 = Open
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
30513
U64
FIX0
RO
30517
U64
FIX0
RO
U64
Duration
RO
U64
Duration
RO
30529
U32
FIX0
RO
30531
U32
FIX0
RO
30533
U32
FIX0
RO
30535
U32
FIX0
RO
30537
U32
FIX0
RO
30539
U32
FIX0
RO
U32
Duration
RO
U32
Duration
RO
U32
Duration
RO
Technical Description
SMA_Modbus-TB-US-en-13
23
U32
Duration
RO
U32
Duration
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
Duration
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
Duration
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
Duration
RO
S32
FIX3
RO
S32
FIX2
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
24
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX3
RO
U32
FIX3
RO
U32
FIX3
RO
U32
FIX3
RO
U32
FIX2
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
U32
FIX2
RO
U32
ENUM
RO
S32
FIX3
RO
U32
FIX0
RO
U32
FIX0
RO
S32
TEMP
RO
U32
FIX2
RO
Technical Description
SMA_Modbus-TB-US-en-13
25
U32
ENUM
RO
U32
FIX2
RO
S32
FIX0
RO
U32
ENUM
RO
S32
FIX0
RO
U32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
U32
FIX0
RO
S32
FIX0
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
26
SMA_Modbus-TB-US-en-13
Technical Description
U32
ENUM
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
30897
U32
FIX0
RO
30899
U32
FIX0
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
U32
FIX2
RO
S32
FIX3
RO
S32
FIX3
RO
S32
FIX3
RO
U32
ENUM
RO
Technical Description
SMA_Modbus-TB-US-en-13
27
Generator status:
303 = Off
1392 = Error
1787 = Initialization
1788 = Ready
1789 = Warm-up
30917 1790 = Synchronize
1791 = Activated
1792 = Re-synchronize
1793 = Generator separation
1794 = Shut-off delay
1795 = Blocked
1796 = Blocked after error
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
28
SMA_Modbus-TB-US-en-13
Technical Description
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
FIX3
RO
S32
FIX0
RO
S32
TEMP
RO
U32
ENUM
RO
S32
FIX3
RO
S32
FIX2
RO
S32
FIX0
RO
S32
FIX3
RO
Technical Description
SMA_Modbus-TB-US-en-13
29
S32
FIX2
RO
S32
FIX0
RO
S32
FIX3
RO
S32
FIX2
RO
S32
FIX0
RO
S32
FIX2
RO
S32
FIX3
RO
S32
FIX3
RO
S32
FIX3
RO
U32
FIX0
RO
S32
FIX3
RO
U32
FIX1
RO
U32
FIX3
RO
U32
FIX3
RO
U32
FIX3
RO
U32
Duration
RO
S32
TEMP
RO
S32
TEMP
RO
U32
FIX2
RO
U32
Duration
RO
U32
Duration
RO
U32
Duration
RO
U32
FIX0
RO
U32
FIX3
RO
U32
Duration
RO
U32
ENUM
RO
UTF8
RO
UTF8
RO
31007
30
SMA_Modbus-TB-US-en-13
STR32
Technical Description
31033
STR32
UTF8
RO
31041
STR32
UTF8
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
31071 Relative battery discharging since the last full charge (%)
U32
FIX0
RO
U32
FIX0
RO
U32
Duration
RO
31073
Technical Description
SMA_Modbus-TB-US-en-13
31
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
31111 Energy fed into the utility grid (current month) (Wh)
U32
FIX0
RO
31113 Energy fed into the utility grid (previous month) (Wh)
U32
FIX0
RO
U32
FIX0
RO
31117 Energy drawn from the utility grid (current month) (Wh)
U32
FIX0
RO
31119 Energy drawn from the utility grid (previous month) (Wh)
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
S32
FIX0
RO
32
SMA_Modbus-TB-US-en-13
Technical Description
S32
FIX0
RO
S32
FIX2
RO
S32
FIX3
RO
S32
FIX0
RO
U32
FIX0
RO
31793
to
String current of strings 1 to 64 (A)
31919
S32
FIX3
RO
31921
to
String current of strings 65 to 96 (A)
31983
S32
FIX3
RO
31985
to
String current of strings 97 to 128 (A)
32047
S32
FIX3
RO
32049
U32
FIX0
RO
32051
U32
FIX2
RO
U32
ENUM
RO
U32
ENUM
RO
Technical Description
SMA_Modbus-TB-US-en-13
33
U32
ENUM
RO
U64
Duration
RO
U64
Duration
RO
U64
Duration
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
U32
FIX0
RO
U32
FIX1
RO
U32
FIX2
RO
U32
FIX2
RO
S32
TEMP
RO
U32
FIX0
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
S32
TEMP
RO
U32
FIX1
RO
U32
FIX1
RO
S32
FIX2
RO
S32
FIX2
RO
34623
34
SMA_Modbus-TB-US-en-13
Technical Description
S32
FIX2
RO
S32
FIX2
RO
S32
FIX2
RO
S32
FIX2
RO
S32
FIX2
RO
S32
FIX2
RO
U32
ENUM
RO
U32
ENUM
RO
U32
ENUM
RO
U64
FIX0
RO
U64
FIX0
RO
U64
FIX0
RO
U32
DT
RW
Reading and setting the time zone (see Section 7.3 "Number
40003
Codes of the Time Zones", page 61).
U32
ENUM
RW
U32
ENUM
RW
Technical Description
SMA_Modbus-TB-US-en-13
35
U32
ENUM
RW
Operating state:
295 = MPP
381 = Stop
40009
443 = Constant voltage
1855 = Stand-alone operation
3128 = Remote control by SMA Service
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
Operating status:
295 = MPP
381 = Stop
1392 = Error
40029 1393 = Waiting for DC start conditions
1467 = Start
1469 = Shut down
1480 = Waiting for electric utility company
2119 = Derating
U32
ENUM
RO
U32
FIX0
RO
U32
TEMP
RW
40011
Acknowledgement:
26 = Acknowledge error
Set language:
777 = German
778 = English
779 = Italian
40013 780 = Spanish
781 = French
782 = Greek
783 = Korean
784 = Czech
36
SMA_Modbus-TB-US-en-13
785 = Portuguese
786 = Dutch
796 = Slovenian
797 = Bulgarian
798 = Polish
799 = Japanese
801 = Thai
804 = Hebrew
Technical Description
Battery type:
1782 = Valve-regulated lead-acid battery (VRLA)
40035 1783 = Flooded lead-acid battery (FLA)
1784 = Nickel/Cadmium (NiCd)
1785 = Lithium-Ion (Li-Ion)
U32
ENUM
RO
U32
FIX0
RO
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
FIX3
RW
U32
FIX3
RW
U32
ENUM
RW
40051
U32
FIX0
RW
40053
U32
FIX0
RW
U32
ENUM
RW
U32
ENUM
RW
U32
FIX0
RW
U32
FIX0
RW
U32
FW
RO
U32
FW
RO
U32
RAW
RO
Grid-forming generator:
1799 = None
40071 1801 = Utility grid
1802 = Utility grid and generator
1803 = Invalid configuration for the PV production meter
U32
ENUM
RW
U32
FIX0
RW
Technical Description
SMA_Modbus-TB-US-en-13
37
U32
ENUM
RW
U32
ENUM
RW
U32
FIX2
RW
U32
FIX3
RW
U32
FIX3
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
40077
U32
FIX2
RW
32
FIX2
RW
32
FIX2
RW
U32
ENUM
RO
38
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX2
RW
40113
U32
FIX2
RW
40115
U32
FIX2
RW
40117
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
40123
U32
FIX2
RW
40125
U32
FIX2
RW
U32
FIX2
RW
U32
Duration
RW
U32
FIX2
RW
U32
ENUM
RW
U32
FIX0
RW
40137
S32
FIX2
RW
40145
S32
FIX2
RW
40147
U32
FIX2
RW
40149
S32
FIX0
RW
U32
ENUM
RW
S32
FIX0
RW
40153
Technical Description
SMA_Modbus-TB-US-en-13
39
U32
ENUM
RW
40159
STR32
IP4
RW
40167
STR32
IP4
RW
40175
STR32
IP4
RW
U32
ENUM
RW
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX0
RO
U32
FIX3
RW
U32
FIX0
RW
U32
FIX0
RW
U32
ENUM
RW
U32
FIX3
RW
U32
FIX3
RW
U32
FIX3
RO
U32
FIX3
RW
40
SMA_Modbus-TB-US-en-13
Technical Description
40488
Voltage at the zero point 2 of the reactive power characteristic curve (%)
U32
FIX3
RW
STR32
UTF8
RO
STR32
IP4
RW
U32
ENUM
RW
U32
FIX0
RW
U32
FIX0
RW
U32
ENUM
RW
U32
ENUM
RW
Type of AC sub-distribution:
302 = None
40531 2609 = Multicluster Box 6
2610 = Multicluster Box 12
2611 = Multicluster Box 36
U32
ENUM
RW
U32
ENUM
RW
Generator request:
40535 1438 = Automatic
1744 = Manual control
U32
ENUM
RW
U32
FIX0
RW
U32
FIX0
RW
U32
TM
RW
U32
TM
RW
Technical Description
SMA_Modbus-TB-US-en-13
41
40545
U32
FIX0
RW
40547
U32
FIX0
RW
U32
ENUM
RW
U32
DT
RW
U32
Duration
RW
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
FIX2
RW
U32
ENUM
RW
40561
42
SMA_Modbus-TB-US-en-13
Technical Description
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
40615
Duration for which the multifunction relay remains activated
and
for timer 1 and 2 (s)
40617
U32
Duration
RW
40619
and
Start date relay control for timer 1 and 2
40621
U32
DT
RW
Technical Description
SMA_Modbus-TB-US-en-13
43
U32
ENUM
RW
U32
DT
RW
U32
Duration
RW
U32
ENUM
RW
STR32
UTF8
RW
U32
ENUM
RW
U32
TM
RW
U32
ENUM
RW
40657
serial numbers of the meters 1 to 3 on the measurement interto
faces 1 to 3
40661
U32
RAW
RW
U32
REV
RO
U32
ENUM
RO
U32
FW
RO
U32
TM
RW
U32
TM
RW
U32
Duration
RW
44
SMA_Modbus-TB-US-en-13
Technical Description
U32
ENUM
RW
U32
FIX3
RW
U32
ENUM
RW
U32
ENUM
RW
40683
U32
FIX0
RW
40685
U32
FIX0
RW
U32
TM
RW
U32
TM
RW
40691
U32
FIX0
RW
40693
U32
FIX0
RW
U32
ENUM
RW
U32
FIX0
RW
U32
Duration
RW
U32
Duration
RW
U32
Duration
RW
U32
FIX0
RW
U32
FIX0
RW
U32
TM
RW
U32
TM
RW
U32
FIX1
RW
S32
TEMP
RW
U32
FIX3
RW
40715
Technical Description
SMA_Modbus-TB-US-en-13
45
40719
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
U32
ENUM
RW
U32
ENUM
RW
U32
FIX2
RW
U32
Duration
RW
U32
Duration
RW
S32
FIX3
RW
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
U32
ENUM
RW
U32
FIX0
RW
46
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX0
RW
U32
FIX3
RW
40757 Battery state of charge threshold for load shedding 1 start (%)
U32
FIX0
RW
40759 Battery state of charge threshold for load shedding 1 stop (%)
U32
FIX0
RW
U32
TM
RW
U32
TM
RW
40765
Battery state of charge limit for load shedding 1 start in additional time period (%)
U32
FIX0
RW
40767
Battery state of charge limit for load shedding 1 stop in additional time period (%)
U32
FIX0
RW
40769 Battery state of charge threshold for load shedding 2 start (%)
U32
FIX0
RW
40771 Battery state of charge threshold for load shedding 2 stop (%)
U32
FIX0
RW
U32
TM
RW
U32
TM
RW
40777
Battery state of charge limit for load shedding 2 start in additional time period (%)
U32
FIX0
RW
40779
Battery state of charge limit for load shedding 2 stop in additional time period (%)
U32
FIX0
RW
40781
S32
TEMP
RW
U32
RAW
RO
U32
RAW
RO
U32
ENUM
RW
U32
REV
RO
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
U32
FIX0
RW
S32
FIX0
RW
Technical Description
SMA_Modbus-TB-US-en-13
47
Determine SOH:
381 = Stop
40803
1467 = Start
3101 = Cancel
U32
ENUM
RW
U32
ENUM
RW
U32
HW
RO
U32
FIX0
RO
U32
FW
RO
U32
RAW
RO
U32
FIX0
RO
U32
FW
RO
U32
HW
RO
U32
FIX0
RO
U32
FW
RO
U32
RAW
RO
U32
FIX0
RO
S32
FIX0
RW
S32
FIX0
RW
S32
FIX1
RW
S32
FIX1
RW
S32
FIX0
RW
S32
FIX0
RW
S32
FIX0
RW
S32
FIX0
RW
S32
FIX0
RW
S32
FIX0
RW
U32
FUNCTION_SEC
RW
48
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX0
RW
5.3
In the following table you will find an overview of the SMA Modbus profile parameters that you
can only change after prior transmission of an SMA Grid Guard code.
SMA Grid Guard code
Technical Description
Access
Format
Description/number code
Type
ADR (DEC)
You will find information on the SMA Grid Guard code in Section 2.5 SMA Grid Guard
Code, page 10.
U32
ENUM
RO
SMA_Modbus-TB-US-en-13
49
U32
ENUM
RO
S32
FIX0
RO
S32
FIX1
RO
S32
FIX2
RO
U32
ENUM
RO
U32
ENUM
RO
U32
FIX0
RO
U32
FIX0
RO
U32
ENUM
RO
50
SMA_Modbus-TB-US-en-13
Technical Description
S32
FIX0
RO
S32
FIX1
RO
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
ENUM
RW
S32
FIX0
RW
S32
FIX1
RW
S32
FIX2
RW
U32
ENUM
RW
Technical Description
SMA_Modbus-TB-US-en-13
51
U32
ENUM
RW
U32
FIX0
RW
U32
FIX0
RW
U32
ENUM
RW
U32
FIX2
RW
U32
FIX2
RW
U32
FIX2
RW
U32
ENUM
RW
U32
FIX2
RW
U32
ENUM
RW
40222
U32
FIX0
RW
40232
U32
FIX0
RW
52
SMA_Modbus-TB-US-en-13
Technical Description
U32
FIX0
RW
U32
FIX0
RW
U32
ENUM
RW
Active power gradient after reset frequency, linear instantaneous power gradient configuration (%)
U32
FIX0
RW
U32
ENUM
RW
40238
40242
U32
FIX2
RW
40248
U32
FIX2
RW
U32
ENUM
RW
S32
FIX0
RW
40254
Upper limit voltage dead band, full dynamic support configuration (%)
U32
FIX0
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX0
RW
40258
Technical Description
SMA_Modbus-TB-US-en-13
53
40282
to
X values 1 to 12 of the characteristic curve 1
40304
S32
FIX3
RW
40306
to
Y values 1 to 12 of the characteristic curve 1
40328
S32
FIX3
RW
40330
to
X values 1 to 12 of the characteristic curve 2
40352
S32
FIX3
RW
40354
to
Y values 1 to 12 of the characteristic curve 2
40376
S32
FIX3
RW
40378
to
X values 1 to 12 of the characteristic curve 3
40400
S32
FIX3
RW
40402
to
Y values 1 to 12 of the characteristic curve 3
40424
S32
FIX3
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
40426
54
SMA_Modbus-TB-US-en-13
Technical Description
40444
U32
FIX0
RW
40446
U32
FIX3
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
U32
FIX0
RW
U32
FIX2
RW
40456
U32
FIX0
RW
40468
U32
FIX0
RW
U32
ENUM
RW
U32
FIX0
RW
S32
FIX0
RW
40476
Cos of the start point, configuration of the cos (P) characteristic curve
S32
FIX2
RW
40478
Cos of the end point, configuration of the cos (P) characteristic curve
S32
FIX2
RW
U32
FIX0
RW
U32
ENUM
RW
U32
FIX1
RW
40490
Reactive power gradient, reactive power-/voltage characteristic curve Q (U) configuration (%)
Technical Description
SMA_Modbus-TB-US-en-13
55
Troubleshooting
6 Troubleshooting
Problem
The correct IP address for the SMA device with Speedwire interface may not be set in the Modbus client.
Corrective measures:
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 firewall may not be set correctly.
Corrective measures:
The SMA device with Speed- It may be that the Modbus server of the SMA device is currently
wire interface does not send a overloaded.
reply within the response time Corrective measures:
specified by the Modbus client.
Extend the response time set in the Modbus client successively by one second respectively.
56
SMA_Modbus-TB-US-en-13
Technical Description
Troubleshooting
A NaN value is returned when You may be trying to read from a Modbus register that is not
reading a Modbus register
supported by the inverter.
(see Section 3.6 "SMA Data
Corrective measures:
Types and NaN Values", page
Contrast and compare the available measured values for
14).
your SMA device with the requested Modbus registers
(see technical information SMA Modbus Interface at
www.SMA-Solar.com").
You may be trying to read a Modbus register that is not defined
in the SMA Modbus profile.
Corrective measures:
Technical Description
SMA_Modbus-TB-US-en-13
57
Troubleshooting
Check the registers at the start address or at the end address of the data block for consistency. May be one of
both registers is not consistent.
You may be trying to write a data block and one of the registers
is not supported by the device.
Corrective measures:
58
SMA_Modbus-TB-US-en-13
Technical Description
Troubleshooting
Corrective measures:
Other errors
Corrective measures:
Technical Description
SMA_Modbus-TB-US-en-13
59
Technical Data
7 Technical Data
7.1
The following table shows the default setting of the supported network protocols:
Network protocol
TCP
502
UDP
502
Use free communication ports
You should only use free communication ports. The following range is generally available:
49152 to 65535.
You can find more information on occupied ports in the database "Service Name and
Transport Protocol Port Number Registry" at http://www.iana.org/assignments/servicenames-port-numbers/service-names-port-numbers.xml.
Changing the communication port
If you change one of the communication ports, you must also change the corresponding
communication port of a connected Modbus client system. Otherwise, the SMA device can
no longer be accessed via the Modbus protocol.
7.2
In this Section, you can find typical data processing and reaction times of the Speedwire Modbus
interface and time details for saving parameters in SMA devices.
Damage to SMA inverters
The parameters of the SMA inverters that can be changed with writable Modbus registers
(RW/WO) are intended for long-term storage of device settings. Cyclical changing of these parameters leads to destruction of the flash memory of the devices.
Contact the SMA Service Line if you wish an automated control of your PV plant (see Section 8
"Contact", page 63).
60
SMA_Modbus-TB-US-en-13
Technical Description
Technical Data
The signal runtime via the SMA device with Speedwire interface is a maximum 100 ms.
The signal runtime is the time required by the SMA device to process incoming Modbus commands.
Data Transfer Interval via the Modbus Protocol
For system stability reasons, the time period between data transfers via the Modbus protocol must
be at least ten seconds. No more than five parameters and measured values should be transmitted
per inverter at the same time.
Reaction Time of the Modbus Interface
The reaction time of the Modbus interface is the time between the arrival of the parameter specifications in the SMA device until the corresponding measured values are provided to the Modbus
interface. Due to this reaction time, parameter specifications can only be displayed via a Modbus
client system (e.g. a SCADA system) at a corresponding or larger interval.
7.3
The following table contains the most important time zones and their number codes in the SMA
Modbus profile. If the location is known, you can determine the numerical key (code) and the time
zone. In the tables in Section 5 "SMA Modbus Profile Assignment Tables", from page 18, with
specification of the time zone, this table is referenced. Please additionally consider local regulations
for daylight saving time.
City/Country
Abu Dhabi, Muscat
Code
9503
Time zone
UTC+04:00
Beirut
Alaska
9501
UTC-09:00
Adelaide
Amman
9513
9542
9546
UTC+02:00
9517
UTC+01:00
9563
UTC-05:00
Brisbane
9525
UTC+10:00
UTC+09:30
UTC+02:00
Brasilia
9578
UTC+01:00
Arizona
9574
UTC-07:00
Asuncion
9594
UTC-04:00
Cairo
Astana, Dhaka
Athens, Bucharest, Istanbul
Atlantic (Canada)
Auckland, Wellington
Azores
Baghdad
Baku
Technical Description
9515
9537
9505
9553
9509
9504
9508
9566
9522
UTC+06:00
UTC+02:00
UTC-04:00
UTC+12:00
UTC-01:00
UTC+03:00
UTC+04:00
UTC+07:00
UTC+08:00
9527
UTC-03:00
9560
UTC+01:00
Buenos Aires
9562
UTC-03:00
9507
UTC+10:00
9511
9564
Casablanca
Central America
9529
9585
9582
9593
9520
9539
SMA_Modbus-TB-US-en-13
UTC+02:00
UTC-01:00
UTC-04:30
UTC+00:00
UTC+04:00
UTC-03:00
UTC-06:00
UTC+05:30
61
Technical Data
9583
UTC-06:00
9587
9506
UTC-07:00
9547
UTC-07:00
Indiana (East)
Islamabad, Karachi
Jerusalem
Kabul
Katmandu
Krasnoyarsk
9534
9531
9591
9535
UTC+09:30
UTC+00:00
UTC+12:00
UTC-04:00
UTC-03:00
9584
UTC-06:00
9580
UTC+10:00
9567
9538
UTC+02:00
UTC-10:00
9532
UTC+02:00
9570
UTC+10:00
9573
9523
9555
9579
9541
9500
9552
9556
9544
9502
UTC-05:00
UTC-12:00
UTC+08:00
UTC-11:00
9588
9561
9524
9572
UTC+13:00
Perth
Petropavlovsk-Kamchatsky
62
SMA_Modbus-TB-US-en-13
9576
9595
Ulan Bator
Vladivostok
West-Central Africa
Windhoek
Yakutsk
Yangon (Rangoon)
Yekaterinburg
Yerevan
9559
9592
9575
9577
9551
9581
9549
9530
9512
UTC+04:00
UTC+03:30
UTC-08:00
UTC+08:00
UTC+10:00
UTC+01:00
UTC+02:00
UTC+09:00
UTC+06:30
UTC+05:00
UTC+04:00
UTC+03:00
Nuku'alofa
9558
9540
UTC+05:00
UTC+03:00
UTC-03:30
Teheran
9533
UTC+08:00
UTC-03:00
9554
9571
Tbilisi
9589
UTC+05:30
UTC+00:00
Newfoundland
Tashkent
9569
UTC+09:00
UTC+02:00
UTC-05:00
9550
Taipei
9568
UTC-06:00
UTC-02:00
9528
Novosibirsk
Sri Jayawardenepura
9543
UTC+03:00
9565
Montevideo
Seoul
9510
UTC+08:00
9536
UTC+01:00
Saskatchewan
UTC-04:00
UTC+07:00
UTC-04:00
Monrovia, Reykjavk
9518
UTC+05:45
9516
9526
UTC+04:30
Manaus
Minsk
UTC+04:00
9557
UTC+02:00
UTC+11:00
9545
9586
Santiago
UTC+05:00
9519
Mid-Atlantic
Port Louis
UTC+06:00
UTC+09:00
UTC-08:00
UTC+08:00
UTC+12:00
Technical Description
Contact
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:
Modbus client software or hardware used
Type of the communication interface between the inverter and the SCADA system
2
3
4
United States/
Estados Unidos
Canada/Canad
Rocklin, CA
Toronto
+1 916 625-08703
toll free for USA, Canada and Puerto Rico / Exento de tasas en EE. UU., Canad y Puerto Rico
international / Internacional
toll free for Canada / gratuit pour le Canada
Technical Description
SMA_Modbus-TB-US-en-13
63