Mitsubishi Electric MELSEC iQ-R Series Service manual

MELSEC iQ-R Array Handling Function Block
Library Reference

1
CONTENTS
CONTENTS
CHAPTER 1 OVERVIEW 2
1.1 FB Library List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 System Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
CHAPTER 2 DETAILS OF THE FB LIBRARY 4
2.1 M+ArrayHandling_PointAdd_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.2 M+ArrayHandling_PointSub_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.3 M+ArrayHandling_PointMul_R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.4 M+ArrayHandling_PointDiv_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.5 M+ArrayHandling_Abs_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.6 M+ArrayHandling_Sort_R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2.7 M+ArrayHandling_Reverse_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2.8 M+ArrayHandling_Compare_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.9 M+ArrayHandling_Copy_R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
INSTRUCTION INDEX 54
REVISIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56

21 OVERVIEW
1.1 FB Library List
1OVERVIEW
The FB library in this manual is for array handling.
1.1 FB Library List
The following table lists the FB library in this manual.
For how to register the FB library, refer to the GX Works3 Operating Manual.
1.2 System Configuration Example
The following figure shows a system configuration example to use the FB library in this manual.
For the specifications of the modules, refer to the user's manual for the module used.
Name Description
M+ArrayHandling_PointAdd_R Adds a specified value to values of each element in a specified array.
M+ArrayHandling_PointSub_R Subtracts a specified value from values of each element in a specified array.
M+ArrayHandling_PointMul_R Multiplies values of each element in a specified array by a specified value.
M+ArrayHandling_PointDiv_R Divides values of each element in a specified array by a specified value.
M+ArrayHandling_Abs_R Outputs absolute values of values of each element in a specified array.
M+ArrayHandling_Sort_R Outputs the result of sorting a specified array in ascending order.
M+ArrayHandling_Reverse_R Outputs the result of sorting a specified array in reverse order.
M+ArrayHandling_Compare_R Compares two specified arrays.
M+ArrayHandling_Copy_R Copies a specified array to specified storage locations.
(1) Power supply module
(2) CPU module
(1) (2)

1 OVERVIEW
1.2 System Configuration Example 3
1
MEMO

42 DETAILS OF THE FB LIBRARY
2.1 M+ArrayHandling_PointAdd_R
2DETAILS OF THE FB LIBRARY
This chapter describes the details of the FB library.
2.1 M+ArrayHandling_PointAdd_R
Name
M+ArrayHandling_PointAdd_R
Overview
Labels to use
■Input labels
*1 The valid range varies depending on "Device/Label Memory Area Setting" of "CPU Parameter".
■Output labels
Item Description
Functional overview Adds a specified value to values of each element in a specified array.
Symbol
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_udSize Number of data
points
Double Word
[unsigned]
1 to 1000000 Specifies the number of data points for an array
where the addition is performed.
(3) i_udInAryAddr Input array data start
address
Double Word
[unsigned]
Valid device range*1 Specifies the start address of the file register (ZR)
where the input array data of the addition target
values are stored.
(4) i_udInPointAddr Input value address Double Word
[unsigned]
Valid device range*1 Specifies the address of the file register (ZR)
where the addition value is stored.
(5) i_udOutAryAddr Output array data
start address
Double Word
[unsigned]
Valid device range*1 Specifies the start address of the file register (ZR)
where the operation results are to be stored.
(6) i_uDataType Data type selection Word [unsigned] 0 to 2 Specifies the data type of the data to be operated.
0: Word [signed]
1: Double Word [signed]
2: Single-precision real number
No. Variable name Name Data type Default value Description
(7) o_bENO Execution status Bit Off On: The execution command is on.
Off: The execution command is off.
(8) o_bOK Normal completion Bit Off The on state indicates that the addition has been
completed.
(9) o_udOutAryNum Number of output
data points
Double Word
[unsigned]
0 The number of output data points with their
addition completed is stored.
(10) o_bErr Error completion Bit Off The on state indicates that an error has occurred
in the FB.
(11) o_uErrId Error code Word [unsigned] 0 The error code of an error occurred in the FB is
returned.
i_bENB:
i_udInPointAddrUD : o_bErr B:
M+ArrayHandling_PointAdd_R
o_udOutAryNum UD:
o_bOK B:
o_bENO B:
i_uDataTypeUW :
i_udOutAryAddrUD :
i_udInAryAddrUD :
i_udSizeUD :
(1) (7)
(8)
(9)
(10)
o_uErrId UW: (11)
(2)
(3)
(4)
(5)
(6)

