3 DETAILS OF FUNCTION
3.2 MELSEC Data Link Functions
151
3
■
Description
• This function reads labels of a CPU module specified to the network number (lNetNo) and the station number (lStNo).
• Reserve the area for the device name array (plDevLst) in the call source.
• Reserve the area for (lLbCnt
×
3 + 1) for the size of area of the device name array (plDevLst).
• If any of the labels of which the label information cannot be acquired exists in the label name specified to the label name
array (pLbLst), this function returns any of the following errors. For the device type, start device number, and the number of
read points of the label, '0' is stored.
• The error response is returned in order of detection.
If two labels (Label1: non-existent label name, Label2: incorrect device specification method by digit specification) are
specified, only an error of Label1 (the first detected label) (-82) is returned.
• Even if the mdGetLabelInfo function returns the error (-82 or -84) the value is stored in the device name array (plDevLst) for
the label that acquired device information successfully.
• The specification method of the label name to specify to the device name array (pLbLst) is as follows:
: Possible,
: Impossible
Precautions
• In CW Workbench, Unicode character strings cannot be entered and source codes including Unicode character strings
cannot be compiled. Create a file with Unicode (UTF-16) character strings entered in an application (such as Notepad) of
Windows.
• When a device is specified such as the bit specification of word device or the digit specification of label, the device
information cannot be acquired.
• When a label to which a device is not assigned is specified, DevGV is stored in the device type.
• DevGV can be specified only with the functions supporting label access (mdRandRLabelEx/mdRandWLabelEx).
• For accessible CPU modules, refer to the following manual.
MELSEC iQ-R C Controller Module User's Manual (Application)
Error code
Error occurrence
-82 (FFB2H)
• A non-existent label was specified.
• Devices assigned to labels do not support random read/write.
• The specification method for devices assigned to labels is incorrect.
-84 (FFB4H)
The specification method for devices assigned to labels is incorrect.
Label type
Specificatio
n possibility
Specification method
Specification example
Label of the simple data type
Specify the label name.
Label1
Element specification of the array
label
Specify in the following format.
• One-dimensional array: Label name [ m ]
• Two-dimensional array: Label name [ m, n ]
• Three-dimensional array: Label name [ m, n, l ]
• One-dimensional array: Label1 [ 10 ]
• Two-dimensional array: Label2 [ 10, 20 ]
• Three-dimensional array: Label3 [ 10, 20, 30 ]
Whole specification of the
structure label
Member of the structure label
Specify in the following format.
Label name.Element name. to Element name
Str1.Elem1. to Elem3
Array member of the structure
label
Specify in the following format.
Label name.Element name [ m ]
Str1.Elem[ 10 ]
Bit specification of label
Digit specification of label
Label of timer type, retentive timer
type, and counter type
Specify in the following format.
• Contact: Label name.S
• Coil: Label name.C
• Current value: Label name.N
• Contact: Label1.S
• Coil: Label2.C
• Current value: Label3.N
Summary of Contents for MELSEC iQ-R C
Page 1: ...MELSEC iQ R C Controller Module Programming Manual ...
Page 2: ......
Page 201: ...I 199 MEMO ...
Page 203: ...I 201 MEMO ...
Page 207: ......