Siemens SIMATIC S7-1200 User manual

___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
SIMATIC
S7-1200
SM 1238 Energy Meter 480VAC
(6ES7238-5XA32-0XB0)
Manual
V2.0, 01/2019
A5E37457453
-AB
Preface
Documentation guide
1
Product overview
2
Wiring
3
Configure I/O address space
4
Quick start
5
Reading and processing
measured values
6
Energy counters
7
Operating hours counter
8
Minimum and maximum
values
9
Phase-based measurements
10
Configuration with the TIA
Portal
11
Status LEDs and diagnostic
interrupt alarms
12
Technical specifications
13
Module configuration data
record (DS 128)
A
Measured variables
B
Module version configuration
options
C
Process data variant options
D
Measured value data records
E
Tips and tricks
F
Embedded software license
G
前言

Siemens AG
Division Digital Factory
Postfach 48 48
90026 NÜRNBERG
GERMANY
A5E37457453-AB
Ⓟ
01/2019 Subject to change
Copyright © Siemens AG 2019.
All rights reserved
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.

SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 3
Preface
Purpose of the documentation
This SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0) device manual complements
the system manual for the S7-1200 Programmable controller
(https://support.industry.siemens.com/cs/ww/en/view/107623221). Functions that generally
apply to the PLC system are described in the S7-1200 system manual.
This manual and the system manual provide the technical information necessary to develop
and commission energy metering automation.
Conventions
Please also observe notes marked as follows:
Note
A note contains important information on the product described in the documentation, on the
handling of the product, and identifies parts of the documentation that are important to
understand.
Security information
Siemens provides products and solutions with industrial security functions that support the
secure operation of plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is
necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial
security concept. Siemens’ products and solutions constitute one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. Such systems, machines and components should only be
connected to an enterprise network or the internet if and to the extent such a connection is
necessary and only when appropriate security measures (e.g. firewalls and/or network
segmentation) are in place.
For additional information on industrial security measures that can be implemented, please
visit (https://www.siemens.com/industrialsecurity).
Siemens' products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends that product updates are applied as soon as they are
available and that the latest product versions are used. Use of product versions that are no
longer supported, and failure to apply the latest updates may increase customers' exposure
to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS
Feed visit (https://www.siemens.com/industrialsecurity).

SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
4Manual, V2.0, 01/2019, A5E37457453-AB
Table of contents
Preface ................................................................................................................................................... 3
1 Documentation guide .............................................................................................................................. 8
2 Product overview .................................................................................................................................. 11
2.1 Area of application ................................................................................................................. 11
2.2 Properties of the SM 1238 Energy Meter 480VAC ................................................................ 13
2.3 Firmware updates and S7-1200 CPU version compatibility .................................................. 14
3 Wiring ................................................................................................................................................... 15
3.1 Connecting AC power and the measured load ...................................................................... 15
3.2 Connection examples ............................................................................................................ 19
3.3 Electrical current transformer selection ................................................................................. 22
4 Configure I/O address space................................................................................................................. 25
4.1 TIA Portal project overview .................................................................................................... 25
4.2 Choosing a module version ................................................................................................... 26
4.2.1 Module version options .......................................................................................................... 26
4.2.2 STEP 7 project planning and module versions...................................................................... 29
4.2.3 Changing the Process data variant in RUN mode ................................................................. 30
4.2.4 Recommendations on the choice of a module version.......................................................... 31
5 Quick start ............................................................................................................................................ 32
5.1 Getting measured values quickly........................................................................................... 32
6 Reading and processing measured values ............................................................................................ 34
6.1 Basics for reading measured values...................................................................................... 34
6.2 Quality information ................................................................................................................. 36
6.3 Reading measured values from the user data cyclically ....................................................... 39
6.4 Read measured value from a measured data record ............................................................ 40
7 Energy counters.................................................................................................................................... 41
7.1 How the energy meter works ................................................................................................. 41
7.2 Configuring the energy counters............................................................................................ 44
7.3 Evaluating energy counters and overflow counters ............................................................... 46
7.4 Resetting energy counter and overflow counters .................................................................. 47
7.4.1 Introduction ............................................................................................................................ 47
7.4.2 Resetting energy counters by user data ................................................................................ 47
7.4.3 Resetting energy counters and overflow counters by data set DS 143................................. 49
7.4.4 Example reset of energy counters and overflow counters by data set DS 143..................... 51
7.5 Data record for energy counters (DS 143)............................................................................. 53

Table of contents
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 5
7.5.1 Structure of energy counter data DS 143 ...............................................................................53
7.5.2 Structure of the control and feedback interface DS 143.........................................................59
8 Operating hours counter........................................................................................................................ 61
8.1 How the operating hours counter works .................................................................................61
8.2 Resetting the operating hours counter....................................................................................62
8.2.1 Introduction .............................................................................................................................62
8.2.2 Resetting the operating hours counter by user data...............................................................62
8.2.3 Resetting the operating hours counter by data set DS 143....................................................63
9 Minimum and maximum values ............................................................................................................. 65
9.1 Minimum and maximum values ..............................................................................................65
9.2 Resetting minimum and maximum values ..............................................................................66
10 Phase-based measurements................................................................................................................. 68
10.1 Phase-based measurements..................................................................................................68
11 Configuration with the TIA Portal........................................................................................................... 70
11.1 TIA Portal Device configuration ..............................................................................................70
11.2 General information parameters .............................................................................................71
11.3 Module parameters .................................................................................................................71
11.3.1 AI configuration parameters....................................................................................................71
11.3.1.1 Diagnostics (module scope parameters) ................................................................................71
11.3.1.2 Measurement (module scope parameters).............................................................................71
11.3.2 Process data parameters........................................................................................................74
11.3.2.1 Operating mode ......................................................................................................................74
11.4 AI 3 (AC phase parameters) ...................................................................................................76
11.4.1 Inputs (phase channel parameters) ........................................................................................76
11.4.1.1 Line conductors 1, 2, and 3 parameters .................................................................................76
11.5 I/O addresses..........................................................................................................................80
11.5.1 I/O start addresses, Process image update and PIP partition................................................80
11.5.2 Hardware identifier..................................................................................................................81
12 Status LEDs and diagnostic interrupt alarms ......................................................................................... 82
12.1 Status and error LED display..................................................................................................82
12.2 Diagnostic alarms ...................................................................................................................84
12.3 Diagnostics response..............................................................................................................86
13 Technical specifications ........................................................................................................................ 88
13.1 Technical specifications ..........................................................................................................88
A Module configuration data record (DS 128) ........................................................................................... 93
A.1 Configuration by parameter data record .................................................................................93
A.2 Parameter data record 128.....................................................................................................94
B Measured variables............................................................................................................................. 102
B.1 Measured process variables and connection type ...............................................................102

Table of contents
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
6Manual, V2.0, 01/2019, A5E37457453-AB
C Module version configuration options ...................................................................................................110
C.1 Module version "2 bytes I/ 2 bytes O" .................................................................................. 110
C.2 Module versions that allow run-time change of Siemens defined Process data variants.... 113
C.2.1 Module version "32 I bytes I/ 12 bytes O" ............................................................................ 113
C.2.2 Module version "112 bytes I/ 12 bytes O" ............................................................................ 117
C.3 Module version "EE@Industry measured data profile" E0 / E1 / E2 / E3............................ 122
D Process data variant options ................................................................................................................126
D.1 Overview of Process data variant options ........................................................................... 126
D.2 Total power L1, L2, L3 (W# 16# FE).................................................................................... 128
D.3 Active power L1, L2, L3 (W# 16# FD).................................................................................. 129
D.4 Reactive power L1, L2, L3 (W# 16# FC) ............................................................................. 130
D.5 Apparent power L1, L2, L3 (W# 16# FB) ............................................................................. 131
D.6 Basic measurement values L1, L2, L3 (W# 16# FA) ........................................................... 132
D.7 Total energy L1, L2, L3 (W# 16# F9)................................................................................... 133
D.8 Energy L1 (W# 16# F8)........................................................................................................ 134
D.9 Energy L2 (W# 16# F7)........................................................................................................ 135
D.10 Energy L3 (W# 16# F6)........................................................................................................ 136
D.11 Basic values 3-phase measurement L1, L2, L3 (W# 16# F5) ............................................. 137
D.12 Quality values 3-phase measurement (W# 16# F0) ............................................................ 138
D.13 Energy measurement (periodical) overage meter (W# 16# EF).......................................... 139
D.14 EE@Industry measurement data profile E3 (W# 16# E3) ................................................... 140
D.15 EE@Industry measurement data profile E2 (W# 16# E2) ................................................... 141
D.16 EE@Industry measurement data profile E1 (W# 16# E1) ................................................... 141
D.17 EE@Industry measurement data profile E0 (W# 16# E0) ................................................... 142
D.18 Basic values single phase measurement L1 (W# 16# 9F) .................................................. 142
D.19 Basic values single phase measurement L1a (W# 16# 9E) ................................................ 143
D.20 Basic values single phase measurement L2 (W# 16# 9D).................................................. 144
D.21 Basic values single phase measurement L2a (W# 16# 9C)................................................ 145
D.22 Basic values single phase measurement L3 (W# 16# 9B) .................................................. 146
D.23 Basic values single phase measurement L3a (W# 16# 9A) ................................................ 147
E Measured value data records ...............................................................................................................148
E.1 Overview of all measured data records ............................................................................... 148
E.2 Base measurements data record (DS 142) ......................................................................... 149
E.3 Energy counters data record (DS 143) ................................................................................ 151
E.4 Maximum values data record (DS 144) ............................................................................... 156
E.5 Minimum values data record (DS 145) ................................................................................ 157

Table of contents
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 7
E.6 L1 phase-based values data record (DS 147)......................................................................158
E.7 L2 phase-based values data record (DS 148)......................................................................159
E.8 L3 phase-based values data record (DS 149)......................................................................160
E.9 Advanced measurements and status values (DS 150) ........................................................162
F Tips and tricks..................................................................................................................................... 164
F.1 Tips and tricks.......................................................................................................................164
G Embedded software license ................................................................................................................ 165
G.1 Software license conditions ..................................................................................................165
Index................................................................................................................................................... 168

SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
8Manual, V2.0, 01/2019, A5E37457453-AB
Documentation guide
1
The documentation for the SIMATIC S7-1200 programmable controller is arranged into three
areas.
This arrangement enables you to access the specific content that you need.
Basic information
The S7-1200 system Manual and Getting Started describe in detail the configuration,
installation, wiring, and commissioning of a SIMATIC S7-1200 programmable logic control
system. The TIA portal and STEP 7 online help also support you during configuration and
programming.
Device information
This device manual contains a compact description of the module-specific information, such
as properties, terminal diagrams, characteristics, and technical specifications.
General information
The function manuals contain detailed descriptions on general topics regarding the SIMATIC
S7-1200 system (for example, diagnostics, communication, Motion Control, and Web
server).
You can download the documentation free of charge from the Internet
(https://www.siemens.com/global/en/home/products/automation/systems/industrial.html).
Changes and supplements to the manuals are documented in a Product Information
document.

Documentation guide
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 9
S7-1200 system manual
The system manual contains the documentation of the SIMATIC S7-1200.
You can find the S7-1200 system manual on the Internet
(https://support.industry.siemens.com/cs/ww/en/view/91696622).
"mySupport"
With "mySupport", your personal workspace, you make the most of your Industry Online
Support.
In "mySupport" you can store filters, favorites and tags, request CAx data and put together
your personal library in the Documentation area. Furthermore, your data is automatically
filled into support requests and you always have an overview of your current requests.
You need to register once to use the full functionality of "mySupport".
You can find "mySupport" on the Internet (https://support.industry.siemens.com/My/ww/en).
"mySupport" -Documentation
In the Documentation area of "mySupport", you can combine complete manuals or parts of
them to make your own custom manual.
You can export the manual in PDF format or in an editable format.
You can find "mySupport" - Documentation on the Internet
(https://support.industry.siemens.com/my/WW/en/documentation).
"mySupport" - CAx data
In the CAx Data area of "mySupport", you have access to the latest product data for your
CAx or CAe system.
You configure your own download package with a few clicks.
In doing so you can select:
●Product images, 2D dimension drawings, 3D models, internal circuit diagrams, EPLAN
macro files
●Manuals, characteristics, operating manuals, certificates
●Product master data
You can find "mySupport" - CAx Data on the Internet
(https://support.industry.siemens.com/my/WW/en/CAxOnline).
Application examples
The application examples support you with various tools and examples for solving your
automation tasks. Solutions are shown in interplay with multiple components in the system -
separated from the focus in individual products.
You can find Applications examples on the Internet
(https://support.industry.siemens.com/cs/ww/en/sc/2054).

Documentation guide
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
10 Manual, V2.0, 01/2019, A5E37457453-AB
TIA Selection Tool
With the TIA Selection Tool, you can select, configure and order devices for Totally
Integrated Automation (TIA).
This tool is the successor of the SIMATIC Selection Tool and combines the known
configurators for automation technology into one tool.
With the TIA Selection Tool, you can generate a complete order list from your product
selection or product configuration.
You can find the TIA Selection Tool on the Internet
(http://w3.siemens.com/mcms/topics/en/simatic/tia-selection-tool).
See also
SIMATIC manual overview
(https://www.siemens.com/global/en/home/products/automation/systems/industrial/plc/s7-
1200.html)

SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 11
Product overview
2
2.1 Area of application
Introduction
Energy efficiency is increasingly important to industry. Rising energy prices, increasing
pressure to improve profitability, and the growing awareness of climate protection are
important reasons to reduce energy costs and monitor energy consumption.
Where can you use the SM 1238 Energy Meter 480VAC?
SM 1238 Energy Meter 480VAC is designed for machine-level deployment in a S7-1200
system. The module records over 200 different electrical measurement and energy values. It
lets you measure the energy requirements of individual components of a production plant
down to the machine level.
Using the measured values provided by the SM 1238 Energy Meter 480VAC, you can
determine energy consumption and power demand. You can determine consumption
forecasts and efficiency from the measured values. Power measurements are relevant for
load management and maintenance. In addition, you can use the measurements for energy
reporting and for determining the CO2 footprint.
Note
Measuring dangerous electrical quantities
The SM
1238 Energy Meter 480VAC is not tested according to DIN EN 61010-2-030 and
may therefore not be used to verify, measure or monitor protective measures according to
DIN
EN 61557.
Qualified personnel must ensure through additional measures that no danger ensues for
humans and the environment, if there is an incorrect measurement.

Product overview
2.1 Area of application
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
12 Manual, V2.0, 01/2019, A5E37457453-AB
Measuring with SM 1238 Energy Meter 480VAC
A typical AC power network for a production plant is divided into three voltage ranges:
●The infeed of the entire plant
●The distribution, for example, to individual lines within the plant
●The end electrical loads such as the machines in a production line.
The following figure shows measurement in an electricity supply network:
Figure 2-1 Use of the SM 1238 Energy Meter 480VAC
Advantages of the SM 1238 Energy Meter 480VAC
The SM 1238 Energy Meter 480VAC has the following advantages:
●Space-saving especially for use in a control cabinet
●You can plug in a maximum of eight Energy Meter modules to one S7-1200 PLC
●Expansion of existing I/O to monitor and record power consumption

Product overview
2.2 Properties of the SM 1238 Energy Meter 480VAC
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 13
2.2 Properties of the SM 1238 Energy Meter 480VAC
Article number
6ES7238-5XA32-0XB0
Powering the module
Module revision F-stand 1 modules are powered from the L1 input voltage and require a
minimum of 90 V AC for module operation. Module revision F-stand 2 and higher are
powered from the CPU bus and will operate with an input voltage of 0 V AC on L1.
Properties
The module has the following technical properties:
●Measurement of electrical variables from single-phase, two-phase and three-phase AC
power supply networks
●Maximum nominal voltage between two outer conductors 480 V AC (max. phase voltage
277 V AC)
●Recording of:
–Voltages
–Currents
–Phase angles
–Power (electrical load - active W, reactive var, apparent VA)
–Energy usage counter (electrical work)
–Frequencies
–Minimum and maximum values
–Power factors (ratio of real power/apparent power)
–Operating hours counter
The module supports the following functions:
●Firmware update
●I&M identification data
●Reconfiguration in RUN
●Diagnostics interrupts
Configuration tool
You can configure the module with STEP 7 (TIA Portal) V13 SP1 with Update 8 or higher
and HSP 0151.

Product overview
2.3 Firmware updates and S7-1200 CPU version compatibility
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
14 Manual, V2.0, 01/2019, A5E37457453-AB
Accessories
SM 1238 Energy Meter 480VAC modules are shipped with keyed terminal blocks installed. If
you need additional terminal blocks, a terminal block kit (a special keyed terminal block is
required) must be ordered separately.
You can find additional information on the accessories in the S7-1200 system manual
(https://support.industry.siemens.com/cs/ww/en/view/91696622).
2.3 Firmware updates and S7-1200 CPU version compatibility
The SM 1238 Energy Meter 480VAC module is compatible with S7-1200 CPUs that have
firmware version V4.1 or higher.
SM 1238 Energy Meter 480VAC firmware update via SD card and S7-1200 CPU V4.1 is not
supported.
Supported methods to update SM 1238 Energy Meter 480 VAC firmware
Using S7-1200 CPU V4.1:
●TIA Portal signal module firmware loader
●S7-1200 CPU Webserver firmware loader
●SIMATIC Automation Tool firmware update
Using S7-1200 CPU V4.2 (or higher):
●TIA Portal signal module firmware loader
●S7-1200 CPU Webserver firmware loader
●SIMATIC Automation Tool firmware update
●SD card via S7-1200 CPU card slot loader
Note
For F-Stand 1 modules firmware update process requires power from phase 1
Before starting a firmware update, you
must plug the SM 1238 Energy Meter
480VAC into an
S7
-1200 CPU
and
connect phase 1 (90 V AC minimum) to the Energy meter's UL1 and N
terminals.

SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
Manual, V2.0, 01/2019, A5E37457453-AB 15
Wiring
3
3.1 Connecting AC power and the measured load
General safety instructions
WARNING
Danger to life and dangerous system conditions can occur if the following requirements are
not met
A switch or circuit-breaker must be included in the installation.
The switch or circuit-breaker must be suitably located and easily reached.
The switch or circuit-breaker must be marked as the disconnecting device for the
equipment.
WARNING
Danger to life due to electric shock
Touching live parts can lead to death or severe injuries.
Before beginning any work de-energize the system and the Energy Meter and short-circuit
installed transformers.
WARNING
Danger to life, dangerous system conditions and material damage possible
Removing and inserting the Energy Meter under live voltage is prohibited!
If you remove and insert the Energy Meter under live voltage during operation, the
transformers used can produce dangerous induction voltages and electric arcs and
dangerous system conditions can arise.
The Energy Meter may only be removed and inserted during operation if the measured
voltages applied to the module are disconnected at all phases at the terminals UL1 , UL2,
UL3
and
special electrical current transformer terminals are used that short-circuit the
transformer at the secondary side when removed.
CAUTION
Use only in AC networks
The Energy Meter is destroyed if used with direct voltage / direct current.
Use the Energy Meter solely to measure the electrical characteristics of AC networks.

Wiring
3.1 Connecting AC power and the measured load
SM 1238 Energy Meter 480VAC (6ES7238-5XA32-0XB0)
16 Manual, V2.0, 01/2019, A5E37457453-AB
Supplying the module
For F-Stand 1 modules the module is always supplied via UL1 and N. The required minimum
voltage is 90 VAC.
AC power source grounding systems
The SM 1238 Energy Meter 480VAC works with the following IEC defined grounding
systems.
●TN
●TT
●IT: You must create an artificial N-conductor (for example, by means of a 1:1 voltage
transformer) in IT networks due to the missing neutral conductor. You can then use the
module.
Protecting the connection cables
To protect the connection cables at UL1, UL2 and UL3, make sure there is adequate cable
protection, especially after conductor cross-sectional area transitions.
If short-circuit resistance according to IEC 61439-1:2009 is ensured by the design, there is
no need for separate line protection devices at the power line phase connections.