Mitsubishi Electric MELSEC iQ-R C Owner's manual

MELSEC iQ-R C Controller Module
Programming Manual

1
SAFETY PRECAUTIONS
(Read these precautions before using this product.)
Before using C Controller module, please read this manual and the relevant manuals carefully and pay full attention to safety
to handle the product correctly.
Make sure that the end users read this manual and then keep the manual in a safe place for future reference.
CONDITIONS OF USE FOR THE PRODUCT
(1) Mitsubishi 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 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'S USER, 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 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 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 representative in your region.

2
CONSIDERATIONS FOR USE
Considerations for the Wind River Systems product
C Controller module has an embedded real-time operating system, VxWorks, manufactured by Wind River Systems, Inc. in
the United States. We, Mitsubishi, make no warranty for the Wind River Systems product and will not be liable for any
problems and damages caused by the Wind River Systems product during use of C Controller module.
For the problems or specifications of the Wind River Systems product, refer to the corresponding manual or consult Wind
River Systems, Inc.
Contact information is available on the following website.
• Wind River Systems, Inc.: www.windriver.com
INTRODUCTION
Thank you for purchasing the Mitsubishi MELSEC iQ-R series programmable controllers.
This manual describes the functions required for programming.
Before using this product, 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 product correctly.
Please make sure that the end users read this manual.

