EtherCAT Interface Description

POWER SUPPLIES WITH ETHERCAT INTERFACE

This document gives access to details of data structures and their communication with EtherCAT interfaces built into thefollowing PULS power supplies of the DIMENSION series:•

CP10.241-ETC, 24V, 10A, 240W•

CP20.241-ETC, 24V, 20A, 480W•

CP20.481-ETC, 48V, 10A, 480W

These interfaces come with an ESI-EEPROM which contains the EtherCAT identity with the revision number.
The EtherCAT slave information, also colloquially known as the ESI/XML configuration file for the EtherCAT master, isstored on it.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

1/25

EtherCAT Interface Description

Index
Page
1.
2.
3.

Switching output via EtherCAT ..........................3
Start-up behaviour of the output voltage .........4
Information on grid monitoringon the input side .................................................5
4. Object description and parameterization ..........6
4.1. Restore object ........................................... 6
4.2. Input data ................................................. 7
4.3. Output data .............................................. 84.4. Configuration data................................... 94.5. Configuration data (vendor-specific) ...... 11
4.6. Command object ...................................... 114.7. Information - diagnostic data .................. 12

Page
5.

Appendix .......................................................... 14
5.1. Restoring the delivery state ..................... 14
5.2. Display of errors and warning messages . 16
5.3. Setting the warning thresholds
for the warning bit ................................... 175.4. Selecting the info data ............................. 18
5.5. JSON .......................................................... 21
5.6. Resetting individual counters andmaximum/minimum values....................... 24

Terminology and Abreviations
PE andsymbolPE is the abbreviation for Protective Earth and has the same meaning as the symbol.

Earth, Ground

This document uses the term “earth” which is the same as the U.S. term “ground”.

t.b.d.

To be defined, value or description will follow later.

AC 230 V

A figure displayed with the AC or DC before the value represents a nominal voltage withstandard tolerances (usually ±15 %) included.
E.g.: DC 12 V describes a 12 V battery disregarding whether it is full (13.7 V) or flat (10 V)

230 Vac

A figure with the unit (Vac) at the end is a momentary figure without any additional
tolerances included.

50 Hz vs. 60 Hz

As long as not otherwise stated, AC 230 V parameters are valid at 50 Hz mains frequency.

may

A key word indicating flexibility of choice with no implied preference.

shall

A key word indicating a mandatory requirement.

shouldA key word indicating flexibility of choice with a strongly preferred implementation.




CoE
DUT
PDO
FoE
OP
ADS
PLC

Action step
Positive result
Negative result
CAN over Ethernet
Data Unit Types (user-specific data types)
Process Data Objects
File Access over EtherCAT
Operational / Normal Mode
Automation Device Specification
Programmable Logic Controller

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

2/25

EtherCAT Interface Description

1. Switching output via EtherCAT
Switching the outputs when the system is at a standstill or in the event of an error via "Disable
output"The output voltage of the device can be disabled via "Disable output". In the event of a system standstill or
fault, the power supply and corresponding downstream system components can be switched off and on
again via TwinCAT in a targeted and location-independent manner.

1.

Enable the PDO 0x1600 "PSU Outputs" via the "Process data" tab.
 "Disable output" is displayed in the tree structure.
The power supply output can be disabled via the "Disable output" bit.

2.

Restarting the EtherCAT system or reloading the configuration in Config mode (F4) restarts the EtherCAT
communication and the process data is transferred.

3.

If the "Disable output" bit is set to TRUE, the DC output voltage of the device is switched off.
 The output remains disabled as long as "Disable output" = TRUE.
 The voltage at the output returns when the "Disable output" bit is disabled again.

Fig. 1-1 Enabling "Disable Output" via the Process Data tab using the CP20.241-ETC as an example

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

3/25

EtherCAT Interface Description

2. Start-up behaviour of the output voltage
Change the behaviour of the output voltage at startup via index 0x8001:41 "Default Start Up
Output State"•This function only takes effect if the device is completely de-energised on both the primary andsecondary sides and the internal capacitors are discharged.

•

