Professional Documents
Culture Documents
Building
Automation
WAGO-I/O-SYSTEM 750
WagoAppDatalogger
Version 1.0.0
2 e!COCKPIT Application Note – WagoAppDatalogger
WAGO-I/O-SYSTEM 750
Hansastraße 27
D-32423 Minden
Email: info@wago.com
Online: http://www.wago.com
Technical Support
Email: support@wago.com
Every conceivable measure has been taken to ensure the accuracy and
completeness of this documentation. However, as errors can never be fully
excluded, we always appreciate any information or suggestions for improving the
documentation.
We wish to point out that the software and hardware names, as well as the
trademarks of companies used and/or mentioned in the present document, are
generally protected by trademark or patent.
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 3
WAGO-I/O-SYSTEM 750 Description
Copyright
This documentation, including all figures and illustrations contained therein, is
subject to copyright protection. Any use of this documentation that infringes upon
the copyright provisions stipulated herein is prohibited. Reproduction, translation,
electronic, photo-technical filing/archiving and any amendments require the
written consent of WAGO Kontakttechnik GmbH & Co. KG, Minden, Germany.
Non-observance will entail the right of claims for damages.
WAGO is a registered trademark of WAGO Verwaltungsgesellschaft mbH.
Number Notation
Table 1: Number Notation
Number System Example Comment
Decimal 100 Normal notation
Hexadecimal 0x64 C notation
Binary '100' In single quotes,
'0110.0100' nibble separated by a period
Font Conventions
Table 2: Font Conventions
Font Type Explanation
italic Names of paths and files are shown in italics, e.g.:
C:\Programs\WAGO-I/O-CHECK
Menu Menu options are shown in bold, e.g.,:
Save
> A “greater than” symbol between two names denotes the selection of
a menu option, e.g.:
File > New
Input Names of input or selection fields are shown in bold, e.g.:
Start of measurement range
“Value” Input or selection values are shown in quotation marks, e.g.:
Enter the value “4 mA” under Start of measurement range.
[Button] Button labels within the dialogs are bold and enclosed in square
brackets, e.g.:
[Input]
[Key] Key labels on the keyboard are shown in bold and enclosed in square
brackets, e.g.:
[F5]
Version 1.0.0
4 e!COCKPIT Application Note – WagoAppDatalogger
Description WAGO-I/O-SYSTEM 750
Symbols
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 5
WAGO-I/O-SYSTEM 750 Description
Legal Principles
Subject to Change
WAGO Kontakttechnik GmbH & Co. KG reserves the right to make any
alterations or modifications that serve the purpose of technical progress. WAGO
Kontakttechnik GmbH & Co. KG owns all rights arising from granting patents or
from the legal protection of utility patents. Third-party products are always
mentioned without any reference to patent rights. Thus, the existence of such
rights cannot be excluded.
Personnel Qualification
The use of the product described in this document is exclusively geared to
specialists having qualifications in PLC programming, electrical specialists or
persons instructed by electrical specialists who are also familiar with the
appropriate current standards.
Moreover, the persons named here must also be familiar with all of the products
cited in this document, along with the operating instructions. They must also be
capable of correctly predicting any hazards which may not arise until the products
are combined.
Limitation of Liability
This documentation describes the use of various hardware and software
components in specific example applications. The components may represent
products or parts of products from different manufacturers. The respective
operating instructions from the manufacturers apply exclusively with regard to
intended and safe use of the products. The manufacturers of the respective
products are solely responsible for the contents of these instructions.
WAGO Kontakttechnik GmbH & Co. KG assumes no liability for the realization
of these concepts.
Version 1.0.0
6 e!COCKPIT Application Note – WagoAppDatalogger
Description WAGO-I/O-SYSTEM 750
Table of Contents
Table of Contents................................................................................................... 6
1 Description .................................................................................................... 7
2 Material Used ............................................................................................... 7
2.1 Required Libraries ..................................................................................... 7
2.2 Devices ...................................................................................................... 7
2.3 Tools .......................................................................................................... 7
3 Structure ....................................................................................................... 8
4 Commissioning and Use .............................................................................. 9
4.1 Variable Declaration ............................................................................... 12
4.2 Important Notes about the Storage Medium ........................................... 12
4.3 Offline Parameterization ......................................................................... 14
4.4 Connection of Function Block ................................................................ 15
4.5 Use and Important Information ............................................................... 16
4.6 Setting the CSV Formats ......................................................................... 17
4.6.1 Standard Format ................................................................................. 17
4.6.2 Econ Format ....................................................................................... 17
4.6.3 Dataplotter Format.............................................................................. 18
4.7 Setting Up the FTP Connection .............................................................. 20
5 Diagnostics .................................................................................................. 21
6 Visualizations.............................................................................................. 22
6.1 Setting Up the Visualizations .................................................................. 22
6.2 Explanations of the Visualizations .......................................................... 25
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 7
WAGO-I/O-SYSTEM 750 Description
1 Description
The WagoAppDatalogger library makes data logging of up to 160 channels
possible. At the desired interval and/or if an event occurs, the measured values of
the channels are written to a CSV file in three different formats. The main element
of the library is the FbDatalogger function block. This executes the required
operations and controls the “Datalogger_Compact” visualization element also
contained in the library.
2 Material Used
2.1 Required Libraries
Library Description
2.2 Devices
Supplier Quantity Designation Item No.
2.3 Tools
Designation Item No.
2759-101/
e!COCKPIT workstation license
1110-2002
Version 1.0.0
8 e!COCKPIT Application Note – WagoAppDatalogger
Structure WAGO-I/O-SYSTEM 750
3 Structure
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 9
WAGO-I/O-SYSTEM 750 Commissioning and Use
The following eight steps are simplified instructions for integrating the function
block in the project. Starting in Section 4.1, some of these steps are described in
detail, and other noteworthy features of the library explained.
Version 1.0.0
10 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
3) Set up the function block connection.
Declaration of the required variables of type FbDatalogger and
typConfigDatalogger
5) Set channel and base settings online via the “typConfigDatalogger” type
structure (alternative: see Sec.4.3).
a. Set the desired CSV format as follows:
1
i. .bDatalogger_type = 1 for default data logger
1
ii. .bDatalogger_type = 2 for the Econ format
1
iii. .bDatalogger_type = 3 for the Dataplotter format: specific to
the “Dataplotter” Web application
A detailed description of the various CSV formats is provided in Sec.
4.6.
b. Channel is ignored by FbDatalogger unless 2.xChannelExists =
“TRUE.”
1
c. .sFilename must end with “.csv.”
1
typConfigParameters
2
typConfigParameters.atypChannelConfig[…]
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 11
WAGO-I/O-SYSTEM 750 Commissioning and Use
1
d. .sPath should be an existing directory (“/media/sd/” corresponds to
the SD card of the 750-820x controller)
Version 1.0.0
12 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
To have the right settings after power failures and reloading the program, it is
recommended that you declare the two following variables as VAR RETAIN
PERSISTENT (see Step 3 above).
The input of the “aValues” function block requires an ARRAY
[1..MAX_CHANNELS] OF REAL as a variable. This variable contains all input
values for the channels to be logged, of which there can be up to 80.
Note The MAX_CHANNELS parameter can be set to a value ≤ 160 via the
library parameter list according to the number of channels used. Advantage:
A smaller global constant results in lower memory requirements and a
shorter internal sequence for the function block. For example, if only
channels 1 to 20 are required, the MAX_CHANNELS parameter can be set
to 20.
The possible paths for the storage medium are listed in the table below according
to the controller used:
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 13
WAGO-I/O-SYSTEM 750 Commissioning and Use
750-88x “s:\”
Due to the limitation on the maximum number of files in the root directory of the
storage medium, the FbDatalogger function block forces a subdirectory called
“CSV_Files” in which the CSV files are stored. If the 1.sPath file path already
contains a subdirectory, it remains unchanged. The 1.sPath file path specified is
adjusted automatically.
Examples:
Table 4: Automatic Adaptation of the Specified Path (Standard and Econ Format)
Specified Path Adapted Path
“/media/sd/logfile.csv” “/media/sd/CSV_Files/logfile.csv”
“/media/sd/Day1/logfile2.csv” “/media/sd/Day1/logfile2.csv”
“s:\Temp.csv” “s:\CSV_Files\Temp.csv”
“s:\Logging\logfile.csv” “s:\Logging\logfile.csv”
“/media/sd/logfile.csv” “/media/sd/CSV_Files/logfile.csv”
“/media/sd/Day1/logfile2.csv” “/media/sd/CSV_Files/Day1/logfile2.csv”
“s:\Temp.csv” “s:\CSV_Files\Temp.csv”
“s:\Logging\logfile.csv” “s:\CSV_Files\Logging\logfile.csv”
Note:
The FbDatalogger function block checks whether a folder with the adapted
1
.sPath file path already exists. If not, the FbDatalogger function block creates
this folder automatically.
Version 1.0.0
14 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
1) Creation of an action via: right-click on program > Add a New Element >
Action > Enter Name > [ST] > [Add]
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 15
WAGO-I/O-SYSTEM 750 Commissioning and Use
Version 1.0.0
16 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
The header of the LOG file in which the channels are named is only created once.
If the number of channels or their names change, a new file must be created to
ensure proper formatting. The same applies to the channel-specific 2.xLogAlarm
option. The header includes an alarm column, which is created only once. If
2
.xLogAlarm changes without a new file being created, the entries move through
the unexpected, added or removed alarm column. It follows that a new file must
be created when there are changes to the 2.xChannelExists, 2.sChannelName and
2
.xLogAlarm channel variables. A new file is created if no file of this name
exists. Consequently, either the old file must be deleted or the file name must be
changed to allow a new file and header to be generated.
The logging operation of the function block can be executed at a fixed time
interval or by means of trigger event. If you set the 1.xCyclicLogging variable to
“TRUE,” writing to the file occurs at the specified interval. The interval factor is
stored in the 1.uiIntervalFactor variable and the associated unit in the 1.bInterval
variable (hours = 1, minutes = 2, seconds = 3). Even during cyclic writing, the
“xEvent” trigger (block input) can be set and can trigger a logging operation if
necessary. It is necessary to ensure that “xEvent” is only set if “xReady” outputs a
“TRUE” to avoid possible complications with an open file. The shortest possible
interval setting is one second. The only time limit for logging via Event is the
“xReady” output. If the intervals for the channels differ, the function block must
be instantiated. Several function blocks writing to one file is not recommended;
therefore, an individual file name should be used for each function block.
If you set 1.xAppendDate to “TRUE,” the controller date is automatically
appended to the file name entered. Because the file name changes daily, a new file
is generated every day.
Pos: 36 /Dokumentation allgemein/Muster/Inbetriebnehmen - Konfigurieren - Parametrieren/Strukturmuster Hauptkapitel "Inbetriebnehmen", Unterkapitel "Konfigurieren" @ 12\mod_1339747405738_6.doc @ 97671 @ @ 4
Pos: 37 /Alle Serien (Allgemeine Module)/Überschriften für alle Serien/Inbetriebnehmen - Konfigurieren - Parametrieren/Parametrieren - Überschrift 2 @ 5\mod_1249376820406_6.doc @ 40252 @ 2 @ 1
Pos: 39 /Dokumentation allgemein/Gliederungselemente/---Seitenwechsel--- @ 3\mod_1221108045078_0.doc @ 21808 @ @
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 17
WAGO-I/O-SYSTEM 750 Commissioning and Use
The CSV file can be opened in Excel via: File > Open… > select the respective
file.
The FbDatalogger function block can create the CSV file in three different
formats.
Figure 11 shows the CSV file format. Channels 1 (Sinus Curve) and 2 (sawtooth)
are expanded with alarm columns. Channel 37 (CH – 37) was paused at the time
of saving, so the associated cells were marked with “OFF.” The column separator
in the CSV file can be adjusted using the 1.sColumnSeparator variable. The
semicolon “;” is used in this format by default. The decimal separator can be
adjusted using the 1.sDecimalSeparator variable. The comma “,” is used by
default.
Compared to the standard format (see Section 4.6.1), the Econ format lacks the
Alarm column. As shown in Figure 12, the unit of each channel is entered once
with the channel name. Channel 4 was paused at the time of saving, so the
corresponding cells were labeled with a space.
The column separator in the CSV file can be adjusted using the
1
.sColumnSeparator variable. The semicolon “;” is used in this format by
Version 1.0.0
18 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
default. The decimal separator can be adjusted using the 1.sDecimalSeparator
variable. The comma “,” is used by default.
If the Econ format is selected, the minimum time interval for the logging
operation is one minute. Then the “Seconds” selection option is no longer
shown in the visualization.
Compared to the standard format (see Section 4.6.1), the Dataplotter format lacks
the alarm column. As shown in Figure 13, the unit of each channel is entered once
with the channel name. Channel 4 was paused at the time of saving, so the
corresponding cells were labeled with a space. The comma “,” is used in this
format as the column separator. The period “.” is used as the decimal separator.
The 1.sColumnSeparator and 1.sDecimalSeparator parameters are ignored in
this format.
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 19
WAGO-I/O-SYSTEM 750 Commissioning and Use
“_dp” is always added to the file name. This prevents any confusion between
different CSV formats in a file (usually due to setting the 1.bDatalogger_type
during the write operation without changing the file name).
Version 1.0.0
20 e!COCKPIT Application Note – WagoAppDatalogger
Commissioning and Use WAGO-I/O-SYSTEM 750
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 21
WAGO-I/O-SYSTEM 750 Diagnostics
5 Diagnostics
Pos: 41 /Dokumentation allgemein/Muster/Diagnose - Service/Strukturmuster Hauptkapitel "Diagnose" @ 12\mod_1339747130109_6.doc @ 97663 @ @ 4
The “xReady” output outputs a “TRUE” provided that no file is open for writing
at the respective time. This output is critical when using the trigger via event
option, because a pulse should only be sent if the previous write operation has
been completed.
The “sStatus” output outputs the status of the function block as a string. If
problems arise during processing of the function block, error messages are output
to the “sStatus” output.
Version 1.0.0
22 e!COCKPIT Application Note – WagoAppDatalogger
Visualizations WAGO-I/O-SYSTEM 750
6 Visualizations
The visualization object contained in the library provides a simple overview of the
current channels and some settings options for ongoing operation. This object is
only for support and makes it possible to change only part of the existing settings
of the function block.
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 23
WAGO-I/O-SYSTEM 750 Visualizations
Open the visualization page created previously. Then open the [Tools] tab on
the right edge of the screen.
Click [WagoAppDatalogger] to view the visualization elements contained in
the library.
In the selection window, select the Datalogger_Compact element and drag
and drop it onto the visualization page.
After you place it there, a dialog opens, which can be closed by clicking the
[Cancel] button.
Version 1.0.0
24 e!COCKPIT Application Note – WagoAppDatalogger
Visualizations WAGO-I/O-SYSTEM 750
3) After the visualization element is placed, it should be linked to the
FbDatalogger function block. To do so, select the visualization element and
open the [Properties] tab.
Elements to be linked are displayed under “Referenced visualizations.” Here
the required variables and blocks (in this case, the FbDatalogger function
block) can be selected with the Input Assistant ([...] button) and assigned to
the configuration interface (see Figure 17).
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 25
WAGO-I/O-SYSTEM 750 Visualizations
1 2 3 4
Channel
overview
5
Version 1.0.0
26 e!COCKPIT Application Note – WagoAppDatalogger
Visualizations WAGO-I/O-SYSTEM 750
4 File Information The storage path and CSV file name can be
adjusted in this section. It is also possible to specify
whether the current date should be appended to the
file name.
Version 1.0.0
e!COCKPIT Application Note – WagoAppDatalogger 27
WAGO-I/O-SYSTEM 750 Visualizations
5 Status bar Besides the current time and storage path of the
CSV file, the status bar indicates the current status
of the cycling logging process (in plain text and
symbolically).
Version 1.0.0
WAGO Kontakttechnik GmbH & Co. KG
PO Box 2880 • D-32385 Minden
Hansastraße 27 • D-32423 Minden
Phone: +49 (0) 571/8 87 – 0
Fax: +49 (0) 571/8 87 – 1 69
Email: info@wago.com
Web: http://www.wago.com