3
CONTENTS
CONTENTS
SAFETY PRECAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
CONDITIONS OF USE FOR THE PRODUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
CONSIDERATIONS FOR USE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
RELEVANT MANUALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
TERMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
CHAPTER 1 COMMON ITEMS 7
1.1 Header Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 C Controller Module Dedicated Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Program processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Argument specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.3 MELSEC Data Link Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Program processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Accessible range and devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Argument specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.4 Considerations on Interrupt Service Routine (ISR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
CHAPTER 2 FUNCTION LIST 44
2.1 C Controller Module Dedicated Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
C Controller module dedicated functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
C Controller module dedicated functions for ISR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.2 MELSEC Data Link Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
CHAPTER 3 DETAILS OF FUNCTION 48
3.1 C Controller Module Dedicated Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
C Controller module dedicated functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
C Controller module dedicated functions for ISR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
3.2 MELSEC Data Link Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
CHAPTER 4 ERROR CODE LIST 174
4.1 Common Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
4.2 C Controller Module Dedicated Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
4.3 MELSEC Data Link Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
4.4 Error Codes Different From Conventional Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
APPENDIX 188
Appendix 1 Example for Replacing Ladder by C Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Program example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Appendix 2 How to Replace an Existing Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Replacement of projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Replacement of VxWorks standard API functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Replacement of functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Replacement of device type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Compilation of replaced project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

4
Appendix 3 Correspondence Table to Conventional Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
C Controller module dedicated functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
C Controller module dedicated function for ISR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Bus interface functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Bus interface functions for ISR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
MELSEC data link functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
INDEX 198
FUNCTION INDEX 200
REVISIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
TRADEMARKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204

5
RELEVANT MANUALS
e-Manual refers to the Mitsubishi 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.
• 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 C Controller Module Programming Manual
[SH-081371ENG] (this manual)
Explains the programming specifications and dedicated
function library of a C Controller module.
e-Manual
PDF
MELSEC iQ-R C Controller Module User's Manual
(Startup)
[SH-081367ENG]
Explains the performance specifications, procedure before
operation, and troubleshooting of a C Controller module.
Print book
e-Manual
PDF
MELSEC iQ-R C Controller Module User's Manual
(Application)
[SH-081369ENG]
Explains the functions, devices, and parameters of a C
Controller module.
Print book
e-Manual
PDF
CW Workbench/CW-Sim Operating Manual
[SH-081373ENG]
Explains the system configuration, specifications, functions,
and troubleshooting of CW Workbench/CW-Sim.
e-Manual
PDF

6
TERMS
Unless otherwise specified, this manual uses the following terms.
Term Description
Basic model QCPU A generic term for Q00JCPU, Q00CPU, and Q01CPU.
C Controller module A generic term for MELSEC iQ-R series C Controller module.
C Controller module dedicated function A dedicated function library offered by C Controller module.
It is used to control the C Controller module.
CC-Link IE Controller Network module An abbreviation for CC-Link IE Controller Network module, RJ71GP21-SX.
CC-Link IE Field Network module An abbreviation for CC-Link IE Field Network module, RJ71GF11-T2.
CC-Link module An abbreviation for CC-Link module, RJ61BT11.
CW Configurator A generic product name for SWnDND-RCCPU. ('n' indicates its version.)
CW Workbench An abbreviation for C Controller module and C intelligent function module engineering tool, CW
Workbench.
CW-Sim An abbreviation for VxWorks simulator that can operate and debug the C Controller module and C
intelligent function module programs on a personal computer on which CW Workbench installed, without
connecting to the actual machine (target).
Dedicated function library A generic term for C Controller module dedicated function and MELSEC data link function.
Existing product A generic term for Q12DCCPU-V (Basic mode/Extended mode).
High Performance model QCPU A generic term for Q02CPU, Q02HCPU, Q06HCPU, Q12HCPU, and Q25HCPU.
Intelligent function module A generic term for modules which has functions other than input and output, such as A/D converter module
and D/A converter module.
MELSEC data link function A data link function library offered by C Controller module.
It is used to access other CPU modules as a connection target via network or in a multiple CPU system.
Process CPU A generic term for Q02PHCPU, Q06PHCPU, Q12PHCPU, and Q25PHCPU.
R12CCPU-V An abbreviation for R12CCPU-V C Controller module.
RCPU A generic term for R04CPU, R04ENCPU, R08CPU, R08PCPU, R08ENCPU, R08SFCPU, R16CPU,
R16PCPU, R16ENCPU, R16SFCPU, R32CPU, R32PCPU, R32ENCPU, R32SFCPU, R120CPU,
R120PCPU, R120ENCPU, and R120SFCPU.
Redundant CPU A generic term for Q12PRHCPU and Q25PRHCPU.
Universal model QCPU A generic term for Q00UJCPU, Q00UCPU, Q01UCPU, Q02UCPU, Q03UDCPU, Q03UDVCPU,
Q03UDECPU, Q04UDHCPU, Q04UDVCPU, Q04UDEHCPU, Q06UDHCPU, Q06UDVCPU,
Q06UDEHCPU, Q10UDHCPU, Q10UDEHCPU, Q13UDHCPU, Q13UDVCPU, Q13UDEHCPU,
Q20UDHCPU, Q20UDEHCPU, Q26UDHCPU, Q26UDVCPU, Q26UDEHCPU, Q50UDEHCPU, and
Q100UDEHCPU.
VxWorks A product name for the real-time operating system manufactured by Wind River Systems, Inc.

1 COMMON ITEMS
1.1 Header Files 7
1
1COMMON ITEMS
A user program is created by using the VxWorks standard API functions*1 and dedicated function library offered by a C
Controller module in accordance with the specification of VxWorks, the operating system of C Controller module.
*1 For details on the VxWorks standard API functions, refer to the following programmer's guide supported.
VxWorks "KERNEL PROGRAMMER'S GUIDE"
Dedicated function libraries offered by a C Controller module are as follows:
• C Controller module dedicated function
• MELSEC Data Link Functions
For the execution procedure of user programs, refer to the following manual.
MELSEC iQ-R C Controller Module User's Manual (Startup)
1.1 Header Files
Include the following header files in a user program to use the dedicated function library.
A header file is stored in a C Controller module.
(MELSEC iQ-R C Controller Module User's Manual (Application)
Dedicated function library Header file
C Controller module dedicated function CCPUFunc.h
MELSEC data link function MDFunc.h

81 COMMON ITEMS
1.2 C Controller Module Dedicated Functions
1.2 C Controller Module Dedicated Functions
C Controller dedicated functions of the dedicated function libraries are used to control C Controller module.
These functions can be used for reading status of C Controller module or accessing resources such as LED control and clock.
Program processing
The following shows the user program processing using the C Controller module dedicated function.
1. Start a task.
2. Read the status of C Controller module and access the resources such as LED control and clock by using the C
Controller module dedicated function.
3. Complete the task.
Considerations
Considerations for user WDT (user watchdog timer)
■User WDT error occurrence
If a user WDT cannot be reset due to a user program runaway, a user WDT error will occur.
In this case, take the following corrective actions.
• Increase the user WDT period set with the CCPU_StartWDT function.
• Lower the number of tasks with high CPU utilization or make them deactivated.
• Review the user program.
Reset the C Controller module once the corrective actions have been taken.
In the user program, a user WDT can be used to monitor the hardware and status of user program, and
processing timeout for accessing and controlling each module.
■User WDT setting range
The user WDT period can be set within the range of 100 ms to 10,000 ms.
■Output when a user WDT error occurs
When a user WDT error occurs, the output turns OFF.
Considerations for the dedicated instructions
Considerations for argument are shown below:
• For the first argument, "pcInstName", categorizing the dedicated instructions (D/DP/J/JP/G/GP/M) is not required.
• Devices of the own station cannot be specified. Reserve the required area with a user program, and specify the start
address of the area to the relevant argument.
• Specify devices of other stations by using a character string. Set the value (the number of elements to which one is added
for the termination code) to the number of elements for the array.
(Example) To specify D4: char cDev[3] = {"D4"};
Set '3', the total number of '2' for D4 and '1' for termination code, to the number of elements for the character string.
• When the data type is device name (control data, input data, and output data), specify the argument using an array.
• The size is required to be set according to the number of elements for the array, which is specified to the argument. When
data type is 16-bit binary, BCD 4-digit, or real number, set the size to '1'. When data type is 32-bit binary or BCD 8-digit, set
the size to '2'.
• When data type is bit (completion device), specify the argument using an array. Specify '1' for completion or '0' for
incompletion to the first array. In the second array, '0' or '1' is stored for the normal completion or abnormal completion,
respectively.
• For arguments without the setting data, set the setting data to NULL, and set the size to '0'.
• Errors which occur in the dedicated instruction are not registered in the event history.