2 DETAILS OF THE FB LIBRARY
2.1 M+ArrayHandling_PointAdd_R 5
2
FB details
Item Description
Relevant devices CPU module MELSEC iQ-R series
Engineering tool GX Works3 of version 1.015R or later
Language to use (The internal program of this FB is not open to the public.)
Number of steps 853 steps
The number of steps of the FB embedded in a program depends on the CPU module used, the input/output definitions, and
the options setting of GX Works3. For the options setting of GX Works3, refer to the GX Works3 Operating Manual.
FB dependence No dependence
Functional description (1) As i_bEN (execution command) turns on, this FB performs the addition between the input array data and the addition
value.
■Example 1
When 1 is input as the addition value and this FB is executed for the array data in word [signed], the output result is as
follows.
■Example 2
When 1 is input as the addition value and this FB is executed for the input array data in double word [signed], the output
result is as follows.
If an underflow or an overflow occurs during operation when word or double word is specified by i_uDataType (data type
selection), the operation result is as follows.
(2) The input array data of the addition target values are read from the file register (ZR), starting from the address specified
by i_udInAryAddr (input array data start address). This FB reads input array data for the number of points specified by
i_udSize (number of data points).
(3) The addition value is read from the file register (ZR) of the address specified by i_udInPointAddr (input value address).
(4) The operation results are stored in the file register (ZR) for the number of points specified by i_udSize (number of data
points), starting from the address specified by i_udOutAryAddr (output array data start address).
(5) Set the following so that the input array data areas and the output array data areas are not overlapped.
i_udInAryAddr (input array data start address)
i_udOutAryAddr (output array data start address)
i_udSize (number of data points)
If some areas of input array data and output array data are overlapped, o_bErr (error completion) turns on and the
processing of the FB is interrupted. In addition, 209H is stored in o_uErrId (error code). For the error code, refer to the
list of error codes. (Page 9 List of error codes)
However, if the same value is set for i_udInAryAddr (input array data start address) and i_udOutAryAddr (output array
data start address), the operation is processed normally. The operation results overwrite data in the file register (ZR),
starting from the area specified by i_udInAryAddr (input array data start address).
ZR0
0
ZR1
1
ZR998
32767
ZR999
-32768
··
ZR10000
1
ZR10001
2
ZR10998
-32768
ZR10999
-32767
··
Stored value
Output result
Stored value
ZR0
0
ZR2
1
ZR1996
2147483647
ZR1998
-2147483648
··
ZR10000
1
ZR10002
2
ZR11996
-2147483648
ZR11998
-2147483647
··
Stored value
Output result
Stored value
Word [signed] Effective data range: -32768 to 32767
Overflow 7FFFH(32767) + 0001H(1)
= 8000H(-32768)
Underflow 8000H(-32768) + FFFFH(-1)
= (1)7FFFH(32767)
Underflow data (1) are discarded.
Double word [signed] Effective data range: -2147483648 to 2147483647
Overflow 7FFFFFFFH(2147483647) + 00000001H(1)
= 80000000H(-2147483648)
Underflow 80000000H(-2147483648) + FFFFFFFFH(-1)
= (1)7FFFFFFFH(2147483647)
Underflow data (1) are discarded.

62 DETAILS OF THE FB LIBRARY
2.1 M+ArrayHandling_PointAdd_R
Functional description (6) Specify Word [signed], Double Word [signed], or Single-precision real number as the data type of input array data,
addition value, and output array data in i_uDataType (data type selection).
(7) Specify the number of data points for an array where addition is performed in i_udSize (number of data points). When 1:
Double Word [signed] or 2: Single-precision real number is specified by i_uDataType (data type selection), file register
(ZR) areas twice as many as the setting value of i_udSize (number of data points) are required.
(8) It takes multiple scans until the addition is completed. When the input array data before the operation is changed during
the operation processing, the operation processing is executed with the changed data. The number of points with the
operation completed is output to o_udOutAryNum (number of output data points). When the addition is completed,
o_bOK (normal completion) turns on.
(9) If a value out of the range is set in i_udSize (number of data points), o_bErr (error completion) turns on and the
processing of the FB is interrupted. In addition, 105H is stored in o_uErrId (error code). For the error code, refer to the
list of error codes. (Page 9 List of error codes)
(10)If a value out of the range is set in i_uDataType (data type selection), o_bErr (error completion) turns on and the
processing of the FB is interrupted. In addition, 103H is stored in o_uErrId (error code). For the error code, refer to the
list of error codes. (Page 9 List of error codes)
(11)When a single-precision real number is set in i_uDataType (data type selection) and the value stored in the file register
(ZR) is not a single-precision real number, o_bErr (error completion) turns on and the processing of the FB is
interrupted. In addition, 200H is stored in o_uErrId (error code). For the error code, refer to the list of error codes. (
Page 9 List of error codes)
(12)If i_bEN (execution command) is turned off before o_bOK (normal completion) or o_bErr (error completion) turns on,
o_bErr (error completion) turns on in one scan. In addition, 205H is stored in o_uErrId (error code) in one scan. For the
error code, refer to the list of error codes. (Page 9 List of error codes)
The operation results of the addition that has been completed before i_bEN (execution command) is turned off remain
stored in the file register (ZR).
(13)When a single-precision real number is set in i_uDataType (data type selection) and the operation result exceeds the
scope of the single-precision real number, o_bErr (error completion) turns on and the processing of the FB is
interrupted. In addition, 203H is stored in o_uErrId (error code) in one scan. For the error code, refer to the list of error
codes. (Page 9 List of error codes)
FB compilation method Subroutine type
FB operation Pulse execution type (multiple scan execution type)
Item Description

