Mitsubishi Electric MELSEC iQ-R Series User manual

MELSEC iQ-R File Operation Function Block
Reference

1
SAFETY PRECAUTIONS
(Read these precautions before using this product.)
Before using this product, please read this manual and the relevant manuals carefully and pay full attention to safety to handle
the product correctly.
The precautions given in this manual are concerned with this product only. For the safety precautions of the programmable
controller system, refer to the MELSEC iQ-R Module Configuration Manual.
In this manual, the safety precautions are classified into two levels: " WARNING" and " CAUTION".
Under some circumstances, failure to observe the precautions given under " CAUTION" may lead to serious
consequences.
Observe the precautions of both levels because they are important for personal and system safety.
Make sure that the end users read this manual and then keep the manual in a safe place for future reference.
WARNING Indicates that incorrect handling may cause hazardous conditions, resulting in
death or severe injury.
CAUTION Indicates that incorrect handling may cause hazardous conditions, resulting in
minor or moderate injury or property damage.

2
CONDITIONS OF USE FOR THE PRODUCT
INTRODUCTION
Thank you for purchasing the Mitsubishi Electric MELSEC iQ-R series programmable controllers.
Before using the products, please read this manual and the relevant manuals carefully and develop familiarity with the
functions and performance of the MELSEC iQ-R series programmable controller to handle the products correctly.
Please make sure that the end users read this manual.
(1) MELSEC programmable controller ("the PRODUCT") shall be used in conditions;
i) where any problem, fault or failure occurring in the PRODUCT, if any, shall not lead to any major or serious accident;
and
ii) where the backup and fail-safe function are systematically or automatically provided outside of the PRODUCT for the
case of any problem, fault or failure occurring in the PRODUCT.
(2) The PRODUCT has been designed and manufactured for the purpose of being used in general industries.
MITSUBISHI ELECTRIC SHALL HAVE NO RESPONSIBILITY OR LIABILITY (INCLUDING, BUT NOT LIMITED TO
ANY AND ALL RESPONSIBILITY OR LIABILITY BASED ON CONTRACT, WARRANTY, TORT, PRODUCT
LIABILITY) FOR ANY INJURY OR DEATH TO PERSONS OR LOSS OR DAMAGE TO PROPERTY CAUSED BY the
PRODUCT THAT ARE OPERATED OR USED IN APPLICATION NOT INTENDED OR EXCLUDED BY
INSTRUCTIONS, PRECAUTIONS, OR WARNING CONTAINED IN MITSUBISHI ELECTRIC USER'S, INSTRUCTION
AND/OR SAFETY MANUALS, TECHNICAL BULLETINS AND GUIDELINES FOR the PRODUCT.
("Prohibited Application")
Prohibited Applications include, but not limited to, the use of the PRODUCT in;
• Nuclear Power Plants and any other power plants operated by Power companies, and/or any other cases in which the
public could be affected if any problem or fault occurs in the PRODUCT.
• Railway companies or Public service purposes, and/or any other cases in which establishment of a special quality
assurance system is required by the Purchaser or End User.
• Aircraft or Aerospace, Medical applications, Train equipment, transport equipment such as Elevator and Escalator,
Incineration and Fuel devices, Vehicles, Manned transportation, Equipment for Recreation and Amusement, and
Safety devices, handling of Nuclear or Hazardous Materials or Chemicals, Mining and Drilling, and/or other
applications where there is a significant risk of injury to the public or property.
Notwithstanding the above restrictions, Mitsubishi Electric may in its sole discretion, authorize use of the PRODUCT in
one or more of the Prohibited Applications, provided that the usage of the PRODUCT is limited only for the specific
applications agreed to by Mitsubishi Electric and provided further that no special quality assurance or fail-safe,
redundant or other safety features which exceed the general specifications of the PRODUCTs are required. For details,
please contact the Mitsubishi Electric representative in your region.
(3) Mitsubishi Electric shall have no responsibility or liability for any problems involving programmable controller trouble and
system trouble caused by DoS attacks, unauthorized access, computer viruses, and other cyberattacks.

3
CONTENTS
CONTENTS
SAFETY PRECAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
CONDITIONS OF USE FOR THE PRODUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
RELEVANT MANUALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
TERMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
GENERIC TERMS AND ABBREVIATIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
CHAPTER 1 OVERVIEW 6
1.1 FB List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2 How to Obtain the FB Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3 System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CHAPTER 2 FILE OPERATION FB 8
2.1 M+FileOperation_SaveLoggingCSV_W_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Labels to use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
FB details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Performance value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Error code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
APPENDIX 16
Appendix 1 CSV File Output Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
INSTRUCTION INDEX 18
REVISIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
TRADEMARKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

