Professional Documents
Culture Documents
MD-X2000-2500 Series Laser Marker Communication Interface Users Manual
MD-X2000-2500 Series Laser Marker Communication Interface Users Manual
MD-X2000-2500 Series Laser Marker Communication Interface Users Manual
Communication
1 Interface
3-Axis Hybrid Laser Marker
2 EtherNet/IP
MD-X2000/2500 Series
3 PROFINET
User’s Manual
Read this manual before using the product in order to achieve maximum performance.
Keep this manual in a safe place after reading it so that it can be used at any time.
Introduction
Read this manual before using the product in order to achieve maximum performance.
Keep this manual in a safe place after reading it so that it can be used at any time.
Symbols
In this manual, the following symbols alert you to important messages.
Be sure to read the messages.
Indicates a hazardous situation which, if not avoided, will result in death or serious injury.
Indicates a hazardous situation which, if not avoided, could result in death or serious injury.
Indicates a hazardous situation which, if not avoided, could result in minor or moderate injury.
Indicates a situation which, if not avoided, could result in product damage as well as property damage.
Cautions
(1) Unauthorized reproduction of this manual in whole or part is prohibited.
(2) The contents of this manual may be changed for improvements without prior notice.
(3) A
n utmost effort has been made to ensure the contents of this manual are as complete as possible. If there are any mistakes or questions, please
contact a KEYENCE office listed in the back of the manual.
(4) Regardless of item (3), KEYENCE will not be liable for any effect resulting from the use of this unit.
(5) Any manuals with missing pages or other paging faults will be replaced.
Software License Agreement
H98GB 1
Contents
Contents
Introduction Status of device assignment of the MD information area. . . . . . . . . . . 2-10
Symbols Input Assemblies Memory Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Cautions Output Assemblies Memory Map . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Software License Agreement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Word area for writing a PLC request. . . . . . . . . . . . . . . . . . . . . . . . 2-19
Command communications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Chapter 1 Communication Interface When “Request” bit does NOT work. . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Ladder Program Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Communication command list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 KEYENCE KV Series Program Example. . . . . . . . . . . . . . . . . . . . . . . 2-21
Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Changing the job No. and starting the marking
RS-232C Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 (An example of bit control) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Connection cables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Changing the string (An example of bit control) . . . . . . . . . . . . . . . 2-22
Communication settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Sending a command (An example of command communication). . 2-23
Ethernet interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 OMRON PLC CJ2 Series Program Example. . . . . . . . . . . . . . . . . . . . 2-24
Connection cables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Changing the job No. and starting the marking (An example of bit
Communication settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 control) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24
Communication Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Changing the string (An example of bit control) . . . . . . . . . . . . . . . 2-25
Write/Read command formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Sending a command (An example of command communication). . 2-26
Write command format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Studio 5000 Logix Designer Ladder Program Example. . . . . . . . . . . . 2-27
Read command format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Changing the job No. and starting the marking
Target specifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 (An example of bit control) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27
Communication format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Changing the string (An example of bit control) . . . . . . . . . . . . . . . 2-27
Header/Delimiter setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Sending a command (An example of command communication). . 2-28
Check sum setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Communication priority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Command Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Chapter 3 PROFINET
How to interpret the command details. . . . . . . . . . . . . . . . . . . . . . . 1-10 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Basic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11 Outline of the control by PROFINET . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Laser marker operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 Operation Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Current values and statuses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19 Devices compatible with PROFINET communication. . . . . . . . . . . . . . 3-2
Controller setup/management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 Communication Specification of the Controller. . . . . . . . . . . . . . . . . . . . . . 3-3
Job No.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25 Basic specification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
String/Logo/Barcode setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33 Periodic communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Marking parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-46 Status of device assignment of the MD information area. . . . . . . . . . . . 3-4
Code overprinting parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55 Bit area for writing laser marker state on the PLC. . . . . . . . . . . . . . 3-4
Word area for writing laser marker state on the PLC . . . . . . . . . . . . 3-8
3D shape setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Bit area for writing the request from the PLC
Work flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-63
onto the laser marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Matrix setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-74
Word area for writing a PLC request. . . . . . . . . . . . . . . . . . . . . . . . 3-11
Group/Counter setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-77
Command communications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Operation time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-78
Other controller specification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-80
Endian. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Applied Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-82 GSDML file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Variable-length support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-82 When “Request” bit does NOT work. . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
Omission of target specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-82 Setup Procedure of PROFINET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
If the currently running job No. is the target . . . . . . . . . . . . . . . . . . 1-82 Connection Procedure for PROFINET . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
If block No.000 is the target. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-83 Setup of PROFINET Communication. . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Omission of parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-83 Checking the setup of the Laser marker. . . . . . . . . . . . . . . . . . . . . 3-14
Sending of linked commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-84 Modify the settings of the Siemens S7-1200 series.. . . . . . . . . . . . 3-14
For WX command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-84 Controlling the Laser Marker Controller. . . . . . . . . . . . . . . . . . . . . . . . 3-19
For RX command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-85 Switching and Marking the Job No. of the Laser Marker. . . . . . . . 3-19
Linking the communication command (WXC command) . . . . . . . . 1-85 Use the command communication to change
Creating new settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-86 and mark the job No.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20
Communication Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87 Reading the Marked 2D Code and
Error response. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87 Acquiring the Assessment Result. . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Error list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87 Execute Ladder Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91 Download the created ladder program on the PLC.. . . . . . . . . . . . . . . 3-22
ASCII code list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91 Confirm/monitor the state of laser marker . . . . . . . . . . . . . . . . . . . . . . 3-22
Model-Specific Input Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-92 Execute ladder program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
Communication Interface
Communication command list. . . . . . . . . . . . . . . . . 1-2
Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
RS-232C Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Ethernet interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Communication Specifications . . . . . . . . . . . . . . . . 1-8
Write/Read command formats. . . . . . . . . . . . . . . . . . . . . . 1-8
Target specifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Communication format. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Communication priority. . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Command Details . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Basic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
Laser marker operation . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Current values and statuses . . . . . . . . . . . . . . . . . . . . . . 1-19
Controller setup/management. . . . . . . . . . . . . . . . . . . . . 1-21
Job No.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
String/Logo/Barcode setting. . . . . . . . . . . . . . . . . . . . . . 1-33
Marking parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-46
Code overprinting parameters. . . . . . . . . . . . . . . . . . . . . 1-55
3D shape setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Work flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-63
Matrix setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-74
Group/Counter setting. . . . . . . . . . . . . . . . . . . . . . . . . . . 1-77
Operation time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-78
Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-80
Applied Functions. . . . . . . . . . . . . . . . . . . . . . . . . . 1-82
Variable-length support . . . . . . . . . . . . . . . . . . . . . . . . . . 1-82
Omission of target specifiers. . . . . . . . . . . . . . . . . . . . . . 1-82
Omission of parameters. . . . . . . . . . . . . . . . . . . . . . . . . . 1-83
Sending of linked commands . . . . . . . . . . . . . . . . . . . . . 1-84
Creating new settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-86
Communication Errors. . . . . . . . . . . . . . . . . . . . . . 1-87
Error response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87
Error list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87
Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91
ASCII code list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91
Model-Specific Input Value List. . . . . . . . . . . . . . . . . . . . 1-92
1
Title (Set/Request) Title 1-11
Start the marking laser StartMarking 1-12
Start the guide laser GuideLaser 1-12
Communication Interface
1
Movement marking trigger delay (Set/Request) OnTheFlyTriggerDelay 1-26
Continuous movement marking (Set/Request) ContinuousOnTheFlyMarking 1-27
Marking range setting (Set/Request) OnTheFlyMarkingArea 1-27
Workpiece position adjustment (Plane) (Set/Request) JobPosition 1-28
Communication Interface
Job No.
Height correction (Set/Request) HeightCorrection 1-28
Common block marking parameters (Set/Request) CommonMarkingParameter 1-29
Marking energy check (Set/Request) MarkingEnergy 1-30
Scanner waiting position when ready (Set/Request) ScannerWaiting 1-30
Camera magnification when ready (Set/Request) CameraWaitingScale 1-31
Internal lighting status when ready (Set/Request) CameraWaitingLight 1-31
External lighting status when ready (Set/Request) CameraWaitingExternalLight 1-31
Type of lighting for the running job (Set/Request) LightingType 1-31
Approach scan speed (Set/Request) ApproachScanSpeed 1-32
Block type (Set/Request) BlockType 1-33
Barcode type (Set/Request) CodeType 1-33
String and logo files (Set/Request) CharacterString 1-34
Font setting (Set/Request) CharacterFont 1-37
Character size (Set/Request) CharacterSize 1-38
Logo size (Set/Request) LogoSize 1-38
String proportional setting (Set/Request) CharacterProportional 1-39
String ratio setting (Set/Request) CharacterRatio 1-39
Arc string character layout setting (Set/Request) ArcCharacter 1-40
Barcode/2D code setting (Set/Request) CodeSetting 1-41
String/Logo/Barcode
Barcode size (Set/Request) BarcodeSize 1-41
setting
GS1DataBar size (Set/Request) GS1DataBarSize 1-42
DataMatrix size (Set/Request) DataMatrixSize 1-42
DataMatrix cell size ratio in X direction (Set/Request) DataMatrixCellSizeRatioX 1-43
DataMatrix cell size ratio in Y direction (Set/Request) DataMatrixCellSizeRatioY 1-43
QR Code size (Set/Request) QRCodeSize 1-43
QR code cell size ratio in X direction (Set/Request) QRCodeCellSizeRatioX 1-44
QR code cell size ratio in Y direction (Set/Request) QRCodeCellSizeRatioY 1-44
Block position (Set/Request) BlockPosition 1-44
Block layout (Set/Request) BlockLayout 1-45
Fixed point emission time (Set/Request) FixedPointProcessingTime 1-45
Marking parameters (Set/Request) MarkingParameter 1-46
Barcode/2D code pattern setting (Set/Request) CodePattern 1-47
Hatch logo pattern setting (Set/Request) HatchPattern 1-48
TrueType font pattern setting (Set/Request) TTFPattern 1-49
Barcode/2D code fill marking parameters (Set/Request) CodeFillParameter 1-49
Hatch logo fill marking parameters (Set/Request) HatchParameter 1-50
TrueType font fill marking parameters (Set/Request) TTFParameter 1-51
Marking parameters Photo setting (Set/Request) PhotoSetting 1-51
Marking flag (Set) MarkingEnable 1-52
Individual fill marking parameters (Set/Request) FillMarkingParameter 1-52
Jump Speed (Set/Request) JumpSpeed 1-53
Nudge marking quality setting (Set/Request) MarkingQuality 1-53
Approach (Set/Request) Approach 1-53
Space approach (Set/Request) SpaceApproach 1-54
Curve correction (Set/Request) CurveCorrection 1-54
1
Space approach of barcode/2D code overprinting (Set/Request) MultiPassSpaceApproach 1-58
Curve correction of barcode/2D code overprinting (Set/Request) MultiPassCurveCorrection 1-58
Jump speed of barcode/2D code overprinting (Set/Request) MultiPassJumpSpeed 1-58
Communication Interface
WindowCheckBeforeMarking
Set/Request the sensitivity of the lens inspection before marking 1-64
Sensitivity
Set/Request to enable/disable the lens inspection after marking WindowCheckAfterMarkingEnable 1-65
WindowCheckAfterMarkingAlarm
Set/Request the warning threshold of the lens inspection after marking 1-65
Threshold
Set/Request the sensitivity of the lens inspection after marking WindowCheckAfterMarkingSensitivity 1-65
Enable/disable the marking verification function (Set/Request) MarkingConfirmationSetting 1-66
Work flow
2D code quality check and various settings (Set/Request) CodeReaderSetting 1-66
Request internal lighting condition during 2D code reading CodeReaderLightSetting 1-67
Capturing condition of the camera function (Set/Request) CameraImagingSetting 1-67
Capturing position of the camera (Set/Request) CameraTargetSetting 1-68
Request the workflow result WorkflowResultDetail 1-69
Request the marking result MarkingResult 1-70
Request the pre-marking lens inspection result WindowCheckBeforeMarkingResult 1-70
Request the post-marking lens inspection result WindowCheckAfterMarkingResult 1-70
Request the filename of the image captured with the camera CameraImageFilepath 1-71
Request the marking confirmation result MarkingConfirmationResult 1-71
Request the 2D code reader result CodeReadResult 1-72
Request the marking energy result MarkingEnergyResult 1-73
Request the number of marked matrix cells MatrixCellMarkingCount 1-73
Matrix row & column setting (Set/Request) MatrixSetting 1-74
Matrix size setting (Set/Request) MatrixSize 1-74
Matrix cell reference point (Set/Request) CellReferencePoint 1-75
Matrix setting Cell individual setting (Set/Request) MatrixCell 1-75
Cell marking flag (Set) MatrixCellEnable 1-76
Matrix position setting (Set/Request) MatrixPosition 1-76
Count using invalid marking cells (Set/Request) InactiveCellCount 1-76
1
Request the head temperature MarkingUnitTemperature 1-79
Request the controller temperature ControllerTemperature 1-79
Request the result of laser power calibration LaserPowerCalibrationResult 1-79
Cumulative marking count 1 and 2 (Set/Request) CumulativeMarkingCount 1-79
Communication Interface
Request the lens inspection result WindowCheckResult 1-80
Set/Request the sensitivity of the lens inspection WindowCheckSensitivity 1-80
Set/Request the lens inspection at startup WindowCheckStartup 1-80
Set/Request the lens inspection alarm threshold. WindowCheckAlarmThreshold 1-81
Maintenance
Start the lens inspection WindowCheck 1-81
Laser power measurement LaserPowerCheck 1-81
Delete all logging data LoggingClearAllData 1-81
Delete logging data with a specified period LoggingClearData 1-81
Interface
• Read the “Safety Information” in the user's manual for the applicable model to perform operation in the state that the safety
is secured by using security function even when the network failure occurs.
• Confirm the safe operation by considering the communication delay due to the communication time or network overload
state.
1 RS-232C Interface
Communication Interface
Ethernet interface
This section explains how to communicate using TCP/IP (Non-
procedure) via Ethernet.
Connection cables
Connect the laser marker with the external device using a LAN (STP or
UTP) cable.
To use TCP/IP (Non-procedure) communication, use the LAN1 [MAIN]
1
port of the laser marker.
Communication Interface
Pin
MDI signal Signal function
number
4 - -
5 - -
RJ-45
Modular connector 6 RD- Received data (-)
7 - -
Communication settings
When connecting the laser marker with the external device using TCP/
IP via Ethernet, set the IP addresses and subnet masks such that they
are in the same local area network. The default port number is “50002”.
For the detail, refer to “Communication Setup” in [4 Setting Menu” of
“Marking Builder Plus User's Manual.”
Communication Specifications
Write/Read command formats Target specifier
If you wish to send a command from the external device to the laser When sending a command to the laser marker, for most commands,
marker, it should be sent/received in the format described below. you need to determine the change target in advance. A target specifier
is inserted before the command in the form of “Target specifier = Target
1
No.”. If you wish to specify multiple targets, they need to be arranged
side-by-side. The types of target specifiers and target number ranges
Write command format are as described below.
If the command is changing the setting value of the laser marker or Description
executing an operation, add “WX” on the beginning of the command. Specifier No.
Command WX,Command [CR] JOB 0000 to 1999 Specifies the job No.
Normal : WX,OK [CR] BLK 000 to 255 Specifies the block No.
Response
Error : WX,NG,S***,ErrCode [CR]
00 : Marking confirmation function
An OK response is returned if the change or instruction specified by FNC 00 to 01
01: 2D code reader
the command is successful and returns an error response if it fails. For
more information on the error, refer to “Communication Errors” (Page TRK 000 to 255 Specifies the tracking No.
1-87).
A response is returned in the timing when the specified change or OLP 0 to 9 Specifies the overprinting No.
instruction has completed.
3DS 000 to 255 Specifies the 3D shape No.
• The spelling of “Command” is not case-sensitive. Both
cases will be accepted. Specifies the number of rows and
• The maximum command byte length is 4096 bytes. You columns of the matrix. The number
need to split the command if you wish to send a longer will be assigned with priority given to
byte length. rows, in reference to the top left of
• The command other than strings is sent in ASCII format. the matrix.
If the command is requesting the setting value or the status of the laser
marker, add “RX” on the beginning of the command.
For example, to change a string, you need to specify the job No. and
block No. in advance. The command will therefore be as an example
described below.
1
A response is returned automatically detecting the header/delimiter as [STX]
/ [ETX] or [None] / [CR].
Communication path Priority acquisition period
Ethernet connection • The length of time from when the WX
Only [None]/[CR] are supported. command is sent until a response is
Communication Interface
External communication returned
(RS-232C/Ethernet) • From sending the CreateJob command,
[STX]/[ETX] command examples • until a response is returned from the
EndJob command
Command [STX]WX,Command[ETX]
• During acquiring mastership
Response [STX]WX,OK[ETX]
• During I/O terminal monitor mode
Marking Builder Plus
transition
(USB/Ethernet)
[None]/[CR] command examples • During transition of settings and backup
data
Command WX,Command[CR]
• During test marking mode transition
Response WX,OK[CR] • During terminal block simulate mode
Console
transition
(Dedicated cable)
• During transition of settings and backup
data
Response WX,OK,0B[CR]
0100 1000b
ASCII conversion
48h
Communication Interface
0: Disabled
A:0/1 1 byte
1: Enabled
* Default value “0”
Command Details
Upper limit threshold
Command Details
0: Disabled
Parameter B:0/1 1 byte
1: Enabled
* Default value “0”
1
This shows the target specifier required for This is the default value of the job
thisScanner
(13) command.
waiting position when ready (Set/Request) parameters.
Command WX,JOB=0000,ScannerWaiting=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,ScannerWaiting[CR]
RX
Response RX,OK,A,B,C,D[CR]
Standby coordinate
0: Auto
A:0/1 1 byte
1: Custom coordinate
* Default value “0”
When setting the standby coordinate to auto, standby is done on the coordinate where the scanner will be used firstly at work flow.
The input range varies depending on the laser marker area size. Input range is listed in the “Model-Specific Input
The applicable models for each area size are as described below. Value List” (Page 1-92).
• Normal : MD-X2000/2500 Series
• Wide : MD-X2020/2520 Series
Enter a fixed value when the value of the specific parameter is “0”.
• Small : MD-X2050 Series
* Since the fixed values are ignored on the laser marker side, values
other than the fixed values will be accepted as long as they are
within the parameter input range.
WX command example
This command changes the scanner waiting position when ready (X: 5mm, Y: 10mm, Z: -5mm) of job No.0005.
Command WX,JOB=0005,ScannerWaiting=1,0005.000,0010.000,-005.000[CR]
RX command example
This command requests the scanner waiting position when ready (X: 5 mm, Y: 10 mm, Z: -5 mm) of job No.0005.
Command RX,JOB=0005,ScannerWaiting
- MD-X2000/2500 Series Communication
[CR] Interface User’s Manual - 1-25
Response RX,OK,1,0005.000,0010.000,-005.000[CR]
Basic
(1) Delete the job
Command DeleteJob 13 bytes
Description Deletes the jobs in the laser marker.
Target None
WX
Command
Response
WX,DeleteJob=A,A,A,A...[CR]
WX,OK [CR]
1
Communication Interface
Command
RX None
Response
Target None
Command
WX None
Response
Command RX,Ready[CR]
RX
Response RX,OK,A[CR]
0 : READY ON
1 : READY OFF (Error occurring)
Parameter A:0/1/2 1 byte
2 : READY OFF (Marking or expansion in
progress)
If the value of parameter A is “1”, you cannot perform any marking until the error is cleared. Clear the error using the ErrorClear command.
However, if the occurring error is a terminal block status error (T***), check the ON/OFF status of the terminal block.
Command WX,JOB=0000,Title=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,Title[CR]]
RX
Response RX,OK,A[CR]
Target None
1 WX
Command
Response
WX, StartMarking=A [CR]
WX,OK [CR]
Communication Interface
Command
RX None
Response
• An error response is returned when marking is canceled from the terminal block, etc.
• The parameter can be omitted. Sending WX,StartMarking[CR] results in the same response as WX,StartMarking=0[CR].
The guide laser is emitted for the same length of time as the marking time when selecting once and emitted
Target
continuously for 30 seconds for all other emission types.
Command WX,GuideLaser=A[CR]
WX
Response WX,OK [CR]
Command
RX None
Response
• This command returns a response as soon as the guide laser emission starts.
• The emission can be canceled using the “StopMarking” command.
Target None
Command WX,StopMarking[CR]
WX
Response WX,OK [CR]
Command
RX None
Response
Parameter None
Target None
Command WX,TriggerLock=A[CR]
WX
Response WX,OK [CR]
Command RX,TriggerLock[CR]
RX
Response RX,OK,A[CR]
If this command is received during marking, the marking will not stop but the next marking start input will be rejected.
Target None
Command WX,DistancePointer=A[CR]
WX
Response WX,OK[CR]
RX
Command
Response
RX,DistancePointer[CR]
RX,OK,A[CR] 1
Distance Pointer
Communication Interface
Parameter A:0/1 1 byte 0: Off
1: On
This command returns a response as soon as the distance pointer is turned on/off.
Target None
Command WX,Check2DCode4=A,B,C,D,E,F,G,H,I,J,K,L,M,N,O[CR]
WX
Response WX,OK,P,Q,R[CR]
Command
RX None
Response
Capture position
0: Current scanner position
A: 0 to 3 1 byte 1: Custom coordinate
2: Block coordinate
3: Block position (last tracking result applied)
Block No.
F: 000 to 255 3 byte
Parameter A: Fixed value of “0” when 0/1
Camera zoom
0: Whole wide
1: Whole standard
G: 0 to 3 1 byte
2: Coax wide
3: Coax standard
* Default value “2”
Brightness
H: -100 to 0100 4 byte
* Default value “0”
Lighting type
0: Internal lighting (normal)
J: 0 to 2 1 byte 1: Internal lighting (halation removal)
2: External lighting
* Default value “2”
1
Lighting condition for internal lighting 5
0: Off
O: 0/1 1 byte
1: On
* This parameter can be omitted.
Communication Interface
• When J is 0 and the lighting condition for the internal lighting is specified, all of parameters K, L, M, N, and O must be specified.
• When A is 2 or 3, reading is possible in the period after marking until the next marking.
• When A is 3, the last correction for the XY tracking and Z tracking set for the block will be applied to the capture position.
When no previous tracking result exists because the setting number was switched or for other reasons, the block position will not be corrected.
When the tracking is set to not correct the block position, the capture position will not be corrected.
• The S087 communication error “2D code reading error” is returned if the 2D code cannot be found.
• The fixed camera and internal lighting cannot be selected for the MD-X2050(A). If the command is executed, an S095 Model Limitation Error will occur.
• This command cannot be used for the MD-X400(A)/450(A).
• See the figure below for the relationship between the internal lighting numbers and positions.
5 4 3
1 2
(7) Check the focus distance
Command FocusCheck 10 bytes
Measures the difference between the distance to the workpiece and the reference distance for the number of times
Description
specified in parameter A and returns its average value as the focus deviation amount.
Target None
Command WX,FocusCheck=A[CR]
WX
Response WX,OK,B[CR]
Command
RX None
Response
• If the Z coordinate of the position correction has been input, this value will be subtracted from the focus deviation amount.
• It cannot be used on the MD-X400(A)/450(A) series.
Target None
Command WX,ZtrackingPointCheck=A,B,C,D,E[CR]
WX
1
Response WX,OK,F,G[CR]
Command
RX None
Response
Communication Interface
A: Depends on the area size
X coordinate (mm)
Normal : -062.500~0062.500 8 bytes
* Default value “0”
Wide : -165.000~0165.000
Z coordinate (mm)
C: -21.000 to 021.000 7 bytes
* Default value “0”
Parameter
Measurement count
D: 1 to 10 2 bytes
* Default value “0”
Sampling cycle
E: 0 to 4 1 byte 0 (short) to 4 (long)
* Default value “0”
Target None
Command WX,XYTracking=A[CR]
WX
Response WX,OK,B,C,D,E,F,G[CR]
Command RX,XYTracking=A[CR]
RX
Response RX,OK,B,C,D,E,F,G[CR]
Result
0: Failure
G:0/1/2 1 byte
1: Success
2: Success (correlation value: low)
• The RX command acquires the result at the previous execution. The previous result will be cleared when changing the job No. of the
current operation.
• When there is no setting of the specified tracking No., S103 tracking No. no registration error will occur.
• When there is no result of the specified tracking No., S104 tracking result request error will occur.
• It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
Target None
Command WX,ZTracking=A[CR]
WX
Response WX,OK,B,C,D,E,F,G[CR]
1 RX
Command
Response
RX,ZTracking=A[CR]
RX,OK,B,C,D,E,F,G[CR]
Result
0: Failure
G: 0/1/2 1 byte 1: Success
2: Success (stability: low)
3: Success (out of tolerance range)
• The RX command acquires the result at the previous execution. The previous result will be cleared when changing the job No. of the
current operation.
• When there is no setting of the specified tracking No., S103 tracking No. no registration error will occur.
• When there is no result of the specified tracking No., S104 tracking result request error will occur.
• It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
Target None
Command WX,ZTrackingMatrixCell=A,B[CR]
WX
Response WX,OK,C,D,E,F,G,H[CR]
Command RX,ZTrackingMatrixCell=A,B[CR]
RX
Response RX,OK,C,D,E,F,G,H[CR]
Result
0: Failure
H: 0 to 3 1: Success
2: Success (stability: low)
3: Success (out of tolerance range)
• When 0 is set for the row and column headers, result acquisition is performed for the entire matrix. When Z tracking is set for each cell,
the average of the cells is returned. The result is 1: Success only when the result is a success for all the cells. Otherwise, the result is 0:
Failure.
• During execution, Z tracking is performed for the entire matrix or matrix cells regardless of the specified cell.
The response returns the result of the specified cell.
• More than one cell can be specified for result acquisition. Specify the cells in the format such as “RX,ZTrackingMatrixCell=A,B,A,B,A,B,”
and so on.
The result of this command will be “RX,OK,C,D,E,F,G,H,C,D,E,F,G,H,C,D,E,F,G,H,” and so on.
If any part of the result is failure, an error is returned.
• The RX command acquires the result of the last execution. The result of the last execution will be cleared when the job No. of the
currently operating job is changed.
• When the tracking produces no result, an S104 Tracking Result Request Error will occur.
• This command cannot be used for the MD-X2050(A)/400(A)/450(A).
(12) Set/Acquire the result of the Z tracking (matrix) (by specifying a cell number)
Command ZTrackingMatrixCellNo 21 bytes
Description Executes/acquires the result of the Z tracking for a matrix or a matrix cell specified with a cell number.
Target None
Command WX,ZTrackingMatrixCellNo=A[CR]
WX
Response WX,OK,B,C,D,E,F,G[CR]
RX
Command
Response
RX,ZTrackingMatrixCellNo=A[CR]
RX,OK,B,C,D,E,F,G[CR] 1
A: 00000 to 65025 5 bytes Cell number
Communication Interface
B: -042.000~0042.000 8 bytes Z coordinate deviation (mm)
Result
0: Failure
G: 0 to 3 1 bytes 1: Success
2: Success (stability: low)
3: Success (out of tolerance range)
• When 0 is set for the cell number, result acquisition is performed for the entire matrix. The RX command acquires the result of the last
execution. The result of the last execution will be cleared when the job No. of the currently operating job is changed.
• During execution, Z tracking is performed for the entire matrix or matrix cells regardless of the specified cell. The response returns the
result of the specified cell.
• More than one cell can be specified for result acquisition. Specify the cells in the format such as “RX,ZTrackingMatrixCellNo=A,A,A,” and
so on.
The result of this command will be “RX,OK,B,C,D,E,F,G,B,C,D,E,F,G,B,C,D,E,F,G,” and so on.
If any part of the result is failure, an error is returned.
• The RX command acquires the result of the last execution. The result of the last execution will be cleared when the job No. of the
currently operating job is changed.
• When the tracking produces no result, an S104 Tracking Result Request Error will occur.
• This command cannot be used for the MD-X2050(A)/400(A)/450(A).
Target None
Command WX,3AxisTracking
WX
Response WX,OK
Command
RX None
Response
Parameter None
• The results can be acquired by RX, XYTracking = A, and RX, ZTracking = A,RX,ZTrackingMatrixCell=A,B.
• This command cannot be used for the MD-X2050(A)/400(A)/450(A).
Target None
Command WX,ZTrackingManualCalibration[CR]
WX
Response WX,OK [CR]
Command
RX None
Response
Target None
Command WX,Lighting=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,Lighting[CR]
RX,OK,A[CR]
Status of lighting
Communication Interface
Target None
WX
Command
Response
WX,JobNo=A[CR]
WX,OK [CR]
1
Communication Interface
Command RX,JobNo[CR]
RX
Response RX,OK,A[CR]
• E015 “No Job Error” is returned if you specify a non-registered job No.
• An OK response is returned when a currently running job No. has been specified. At that point in time, the READY output becomes OFF
for an instant due to switching of the job No.
Command WX,JOB=0000,CTR=0,Counter=A,B[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,CTR=0,Counter[CR]
RX
Response RX,OK,A,B[CR]
Target None
Command WX,IoEncodedCharacter=A[CR]
WX
Response WX,OK [CR]
Command RX,IoEncodedCharacter[CR]
RX
Response RX,OK,A[CR]
This command returns a response very quickly as it is processed immediately regardless of the job expansion time.
Target None
Command
WX None
Response
Command RX,MarkedCharacter=A,B[CR]
RX
Response RX,OK,C[CR]
• The update characters are returned in the form of an actual marking string.
• Make sure to send this command after the marking. The S029 communication error “Mark data request error” is returned if you send the
command without performing any marking.
• In matrix marking, the response returns the mark data of the last marked cell (block).
• If you requested something in relation to the block other than the character strings, “ “ (blank data) will be returned in the response.
Target None
Command
WX None
Response
1 RX
Command
Response
RX,Error[CR]
RX,OK,A,B,B,B...[CR]
A: 0/1 1 byte
occurring, the response returns “0”, if it is, “1”.
Parameter
Displays the currently occurring errors in
B: E003 to E531/W001 to W531/T000 to T017 3 bytes
comma delimited format.
• If multiple errors are occurring in the laser marker, a response is returned in comma delimited format as follows.
RX,OK,1,E001,E002,W100,T000[CR]
• For details of each error, refer to the User's Manual of the laser marker unit.
Target None
Command WX,ErrorClear[CR]
WX
Response WX,OK[CR]
Command
RX None
Response
Parameter None
Controller setup/management
(1) Position correction (Set/Request)
Command AllPosition 11 bytes
Description Sets/Requests the position correction in the Controller Setup.
Target None
WX
Command
Response
WX,AllPosition=A,B,C,D,E,F[CR]
WX,OK [CR]
1
Communication Interface
Command RX,AllPosition[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
θ angle (°)
C: -180.000 to 0180.000 8 bytes
* Default value “0”
• This command is applied to all jobs. If the job pre-expansion function is enabled, it takes time because the response is returned after all
job expansion processings are finished.
• The X/Y rotations angle will be disabled in jobs containing blocks having other than a 3D shape of “XY plane”.
• The following restrictions exist in the case of on-the-fly marking.
• The coordinate correction with the same coordinate on the movement direction (X/Y coordinate) is disabled
• The rotation correction of the coordinate that crosses orthogonally on the movement direction (X/Y rotation angle) is disabled
• θ angle can be corrected up to ±2.000°
Target None
Command WX,TimeSetting=A,B,C,D,E,F[CR]
WX
Response WX,OK[CR]
Command RX,TimeSetting[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
B: 01 to 12 2 bytes Month
C: 01 to 31 2 bytes Day
Parameter
D: 00 to 23 2 bytes Hour
E: 00 to 59 2 bytes Minute
F: 00 to 59 2 bytes Second
Target None
Command WX,PowerOffset=A[CR]
WX
Response WX,OK[CR]
1 RX
Command
Response
RX,PowerOffset[CR]
RX,OK,A[CR]
• If the power offset value set to the block's laser power exceeds 100%, the value will be fixed at 100%.
• This command is applied to all jobs. If the job pre-expansion function is enabled, it takes time because the response is returned after all
job expansion processings are finished.
• This command is not applied to the block whose laser power is 0%.
Target None
Command WX,BarcodeVerification=A[CR]
WX
Response WX,OK[CR]
Command
RX None
Response
You can access Marking Builder Plus barcode verification screen by following the procedure below.
[Settings] tab > [Controller] > [Options] > [Register code] under [Barcode verification]
(5) Set/Request the shutter function as it relates to the laser safety module operation.
Command LaserSafetyModuleShutter 24 bytes
Description Set/Request the shutter to open/close when the laser safety module input is off.
Target None
Command WX,LaserSafetyModuleShutter=A
WX
Response WX,OK
Command RX,LaserSafetyModuleShutter
RX
Response RX,OK,A
Shutter status
0: Do not close the shutter when the safety
Parameter A:0/1 1 byte input is off
1: Close the shutter when the safety input is off
* Default value “0”
When the shutter status turns to “1”, the restoration time from the safety input on will be extended.
Target None
Command WX,PrintCompTiming=A
WX
Response WX,OK
Command RX,PrintCompTiming
RX
Response RX,OK,A
Target None
Command WX,AddRouteTable=A,B,C[CR]
WX
Response WX,OK[CR]
RX
Command
Response
None
1
A:000.000.000.000 to 255.255.255.254 15 bytes Destination address
Communication Interface
Parameter B:000.000.000.000 to 255.255.255.255 15 bytes Mask setting
• Up to four routing tables can be registered. When the registration exceeds the upper limit, an S111 error will be returned.
• The values out of the subnet mask range of the destination address should be set to 0.
• When the same destination address is specified, the table will be overwritten. (This does not apply to the mask setting and transfer
destination gateway.)
• When the destination address is set to 255.255.255.255, an S024 error will occur.
• If the transfer gateway address is not belong to the LAN1 or LAN2 network, an S024 error will occur.
Target None
Command
WX None
Response
Command RX,GetRouteTableSettingNum[CR]
RX
Response RX,OK,A[CR]
Target None
Command
WX None
Response
Command RX,GetRouteTableSetting=A[CR]
RX
Response RX,OK,B,C,D[CR]
• The information of the registered tables can be acquired. If there are no settings, 0 is returned for all parameters.
• When the value of the table index is out of range, S024 is returned.
Target None
Command WX,DeleteRouteTable=A,B[CR]
WX
Response WX,OK[CR]
Command
RX None
Response
• The table that matches the destination address and mask setting will be deleted.
• When 255.255.255.255 is specified for the destination address, an S024 error will occur.
Target None
Command WX,DeleteAllRouteTable[CR]
WX
Response WX,OK[CR]
1 RX
Command
Response
None
Target None
Command WX,ZTiming=A,B[CR]
WX
Response WX,OK[CR]
Command RX,ZTiming[CR]
RX
Response RX,OK,A,B[CR]
For job files that do not include matrix settings, the Z timing value is applied regardless of the parameter B setting.
Job No.
(1) Moving/stationary marking setting (Set/Request)
Command OnTheFly 8 bytes
Description Toggles the stationary/movement marking setting and changes/requests the movement direction.
WX
Command
Response
WX,JOB=0000,OnTheFly=A,B[CR]
WX,OK [CR]
1
Communication Interface
Command RX,JOB=0000,OnTheFly[CR]
RX
Response RX,OK,A,B[CR]
Moving direction
Parameter Sets the line flow direction.
0: Bottom
B: 0 to 3 1 byte 1: Right
2: Top
3: Left
* A: Fixed value of “0” when 0
The line flow direction will be determined with reference to the direction in which the tip of the laser head is set pointing to the left.
Command WX,JOB=0000,HeadDirection=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,HeadDirection[CR]
RX
Response RX,OK,A[CR]
Head orientation
Sets the orientation of the head with reference
to the marking area.
0: left
1: Left (Mirror invert)
2: Right (Mirror invert)
Parameter A:0 to 7 1 bytes
3: Right
4: Bottom (Mirror invert)
5: Top
6: Bottom
7: Top (Mirror invert)
* Default value “0”
Command WX,JOB=0000,MarkingOrder=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,MarkingOrder[CR]
RX
Response RX,OK,A[CR]
Marking order
0: Group/block no. order
Parameter A:0/1 1 byte
1: Auto
* Default value “0”
Command WX,JOB=0000,ContinuousStationaryMarking=A,B,C[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,ContinuousStationaryMarking[CR]
RX
Response RX,OK,A,B,C[CR]
Communication Interface
Command WX,JOB=0000,OnTheFlyMarking=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,OnTheFlyMarking[CR]
RX
Response RX,OK,A,B,C,D[CR]
Moving method
0: Constant
A:0/1 1 byte
1: Encoder
* Default value “0”
Command WX,JOB=0000,OnTheFlyTriggerDelay=A,B[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,OnTheFlyTriggerDelay[CR]
RX
Response RX,OK,A,B[CR]
Command WX,JOB=0000,OnTheFlyContinuousMarking=A,B,C[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,OnTheFlyContinuousMarking[CR]
RX
Response RX,OK,A,B,C[CR]
Communication Interface
Continuous marking setting
0: Mark while trigger ON
A:0/1/2 1 bytes 1: Continuous marking disabled
2: Continuous marking enabled
* Default value “1”
Parameter
Continuous marking count (times)
B: 00002 to 65535 5 bytes
* A: Fixed value of “2” when 0/1
Command WX,JOB=0000,OnTheFlyMarkingArea=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,OnTheFlyMarkingArea[CR]
RX
Response RX,OK,A,B,C[CR]
Command WX,JOB=0000,JobPosition=A,B,C,D,E[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,JobPosition[CR]
RX,OK,A,B,C,D,E[CR]
• The θ angle correction is performed, where the origin is the position where the correction amount has been applied to the movement
reference point.
• Workpiece position adjustment is only enabled for stationary marking.
Command WX,JOB=0000,HeightCorrection=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,HeightCorrection[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
If out of range,
1: Mark (warning output)
F: 1/2 1 byte 2: Do not mark (error output)
* A: Fixed value of “1” when 0
* Default value “1”
Command WX,JOB=0000,CommonMarkingParameter=A,B,C,D,E,F,G,H,I,J,K,L[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,CommonMarkingParameter[CR]
RX,OK,A,B,C,D,E,F,G,H,I,J,K,L[CR] 1
Common laser power (%)
Communication Interface
A:000.0 to 100.0 5 bytes
* Default value “0”
The fixed value is input for the end point control. It cannot be changed.
Command WX,JOB=0000,MarkingEnergy=A,B,C,D[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,MarkingEnergy[CR]
RX,OK,A,B,C,D[CR]
0: Disabled
A:0/1 1 byte
1: Enabled
* Default value “0”
• Marking energy check will be canceled when the next trigger is accepted within 2 seconds of completion of the marking. Therefore, make
sure to allow at least 2 seconds between the marking completion and the next marking start.
• It cannot be used on the MD-X400(A)/450(A) series.
Command WX,JOB=0000,ScannerWaiting=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,ScannerWaiting[CR]
RX
Response RX,OK,A,B,C,D[CR]
Standby coordinate
0: Auto
A:0/1 1 byte
1: Custom coordinate
* Default value “0”
When setting the standby coordinate to auto, standby is done on the coordinate where the scanner will be used firstly at work flow.
Target None
Command WX,JOB=0000,CameraWaitingScale=A[CR]
WX
Response WX,OK[CR]
RX
Command
Response
RX,JOB=1000,CameraWaitingScale[CR]
RX,OK,A 1
Camera magnification
Communication Interface
0: Fixed camera (Wide)
Parameter A:0 to 3 1 byte 1 Fixed camera (Standard)
2: Coaxial Camera (Wide)
3: Coaxial Camera (Standard)
• The fixed camera cannot be selected for the MD-X2050(A). If the command is executed, an S024 Illegal Command Error will occur.
• This command cannot be used for the MD-X400(A)/450(A). If the command is executed, an S095 Model Limitation Error will occur.
• When the camera magnification is set with the CameraWaitingScale command, the lighting conditions specified in the job settings are
applied, so it is recommended to set these conditions with the CameraWaitingLight command.
Command WX,JOB=0000,CameraWaitingLight=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,CameraWaitingLight[CR]
RX
Response RX,OK,A[CR]
This command cannot be used for the MD-X2050(A)/400(A)/450(A). If the command is executed, an S095 Model Limitation Error will occur.
Command WX,JOB=0000,CameraWaitingExternalLight=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,CameraWaitingExternalLight[CR]
RX
Response RX,OK,A[CR]
When the lighting status of the external lighting is set to On, terminal number 40, External Lightning Control Output, turns on during standby.
Command WX,JOB=0000,LightingType=A
WX
Response WX,OK
Command RX,JOB=0000,LightingType
RX
Response RX,OK,A
Command WX,JOB=0000,ApproachScanSpeed=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,ApproachScanSpeed[CR]
RX,OK,A[CR]
String/Logo/Barcode setting
(1) Block type (Set/Request)
Command BlockType 9 bytes
Description Sets/Requests the block type.
WX
Command
Response
WX,JOB=0000,BLK=000,BlockType=A[CR]
WX,OK [CR]
1
Communication Interface
Command RX,JOB=0000,BLK=000,BlockType[CR]
RX
Response RX,OK,A[CR]
Block type
-04: Hatch logo
-03: Photo
-02: Workpiece image logo
-01: Logo
Parameter A:-04 to 004/009 3 bytes 000: Horizontal characters
001 :Vertical characters
002: Arc clockwise
003: Arc counterclockwise
004: Fixed Point
009: Barcode, 2D code
• When creating a new block, send this command to a non-registered block No.
• When you change the block type, the association with the 3D shape No. and the X/Y/Z coordinate layout information will be initialized.
• Fixed point is only supported in stationary marking.
• When the changing command is sent, the character string becomes (a) space(s).
Command WX,JOB=0000,BLK=000,CodeType=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,BLK=000,CodeType[CR]
RX
Response RX,OK,A[CR]
Barcode type
01: CODE39
02: ITF
03: 2of5
04: NW7
05: JAN
06: CODE128
07: QR Code Model 1
08: QR Code Model 2
09: Micro QR Code
Parameter A:01 to 16 2 bytes
10: DataMatrix ECC200
11: GS1 DataBar(Truncated)
12: GS1 DataBar(Truncated) CC-A
13: GS1 DataBar Stacked
14: GS1 DataBar Stacked CC-A
15: GS1 DataBar Limited
16: GS1 DataBar Limited CC-A
17: GS1 DataMatrix
18: CODE93
* Default value “1”
This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code”.
Command WX,JOB=0000,BLK=000,CharacterString=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,CharacterString[CR]
RX,OK,A[CR]
• This command can be sent to a block No. having the block type (BlockType) of “-4: Hatch logo/-3: Photo/-2: Workpiece image/-1: Logo/00:
Horizontal characters/01: Vertical characters/02: Arc clockwise/03: Arc counterclockwise/09: Barcode/2D Code”.
• To send a “, (comma)” as a string, send it in the form of “%044A” (ASCII).
• To send a “%” as a string, send it in the form of “%%” (ASCII).
• To set update characters, send the following in ASCII format.
1
Year: 4 digits None %4Y %4T Y - -
None %2Y %2T Y -
Year: 2 digits
yes %2P Y %2P T Y
Communication Interface
None %1Y %1T Y
Year: 1 digits - -
yes %1P Y %1P T Y
Right-aligned Right-aligned
%2M %2T M
None %02M %02T M
Month Left-aligned Left-aligned
%-2M %-2T M
yes %2P M %2P T M - -
Right-aligned Right-aligned
%2D %2T D
None %02D %02T D
Day Left-aligned Left-aligned
%-2D %-2T D
yes %2P D %2P T D - -
Right-aligned Right-aligned
%2h %2T h
None %02h %02T h
Hour Left-aligned Left-aligned
%-2h %-2T h
yes %2P h %2P T h - -
Right-aligned Right-aligned
%2m %2T m
None %02m %02T m
Minute Left-aligned Left-aligned
%-2m %-2T m
yes %2P m %2P T m - -
Right-aligned
%2s
Second None %02s
Left-aligned
%-2s
Right-aligned Right-aligned
%3X %3T X
None %03X %03T X
365 days Left-aligned Left-aligned
%-3X %-3T X
yes %3P X %3P T X - -
None %1B %1T B - -
Day of week
yes %1P B %1P T B -
Week yes %2P W %2P T W - -
Time zone yes %P S - -
Encoding
Type Zero suppression Padding Alignment
yes None
None - - %0 P C C %0 C C
Auto - %P C C %C C
Serial counter
yes Right-aligned % P C C % C C
Specify Digits
1
Left-aligned %- P C C %- C C
● is the encoding No. (0 to 9), ■ is the counter No. (0 to 9, A to J), and ▲ is the No. of digits (1 to 10).
is the block No. (000 to 255) and is the referenced AI number (Nth AI).
The range specification options add the following before the “>” symbol.
“SxxxLxxx”: S is set with the start position, L is set with the number of reference characters, and XXX is set with the number of characters
(001 to 510).
• Send the following by ASCII when a control code is set to the barcode or 2D code.
Control code Setting code Control code Setting code Control code Setting code
Command WX,JOB=0000,BLK=000,CharacterFont=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,CharacterFont[CR]
RX,OK,A,B,C,D,E,F[CR] 1
Font No.
Communication Interface
-1: Quick
00: Standard
A:00 to 11 2 bytes 01: Small
02 to 11: User font
* Quick: Available on only MD-U1000 series
* Default value “0”
Line type
0: Single
B: 0 to 2 1 byte 1: Multiple
2: Wobble
* Default value “0”
• This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/01: Vertical characters/02: Arc
clockwise/03: Arc counterclockwise”. Cannot be sent to the block of TrueTypeFont.
• Multiple and Wobble thicknesses can be set to a ratio of up to x0.2 compared to the smaller character height or width.
Command WX,JOB=0000,BLK=000,CharacterSize=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,CharacterSize[CR]
RX,OK,A,B,C,D,E,F[CR]
Character Layout
0: Character space
C:0/1/3 1 byte
1: Distribute
3: Character pitch
Parameter
D: Depends on the area size
Normal : 000.000 to 180.000 Space (mm)
8 bytes
Other model : “Character space” of “Model- * Default value “0.5”
Specific Input Value List” (Page 1-92)
• This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/01: Vertical characters/02: Arc
clockwise/03: Arc counterclockwise”.
• You can only set the character height/width ratio between x0.2 and x5.
• The character width and character spacing cannot be set when the ratio specification or proportional is enabled and when the font is a
TrueTypeFont. Also, they cannot be set when the character spacing of C is other than 0.
• C to F: Cannot be set when the character string is circle layout.
• The character pitch can be set for a TrueType font only.
Command WX,JOB=0000,BLK=000,LogoSize=A,B[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,LogoSize[CR]
RX
Response RX,OK,A,B[CR]
• This command can be sent to a block No. having the block type (BlockType) of “-4: Hatch logo/-2: Workpiece image/-1: Logo”.
• When the aspect ratio is maintained, the logo height is set automatically based on the value of the logo width.
Command WX,JOB=0000,BLK=000,CharacterProportional=A,B[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,CharacterProportional[CR]
RX,OK,A,B[CR] 1
Proportional setting
Communication Interface
0: Disabled
A:0/1 1 byte
1: Enabled
Parameter * Default value “0”
This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/02: Arc clockwise/03: Arc
counterclockwise”.
Command WX,JOB=0000,BLK=000,CharacterRatio=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,CharacterRatio[CR]
RX
Response RX,OK,A,B,C[CR]
Ratio setting
0: Disabled
A:0/1 1 byte
1: Enabled
* Default value “0”
• This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/01: Vertical characters/02: Arc
clockwise/03: Arc counterclockwise”.
• The ratio specification cannot be set in the case of TrueTypeFont.
Command WX,JOB=0000,BLK=000,ArcCharacter=A,B,C,D,E[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,ArcCharacter[CR]
RX,OK,A,B,C,D,E[CR]
0: Character space
A:0 to 2 1 bytes 1: Angular interval
2: Distribute angle
* Default value “0”
This command can be sent to a block No. having the block type (BlockType) of “02: Arc clockwise/03: Arc counterclockwise”.
Command WX,JOB=0000,BLK=000,CodeSetting=A,B,C,D[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,CodeSetting[CR]
RX
Response RX,OK,A,B,C,D[CR]
Communication Interface
Format
0: Normal
A:0/1/2 1 byte 1: Black/White inversion
2: Overprinting
* Default value “0”
Check Digit
0: None
1: Yes
B:0/1 1 byte
* Fixed value of “0” when the code type is
other than CODE39/ITF/NW7
* Default value “0”
DataMatrix 06 macro
0: None
Parameter 1: Add
C:0/1 1 byte
* Fixed value of “0” when the code type is
other than DataMatrix ECC200
* Default value “0”
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code”.
• If “Overprinting” is selected as the format, overprinting No.0 will be assigned to “Base” and overprinting No.1 will be assigned to “Code”,
respectively. Then, set the overprinting marking parameters (MultiPassMarkingParameter), overprinting pattern (MultiPassPattern), and
overprinting fill parameters (MultiPassFillParameters).
• If you set the format to “Normal or Black/White Inversion”, the parameters in all overprinting No. will be initialized.
• The format of “2: Overprinting” cannot be selected in the case of JAN/EAN/UPC/GS1 DataBar.
• The error correction proportion of a QR code cannot be set to H (30%) in the case of the micro QR.
Command WX,JOB=0000,BLK=000,BarcodeSize=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,BarcodeSize[CR]
RX
Response RX,OK,A,B,C,D[CR]
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“01: CODE39/02: ITF/03: 2of5/04: NW7/05: JAN/06: CODE128/18: CODE93”.
• The bar ratio cannot be set in the case of JAN/EAN/UPC/CODE93/CODE128.
• The quiet zone cannot be set when the format is “Normal.”
Command WX,JOB=0000,BLK=000,GS1DataBarSize=A,B,C,D,E,F[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,GS1DataBarSize[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
Communication Interface
Guard (x)
E:00 to 10 2 bytes
* Default value “0”
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of “11
to 16: GS1 DataBar”.
• The guard can be set when the format is “Black/white inversion.”
• The quiet zone can be set when CC-A and the format is “Black/white inversion.”
Command WX,JOB=0000,BLK=000,DataMatrixSize=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,DataMatrixSize[CR]
RX
Response RX,OK,A,B,C[CR]
Symbol size
0001:10x10 0020:16x48 0033:8 x 80
0004:16x16 0023:72x72 0034:8 x 96
0007:22x22 0026:96x96 0035:8 x 120
0010:32x32 0029:132x132 0036:8 x 144
0013:44x44 0003:14x14 0037:12 x 64
0016:8x32 0006:20x20 0038:12 x 88
0019:16x36 0009:26x26 0039:16 x 64
A:0001 to 0030 4 bytes 0022:64x64 0012:40x40 0040:20 x 36
0025:88x88 0015:8x18 0041:20 x 44
Parameter 0028:120x120 0018:12x36 0042:20 x 64
0002:12x12 0021:52x52 0043:22 x 48
0005:18x18 0024:80x80 0044:24 x 48
0008:24x24 0027:104x104 0045:24 x 64
0011:36x36 0030:144x144 0046:26 x 40
0014:48x48 0031:8 x 48 0047:26 x 48
0017:12x16 0032:8 x 64 0048:26 x 64
Cell size (mm)
B: 00.010 to 05.000 6 bytes
* Default value “0.2”
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“10: DataMatrix, 17: GS1 DataMatrix”.
• The quiet zone cannot be set when the format is “Normal.”
Command WX,JOB=0000,BLK=000,DataMatrixCellSizeRatioX=A[CR]
WX
Response WX,OK[CR]
RX
Command
Response
RX,JOB=0000,BLK=000,DataMatrixCellSizeRatioX[CR]
RX,OK,A[CR] 1
Parameter A:050.0 to 200.0 5 bytes Ratio (%)
Communication Interface
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“10: DataMatrix, 17: GS1 DataMatrix”.
Command WX,JOB=0000,BLK=000,DataMatrixCellSizeRatioY=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,BLK=000,DataMatrixCellSizeRatioY[CR]
RX
Response RX,OK,A[CR]
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“10: DataMatrix, 17: GS1 DataMatrix”.
Command WX,JOB=0000,BLK=000,QRCodeSize=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,QRCodeSize[CR]
RX
Response RX,OK,A,B,C,D[CR]
Version
1: 1/M1 2: 2/M2 3: 3/M3
4: 4/M4 5: 5/M5 6: -/M6
7: -/M7 8: -/M8 9: -/M9
10: -/M10 11: -/M11 12: -/M12
13: -/M13 14: -/M14 15: -/M15
16: -/M16 17: -/M17 18: -/M18
A:0001 to 0030 4 bytes
19: -/M19 20: -/M20 21: -/M21
22: -/M22 23: -/M32 24: -/M24
25: -/M25 26: -/M26 27: -/M27
28: -/M28 29: -/M29 30: -/M30
Parameter * Default value “0”
* The input range for Model 1 is “0 to 14”
* The input range for Micro QR is “0 to 4”
Mode Auto
0: Disabled
C:0/1 1 byte
1: Enabled
* Default value “1”
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“07: QR Model 1/08: QR Model 2/09: Micro QR”.
• The mode AUTO cannot be set in the case of the micro QR.
• The quiet zone can be set when the format is “Black/white inversion.”
Command WX,JOB=0000,BLK=000,QRCodeCellSizeRatioX=A[CR]
WX
Response WX,OK[CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,QRCodeCellSizeRatioX[CR]
RX,OK,A[CR]
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“07: QR Model 1/08: QR Model 2/09: Micro QR”.
• The mode AUTO cannot be set in the case of the micro QR.
Command WX,JOB=0000,BLK=000,QRCodeCellSizeRatioY=A[CR]
WX
Response WX,OK[CR]
Command RX,JOB=0000,BLK=000,QRCodeCellSizeRatioY[CR]
RX
Response RX,OK,A[CR]
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code” AND barcode type (CodeType) of
“07: QR Model 1/08: QR Model 2/09: Micro QR”.
• The mode AUTO cannot be set in the case of the micro QR.
Command WX,JOB=0000,BLK=000,BlockPosition=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,BlockPosition[CR]
RX
Response RX,OK,A,B,C[CR]
Command WX,JOB=0000,BLK=000,BlockLayout=A,B,C,D,E[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,BlockLayout[CR]
RX,OK,A,B,C,D,E[CR] 1
Block reference point:
Communication Interface
0: Left
1: Right
2: Center
3: Lower left
A:0 to 8 1 bytes 4: Lower right
5: Upper left
6: Upper right
7: Top
8: Bottom
* Default value “3”
This command can be sent to a block No. having the block type (BlockType) of other than “04: Fixed point”.
Command WX,JOB=0000,BLK=000,FixedPointProcessingTime=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,FixedPointProcessingTime[CR]
RX
Response RX,OK,A[CR]
This command can be sent to a block No. having the block type (BlockType) of “04: Fixed point”.
Marking parameters
(1) Marking parameters (Set/Request)
Command MarkingParameter 16 bytes
Description Sets/Requests the laser power, scan speed, pulse frequency, spot variable, and marking count of a block.
1 WX
Command
Response
WX,JOB=0000,BLK=000,MarkingParameter=A,B,C,D,E[CR]
WX,OK [CR]
Communication Interface
Command RX,JOB=0000,BLK=000,MarkingParameter[CR]
RX
Response RX,OK,A,B,C,D,E[CR]
Command WX,JOB=0000,BLK=000,CodePattern=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,CodePattern[CR]
RX,OK,A,B,C,D,E,F[CR] 1
Pattern
Communication Interface
(QR Code/DataMatrix/Bar Code)
000: -/-/Alternate
001: Pattern 1/A/Unidirectional
002: Pattern 2/B/-
003: Pattern 3/C/-
004: Pattern 4/D/-
005: Pattern 5/E/-
006: Pattern 6/F/-
007: Pattern 7/Entire pattern 1/-
A:000 to 13/254 3 bytes 008: Entire pattern 1/Entire pattern 2/-
009: Entire pattern 2/Entire pattern 3/-
010: Entire pattern 3/Entire pattern 4/-
011: Entire pattern 4/Entire pattern 5/-
012: Entire pattern 5/Entire pattern 6/-
013: Entire pattern 6/-/-
254: Individual/Individual/ -
* Default value “9” for QR, DataMatrix, “0” for
Bar Code
* Entire pattern 5/6: Available on only MD-
U1000 series
Finder
000: None
001: F1
002: F2
B: 000 to 002/255 3 bytes
255: Cell
* QR Code and B: Fixed value of “0” when
other than 0 to 2
* Default value “1”
Parameter Alignment
000: None
001: A1
002: A2
C:000 to 002/255 3 bytes
255: Cell
* DataMatrix and C: Fixed value of “0” when
other than 0 to 2
* Default value “1”
Cell
(QR Code/DataMatrix)
000: None/None
001: M1/C1
002: M2/C2
003: M3/C3
D: 000 to 008 3 bytes
004: M4/C4
005: M5/C5
006: M6/C6
007: M7/C7
008: M8/C8
* Default value “1”
• This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code”.
• “D: 0” cannot be set when “B: 0/255.”
• “D: 0” cannot be set when “C: 0/255.”
Command WX,JOB=0000,BLK=000,HatchPattern=A,B,C,D,E,F,G[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,HatchPattern[CR]
RX,OK,A,B,C,D,E,F,G[CR]
Fill Type
Communication Interface
0: Boundary + Fill
A:0 to 2 1 bytes 1: Fill
2: Boundary
* Default value “0”
Pattern
0: Slant
2: Cross
B: 0 to 3 1 byte
3: Contour
* A: Fixed value of “0” when 2
* Default value “0”
Slant/Cross direction
0: Right to Left
1: Left to Right
2: Left to right, Right to left
3: Right to left, Left to right
C: 0 to 5 1 byte
4: Left to right, Right to left (High Speed)
5: Right to left, Left to right (High Speed)
* Fixed value of “2” when A is 0 or B is 2
* Default value “2”
Parameter * 4/5: Available on only MD-U1000 series
Contour direction
0: Clockwise
1: Counterclockwise
D: 0 to 3 1 byte 2: Clockwise to Counterclockwise
3: Counterclockwise to Clockwise
* Fixed value of “0” when A is 2 or B is 0/1
* Default value “0”
This command can be sent to a block No. having the block type (BlockType) of “-4: Hatch logo”.
Command WX,JOB=0000,BLK=000,TTFPattern=A,B,C,D,E[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,TTFPattern[CR]
RX,OK,A,B,C,D,E[CR] 1
Fill Type
Communication Interface
0: Boundary + Fill
A:0 to 2 1 byte 1: Fill
2: Boundary
* Default value “0”
Pattern
0: Slant
B:0/2 1 byte 2: Cross
* A: Fixed value of “0” when 2
* Default value “0”
Fill direction
0: Right to Left
1: Left to Right
Parameter
2: Left to right, Right to left
3: Right to left, Left to right
C: 0 to 5 1 byte
4: Left to right, Right to left (High Speed)
5: Right to left, Left to right (High Speed)
* A: Fixed value of “2” when 2/3
* Default value “2”
* 4/5: Available on only MD-U1000 series
This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/01: Vertical characters/02: Arc
clockwise/03: Arc counterclockwise” AND the font type of TrueType font.
Command WX,JOB=0000,BLK=000,CodeFillParameter=A,B[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,CodeFillParameter[CR]
RX
Response RX,OK,A,B[CR]
This command can be sent to a block No. having the block type (BlockType) of “09: Barcode/2D Code”.
Command WX,JOB=0000,BLK=000,HatchParameter=A,B,C,D,E,F,G,H[CR]
1
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,HatchParameter[CR]
RX
Response RX,OK,A,B,C,D,E,F,G,H[CR]
Communication Interface
Overprinting setting
0: Disabled
D:0/1 1 bytes
1: Enabled
Parameter * Default value “0”
Overprinting direction
0: Alternate
E: 0/1 1 byte
1: Forward
* Default value “0”
Overprinting count
F: 001 to 255 3 bytes
* Default value “1”
Writing Order
0: Boundary -> Fill
H:0/1 1 byte
1: Fill -> Boundary
* Default value “1”
This command can be sent to a block No. having the block type (BlockType) of “-4: Hatch logo” and the fill type in hatch logo pattern setting
(HatchPattern) of 0: Boundary + Fill/1: Fill”.
Command WX,JOB=0000,BLK=000,TTFParameter=A,B,C,D,E,F,G,H[CR]
WX
1
Response WX,OK[CR]
Command RX,JOB=0000,BLK=000,TTFParameter[CR]
RX
Response RX,OK,A,B,C,D,E,F,G,H[CR]
Communication Interface
Fill interval (mm)
* Fixed value of “9.999” if the common block
A:0.000 to 1.000/9.999 5 bytes marking parameters are referenced
* Default value “Normal: 0.06”/”Wide:
0.08”/”Small: 0.03”
Shrink fill
B: 00.000 to 10.000 6 bytes
* Default value “0”
Overprinting setting
0: Disabled
D:0/1 1 bytes
1: Enabled
Parameter * Default value “0.”
Overprinting direction
0: Alternate
E: 0/1 1 bytes
1: Forward
* Default value “0.”
Overprinting count
F: 001 to 255 3 bytes
* Default value “1”
Writing order
0: Boundary -> Fill
H:0/1 1 bytes
1: Fill -> Boundary
* Default value “1”
This command can be sent to a block No. having the block type (BlockType) of “00: Horizontal characters/01: Vertical characters/02: Arc
clockwise/03: Arc counterclockwise” AND the font type of TrueType AND the fill type in the TrueType font pattering setting (TTFPattern) of “0:
Boundary + Fill/1: Fill”.
Command WX,JOB=0000,BLK=000,PhotoSetting=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,PhotoSetting[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
Gamma correction
A: 0.01 to 9.99 (High resolution only) 4 bytes
Default value “0.6”
Contrast
A: -128 to 0127 (High resolution only) 4 bytes
Default value “0”
Contrast enhancement
0: Disabled
C: 0/1 (High resolution only) 1 byte
1: Enabled
Parameter Default value “0”
Brightness
D: -128 to 0127 (High resolution only) 4 byte
Default value “0”
Skip dots
E: 1 to 8 (Grayscale only) 1 byte
Default value “1”
Intensity
F: 1 to 8 (Grayscale only) 1 byte
Default value “3”
• This command can be sent to a block No. having the block type (BlockType) of “-3: Photo”.
• It cannot be used on the MD-F3200/5200 series.
Command WX,JOB=0000,BLK=000,MarkingEnable=A,BBB---[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
None
To change the marking flag of multiple blocks in a batch, send parameter B in multiple digits.
To set block No.10 to ON, No.11 to OFF, No.12 to ON and all other blocks to OFF, send the command as described below.
WX,JOB=0000,BLK=010,MarkingEnable=0,101[CR]
Command WX,JOB=0000,BLK=000,FillMarkingParameter=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,FillMarkingParameter[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
This command can be sent to a block No. having the block type (BlockType) of “-4: Hatch logo” or TrueTypeFont.
Command WX,JOB=0000,BLK=000,JumpSpeed=A[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,BLK=000,JumpSpeed[CR]
RX,OK,A[CR] 1
Jump speed
Communication Interface
0: Top Speed
Parameter A:0/1/2 1 byte 1: High Speed
2: Medium Speed
* Default value “0”
This command is enabled when the quality level (MarkingQuality) is not “05: Customize”.
Command WX,JOB=0000,BLK=000,MarkingQuality=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,MarkingQuality[CR]
RX
Response RX,OK,A,B,C[CR]
Quality Level
00: Top speed
01: Speed priority
02: Standard
Parameter 03: High quality
B: 00 to 06/99 2 bytes 04: Top quality
05: Customize
06: Top speed
* Fixed value of “99” if the common block
marking parameters are referenced
* Default value “02”
The skip cross can be set only for the character strings except TrueTypeFont.
Command WX,JOB=0000,BLK=000,Approach=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,Approach[CR]
RX
Response RX,OK,A[CR]
This command is enabled when the quality level (MarkingQuality) is “05: Customize”.
Command WX,JOB=0000,BLK=000,SpaceApproach=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,SpaceApproach[CR]
RX,OK,A[CR]
This command is enabled when the quality level (MarkingQuality) is “05: Customize”.
Command WX,JOB=0000,BLK=000,CurveCorrection=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,CurveCorrection[CR]
RX
Response RX,OK,A[CR]
Curve correction
0: Disabled
Parameter A:0/1 1 byte
1: Enabled
* Default value “1”
Target
WX
Command
JOB=0000 to 1999,BLK=000 to 255,OLP=0 to 9
WX,JOB=0000,BLK=000,OLP=0,MultiPassMarkingParameter=A,B,C,D,E,F,G[CR] 1
Response WX,OK [CR]
Communication Interface
Command RX,JOB=0000,BLK=000,OLP=0,MultiPassMarkingParameter[CR]
RX
Response RX,OK,A,B,C,D,E,F,G[CR]
Format
0: Code
A:0 to 2 1 byte 1: Code (Black/white inversion)
2: Base
* Default value “2”
• This command can be sent when the type of block (BlockType) is “09: Barcode/2D code” and the format setting of the barcode or 2D code
related settings (CodeSetting) is the block No. of “2: Overprinting.”
• The overprinting can be added when insetting No. is specified so that it becomes consecutive number at OLP.
Command WX,JOB=0000,BLK=000,OLP=0,MultiPassPattern=A,B,C,D,E,F[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,OLP=0,MultiPassPattern[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
Communication Interface
Pattern
(QR Code/DataMatrix/2D Code base/Bar Code/
Bar Code base)
000: -/-/-/Alternate/-
001: Pattern 1/A/B1/Unidirectional/Alternate
002: Pattern 2/B/B2/-/Unidirectional
003: Pattern 3/C/B3/-/Alternate (Horiz.)
004: Pattern 4/D/B4/-/Unidirectional (Horiz.)
005: Pattern 5/E/B5/-/-
006: Pattern 6/F/B6/-/-
007: Pattern 7/Entire pattern 1/B7/-/-
A:000 to 13/254 3 bytes
008: Entire pattern 1/Entire pattern 2/B8/-/-
009: Entire pattern 2/Entire pattern 3/B9/-/-
010: Entire pattern 3/Entire pattern 4/-/-/-
011: Entire pattern 4/Entire pattern 5/-/-/-
012: Entire pattern 5/Entire pattern 6/-/-/-
013: Entire pattern 6/-/-/-/-
254: Individual/Individual/-/-/-
* Default value “0” for Bar Code, “9” for 2D
Code
* B7/8/9, Entire pattern 5/6: Available on only
MD-U1000 series
Finder
000: None
001: F1
002: F2
B: 000 to 002/255 3 bytes
255: =Cell
* QR Code and B: Fixed value of “0” when
other than 0 to 2
Parameter * Default value “0”
Alignment
000: None
001: A1
002: A2
C:000 to 002/255 3 bytes
255: =Cell
* DataMatrix and C: Fixed value of “0” when
other than 0 to 2
* Default value “0”
• This command can be sent when the type of block (BlockType) is “09: Barcode/2D code” and the format setting of the barcode or 2D code
related settings (CodeSetting) is the block No. of “2: Overprinting.”
• “D: 0” cannot be set when “B: 0/255”.
• “D: 0” cannot be set when “C: 0/255”.
Command WX,JOB=0000,BLK=000,OLP=0,MultiPassFillParameters=A,B[CR]
WX
1
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,OLP=0,MultiPassFillParameters[CR]
RX
Response RX,OK,A,B[CR]
Communication Interface
Fill interval (mm)
* Fixed value of “9.999” if the common block marking
A:0.000 to 1.000/9.999 5 bytes
parameters are referenced
Parameter * Default value “Normal: 0.06”/”Wide: 0.08”/”Small: 0.03”
This command can be sent when the type of block (BlockType) is “09: Barcode/2D code” and the format setting of the barcode or 2D code
related settings (CodeSetting) is the block No. of “2: Overprinting.”
Command WX,JOB=0000,BLK=000,OLP=0,MultiPassQualityLevel=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,OLP=0,MultiPassQualityLevel[CR]
RX
Response RX,OK,A[CR]
Quality Level
00: Top speed
01: Speed priority
02: Standard
Parameter A: 00 to 06 2 bytes 03: High quality
04: Top quality
05: Customize
06: Top speed
* Default value “02”
Command WX,JOB=0000,BLK=000,OLP=0,MultiPassApproach=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,OLP=0,MultiPassApproach[CR]
RX
Response RX,OK,A[CR]
This command is enabled when the quality level of barcode/2D code overprinting (MultiPassQualityLevel) is “05: Customize”.
Command WX,JOB=0000,BLK=000,OLP=0,MultiPassSpaceApproach=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,OLP=0,MultiPassSpaceApproach[CR]
RX,OK,A[CR]
This command is enabled when the quality level of barcode/2D code overprinting (MultiPassQualityLevel) is “05: Customize”.
Curve correction
0: Disabled
Parameter A:0/1 1 byte
1: Enabled
* Default value “0”
Jump speed
0: Top Speed
Parameter A:0/1/2 1 byte 1: High Speed
2: Medium Speed
* Default value “0”
This command is enabled when the quality level of barcode/2D code overprinting (MultiPassQualityLevel) is not “05: Customize”.
(9) Wait time for start marking of barcode/2D code overprinting (Set/Request)
Command MultiPassBlockMarkingDelayTime 30 bytes
In barcode/2D code overprinting settings, specify the overprinting order and change/request the wait time for start
Description
marking.
3D shape setting
(1) 3D shape setting (Set/Request)
Command 3DShape 7 bytes
Description Sets/Requests the 3D shape setting enable/disable and the 3D shape No. to be inserted.
WX
Command
Response
WX,JOB=0000,BLK=000,3DShape=A,B[CR]
WX,OK [CR]
1
Communication Interface
Command RX,JOB=0000,BLK=000,3DShape[CR]
RX
Response RX,OK,A,B[CR]
3D shape setting
0: XY Plane
A:0/1 1 byte
1: 3D Shape
Parameter * Default value “0”
3D shape No.
B: 000 to 255 3 bytes * A: Fixed value of “0” when 0
* Default value “0”
• This command can be sent to a block No. having the block type (BlockType) of other than “04: Fixed point”.
• The tilt correction target block of the Z tracking cannot be set for a target. When the block is set to the target, the communication error
S083 “3D information incorrect setting error” will occur.
Command WX,JOB=0000,3DS=000,3DShapeType=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,3DS=000,3DShapeType[CR]
RX
Response RX,OK,A[CR]
3D Shape
-01: Z map
000: Slope
001: Inside cylinder
002: Outside cylinder
Parameter A: -01/000 to 006/020 3 bytes 003: Inside cone
004: Outside cone
005: Inside hemisphere
006: Outside hemisphere
020: XY Plane
* Default value “20”
• You cannot change a 3D shape No. for which a 3D shape has already been set. The 3D shape setting information is initialized when the
block associated with the 3D shape No. is removed.
• Therefore, associate the block using the 3DShape command following the 3DShapeType.
Command WX,JOB=0000,3DS=000,3DShapePosition=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,3DS=000,3DShapePosition[CR]
RX,OK,A,B,C,D,E,F[CR]
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “1: 3D Shapes”.
• Specify the target specifier 3DS based on the 3D shape No. of the 3D shape setting (3DShape).
Command WX,JOB=0000,3DS=000,CylinderDiameter=A[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,3DS=000,CylinderDiameter[CR]
RX,OK,A[CR] 1
A: Depends on the area size
Communication Interface
Normal : 0000.200 to 0480.000 Cylinder diameter (mm)
Parameter 8 bytes
Other model : “Cylinder diameter” of “Model- * Default value “Normal/Wide: 40”/”Small: 20”
Specific Input Value List” (Page 1-92)
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “1: 3D Shapes” AND the 3D shape type
(3DShapeType) of “01/02: Cylinder”.
• Specify the target specifier 3DS based on the 3D shape No. of the 3D shape setting (3DShape).
Command WX,JOB=0000,3DS=000,ConeSize=A,B,C,D,E[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,3DS=000,ConeSize[CR]
RX
Response RX,OK,A,B,C,D,E[CR]
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “1: : 3D shape AND the 3D shape type (3DShapeType)
of “3/4: Cone”.
• Specify the target specifier 3DS based on the 3D shape No. of the 3D shape setting (3DShape).
• The bus angle cannot be set when the specification is disabled at the bus angle. The top diameter and height cannot be set when the
specification is enabled at the bus angle.
Command WX,JOB=0000,3DS=000,SphereDiameter=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,3DS=000,SphereDiameter[CR]
RX
Response RX,OK,A[CR]
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “1: 3D Shapes” AND the 3D shape type
(3DShapeType) of “05/06: Sphere”.
• Specify the target specifier 3DS based on the 3D shape No. of the 3D shape setting (3DShape).
Command WX,JOB=0000,BLK=000,3DSurfacePosition=A,B,C[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,BLK=000,3DSurfacePosition[CR]
RX,OK,A,B,C[CR]
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “01: 3D Shapes”.
• When the type of 3D shape (3DShapeType) is a cylinder or cone (001 to 004), the X coordinate on the 3D shape cannot be set.
• When the type of 3D shape (3DShapeType) is other than a cylinder or cone (001 to 004), the θ angle on the 3D shape cannot be set.
Command WX,JOB=0000,BLK=000,ConeSetting=A,B,C,D[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,BLK=000,ConeSetting[CR]
RX
Response RX,OK,A,B,C,D[CR]
Char. Frame
0: Use fixed length
A:0/1 1 byte
1: Use fixed angle
* Default value “0”
Layout
1: Angular interval
B:1 to 3 1 byte 2: Distribute angle
Parameter 3: Character pitch
* Default value “1”
• This command can be sent to a block No. having the 3D shape setting (3DShape) of “01: 3D Shapes” AND the 3D shape type
(3DShapeType) of “3/4: Cone”.
• B: 3 (Character Pitch) can be set only in the case of TrueTypeFont.
Work flow
(1) Enable/disable the XY tracking settings (Set/Request)
Command XYTrackingEnable 16 bytes
Description Sets/Requests to enable/disable the XY tracking settings.
WX
Command
Response
WX,JOB=0000,TRK=000,XYTrackingEnable=A
WX,OK
1
Communication Interface
Command RX,JOB=0000,TRK=000,XYTrackingEnable
RX
Response RX,OK,A
XY tracking
0: Disabled
Parameter A:0/1 1 byte
1: Enabled
* Default value “0”
• When the non-existing XY tracking setting No. in TRK is specified, S103 tracking No. no registration error will occur.
• This command cannot be used for the MD-X2050(A)/400(A)/450(A).
Command WX,JOB=0000,TRK=000,ZTrackingEnable=A
WX
Response WX,OK
Command RX,JOB=0000,TRK=000,ZTrackingEnable
RX
Response RX,OK,A
Z tracking
0: Disabled
Parameter A:0/1 1 byte
1: Enabled
* Default value “0”
• When the non-existing Z tracking setting No. in TRK is specified, S103 tracking No. no registration error will occur.
• This command cannot be used for the MD-X2050(A)/400(A)/450(A).
Command WX,JOB=0000,ZTrackingCalibration=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,ZTrackingCalibration[CR]
RX
Response RX,OK,A,B,C[CR]
Command WX,JOB=0000,TRK=000,XYTracking=A[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
RX,JOB=0000,XYTracking=[CR]
RX,OK,A[CR]
Command WX,JOB=0000,WindowCheckBeforeMarkingEnable=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,WindowCheckBeforeMarkingEnable[CR]
RX
Response RX,OK,A[CR]
(6) Set/Request the warning threshold of the lens inspection before marking
Command WindowCheckBeforeMarkingAlarmThreshold 38 bytes
Description Sets/Requests the warning threshold of the lens inspection before marking.
Command WX,JOB=0000,WindowCheckBeforeMarkingAlarmThreshold=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,WindowCheckBeforeMarkingAlarmThreshold[CR]
RX
Response RX,OK,A[CR]
Command WX,JOB=0000,WindowCheckBeforeMarkingSensitivity=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,WindowCheckBeforeMarkingSensitivity[CR]
RX
Response RX,OK,A[CR]
Command WX,JOB=0000,WindowCheckAfterMarkingEnable=A[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,WindowCheckAfterMarkingEnable[CR]
RX,OK,A[CR] 1
Lens inspection after marking
Communication Interface
Parameter A:0/1 1 byte 0: Do not conduct
1: Conduct
(9) Set/Request the warning threshold of the lens inspection after marking
Command WindowCheckAfterMarkingAlarmThreshold 37 bytes
Description Sets/Requests the warning threshold of the lens inspection after marking.
Command WX,JOB=0000,WindowCheckAfterMarkingAlarmThreshold=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,WindowCheckAfterMarkingAlarmThreshold[CR]
RX
Response RX,OK,A[CR]
Command WX,JOB=0000,WindowCheckAfterMarkingSensitivity=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,WindowCheckAfterMarkingSensitivity[CR]
RX
Response RX,OK,A[CR]
Command WX,JOB=0000,MarkingConfirmationSetting=A,B,C,D,E
WX
Response WX,OK
1 RX
Command
Response
RX,JOB=0000,MarkingConfirmationSetting
RX,OK,A,B,C,D,E
Marking confirmation
Communication Interface
0: Disabled
A:0/1 1 byte
1: Enabled
* Default value “0”
Sensitivity setting
0: Auto
B:0/1 1 byte
1: Any value
* Default value “0”
Parameter
Sensitivity
C: 000 to 100 3 bytes * G: Fixed value of “50” when 0
* Default value “50”
Error threshold
D: 000 to 100 8 bytes
* Default value “50”
Capture delay
E:0.0 to 9.9 8 bytes
* Default value “0”
Command WX,JOB=0000,CodeReaderSetting=A,B,C,D
WX
Response WX,OK
Command RX,JOB=0000,CodeReaderSetting
RX
Response RX,OK,A,B,C,D
Error threshold
0: Total grade A or higher is OK.
1: Total grade B or higher is OK.
D: 0 to 4 1 byte 2: Total grade C or higher is OK.
3: Total grade D or higher is OK.
4: Total grade F or higher is OK.
* Default value “4”
Target None
Command None
WX
Response
RX
Command
Response
RX,JOB=0000,CodeReaderLightSetting [CR]
RX,OK,A,B,C,D,E [CR] 1
Lighting condition for internal lighting 1
Communication Interface
A: 0/1 1 byte 0: Off
1: On
5 4 3
1 2
(14) Capturing condition of the camera function (Set/Request)
Command CameraImagingSetting 20 bytes
Description Sets/Requests the capturing condition of the camera function in the work flow.
Command WX,JOB=0000,FNC=00,CameraImagingSetting=A,B,C,D
WX
Response WX,OK
Command RX,JOB=0000,FNC=00,CameraImagingSetting
RX
Response RX,OK,A,B,C,D
Camera zoom
0: Whole wide
1: Whole standard
A: 0 to 3 1 byte
2: Coax wide
3: Coax standard
* Default value “2”
Brightness
B: -100 to 0100 4 bytes
Parameter * Default value “0”
Lighting type
0: Internal lighting (normal)
D:0/1/2 1 byte 1: Internal lighting (halation removal)
2: External lighting
* Default value “2”
• When FNC is out of range, S100 capturing condition invalid error will occur.
• If the marking verification function is not set when FNC=00 is specified, S032 no setting error (marking verification function) will occur.
• If the 2D code reader is not set when FNC=01 is specified, S031 no setting error (2D code reader) will occur. When it is non-activation,
S040 operation limitation error (2D code reader) will occur.
• When the Marking Builder Plus enables the function, the default of the lighting type is not “2”.
Command WX,JOB=0000,FNC=00,CameraTargetSetting=A,B,C,D,E,F,G,H,I
WX
Response WX,OK
1 RX
Command
Response
RX,JOB=0000,FNC=00,CameraTargetSetting
RX,OK,A,B,C,D,E,F,G,H,I
Block No.
B: 000 to 255 3 bytes * A: Fixed value of “0” when 1
* Default value “0”
Reading X coordinate
C: Depends on the area size 8 bytes * A: Fixed value of “0” when 0
* Default value “0”
Reading Y coordinate
D: Depends on the area size 8 bytes * A: Fixed value of “0” when 0
* Default value “0”
Reading Z coordinate
E: Depends on the area size 8 bytes * A: Fixed value of “0” when 0
* Default value “0”
• When FNC is out of range, S100 capturing condition invalid error will occur.
• When the marking verification function is not set if FNC=00 is specified, S032 no setting error (marking verification function) will occur.
• When the 2D code reader is not set if FNC=01 is specified, S031 no setting error (2D code reader) will occur. When the 2D code reader
has not been activated the S040 operation limitation error (2D code reader) will occur.
• If the XY tracking No. which is not set to G is specified when F=1, S103 tracking No. no registration error will occur.
• If the Z tracking No. which is not set to I is specified when H=1, S103 tracking No. no registration error will occur.
Target None
Command
WX
Response
RX
Command
Response
RX,WorkflowResultDetail [CR]
RX,OK,A,B,C,D,E,F,G,H,I,J,K,L,M [CR] 1
Execution
Communication Interface
A: 0/1 1 byte 0: Not executed
1: Executed
Result of XY tracking
0: Not executed
F: 0 to 3 1 byte 1: Success
2: Failure (out of judgment threshold)
3: Failure
Result of Z tracking
0: Not executed
G: 0 to 3 1 byte 1: Success
2: Failure (out of judgment threshold)
3: Failure
Parameter
Marking result
0: Not executed
H: 0/1/3 1 byte
1: Success
3: Failure
• The result of the last execution is acquired. The result of the last execution will be cleared when the job No. of the currently operating job
is changed.
• The result of marking energy cannot be acquired unless 2 seconds have passed after marking is complete.
• When there is more than one setting of XY tracking and Z tracking, the worst result will be returned.
The order of judgment results from the worst side is [Failure], [Failure (out of judgment threshold)], and [Success].
• The way that XY tracking and Z tracking results are judged varies between the XYTracking, ZTracking, ZTrackingMatrixCell, and
ZTrackingMatrixCellNo commands. With the WorkflowResultDetail command, even if the detection or distance measurement is
successful, the result will be a failure if the value is outside the judgment threshold.
Target None
Command
WX None
Response
1 RX
Command
Response
RX,MarkingResult
RX,OK,A,B
Marking result
Communication Interface
• The result of the last execution is acquired. The result of the last execution will be cleared when the job No. of the currently operating job
is changed.
Target None
Command
WX None
Response
Execution result
A: 0/1 1 byte 0: Not executed
1: Executed
Target None
Command
WX None
Response
Execution result
A: 0/1 1 byte 0: Not executed
1: Executed
(20) Request the filename of the image captured with the camera
Command CameraImageFilepath 19 bytes
Description Requests the filename of the image captured with the built-in camera during the last marking.
Target None
Command None
WX
Response None
RX
Command
Response
RX,CameraImageFilePath=A,B [CR]
RX,OK,C,D [CR] 1
Target image
Communication Interface
0: Marking confirmation function
1: 2D code reader
A: 0 to 9 1 byte
2: Pre-marking capture
3: Post-marking capture
4: XY tracking
File path
D: Character string
* image/yyyymmddhh/mm/file name
• Acquisition fails when Save is not selected for each image in [Image Save Settings] of the job settings.
• This command cannot be used for the MD-X400(A)/450(A).
• Starting from the image folder, the actual path to the saved file is returned in the file path.
Target None
Command
WX None
Response
Execution result
A: 0/1 1 byte 0: Not executed
1: Executed
The result of the last execution is acquired. The result of the last execution will be cleared when the job No. of the currently operating job is
changed.
Target None
Command
WX None
Response
1 RX
Command
Response
RX,CodeReadResult=A [CR]
79 bytes
C to V: A to D or 00.000 to 99.999 (including Detailed grade
comma)
Detailed grade
• The last result of the 2D code reading performed by the method other than the workflow will also be acquired.
• The result of the last execution is acquired. The result of the last execution will be cleared when the job No. of the currently operating job
is changed.
• Controllers activated with the MD-AD-2DRA cannot acquire results other than the total grade and read data.
For reading time and matching level, “-” is returned. For detailed grade, “0” or “F” is returned.
• This command cannot be used for the MD-X400(A)/450(A).
Target None
Command
WX None
Response
RX
Command
Response
RX,MarkingEnergyResult [CR]
RX,OK,A,B,C [CR] 1
Execution result
Communication Interface
A: 0/1 1 byte 0: Not executed
1: Executed
• The result of marking energy cannot be acquired unless 2 seconds have passed after marking is complete.
• When this command is sent within 2 seconds after completion of marking, the Not executed result will be returned.
• This command cannot be used for the MD-X400(A)/450(A). If the command is executed, an S095 Model Limitation Error will occur.
Target None
Command
WX None
Response
• For parameter C, the number of cells which have actually been marked is returned, and those with marking flags set to OFF or which
were not marked due to the result of Z tracking are excluded.
• The result of the last marking is acquired. The result of the last execution will be cleared when the job No. of the currently operating job is
changed.
Matrix setting
(1) Matrix row & column setting (Set/Request)
Command MatrixSetting 13 bytes
Description Sets/Requests the number of rows/columns and marking direction of a matrix.
1 WX
Command
Response
WX,JOB=0000,MatrixSetting=A,B,C[CR]
WX,OK [CR]
Communication Interface
Command RX,JOB=0000,MatrixSetting[CR]
RX
Response RX,OK,A,B,C[CR]
Marking direction
Parameter 1: Horizontal
2: Vertical
C:1/2/4/5 1 byte
4: Horizontal (Alternate)
5: Vertical (Alternate)
* Default value “1”
Command WX,JOB=0000,MatrixSize=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,MatrixSize[CR]
RX
Response RX,OK,A,B,C[CR]
Command WX,JOB=0000,CellReferencePoint=A[CR]
WX
Response WX,OK [CR]
RX
Command
Response
RX,JOB=0000,CellReferencePoint[CR]
RX,OK,A[CR] 1
Cell base point
Communication Interface
02: Center
03: Lower left
Parameter A:2 to 6 1 bytes 04: Lower right
05: Upper left
06: Upper right
* Default value “2”
If you change the θ angle of the cell coordinates of the matrix (MatrixCell), it will rotate around this reference point.
Command WX,JOB=0000,CEL=00001,MatrixCell=A,B,C,D,E,F[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,CEL=00001,MatrixCell[CR]
RX
Response RX,OK,A,B,C,D,E,F[CR]
Marking flag
0: Do not Mark
A:0/1 1 byte
1: Mark
* Default value “1”
θ angle (°)
E:-180.000 to 0180.000 8 bytes
Default value “0”
Command WX,JOB=0000,CEL=00001,MatrixCellEnable=A,BBB---[CR]
WX
Response WX,OK [CR]
1 RX
Command
Response
None
To change the marking flag of multiple cells in a batch, send parameter B in multiple digits.
To set cell No.10 to ON, No.11 to OFF, No.12 to ON and all other cells to OFF, send the command as described below.
WX,JOB=0000,CEL=00010,MatrixCellEnable=0,101[CR]
Command WX,JOB=0000,MatrixPosition=A,B,C[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,MatrixPosition[CR]
RX
Response RX,OK,A,B,C[CR]
Base point
00: Left edge
01: Right edge
02: Center
03: Lower left
A:00 to 08 2 bytes 04: Lower right
05: Upper left
06: Upper right
07: Top
08: Bottom
Parameter * Default value “2”
Command WX,JOB=0000,InactiveCellCount=A[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,InactiveCellCount[CR]
RX
Response RX,OK,A[CR]
Group/Counter setting
(1) Group setting (Set/Request)
Command GroupOffset 11 bytes
Specifies the group and changes/requests the X/Y coordinate correction, θ angle correction, and marking enable/
Description
disable setting.
Target
WX
Command
JOB=0000 to 1999,GRP=000 to 255
WX,JOB=0000,GRP=000,GroupOffset=A,B,C,D[CR] 1
Response WX,OK [CR]
Communication Interface
Command RX,JOB=0000,GRP=000,GroupOffset[CR]
RX
Response RX,OK,A,B,C,D[CR]
Marking flag
D:0/1 1 byte 0: Disabled
1: Enabled
You can only create new groups using Marking Builder Plus. The group number assigned when you created a group in Marking Builder Plus
will be the number of the target specifier GRP.
Command WX,JOB=0000,CTR=0,CounterSetting=A,B,C,D,E,F,G,H,I[CR]
WX
Response WX,OK [CR]
Command RX,JOB=0000,CTR=0,CounterSetting[CR]
RX
Response RX,OK,A,B,C,D,E,F,G,H,I[CR]
Step
A:00000 to 10000 5 bytes
* Default value “1”
Default value
C: 0000000000 to 4294967295 10 bytes * B: Fixed value of “0” when 0
* Default value “0”
Leading value
D: 0000000000 to 4294967295 10 bytes
* Default value “0”
Final value
E:0000000000 to 4294967295 10 bytes
* Default value “4294967295”
Reset timing
0: Trigger
1: I/O
2: Power on
G: 0 to 5 1 bytes
3: When switching the job No.
4: When the date changes
5: When the shift code is switched
* Default value “1”
Count timing
0: Trigger
H:0/1 1 byte
1: Each matrix cell/group/marking
* Default value “0”
Base
I: 02 to 36 2 bytes
* Default value “10”
The target specifier JOB can be omitted if you are specifying a common counter.
Operation time
(1) Request the controller operating time
Command OperatingTime 13 bytes
Description Requests the operating time of the laser marker.
Target None
1 WX
Command
Response
None
Communication Interface
Command RX,OperatingTime[CR]
RX
Response RX,OK,A[CR]
Target None
Command
WX None
Response
Target None
Command
WX None
Response
Target None
Command
WX None
Response
Command RX,ShutterOperatingCount[CR]
RX
Response RX,OK,A[CR]
Target None
Command
WX None
Response
Target None
Command
WX None
Response
RX
Command
Response
RX,MarkingUnitTemperature[CR]
RX,OK,A[CR] 1
Parameter A:-999.9 to 0999.9 6 bytes Head temperature (°C)
Communication Interface
(7) Request the controller temperature (°C)
Command ControllerTemperature 21 bytes
Description Requests the controller temperature.
Target None
Command
WX None
Response
Command RX,ControllerTemperature[CR]
RX
Response RX,OK,A[CR]
Target None
Command
WX None
Response
Command RX,LaserPowerCalibrationResult[CR]
RX
Response RX,OK,A,B[CR]
Target None
Command WX,CumulativeMarkingCount=A,B[CR]
WX
Response WX,OK [CR]
Command RX,CumulativeMarkingCount[CR]
RX
Response RX,OK,A,B[CR]
Maintenance
(1) Request the lens inspection result
Command WindowCheckResult 17 bytes
Description Requests the result of the lens inspection maintainable as well as the date it was last performed.
Target -
1 WX
Command
Response
-
-
Communication Interface
Command RX,WindowCheckResult[CR]
RX
Response RX,OK,A,B,C,D,E[CR]
Year conducted
B: 0000 to 2099 4 bytes
(when not conducted at all: 0000)
Parameter
Month conducted
C: 00 to 12 2 bytes
(when not conducted at all: 00)
Day conducted
D: 00 to 31 2 bytes
(when not conducted at all: 00)
Conducted result
E:000 to 100 3 bytes
(when not conducted at all: 000)
Target None
Command WX,WindowCheckSensitivity=A[CR]
WX
Response WX,OK [CR]
Command RX,WindowCheckSensitivity[CR]
RX
Response RX,OK,A[CR]
Target None
Command WX,WindowCheckStartup=A[CR]
WX
Response WX,OK [CR]
Command RX,WindowCheckStartup[CR]
RX
Response RX,OK,A[CR]
1
Command RX,WindowCheckAlarmThreshold[CR]
RX
Response RX,OK,A[CR]
Parameter A:0~100 3 bytes Value of the lens inspection result
Communication Interface
It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
Target None
Command WX,WindowCheck[CR]
WX
Response WX,OK,A[CR]
Command
RX None
Response
Target None
Command WX,LaserPowerCheck=A,B[CR]
WX
Response WX,OK,C[CR]
Command
RX None
Response
Target None
Command WX,LoggingClearAllData[CR]
WX
Response WX,OK [CR]
Command
RX None
Response
Target None
Command WX,LoggingClearData=A,B
WX
Response WX,OK
Command
RX None
Response
Applied Functions
This chapter provides information on omission of parameters, convenient command usages, and how to create new settings using only commands.
Variable-length support
1 The unwanted “0” can be omitted when sending the setting values to the laser marker using the Write command.
Omission of the command for changing the currently running job No. to “1”
Communication Interface
Command WX,JobNo=0001[CR]
Command WX,JobNo=1[CR]
Command WX,AllPosition=-90,0,90,-62.5,0,21[CR]
Omission of the command for changing the title of the currently running job No.0001 to “ABC”
Command WX,JOB=0001,Title=ABC[CR]
Command WX,Title=ABC[CR]
Omission complete
Omission of the command for changing the block No.000 string of the currently running job
No.0001 to “ABC”
Command WX,JOB=0001,BLK=000,CharacterString=ABC[CR]
Communication Interface
Command WX,JOB=0001,CharacterString=ABC[CR]
Command WX,CharacterString=ABC[CR]
Omission complete
Omission of parameters
If you only wish to change some parameters using a command that have multiple parameters, you can send the command omitting those parameters
you do not need to change.
Omission of the command changing only the C: Day setting value out of the six date/time setting
parameters (A: Year, B: Month, C: Day, D: Hour, E: Minute, F: Second)
To change the current time setting of 2014/12/20/11: 38: 20 to 2014/12/21/11: 38: 20
Command WX,TimeSetting=2014,12,21,11,38,20[CR]
Response WX,OK[CR]
Command WX,TimeSetting=,,21,,,[CR]
Response WX,OK【CR】
• You cannot link and send a command targeting two or more job No.
• You cannot link and send commands that are related to “Operation/Current Value” or “Status/Controller Setup”.
1 For WX command
Communication Interface
To send the command with a linked WX command, link the command by adding “WX” only to the first command and removing “WX” from the second and
subsequent commands.
Omission of the command for changing the block No.1 string of the currently running job No.0001
to “ABC”, and the block No.2 string to “123”
1. Command WX,JOB=0001,BLK=001,CharacterString=ABC[CR]
2. Response WX,OK[CR]
3. Command WX,JOB=0001,BLK=002,CharacterString=123[CR]
4. Response WX,OK[CR]
You can link the commands as they are changing blocks in the same job No.
Command WX,JOB=0001,BLK=001,CharacterString=ABC,JOB=0001,BLK=002,CharacterString=123[CR]
Response WX,OK[CR]
You can omit the “JOB” on the end as the job No. are the same.
Command WX,JOB=0001,BLK=001,CharacterString=ABC,BLK=002,CharacterString=123[CR]
Response WX,OK[CR]
Command WX,BLK=001,CharacterString=ABC,BLK=002,CharacterString=123[CR]
Response WX,OK[CR]
You can omit “0s” as they are unnecessary for the parameters.
Command WX,BLK=1,CharacterString=ABC,BLK=2,CharacterString=123[CR]
Response WX,OK[CR]
Omission complete
For RX command
To send the command with a linked RX command, link the command by adding “RX” only to the first command and removing “RX” from the second and
subsequent commands. A response is returned in the order of the requesting commands.
Omission of the command for requesting the block No.1 (String: ABC) and No.2 (String: 123) string
setting of the currently running job No. 0001
1. Command
2. Response
RX,JOB=0001,BLK=001,CharacterString[CR]
RX,OK,ABC[CR]
1
3. Command RX,JOB=0001,BLK=002,CharacterString[CR]
Communication Interface
4. Response RX,OK,123[CR]
You can link the commands as they are requests in the same job No.
Command RX,JOB=0001,BLK=001,CharacterString,JOB=0001,BLK=002,CharacterString[CR]
Response RX,OK,ABC,123[CR]
You can omit the “JOB” on the end as the job No. are the same.
Command RX,JOB=0001,BLK=001,CharacterString,BLK=002,CharacterString[CR]
Response RX,OK,ABC,123[CR]
Command RX,BLK=001,CharacterString,BLK=002,CharacterString[CR]
Response RX,OK,ABC,123[CR]
You can omit “0s” as they are unnecessary for the parameters.
Command RX,BLK=1,CharacterString,BLK=2,CharacterString[CR]
Response RX,OK,ABC,123[CR]
Omission complete
Command WXC,WX,StartMarking,%,WX,JobNo=10[CR]
cmd_index = No. of the linking commands on which an error occurs. 000 indicates errors occur on WXC command. 001 or the subsequent number
indicates errors occur on the linking commands.
1 Description
Declare a start of job creation on a non-registered job No. using the following command: The specified job No. will stop
the expansion processing until “EndJob” is input.
Target None
Communication Interface
Command WX,CreateJob=A[CR]
WX
Response WX,OK[CR]
Command
RX None
Response
• When you declare “CreateJob” on a non-registered job No., a job will be created with all parameters in their default values.
• By declaring “CreateJob” on an existing job No., you can change the desired job parts using this job file as a base.
• If you wish to initialize the job contents every time you create a job, insert “CreateJobWithAllClear” into the command.
• The XY tracking and Z tracking settings cannot be created.
• If you start editing with CreateJob, do not change any setting contents or edit anything other than the job number until ending editing with
EndJob. Doing so will cause an error in EndJob, preventing editing from completing normally.
Since all commands other than the string setting command have a default value, you can create new settings even if you omit these values.
Target None
Command WX,EndJob[CR]
WX
Response WX,OK[CR]
Command
RX None
Response
Parameter None
If the settings are in their default values and the mark data is the “ABC” string, the program can be configured using just three commands as
described below.
• WX,CreateJob=0001[CR]
• WX,JOB=0001,BLK=001,CharacterString=ABC[CR]
• WX,EndJob[CR]
Communication Errors
Error response
An error response is returned if there is an error in the command format or data range. All error responses will have the error number “S***” and error
code on the end of the command.
1
Send WX,Command[CR]
Communication Interface
Error list
S029 Mark data request error Send the command after marking has completed.
Group the blocks in the job using Marking Builder Plus.
Group number
S030 You can group blocks by following the procedure below.
unregistered error
Select and right-click on a block to open the context menu, and then select [Grouping].
No Program Error
S031 Activate the 2D code reader function in Marking Builder Plus.
(2D code reader)
1
No Program Error
S032 (Marking confirmation Activate the marking confirmation function in Marking Builder Plus.
function)
No Program Error
S033 Activate the XY tracking or Z tracking function in Marking Builder Plus.
Communication Interface
(3-Axis Tracking)
Operation Limitation Error
S040
(2D Code Reader)
Operation Limitation Error
S041
(3D Marking)
Delete the job that uses the inactivated function or activate the target function..
Operation Limitation Error
S042
(Z Tracking)
Operation Limitation Error
S043
(XY Tracking)
Check the following when using the high speed character edit command.
Quick change of • Check if the block you wish to change is subject to high speed string editing.
S050
character setup error • Check that the string to be sent is registered as the character type that supports high speed string
editing.
Sample Marking
S051 Commence sample marking in READY state.
Unexecutable Error
Laser inspection
S052 Commence inspection laser in READY state.
unexecutable error
Block type incorrect
S060
setting error
Recreate the job.
Block assignment
S061
incorrect setting error
Character size incorrect
S062 Modify the blocks whose character aspect ratio is greater than 1:5 or 5:1.
setting error
Character assignment
S063
incorrect setting error
Character advanced
S064
incorrect setting error
Marking condition
S065
incorrect setting error
Barcode/2D code illegal
S066
setting error
Continuous marking
S067
incorrect setting error
Movement/marking
S068 direction incorrect setting Recreate the job.
error
Job Program Incorrect
S069
Error
Matrix information
S070
incorrect setting error
Matrix cell information
S071
incorrect setting error
Character string incorrect
S072
setting error
Individual counter
S073
incorrect setting error
Reconfigure the common counter settings by following the procedure below.
Common counter
S074 You can configure by selecting [Settings] - [Common Data] in the ribbon menu, followed by [Common
incorrect setting error
Counter].
Encoding information Reconfigure the encoding setting.
S075
incorrect setting error You can configure by selecting [Settings] - [Common Data] in the ribbon menu, followed by [Encoding].
System information
S076
incorrect setting error
Font replacement Recreate the job.
S077 information incorrect
setting error
Reconfigure the character scaling settings.
Font scaling information
S078 You can configure by selecting [Settings] - [Common Data] in the ribbon menu, followed by [Character
incorrect setting error
scaling].
Logo/custom character
S080 buffer information
incorrect setting error Recreate the job.
3D information incorrect
S083
setting error
A job loaded on the controller is using a function that has not been activated (e.g. 2D code reader).
S084 Operation limitation error
Delete the job that is using the unactivated function, or activate the necessary function.
Communication Interface
S087 2D code reading error Modify the job so that code reading is possible in test marking, then run the job again.
Working distance Height measurement may not be possible in the following cases:
S088
measurement error • Distance measuring light cannot be detected correctly because of the surface condition of the target.
Working distance
S089 measurement limitation Measure the work distance when the laser is in the READY state.
error
S090 Registered barcode error Change the barcode verification string.
Please check the following:
Barcode/2D code link
S091 • Check if the 2D code overprinting setting is enabled for the target block.
setting error
• Check if the target overprinting No. exists.
Barcode illegal
S092 Configure it in either Marking Builder Plus or the console.
registration state error
Marking Confirmation
S093 Check if the marked data exisits within the field of view of the confirmation coordinates.
Function Error
TrueType font file size
S094 Reduce the number of TrueType font types being used.
error
S095 Model limitation error Cannot be used.
S096 Open priority error Restart the device.
File may be read-only.
S097 File Access Error
Check the file attribute and try again.
The FNC specifier of the communication command is specified other than 00 (marking confirmation
Illegal Capturing
S100 function) and 01 (2D code reader).
Condition Error
Send the command using the correct FNC specifier number.
Window maintenance
S101 Window maintenance started by a communication command was cancelled.
cancelled
Z distance measuring
S102 Z coordinate acquisition performed by communication command failed.
failure
Distance laser unexcited The lens inspection start command was sent while the distance laser was not excited. Send this
S108
error command after exciting the laser.
Capturing Condition Auto If an error occurs in the “Capturing condition auto adjustment” of the 2D code reader, try again.
S109
Adjustment Error If an error occurs in the “Brightness and Magnification Adjustment” of the XY tracking, try again.
The routing table is full. The maximum number of paths that can be registered in this table is four.
S111 Routing Table Full Error
Delete registered paths.
User management
S112 The user management function is disabled.
function disable error
Simultaneous login The number of allowable simultaneous logins (four) was exceeded. Wait for another user to log out
S113
exceeded error before logging in.
User authentication
S114 User authentication failed. Make sure the password is correct.
failure error
S115 No user information error There is no user information. Make sure the user name is correct.
S116 OPC UA parameter error This is the response when an OPC UA method argument is incorrect. Check the arguments.
Check whether the timing of OPC UA processing, the parameters being used, the server certificate, and
S117 OPC UA internal error
the list of expired certificates are correct.
Unregistered OPC UA
S118 The OPC UA session has not been registered.
session error
S120 Workflow error A workflow process failed. Check the workflow error details.
1
Communication Interface
Appendix
ASCII code list
Upper 4 bit
0 1 2 3 4 5 6 7 8 9 A B C D E F
0
1
NUL DLE SP
SOH DC1 !
0
1
@
A
P
Q
`
a
p
q
1
2 STX DC2 “ 2 B R b r
Communication Interface
3 ETX DC3 # 3 C S c s
4 EOT DC4 $ 4 D T d t
5 ENQ NAC % 5 E U e u
6 ACK SYN & 6 F V f v
7 BEL ETB ' 7 G W g w
Lower 4 bit
8 BS CAN ( 8 H X h x
9 HT EM ) 9 I Y i y
A LF SUB * : J Z j z
B VT ESC + ; K [ k {
C FF FS , < L \ l ―
D CR GS - = M ] m }
E SO RS . > N ^ n ~
F SI US / ? O _ o DEL
1 Height/Width
Logo Height/Width
mm
mm
000.100 to 125.000
000.002 to 125.000
000.100 to 330.000
000.005 to 330.000
000.001 to 050.000
000.001 to 50.000
Communication Interface
Character full width/full height mm 000.100 to 180.000 000.100 to 450.000 000.100 to 075.000
EtherNet/IP
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
What is EtherNet/IP?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
EtherNet/IP communication specifications
and functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Compatible laser markers . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Compatible PLCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Cyclic communication . . . . . . . . . . . . . . . . . . . . . . . 2-3
Cyclic communication with the laser marker. . . . . . . . . . 2-3
How to configure the laser marker . . . . . . . . . . . . . . . . . . 2-3
Configuring the PLC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Status of device assignment of the MD information
area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Command communications. . . . . . . . . . . . . . . . . . . . . . . 2-20
When “Request” bit does NOT work. . . . . . . . . . . . . . . . 2-20
Ladder Program Example. . . . . . . . . . . . . . . . . . . . 2-21
KEYENCE KV Series Program Example. . . . . . . . . . . . . 2-21
OMRON PLC CJ2 Series Program Example. . . . . . . . . . 2-24
Studio 5000 Logix Designer Ladder Program
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27
Getting Started
What is EtherNet/IP? EtherNet/IP communication
EtherNet/IP is an industrial communication network proposed by the
specifications and functions
ODVA (Open DeviceNet Vendor Association,Inc.).
EtherNet/IP communications can be shared and used with standard EtherNet/IP communication specifications of
Ethernet and network communications. the laser marker
z Scanner and adapters Number of
16
In EtherNet/IP, one of the two devices opens a communication line connections
2
called a “connection” with the other device. The side that opens a
Keyence KV
connection is referred to as a “scanner” (originator); and the side that is 2 to 320 bytes
Series
opened is referred to as an “adapter” (target). Typically, the PLC is used
for the scanner. The laser marker is an adapter device. Cyclic communication OMRON
(Implicit messages) 2 to 320 bytes
Communication CJ/CS series
z Cyclic communication
EtherNet/IP
size
EtherNet/IP offers cyclic communication (Implicit message) for sending Rockwell
and receiving data on a periodic basis. It allows you to set the RPI Automation
2 to 320 bytes
(communication cycle) based on the priority of the sent/received data, ControlLogix
enabling sending and receiving of data with adjustment of the overall CompactLogix
communication load.
Compatible PLCs
For more details on how to configure each PLC, refer to the instruction manual of the corresponding PLC.
z Keyence
PLC model EtherNet/IP communication unit Firmware version Software
z OMRON
PLC model EtherNet/IP communication unit Firmware version Software
z Rockwell Automation
PLC model EtherNet/IP communication unit Firmware version Software
Cyclic communication
Cyclic communication with the laser marker How to configure the laser marker
Cyclic communication performs periodic communication (several to The laser marker is configured as follows using Marking Builder Plus.
several dozen ms) and is suitable for real-time control.
The communication cycle and communication size settings follow those
on the PLC settings. 1 Select [Controller] from the [Settings] tab, and
then [Ethernet Settings].
It is recommended to set the communication cycle to 10
ms or longer.
EtherNet/IP
IP address 192.168.0.20
Command
instruction
Command
instruction 4 Set the Input/Output assembly size.
These items should be set according to the PLC settings.
PLC settings
Configure the following settings on the PLC when using cyclic communication.
(1) The connection to be used
(2) The device settings to be used for cyclic communication
(For more details on the setting method, refer to the manual of each PLC.)
When using the KV series, (1) and (2) are set automatically when you make a selection in the KV STUDIO.
z Connection to be used
2 In EtherNet/IP, a connection is opened from the scanner during cyclic communication. There are many types of connections, and the connection available
is different for each device. The type of connection available for the laser marker is Exclusive Owner.
EtherNet/IP
If you cannot find the target model in the device list,
add MD-X2000/2500 from [EDS File(D)] > [Reg]. The
ez1 file is stored in the location described below.
C:\Program Files (x86)\keyence\Marking Builder
Plus_Ver*\etc\EtherNetIP\[model name]
(Ver* is the version of Marking Builder Plus.)
How to configure the OMRON CJ2 series 4 Set the IP address of PLC.
After setting the IP address and subnet mask, select [Transfer[PC to
Connect the PLC with the laser marker using an Ethernet cable and launch Unit]], and transfer the parameter to the unit.
CX-Programmer.
2 Connect PLC.
Select [Auto Online] > [Direct Online] from [PLC] menu. Select the
connection type with PLC to connect.
2
EtherNet/IP
6 Select interface.
Select [Select Interface] > [CJ2 USB/Serial Port] from [Option] menu.
EtherNet/IP
9 Install EDS file
Select [Install] from [EDS File] menu.
2
EtherNet/IP
z Setting example
Connection I/O Type
Class1
Originator Device (PLC)
2
The EDS file of the laser marker is located in the
folder below.
C:\Program Files (x86)\keyence\Marking Builder
Plus_Ver*\etc\EtherNetIP\[model name]
(Ver* is the version of Marking Builder Plus.)
EtherNet/IP
2 Add an MD-X Ethernet Module.
Right click [I/O Configuration] > [Ethernet], and select [New Module].
Select [MD-X2000/2500] and click [Create].
2 1
Window
Monitoring
Busy Status
Mark Check
/2DC Read
Busy Status
Job Edit
Busy
Status
Communication
Priority Error
Status
Job Change
Busy Status
Guide
Laser Busy
Status
Marking
Busy
Status
Busy
Status
Mark Check Mark Check Counter Counter Counter Counter Distance Internal Laser Operation Trigger
Marking Date Attach Date Hold
EtherNet/IP
2 /2DC Read /2DC Read End4 End3 End2 End1 Laser Stop Lighting Control Stop Lock
Complete1 Status Status
NG Status 1 OK Status 1 Status Status Status Status Status Status Status Status Status
Window Guide
Job Edit 2DC Read Error Clear Laser Stop Marking
4 Monitoring Laser
Complete Complete Complete Complete Complete2
Complete Complete
12 Error Code 1
13 Error Code 2
15
16 Job No Status
17 Counter No Status
21 System Info ID
2
2 Warning Status
1: Warning Linked I/O Terminal Warning output
0: Not I/O Error
3 I/O Error Status Displays the terminal block error (T***) status.
1: I/O Error
EtherNet/IP
0: Open Shutter Displays whether the internal shutter is opened or closed.
4 Shutter Status
1: Close Shutter Linked I/O Terminal Shutter status output
0: No Connection
5 Network Status Displays the Fieldbus network communication status.
1: Connection
Job Change Ready 0: Not Ready Displays the job switching ready status.
6
0 Status 1: Ready Linked I/O Terminal Job switching ready status
Distance Laser Ready 0: Not Ready Displays the Ready state of the distance laser.
7
Status 1: Ready Linked I/O Terminal Distance laser operation ready output
External Lighting Control 0: OFF Displays whether the external lighting control output is on or off.
13
Status 1: ON Linked I/O Terminal External Lighting Control Output
If one or more of the following busy statuses are on, Busy Status turns on.
Marking Busy, Guide Laser Busy, Job Change Busy, Commmunication
0 Busy Status
Priority, Job Edit Busy, Mark Cheeck/2DC Read Busy Status Window
Monitoring Busy
Turns on during marking (including laser inspection).
1 Marking Busy Status
Linked I/O Terminal Output During Marking
Turns on when guide laser marking is in operation (including the distance
2 Guide Laser Busy Status pointer).
Linked I/O Terminal Guide Laser Output
Turns on when a job is being deployed.
3 Job Change Busy Status 0: Not Busy
1 (Deployment timing: when changing marking jobs, content, and so on)
1: Busy
Communication Priority Displays the communication priority status. Turns on when the laser marker
4
Error Status is connected to an external control device and in the no priority state.
Turns on when the Job Edit Start Request turns on and editing starts.
5 Job Edit Busy Status Returns to “OFF” when the Job Edit Start Request is turned off and editing is
completed.
Mark Check /2DC Read
6 Turns on when the marking verification function or 2DC reading is operating.
Busy Status
Turns on during the lens inspection. Also turns on during maintenance and
Window Monitoring Busy workflow lens inspections.This not only turns on when the operation is started
7
Status by Profinet and Ethernet/IP communications, but also when this operation is
started by another communication before or after marking.
2
9 Counter End1 Status
Displays the status of counter end output 1 - 4. You can use the Controller
10 Counter End2 Status settings of the Marking Builder Plus to assign the individual and common
0: Not Complete
11 Counter End3 Status 1: Complete counters (0 to 9, A to J).
EtherNet/IP
2
System Info ID Change Displays the completion status of the operation information ID by System Info
8
Complete [Reset timing] ID Change Request.
Reset when the Complete Clear
Setting String Read
0 Bit statuses turn on or the next Displays the completion status of Setting String Read Request.* 2
Complete
Request turns on.
EtherNet/IP
6 Marked String Read
1 Displays the completion status of Marked String Read Request.* 2
Complete
2 String Change Complete Displays the completion status of String Change Request.* 2
Command Send
8 Displays the completion status of Command Send Request.* 2
Complete
XY Tracking Result Read
7 9 Display the completion status of XY Tracking Result Request.* 2
Complete
Z Tracking Result Read
10 Display the completion status of Z Tracking Result Request.* 2
Complete
If the marking operation started with Start Marking Request fails, the bit turns
Start Marking Request
0 on.
Error
If marking is canceled or marking cannot start without priority, it turns on.* 3
If the guide laser operation started with Guide Laser Request fails, the bit
Guide Laser Request
1 turns on. If Guide Laser Request is turned on when the guide laser cannot be
Error
irradiated or cannot be started without priority, it turns on.* 3
Stop Marking Request If a Stop Marking Request fails to stop marking, the bit turns on.
2
8 Error *3
3 Error Clear Request Error If an Error Clear Request fails to clear the error, it turns on.* 3
4 2DC Read Request Error If a 2DC Read Request fails to read a 2D code, the bit turns on.
Window Monitoring If a Window Monitoring Request fails in the lens inspection operation, it turns
5
Request Error on.* 3
If a Job Edit Start Request fails to edit the job, it turns on.* If edit start is not
8 Job Edit Error 0: Not Error received or if data cannot be deployed when editing finishes, the bit turns on.
1: Error
Job Change Request
0 [Reset timing] If a job change with a Job Change Request fails, it turns on.* 3
Error
Reset when the Complete Bit
Rank Change Request Clear statuses turn on or the next If an I/O specified character change with a Rank Change Request fails, it
1
Error Request turns on. turns on.* 3
Counter No Change If a number change with a Counter No Change Request fails, the bit turns on.
2
Request Error *3
If a value change with a Counter Value Change Request fails, the bit turns
Counter Value Change
3 on.
Request Error
9 *3
Counter Up Request If a value change with a Counter Up Request fails, it turns on.* 3
4
Error Receivable condition: Ready ON
Counter Down Request If a value change with a Counter Down Request fails, it turns on.* 3
5
Error Receivable condition: Ready ON
Counter Reset Request If a reset with a Counter Reset Request fails, it turns on.* 3
6
Error Receivable condition: Ready ON
System Info IDChange If a change of the operation information ID with a System Info ID Change
8
Error Request fails, it turns on.* 3
Setting String Read 0: Not Complete
0 If reading with a Setting String Read Request fails, it turns on.* 3
Request Error 1: Complete
Marked String Read [Reset timing] If reading with a Marked String Read Request fails, the bit turns on.
10 1
Request Error Reset when the Complete Bit *3
String Change Request Clear statuses turn on or the next If a change with a String Change Request fails, the bit turns on.
2 Request turns on.
Error It will also fail if the data length exceeds 250 bytes.* 3
Command Send Request 0: Not Complete If Command Send Request fails, the bit turns on.
8
Error 1: Complete It will also fail if the data length exceeds 250 bytes.* 3
XY Tracking Result [Reset timing]
11 9 When XY Tracking Result Request fails, it turns on.* 2
Request Error Reset when the Complete Bit
Z Tracking Result Clear statuses turn on or the next
10 Request turns on. When Z Tracking Result Request fails, it turns on.* 2
Request Error
* 1 If a code is read with the settable 2D code reading function on Marking Builder Plus, OK/NG is output with the grade that is set as the
threshold as the reference. If code is read with 2DC Read Request, OK/NG is output for whether the code was successfully read or not. (Even
if the code reads with a F Grade, OK is output.)
* 2 The bit turns at completion only if the operation is started by Profinet and Ethernet/IP communications. If you start the operation with other
forms of communication or I/O, the bit will not turn on, even if the operation completes.
* 3 The bit turns on at error only if the operation is started by Profinet and Ethernet/IP communications. If you started the operation with other
forms of communication or I/O, the bit will not turn on, even if an error occurs.
Remote interlock input, shutter interlock input, and laser excitement input cannot be controlled from Ethernet/IP. Control those inputs from I/O.
2 Address
12
Data Type
Word
Name
Error Code 1
Status Information Description
Displays the number for the error currently occurring. The error
number display differs to the normal display.
EtherNet/IP
The error codes are displayed as four digits such as 1*** for an
Error Number error (E***), 2*** for a warning error (W***), and 3*** for an I/O
13 Word Error Code 2 error (T***).
Up to two errors can be displayed. When three or more errors
occur, confirm the errors through Marking Builder Plus.
Error Number
[Reset timing] If Command Send Request fails due to a software error, the
Command Send Error Command Send Request error number is displayed. The error number display differs to
14 Word
Status Reset when Complete Bit Clear the normal display. A software error (S***) is displayed as 4*** in
turns on or the next Command four digits.
Send Request turns on.
16 Word Job No Status Job Number (0 to 1999) Displays the currently selected job number.
• Counter Value Change/Up/Down/Reset Request that is to be
changed
• Counter Value Status that is to be displayed
17 Word Counter No Status Counter Number (0 to 19) Displays the number of the target counter listed above.
Changes with Counter No Change Request.
Individual Counter(0 to 9): 0 to 9
Common Counter(A to J):10 to 19
Counter Value Displays the current counter value set to be displayed for
18/19 DWord Counter Value Status
(0 to 4294967295) Counter No Change Request.
I/O Encoded Character Value
20 Word Rank Value Status Displays the value for I/O specified characters.
(0 to 35)
21 Word System Info ID System Info ID (0 to 301) Displays the currently selected operation information ID.
System Info Value
22/23 DWord System Info Value Displays the operation information specified by System Info ID.
(0 to 4294967295)
Any of the following are displayed:
• 2D code reading (Defaults) : Read fail of AIM DPM
[When acquiring 2DC reading] comprehensive determination
0 to 4 grade or F(0)/D(1)/C(2)/B(3)/A(4)
• Marking verification function : score
[When using the marking
verification function] Displays the 2D code grade result by default, and the
Marking Check Score/ assessment result of the marking verification function will be
24 Word 000 to 100
2DC Read Grade Status 1 displayed in Marking Check Score/2DC Read Grade Status 2.
[Reset timing] Status 1 and 2 can be reversed in the communication setting
Reset when 2DC Read Complete screen of Marking Builder Plus.
Bit Clear turns on or the next 2DC When displaying the result of the 2D code reading grade,
Read Request turns on. even if you started the operation with communications and I/O
other than 2DC Read Request, the result is displayed after the
operation is completed.
Displays the execution count of the 2D code reading or the
0 to 65535 execution count of the marking verification functions. Displays
Marking Check/ the execution count of the 2D code reading by default, and the
25 Word 2DC Read Total Count [Reset timing] execution count of the marking verification functions will be
Status 1 It will be reset to “0” when the displayed in Marking Check/2DC Read Total Count Status 2.
power is turned off. Status 1 and 2 can be reversed in the communication setting
screen of Marking Builder Plus.
Any of the following are displayed:
• Marking verification function (defaults) : score
[When using the marking • 2D code reading : Read fail of AIM DPM comprehensive
verification function] determination grade or
000 to 100 F(0)/D(1)/C(2)/B(3)/A(4)
[When acquiring 2DC reading] Displays the marking verification result by default, and the grade
Marking Check Score/
26 Word 0 to 4 result of the 2D code reading will be displayed in Marking Check
2DC Read Grade Status 2
[Reset timing] Score/2DC Read Grade Status 2. Status 1 and 2 can be reversed
Resets when 2DC Read Complete in the communication setting screen of Marking Builder Plus.
Bit Clear turns on or the next 2DC When displaying the result of the 2D code reading grade,
Read Request turns on. even if you started the operation with communications and I/O
other than 2DC Read Request, the result is displayed after the
operation is completed.
2
• Setting/Marked String Request
• 2DC Read Request (read content)
• Command Send Request
Response • XY Tracking Result Request
[Reset timing] • Z Tracking Result Request
EtherNet/IP
31 to 155 Character Response Data Reset when each Complete Bit • Window Monitoring Request
Clear request turns on or the next * Selectable capacities are from 32, 64, 128, and 252 bytes on
Request turns on. the PLC settings. (Default: 128 bytes. Fixed at 250 bytes in the
KEYENCE PLC “KV Series”.) However, if the response data
is greater than the selected byte number, all the data cannot
be received. Additionally, even if 252 bytes is selected, the
maximum amount of data that will be received is 250 bytes.
Address Bit15 Bit14 Bit13 Bit12 Bit11 Bit10 Bit9 Bit8 Bit7 Bit6 Bit5 Bit4 Bit3 Bit2 Bit1 Bit0
2 3
Z Tracking
Result
Request
XY Tracking Command
Result
Request
Send
Request
Window Guide
Job Edit 2DC Read Error Clear Laser Stop Marking
Monitoring Laser
6 Complete Complete Complete Complete Complete
Complete Complete
Bit Clear Bit Clear Bit Clear Bit Clear Bit Clear
Bit Clear Bit Clear
3-Axis
Command
Tracking
Send
9 Result Read
Complete
Complete Bit
Bit Clear
Clear
10/11 Request No
Bit area for writing the request from the PLC onto the laser marker
In the following areas, information is divided by bit. The bit values are either 0 or 1.
The request from the PLC is written onto the laser marker via cyclic communication. An area without a description is reserved.
0→1: Start
1→0 : - Starts the marking. If marking cannot be performed or is canceled, Start
0 Start Marking Request Marking Request Error turns on. The Marking Busy Status turns on during
[Condition of operation] marking. If marking completes successfully, Marking Complete 1 and 2 turn on.
The Ready Status is turned on.
Starts guide laser marking. Enter the number into Request No. beforehand.
0→1: Start 0: Distance pointer 1: Guide laser once
1→0 : -
2
2: Guide laser continuously 3: Area frame
[Condition of operation]
The Ready Status is turned on. 4: Work image 5: Block frame
1 Guide Laser Request
* During shutter control, laser
If marking completes or is canceled (including canceled due to an error)
safety module control, and safety
after a set amount of time, the Guide Laser Request Complete bit turns on. If
EtherNet/IP
shutter control, it is accepted even
guide laser marking cannot start, Guide Laser Request Error turns on.
if the Ready Status is turned off.
If the move marking setting is selected, guide laser marking cannot be used.
The error bit turns on.
0→1: Stop
1→0 : -
2 Stop Marking Request [Condition of operation] Cancels marking.
The Marking Busy Status is turned
on.
If an error occurs, remove the cause of the error and then turn this bit on to
0 clear the error. An Error Status Bits error cannot be cleared (it is reset when
0→1: Error Clear the Complete Bit Clear statuses turn on or the next Request turns on). After
3 Error Clear Request
1→0 : - the operation has been completed, Error Clear Complete turns on regardless
of whether the error is cleared successfully or not. If the error clearing
operation cannot be accepted, Error Clear Request Error turns ON.
0→1: Start Starts the lens inspection. The score is stored in Response Data. If this
1→0 : - request is run when the condition of operation is not satisfied, Window
Window Monitoring
5 Monitoring Complete is reset, and Window Monitoring Request Error is turned
Request [Condition of operation] on.
The Ready Status is turned on. * It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
Starts the job editing. If the start edit request is received successfully, the
job change request after that is retained temporarily in the controller, and the
0→1: Edit Start job is deployed all at once when editing is completed. Use this request if you
8 Job Edit Start Request
1→0: Edit End want to reduce the communication time used by job editing. If edit start is
received successfully, Job Edit Busy Status turns on. Additionally, if edit start
is received successfully, Job Edit Complete turns on. 1
Counter Value Change Changes the value of the counter set to be displayed for Counter No Change
3
Request Request. * 1
Increases the value of the counter set to be displayed for Counter No Change
4 Counter Up Request
Request. * 1
2
Reduces the value of the counter set to be displayed for Counter No Change
5 Counter Down Request
Request. * 1
6 Counter Reset Request Resets the counter set to be displayed for Counter No Change Request. * 1
0→1: Request
1 Changes the operation information ID. The operation information to the ID is
EtherNet/IP
1→0 : -
displayed to System Info Value.* 1
Operation ID Operation information
1 Controller operating time
2 Laser excited time
3 Scanner operating time
System Info ID Change
8 101 Number of shutter operations
Request
Number of times the laser safety module has
102
been operated
201 Head temperature
202 Controller temperature
301 Results of the laser power calibration
302 Final execution result of the lens inspection
Loads the result of the XY tracking. Enter the XY tracking No. into the
XY Tracking Result 0→1: Request
3 9 Request No. Store the response in Response Data. Sending the request
Request 1→0 : -
before marking results in an error.
Loads the result of the Z tracking. Enter the Z tracking No. into Request No.
Z Tracking Result
10 Store the response in Response Data. Sending the request before marking
Request
results in an error.
Disables the trigger input. If this bit turns on while marking, the trigger lock
0 Trigger Lock Request status is activated after all of the mark data is marked. Test marking and
sample marking is immediately canceled when this bit turns on.
Stops the laser radiation (the internal shutter remains open). Use this bit to
1 Operation Stop Request
stop the laser radiation at the desired position while processing a workpiece.
Stops the marking laser and the guide laser. The internal shutter closes while
2 Laser Stop Request
0: Input Off this bit is turned on.
4
1: Input On If the controller's internal clock passes midnight when this bit is turned on,
3 Date Hold Request the date of updated string is subtracted one day and the subtracted date is
marked.
2
Clear
also cleared at the same time.
Window Monitoring
5 Resets Window Monitoring Complete.
Complete Bit Clear
EtherNet/IP
Job Edit Complete Bit
8 Resets Job Edit Complete and Job Edit Error.
Clear
Counter No Change
2 Resets Counter No Complete and Counter No Change Request Error.
Complete Bit Clear
Marked String Read 0→1: Complete Clear Resets Marked String Read Complete and Marked String Read Request
8 1
Complete Bit Clear 1→0 : - Error.
Command Send
8 Resets Command Send Complete and Command Send Request Error.
Complete Bit Clear
0→1: Complete Clear
9 Resets XY Tracking Result Read Complete, Z Tracking Result Read
3-Axis Tracking Result 1→0 : -
9 Complete, 3-Axis Tracking OK Status, 3-Axis Tracking NG Status, XY
Read Complete Bit Clear
Tracking Result Request Error, and Z Tracking Result Request Error.
* 1 T urns on this bit after storing the job No., I/O specified character No., counter value, counter No., and operation information No. in the
applicable Request No.
* 2 If you turn on this bit after storing the block No. in Request No., the content will be loaded from the specified block in the current job. Store
the load result in Response Data.
Stores the job No., block No., counter value, and counter No. to be
10/11 DWord Request No Numbers (Four bytes)
changed.
12 Word Request Data Size Data size (Two bytes) Stores the data length of “Request Data” in 16-bit binary data.
Use for String Change Request and Command Send Request. Store
the change string and communication command data. Headers and
Command function
delimiters are not required.
(Default: 250 bytes)
13 to 137 Character Request Data * Selectable capacities are from 32, 64, 128, and 252 bytes on the
* Selectable from 32, 64, 128, and
PLC settings. (Default: 250 bytes.)
252 bytes on the PLC.
However, even if 252 bytes is selected, the maximum amount of
data that can be sent is 250 bytes.
Command communications
Control via the command communication can also be made when using EtherNet/IP.
Since the communication mode is “command/response type”, multiple commands cannot be sent simultaneously. Therefore, make sure to send the
command only after a response has been received.
z Communication format
Header and delimiter settings are not required.
Store the send data size in “Request Data Size” and the send data in “Request Data” in the PLC command area. Then set the “Command Send Request”
bit to “1” to enable the stored data to be sent to the controller.
For further details of the communication command, refer to “Chapter 1 Communication Interface” (Page 1-1) .
z Confirmation method
Start Marking Builder Plus, and select the [Maintenance] tab > [Communication] > [Communication History].
The [Communication History] window appears. Click the [Update] button to display the latest history.
If the communication history is empty, the laser marker has not received any communication.
Double check the communication settings between the laser marker and the PLC, and make sure that the HUB and cable are not defective.
z Request format
Each request will be stored in the communication history in the following format:
Command: ***** Request
Response: ***** Request,X (X = 0: Success; X = 1: Fail)
However, the requests below have a different format. (X = 0: Success; X = 1: Fail)
Request History format (“>” = command; “<” = response)
> 2DC_Read_Request,0
2DC Read Request
< 2DC_Read_Request,X,[Grade],[Content]
> System_Info_ID_Change_Request,[System_Info_ID]
System Info ID Change Request
< System_Info_ID_Change_Request,X
> Window_Monitoring_Request,WindowCheck
Window Monitoring Request
< Window_Monitoring_Request,[OK/NG], [Score]
> XY_Tracking_Result_Request,0
XY_Tracking_Result_Request < XY_Tracking_Result_Request, [OK/NG], [X Coordinate Gap Amount], [Y Coordinate Gap Amount], [θ Gap Amount], [Correlation
Value], [Execution Time], [Result]
> Z_Tracking_Result_Request
Z_Tracking_Result_Request < Z_Tracking_Result_Request, [OK/NG], [Z Coordinate Gap Amount], [X Rotation Angle], [Y Rotation Angle], [Stability], [Execution
Time], [Result]
An error may be the cause of the request not working. You can check up to two error codes simultaneously, Error Code 1 and Error Code 2.
Error details and resolutions are listed in the User's Manual for the applicable model.
Changing the job No. and starting the marking (An example of bit control)
EtherNet/IP
Request No
Marking Complete 2
Marking Complete /
Job Change Complete Bit
Clear
Request Data No
2
Request Data
Request Data
2
Command Send Request
EtherNet/IP
Response Data Size
Response Data
Changing the job No. and starting the marking (An example of bit control)
2 Request No
Marking Complete 2
Marking Complete /
z Sequence Job Change Complete Bit
Clear
(1) If Ready Status is ON at the rising edge of 0.01,
transfer job No.”1” to Request No. • “Ready Status” becomes OFF and the “Busy” bit
End the sequence if Ready Status is OFF. becomes ON while the job No. switching is in progress.
• If the job No. switching fails, “Job Change Request
(2) Execute Job Change Request after the completion of
Error” will become ON.
sequence (1). • “Job Change Complete” retains its ON status until “Job
A switch is made to job No.1. Change Complete Clear” becomes ON or until “Job
(3) Set Start Marking Request at the rising edge of 0.02 to Change Request” becomes ON again.
ON . • “Marking Complete” retains its ON status until “Marking
The marking process starts. Complete Bit Clear” becomes ON or until “Marking
Request” becomes ON again.
(4) Set Job Change Complete Bit Clear at the rising edge • The request bit should be ON for longer than the cyclic
of 0.03, and set Marking Complete Bit Clear at the communication time interval (RPI).
rising edge of 0.04 to ON.
The completion flag is cleared.
EtherNet/IP
according to the CIP rules. By the SWAP command of
CJ2 Series convert the character string (“KEYENCE”)
stored in “D3000” into the CIP character string type
data, and store the converted data in “D13 (Request
Data Size)”.
z Timing chart
Ready Status
Request Data No
Request Data
2
is going to store the character data.
(4) Perform the following at the rising edge of 2.04:
• Transfer the character data “WX,BLK=0,CharacterString=MD-X” to
Request Data
EtherNet/IP
z Timing chart
Ready Status
Request Data
Changing the job No. and starting the Changing the string (An example of bit
marking (An example of bit control) control)
EtherNet/IP
z Sequence
(1) Turn ON ChangeJob.
If Job Change Complete is OFF and Ready Status is ON, “1” is
stored in Request No.
(2) Execute Job Change Request after the completion of
(1).
A switch is made to job No.1.
(3) If Job Change Complete becomes ON, Start Marking z Sequence
Request are set to ON.
The marking process starts. (1) If String Change Complete is OFF and Ready Status
is ON when ChangeString turns ON, the following
(4) When Marking Complete2 turns ON, the Job Change
occurs:
Complete Bit Clear and Marking Complete Bit Clear are
• The length of the new string “5” is moved to Request Data Size
turned ON. • The Block Number “0” is moved to Request No
z Timing chart • The new string “ABCDE” is moved to Request Data (Addresses
13 to 17)
• String Change Request turns ON
Ready Status
(2) When String Change Complete turns ON, the String
Change Complete Bit Clear turns ON.
Request No
z Timing chart
Job Change Request
Ready Status
Marking Complete 2
Request Data
• “Ready Status” becomes OFF and the “Busy” bit String Change Complete
becomes ON while the job No. switching is in progress.
• If the job No. switching fails, “Job Change Request
String Change Complete Bit
Error” will become ON. Clear
• “Job Change Complete” retains its ON status until “Job
Change Complete Clear” becomes ON or until “Job
Change Request” becomes ON again.
Marking Complete2 remains ON until Marking Complete • “Ready” becomes OFF and “Busy” becomes ON while a
Bit Clear turns ON or until Marking Request turns ON string is being changed.
again. • If changing the string fails, the [String Change Request
• The request bit should be ON for longer than the cyclic Error] will turn on.
communication time interval (RPI). • “String Change Complete” will not become OFF until
“String Change Complete Bit Clear” becomes ON or until
“String Change Request” becomes ON again.
• The request bit should be ON for longer than the cyclic
communication time interval (RPI).
z Reference ladder
2
EtherNet/IP
z Sequence
(1) If Command Send Complete is OFF and Ready Status
is ON when SendCommand turns ON, the following
occurs:
• The length of the command string “29” is moved to Request Data
Size
• The command string “WX,BLK=0,CharacterString=MD-X” is
moved to Request Data (Addresses 13 to 41)
• Command Send Request turns ON
(2) When Command Send Complete turns ON, the
following occurs:
• The Response Data Size “5” is moved to CommandResponse.
LEN
• The Response Data “WX,OK” is moved to CommandResponse.
DATA (Addresses 0 to 4)
• Command Send Complete Bit Clear turns ON.
z Timing chart
Ready Status
Request Data
PROFINET
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Outline of the control by PROFINET. . . . . . . . . . . . . . . . . 3-2
Operation Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Devices compatible with PROFINET communication. . . 3-2
Communication Specification of the Controller. . . 3-3
Basic specification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Status of device assignment of the MD information
area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Command communications. . . . . . . . . . . . . . . . . . . . . . . 3-11
Other controller specification . . . . . . . . . . . . . . . . . . . . . 3-11
When “Request” bit does NOT work. . . . . . . . . . . . . . . . 3-12
Setup Procedure of PROFINET . . . . . . . . . . . . . . . 3-13
Connection Procedure for PROFINET. . . . . . . . . . 3-14
Setup of PROFINET Communication . . . . . . . . . . . . . . . 3-14
Controlling the Laser Marker Controller. . . . . . . . . . . . . 3-19
Execute Ladder Program . . . . . . . . . . . . . . . . . . . . 3-22
Download the created ladder program on the PLC. . . . 3-22
Confirm/monitor the state of laser marker. . . . . . . . . . . 3-22
Getting Started
Outline of the control by PROFINET
The MD-X2000/2500 series supports communication with PROFINET. PROFINET is an open communication standard defined by the PROFIBUS
& PROFINET International, which allows any compatible devices to communicate regardless of their manufactures. This system complies with the
Conformance Class A.
Operation Flow
Confirm the Specification
“Communication Specification of the Controller” (Page 3-3)
3
• Check the device map of the input/output data.
PROFINET
• To register the laser marker information on the PLC, use the GSDML file that the laser marker model uses.
• After the PROFINET connection has been successfully established, the LINK LED (green) of the Ethernet port of the controller starts
blinking.
Data I/O
• The laser marker information will be assigned to the PLC device and the status of the laser marker will be written to the MD information
area (Page 3-4) on the PLC.
• The laser marker information will be assigned to the PLC device and the laser marker controller is controlled by writing data to the MD
instruction area (Page 3-9) on the PLC.
Periodic communication
The periodic communication performs communication periodically (at an interval of few msec. to several dozens of msec.), which is suitable for real-time
control. The update time and communication size depend on the connection settings on the PLC side.
For details, refer to “Connection Procedure for PROFINET” (Page 3-14).
PROFINET
PLC MD-X2000/2500 series
MD information area
MD information area
Controller
Controller status
information
Error status
Error status
Busy status
Busy status
Reading result Communication Reading result
cycle
Configured
on the PLC side
PLC specified area PLC specified area
Command Command
instruction instruction
• Read the “Safety Information” in the user's manual for the applicable model to perform operation in the state that the safety
is secured by using security function even when the network failure occurs.
• Confirm the safe operation by considering the communication delay due to the communication time or network overload
state.
Displays the ready status. When the device status is Ready, operations
0: Not Ready such as start marking, job change, and character string change are
0 Ready Status accepted
1: Ready
Linked I/O Terminal Trigger ready output
Displays the error (E***) status. To recover from an error, eliminate the
3
0: Not Error causes of the error first, and then turn on Error Clear.
1 Error Status
1: Error
Linked I/O Terminal Error output
0: No Connection
5 Network Status Displays the Fieldbus network communication status.
1: Connection
0: OFF (Close)
1 Shutter Control Status Displays whether the shutter control input is on or off.
1: ON (Open)
0: OFF (Close)
2 Remote Interlock Status Displays whether the remote interlock input is on or off.
1: ON (Open)
Machine 1 Displays whether the laser safety module control input is on or off.
0 4 Laser Safety Module 0: OFF (Close)
Status 3 Displays the status where the laser emission stops when it is “1 (ON)”.
Status 1: ON (Open)
When the laser safety module (MD-C1) is not mounted, it is always “0”.
External Lighting Control 0: OFF Displays whether the external lighting control output is on or off.
5
Status 1: ON Linked I/O Terminal External Lighting Control Output
If one or more of the following busy statuses are on, Busy Status turns
on.
Marking Busy, Guide Laser Busy, Job Change Busy,
0 Busy Status
Commmunication Priority, Job Edit Busy,
Mark Cheeck/2DC Read Busy Status,
Window Monitoring Busy
Turns on when the Job Edit Start Request turns on and editing starts.
5 Job Edit Busy Status Returns to “OFF” when the Job Edit Start Request is turned off and
editing is completed.
Mark Check /2DC Read Turns on when the marking verification function or 2DC reading is
6
Busy Status operating.
Turns on during the lens inspection. This not only turns on when the
Window Monitoring Busy operation is started by Profinet and Ethernet/IP communications, but
7
Status also when this operation is started by another communication and
before or after marking.
0 Trigger Lock Status Displays whether the trigger lock input is on or off.
1 Operation Stop Status Displays whether the processing operation stop input is on or off.
2 Laser Control Status 0: OFF Displays whether the laser stop input is on or off.
0
3 Date Hold Status 1: ON Displays whether the date hold input is on or off.
4 Internal Lighting Status Displays whether the internal lighting control input is on or off.
5 Distance Laser Stop Status Displays whether the distance laser stop input is on or off.
3
4 Counter End4 Status Linked I/O Terminal Counter end output 1 - 4
PROFINET
Status1 Check/2DC Read OK Status 2. Status 1 and 2 can be reversed in the
1 Reset when 2DC Read
Request or 2DC Read communication setting screen.
Complete Bit Clear turns on.
Linked I/O Terminal Marking/2D code check OK output
4 2DC Read Complete Displays the completion status of 2DC Read Request.* 2
Window Monitoring
5
Complete
* Turns on when completing the lens inspection.* 2
3
Displays the completion status of editing started with Job Edit Start
1 0 Job Edit Complete
Request. If it completes successfully, the bit turns on.
0 Job Change Complete Displays the completion status of Job Change Request.* 2
1 Rank Change Complete Displays the completion status of Rank Change Request.* 2
PROFINET
3 Counter Value Complete Displays the completion status of Counter Value Change Request.* 2
Setting String Read Displays the completion status of Setting String Read Request.
0
Complete *2
4 Marked String Read Displays the completion status of Marked String Read Request.
1
Complete *2
2 String Change Complete Displays the completion status of String Change Request.* 2
0 Command Send Complete Displays the completion status of Command Send Request.* 2
If the marking operation started with Start Marking Request fails, the bit
Start Marking Request turns on.
0
Error If marking is canceled or marking cannot start without priority, it turns
on.* 3
0: Not Error If the guide laser operation started with Guide Laser Request fails, the
1 Guide Laser Request Error 1: Error bit turns on. If Guide Laser Request is turned on when the guide laser
cannot be irradiated or cannot be started without priority, it turns on.* 3
0 [Reset timing]
Stop Marking Request Reset when the Complete Bit
2 If a Stop Marking Request fails to stop marking, the bit turns on.* 3
Error Clear statuses turn on or the
next Request turns on.
3 Error Clear Request Error If an Error Clear Request fails to clear the error, it turns on.* 3
4 2DC Read Request Error If a 2DC Read Request fails to read a 2D code, the bit turns on.
Window Monitoring If a Window Monitoring Request fails in the lens inspection operation, it
5
Request Error turns on.* 3
0: Not Error
1: Error
3
If a Job Edit Start Request fails to edit the job, it turns on.* If edit start
[Reset timing]
1 0 Job Edit Error is not received or if data cannot be deployed when editing finishes, the
Reset when Job Edit
bit turns on.
Complete Bit Clear turns on
or the next Job Edit Start
Request turns on.
PROFINET
Error Status 0 Job Change Request Error If a job change with a Job Change Request fails, it turns on.* 3
3 8
Bits
Rank Change Request If an I/O specified character change with a Rank Change Request fails,
1
Error it turns on.* 3
Counter No Change If a number change with a Counter No Change Request fails, the bit
2
Request Error turns on.* 3
0: Not Error
Counter Value Change If a value change with a Counter Value Change Request fails, the bit
3 1: Error
Request Error turns on.* 3
2 [Reset timing]
If a value change with a Counter Up Request fails, it turns on.* 3
4 Counter Up Request Error Reset when the Complete Bit
Receivable condition: Ready ON
Clear statuses turn on or the
Counter Down Request next Request turns on. If a value change with a Counter Down Request fails, it turns on.* 3
5
Error Receivable condition: Ready ON
Counter Reset Request If a reset with a Counter Reset Request fails, it turns on.* 3
6
Error Receivable condition: Ready ON
System Info ID Change If a change of the operation information ID with a System Info ID
7
Error Change Request fails, it turns on.* 3
Command Send Request 0: Not Error If Command Send Request fails, the bit turns on.
0
Error 1: Error It will also fail if the data length exceeds 250 bytes.* 3
* 1 If a code is read with the settable 2D code reading function on Marking Builder Plus, OK/NG is output with the grade that is set as the
threshold as the reference.
If code is read with 2DC Read Request, OK/NG is output for whether the code was successfully read or not.
(If the code is read even at Grade F, OK is output.)
* 2 The bit turns on at completion only if the operation is started by Profinet and Ethernet/IP communications.
If you start the operation with other forms of communication or I/O, the bit will not turn on, even if the operation completes.
The bit turns on when complete only if the operation is started by Profinet and Ethernet/IP communications.
* 3 If you started the operation with other forms of communication or I/O, the bit will not turn on, even if an error occurs.
Remote interlock input, shutter interlock input, and laser excitement input cannot be controlled from Profinet. Control those inputs from I/O.
Displays the number for the error currently occurring. The error number
Word Error Code 1 display differs to the normal display.
The error codes are displayed as four digits such as 1*** for an error
Error Number
(E***), 2*** for a warning error (W***), and 3*** for an I/O error (T***).
Word Error Code 2 Up to two errors can be displayed. When three or more errors occur,
check them with Marking Builder Plus.
[Reset timing]
If Command Send Request fails due to a software error, the error
Command Send Reset when Command
Word number is displayed. The error number display differs to the normal
Error Status Send Request Complete Bit
display. A software error (S***) is displayed as 4*** in four digits.
Clear turns on or the next
Command Send Request
3
turns on.
Job Number
Word Job No Status Displays the currently selected job number.
(0 to 1999)
Counter Number
• Counter Value Status that is to be displayed
Word Counter No Status Displays the number of the target counter listed above.
(0 to 19)
Changes with Counter No Change Request.
Individual Counter(0 to 9): 0 to 9
Operate Common Counter(A to J):10 to 19
5 16 0
Parameter Counter Value Counter Value Displays the current counter value set to be displayed for Counter No
DWord
Status (0 to 4294967295) Change Request.
I/O Encoded Character Value
Word Rank Value Status Displays the value for I/O specified characters.
(0 to 35)
System Info ID
Word System Info ID Displays the currently selected operation information ID.
(0 to 301)
System Info Value
DWord System Info Value Displays the operation information specified by System Info ID.
(0 to 4294967295)
Bit area for writing the request from the PLC onto the laser marker
In the following areas, information is divided by bit. The bit values are either 0 or 1.
The request from the PLC is written onto the laser marker via cyclic communication. An area without a description is reserved.
Slot Size Module Address bit Name Status Information Description
0→1: Start
1→0 : - Starts the marking.
If marking cannot be performed or is canceled, Start Marking Request
0 Start Marking Request [Condition of operation] Error turns on. The Marking Busy Status turns on during marking. If
The Ready Status is turned marking completes successfully, Marking Complete 1 and 2 turn on.
on.
Starts guide laser marking.
0→1: Start
Enter the number into Request No. beforehand.
1→0 : -
0: Distance pointer 1: Guide laser once
[Condition of operation]
The Ready Status is turned 2: Guide laser continuously 3: Area frame
on.
1 Guide Laser Request 4: Work image 5: Block frame
* During shutter control,
3
contactor control, and
If marking completes or is canceled (including canceled due to an error)
safety shutter control, the
after a set amount of time, the Guide Laser Request Complete bit turns on.
request is received even if
If guide laser marking cannot start, Guide Laser Request Error turns on.
the Ready Status is turned
If the move marking setting is selected, guide laser marking cannot be
off.
used. The error bit turns on.
PROFINET
0→1: Stop
1→0 : -
2 Stop Marking Request Cancels marking.
[Condition of operation]
The Marking Busy Status is
0
turned on.
If an error occurs, remove the cause of the error and then turn this bit
on to clear the error. An Error Status Bit error cannot be cleared (it is
reset when the Complete Bit Clear statuses turn on or the next Request
0→1: Error Clear
3 Error Clear Request turns on).
1→0 : -
After the operation has been completed, Error Clear Complete turns
on regardless of whether the error is cleared successfully or not. If the
error cannot be cleared, Error Clear Request Error turns on.
Reads 2D code.The reading position is the current scanner coordinates.
Reading is performed with the coaxial camera in wide mode. The
0→1: Start internal lighting does not turn on automatically during reading. To use
1→0 : - this lighting, turn it on via communication or I/O before executing the
4 2DC Read Request 2DC Read Request.
[Condition of operation]
If this request is run when the condition of operation is not satisfied, Mark
The Ready Status is turned
Check/2DC Read OK Status, Mark Check/2DC Read NG Status, and 2DC
on.
Read Complete are reset, and 2DC Read Request Error turns on.
* It cannot be used on the MD-X400(A)/450(A) series.
0→1: Start Starts the lens inspection.
1→0 : - If this request is run when the condition of operation is not satisfied,
Window Monitoring
General 5 Window Monitoring Complete is reset, and Window Monitoring Request
Request [Condition of operation]
0 8 Error is turned on.
Request The Ready Status is turned
* It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
on.
Starts the job editing.
If the start edit request is received successfully, the job change
request after that is retained temporarily in the controller, and the job is
0→1: Edit Start
1 0 Job Edit Start Request deployed all at once when editing is completed. Use this request if you
1→0: Edit End
want to reduce the communication time used by job editing. If edit start
is received successfully, Job Edit Busy Status turns on. Additionally, if
edit start is received successfully, Job Edit Complete turns on. 1
0 Job Change Request Changes the job number. * 1
1 Rank Change Request Changes the I/O specified characters. * 1
Changes the number of the counter to be changed. * 1
Counter No Change
2 Individual Counter(0 to 9): 0 to 9
Request
Common Counter(A to J):10 to 19
Counter Value Change Changes the value of the counter set to be displayed for Counter No
3
2 Request Change Request. * 1
Increases the value of the counter set to be displayed for Counter No
4 Counter Up Request
Change Request. * 1
Reduces the value of the counter set to be displayed for Counter No
5 Counter Down Request
Change Request. * 1
Resets the counter set to be displayed for Counter No Change
6 Counter Reset Request
Request. * 1
0→1: Request Changes the operation information ID. The operation information to the
1→0 : - ID is displayed to System Info Value.* 1
3
Response Data. Sending the request before marking results in an error.
Disables the trigger input.
If this bit turns on while marking, the trigger lock status is activated after
0 Trigger Lock Request
all of the mark data is marked. Test marking and sample marking is
immediately canceled when this bit turns on.
PROFINET
Function 0: Input Off Stops the marking laser and the guide laser.
1 4 0 2 Laser Stop Request
Request 1: Input On The internal shutter closes while this bit is turned on.
If the controller's internal clock passes midnight when this bit is turned
3 Date Hold Request on, the date of updated string is subtracted one day and the subtracted
date is marked.
Turns on an internal lighting.
4 Internal Lighting Request
* It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
Distance Laser Stop Stops the distance laser.
5
Request * It cannot be used on the MD-X2050(A)/400(A)/450(A) series.
0 Marking Complete Bit Clear Resets Marking Complete and Start Marking Request Error.
* 1 Turns on this bit after storing the job No., I/O specified character No., counter value, counter No., and operation information No. in the
applicable Request No.
* 2 If you turn on this bit after storing the block No. in Request No., the content will be loaded from the specified block in the current job. Store
the load result in Response Data.
Slot Size Module Address Data Type Name Status Information Description
Numbers Stores the job No., block No., counter value, and counter No. to be
3 4 Request No 0 DWord Request No
(Four bytes) changed.
Data size
0 Word Request Data Size Stores the data length of “Request Data” in 16-bit binary data.
(Two bytes)
2+ Request Use for String Change Request and Command Send Request. Store
Command function
4 data Parameters the change string and communication command data. Headers and
(Default: 250 bytes)
size for strings delimiters are not required.
2 Character Request Data * Selectable from 32, 64,
128, and 252 bytes on the
* Selectable capacities are from 32, 64, 128, and 252 bytes on the
PLC settings. (Default: 250 bytes.) However, even if 252 bytes is
PLC.
selected, the maximum amount of data that can be sent is 250 bytes.
* 1 If you turn on this bit after storing the block No. in Request No., the content will be loaded from the target block in the current job, and will be
3
stored in Response Data.
PROFINET
Command communications
PROFINET communication can control the laser via command communication.
Since the communication mode is “command/response type”, multiple commands cannot be sent simultaneously. Therefore, make sure to send the
command only after a response has been received.
The command and response data is a combination of comma-delimited parameters.
z Communication format
Header and delimiter settings are not required. Store the send data size in “Request Data Size” and the send data in “Request Data” in the PLC
command area. Then set the “Command Send Request” bit to “1” to enable the stored data to be sent to the controller. For the communication
commands, refer to “Communication Interface Manual”.
Endian
Endian is a method to place multiple-byte data onto the PLC's data memory. The laser marker uses the big endian method. Data having 2 bytes or more
is recorded/sent in sequence from the upper byte.
Typical endians are below.
• PLCs from Siemens: Big endian
• Omron PLC: Little-Endian
GSDML file
GSDML file includes information on the PROFINET functions of the controller.
GSDML file is in the following folder of the PC which Marking Builder Plus was installed on.
C:\Program Files\keyence\MarkingBuilderPlus_Ver*\etc\ Profinet\[model name]
(Version of Marking Builder Plus is in *.)
Copy this file onto your PLC as required.
File name: GSDML-[Version]-Keyence-[Model name]-yyyymmdd.xml
(yyyymmdd is an update time of the file.)
The MD-X400 Series can use a GSDML file from the MD-X2000 Series.
In this case, some displays may be the contents of the MD-X2000 series.
z Confirmation method
Start Marking Builder Plus, and select the [Maintenance] tab > [Communication] > [Communication History].
The [Communication History] window appears. Click the [Update] button to display the latest history.
3
PROFINET
If the Communication history is empty, the laser marker has not received any Communication.
Double check the communication settings between the laser marker and the PLC, and make sure that the HUB and cable are not defective.
z Request format
Each request will be stored in the communication history in the following format:
Command: ***** Request
Response: ***** Request,X (X = 0: Success; X = 1: Fail)
However, the requests below have a different format. (X = 0: Success; X = 1: Fail)
Request History format (“>” = command; “<” = response)
> 2DC_Read_Request,0
2DC Read Request
< 2DC_Read_Request,X,[Grade],[Content]
> System_Info_ID_Change_Request,[System_Info_ID]
System Info ID Change Request
< System_Info_ID_Change_Request,X
> Window_Monitoring_Request,WindowCheck
Window Monitoring Request
< Window_Monitoring_Request,[OK/NG], [Score]
> XY_Tracking_Result_Request,0
XY_Tracking_Result_Request < XY_Tracking_Result_Request, [OK/NG], [X Coordinate Gap Amount], [Y Coordinate Gap Amount], [θ Gap Amount], [Correlation
Value], [Execution Time], [Result]
> Z_Tracking_Result_Request
Z_Tracking_Result_Request < Z_Tracking_Result_Request, [OK/NG], [Z Coordinate Gap Amount], [X Rotation Angle], [Y Rotation Angle], [Stability], [Execution
Time], [Result]
An error may be the cause of the request not working. You can check up to two error codes simultaneously, Error Code 1 and Error Code 2.
Error details and resolutions are listed in the User's Manual for the applicable model.
• For the Ethernet setup of the controller such as IP address and subnet mask, refer to “Marking Builder Plus User's Manual.”
• This product needs to be restarted when you enable the PROFINET settings and rename any device name.
PROFINET
5 Press [OK].
Checking the setup of the Laser marker Modify the settings of the Siemens S7-1200
series.
1 Select [Controller] from the [Settings] tab, and
then [Ethernet Settings].
1 Start up [Totally Integrated Automation Portal]
with the PC and the CPU connected each
3 2 Configure the Ethernet.
Use the settings below here as an example.
other, and select [Create new project] from
the [Start] menu.
(Modify the settings depending on the destination device).
PROFINET
Parameter Contents
2
IP address 192.168.1.20
Enter a project name in the [Project name]
Subnet mask 255.255.255.0
column, and select [Create].
Default gateway Not used
2DC reader/marking
confirmation 1: 2DC reader/2: Marking verification
output assignment
Move the mouse cursor away. If the indication below appeared, the
network has been established.
PROFINET
[Properties].
5
Use the settings below here as an example.
Create the connection with the MD-X2000/2500 (Modify the settings depending on the destination device).
series. PLCs from Siemens
Setting items MD-X2000/2500 series
CPU 1211C DC/DC/DC
Through [Device] - the [Device & networks] screen - [Hard ware
Catalog] - [Filter], open “Other field devices” - “PROFINET IO” - IPaddress 192.168.0.20 192.168.0.30
“Sensors” - “KEYENCE CORPORATION.” - “Keyence Laser Marker,”
and drag and drop “ MD-X2XXX Series.” Subnet mask 255.255.255.0 255.255.255.0
PROFINET device
MD-x2xxx plc_1
name
Shortest possible
8 ms -
Update interval
3
Here the device is assigned as an example as shown below.
PROFINET
Module Address
Error Status Bits I address 216 - 223 PLC specified area device tag table
Error Codes I address 224 - 231
Edit the name of the new tag table and edit the list inside tag table.
Set a function name in [Name], and set the address which has
been assigned in [Device overview] beforehand in relation to that
function in [Address]. Here set the items below based on the device
map.
PROFINET
Laser Emitted Status %I201.0 Marked String Read Request Error %I220.1
Machine
Shutter Control Status %I201.1 String Change Request Error %I220.2
Status
Remote Interlock Status %I201.2 Command Send Request Error %I223.0
Safety Shutter Status %I201.3 Error Code 1 %IW224
Busy Status %I202.0 Error Code 2 %IW226 Error Codes
Marking Busy Status %I202.1 Command Send Error Status %IW228
Guide Laser Busy Status %I202.2 Job No Status %IW232
Job Change Busy Status %I202.3 Counter No Status %IW234
Communication Priority Error Status %I202.4 Counter Value Status %ID236 Operate
Job Edit Busy Status %I202.5 Rank Value Status %IW240 Parameter
Mark Check /2DC Read Busy Status %I202.6 System Info ID %IW242
Trigger Lock Status %I204.0 System Info Value %ID244
Operation Stop Status %I204.1 Marking Check Score / 2DC Read Grade
%IW248 Marking
Status Check/2D
Laser Control Status %I204.2
Marking Check/2DC Read Total Count Code Read
Date Hold Status %I204.3 %IW250 Result
Status
Internal Lighting Status %I204.4
Count Result
Total Marking Count Status %ID256
Distance Laser Stop Status %I204.5 Data
Date Attach Status %I205.0 Response Data Size %IW260 Response
Function
Status Response Data %IB262 Data
Counter End1 Status %I205.1
Counter End2 Status %I205.2
Counter End3 Status %I205.3
Counter End4 Status %I205.4
Mark Check/2DC Read OK Status %I205.5
Mark Check/2DC Read NG Status %I205.6
Marking Complete 1 %I205.7
Marking Complete 2 %I208.0
Guide Laser Complete %I208.1
Laser Stop Complete %I208.2
Error Clear Complete %I208.3
2DC Read Complete %I208.4
Job Edit Complete %I209.0
Job Change Complete %I210.0
Rank Change Complete %I210.1
Counter No Complete %I210.2 Completion
Counter Value Complete %I210.3 Status
Guide Laser Request %Q200.1. IF THE RUN LED DOES NOT TURN ON
• The PROFINET settings may be incorrect; the
Stop Marking Request %Q200.2 cables connection may be incorrect; or the laser
Error Clear Request %Q200.3 marker may have not started up.
• Once the communication is disconnected, the RUN
2DC Read Request %Q200.4
3
LED turns off. In this case, use the mode switch of
Job Edit Start Request %Q201.0 the CPU to execute the MRES and switch to the
RUN mode.
Job Change Request %Q202.0
Rank Change Request %Q202.1
PROFINET
If the name for each device via tag table is determined, the
device names are displayed when creating or executing
the job.
This part describes the procedure to control the laser marker through the PLC by the PROFINET communication.
PROFINET
(2)
(1) Require switching of the job.
Store the job No. to be set in [Request No] and turn the [Job
Change Request] bit into “1.”
(2) Check that the job change has been completed.
The “Job Change Request Complete” bit turns to “1.”
(3) Enter a trigger.
• While changing the job No., the “Ready Status” bit is “0”
and the “Busy Status” bit is “0.”
• If the job No. switching fails, the “Job Change Request (3)
Error” bit is “1.”
• The “Job Change Complete” bit is cleared by turning the
“Job Change Complete Bit Clear” bit into “1” or start of
the next operation. Before that, the bit remains “1.”
• Each bit remains “1” until the completion bit or the next
operation starts.
(4)
Use the command communication to change and mark the job No.
Ready
z Referential ladder diagram
The following is a referential job for switching and marking the job No.
using the command communication.
Request Data Size Programming for practical operations needs to consider additional
functions such as error processing.
PLCs from Siemens
Request Data
(1)
Command Send Request
3
(1) (2) (3)
3
(1) (2) (3) (4) (5)
PROFINET
The “Marking Complete 2” bit turns to “1.”
(3) Read the 2D code.
Turn the “2DC Read Request” bit into “1.”
(4) Confirm the 2D code reading has been completed.
The “2DC Read Complete” bit turns to “1.”
(3)
(5) Load the assessment result of the 2D code.
At the same time as loading of the 2D code is completed, the result
is stored in “2DC Read Grade Status.”
1
“Modify”→”Modify to 1” to change the bit to “1”.
Select “Online” - “Go online” on the menu
Right click
bar.
3
“Main” program is switched to in the following.
PROFINET
5 Confirm the judgement result.
Judgment result is stored to “%MB100”.
“4” is stored in the following, therefore, the grade becomes A.
MEMO
3
PROFINET
OPC UA
Security precautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
OPC UA Server Function . . . . . . . . . . . . . . . . . . . . . 4-3
OPC UA communication specifications and functions. . 4-3
System configuration example . . . . . . . . . . . . . . . . . . . . . 4-3
How to configure the laser marker . . . . . . . . . . . . . . . . . . 4-4
Certificate registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Node structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Node functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Alarms & conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
Control examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
Communication history . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
Getting Started
What is OPC UA? Security precautions
The MD-X2000/2500 Series is equipped with an OPC UA server
function. z Do not use OPC UA if security vulnerabilities exist.
OPC UA is an industrial network communication protocol. It is a • To limit access to the OPC UA settings, enable the user management
service-oriented architecture that is not dependent on platform and that function on the laser marker and set an appropriate user level.
integrates into an extensible framework all the functionality of the OPC • Use OPC UA with its security functions, such as encryption and
Classic specifications. signatures, enabled. By default, the security policy [None] is also
It provides excellent inter-device interconnectivity and can connect enabled to allow for an easier initial connection. When operating
various layers from field devices to cloud-based servers. with the security function enabled, disable [None]. Because it has a
Its safety and high reliability have led to it being used in more and more security level lower than SHA2, only use SHA1 when necessary.
industrial devices as time goes on.
• Formulate and make use of a policy for managing user names and
passwords.
• Appropriately perform management such as updating, revoking, and
deleting certificates. When trusting a certificate, thoroughly check
its information to check whether the correct certificate has been
registered.
• Manage private keys so they are not disclosed.
4
• Do not use applications and user certificates for multiple purposes.
• Apply all software updates that patch vulnerabilities.
• Manage the network in a way that makes data interception and DoS
attacks difficult.
• If there is the risk of illegal access from external devices over the
network, users must implement countermeasures.
URL (endpoint URL) specification method opc.tcp://[IP address]:[port no.] Example) opc.tcp://192.168.0.10:4840
OPC UA
Basic128Rsa15 / Basic256 / Basic256Sha256 / Aes128Sha256RsaOaep /
Signature and encryption algorithms
Aes256Sha256RsaPss
*1 The monitor item count is the number of elements to set as the targets to communicate with on the OPC UA client in a cyclic manner.
*2 Set the sampling cycle with the OPC UA client.
OPC UA server
(laser marker) Communication route 1
LAN1 (MAIN)
TCP/IP, EtherNet/IP, Profinet
OPC UA client
(MES, etc.)
Communication route 2
LAN2 (SUB)
OPC UA protocol
4
OPC UA
3 Trust the client on the laser marker. Procedure example 2 for initial connection to
Select [Client Certificate]. OPC UA client (when the client certificate is
self-signed)
In this procedure example, the client certificate is registered prior to
establishing the connection.
OPC UA
Select [+] next to [Trusted Client/CA certificates], and then select
the security certificate (*.der) to register.
Certificate registration
CA certificate registration procedure (when the
client certificate is CA-signed)
In advance, register the laser marker’s server certificate as a trusted
CA certificate and certificate revocation list certificate on the client. Alternatively, register the client certificate CA on
the client as necessary.
• CA
CA (Certificate Authority) issues electronic certificates and revokes CA-signed client certificates can be used according to the following patterns.
electronic certificates for which revocation requests have been made This section will explain how to register certificates in patterns 1 and 2.
and for which there is the possibility that their private keys are no In patterns 3 and 4, where a root CA certificate and intermediate CA
longer safe. certificate exist, all CA certificates and CRLs must be registered in the
• CA certificate same manner.
CA electronic certificates. Required when creating, revoking, and
using a certificate authorized by the CA. • Pattern 1
• Certificate revocation list Register as Trusted
The certificate revocation list is expressed as CRL.
The CRL contains the certificates revoked by the CA. You can check
which certificates have been revoked by checking the CRL. Root CA
certificate
The trusted certificate revocation list is prioritized
over the issuer authentication certificate
revocation list.
Trusted
Basic256 -
Basic256Sha256 -
Client certificate 1 Client certificate 2 Client certificate 3
Aes128-Sha256-RsaOaep -
Connectable Not connectable Not connectable
Aes256-Sha256-RsaPss -
OPC UA
Select [Issuer authentication].
Select [+] next to [CA certificate], and then select the CA certificate
to add.
2 Register the CRL of the CA certificate. CA certificate registration procedure (when the
Select [+] next to [Client Certificate Revocation List], and then user certificate is CA-signed)
select the CRL of the CA certificate. The certificate registration screen is accessed from [User Certificate].
The rest of the procedure is the same as when registering client
certificates.
For details on the procedure, refer to “CA certificate registration
procedure (when the client certificate is CA-signed).”
Server certificate
4
2
OPC UA
Register the CRL of the CA certificate.
Select [+] next to [Client Certificate Revocation List], and then Because the certificate is CA-signed, the Issued to
select the CRL. and Issued by fields differ.
Node structure
The MD-X2000 Series node structure is as follows.
Node (Object) structure
Root
└──── Objects
└──── LaserMarker
├──── MachineStatus
│ ├──────── ReadyStatus
│ ├──────── ErrorStatus
│ ├──────── WarningStatus
│ ├──────── IOErrorStatus
│ ├──────── ErrorCode
│ ├──────── ShutterStatus
│ ├──────── NetworkStatus
│ ├──────── JobChangeReadyStatus
│ ├──────── DistanceLaserOperationReadyStatus
│ ├──────── MarkingLaserExcitedStatus
│ ├──────── ShutterControlStatus
│ ├──────── RemoteInterlockStatus
│ ├──────── LaserSafetyModuleStatus
│ ├──────── DataLoggingTriggerStatus
│ ├──────── ExternalLightControlStatus
│ ├──────── BusyStatus
│ ├──────── MarkingBusyStatus
│ ├──────── GuideLaserBusyStatus
│ ├──────── JobChangeBusyStatus
│ ├──────── CommunicationPriorityBusyStatus
4
│ ├──────── JobEditBusyStatus
│ ├──────── MarkingConfirmationBusyStatus
│ ├──────── 2DCodeReadBusyStatus
│ ├──────── WindowCheckBusyStatus
│ ├──────── TriggerLockStatus
│ ├──────── OperationDisableStatus
OPC UA
│ ├──────── LaserControlStatus
│ ├──────── DateHoldInputStatus
│ ├──────── BuiltInLightStatus
│ ├──────── DistanceLaserStopStatus
│ ├──────── DateHoldOutputStatus
│ ├──────── CounterCompletionStatus
│ ├──────── CurrentJobNo
│ └──────── IOEncodedCharacter
├──── OperationResult
│ ├──────── MarkingCompleteStatus
│ ├──────── TotalMarkingCount
│ ├──────── MarkingConfirmationResult
│ ├──────── MarkingConfirmationScore
│ ├──────── MarkingConfirmationTotalOperationCount
│ ├──────── 2DCodeReadResult
│ ├──────── 2DCodeReadGrade
│ ├──────── 2DCodeReadTotalOperationCount
│ └──────── WindowCheckScore
│ ├──────── WorkflowResult
│ ├──────── WorkflowTime
│ ├──────── CameraImageBeforeMarkingResult
│ ├──────── WindowCheckBeforeMarkingResult
│ ├──────── WindowCheckBeforeMarkingScore
│ ├──────── WindowCheckBeforeMarkingScoreDetail
│ ├──────── WindowCheckBeforeMarkingTime
│ ├──────── XYTrackingResult
│ ├──────── ZTrackingResult
│ ├──────── MarkingResult
│ ├──────── MarkingTime
│ ├──────── CameraImageAfterMarkingResult
│ ├──────── MarkingConfirmationTime
│ ├──────── 2DCodeReadString
│ ├──────── WindowCheckAfterMarkingResult
│ ├──────── WindowCheckAfterMarkingScore
│ ├──────── WindowCheckAfterMarkingScoreDetail
│ ├──────── WindowCheckAfterMarkingTime
│ ├──────── MarkingEnergyResult
│ ├──────── MarkingEnergy
│ ───────── MatrixCellInformation
├──── IOFunction
│ ├──────── TriggerLockRequest
│ ├──────── OperationDisableRequest
│ ├──────── LaserStopRequest
│ ├──────── DateHoldRequest
│ ├──────── BuiltInLightRequest
│ └──────── DistanceLaserStopRequest
├──── MachineInformation
│ ├──────── ControllerOperatingTime
│ ├──────── LaserExcitedTime
│ ├──────── ScannerOperatingTime
│ ├──────── ShutterOperationCount
│ ├──────── LaserSafetyModuleOperationCount
│ ├──────── HeadTemperature
│ ├──────── ControllerTemperature
│ ├──────── LaserPowerCalibrationResult
│ ├──────── VersionInformation
│ ├──────── LaserMarkerID
├──────── LaserMarkerModel
│ └──────── SerialNumber
├──── MarkingOperation
│ ├──────── StartMarking
│ ├──────── StartGuideLaser
│ ├──────── StopMarking
│ ├──────── Read2DCodePosition
│ ├──────── Read2DCodeBlock
│ ├──────── GetXYTrackingResult
│ ├──────── GetZTrackingResult
│ └──────── GetMarkedString
│ ├──────── GetZTrackingMatrixCellResult
│ ├──────── GetZTrackingMatrixCellNoResult
│ ├──────── GetCameraImage
│ ├──────── StartMarkingResult
│ ├──────── StartGuideLaserMarkingResult
│ ├──────── StopMarkingResult
│ ───────── Read2DCodeResult
├──── JobOperation
│ ├──────── StartJobEdit
│ ├──────── EndJobEdit
4
└──────── InitializeAllSetting
└──────── SaveMLogFile
├──────── SaveJobFileResult
├──────── LoadJobFileResult
├──────── BackupAllSettingResult
├──────── RestoreAllSettingResult
OPC UA
├──────── InitializeAllSettingResult
───────── SaveMLogFileResult
• Method and FileType nodes are added to [JobFiles], [LogoFiles], [CustomCharacterFiles], [Z-MapFiles], [FontFiles], [BackupFiles], and [MlogFiles]
under [FileOperation]. Size, Writable, UserWritable, and OpenCount nodes are added to each FileType node.
• The number of nodes varies dynamically according to the saved data contents. Files with non-targeted extensions cannot be created (with CreateFile
Method).*4
• NodeID is in String format and is referenced from the LaserMarker node via a slash (“/”). For example, “LaserMarker/FileOperation/JobFiles/AAA.ma2”
references the job file AAA.ma2. Furthermore, “LaserMarker/FileOperation/JobFiles/AAA.ma2/Size” references this file’s Size property.
└──── FontFiles[FileDirectoryType]
│ └──── CreateFile[Method]
│ └──── Delete[Method]
│ └──── MoveOrCopy[Method] *1
│ └──── HHH.fuy[FileType]
│ │ └────・・・・
│ └──── ・・・・
│
└──── BackupFiles[FileDirectoryType] *2
│ └──── CreateFile[Method]
│ └──── Delete[Method]
│ └──── MoveOrCopy[Method] *1
│ └──── JJJ.mab2[FileType]
│ │ └────・・・・
│ └──── ・・・・
│
└──── MLogFiles[FileDirectoryType] *2
│ └──── Delete[Method]
│ └──── MoveOrCopy[Method] *1
│ └──── KKK.mlog[FileType] *3
│ │ └────・・・・
│ └──── ・・・・
│
└──── SaveJobFile[Method]
└──── LoadJobFile[Method]
4 └──── BackupAllSetting[Method]
└──── RestoreAllSetting[Method]
└──── InitializeAllSetting[Method]
└──── SaveMLogFile[Method]
OPC UA
└──── SaveJobFileResult
└──── LoadJobFileResult
└──── BackupAllSettingResult
└──── RestoreAllSettingResult
└──── InitializeAllSettingResult
└──── SaveMLogFileResult
Node functions
Objects
Name Node
Affiliated object Item Overview Supplemental explanation
Space ID
2 15001 Root - Object LaserMarker Laser marker object (includes the following objects)
OPC UA
Object for controlling files such as by transferring
2 15009 LaserMarker FileOperation
them
Variable
Name Node Read/ Supplemental
Affiliated object Item Type Overview
Space ID Write explanation/value range
Shutter open/closed
2 16006 MachineStatus ShutterStatus Boolean Read
status
Network connection
2 16007 MachineStatus NetworkStatus Boolean Read
status
Marking in progress
2 16016 MachineStatus MarkingBusyStatus Boolean Read
status
4
Marking confirmation in
2 16021 MachineStatus MarkingConfirmationBusyStatus Boolean Read
progress status
2D code reading in
2 16022 MachineStatus 2DCodeReadBusyStatus Boolean Read
progress status
OPC UA
Lens inspection in
2 16023 MachineStatus WindowCheckBusyStatus Boolean Read
progress status
UInt32
2 16032 MachineStatus CurrentJobNo Read Current job number Value range: 0 to 1999
(Unsigned Integer)
I/O-specified character
2 16034 MachineStatus IOEncodedCharacter UInt32 Read Value range: 0 to 35
acquisition
0: no result, 1: success, 2:
Previous marking
2 16037 OperationResult MarkingConfirmationResult UInt32 Read failure, 3: outside of error
confirmation result
thresholds
0: no result, 1: success, 2:
Previous 2D code reading
2 16040 OperationResult 2DCodeReadResult UInt32 Read failure, 3: outside of error
result
thresholds
Previous workflow
2 16079 OperationResult WorkflowTime UInt32 Read
execution time (ms)
Score of previous
Value range: 0 to 100 (0
2 16082 OperationResult WindowCheckBeforeMarkingScore UInt32 Read pre‑marking lens
when there is no result)
inspection (all)
OPC UA
Previous XY tracking
2 16085 OperationResult XYTrackingResult UInt32 Read
result (all)
0: no result, 1: success, 2:
Previous Z tracking result
2 16086 OperationResult ZTrackingResult UInt32 Read failure, 3: outside of error
(all)
thresholds
0: no result, 1: success, 2:
2 16087 OperationResult MarkingResult UInt32 Read Previous marking result
failure
Previous marking
2 16098 OperationResult MarkingTime UInt32 Read
time (ms)
Previous marking
2 16089 OperationResult MarkingConfirmationTime UInt32 Read confirmation execution
time (ms)
Score of previous
Value range: 0 to 100 (0
2 16092 OperationResult WindowCheckAfterMarkingScore UInt32 Read pre‑marking lens
when there is no result)
inspection (all)
Execution time of
2 16094 OperationResult WindowCheckAfterMarkingTime UInt32 Read previous pre-marking lens
inspection (ms)
Read/
2 16045 IOFunction TriggerLockRequest Boolean Trigger lock request
Write
Read/
2 16047 IOFunction LaserStopRequest Boolean Laser stop request
Write
Read/
2 16048 IOFunction DateHoldRequest Boolean Date hold request
Write
Value range: 0 to
2 16051 MachineInformation ControllerOperatingTime UInt32 Read Controller operating time
4294967295 (unit: H)
Value range: 0 to
2 16052 MachineInformation LaserExcitedTime UInt32 Read Laser operating time
4294967295 (unit: H)
Value range: 0 to
4
2 16053 MachineInformation ScannerOperatingTime UInt32 Read Scanner operating time
4294967295 (unit: H)
Value range: 0 to
2 16054 MachineInformation ShutterOperationCount UInt32 Read Shutter operating count
4294967295
OPC UA
Laser marker ID
2 16060 MachineInformation LaserMarkerID String Read
(nickname)
Result of stopping
Read/
2 16066 MarkingOperation StopMarkingResult OperationMethodResultType marking via OPC UA *2
Write
(StopMarking)
Result of 2D code
Read/ reading via OPC UA
2 16067 MarkingOperation Read2DCodeResult OperationMethodResultType *2
Write (Read2DCodePosition/
Read2DCodeBlock)
Result of lens
Read/
2 16069 GeneralOperation StartWindowCheckResult OperationMethodResultType inspection via OPC UA *2
Write
(StartWindowCheck)
Result of setting
Read/ the current job
2 16071 JobOperation SetCurrentJobNoResult OperationMethodResultType *2, *3
Write number via OPC UA
(SetCurrentJobNo)
Number of corresponding
files opened via OPC UA
communication. Open
4
- - Each FileType node OpenCount UInt16 Read
Method increases this
OPC UA
value and Close Method
decreases it.
*1 epending on the sampling cycle setting, the length of time that MarkingCompleteStatus and CounterCompletionStatus are monitored as ON may be
D
shorter than the ON time of the terminal block. It may not even be possible to monitor these two values switching to ON at all.
*2 When using it for handshaking with the corresponding Method, write 0: None in advance and then call Method.
*3 Result is saved after expansion process completes.
Method
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
Method processing
finishes when the
Marking start request
is output. Processing
completion notification is
1. Success/failure
provided via an event. If
<Succeeded>: Boolean Starts
2 17001 MarkingOperation StartMarking None the block to mark does
2. Error code marking
not exist within the job,
<ErrorCode>: String
the S101 error occurs in
the MarkingEnd event.
Related events:
MarkingStart,
MarkingEnd
Method processing
finishes when the
GuideLaser start request
1. Success/failure
is output. Processing
A. Type <Type>: <Succeeded>: Boolean Starts guide
4
2 17002 MarkingOperation StartGuideLaser completion notification is
GuideLaserType 2. Error code laser marking
provided via an event.
<ErrorCode>: String
Related events:
GuideLaserMarkingStart,
GuideLaserMarkingEnd
OPC UA
1. Success/failure
Related events:
<Succeeded>: Boolean Stops
2 17003 MarkingOperation StopMarking None MarkingEnd,
2. Error code marking
GuideLaserMarkingEnd
<ErrorCode>: String
A: 0 to 255
B: 0 to 100 The Method
A. Block number finishes when 2D
<BlockNo>: 1. Success/failure 2D code code reading starts.
UInt32 <Succeeded>: Boolean reading Processing completion
2 17005 MarkingOperation Read2DCodeBlock
B. Reading range 2. Error code (block notification is provided
<ReadingArea> <ErrorCode>: String specification) via an event.
(%): UInt32 Related events:
2DCodeReadingStart,
2DCodeReadingEnd
1. Success/failure
<Succeeded>: Boolean
2. Error code
<ErrorCode>: String
3. X deviation [mm] <X_
Deviation>: Double
A: 0 to 7
4. Y deviation [mm] <Y_
A. Tracking 6: 0 to 100
Deviation>: Double Acquires the
number 8: Result (0: Failure, 1:
2 17006 MarkingOperation GetXYTrackingResult 5. Angle [°] <Theta_ XY tracking
<TrackingNo>: Success,
Deviation>: Double result
UInt32 2: Success (low match
6. Match level
level))
<Correlation>: UInt32
7. Tact
[ms] <ExecutionTime>:
UInt32
8. Result <Result>:
UInt32
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
1. Success/failure
<Succeeded>: Boolean
2. Error code
<ErrorCode>: String
3. Z deviation [mm] <Z_
Deviation>: Double A: 0 to 255
A. Tracking 4. X tilt [°] <X_ 6: 0 to 100
Acquires the
number AngleDeviation>: Double 8: Result (0: Failure, 1:
2 17007 MarkingOperation GetZTrackingResult Z tracking
<TrackingNo>: 5. Y tilt [°] <Y_ Success, 2: Success (low
result
UInt32 AngleDeviation>: Double stability), 3: Success (out
6. Stability <Stability>: of tolerance range))
UInt32
7. Tact
[ms] <ExecutionTime>:
UInt32 8. Result
<Result>: UInt32
1. Success/failure
A. <JobNo>:
<Succeeded>: Boolean
UInt32
2. Error code Acquires the A: 0 to 1999
4
2 17008 MarkingOperation GetMarkedString B. Block number
<ErrorCode>: String marked string B: 0 to 255
<BlockNo>:
3. Marked string
UInt32
<MarkedString>: String
1. Success/failure
OPC UA
<Succeeded>: Boolean
2. Error code
<ErrorCode>: String
3. Z deviation [mm] <Z_
Deviation>: Double Acquires A: 0 to 255
A: Row number 4. X tilt [°] <X_ the matrix B: 0 to 255
<Row>: UInt32 AngleDeviation>: Double cell height 6: 0 to 100
2 17034 MarkingOperation GetZTrackingMatrixCellResult B. Column 5. Y tilt [°] <Y_ correction 8: Result (0: Failure, 1:
number AngleDeviation>: Double result (row Success, 2: Success (low
<Column>: UInt32 6. Stability <Stability>: and column stability), 3: Success (out
UInt32 specified) of tolerance range))
7. Tact
[ms] <ExecutionTime>:
UInt32
8. Result <Result>:
UInt32
1. Success/failure
<Succeeded>: Boolean
2. Error code
<ErrorCode>: String
3. Z deviation [mm] <Z_
Acquires
Deviation>: Double A: 0 to 65025
the matrix
4. X tilt [°] <X_ 6: 0 to 100
cell height
A. Cell number AngleDeviation>: Double 8: Result (0: Failure, 1:
2 17035 MarkingOperation GetZTrackingMatrixCellNoResult correction
<CellNo>: UInt32 5. Y tilt [°] <Y_ Success, 2: Success (low
result (cell
AngleDeviation>: Double stability), 3: Success (out
number
6. Stability <Stability>: of tolerance range))
specified)
UInt32
7. Tact
[ms] <ExecutionTime>:
UInt32 8. Result
<Result>: UInt32
Acquires
camera
A. Image
1. Success/failure images
type <Type>:
<Succeeded>: Boolean (before/after
CameraImageType
2. Error code marking, 2D
2 17023 MarkingOperation GetCameraImage B. Option (XY
<ErrorCode>: String code reading,
tracking number,
3. Jpeg file data marking
etc.) <Option>:
<JpegData>: ImageJPG confirmation,
UInt32
and XY
tracking)
A: 0 to 1999
• If you start editing
with StartJobEdit,
do not change any
setting contents or edit
1. Success/failure
anything other than
A. <JobNo>: <Succeeded>: Boolean Starts setting
2 17009 JobOperation StartJobEdit the job number until
UInt32 2. Error code change
ending editing with
<ErrorCode>: String
EndJobEdit. Doing so
will cause an error in
EndJobEdit, preventing
editing from completing
normally.
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
1. Success/failure
Related events:
<Succeeded>: Boolean Ends setting
2 17010 JobOperation EndJobEdit None ExpansionStart,
2. Error code change
ExpansionEnd
<ErrorCode>: String
A: 0 to 1999
Depending on the
laser marker status, it
may take some time
1. Success/failure
Changes the from the execution of
A. <Succeeded>: Boolean
2 17011 JobOperation SetCurrentJobNo current job SetCurrentJobNo to the
<JobNo>:UInt32 2. Error code
number changing of ReadyStatus
<ErrorCode>: String
to False.
Related events:
ExpansionStart,
ExpansionEnd
1. Success/failure
Changes the
A. <Succeeded>: Boolean
2 17012 JobOperation SetIOEncodedCharacter I/O-specified A: 0 to 35
<EncodedCharacter>:UInt32 2. Error code
character
4
<ErrorCode>: String
1. Success/failure
A. <JobNo>:
<Succeeded>: Boolean
UInt32 Acquires the A: 0 to 1999
2. Error code
2 17013 JobOperation GetCurrentCounterValue B. Counter type current value B: “0” to “9,” “A” to “J”
OPC UA
<ErrorCode>: String
<CounterNo>: of the counter 3: 0 to 4294967295
3. Counter value
String
<CounterValue>: UInt32
A. <JobNo>:
UInt32
B. Counter type 1. Success/failure
Sets the A: 0 to 1999
<CounterNo>: <Succeeded>: Boolean
2 17014 JobOperation SetCurrentCounterValue current value B: “0” to “9,” “A” to “J”
String 2. Error code
of the counter C: 0 to 4294967295
C. Counter value <ErrorCode>: String
<CounterValue>:
UInt32
A. <JobNo>:
1. Success/failure Increases the
UInt32
<Succeeded>: Boolean current value A: 0 to 1999
2 17015 JobOperation UpCurrentCounterValue B. Counter type
2. Error code of the counter B: “0” to “9,” “A” to “J”
<CounterNo>:
<ErrorCode>: String by 1
String
A. <JobNo>:
1. Success/failure Decreases
UInt32
<Succeeded>: Boolean the current A: 0 to 1999
2 17016 JobOperation DownCurrentCounterValue B. Counter type
2. Error code value of the B: “0” to “9,” “A” to “J”
<CounterNo>:
<ErrorCode>: String counter by 1
String
A. <JobNo>:
1. Success/failure
UInt32 Resets the
<Succeeded>: Boolean A: 0 to 1999
2 17017 JobOperation ResetCurrentCounterValue B. Counter type current value
2. Error code B: “0” to “9,” “A” to “J”
<CounterNo>: of the counter
<ErrorCode>: String
String
1. Success/failure
<Succeeded>: Boolean
A. <JobNo>: Acquires
2. Error code
UInt32 the current A: 0 to 1999
<ErrorCode>: String
2 17036 JobOperation GetCurrentCounterRepetition B. Counter type marking B: “0” to “9,” “A” to “J” 3:
3. Current
<CounterNo>: repetition of 0 to 4294967295
marking repetition
String the counter
<RepetitionValue>:
UInt32
A. <JobNo>:
UInt32
B. Counter type Sets the
1. Success/failure
<CounterNo>: current A: 0 to 1999
<Succeeded>: Boolean
2 17037 JobOperation SetCurrentCounterRepetition String marking B: “0” to “9,” “A” to “J”
2. Error code
C. Current repetition of C: 0 to 4294967295
<ErrorCode>: String
marking repetition the counter
<RepetitionValue>:
UInt32
1. Success/failure
A. <JobNo>:
<Succeeded>: Boolean A: 0 to 1999
UInt32
2. Error code Acquires the B. 0 to 255
2 17018 JobOperation GetSettingString B. Block number
<ErrorCode>: String setting string 3: The character code is
<BlockNo>:
3. Setting string UTF-8.
UInt32
<SettingString>: String
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
A. <JobNo>:
UInt32 A: 0 to 1999
B. Block number 1. Success/failure B: 0 255 C: The character
<BlockNo>: <Succeeded>: Boolean Updates the code is UTF-8.
2 17019 JobOperation SetSettingString
UInt32 2. Error code setting string Related events:
C. Setting string <ErrorCode>: String ExpansionStart,
<SettingString>: ExpansionEnd
String
Related events:
Clears the
1. Success/failure ExpansionStart,
currently
<Succeeded>: Boolean ExpansionEnd
2 17020 GeneralOperation ClearError None occurring
2. Error code (Deployment processing
errors/
<ErrorCode>: String may occur when errors
warnings
are reset.)
4
2. Error code provided via an event.
(maintenance)
<ErrorCode>: String Related events:
WindowCheckStart,
WindowCheckEnd
OPC UA
Synchronization
processing will be
A. Command Transmits a performed, so pay
1. Return value
2 17022 GeneralOperation CommandSendRequest <Command>: command attention to the timeout
<Response>: String
String string setting. Command
strings can be up to 4096
characters in length.
FileName: If the
extension is not ma2,
error S024 is returned.
A. Job number Method processing
1. Success/failure
<JobNo>: UInt32 finishes when the file
<Succeeded>: Boolean Saves the job
2 17028 FileOperation SaveJobFile B. File name generation request
2. Error code file
<FileName>: is output. Processing
<ErrorCode>: String
String completion notification is
provided via an event.
Related event:
SaveJobFileEnd
Method processing
finishes when the file
A. Job number
1. Success/failure loading request is output.
<JobNo>: UInt32
<Succeeded>: Boolean Loads a job Processing completion
2 17029 FileOperation LoadJobFile B. File name
2. Error code file notification is provided
<FileName>:
<ErrorCode>: String via an event.
String
Related event:
LoadJobFileEnd
FileName: If the
extension is not mab2,
error S024 is returned.
Method processing
1. Success/failure
A. File name finishes when the backup
<Succeeded>: Boolean Creates a
2 17030 FileOperation BackupAllSetting <FileName>: file generation request
2. Error code backup file
String is output. Processing
<ErrorCode>: String
completion notification is
provided via an event.
Related event:
BackupAllSettingEnd
Method processing
finishes when the request
to restore settings from
the backup file is output.
Processing completion
notification is provided
via an event.
A. File name
1. Success/failure Related event:
<FileName>: Restores
<Succeeded>: Boolean RestoreAllSettingEnd
2 17031 FileOperation RestoreAllSetting String settings from
2. Error code B: Use the bits to specify
B. Option a backup file
<ErrorCode>: String the additional targets to
<Option>: UInt32
restore. (ON bits indicate
targets to restore. Bits
are set to 0 by default.)
Bit 0: Ethernet settings
Bit 1: Nickname
Bit 2: User information
Bit 3: OPC UA settings
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
Method processing
finishes when the
initialization request is
1. Success/failure output. Depending on
A. Initialization
<Succeeded>: Boolean Initializes the initialization contents,
2 17032 FileOperation InitializeAllSetting range <Type>:
2. Error code settings processing completion
InitializeSettingType
<ErrorCode>: String notification is provided
via an event.
Related event:
InitializeAllSettingEnd
4
A. Acquire all Processing completion
remaining data notification is provided
<Entire Period>: via an event.
Boolean Related event:
B. Start time SaveMLogFileEnd
OPC UA
<From>:
DateTime 1. Success/failure • When the controller
C. End time <Succeeded>: Boolean Saves the logging settings are
2 17033 FileOperation SaveMLogFile
<To>: DateTime 2. Error code history file used to set USB memory
D. Do not <ErrorCode>: String as the destination for
acquire images saving the file, data is
<IgnoreImages>: acquired from the USB
Boolean memory. (Data saved to
E. File name USB memory cannot be
<FileName>: acquired as an MLOG file
String in Marking Builder Plus.)
• Saving may fail if the
amount of data to acquire
is large. In this situation,
reduce the amount of
data by configuring
the settings to prevent
acquisition of images or
by shortening the data
acquisition period.
1. Node ID of
A. Directory name
created directory Creates a
2 18001 JobFiles CreateDirectory <DirectoryName>: Not used.*4
<DirectoryNodeId>: directory
String
NodeId
A. File name
(including extension) If the extension is not
1. Node ID of created file
<FileName>: String supported, an error is
<FileNodeId>: NodeId
2 18002 JobFiles CreateFile B. Whether to Creates a file returned. The file handle
2. File handle
open created file is used when calling
<FileHandle>: UInt32
<RequestFileOpen>: FileType node Methods.
Boolean
A. File name
If the file cannot be
(including
deleted, such as because
2 18003 JobFiles Delete extension) None Deletes a file
it is in use, an error is
<ObjectToDelete>:
returned.
NodeId
A. Node ID to move
<ObjectToMoveOrCopy>: Files can only be moved
NodeId (renamed) or copied in
B. Node ID of the the same directory. When
directory to move to renaming a file, it is not
1. New node ID (after
<TargetDirectory>: Moves or possible to leave the
2 18004 JobFiles MoveOrCopy moving or copying)
NodeId copies a file order of the characters
<NewNodeId>: NodeId
C. Whether to copy the unchanged and
file <CreateCopy>: merely switch between
Boolean uppercase and lowercase
D. New name characters.
<NewName>: String
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18005 LogoFiles CreateDirectory
JobFiles object object directory object
The same as the The same as the JobFiles The same as the JobFiles
2 18006 LogoFiles CreateFile Creates a file
JobFiles object object object
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
The same as the The same as the JobFiles The same as the JobFiles
2 18007 LogoFiles Delete Deletes a file
JobFiles object object object
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18008 LogoFiles MoveOrCopy
JobFiles object object copies a file object
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18009 CustomCharacterFiles CreateDirectory
JobFiles object object directory object
The same as the The same as the JobFiles The same as the JobFiles
2 18010 CustomCharacterFiles CreateFile Creates a file
JobFiles object object object
The same as the The same as the JobFiles The same as the JobFiles
2 18011 CustomCharacterFiles Delete Deletes a file
JobFiles object object object
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18012 CustomCharacterFiles MoveOrCopy
JobFiles object object copies a file object
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18013 Z-mapFiles CreateDirectory
JobFiles object object directory object
4
The same as the The same as the JobFiles The same as the JobFiles
2 18014 Z-mapFiles CreateFile Creates a file
JobFiles object object object
The same as the The same as the JobFiles The same as the JobFiles
2 18015 Z-mapFiles Delete Deletes a file
JobFiles object object object
OPC UA
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18016 Z-mapFiles MoveOrCopy
JobFiles object object copies a file object
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18017 FontFiles CreateDirectory
JobFiles object object directory object
The same as the The same as the JobFiles The same as the JobFiles
2 18018 FontFiles CreateFile Creates a file
JobFiles object object object
The same as the The same as the JobFiles The same as the JobFiles
2 18019 FontFiles Delete Deletes a file
JobFiles object object object
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18020 FontFiles MoveOrCopy
JobFiles object object copies a file object
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18021 BackupFiles CreateDirectory
JobFiles object object directory object
The same as the The same as the JobFiles The same as the JobFiles
2 18022 BackupFiles CreateFile Creates a file
JobFiles object object object
The same as the The same as the JobFiles The same as the JobFiles
2 18023 BackupFiles Delete Deletes a file
JobFiles object object object
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18024 BackupFiles MoveOrCopy
JobFiles object object copies a file object
The same as the The same as the JobFiles Creates a The same as the JobFiles
2 18025 MLogFiles CreateDirectory
JobFiles object object directory object
The same as the The same as the JobFiles The same as the JobFiles
2 18027 MLogFiles Delete Deletes a file
JobFiles object object object
The same as the The same as the JobFiles Moves or The same as the JobFiles
2 18028 MLogFiles MoveOrCopy
JobFiles object object copies a file object
A. OR calculation of the
bits
Bit 0: Open loadable file
Bit 1: Open writable file
Bit 2: Delete existing data
A. Mode <Mode>: 1. File handle
2 Each FileType node Open Opens a file and open file
Byte <FileHandle>: UInt32
Bit 3: Open file in
appending mode
The file handle is used
when calling other
Methods.
A. File handle
Closes the
2 Each FileType node Close <FileHandle>: None
file
UInt32
A. File handle
<FileHandle>:
1. Loaded data <Data>: Reads file
2 Each FileType node Read UInt32
ByteString data
B. Length to load
<Length>: Int32
Return value
Name Node Argument Supplemental
Affiliated object Item <Value.Name> Overview
Space ID <Value.Name>*1 explanation
*2, *3
A. File handle
<FileHandle>:
UInt32 Writes data
2 Each FileType node Write None
B. Data to to the file
write <Data>:
ByteString
Acquires
A. File handle the current
1. Current file position
2 Each FileType node GetPosition <FileHandle>: position for
<Position>: UInt64
UInt32 file reading/
writing
A. File handle
<FileHandle>: Sets the
If a value larger than the
UInt32 current
file size is specified with
2 Each FileType node SetPosition B. Current None position for
B, the position is set to
file position file reading/
the end of the file.
<Position>: writing
UInt64
4 *1 W hen specifying a file name to execute a Method, the Marking Builder Plus or laser marker controller file name restrictions are applied.
File name: Up to 100 characters, including the extension. When the file name is expressed in UTF-16, strings that use surrogate pairs cannot be used.
Prohibited characters: #%\/:;,.*?" <>| (half-width space) (full-width space)
*2 Success: TRUE, failure: FALSE.
OPC UA
*3 Error codes only take on a value when a failure occurs. They are blank when the operation is successful.
*4 In terms of the structure, CreateDirectory under JobFiles, LogoFiles, CustomCharacterFiles, Z-mapFiles, BackupFiles, and MLogFiles and CreateFile
under MLogFiles exist but are not used.
If you call these Methods, a BadNotSupported error will be returned, and the operation will not be recorded in the communication history.
Event
Node Notification data
NameSpace Affiliated object Item Overview Supplemental explanation*4
ID <element name in event>
A. Success/
failure
Issued at the completion
<Succeeded>:
of marking (marking, Event type:
- - Server MarkingEnd Boolean
test marking, and laser OperationResultEventType
B. Error code
inspection)*1
<ErrorCode>:
String
A. Success/
failure Issued at the completion
<Succeeded>: of the marking workflow
Event type:
- - Server MarkingWorkflowEnd Boolean (marking, test marking, and
OperationResultEventType
B. Error code single instance of guide
<ErrorCode>: laser marking)*2
String
A. Success/
failure
Issued at the completion of
<Succeeded>:
guide laser marking (guide Event type:
- - Server GuideLaserMarkingEnd Boolean
laser marking and distance OperationResultEventType
B. Error code
pointer)*3
<ErrorCode>:
String
4
not issued in workflows)
A. Success/
failure Issued at the completion
<Succeeded>: of lens inspection (only
Event type:
OPC UA
- - Server WindowCheckEnd Boolean at startup and during
OperationResultEventType
B. Error code maintenance, not issued in
<ErrorCode>: workflows)
String
A. Success/
failure
<Succeeded>:
Issued at the completion of Event type:
- - Server SaveJobFileEnd Boolean
SaveJobFile processing OperationResultEventType
B. Error code
<ErrorCode>:
String
A. Success/
failure
<Succeeded>:
Issued at the completion of Event type:
- - Server LoadJobFileEnd Boolean
LoadJobFile processing OperationResultEventType
B. Error code
<ErrorCode>:
String
A. Success/
failure
<Succeeded>: Issued at the completion
Event type:
- - Server BackupAllSettingEnd Boolean of BackupAllSettings
OperationResultEventType
B. Error code processing
<ErrorCode>:
String
A. Success/
failure
<Succeeded>: Issued at the completion
Event type:
- - Server RestoreAllSettingEnd Boolean of RestoreAllSettings
OperationResultEventType
B. Error code processing
<ErrorCode>:
String
A. Success/
failure
<Succeeded>: Issued at the completion
Event type:
- - Server InitializeAllSettingEnd Boolean of InitializeAllSettings
OperationResultEventType
B. Error code processing
<ErrorCode>:
String
A. Success/
failure
<Succeeded>:
Issued at the completion of Event type:
- - Server SaveMLogFileEnd Boolean
SaveMLogFile processing OperationResultEventType*5
B. Error code
<ErrorCode>:
String
*1 This event is issued multiple times during continuous marking. It is issued every time for the tracking of moving marking marking.
*2 This event is only issued once during continuous marking. It is not issued during moving marking.
*3 This event is issued each time continuous marking is set or the tracking of moving marking occurs during one instance of guide laser marking.
*4 In addition to the BaseEventType, there is also the OperationResultEventType, which returns the success/failure of the operation and the error code in the
case of failure.
*5 This event is not issued when a request is made from Marking Builder Plus.
Depending on the sampling cycle setting and the operation status of the laser marker, the updating of Variables and the issuing of
Events may occur later than the operations of the actual laser marker.
With the MD-X2000 Series, the following Node is provided as the A&C function.
Error Condition (ns=2, i=20001)(DiscreteAlarmType)
The Error Condition node notifies the user of error and warning states with the Severity and Message contents.
To monitor, register a ServerNode to a Subscription.
* Only the T000 terminal block error is targeted by the A&C function.
4
OPC UA
Control examples
Sequence example 1: Transfer the new job file myjob.ma2 and load this file as the laser marker job.
OPC UA client Laser marker
1-1 Call the CreateFile Method of the JobFiles node.
(FileName: myjob.ma2, RequestFileOpen: true)
Close
3-1 Call the Close Method of the FileType node of the acquired FileNodeId.
(FileHandle: value acquired in step 1-2) Load
OPC UA
4-1 Call the LoadJobFile Method of the FileOperation node. Job data in
(JobNo: job number to read, FileName: myjob.ma2) memory
4-1 Acquire the execution result (loading and deployment processing are performed asynchronously).
6 Use an ExpansionEnd Event to provide notification of deployment completion.*3 *2 If the Event cannot be acquired, you can use the
LoadJobFileResult Variable in advance to detect the
completion.
*3 When loaded into the current job number or the advance
deployment target job number, deployment processing
7-1 Call the Delete Method of the JobFiles node.*4 is executed, and an event is issued.
(ObjectToDelete: FileNodeId acquired in step 1-2) (An ExpansionStart Event is also issued at the start.)
The result can also be acquired with the
LoadJobFileResult Variable.
7-2 Acquire the execution result. *4 Because files take up space in the built-in memory, it is
recommended to use the Delete Method to delete files
that are no longer used.
Sequence example 2: Read out laser marker job data (No. 0000; the temporary file name is markerjob.ma2).
OPC UA client Laser marker
1-1 Call the SaveJobFile Method of the FileOperation node.
(JobNo: 0, FileName: markerjob.ma2)
Read
5-1 Call the Read Method of the markerjob.ma2 node.*1
(FileHandle: value acquired in step 4-2, Length: file size acquired in step 3)
*1 If an error occurs during OPC UA
communication because the file size
is too large, separate the file into
5-2 Acquire the execution result (Data). multiple transfer operations (call
Read multiple times).
Close
6-1 Call the Close Method of the markerjob.ma2 node.
(FileHandle: value acquired in step 1-2)
Sequence example 3: Change the job number (No. 1000 → No. 1001) and the strings (block
1 = “ABCDE,” block 2 = “12345”).
OPC UA client Laser marker
1-1 Call the SetCurrentJobNo Method of the JobOperation node.
(JobNo: 1001)
3-1 Call the StartJobEdit Method of the JobOperation node.*2 *2 From StartJobEdit to EndJobEdit, deployment processing
(JobNo: 1001) is not carried out even if the string is changed.
memory
5-1 Call the SetSettingString Method of the JobOperation node.
(JobNo: 1001, BlockNo: 2, SettingString: 12345)
Load and
5-2 Acquire the execution result. deploy.
Deployment
processing
6-1 Call the EndJobEdit Method of the JobOperation node.
Sequence example 4: Apply triggers from the PLC to acquire the result after marking completion.
OPC UA client Laser marker PLC
5 Read the Variable for acquiring the result.*2 *2 he workflow execution result is applied to the Variable
T
under the OperationResult node.
For details, refer to the Variable explanation.
6-1 Call the Method for acquiring the result.*3 *3 ou can use GetXYTrackingResult, GetZTrackingResult,
Y
and GetCameraImage Methods to acquire the tracking
result and image.
6-2 Result acquisition For details, refer to the Method explanation.
Communication history
The history of OPC UA communication can be recorded in the communication history, which can be checked using Marking Builder Plus.
Method (normal) Command: <Method name>, <argument 1>, <argument 2>, ...
Response (success): <Method name>, OK, <return value 1>, <return value 2>, ...
Response (failure): <Method name>, Failed, <error code>
Method (FileType node) Command: <File name>, <Method name>, <argument 1>, <argument 2>, ...
Response (success): <File name>, <Method name>, OK, <return value 1>, <return value 2>, ...
Response (failure): <File name>, <Method name>, Failed, <error code>
4
If the controller is equipped with two LAN ports, both ports can receive events, so the IP address will be 0.0.0.0 in the event
communication history.
OPC UA
(1) KEYENCE warrants the Products to be free of defects in materials and workmanship for a period of one (1) year
from the date of shipment. If any models or samples were shown to Buyer, such models or samples were used
merely to illustrate the general type and quality of the Products and not to represent that the Products would
necessarily conform to said models or samples. Any Products found to be defective must be shipped to KEYENCE
with all shipping costs paid by Buyer or offered to KEYENCE for inspection and examination. Upon examination by
KEYENCE, KEYENCE, at its sole option, will refund the purchase price of, or repair or replace at no charge any
Products found to be defective. This warranty does not apply to any defects resulting from any action of Buyer,
including but not limited to improper installation, improper interfacing, improper repair, unauthorized modification,
misapplication and mishandling, such as exposure to excessive current, heat, coldness, moisture, vibration or
outdoors air. Components which wear are not warranted.
(2) KEYENCE is pleased to offer suggestions on the use of its various Products. They are only suggestions, and it
is Buyer’s responsibility to ascertain the fitness of the Products for Buyer’s intended use. KEYENCE will not be
responsible for any damages that may result from the use of the Products.
(3) The Products and any samples (“Products/Samples”) supplied to Buyer are not to be used internally in humans,
for human transportation, as safety devices or fail-safe systems, unless their written specifications state otherwise.
Should any Products/Samples be used in such a manner or misused in any way, KEYENCE assumes no
responsibility, and additionally Buyer will indemnify KEYENCE and hold KEYENCE harmless from any liability or
damage whatsoever arising out of any misuse of the Products/Samples.
(4) OTHER THAN AS STATED HEREIN, THE PRODUCTS/SAMPLES ARE PROVIDED WITH NO OTHER
WARRANTIES WHATSOEVER. ALL EXPRESS, IMPLIED, AND STATUTORY WARRANTIES, INCLUDING,
WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, AND NON-INFRINGEMENT OF PROPRIETARY RIGHTS, ARE EXPRESSLY DISCLAIMED. IN NO
EVENT SHALL KEYENCE AND ITS AFFILIATED ENTITIES BE LIABLE TO ANY PERSON OR ENTITY FOR
ANY DIRECT, INDIRECT, INCIDENTAL, PUNITIVE, SPECIAL OR CONSEQUENTIAL DAMAGES (INCLUDING,
WITHOUT LIMITATION, ANY DAMAGES RESULTING FROM LOSS OF USE, BUSINESS INTERRUPTION,
LOSS OF INFORMATION, LOSS OR INACCURACY OF DATA, LOSS OF PROFITS, LOSS OF SAVINGS, THE
COST OF PROCUREMENT OF SUBSTITUTED GOODS, SERVICES OR TECHNOLOGIES, OR FOR ANY
MATTER ARISING OUT OF OR IN CONNECTION WITH THE USE OR INABILITY TO USE THE PRODUCTS,
EVEN IF KEYENCE OR ONE OF ITS AFFILIATED ENTITIES WAS ADVISED OF A POSSIBLE THIRD PARTY’S
CLAIM FOR DAMAGES OR ANY OTHER CLAIM AGAINST BUYER. In some jurisdictions, some of the foregoing
warranty disclaimers or damage limitations may not apply.
E 1101-3
Specifications are subject to change without notice.
KEYENCE CORPORATION
1-3-14, Higashi-Nakajima, Higashi-Yodogawa-ku, Osaka, 533-8555, Japan PHONE: +81-6-6379-2211 www.keyence.com/glb
AUSTRIA FRANCE ITALY POLAND TAIWAN
Phone: +43 (0)2236 378266 0 Phone: +33 1 56 37 78 00 Phone: +39-02-6688220 Phone: +48 71 368 61 60 Phone: +886-2-2721-1080
BELGIUM GERMANY KOREA ROMANIA THAILAND
Phone: +32 (0)15 281 222 Phone: +49-6102-3656-0 Phone: +82-31-789-4300 Phone: +40 (0)269 232 808 Phone: +66-2-078-1090
BRAZIL HONG KONG MALAYSIA SINGAPORE UK & IRELAND
Phone: +55-11-3045-4011 Phone: +852-3104-1010 Phone: +60-3-7883-2211 Phone: +65-6392-1011 Phone: +44 (0)1908-696-900
CANADA HUNGARY MEXICO SLOVAKIA USA
Phone: +1-905-366-7655 Phone: +36 1 802 7360 Phone: +52-55-8850-0100 Phone: +421 (0)2 5939 6461 Phone: +1-201-930-0100
CHINA INDIA NETHERLANDS SLOVENIA VIETNAM
Phone: +86-21-3357-1001 Phone: +91-44-4963-0900 Phone: +31 (0)40 206 6100 Phone: +386 (0)1 4701 666 Phone: +84-24-3772-5555
CZECH REPUBLIC INDONESIA PHILIPPINES SWITZERLAND
Phone: +420 220 184 700 Phone: +62-21-2966-0120 Phone: +63-(0)2-8981-5000 Phone: +41 (0)43 455 77 30
A4WW1-MAN-2033
Copyright (c) 2023 KEYENCE CORPORATION. All rights reserved. 252166GB 2073-1 H98GB Printed in Japan