Mitsubishi Electric MELSEC iQ-F Series User manual

MELSEC iQ-F Character String Operation
Function Block Library Reference

1
SAFETY PRECAUTIONS
(Read these precautions before use.)
Before using this product, please read this manual and the relevant manuals introduced in this manual carefully and pay full
attention to safety in order to handle the product correctly.
This manual classifies the safety precautions into two categories: [ WARNING] and [ CAUTION].
Depending on the circumstances, procedures indicated by [ CAUTION] may also cause severe injury.
It is important to follow all precautions for personal safety.
Store this manual in a safe place so that it can be read whenever necessary. Always forward it to the end user.
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
INTRODUCTION
Thank you for purchasing the Mitsubishi Electric MELSEC iQ-F series programmable controllers.
This manual describes the module function blocks for the target modules listed below.
It should be read and understood before attempting to install or use the module function blocks.
Always forward it to the end user.
Target module
• FX5S CPU module
• FX5UJ CPU module
• FX5U CPU module
• FX5UC CPU module
Regarding use of this product
• This product has been manufactured as a general-purpose part for general industries, and has not been designed or
manufactured to be incorporated in a device or system used in purposes related to human life.
• Before using the product for special purposes such as nuclear power, electric power, aerospace, medicine or passenger
movement vehicles, consult Mitsubishi Electric.
• This product has been manufactured under strict quality control. However when installing the product where major
accidents or losses could occur if the product fails, install appropriate backup or failsafe functions in the system.
Note
• If in doubt at any stage during the installation of the product, always consult a professional electrical engineer who is
qualified and trained in the local and national standards. If in doubt about the operation or use, please consult the nearest
Mitsubishi Electric representative.
• Since the examples indicated by this manual, technical bulletin, catalog, etc. are used as a reference, please use it after
confirming the function and safety of the equipment and system. Mitsubishi Electric will accept no responsibility for actual
use of the product based on these illustrative examples.
• This manual content, specification etc. may be changed, without a notice, for improvement.
• The information in this manual has been carefully checked and is believed to be accurate; however, if you notice a doubtful
point, an error, etc., please consult your local Mitsubishi Electric representative. When doing so, please provide the manual
number given at the end of this manual.

3
CONTENTS
CONTENTS
SAFETY PRECAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
RELEVANT MANUALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
TERMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
GENERIC TERMS AND ABBREVIATIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
CHAPTER 1 OVERVIEW 5
1.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 List of FB Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3 System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CHAPTER 2 SPECIFICATIONS 7
2.1 FB Library Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2 List of Structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3 Precautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
CHAPTER 3 DETAILS OF FB LIBRARIES 10
3.1 M+StrProcessing_JSONDeserialize_F (Acquisition of JSON String). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Function details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Parameter settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Performance values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Error code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2 M+StrProcessing_JSONSerialize_F (Construction of JSON String) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Function details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Parameter settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Performance values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Error code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
CHAPTER 4 APPLICATION EXAMPLE 22
4.1 Acquiring Value String from JSON String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Programming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.2 Constructing the JSON String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Programming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
INSTRUCTION INDEX 29
REVISIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
TRADEMARKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

4
RELEVANT MANUALS
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.
Manual name Description
MELSEC iQ-F FX5S/FX5UJ/FX5U/FX5UC User's Manual (Hardware)
<SH-082452ENG>
Hardware of the CPU module, including I/O specifications, wiring, installation, and
maintenance
MELSEC iQ-F FX5 User's Manual (Application)
<JY997D55401>
Basic knowledge about programming, functions of the CPU module, devices/labels,
and parameter settings
MELSEC iQ-F FX5 Programming Manual (Program Design)
<JY997D55701>
Program specifications (ladder, ST, FBD/LD, and SFC programs) and labels
MELSEC iQ-F FX5 Programming Manual (Instructions, Standard
Functions/Function Blocks)
<JY997D55801>
Specifications of the instructions and functions that can be used in programs
GX Works3 Operating Manual
<SH-081215ENG>
Explanation of system configuration, parameter settings, and online operations of GX
Works3
Term Description
Engineering tool A tool used for setting up programmable controllers, programming, debugging, and maintenance
JSON string Data string based on the way JavaScript objects are written
Key string Value for identifying the Value string in the JSON string
Member Structure including the type, Key string, Value string, and depth of hierarchy
Value string Data to be written after the Key string in the JSON string
Generic term/abbreviation Description
FB An abbreviation for "Function Block". A function block is created from a ladder block repeatedly used in a sequence
program so that it can be used as a component in a sequence program.
Using FBs helps to develop programs more efficiently, reduce mistakes, and improve quality of programs.
FX5 A generic term for FX5S, FX5UJ, FX5U, and FX5UC programmable controllers
FX5 CPU module A generic term for FX5S CPU module, FX5UJ CPU module, FX5U CPU module, and FX5UC CPU module
FX5S CPU module A generic term for FX5S-30MR/ES, FX5S-40MR/ES, FX5S-60MR/ES, FX5S-80MR/ES, FX5S-30MT/ES, FX5S-40MT/
ES, FX5S-60MT/ES, FX5S-80MT/ES, FX5S-30MT/ESS, FX5S-40MT/ESS, FX5S-60MT/ESS, and FX5S-80MT/ESS
FX5U CPU module A generic term for FX5U-32MR/ES, FX5U-32MT/ES, FX5U-32MT/ESS, FX5U-64MR/ES, FX5U-64MT/ES, FX5U-64MT/
ESS, FX5U-80MR/ES, FX5U-80MT/ES, FX5U-80MT/ESS, FX5U-32MR/DS, FX5U-32MT/DS, FX5U-32MT/DSS, FX5U-
64MR/DS, FX5U-64MT/DS, FX5U-64MT/DSS, FX5U-80MR/DS, FX5U-80MT/DS, and FX5U-80MT/DSS
FX5UC CPU module A generic term for FX5UC-32MT/D, FX5UC-32MT/DSS, FX5UC-64MT/D, FX5UC-64MT/DSS, FX5UC-96MT/D,
FX5UC-96MT/DSS, FX5UC-32MT/DS-TS, and FX5UC-32MT/DSS-TS
FX5UJ CPU module A generic term for FX5UJ-24MR/ES, FX5UJ-24MT/ES, FX5UJ-24MT/ESS, FX5UJ-40MR/ES, FX5UJ-40MT/ES,
FX5UJ-40MT/ESS, FX5UJ-60MR/ES, FX5UJ-60MT/ES, and FX5UJ-60MT/ESS

