SMA DATA MANAGER L Manual
Technical Information
SMA Modbus® Interface
ennexOS
SMAModbus-ennexOS-TI-en-10 | Version 1.0ENGLISH
Legal Provisions SMA Solar Technology AG
Technical InformationSMAModbus-ennexOS-TI-en-102
Legal Provisions
The information contained in these documents is the property of SMA Solar Technology AG. No part of this document
may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, be it electronic,
mechanical, photographic, magnetic or otherwise, without the prior written permission of 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.
SMA Solar Technology AG makes no representations or warranties, 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 representations or warranties are
expressly disclaimed. Neither SMA Solar Technology AG 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 product improvements and field usage experience may
cause SMA Solar Technology AG to make changes to these specifications without advance notice or per contract
provisions. SMA Solar Technology AG 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.
SMA Solar Technology AG reserves the right to modify the implementation of communication interfaces and protocols
at any time without notifying the user. It is the user’s responsibility to determine whether the downloaded content is up
to date and to comply with it. SMA Solar Technology AG shall not be held liable for any damage as well as any
assumption of consequential costs for customer systems by SMA Solar Technology AG that may result from the user’s
failure to do so.
Software licenses
You will find the software licenses for the installed software modules (open source) on the Internet at www.SMA-
Solar.com.
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.
SMA Solar Technology AG
Sonnenallee 1
34266 Niestetal
Germany
Phone +49 561 9522-0
Fax +49 561 9522 100
www.SMA.de
E-mail: [email protected]
Status: 7/3/2023
Copyright © 2023 SMA Solar Technology AG. All rights reserved.
Table of Contents
SMA Solar Technology AG
Technical Information 3SMAModbus-ennexOS-TI-en-10
Table of Contents
1 Information on this Document..................................................................................................... 4
1.1 Validity.............................................................................................................................................................. 4
1.2 Target Group ................................................................................................................................................... 4
1.3 Content and Structure of this Document......................................................................................................... 4
1.4 Levels of warning messages............................................................................................................................ 4
1.5 Symbols in the Document................................................................................................................................ 5
1.6 Typographical Elements in the Document...................................................................................................... 5
1.7 Additional Information..................................................................................................................................... 5
2 Safety ............................................................................................................................................ 6
2.1 Intended Use.................................................................................................................................................... 6
2.2 IMPORTANT SAFETY INSTRUCTIONS ......................................................................................................... 6
3 Product Overview........................................................................................................................ 8
3.1 Modbus Protocol ............................................................................................................................................. 8
3.2 SMA Modbus Profile....................................................................................................................................... 8
3.3 System Topology ............................................................................................................................................. 8
3.4 Addressing and Data Transmission ................................................................................................................ 8
3.4.1 Unit IDs ............................................................................................................................................................ 8
3.4.2 Register Address, Register Width and Data Block........................................................................................ 8
3.4.3 Data Transmission ........................................................................................................................................... 8
3.4.4 Reading and Writing of Data......................................................................................................................... 9
3.4.5 SMA Data Types and NaN Values............................................................................................................... 10
3.4.6 SMA Data Formats ......................................................................................................................................... 10
3.4.7 SMA Firmware Data Formats......................................................................................................................... 11
3.5 Modbus Ports................................................................................................................................................... 11
3.6 Data Processing and Time Behavior............................................................................................................... 12
3.7 Number codes of time zones.......................................................................................................................... 13
3.8 Frequently Used Number Codes.................................................................................................................... 16
4 Configuration ............................................................................................................................... 19
5 Contact.......................................................................................................................................... 20
1 Information on this Document SMA Solar Technology AG
Technical InformationSMAModbus-ennexOS-TI-en-104
1 Information on this Document
1.1 Validity
This document is valid for:
• EDML-10 (SMADataManager L)
• EDMM-10 (SMADataManagerM)
• EDMM-US-10 (SMA Data Manager M)
• EDMM-10.A (SMA Data Manager M Lite)
1.2 Target Group
The tasks described in this document must only be performed by qualified persons. Qualified persons must have the
following skills:
• Detailed knowledge of the grid management services
• Knowledge of IP-based network protocols
• Knowledge of the Modbus specifications
• Training in the installation and configuration of IT systems
• Knowledge of and compliance with this document and all safety information
1.3 Content and Structure of this Document
This document does not contain any information on the Modbus registers provided by SMA products. Furthermore, no
information on the firmware version to be installed on the respective SMA product is included. Information on firmware
versions and device-specific Modbus registers of SMA products can be found on our product pages or Modbus page
at www.SMA-Solar.com.
This document does not contain any information on software which can communicate with the Modbus interface (see
the software manufacturer's manual).
This document contains a general description of the Modbus interface integrated in SMA products.
This document does not contain any information related to parameters for grid management services (system control
objects). For more information on these parameters, contact the SMA Service.
Illustrations in this document are reduced to the essential information and may deviate from the real product.
1.4 Levels of warning messages
The following levels of warning messages may occur when handling the product.
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, can result in property damage.
1 Information on this Document
SMA Solar Technology AG
Technical Information 5SMAModbus-ennexOS-TI-en-10
1.5 Symbols in the Document
Icon Explanation
Information that is important for a specific topic or goal, but is not safety-relevant
☐
Indicates a requirement for meeting a specific goal
☑
Desired result
Example
1.6 Typographical Elements in the Document
Typographical element Use Example
bold • Messages
• Terminals
• Elements on a user interface
• Elements to be selected
• Elements to be entered
• Connect the insulated conductors
to the terminals X703:1 to
X703:6.
• Enter 10 in the field Minutes.
>• Connects several elements to be
selected
• Go to Settings > Date.
[Button]
[Key]
• Button or key to be clicked on or
pressed down
• Select [Enter].
# • Placeholder for variable components
(e.g., parameter names)
• Parameter WCtlHz.Hz#
1.7 Additional Information
For more information, please go to www.SMA-Solar.com.
Title and information content Type of information
"Direct Marketing Interface" Technical information
"Parameters and Measured Values"
Device-specific overview of all parameters and measured values and their setting
options
Information about the SMA Modbus registers
Technical Information
"SMA GRID GUARD 10.0 - Grid Management Services via Inverter and System
Controller"
Technical Information
Modbus Application Protocol Specification Modbus specification under
https://modbus.org/specs.php
2 Safety SMA Solar Technology AG
Technical InformationSMAModbus-ennexOS-TI-en-106
2 Safety
2.1 Intended Use
The Modbus interface of the SMA products is designed for industrial use and has the following tasks:
• Remote control of grid management services
• Remote-controlled querying of measured values
• Remote-controlled changing of parameters
• Interface for direct marketing
The Modbus interface can only be used via the Modbus TCP protocol.
All components must remain within their permitted operating ranges and their installation requirements at all times.
Use SMA products only in accordance with the information provided in the enclosed documentation and with the
locally applicable laws, regulations, standards and directives. Any other application may cause personal injury or
property damage.
Alterations to the SMA products, e.g., changes or modifications, are only permitted with the express written permission
of SMA Solar Technology AG. Unauthorized alterations will void guarantee and warranty claims and in most cases
terminate the operating license. SMA Solar Technology AG shall not be held liable for any damage caused by such
changes.
Any use of the product other than that described in the Intended Use section does not qualify as appropriate.
The enclosed documentation is an integral part of this product. Keep the documentation in a convenient, dry place for
future reference and observe all instructions contained therein.
This document does not replace any regional, state, provincial, federal or national laws, regulations or standards that
apply to the installation, electrical safety and use of the product. SMA Solar Technology AG assumes no responsibility
for the compliance or non-compliance with such laws or codes in connection with the installation of the product.
2.2 IMPORTANT SAFETY INSTRUCTIONS
Keep the manual for future reference.
This section contains safety information that must be observed at all times when working.
The product has been designed and tested in accordance with international safety requirements. As with all electrical
or electronical devices, some residual risks remain despite careful construction. To prevent personal injury and property
damage and to ensure long-term operation of the product, read this section carefully and observe all safety
information at all times.
NOTICE
Damage of SMA products due to cyclical changing of parameters
The parameters of SMA products that can be changed with writable Modbus registers (RW) are intended for long-
term storage of device settings. Cyclical changing of these parameters leads to destruction of the flash memory of
the SMA products. These parameters are marked with (see Technical Information "Parameters and Measured
Values").
Parameters for grid management services to control and limit the nominal PV system power are an exception. Such
parameters can be changed cyclically. These parameters are marked with (see Technical Information
"Parameters and Measured Values").
• Do not change device parameters cyclically.
• Use the parameters for grid management services for the automated remote control.
• Note the explanation of the symbols (see Technical Information "Parameters and Measured Values").
2 Safety
SMA Solar Technology AG
Technical Information 7SMAModbus-ennexOS-TI-en-10
NOTICE
Manipulation of system data in networks
You can connect the supported SMA products to the Internet. When connected to the Internet, there is a risk that
unauthorized users can access and manipulate the data of your system.
• Set up a firewall.
• Close unnecessary network ports.
• If absolutely necessary, only enable remote access via a virtual private network (VPN).
• Do not use the port forwarding feature. This also applies to the used Modbus ports.
• Disconnect system components from other network components (network segmentation).
Access to data points after activating the Modbus interface
The read-only access to data points is possible after activating the Modbus interface. The write-only access to all
designated data points is possible. All parameter changes are shown on the user interface of the SMA product.
• Ensure that the Modbus interface is still active after resetting the SMA product to default settings.
3 Product Overview SMA Solar Technology AG
Technical InformationSMAModbus-ennexOS-TI-en-108
3 Product Overview
3.1 Modbus Protocol
The Modbus Application Protocol is an industrial communication protocol that is currently used in the solar sector
mainly for PV system communication. 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 device-specific Modbus
profile, a Modbus client (e.g. a SCADA system) can access the data of a Modbus server (e.g. SMA product with
Modbus interface).
The SMAModbus profile and SunSpecModbus profile are used for SMA products.
3.2 SMAModbus Profile
The SMA Modbus profile contains definitions for SMA products. All available data on SMA products was assigned to
the corresponding Modbus registers for the definition. Not all SMA products support all Modbus registers of the
SMAModbus profile.
3.3 System Topology
An SMA product with Modbus interface is connected with the SCADA system of the electric utility company or the grid
operator via Ethernet. The Modbus interface also enables communication via the Modbus protocol. From the
perspective of the Modbus protocol, an SMA product with Modbus interface constitutes a Modbus server that
supports the SMA Modbus profile.
3.4 Addressing and Data Transmission
3.4.1 Unit IDs
The UnitID is a superordinate addressing type in the Modbus protocol.
The following tables shows the Unit IDs supported by this SMA product.
Unit ID Explanation
1 This Unit ID is reserved for information on the SMA product.
2 This unit ID is reserved for the system parameters and measured values.
10+ This unit ID refers to a device connected under unit ID 10 or higher whose data
are assigned to this unit ID.
3.4.2 Register Address, Register Width and Data Block
A Modbus register is 16 bits wide. For wider data items, connected Modbus registers are used and considered as
data blocks. The address of the first Modbus register in a data block is the start address of the data block.
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 function-dependent 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 (see Section3.4.4, page9).
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 Product Overview
SMA Solar Technology AG
Technical Information 9SMAModbus-ennexOS-TI-en-10
3.4.4 Reading and Writing of Data
The Modbus interface can be used via the protocol Modbus TCP. Using Modbus TCP enables read and write access
to the Modbus register. SMA products with Modbus interface use the Modbus TCP as standard.
Access type Explanation
RO (Read-Only) Read only
RW (Read-Write) Read and write
The following Modbus commands are supported by the implemented Modbus interface:
Modbus command Hexadecimal value Data volume (number of
registers)1)
Read Holding Registers 0x03 1 to 125
Read Input Registers 0x04 1 to 125
Write Single Register 0x06 1
Write Multiple Registers 0x10 1 to 123
Read Write Multiple Registers 0x17 Read: 1 to 125, Write: 1 to 121
Error messages on reading or writing individual Modbus registers
If a Modbus register is accessed, which is not contained in a Modbus profile, or if a Modbus command is incorrect, a
Modbus exception is generated. Modbus exceptions are also generated when write access occurs on a read-only
Modbus register or read access occurs on a write-only Modbus register.
Reading or writing of data blocks
To prevent inconsistencies, data blocks of associated Modbus registers or Modbus register ranges must be read or
written consecutively. The 4 bytes of a 64-bit Modbus register must be read, for example, with an operation in a 64-bit
SMA data type (Read Multiple Registers).
Reading multiple Modbus registers as a data block
If a data block is read and if at least one register defined in the Modbus profile can be determined in its data range,
an answer is returned. If this data block also contains Modbus registers that are not defined in the Modbus profile,
NaN is used for the query values in each case. If none of the Modbus registers are defined in the data range of a
data block in the Modbus profile, the query is invalid, and a Modbus exception is generated.
Error message on writing multiple Modbus registers as a data block
If multiple registers are written in the data block (Modbus command 0x10 and 0x17) and an error occurs when
writing, the process continues with the next register in the data block. If some data is dependent on other data, or if
some data is mutually exclusive, the data is only processed if the entire data block is valid. Otherwise the entire data
block is discarded. In the event of an error, a Modbus exception will be generated.
Modbus exceptions
For Modbus exceptions, see "Modbus Application Protocol Specification" at http://www.modbus.org/specs.php.
1) Number of Modbus registers transferable as a data block per command (16 bit)
3 Product Overview SMA Solar Technology AG
Technical InformationSMAModbus-ennexOS-TI-en-1010
3.4.5 SMA Data Types and NaN Values
The following table shows the data types used in the SMA Modbus profile and compares these to possible NaN
values. The SMA data types are listed in the assignment tables in the Type column. The SMA data types describe the
data widths of the assigned values:
Type Explanation NaN value
S16 A signed word (16-bit) 0x8000
S32 A signed double word (32-bit) 0x8000 0000
STR32 32byte data field, in UTF8 format. ZERO
U16 An unsigned word (16-bit) 0xFFFF
U32 An unsigned double word (32-bit) 0xFFFF FFFF
U32 For status values, only the lower 24 bits of a double word (32-bit)
are used.
0xFFFF FD
U64 An unsigned quadruple word (64-bit) 0xFFFF FFFF FFFF
FFFF
3.4.6 SMA Data Formats
The following SMA data formats describe how SMA data is to be interpreted. The data formats are used, 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 Time in seconds, in minutes or in hours, depending on the Modbus register
ENUM
or
TAGLIST
Coded numerical values. The breakdown of the possible codes can be found di-
rectly under the designation of the Modbus register in the assignment tables.
FIX0 Decimal number, commercially rounded, without decimal place.
FIX1 Decimal number, commercially rounded, one decimal place.
FIX2 Decimal number, commercially rounded, two decimal places.
FIX3 Decimal number, commercially rounded, three decimal places.
FIX4 Decimal number, commercially rounded, four decimal places.
FUNCTION_SEC The date saved in the Modbus 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. A security question must be executed in the client software prior to
execution of the function.
FW Firmware version
HW Hardware version (e.g. 24)
IP4 4-byte IP address (IPv4) of the form XXX.XXX.XXX.XXX.
RAW Text or number. A RAW number has no decimal places and no thousand or
other separation indicators.
Other manuals for DATA MANAGER L
2
This manual suits for next models
5
Table of contents
Other SMA Recording Equipment manuals
SMA
SMA BLUETOOTH PIGGY-BACK Installation and operating instructions
SMA
SMA SPEEDWIRE/WEBCONNECT Piggy-Back User manual
SMA
SMA SUNNY BOY STORAGE 3.7-10 User manual
SMA
SMA BLUETOOTH PIGGY-BACK PLUS User manual
SMA
SMA BLUETOOTH PIGGY-BACK User manual
SMA
SMA Webconnect Data Module User manual
SMA
SMA Modbus EDMM-US-10 Manual
