38.9.4.3 Extended Read of SRAM Backup Data

The Read function reads data in the SRAM backup memory and saves the data as a file.

The saved file format for filing data is saved in a binary format and other files are saved in CSV format.

This enables access to data that cannot be retrieved from backup data by comparing with EasyBackupDataRead().

Function Name

INT WINAPI EasyBackupDataReadEx(LPCSTR sSaveFileName, LPCSTR sNodeName, INT iBackupDataType, INT iSaveMode, INT iNumber = 0, INT iStringTable = 0x0000);

Argument

sSaveFileName: (In) File path of a destination file for read data (Text pointer)

sNodeName: (In) Name of node of the data source to be read
The station name is fixed as #WinGP.

iBackupDataType: (In) Types of read data

Value	Types of data
0x0001	Filing Data
0x0002	Sampling data of sampling group number 1
0x0003	All sampling group data except for sampling group number 1
0x0004	All sampling group data except for sampling group number 1
0x0005	Alarm Block1 Specify the type of alarm using iNumber.
0x0006	Alarm Block2 Specify the type of alarm using iNumber.
0x0007	Alarm Block3 Specify the type of alarm using iNumber.
0x0008	Alarm Block4 Specify the type of alarm using iNumber.
0x0009	Alarm Block5 Specify the type of alarm using iNumber.
0x000A	Alarm Block6 Specify the type of alarm using iNumber.
0x000B	Alarm Block7 Specify the type of alarm using iNumber.
0x000C	Alarm Block8 Specify the type of alarm using iNumber.
0x8002	Sampling group of a specific group number. Define group number with iNumber.

iSaveMode: (In) How to save
0: New (If a file with the same file name exists, the file is deleted and overwritten.)
1: Add (Add data to the end of a file. If there is no file, a new file is created.)
Other than those above: Reserved

iNumber: Enter a value based on the value in iBackupDataType.

A value in iBackupDataType	Description
0x0005 to 0x000C	There are three types of alarm data: Active, History, and Log. Specify the type. 0 Check if the alarm block contains available data based on the following priorities and if data exists, the data becomes a target. (1) Alarm History, (2) Alarm Log, (3) Active Alarms - If none are available, the error occurs. 1 Targets Active Alarms. 2 Targets Alarm History. 3 Targets Alarm Log. If the subjected data type is not in the alarm block specified by iBackupDataType, an error occurs.
0x8002	Group number (1 to 64) of a sampling group to be read
Other than those above	(Reserved)

A value in iBackupDataType

Description

0x0005 to 0x000C

There are three types of alarm data: Active, History, and Log. Specify the type.

Check if the alarm block contains available data based on the following priorities and if data exists, the data becomes a target. (1) Alarm History, (2) Alarm Log, (3) Active Alarms - If none are available, the error occurs.

Targets Active Alarms.

Targets Alarm History.

Targets Alarm Log.

If the subjected data type is not in the alarm block specified by iBackupDataType, an error occurs.

0x8002

Group number (1 to 64) of a sampling group to be read

Other than those above

(Reserved)

iStringTable:(In) Reserved
Always specify 0.

Return value (NULL)

Normal End: 0

Problem: Error code

Special Item

When reading alarm data or sampling data, the date data is handled as "yy/mm/dd."