If the input voltage is only interrupted for a short time, this function does not take effect. Due to theinternal capacitance, the internal auxiliary voltage can remain on for several seconds, depending on theload situation. The EtherCAT interface can also continue to communicate actively during this time. If the
input voltage returns during this time without a loss of communication, the last known state of theoutput is retained.

When delivered, the device is parameterized so that the output voltage is applied directly when the input voltage isswitched on.
1.

Behaviour at start (see fig. 2-1 “AC Power on”)•
The behaviour of the output voltage at startup can be changed via the CoE object 0x8001:41 ("Default Start Up
Output State").
•0x8001:41 = 0 "Enable Output” (Default)•
0x8001:41 = 1 "Disable Output"
If the bit is set to "Disable Output", the output voltage is not switched on directly after switching on.

2.

Behaviour after reaching the OP state (see Fig. 2-1 “Stage change to OP”).
As soon as the EtherCAT devices state changes to OP, this setting becomes ineffective and is taken over by theprocess data bit "Disable output" (0x1600:01).
•
This is not mapped in the standard configuration, which means that the device switches on the output voltage
after reaching the OP state.
•
If the device is not to switch on the voltage even after reaching the OP state, the "Disable output" PDO(0x1600:01) must be mapped and must be set to "TRUE" before reaching the OP state.

Fig. 2-1: Start-up behaviour dependent on CoE 0x8001:41 and 0x1600

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

4/25

EtherCAT Interface Description

3. Information on grid monitoring on the input side
Using the measurement data recorded on the input side in object 0xFA14 it is possible to monitor the mains voltage
over a longer period of time. Creeping changes and quality problems can thus be detected at an early stage andprevented with suitable measures before they become a problem for the power supply or other connected devices.
RMS input voltage
The AC input voltage is determined with an effective power measurement. In the nominal voltage range of 85 - 264
Vac, an average value is calculated over 10 mains periods.
Undervoltages and overvoltages
A supply voltage that is too low or too high at the input can be detected using the CPxxx-ETC power supplies.
The devices themselves are largely protected against voltage fluctuations within the nominal voltage range, as thewide-range input 100 - 240 Vac (-15%, +10%) in the device ensures that the 24 Vdc (CPxx.241-ETC) / 48 Vdc (CPxx.481ETC) output remains stable even in the event of major deviations in the supply voltage.
The undervoltage range begins when the voltage falls below 75 Vac and is exited again when it exceeds 85 Vac.
A hysteresis of 10 Vac is stored here. There are two measuring principles within the undervoltage range:•from 0 - 65 Vac: effective power measurement over ½ mains period•

from 65 - 75 Vac: effective power measurement over 1 mains period

The overvoltage range begins when 274 Vac is exceeded and is exited again when the value falls below 264 Vac.
A hysteresis of 10 Vac is stored here.
Peak voltages are measured up to a level of 700 V.
Rapid overvoltages and transients
Rapid overvoltages and transients are also detected by the CPxxx-ETC power supplies. For example, the VDE-0160 pulse
and surge pulses from 750 V are detected.
Measuring times of the effective power measurement as a function of the input voltage

Input voltage
range
Undervoltage

Measuring principle:
1< 65 Vac

Effective power measurement over ½ mains period

265 - 75 Vac

Effective power measurement over 1 mains period

Nominal voltage

3

85 - 264 Vac

Effective power measurement, averaging over 10 mains periods

Overvoltage

4< 274 Vac

Effective power measurement over 1 mains period, transient detection

Device-specific transmission times of typically 3 ms and the set cycle time are added to the measuring times.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

5/25

EtherCAT Interface Description

4. Object description and parameterization
The CoE overview contains objects for different intended applications:•Objects required for parameterization during commissioning:oRestore Object Index 0x1011, (see chapter 4.1)oConfiguration data index 0x80n0, (see chapter 4.4)•

Objects intended for regular operation, e.g. through ADS access•Profile-specific objects:oConfiguration data (vendor-specific) index 0x80nF, (see chapter 4.6)oInput data Index 0x60n0, (see chapter 4.2)oInformation and diagnostic data, (see chapter 4.7) Index 0xF000, 0xF008, 0xA000, 0xF914, 0xFA14

4.1. Restore object
Index
(hex)

Name

Meaning

Data
type

Flags Default

1011:0

Restore default
parameters(see chapter 5.1)

Restore default parameters

UINT8

RO

0x01 (1dec)

1011:01

SubIndex 001

If this object is set to “0x64616F6C” in the set value
dialog, all backup objects are reset to their delivery
state.

UINT32RW

0x00000000 (0dec)

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

6/25

EtherCAT Interface Description

4.2. Input data
Index 6000 PSU Inputs
Index
(hex)

Name

6000:0PSU Inputs

6000:01

Warning

Meaning

Data type

Flags

Default

UINT8

RO

0x16 (22dec)

BOOLEANRO

0x00 (0dec)

Becomes TRUE and results in the output voltage
BOOLEAN
being switched off if one of the following conditions
applies:RO

0x00 (0dec)

Is set if one of the following conditions applies:• The output voltage (0x6000:11) falls below the DC
OK threshold (0x8000:16)• The output voltage (0x6000:11) exceeds theovervoltage threshold (0x8000:14)• The output current (0x6000:12) exceeds theovercurrent threshold (0x8000:15)• The internal device temperature (0xFA14:1B)
exceeds the internal temperature threshold(0xF814:11)• The input voltage "Actual RMS input voltage"(0xFA14:19) falls below the minimum value of thenominal input voltage• The device has been disconnected from the power
supply• If the warning bit = 1, the cause of the warning
can be viewed in the Diag History or via the
TwinCAT EventLogger (see chapter 5.2)

6000:02

Error• Device-specific overvoltage protection active. The
output voltage has exceeded the maximum
permissible value (see CPxxx-ETC datasheets
chapter “Safety and Protection Features”).
• Device-specific overcurrent protection active. The
device was switched off due to the hiccup mode
The error bit is an image of the on/off behavior of
the hiccup mode (see CPxxx-ETC datasheets
chapter “Output”).
• Device-specific overtemperature protection active.
The internal device temperature has exceeded the
maximum permissible value (130°C).
• If the error bit = 1, the cause of the error can beviewed in the Diag History or via the TwinCAT
EventLogger (see chapter 5.2).
6000:04

DC OK

The output voltage (0x6000:11) falls below the DC OK BOOLEAN
threshold (0x8000:16)

RO

0x00 (0dec)

6000:11Output voltage

Current output voltage in V
Accuracy: typ. ±0.2% FSV (full scale value, typ. 0 to
65 V)

REAL32

RO

0x00000000(0dec)

6000:12Output current

Current output current in A
Accuracy: typ. ±0.2% FSV (full scale value, typ. 0 to
65 A)

REAL32

RO

0x00000000(0dec)

6000:15

Info data 1

Synchronous information (selection via subindex
0x8001:19)

UINT16

RO

0x0000 (0dec)

6000:16

Info data 2

Synchronous information (selection via subindex
0x8001:21)

UINT16

RO

0x0000 (0dec)

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

7/25

EtherCAT Interface Description

Index F614 PSU Inputs
Index
(hex)

Name

F614:0PSU Inputs

F614:03

Input
undervoltage

Meaning

The input voltage "Actual RMS input voltage"(0xFA14:19) falls below the minimum value of thenominal input voltage.

Data type

Flags

Default

UINT8

RO

0x03 (3dec)

BOOLEANRO

0x00 (0dec)

Data type

Flags

Default

UINT8

RO

0x10 (16dec)

BOOLEANRO

0x00 (0dec)

4.3. Output data
Index 7000 PSU Outputs
Index
(hex)
7000:0Name

7000:01

Disable output

Meaning

PSU Outputs
Switch off output voltage

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

8/25

EtherCAT Interface Description

4.4. Configuration data
Index 8000 PSU Settings
Index
(hex)
8000:0Name

8000:14

Overvoltage warn
threshold

Meaning

PSU Settings
Adjustable overvoltage warning threshold(see chapter 5.3)

Data type

Flags

Default

UINT8

RO

0x16 (22dec)

REAL32RW

CP10.241-ETC from 0.0 V to 30.0 V

0x41E66666(1105618534dec)

CP20.241-ETC from 0.0 V to 30.0 V

0x41E66666(1105618534dec)

CP20.481-ETC from 0.0 V to 60.0 V

0x41400000(1094713344dec)

Default value: 1.2 * Nominal Voltage(0x800F:15(See chapter 4.5)
Hysteresis: 0.5 V
If the output voltage (0x6000:11 (see chapter
4.2) exceeds this value, the warning bit(0x6000:01) is set in the input process data.
8000:15

Overcurrent warn
threshold

Adjustable overcurrent warning threshold(see chapter 5.3)
from 0.0 A to 4 * Nominal current (0x800F:16).

REAL32RW

CP10.241-ETC

0x41400000(1094713344dec)

CP20.241-ETC

0x41C00000(1103101952dec)

CP20.481-ETC

0x41400000(1094713344dec)

Default value: 1.2 * Nominal Current(0x800F:16) Hysteresis: 0.5 A
If the output current (0x6000:12) exceeds thisvalue, the warning bit (0x6000:01) is set in the
input process data.
8000:16

DC OK threshold

Adjustable DC OK threshold (see CPxxx-ETC
datasheets chapter “DC OK Function”)

REAL32RW

CP10.241-ETC from 3.0 V to 30.0 V

0x41B00000(1102053376dec)

CP20.241-ETC from 3.0 V to 30.0 V

0x41B00000(1102053376dec)

CP20.481-ETC from 3.0 V to 60.0 V

0x42300000(1110441984dec)

Default value: 0.917 * Nominal Voltage(0x800F:15) Hysteresis: 0.5 V
If the output voltage (0x6000:11) falls below thisvalue, the warning bit (0x6000:01) is set in the
input process data

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

9/25

EtherCAT Interface Description

Index 8001 PSU Features
Index
(hex)

Name

8001:0PSU Features

8001:01

Parallel use

8001:19

Select info data 1

Meaning

Data type

Flags

Default

UINT8

RO

0x21 (33dec)

Must be set if several power supplies are connected BOOLEAN
in parallel (see CPxxx-ETC datasheets chapter“Parallel use to increase ouptut power” and“Parallel use for redundancy”).

RW

0x00 (0dec)

This object can be used to select which value is tobe displayed in the Info Data 1 object (0x6000:15)(see chapter 5.4).
permitted values:

UINT8

RW

0x00 (0dec)

UINT8

RW

0x00 (0dec)

UINT8

RW

0x00 (0dec)

Data type

Flags

Default

UINT8

RO

0x11 (17dec)

Adjustable warning threshold for overtemperature REAL32
from -40°C to +130°C
Default value: +120°C
Hysteresis: 2°C

RW

0x42F00000(1123024896dec)• 0: Min. input voltage in 0.1 V (0xFA14:11)• 1: Input undervoltage counter (0xFA14:12)• 2: Max. input voltage in 0.1 V (0xFA14:13)• 4: Max. peak input voltage in 0.1 V(0xFA14:15)• 5: Input overvoltage counter (0xFA14:16)• 6: Max. output voltage in 0.1 V (0xA000:11)• 7: Max. output current in 0.01 A (0xA000:12)• 8: Min. temperature in 0.1°C (0xFA14:17)• 9: Max. temperature in 0.1°C (0xFA14:18)• 10: Actual RMS input voltage in 0.1 V(0xFA14:19)
8001:21

Select info data 28001:41

Default Start Up
Output State• 14: Actual temperature in 0.1°C (0xFA14:18)
This object can be used to select which value is tobe displayed in the Info Data 2 object (0x6000:16)(see chapter 5.4).
permitted values:
see subindex 0x8001:19
This object can be used to change the start-up
behavior (see chapter 2)
0: Enable Output (Default)
1: Disable Output

Index F814 PSU Settings
Index
(hex)

Name

F814:0PSU Settings

F814:11

Overtemperaturewarn threshold

Meaning

If the internal device temperature (0xFA14:1B)
exceeds this value, the warning bit (0x6000:01) is
set in the input process data.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

10/25

EtherCAT Interface Description

4.5. Configuration data (vendor-specific)
Index 800F PSU Vendor data
Index
(hex)
800F:0Name

800F:15

Nominal voltage

800F:16

Nominal current

Meaning

Data type

Flags

Default

UINT8

RO

0x16 (22dec)

Output-side nominal voltage of the device in V,
cannot be changed.

REAL32

RO

0x00 (0dec)

Output-side nominal current of the device in A,
cannot be changed.

REAL32

RO

0x00 (0dec)

Meaning

Data type

Flags

Default

UINT8

RO

0x03 (3dec)

OCTETSTRING[2]

RW

{0}

RO

0x00 (0dec)

RO

{0}

PSU Vendor data

4.6. Command object
Index FB00 PSU Command
Index
(hex)

Name

FB00:0PSU Command

FB00:01

RequestA write access to this object executes thecorresponding command.
0x7001: Reset all counters and min. and max. values
in the "PSU Diag Data" 0xA000 and 0xFA14
0x7002: Reset all events from the [JSON file](see chapter 5.5)

FB00:02

Status0: last command completed, no errors, no response UINT8
data
1: last command completed, no errors, response
data available
2: last command completed, error, no response data
3: last command completed, error, response data
available
4-99: reserved for future use
100-200: indicates how much of the command was
executed (in %, 100 = 0%, 200 = 100%)
201-254: reserved for future use
255: command is executed (if the percentage
display is not supported)

FB00:03

Response

Byte 0: see SubIndex 2
Byte 1: unused
2-n: Service response data

OCTETSTRING[6]Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

11/25

EtherCAT Interface Description

4.7. Information - diagnostic data
Index A000 PSU Diag data
Index
(hex)
A000:0Name

A000:11Max. output voltage

Meaning

PSU Diag data
• Maximum output voltage in V.

Data type

Flags

Default

UINT8

RO

0x20 (32dec)

REAL32RW

0x00000000(0dec)

REAL32RW

0x00000000(0dec)• The value for the maximum output voltage isupdated again if the old value is exceeded.
• Is reset to the current value by writing any
value.
• Is retained beyond one PowerCycle.
A000:12Max. output current

Maximum output current in A.
• The value for the maximum output current is
updated again if the old value is exceeded.
• Is reset to the current value by writing any
value.
• Is retained beyond one PowerCycle.

A000:13

Actual output
voltage

Value of the current output voltage in V
Accuracy: typ. ±0.2% FSV (full scale value,
typ. 0 to 65 V)

REAL32

RO

0x00000000(0dec)

A000:14

Actual output
current

Value of the current output current in A
Accuracy: typ. ±0.2% FSV (full scale value,
typ. 0 to 65 A)

REAL32

RO

0x00000000(0dec)

Meaning

Data type

Flags

Default

UINT8

RO

0x14 (20dec)

Index F914 PSU Info data
Index
(hex)

Name

F914:0PSU Info data

F914:12

Operating time

Total operating time of the device in s(cannot be reset)

UINT32

RO

0x00000000(0dec)

F914:13

UptimeOperating time since last AC-side switch-on process UINT32
in s (cannot be reset)RO

0x00000000(0dec)

F914:14

Turn on counter

Total number of AC-side turn-on operations of thepower supply during the complete operating time(cannot be reset)

UINT32

RO

0x00000000(0dec)

Meaning

Data type

Flags

Default

UINT8

RO

0x14 (20dec)

UINT32RW

0x00000000(0dec)UINT16RW

0x0000 (0dec)

Index FA14 PSU Diag data
Index
(hex)

Name

FA14:0PSU Diag data

FA14:11

Min. input voltage

Minimum RMS input voltage in VRMS. The value isupdated again if it falls below the old value.
The input voltage averaged over 10 mains periods isused as the reference value.
Undervoltages due to a grid disconnection are nottaken into account.

FA14:12

Input undervoltage
counterNumber of undervoltage events of the RMS input
voltage.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

12/25

EtherCAT Interface Description

FA14:13Max. input voltage

Maximum RMS input voltage in VRMS. The value isupdated again if the old value is exceeded.

UINT32RW

0x00000000(0dec)The input voltage averaged over 10 mains periods isused as the reference value.
FA14:15

Max. peak input
voltage

Maximum peak input voltage from 0 V to 700 V.
The value is updated again if the old value is
exceeded.

REAL32RW

0x00000000(0dec)

FA14:16

Input overvoltage
counterNumber of overvoltage events of the RMS input
voltage.

UINT16RW

0x0000 (0dec)

The counter for the input overvoltages is also
increased if fast input voltage transients such as the
VDE 0160 pulse or a surge pulse (EN 61000-4-5)
occur.
FA14:17

Min. temperature

Minimum internal device temperature in °C. The
value for the minimum device temperature is
updated again if it falls below the old value.

REAL32RW

0x00000000(0dec)

FA14:18

Max. temperature

Maximum internal device temperature in °C. The
value for the maximum device temperature is
updated again if the old value is exceeded.

REAL32RW

0x00000000(0dec)

FA14:19

Actual RMS input
voltage

RMS value of the current input voltage in VRMS.
Accuracy: typ. ±0.7% FSV (typ. 0 to 700 V)

REAL32

RO

0x00000000(0dec)

FA14:1B

Actual temperature

Value of the current internal device temperature in REAL32°C. Accuracy: typ ±1°C

RO

0x00000000(0dec)

Flags

Default

All values of object 0xFA14 with flag: "RW"
• are retained beyond one PowerCycle,• can be reset with any value via write access (counter to 0, all other values to the current value)(see chapter 5.6)

Index F000 Modular Device profile
Index
(hex)
F000:0Name

Meaning

Data type

Modular Device
ProfileGeneral information for the Modular Device Profile UINT8

RO

0x02 (2dec)

F000:01

Index distanceIndex distance of the objects of the individual UINT16
channelsRO

0x0010 (16dec)

F000:02

Maximum number of Number of channels
modulesRO

0x0001 (1dec)

UINT16

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

13/25

EtherCAT Interface Description

5. Appendix
5.1. Restoring the delivery state
To restore the delivery state (factory settings) of CoE objects for EtherCAT devices (“slaves”), the CoE object Restore
default parameters, SubIndex 001 can be used via EtherCAT master (e.g. TwinCAT) (see Fig. 5.1-1).

Fig. 5.1-1: Selecting the restore default parameters PDO

Fig. 5.1-2: Entering a restore value in the Set Value dialog

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

14/25

EtherCAT Interface Description

Double-click on SubIndex 001 to enter the Set Value dialog. Enter the reset value 1684107116 in field Dec or the value
0x64616F6C in field Hex (ASCII: “load”) and confirm with OK (see Fig. 5.1-2).

• All changeable entries in the slave are reset to the default values.
• The values can only be successfully restored if the reset is directly applied to the online CoE, i.e. to the slave.
No values can be changed in the offline CoE.

• TwinCAT must be in the RUN or CONFIG/Freerun state for this; that means EtherCAT data exchange takes place.
Ensure error-free EtherCAT transmission.

• No separate confirmation takes place due to the reset. A changeable object can be manipulated beforehand forthe purposes of checking.

All backup objects are reset to the delivery state.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

15/25

EtherCAT Interface Description

5.2. Display of errors and warning messages
Diag History If a warning or error state is present and the warning or error bit has been set, the detailed warning or
error messages can be read in the "Diag History" tab of the power supply

Fig. 5.2-1: Diag History tab with warning messages

TwinCAT EventLogger
Alternatively, warnings and error messages are also displayed in the TwinCAT EventLogger.
Open the TwinCAT EventLogger via the "View" menu and select "Other Windows" -> TwinCAT Logged Events.

Fig. 5.2-2: Open TwinCAT EventLogger

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

16/25

EtherCAT Interface Description

5.3. Setting the warning thresholds for the warning bit
Adjustable warnings
The adjustable warning thresholds can be used to set application-specific limits above which an overvoltage,
overcurrent or too low voltage is to be detected at the output and a warning of too high a temperature in
the device is to be issued. The warnings can thus be individually adapted to the system.
While the warning bit (0x6000:01 see chapter 4.2) only indicates the warning state, the detailed warning
messages can be read in the TwinCAT EventLogger and the Diag History.
Please note that if the absolute, device-specific overvoltage, overcurrent and overtemperature limits are
exceeded, the power supply switches to error mode (0x6000:02 see chapter 4.2).
The warning thresholds are set in the CoE Online tab under 0x8000 (see chapter 4.4) and 0xF814 (see chapter 4.2)
"PSU Settings":
Index

Name

0x8000:14

Overvoltage warn threshold

0x8000:15

Overcurrent warn threshold

0x8000:16

DC OK threshold

0xF814:11

Overtemperature warn threshold

Fig. 5.3-1: Set values for warning thresholds e.g. 0x8000:14 "Overvoltage warn threshold" using the CP20.241-ETC as an
example1. Double-click on the corresponding warning threshold. The "Set Value Dialog" dialog box opens.

2. Enter the corresponding threshold value under "Float" and close the dialog box with "OK".

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

17/25

EtherCAT Interface Description

5.4. Selecting the info data
Updating the info data objects
In addition to the process data transmitted by default, some variables from the "PSU Diag Data" objects canbe displayed via the two info data objects "Info data 1" "0x6000:15" and "Info data 2" and then linked to
PLC variables.
Note that although the info data is transmitted on every process data cycle, it typically contains new values
only every 52 ms.
The info data is selected in two steps:
1.

In the "Process data" tab of the power supply, select the Predefined PDO Assignment "Standard + Synchron info
data".

Fig. 5.4-1: Selection of process data set "Standard + Synchron info data" in the Process Data tab using the CP20.241-ETC
as an example
Select the info data via the CoE-Online tab under object 0x8001 (see chapter 4.4).

 Double-click on the object 0x8001:19 "Select Info data 1" or 0x8001:21 "Select Info data 2"
 The "Set Value Dialog" dialog box opens Select the desired entry from the drop-down menu under "Enum" (see following tables).
The following sizes from "PSU Diag Data" can be selected Close the dialog box with "OK"

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

18/25

EtherCAT Interface Description

Fig. 5.4-2: Select info data under "PSU Features" using CP20.241-ETC as an example
The following entries of the "PSU Diag Data" can be selected in the objects 0x8001:19 and 0x8001:21:
Information on the input side
Enum (Dec) in index 0x8001:19 or 0x8001:21

Index "PSU Diag data"

Min. input voltage (0)0xFA14:11

Input undervoltage count (1)0xFA14:12

Max. input voltage (2)0xFA14:13

Max. peak input voltage (4)0xFA14:14

Input overvoltage counter (5)0xFA14:16

Actual RMS input voltage (10)0xFA14:19

Information on the output side
Enum (Dec) in index 0x8001:19 or 0x8001:21

Index "PSU Diag data"

Max. output voltage (6)0xA000:11

Max. output current (7)0xA000:12

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

19/25

EtherCAT Interface Description

Temperature information
Enum (Dec) in index 0x8001:19 or 0x8001:21

Index "PSU Diag data"

Min. temperature (8)0xFA14:17

Max. temperature (9)0xFA14:18

Actual temperature (14)0xFA14:1B

Differentiation between counters, current values and maximum/minimum values
The entries of the "PSU Diag Data" are divided into values, counters and maximum/minimum values.
Objects that contain counters or maximum/minimum values can be reset if required (see chapter 5.6)

Using info data for network and system monitoring
With the variables recorded as process data by default and the additional info data, both the operating stateof the system and network monitoring can be realised on the input side. Details on the data recorded on the
input side can be found in chapter 3 "Information on grid monitoring on the input side”.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

20/25

EtherCAT Interface Description

5.5. JSON
The power supplies of the CP10 and CP20 series with EtherCAT interface have the option of retrieving a log file in theform of a JSON document. This contains, for example, the currently set threshold values, minimum and maximum
voltages and currents that have occurred, as well as an error history. The file also contains static product properties
such as the nominal current, nominal voltage, product name and a unique serial number.
The error history contains up to ten undervoltage, overvoltage, overcurrent and overtemperature events. The value ofthe over/underrun and the time of occurrence are stored for each event.
Exemplary representation of the JSON file.

{"Product": "CP20.481-ETC","BIC": "1P551049SBTNasdfghjk1KPS2001-4810-1001"NominalCurrent": 20.000000,

Q1

52SP12345678","NominalVoltage": 24.000000,"MinInputVoltage": 228.000000,"MaxInputVoltage": 240.000000,"MaxPeakInputVoltage": 340.000000,"InputUndervoltageCounter": 0,"InputOvervoltageCounter": 0,"MaxOutputVoltage": 28.531250,"MaxOutputCurrent": 0.062500,"MinTemperature": 18.656250,"MaxTemperature": 30.156250,"DcOkThreshold": 23.000000,"OvervoltageWarnThreshold": 28.799999,"OvercurrentWarnThreshold": 24.000000,"OvertemperatureWarnThreshold": 120.000000,"UndervoltageEvents":[{"Value": 22.386719,"DcTimestamp": 695747772293000000,

}

]

}

"Time": "2022-01-17T15:16:12"

Reading the JSON log file
The file can be read via a FoE upload

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

21/25

EtherCAT Interface Description

Fig. 5.5-1: Reading the JSON log file using the CP20.241-ETC as an example• In the following dialog, enter "Logfile.json" as the file name and press "Save".
• Confirm the following dialog "Edit FoE Name" with "OK".
Update the time for the JSON file
The power supply has no information on the current local time. For this reason, the time of the events is always
displayed as 0 by default.
The CoE object 0x10F9:01 can be used to inform the EtherCAT slave of the current time. The time of this object
corresponds to the notation for 64-bit EtherCAT timestamps.
Theoretically, it is sufficient to transfer the current time once after switching on. The internal clock of the power supply
unit is set and continues to run automatically. However, to ensure that the time of the master and the power supply
unit do not drift apart, a regular update is recommended. (e.g. every minute).

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

22/25

EtherCAT Interface Description

Fig. 5.5-2: Sample code for writing the time every minute
PLC library:Tc3_JsonXml
With the aid of the PLC library Tc3_JsonXml, SAX and DOM parser technologies can be used to create and navigate
through JSON and XML documents.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

23/25

EtherCAT Interface Description

5.6. Resetting individual counters and maximum/minimum values
Resetting individual counters and maximum/minimum values is possible in the "CoE-Online" tab under the two "PSU
Diag Data" objects (0xA000, 0xFA14)

Fig. 5.6-1: Reset e.g. 0xA000:11 "Max. output voltage" using the CP20.241-ETC as an example

1. Double-click on the counter or maximum/minimum value that you want to reset. The "Set Value
Dialog" dialog box opens

2. With a write access (e.g. with the value 0), which you confirm with "OK", the corresponding counter is reset to 0,
 all other values have the current value after resetting.
No writing of 0xA000, 0xFA14 with certain values
Only resetting the values is possible via write access.
It is not possible to write specific values to the counters or maximum/minimum values.
• Regardless of the value entered, due to the write access the value of counters is always reset to zero, all other values have the current value after resetting.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

24/25

EtherCAT Interface Description

Resetting all counters and maximum/minimum values
Resetting all counters to 0 and minimum/maximum values to the current values is possible in the "CoEOnline" tab via
the "PSU Command" object (0xFB00):

Fig. 5.6-2: Reset all counters and maximum/minimum values via 0xFB00:01

1. Double-click on the object 0xFB00:01. The "Set Value Dialog" dialog box opens
2. Enter the desired value under "Hex". The following values can be specified: 0x7001: Reset all min./max. values in the objects 0xA000 and 0xFA14
 0x7002: Delete exceeded threshold values from the JSON log
3. Confirm with "OK".
 In the "PSU Diag Data", all counters are set to zero, maximum/minimum values have the current values or Threshold value violations are deleted from the JSON log.

Apr. 2024 / Rev 1.0 EtherCAT Interface Description
www.pulspower.com Phone +49 89 9278 0Germany

25/25