2 DETAILS OF THE FB LIBRARY
2.1 M+ArrayHandling_PointAdd_R 7
2
Timing chart of
I/O signals
Normal
completion
When i_udSize (number of data points) is 1000 points
Error
completion
• Parameter error (error before execution)
• Single-precision real number format error (error during addition in array)
• When i_bEN (execution command) is turned off during execution
Item Description
ON
OFF
OFF
OFF
OFF
ON
0
ON
001 2 999
·
1000
i_bEN
o_bENO
o_bOK
o_udOutAryNum
o_bErr
o_uErrId
Addition handling Unexecuted Executing Unexecuted
ON
OFF
OFF
OFF
OFF
ON
00
ON
0
i_bEN
o_bENO
o_bOK
o_bErr
o_uErrId
o_udOutAryNum
Addition handling Unexecuted
Error code
ON
OFF
OFF
OFF
OFF
ON
ON
0012
·
789
i_bEN
o_bENO
o_bOK
o_udOutAryNum
o_bErr
o_uErrId 00 200H
Addition handling Unexecuted
Unexecuted Executing
Format error
ON
OFF
OFF
OFF
OFF
ON
ON
0012
·
567
i_bEN
o_bENO
o_bOK
o_udOutAryNum
o_bErr
o_uErrId 00 205H
Addition handling Unexecuted
Unexecuted Executing

82 DETAILS OF THE FB LIBRARY
2.1 M+ArrayHandling_PointAdd_R
Performance value
The following table lists the performance values of this FB under the following conditions.
• CPU module: R04CPU
• File register storage location: Extended SRAM cassette
• FB compilation method: Subroutine type
*1 The time required from start to end of the processing
Restrictions and precautions (1) This FB does not include the error recovery processing. Prepare the error recovery processing separately to suit the
user's system and the expected operation.
(2) This FB uses the long index register LZ0. When using an interrupt program, do not use the corresponding index
register.
(3) The FB cannot be used in an interrupt program.
(4) Using the FB in a program that is to be executed only once, such as a subroutine program or a FOR-NEXT loop, has a
problem that i_bEN (execution command) can no longer be turned off and normal operation is not possible; Always use
the FB in a program that is capable of turning off the execution command.
(5) The FB requires the configuration of the ladder for every input label.
(6) This FB checks the input array data values before the operation execution to prevent an overflow or an underflow from
occurring during the operation. If a possibility of an overflow or an underflow is detected at this check, o_bErr (error
completion) turns on and 203H is stored in o_uErrId (error code). For the operation with the single-precision real
number, an error may occur depending on the combination of input array data values. Even after the input array data
values are checked, the instruction execution fault (operation error) may occur at the operation execution. If "RAS
Setting" of "CPU Parameter" is set to continue the processing even after an operation error occurs, o_bErr (error
completion) turns on and 203H is stored in o_uErrId (error code).
(7) If 3403H is stored in the special register SD0 (Latest self-diagnostic error code) of the CPU module due to an error
outside FB while i_bEN (execution command) of this FB is on, o_bErr (error completion) turns on and the processing of
the FB is interrupted. In addition, 204H is stored in o_uErrId (error code). However, if "RAS Setting" of "CPU
Parameter" is set to stop the processing after an operation error occurs, 204H is not stored in o_uErrId (error code).
Input label Time required for the
processing*1
Maximum scan time Number of the scans
required for the
processing
Number of data points Data type selection
10000 points 0: Word [signed] 14ms 3.62ms 4 scans
1: Double Word [signed] 22.5ms 5.83ms
2: Single-precision real number 37.1ms 9.65ms
500000 points 0: Word [signed] 754ms 3.9ms 200 scans
1: Double Word [signed] 1210ms 6.16ms
2: Single-precision real number 1950ms 9.86ms
1000000 points 0: Word [signed] 1510ms 3.92ms 400 scans
1: Double Word [signed] 2400ms 6.17ms
2: Single-precision real number 3880ms 9.87ms
Item Description