1 OVERVIEW
1.1 Features 5
1
1OVERVIEW
The function blocks in this reference manual mean the FB libraries for character string operation in the MELSEC iQ-F series.
1.1 Features
This section describes the features of this function.
Shortening programming time
Programming time can be shortened because the character string operation program that had to be created by combining
instructions for CPU modules is grouped into blocks for each function.
1.2 List of FB Libraries
The following table lists the FB libraries in this reference manual.
: Required, : Not required
For these FB libraries and software, please consult your local Mitsubishi Electric representative.
For the FB library registration method, refer to the following.
GX Works3 Operating Manual
1.3 System Configuration
The following figures show examples of system configuration for using the FB libraries in this reference manual.
Name Description Parameter
setting
M+StrProcessing_JSONDeserialize_F (Acquisition of JSON
string)
Acquires the Value string corresponding to the specified Key string from the
JSON string.

M+StrProcessing_JSONSerialize_F (Construction of JSON
string)
Constructs the JSON string by specifying the Key string and Value string. 
(1) Programmable controller programmed by
using the FB libraries
FX5S, FX5UJ, FX5U, or FX5UC CPU module
(2) Personal computer where GX Works3 is
installed
(1) (2)
Ethernet
(1)

61 OVERVIEW
1.3 System Configuration
MEMO

2 SPECIFICATIONS
2.1 FB Library Specifications 7
2
2SPECIFICATIONS
This chapter describes the common specifications of the FB libraries in this reference manual.
2.1 FB Library Specifications
The FB libraries in this reference manual are used on a single CPU module of the MELSEC iQ-F series without
communicating with external devices.
For the available number of characters and character codes, refer to the following.
Page 10 DETAILS OF FB LIBRARIES

82 SPECIFICATIONS
2.2 List of Structures
2.2 List of Structures
The following table lists the structure used in the FB libraries in this reference manual.
Member
It is the structure used for constructing or acquiring the JSON string.
Set uDepth (depth of hierarchy) of pb_st30Member, which is the structure used in the FB libraries, according to the following
rules.
• The initial value of hierarchy is 1.
• The Value string parenthesized with {} indicates an object.
• If the Value is an object, one following hierarchy increases.
• When the end of an object is reached, one following hierarchy decreases.
In the JSON string below, hierarchies are surrounded by solid lines and objects are surrounded by dotted lines.
Name Description
Member Refers to member information.
Label Label name Data type Setting range Description
uType Type of Value Word [unsigned]/bit string [16 bits] 0 to 4 Set the type of Value.
0: Member structure array end
1: Object
2: Array
3: String
4: Numerical value/true/false/null
s32Key Key string String (32) 31 characters + a
terminator
Set the Key string and terminator.
s64Value Value string String (64) 63 characters + a
terminator
■When it is used in the JSON string acquisition
FB
Used to store the acquired Value strings. No
setting is required.
■When it is used in the JSON string construction
FB
Set the Value string and terminator.
uDepth Depth of hierarchy Word [unsigned]/bit string [16 bits] 1 to 30 Set the depth of Key hierarchy.
{
”name”: ”taro”,
”age”: 29,
”image”: {
”visible”: true,
”Title”: ”View from 15th Floor”,
”Thumbnail”: {
”Url”: ”http://www.example.com”,
”Height”: 125,
”Width”: 100
} ,
”IDs”: [116,943, 234, 38793]
}
}
Object
Hierarchy 1
Hierarchy 2
Hierarchy 3
Hierarchy 2