4
RELEVANT MANUALS
e-Manual refers to the Mitsubishi Electric FA electronic book manuals that can be browsed using a dedicated
tool.
e-Manual has the following features:
• Required information can be cross-searched in multiple manuals.
• Other manuals can be accessed from the links in the manual.
• The hardware specifications of each part can be found from the product figures.
• Pages that users often browse can be bookmarked.
Manual name [manual number] Description Available form
MELSEC iQ-R Module Configuration Manual
[SH-081262ENG]
Common information on the hardware configuration of all
modules, overview of each system configuration, and
specifications of the power supply module, base unit, SD memory
card, and battery.
Print book
e-manual
PDF
MELSEC iQ-R CPU Module User's Manual (Startup)
[SH-081263ENG]
Specifications, procedures before operation, and troubleshooting
of the CPU module
Print book
e-manual
PDF
MELSEC iQ-R CPU Module User's Manual (Application)
[SH-081264ENG]
Memory, functions, devices, and parameters of the CPU module Print book
e-manual
PDF
MELSEC iQ-R Programming Manual (CPU Module Instructions,
Standard Functions/Function Blocks)
[SH-081266ENG]
Instructions for the CPU module and standard functions/function
blocks
e-manual
PDF
GX Works3 Operating Manual
[SH-081215ENG]
System configuration, parameter settings, and online operations of
GX Works3
e-manual
PDF

5
TERMS
Unless otherwise specified, this manual uses the following terms.
GENERIC TERMS AND ABBREVIATIONS
Unless otherwise specified, this manual uses the following generic terms and abbreviations.
Term Description
Engineering tool A tool used for setting up programmable controllers, programming, debugging, and maintenance
Generic term/abbreviation Description
FB Function Block. An FB is used in a sequence program. It consists of individual circuit blocks which are used repeatedly
in a sequence program. Using FBs helps to develop programs more efficiently, reduce mistakes, and improve quality of
programs.

6
1 OVERVIEW
1.1 FB List
1 OVERVIEW
FB described in this reference manual indicates the FB library for file operation.
1.1 FB List
The following table lists the FB library in this reference manual.
*1 An FB name ends in the FB version information such as "_00A"; however, this reference manual leaves it out.
1.2 How to Obtain the FB Library
For the FB library, please consult your local Mitsubishi representative.
For how to register the FB library, refer to the GX Works3 Operating Manual.
1.3 System Configuration
The following figure shows a system configuration example to use the FB library in this reference manual.
For the specifications of the modules, refer to the user's manual for the module used.
Name
*1
Description
M+FileOperation_SaveLoggingCSV_W_R Reads the signed word logging data stored in the file register (ZR), such as the analog data of multiple channels,
and stores the data in CSV format in an SD memory card.
(1) Power supply module
(2) CPU module
(3) SD memory card
(1) (2)
(3)

1 OVERVIEW
1.3 System Configuration
7
1
MEMO

8
2 FILE OPERATION FB
2.1 M+FileOperation_SaveLoggingCSV_W_R
2 FILE OPERATION FB
2.1 M+FileOperation_SaveLoggingCSV_W_R
Overview
This FB reads signed word logging data stored in a file register (ZR), such as analog data of multiple channels, and stores the
data in CSV format in an SD memory card.
Labels to use
Input label
Output label
No. Variable name Name Data type Scope Description
(1) i_bEN Execution
command
Bit On or off On: The FB is activated.
Off: The FB is not activated.
(2) i_udDataAddr Start address of
the storage
location of logging
data
Double word
[unsigned]
Valid device range. Specify the start address of the file register (ZR) where
logging data is stored.
Store the logging data in signed word format.
(3) i_uCHNum Number of
channels
Word [unsigned] 1 to 4 Specify the number of channels of the logging data to be
stored.
(4) i_udSavePoints Number of save
points
Double word
[unsigned]
1 to 10000000 Specify the number of points of the logging data to be
stored.
(5) i_snAppendFileName CSV file name String 1 to 28 characters Specify a CSV file name.
The file extension (.CSV) is automatically added by this
FB.
No. Variable name Name Data type Initial data Description
(6) o_bENO Execution status Bit OFF On: The execution command is on.
Off: The execution command is off.
(7) o_bOK Normal completion Bit OFF The on state indicates that the storage of the logging
data in an SD memory card is completed.
(8) o_udCompleteLogPoints Number of storage
completed logging
data points
Double word
[unsigned]
0 Returns the number of points of the logging data stored
in an SD memory card.
(9) o_bErr Error completion Bit OFF The on state indicates that an error has occurred in the
FB.
(10) o_uErrId Error code Word [unsigned] 0 The error code of an error occurred in the FB is stored.
o_udCompleteLogPoints:UD
o_bOK:B
o_bENO:B
UD:i_udDataAddr
B:i_bEN
M+FileOperation_SaveLoggingCSV_W_R
o_bErr:B
o_uErrId:UW
UW:i_uCHNum
UD:i_udSavePoints
S:i_snAppendFileName
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
(9)
(10)