NJ - NX-series CPU Unit OPC UA User's Manual
NJ - NX-series CPU Unit OPC UA User's Manual
NJ/NX-series
CPU Unit
OPC UA
User’s Manual
NJ501-1£00
NX102-££££
NX701-1£££
W588-E1-06
NOTE
1. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or
transmitted, in any form, or by any means, mechanical, electronic, photocopying, recording, or
otherwise, without the prior written permission of OMRON.
2. No patent liability is assumed with respect to the use of the information contained herein.
Moreover, because OMRON is constantly striving to improve its high-quality products, the infor-
mation contained in this manual is subject to change without notice.
3. Every precaution has been taken in the preparation of this manual. Nevertheless, OMRON as-
sumes no responsibility for errors or omissions.
Neither is any liability assumed for damages resulting from the use of the information contained in
this publication.
Trademarks
• Sysmac and SYSMAC are trademarks or registered trademarks of OMRON Corporation in Japan
and other countries for OMRON factory automation products.
• Microsoft, Windows, Excel, Visual Basic, and Microsoft Edge are either registered trademarks or
trademarks of Microsoft Corporation in the United States and other countries.
• EtherCAT® is registered trademark and patented technology, licensed by Beckhoff Automation
GmbH, Germany.
• ODVA, CIP, CompoNet, DeviceNet, and EtherNet/IP are trademarks of ODVA.
Other company names and product names in this document are the trademarks or registered trade-
marks of their respective companies.
Copyrights
• Microsoft product screen shots used with permission from Microsoft.
• This product incorporates certain third party software. The license and copyright information associ-
ated with this software is available at http://www.fa.omron.co.jp/nj_info_e/.
Introduction
Introduction
Thank you for purchasing an NJ/NX-series CPU Unit.
This manual contains information that is necessary to use the OPC UA with the NJ/NX-series CPU
Unit. Please read this manual and make sure you understand the functionality and performance of the
NJ/NX-series CPU Unit before you attempt to use it in a control system.
Keep this manual in a safe place where it will be available for reference during operation.
Intended Audience
This manual is intended for the following personnel, who must also have knowledge of electrical sys-
tems (an electrical engineer or the equivalent).
• Personnel in charge of introducing FA systems.
• Personnel in charge of designing FA systems.
• Personnel in charge of installing and maintaining FA systems.
• Personnel in charge of managing FA systems and facilities.
For programming, this manual is intended for personnel who understand the programming language
specifications in international standard IEC 61131-3 or Japanese standard JIS B 3503.
Applicable Products
This manual covers the following products.
• NJ-series CPU Units NJ501-1£00 (Unit version 1.17 or later)
• NX-series CPU Units NX102-££££ (Unit version 1.30 or later)
• NX-series CPU Units NX701-1£££ (Unit version 1.24 or later)
• Sysmac Studio SYSMAC-SE2£££
(NJ501-1£00: version 1.21 or higher, NX102-££00: version 1.23 or higher, NX102-££20: version
1.24 or higher, NX701-1£££: version 1.44 or higher)
Part of the specifications and restrictions for the CPU Units are given in other manuals. Refer to Rele-
vant Manuals on page 2 and Related Manuals on page 20.
Relevant Manuals
The following table provides the relevant manuals for the NJ/NX-series CPU Units. Read all of the
manuals that are relevant to your system configuration and application before you use the NJ/NX-ser-
ies CPU Unit.
The built-in EtherNet/IP port in the NJ/NX-series CPU Unit is used for this product. For details on how
to use the built-in EtherNet/IP port, refer to the NJ/NX-series CPU Unit Built-in EtherNet/IP Port User’s
Manual (Cat. No. W506).
Most operations are performed from the Sysmac Studio Automation Software. Refer to the Sysmac
Studio Version 1 Operation Manual (Cat. No. W504) for information on the Sysmac Studio.
Manual
Basic information
Hardware User’s Manual
NX-series CPU Unit
Troubleshooting Manual
NJ/NX-series
Purpose of use
NJ/NX-series
Refer to the NJ/NX-series Troubleshooting Manual (Cat. No. W503) for the error management concepts and an overview of the error
¡
Troubleshooting Manual
NJ-series CPU Unit
OPC UA User’s Manual
NJ/NX-series CPU Unit
r
¡
Hardware User’s Manual
NX-series NX102 CPU Unit
¡
Hardware User’s Manual
NX-series CPU Unit
¡
Hardware User’s Manual
Using EtherNet/IP
Using EtherCAT
Maintenance
tions*1
*1.
Manual Structure
Manual Structure
Page Structure
The following page structure is used in this manual.
A step in a procedure 1 Join the Units so that the connectors fit exactly.
4-3 Mo u n t i n g U n i t s
4 Page tab
2 Gives the number
Lock
Release
Slider
Manual name NJ-series CPU Unit Hardware User’s Manual (W500) 4-9
This illustration is provided only as a sample. It may not literally appear in this manual.
Special Information
Special information in this manual is classified as follows:
Additional Information
Additional information to read as required.
This information is provided to increase understanding or make operation easier.
Version Information
Information on differences in specifications and functionality for Controller with different unit versions
and for different versions of the Sysmac Studio is given.
Precaution on Terminology
• In this manual, built-in EtherNet/IP port refers to the following port.
Built-in EtherNet/IP port of the NJ-series CPU Units NJ501-1£00
Built-in EtherNet/IP port (PORT 1) of the NX-series CPU Units NX102-££££
Built-in EtherNet/IP port (PORT 1) of the NX-series CPU Units NX701-1£££
• In this manual, download refers to transferring data from the Sysmac Studio to the physical Control-
ler and upload refers to transferring data from the physical Controller to the Sysmac Studio.
For the Sysmac Studio, synchronization is used to both upload and download data. Here,
synchronize means to automatically compare the data for the Sysmac Studio on the computer with
the data in the physical Controller and transfer the data in the direction that is specified by the user.
1 A
Overview of OPC UA 2 I
1 Server Function A Appendices
3
Structure of the OPC
2 UA Server I Index
4
7
5 Security Function of OPC UA Server
8 Other Functions
9 Troubleshooting
CONTENTS
Introduction .............................................................................................................. 1
Intended Audience...........................................................................................................................................1
Applicable Products .........................................................................................................................................1
Relevant Manuals..................................................................................................... 2
Manual Structure...................................................................................................... 4
Page Structure.................................................................................................................................................4
Special Information ..........................................................................................................................................4
Precaution on Terminology ..............................................................................................................................5
Safety Precaution................................................................................................... 15
Versions .................................................................................................................. 19
Unit Versions of CPU Units and the Sysmac Studio Versions .......................................................................19
Related Manuals..................................................................................................... 20
Terminology............................................................................................................ 22
Revision History..................................................................................................... 24
Section 9 Troubleshooting
9-1 Overview of Troubleshooting ...............................................................................................9-2
Appendices
A-1 Task Design Procedure ........................................................................................................ A-2
A-1-1 Startup Time of the OPC UA Server (Reference Values)........................................................... A-2
A-1-2 Guidelines for System Service Execution Time Ratio ................................................................ A-5
A-1-3 Checking the System Service Execution Time Ratio ................................................................. A-6
A-2 OPC UA Instruction .............................................................................................................. A-8
A-2-1 OPCUA_Shutdown (Shutdown OPC UA Function) ................................................................... A-8
Index
Warranties
Exclusive Warranty
Omron’s exclusive warranty is that the Products will be free from defects in materials and work-
manship for a period of twelve months from the date of sale by Omron (or such other period ex-
pressed in writing by Omron). Omron disclaims all other warranties, express or implied.
Limitations
OMRON MAKES NO WARRANTY OR REPRESENTATION, EXPRESS OR IMPLIED, ABOUT
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OF
THE PRODUCTS. BUYER ACKNOWLEDGES THAT IT ALONE HAS DETERMINED THAT THE
PRODUCTS WILL SUITABLY MEET THE REQUIREMENTS OF THEIR INTENDED USE.
Omron further disclaims all warranties and responsibility of any type for claims or expenses based
on infringement by the Products or otherwise of any intellectual property right.
Buyer Remedy
Omron’s sole obligation hereunder shall be, at Omron’s election, to (i) replace (in the form originally
shipped with Buyer responsible for labor charges for removal or replacement thereof) the non-com-
plying Product, (ii) repair the non-complying Product, or (iii) repay or credit Buyer an amount equal
to the purchase price of the non-complying Product; provided that in no event shall Omron be re-
sponsible for warranty, repair, indemnity or any other claims or expenses regarding the Products
unless Omron’s analysis confirms that the Products were properly handled, stored, installed and
maintained and not subject to contamination, abuse, misuse or inappropriate modification. Return
of any Products by Buyer must be approved in writing by Omron before shipment. Omron Compa-
nies shall not be liable for the suitability or unsuitability or the results from the use of Products in
combination with any electrical or electronic components, circuits, system assemblies or any other
materials or substances or environments. Any advice, recommendations or information given orally
or in writing, are not to be construed as an amendment or addition to the above warranty.
WAY CONNECTED WITH THE PRODUCTS, WHETHER SUCH CLAIM IS BASED IN CONTRACT,
WARRANTY, NEGLIGENCE OR STRICT LIABILITY.
Further, in no event shall liability of Omron Companies exceed the individual price of the Product on
which liability is asserted.
Application Considerations
Suitability of Use
Omron Companies shall not be responsible for conformity with any standards, codes or regulations
which apply to the combination of the Product in the Buyer’s application or use of the Product. At Buy-
er’s request, Omron will provide applicable third party certification documents identifying ratings and
limitations of use which apply to the Product. This information by itself is not sufficient for a complete
determination of the suitability of the Product in combination with the end product, machine, system, or
other application or use. Buyer shall be solely responsible for determining appropriateness of the par-
ticular Product with respect to Buyer’s application, product or system. Buyer shall take application re-
sponsibility in all cases.
NEVER USE THE PRODUCT FOR AN APPLICATION INVOLVING SERIOUS RISK TO LIFE OR
PROPERTY OR IN LARGE QUANTITIES WITHOUT ENSURING THAT THE SYSTEM AS A WHOLE
HAS BEEN DESIGNED TO ADDRESS THE RISKS, AND THAT THE OMRON PRODUCT(S) IS
PROPERLY RATED AND INSTALLED FOR THE INTENDED USE WITHIN THE OVERALL EQUIP-
MENT OR SYSTEM.
Programmable Products
Omron Companies shall not be responsible for the user’s programming of a programmable Product, or
any consequence thereof.
Disclaimers
Performance Data
Data presented in Omron Company websites, catalogs and other materials is provided as a guide for
the user in determining suitability and does not constitute a warranty. It may represent the result of
Omron’s test conditions, and the user must correlate it to actual application requirements. Actual per-
formance is subject to the Omron’s Warranty and Limitations of Liability.
Change in Specifications
Product specifications and accessories may be changed at any time based on improvements and oth-
er reasons. It is our practice to change part numbers when published ratings or features are changed,
or when significant construction changes are made. However, some specifications of the Product may
be changed without any notice. When in doubt, special part numbers may be assigned to fix or estab-
lish key specifications for your application. Please consult with your Omron’s representative at any
time to confirm actual specifications of purchased Product.
Safety Precaution
Refer to the following manuals for safety precautions.
• NX-series CPU Unit Hardware User’s Manual (Cat. No. W535)
• NJ-series CPU Unit Hardware User’s Manual (Cat. No. W500)
• NX-series NX102 CPU Unit Hardware User's Manual (Cat. No. W593)
• Sysmac Studio Version 1 Operation Manual (Cat. No. W504)
Refer to the following manuals for other precautions for safe use that are not described above.
• NX-series CPU Unit Hardware User’s Manual (Cat. No. W535)
• NJ-series CPU Unit Hardware User’s Manual (Cat. No. W500)
• NX-series NX102 CPU Unit Hardware User's Manual (Cat. No. W593)
• Sysmac Studio Version 1 Operation Manual (Cat. No. W504)
Refer to the following manuals for other precautions for correct use that are not described above.
• NX-series CPU Unit Hardware User’s Manual (Cat. No. W535)
• NJ-series CPU Unit Hardware User’s Manual (Cat. No. W500)
• NX-series NX102 CPU Unit Hardware User's Manual (Cat. No. W593)
• Sysmac Studio Version 1 Operation Manual (Cat. No. W504)
OpenSSL
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/).
Copyright (C) 1995-1998 Eric Young ([email protected]) All rights reserved.
This product includes cryptographic software written by Eric Young
([email protected])
This Windows version of this product includes software written by Tim Hudson ([email protected])
LibXML2
This product includes code that was developed for the XML toolkit from the GNOME project
(http://xmlsoft.org/).
Copyright (C) 1998-2003 Daniel Veillard. All Rights Reserved.
OPC UA
This product includes code that was developed by Unified Automation GmbH for the OPC UA SDK
(http://www.unifiedautomation.com/).
Copyright (C) 2008-2017 Unified Automation GmbH. All Rights Reserved.
The OPC UA SDK is based in part on <OPC UA Ansi C Stack> of the OPC Foundation.
Initial version of <OPC UA Ansi C Stack> was founded and copyrighted by OPC
Foundation,Inc. Copyright (C) 2008,2014 OPC Foundation, Inc., All Rights Reserved.
Versions
Hardware revisions and unit versions are used to manage the hardware and software in the NJ/NXser-
ies Units and EtherCAT slaves. The hardware revision or unit version is updated each time there is a
change in hardware or software specifications. Even when two Units or EtherCAT slaves have the
same model number, they will have functional or performance differences if they have different hard-
ware revisions or unit versions.
Related Manuals
The followings are the manuals related to this manual. Use these manuals for reference.
Terminology
Term Description
OPC UA A protocol for communications between industrial devices that is independent of the manu-
facturer and platform, and is safe with a high reliability.
It has an architecture in which the conventional OPC (Object Linking and Embedding for
Process Control) has been generalized and widened in scope.
OPC UA Server A communications service that provides the function of connecting to the OPC UA client in
the NJ/NX-series.
It is executed in a system service within the processing of the CPU Unit.
OPC UA server Main entity of communications, such as an application, computer, or controller that supports
the OPC UA, executes a service in response to a service request from the OPC UA client,
and also sends a response.
OPC UA client An application or computer that supports the OPC UA and issues a service request to the
OPC UA server. Specifically, the main entity of communications, such as the SCADA and
MES.
End point The physical address that can be used on the OPC UA communications network used by the
OPC UA client to access the OPC UA server. Specifically, the following address:
opc.tcp://[IPAddress]:[Port]
In the case of the OPC UA Server, the default address is:
opc.tcp://192.168.250.1:4840/
Message The data unit that expresses the requests or responses of the OPC UA server transmitted
between the OPC UA client and the server.
Application authentication The authentication of each other’s identity by the server and the OPC UA client through the
exchange of the mutual X.509 digital certificates during the establishment of a connection
from the OPC UA client to the server.
User authentication The authentication of the identity of the user operating the OPC UA client by the server dur-
ing the establishment of a connection from the OPC UA client to the server.
Server certificate An X.509 digital certificate that certifies the OPC UA server.
It is generated and managed by the OPC UA server in combination with the private key of
the certificate.
In the NJ/NX-series, it indicates the self-certificate that certifies an individual CPU Unit as an
OPC UA server.
It is different for each serial number of the CPU Unit.
Client certificate An X.509 digital certificate that certifies the OPC UA client.
It is generated and managed by the OPC UA client in combination with the private key of the
certificate.
In the NJ/NX-series, it is necessary to register the client certificate in the CPU Unit by the
Sysmac Studio.
Trusted certificate list A list of certificates of the communications partner that must be trusted in application authen-
tication.
There are the following two types of trusted certificate lists at the server side and the OPC
UA client side:
• Trusted certificate list at the server side: A list of client certificates that have been set to
trust the OPC UA client.
• Trusted certificate list at the OPC UA client side: A list of server certificates that have been
set to trust the server.
Rejected certificate list A list of client certificates that have been rejected at the server side in application authentica-
tion.
Client authentication Indicates the direct authentication of client certificates.
• Authentication of a self-signed client certificate is performed depending on whether it is
present in the trusted certificate list.
• Authentication of a CA-signed client certificate is performed by checking the trust and rev-
ocation of the signed CA certificate.
Term Description
Issuer authentication Indicates the authentication by the certificate authority itself that has signed the client certifi-
cate.
Authentication of a CA-signed client certificate is performed by checking the trust and revo-
cation of the certificate of the certificate authority itself.
Certificate Authority Organization that issues certificates.
OPC UA security profile A common name for the client certificate, CA certificate, certificate revocation list, and securi-
ty settings.
Security settings A common name for user authentication settings, anonymous login, and security policy.
Security policy A common name for the OPC UA security mode and OPC UA security policy.
OPC UA security mode Setting the encryption and signature of messages in the security-related settings of messag-
es in the OPC UA.
OPC UA security policy Specification of algorithms such as signatures and encryption in the security-related settings
of messages in the OPC UA.
Address space A collection of information that visualizes the OPC UA server with respect to the OPC UA
client.
By referencing this information, the OPC UA client can use the objects of the OPC UA server
and their related information.
Node The basic component of the address space.
Event A phenomenon that occurs in an unplanned and irregular manner in the NJ/NX-series Con-
trollers.
Event log A log for recognizing and recording the events that have occurred in the entire Controller. It is
recorded in the CPU Unit. In the OPC UA Server, it indicates the errors and various states of
the OPC UA Server.
Execution log A log for recording the execution state of the OPC UA Server. It is saved in an SD Memory
Card (sold separately).
As compared to the event log, the execution log has a higher capacity and includes the ac-
cess results from the OPC UA client to the variables.
In view of future functional expansion, this Execution Log is considered as one of the types
in the leading concept of the Operation log in the Sysmac Studio.
OPC UA instruction Indicates instructions related to the OPC UA Server.
Revision History
A manual revision code appears as a suffix to the catalog number on the front and back covers of the
manual.
Revision
Date Revised content
code
01 January 2018 Original production
02 April 2018 Added information on the NX102-££££.
03 July 2019 Corrected mistakes.
04 January 2021 Added information on the NX701-1£££.
05 July 2021 Added information of the SD Memory Card.
06 April 2022 Added information of the function to expand nodes for structure mem-
bers.
1-1-1 Overview
The OPC UA Server function enables the NJ/NX-series CPU Unit to operate as an OPC UA server.
With this function, OPC UA clients can connect via Ethernet to the built-in EtherNet/IP port of the
NJ/NX-series CPU Unit using the OPC UA communications, and then read and write variables in the
CPU Unit.
The OPC UA communications can simultaneously achieve both addressing security risks and connect-
ing with general-purpose methods. Therefore, the OPC UA Server function enables secure data ex-
changes between the CPU Unit and host systems such as SCADA or MES compatible OPC UA so
that the host systems can collect manufacturing progress information or issue manufacturing instruc-
tions.
OPC UA Client
- SCADA software
- MES etc.
Sysmac Studio
OPC UA Server function Securely connects and reads and writes variables.
Refer to A-5 Version Information on page A-20 for the Unit version of the CPU Unit and the version of
the Sysmac Studio that can be supported.
1-1-3 Features
The OPC UA Server function has the following features.
1-1-3 Features
The NJ/NX-series OPC UA Server function has the following features.
• It allows the Controller to connect directly to the OPC UA client via Ethernet without relaying the
computer.
• Since the NJ/NX-series CPU Unit has EtherCAT communications as the lower level network, it
makes it easy to gather sensor and actuator level information on EtherCAT into OPC UA communi-
cations as a higher network.
• You can check the operation results of the OPC UA Server function from the event log in the Con-
troller and the Execution Log.
1-2 Specifications
This section describes the specifications of the OPC UA Server function.
1-2 Specifications
Conditions Maximum number of varia- 10,000
across net- bles that can be published
work-publish- Maximum number of value 10,000
ed variables*1 attributes that can be pub-
lished
Number of structure defi- 100
nitions that can be pub-
lished
1
Conditions that can not be published for • Multidimensional array specified structure
For the NX701-1£££ CPU Unit and NX102-££££ CPU Unit, there are two built-in
EtherNet/IP ports, PORT 1 and PORT 2. Note that only PORT 1 is the port that supports the
OPC UA Server.
1
STEP4. Trouble 4-1. Client error check
shooting 4-2. Status Monitor • Checking the operating 4-2-1 Checking
Yes
(Used for the first time, etc.)
2-3. Reading Read/write variables in the CPU Unit from the OPC UA 6-2-2 Reading/Writ-
and writing client via the OPC UA Server. ing the Variables of
variables from Confirm variables in the CPU Unit with a monitor such the CPU Unit on
the OPC UA as a Watch Tab Page on the Sysmac Studio. page 6-4
client Sysmac Studio
Version 1 Operation
Manual (Cat. No.
W504)
2-1 Internal Structure of the Overall OPC UA Communications System ........ 2-2
2-1-1 Overview ......................................................................................................... 2-2
2-1-2 Details ............................................................................................................. 2-2
2-2 Overview of the Security Function of the OPC UA Server ......................... 2-5
2-1-1 Overview
An overview of the overall OPC UA communications system is provided below.
The description is given separately for the NJ/NX-series CPU Unit side as a server and the OPC UA
client side.
Sysmac Studio
OPC UA client side
Setting (Offline and Online)
OPC UA Server
OPC UA communications
Reading Settings for communications (Connection, reading/writing of
and with clients variables, etc.) Connect
Variables writing via built-in EtherNet/IP port
2-1-2 Details
The details of the structure of the overall OPC UA communications system is described by using the
following figure.
Note that the (Figure a) to (Figure e) in the table shown below correspond to the (a) to (e) in the fol-
lowing figure.
Communications System
Client Trusted Certificate List
OPC UA server side (CPU Unit)
certificate Server
certificate
OPC UA Server
Refer to server Design variables
OPC UA Server Settings (a) address space specifications
Use of OPC UA server etc.
Additional Service
Application authentication (c) registration request
Server
certificate 2
Client Authentication
OPC UA communications
Reading Trusted Certificate List
2-1-2 Details
and Client (Connection, reading/writing of variables, etc.)
writing certificate Connect via built-in EtherNet/IP port
*1
Global variable (b)
Note The above figure shows the case of a self-signed client certificate.
You can also support a CA-signed client certificate. To use the CA-signed client certificate, refer to
A-3 When CA-signed Client Certificates Supported on page A-13.
Basic Mechanism
The basic mechanism from the start for using the OPC UA Server to reading and writing variables is
as follows. The basic mechanism is shown in accordance with the usage procedure.
Status Confirmation
The following table shows how to confirm the status of the OPC UA Server.
Means of
Status confirmation mechanism Reference
confirmation
OPC UA The server operating status and the number of currently con- 4-2 Checking the Status of the
server status nected OPC UA clients can be checked with the OPC UA serv- OPC UA Server on page
er status in the Sysmac Studio. 4-5
Event Log Failure of OPC UA Server and status are stored as event logs Section 9 Troubleshooting on
(Figure d) of the NJ/NX-series Controllers. page 9-1
You can confirm with troubleshooting functions of the Sysmac
Studio.
Execution Logs (Figure e) for recording the execution status of the OPC Section 7 Execution Log
Log UA Server, variable published-status, authentication process- Functions on page 7-1
ing, and operation of certificates are saved as a log file in the
SD Memory Card (sold separately) in the CPU Unit.
You can confirm in Operation Logs Display on the Sysmac
Studio.
OPC UA Server
This section describes the overview of the security function of the OPC UA Server.
The OPC UA Server of the NJ/NX-series CPU Unit supports the server function of the OPC UA. There
are the following two security functions as a server in the OPC UA Server.
Function Description
Connection authentication function of When a connection request is accepted from an OPC UA client and its
2
the OPC UA Server users, the OPC UA Server permits connections from only authenticat-
ed OPC UA clients and users.
Message security function Upon receiving requests from OPC UA clients and sending responses
to OPC UA clients, the OPC UA Server signs and encrypts the mes-
sages.
Set the following contents, in advance, to use the security functions as a server.
For details on the security functions, refer to Section 5 Security Function of OPC UA Server on page
5-1.
For details on the settings, refer to the NJ/NX-series CPU Unit Built-in EtherNet/IP Port User’s Manual
(Cat. No. W506).
The server certificate is automatically or manually generated with the IP address that is set in the Con-
troller Setup. For information on automatic generation of server certificates, refer to 3-2-4 Automatic
Generation of the Server Certificate on page 3-9. For information on the manual regeneration of
server certificates, refer to the 3-2-5 Setting and Displaying the Certificate on page 3-9 and Regen-
erating the Server Certificate on page 3-12.
If you change the IP address by downloading the settings or executing the instruction after the
server certificate is generated automatically or manually, the IP address of the built-in
EtherNet/IP port will not match that of the Server certificate. As a result, the OPC UA client can
not connect to the OPC UA Server. Then, a Server Certificate Mismatch event (event code:
15020000 hex) occurs. In that case, manually regenerate the server certificate or set the IP ad-
dress back to the original address.
The OPC UA Settings are located in Configurations and Setup in Multiview Explorer in the Sysmac
Studio as follows.
There are three types of OPC UA Settings; items that are recorded in the project file in the Sysmac
Studio, items that are not recorded in the project file in the Sysmac Studio and required to be set for
each CPU Unit, and items that are only displayed or operated without any setting. The differences of
each are described in the table below.
Items of OPC UA
Contents Procedure Reference
Settings
OPC UA Server Set- Set the following items in the OPC Double-click 3-2-2 OPC UA Server Set-
tings UA Server Settings Tab Page. OPC UA tings on page 3-5
• Use of the OPC UA Server: Server
Set whether to use. Settings or
right-click it and
• End Point Settings:
select Edit from
Display the End point and set
menu
the port number.
• Execution Log Settings:
Set whether to record, set the
number of log files, and set the
number of records.
Items of OPC UA
Contents Procedure Reference
Settings
Server Certificate Display and operate the server certif- Right-click OPC 3-2-3 When Necessary to
icate in the Server Certificate Tab UA Server Cycle the Power Supply to
Page. Settings and the Controller or Reset the
Client Authentication • For a self-signed client certificate: select from the Controller on page 3-8
Display and operate the Trusted menu.
Certificate List and the Client Re-
jected Certificate List in the Client
Authentication Tab Page.
• For a CA-signed client certificate: Client Authentication on
Display and operate the Trusted page A-14
Certificate List of the CA certificate
that is signed and the Certificate
Revocation List in the Client Au-
thentication Tab Page.
Issuer authentication For a CA-signed client certificate on- Issuer Authentication on
ly: page A-16
Display and operate the Trust List of
the CA’s own Certificate and the Cer-
tificate Revocation List in the Issuer
Authentication Tab Page.
Security Settings The following settings are made in 3-2-6 Security Settings on
the Security Setting Tab Page. page 3-21
• User name and Password to au-
thenticate
• Prohibition or permission for anon-
ymous login
• Security mode policy
Items of OPC UA
Contents Procedure Reference
Settings
Server Status Display the operating status of the Right-click OPC 4-2-1 Checking Based on
1 Double-click OPC UA Server Settings under Configurations and Setup - OPC UA Settings
in Multiview Explore in the Sysmac Studio. Alternatively, right-click OPC UA Server Settings
and select Edit from the menu.
After you download the project whose OPC UA Server in the OPC UA Settings was changed from Do
not use to Use to the CPU Unit, and then cycle the power supply to the Controller or reset the Control-
ler, the OPC UA Server will start automatically at that time.
For details on how to start the OPC UA, refer to 4-1 Starting or Stopping the OPC UA Server on page
4-2.
Changes
Setting Set value or Update
Parameter Description Default in RUN
group display value Timing
mode
End Point End point The End point notation opc.tcp:// opc.tcp:// --- ---
Settings of the OPC UA Server [IPAddress]: 192.168.250.1:
is displayed. [Port] 4840
• The [IPAddress] sec- Note Not al-
Setting
Parameter Description Set value Default
group
Execution Execution Log Sets whether to record Execution Do not record Do not record
Log Set- Logs. Record
tings Number of Sets the maximum number of files of 2 to 100 24
files the Execution Logs.
When the maximum number of files is
reached, the oldest file is deleted and
a new file is created*1.
Number of re- Sets the number of log records that 100 to 65,536 12,000
cords can be contained in each Execution
Log file*1.
Reset all to Returns all parameters to the default --- ---
default But- settings.
ton
*1. It can be set only when OPC UA server is set to Use and Execution Log is set to Record.
For details on the Execution Log, refer to Section 7 Execution Log Functions on page 7-1.
Node Setting
In the Node Setting, set whether or not to publish the member of the structure variable as one node.
Set the following items.
2 Then, cycle the power supply to the Controller or reset the Controller.
3
After the Execution of Clear All Memory While the OPC UA Server
The value of the IP address of the automatically generated server certificate is generated from the IP
address of the built-in EtherNet/IP port at the time.
If you change the IP address after the server certificate is generated automatically or manually, be
sure to regenerate the server certificate manually. For details on how to operate, refer to Regenerating
the Server Certificate on page 3-12 in Server Certificate on page 3-10 in 3-2-5 Setting and Display-
ing the Certificate on page 3-9. If the IP address of the server certificate does not match the IP ad-
dress of the built-in EtherNet/IP port, OPC UA clients can not connect to the OPC UA Server.
The certificate setting can be operated only when online, and only by the Administrator in the opera-
tion authority verification settings.
The certificate can be displayed only when online, and only by the person other than Observer in the
operation authority verification settings.
Server Certificate
You can display and operate the server certificate in the CPU Unit connected online.
1 In the Sysmac Studio, connect online to the CPU Unit, right-click OPC UA Server Settings
under Configurations and Setup - OPC UA Settings in Multiview Explorer and select Server
Certificate from the menu.
The current server certificate in the CPU Unit is acquired and displayed on the following Server
Certificate Tab Page.
(B) Details
Classifi-
Item*1 Description
cation
(A) Basic Issued to The common name of the subject is Set to NxOpcUaServer@[IPAd-
informa- displayed. dress] in the case of server cer-
tion Issued by The issuer’s common name is dis- tificate.
played. The [IPAddress] part is the IP
address of the server certificate.
The IP address after CN=NxOpcUaServer@ displayed in the first line of the above Detailed
Text Box must match that of the built-in EtherNet/IP port.
If it does not match, the OPC UA client can not connect to the OPC UA Server. Then, a Server
Certificate Mismatch event (event code: 15020000 hex) will occur. In that case, manually regen-
erate the server certificate.
1 Click the Update Button to reacquire the Server Certificate in the CPU Unit and update the
Server Certificate Tab Page display.
1 When you click the Export Button, the following Export server certificate Dialog Box is dis-
played.
2 Click the Save Button to save the Server certificate file in the specified path.
If you replace the CPU Unit or change the IP address of the CPU Unit and regenerate the Serv-
er certificate, export the Server certificate by the above operation and import it to the OPC UA
client.
The value of the IP address of the server certificate is generated from the IP address of the built-in
EtherNet/IP port at the time of regeneration.
If you change the IP address after the server certificate is generated automatically, be sure to re-
generate the server certificate manually. If the IP address of the server certificate does not match
the IP address of the built-in EtherNet/IP port, OPC UA clients can not connect to the OPC UA
Server.
OPC UA Server is
set to Use, and
Omi
Default value displayed default value
Item Effective character/range ssio
on the Sysmac Studio when the Con-
n
troller power is
turned on
Organiza- 0 to 9, a to z, A to Z, halfwidth Value stored in the sub- OMRON Corpora- Can-
tion name space [ ], hyphen [-], dot [.], Un- ject of the Certificate be- tion not
derscore [_], comma [,], slash [/], ing displayed be
parenthesis [(], closing parenthe- omitt
sis [)] ed
Organiza- Within 64 characters. --- Can
tional unit be
name omitt
ed
Municipality Kyoto Can-
not
be
omitt
ed
Prefecture Kyoto Can-
not
be
omitt
ed
Country Two half-width alphabetic char- JP Can-
acters not
be
omitt
ed
Validity pe- An integer from 1 to 20 20 20 Can-
riod (years) not
be
omitt
ed
3 When you click the OK Button, the following confirmation dialog box is displayed.
4 Click the Yes Button to regenerate the server certificate in the CPU Unit in the entered DN in-
formation and valid period. Click the No Button to close the confirmation dialog box and return
to the state before execution.
After the server certificate is regenerated, communications with OPC UA clients can not be
performed as it is. To communicate with the OPC UA clients, export the server certificate and
install it on the OPC UA client side. For information on how to export server certificates, refer to
Exporting Server Certificate on page 3-12.
Client Authentication
You can display and operate self-signed client certificates in the CPU Unit connected online.
Additional Information
For the CA-signed client certificate, refer to the A-3 When CA-signed Client Certificates Sup-
1 In the Sysmac Studio, connect online to the CPU Unit, right-click OPC UA Server Settings
under Configurations and Setup - OPC UA Settings in Multiview Explorer and select Client
Authentication.
Parameter Description
(A) Trusted Certifi- The Trusted Client Certificate List in the CPU Unit is displayed.
cate List • Common name, expiration of validity period, organization, domain name are
displayed.
• The default display order is ascending order of common names. You can sort
the list by the name of each item by clicking each column header. Ascending
and descending order are switched each time you click.
• Add Button ( ):
Adds the certificate selected in the Add Certificate Dialog Box to the Trusted
Certificate List in the CPU Unit. For details, refer to Adding a Client Certificate
(Transfer to the CPU Unit) on page 3-16 below.
• Delete Button ( ):
Deletes the selected certificate from the Trusted Certificate List in the CPU Unit.
For details, refer to Deleting a Client Certificate on page 3-18 below.
• Show Detail Button: Display details of the selected certificate.
(B) Certificate The Certificate Revocation List is used only for CA-signed client certificate.
Revocation List For details, refer to A-3 When CA-signed Client Certificates Supported on page
A-13.
(C) Rejected Cer- The rejected client certificate list in the CPU Unit is displayed.
tificate List
• Delete Button ( ):
Deletes the selected certificate from the Rejected Certificate List in the CPU
Unit.
• Show Detail Button: Display details of the selected certificate.
(D) Move to The Rejected Certificate List in the CPU Unit is moved to the Trusted certificate.
Trusted • Move to Trusted Certificate Button:
Certificate Button Move the certificate selected in the Rejected Certificate List to the Trusted Cer-
tificate.
For details, refer to Permitting a Rejected Client Certificate on page 3-19 be-
low.
(E) Update Button The display in the Client Authentication Tab Page is updated with the data in the
CPU Unit.
For details, refer to Updating the Client Authentication Tab Page on page 3-20
below.
1 Click the Add Button ( ). The following Add Certificate Dialog Box is displayed.
3 If you click the Yes Button, the selected client certificate is added to the Trusted Certificate List
in the CPU Unit.
When the addition is successful, the following confirmation dialog box is displayed.
• When the client certificate already exists in the Trusted Certificate List
If the client certificate to be added already exists in the Trusted Certificate List in the CPU
Unit, the following confirmation dialog box is displayed.
Even if you accidentally add the client certificate of a client for which you do not want to permit
connection in the Trusted Certificate List, the OPC UA Server of the NJ/NX-series Controller will
permit connections from that client.
As a result, confidential information on the server side may be leaked or unintended operation
may be performed. Therefore, when you add a certificate to the Trusted Certificate List from the
Sysmac Studio, make sure that all the certificates that you will register in the Trusted Certificate
List are trusted client certificates.
1 Select the client certificate you want to delete and click the Delete Button ( ). The following
confirmation dialog box is displayed.
3
1 Select the client certificate you want to move, and click the Move to Trusted Certificate But-
ton.
2 After a while, the client certificate in the CPU Unit is moved and the Client Authentication Tab
Page display is updated to the latest information.
If the move fails, the following confirmation dialog box is displayed.
Additional Information
2 After a while, the detailed contents of the client certificate in the CPU Unit are displayed.
If the certificate details display fails, the following confirmation dialog box is displayed.
1 Click the Update Button to reacquire the Client Certificate List in the CPU Unit and update the
Client Authentication Tab Page display.
Additional Information
When a new OPC UA client connects to the server while a client certificate is displayed and
operated, and the client does not exist in the Trusted Certificate List, the client's certificate will
be automatically added to the Rejected Certificate List. In such a case, it is necessary to update
the Client Authentication Tab Page.
Issuer Authentication
You can display and operate the certificate authority itself that signed the client certificate in the CPU
Unit connected online. For details, refer to A-3 When CA-signed Client Certificates Supported on page
A-13.
Chan
Update ges in
Parameter Description Set value Default
Timing RUN
mode
User Au- The list of configured user names is dis- User name*1 and password None When click- Not al-
thentication played. (up to 20 people) ing the lowed.
Settings • The default display order is the order Transfer to
• Add Button ( ):
Adds the user name. For details, refer to
Adding a User Name on page 3-24. 3
• Delete Button ( ):
Deletes the selected user name.
Range of charac-
Item Valid character Default
ters
User name 0 to 9, a to z, A to Z (case sensitive) 4 to 32 characters Blank
Note The following are reserved words and cannot be set
(not case sensitive).
Administrator
Designer
Maintainer
Operator
Observer
Anonymous
Password 0 to 9, a to z, A to Z (case sensitive) 8 to 32 characters Blank
Range of charac-
Item Valid character Default
ters
Confirm New Same as above password. Same as above Blank
Password password.
*2. For the CPU Units with unit versions shown below, the default setting is Permit.
NJ501-1£00: Unit version earlier than 1.43
NX102-££00: Unit version earlier than 1.43
NX102-££20: Unit version earlier than Ver.1.36
*3. For the CPU Units with unit versions shown below, the default setting for None is selected.
NJ501-1£00: Unit version earlier than 1.43
NX102-££00: Unit version earlier than 1.43
NX102-££20: Unit version earlier than Ver.1.36
When you take security into consideration, be sure to clear None under Security Policy.
Additional Information
If the OPC UA communications cannot be performed normally, check the consistency of anony-
mous login setting and security policy setting between the Controller and OPC UA client.
1 When you click the Add Button( ), the following Add a User Dialog Box is displayed.
2 In the User name field, enter the user name, and enter the password in the Password and
Confirm Password fields, and then click the OK Button.
1 Click the Change password Button, the following Change Password Dialog Box is displayed.
2 Enter the password in the fields of Current Password, New Password, and Confirm New
Password, and click the OK Button.
3
2 Click the Yes Button to transfer the User name and Password displayed in the User Authenti-
Additional Information
In view of future expansion of functions, in the Sysmac Studio, the display of the Execution
Logs is placed under the Operation Log Display as the lower level of the upper concept
Operation Log.
Operations
Backup Restore
When one of
When one of
One of the the following
the following
following methods is
methods is
cases: used:
Synchro- used:
• SD Memo- • Automatic Clear All
nization • SD Memo-
Setting data of OPC UA Set- ry Card transfer Memory oper-
(transfer) ry Card
tings Backup from SD ation from
from the Backup
functions Memory the Sysmac
Sysmac function
• Sysmac Card Studio
Studio • Sysmac
Studio • Program
Studio
Controller transfer
Controller
backup from SD
Backup
functions Memory
function
Card
OPC UA Server settings OK OK OK OK Clear
Server certificate NA NA NA NA Select whether
OPC UA se- Client certificate NA OK*1 AS*2 NA to clear or not.
curity profile CA certificate
Certificate Rev-
ocation List
Security set-
tings
(User authenti-
cation settings,
anonymous log-
in, and security
policy)
Execution Log NA NA NA NA Do not clear
*1. Client certificates, CA certificates, Certificate Revocation Lists, and Security Settings are not applicable
when exporting and importing backup files in the Sysmac Studio.
*2. Whether to restore or not can be selected below.
• When the SD Memory Card backup function is used: Depends on the restore command file (Restore-
Command.ini).
• When the Sysmac Studio Controller backup function is used: Depends on selecting the data to restore in
the Restore Dialog Box.
The variables that can be published to OPC UA communications are the global variables*1.
*1. System-defined variables can not be published to OPC UA communications.
1 In the Global Variable Editor of the Sysmac Studio, set the Network Publish attribute of the
If a variable is published to the network, it can be read and written from the OPC UA client.
The possibility of reading from or writing to the OPC UA client in accordance with the network
publish attribute is as follows.
The following table shows the maximum number of variables and value attributes with the Net-
work Publish attribute that can be published to clients as an OPC UA Server.
For details of the data types that can be published, refer to 6-2 Reading/Writing Variables from
the OPC UA Client on page 6-3.
Additional Information
Publish Only, Input, and Output in the Network Publish attribute are settings shared with Ether-
Net/IP communications. As for OPC UA communications, there is no difference between
Publish Only, Input, and Output.
1 In the Multiview Explorer of the Sysmac Studio, double-click OPC UA Server Settings under
Configurations and Setup - OPC UA Settings. Or, right-click OPC UA Server Settings and
select Edit from the menu.
2 Select Use Option for OPC UA Server under OPC UA Settings - OPC UA Server Settings.
The factory default setting is Do not use (Stop).
3 Place the Sysmac Studio online with the CPU Unit and download (synchronize) OPC UA
Settings.
When you download (synchronize) or restore the OPC UA Settings by changing OPC UA
Server to Use from Do not use, you must either cycle the power supply to the Controller or re-
set the Controller in order to start the OPC UA Server. The OPC UA Server will not start unless
you cycle the power supply to the Controller or reset the Controller.
1 Place the Sysmac Studio online with the CPU Unit, right-click OPC UA Server Settings under
Configurations and Setup - OPC UA Settings in the Multiview Explorer, and then select
Server Status.
Additional Information
• The OPC UA Server continues to operate even when a major fault level Controller error oc-
curs.
• When a Controller error occurs and you refer to the address space of the NJ/NX-series Con-
troller from the OPC UA client, you can check the following from ErrorStatus under
DeviceStatus.
a) NoError: Normal
b) MajorFault: Major fault
c) ContinuousError: Partial fault or minor fault
You can use the following methods to check the status of the OPC UA Server.
• OPC UA server status of the Sysmac Studio
• Event log
• Execution Log
You can check the following states unless the operating status of the OPC UA Server is
Initializing or Shutdown.
1 When you click the Server shutdown Button, the following confirmation dialog box is dis-
played.
The OPC UA Server has five operation states, such as Initializing, Preparing, Running, Halt error, and
Shutdown. The operating status transits as shown in the figure below. 4
Turn ON the
Controller power Note: In the following cases, you must cycle the power supply to
or reset the the Controller or reset the Controller.
Controller
·When OPC UA Server is changed
from Do not use to Use and the data is downloaded or restored
·When a Clear All Memory operation is executed while OPC UA
Do not use Server is set to Use
When OPC UA Server
is set to...
Use
· Shut down
· Clear All Memory
Halt error
Or
· OPC UA Server is set to Do not Use, and
data is downloaded
Shutdown
· Shutdown
·Clear All Memory
Or
·OPC UA Server is set to Do not Use,
and data is downloaded
• If the OPC UA server is set to Use after the Controller power is turned ON*1, the OPC UA Server
enters the Initializing state. When the initialization process is complete, the OPC UA Server enters
the Preparing state, then it shifts to the Running state after the completion of preparation.
• In the Running state, if the OPC UA Server is shutdown*2, or if OPC UA server is set to Do not Use
and data is downloaded, the OPC UA Server shifts to the Shutdown state.
*1. In the following cases, you must cycle the power supply to the Controller or reset the Controller.
• When OPC UA Server is changed from Do not use (setting in the CPU Unit) to Use and the data is down-
loaded or restored*
* It includes both the Restore operation executed from the SD memory card and the Restore operation exe-
cuted from the Sysmac Studio.
• When a Clear All Memory operation is executed while OPC UA Server is set to Use (setting in the CPU
Unit)
*2. When shutdown of the OPC UA Server is instructed from the Sysmac Studio, or when the OPCUA_Shutdown
(Shutdown OPC UA Function) instruction is executed.
The details of each status are given below.
Additional Information
Even if a network-published variable is added by online editing while the OPC UA Server is run-
nning, the OPC UA Server is not reconfigured, and the network-published variable is added to
the existing address space. In that case, OPC UA clients can access to the variable that you
have added.
Function Description
Application authentication Authentication of applications between the OPC UA server and OPC UA client
User authentication Authentication of the user that operates the client applications of the OPC UA
In application authentication, the certificates supported by the OPC UA server and the OPC UA client
are X.509-standard certificates.
The certificates supported by the OPC UA Server are of the following three types:
Certificate Description
Server certificate This is a certificate for certifying an OPC UA server. In the case of an OPC UA
server, it is a self-signed certificate.
Client certificate This is a certificate for certifying the OPC UA client.
Both self-signed client certificates and CA-signed client certificates can be
used.
CA certificate and Certificate In the case of a CA-signed client certificate, this certificate is used to authenti-
Revocation List cate the certificate chain.
In the OPC UA Server, the following functions are enabled for each certificate:
Certificate Function
Server certificate • Generation (automatic generation or manual regeneration*1) of the server
certificate (self-signed certificate)
• Export of the server certificate from the CPU Unit*1
• Advance expiration notice of the server certificate, and notification of expiry
Client certificate • Authentication of the client certificate during a connection*1
• Addition of the client certificate (transfer to the CPU Unit)*1
• Trust or reject setting of the client certificate*1
• Notification of expiry of client certificate
CA certificate and Certificate Used only in the case of a CA-signed client certificate.
Revocation List For details, refer to A-3 When CA-signed Client Certificates Supported on page
A-13.
*1. This operation can be performed only by the Administrator in the operation authority verification settings of
the Sysmac Studio.
For details on each operation method from the Sysmac Studio, refer to 3-2-5 Setting and Displaying
the Certificate on page 3-9.
• Manual regeneration
By setting the DN (Distinguished Name) information and the valid period of the server certificate,
the server certificate in the CPU Unit can also be manually regenerated.
This function is executed when it is necessary to recreate the server certificate, for example,
when the following events occur:
Server Certificate Mismatch (event code: 15020000 hex)
Server Certificate Expired (event code: 35D10000 hex)
Server Certificate Expiration Notice (event code: 35D20000 hex)
Note that regeneration of the server certificate can be executed only by the Administrator set as
the operation authority.
When you download to the CPU Unit a project for which OPC UA Server is set to Use in the
OPC UA Settings, and then cycle the power supply to the Controller, the server certificate is
automatically generated by the IP address of the built-in EtherNet/IP port at that time.
Thereafter, when you change the IP address of the built-in EtherNet/IP port, the IP address of
the built-in EtherNet/IP port and the IP address of the server certificate do not match. Therefore,
a Server Certificate Mismatch event (event code: 15020000 hex) occurs. In that case, manually
regenerate the server certificate, or set the IP address back to the original address.
Client Certificate
A self-signed client certificate is described below.
For details on using a CA-signed client certificate, refer to A-3 When CA-signed Client Certificates
Supported on page A-13.
In the OPC UA Server, the following functions are enabled for the client certificate.
The OPC UA Server supports Allow access to all in a fixed manner as the user access authority of the
OPC UA.
For details on the operation method from the Sysmac Studio, refer to Adding a User Name on page
3-24 and Changing the Password on page 3-24 in 3-2-6 Security Settings on page 3-21.
Additional Information
If the OPC UA communications cannot be performed normally, check the consistency of anony-
mous login setting between the Controller and OPC UA client. For details on how to make the
settings, refer to 3-2-6 Security Settings on page 3-21.
For details on the OPC UA security mode and policy, refer to the OPC UA specifications.
When you take security into consideration, be sure to clear None under Security Policy.
Additional Information
If the OPC UA communications cannot be performed normally, check the consistency of securi-
ty policy setting between the Controller and OPC UA client. For details on how to make the set-
tings, refer to 3-2-6 Security Settings on page 3-21.
As for the URL, enter the URL set in OPC UA Server Settings - End Point under Configurations
and Setup - OPC UA Settings in the Multiview Explorer of the Sysmac Studio.
(By default, opc.tcp://192.168.250.1:4840/ is set.)
*1. The range of permitted security policies depends on the setting of Security Policy under Security Settings,
which is displayed when OPC UA Server Settings is right-clicked under Configurations and Setup - OPC
UA Settings in the Multiview Explorer of the Sysmac Studio.
*2. Set from OPC UA Server Settings - Security Settings under Configurations and Setup - OPC UA
Settings in the Multiview Explorer of the Sysmac Studio.
Additional Information
If a connection cannot be established, check for a connection error at the OPC UA client, and
then check the settings, etc.
As for the status at the server side, connect the Sysmac Studio to the NJ/NX-series Controller,
check for a certificate error, connection rejection, etc. from the event log, and then take neces-
sary actions. For details, refer to the NJ/NX-series Troubleshooting Manual (Cat. No. W503).
Or, check the contents of the Execution Log, and take necessary actions. For details, refer to
Section 7 Execution Log Functions on page 7-1.
Address space of the NJ/NX-series Controller that can be referenced by the client
Root
Objects
DeviceSet
Configuration
Resources
SupportedTypes
NxControllerType
ContollerName Controller name
DeviceStatus Controller state
ErrorStatus Error state of the Controller
Mode Mode of the Controller 6
UnpublishedVariablesStatus Status of unpublished variables
GlobalVars Published variables
Controller Name
The Controller name set in the Sysmac Studio is displayed as the folder name.
Controller State
The Controller state is displayed as shown below under DeviceState.
Sysmac Studio
Root
Objects
DeviceSet
Configuration
Resources
SupportedTypes
ContollerName
DeviceStatus
GlobalVars Published variables
Var1
Var2
Var3
6
Controller data type OPC UA data type Description of OPC UA data type
BOOL Boolean A value that indicates two states represented by an
8-bit value
SINT SByte 8-bit signed integer
USINT Byte 8-bit unsigned integer
BYTE
INT Int16 16-bit signed integer
UINT UInt16 16-bit unsigned integer
WORD
DINT Int32 32-bit signed integer
UDINT UInt32 32-bit unsigned integer
DWORD
LINT Int64 64-bit signed integer
ULINT UInt64 64-bit unsigned integer
LWORD
REAL Float IEEE-754 single-precision floating-point value
TIME Double IEEE-754 double-precision floating-point value
LREAL
STRING String UTF-8 string ending in NULL
DATE_AND_TIME DateTime Date and time
DATE 64-bit. 100-ns time from January 1, 1601
TIME_OF_DAY
Note Conforms to PLCopen OPC UA Information Model 1.00 Specifications.
• Array
As for the arrays of the CPU Unit, as shown below, an entire array variable is published as one
node.
Example) ArrayVar1, ArrayVar2, and ArrayVar3 are array variables.
GlobalVars
ArrayVar1
ArrayVar2
ArrayVar3
a) Reading and writing between the OPC UA server and the OPC UA client is performed by the
entire array variable.
b) Elements in the array can not be displayed, and reading/writing in element units is not sup-
ported.
c) One-dimensional or multi-dimensional arrays can be specified.
• Structure
As for the structures of the CPU Unit, as shown below, an entire structure variable is published
as one node.
Example) StructVar1, StructVar2, and StructVar3 are structure data type variables.
mem1, mem2, mem3, and stll are members of each of above structures.
The structure can be manipulated differently depending on the node setting. For details on node
setting, refer to Node Setting on page 3-8.
To read or write to an entire structure variable, select Do not expand in Node Setting.
GlobalVars
StructVar1
StructVar2
StructVar3
To read or write to an entire structure variable or a single member of a structure, select Expand
in Node Setting.
GlobalVars
StructVar1
mem1
mem2
mem3
stll
mbrl
mbrll
stlll 6
StructVar2
StructVar3
Additional Information
If the OPC UA client has the functions to interpret the type information of the structure and to
display the member hierarchies in the structure, the member hierarchies in the structure can be
displayed.
• Enumerated type
The enumerated type of the CPU Unit is published as the Int32 type.
The enumerated type is handled as the DINT type in the CPU Unit.
Additional Information
If the OPC UA client has the functions to interpret the type information of the enumerated type
and to display it as the enumerated type, the enumerated type can be displayed.
Whether the OPC UA Client can read/write global variables depends on the setting value of the
Network Publish attribute, as shown below.
Restrictions
The restrictions on public variables in the OPC UA Server are described below.
Scope of restric-
Item Description
tion
All network-publish- Number of public variables*1 10,000 max.
ed variables Number of value attributes of 10,000 max.
public variables*2
Number of structure definitions 100 max.
that can be published*3
Individual network- Size of public variable 60KB*4 max.
published variable Array specification • The maximum number of elements is 2,048*5 per
variable.
• Only elements whose element number starts with
a zero can be published.
Structure • The maximum number of members per structure
type variable*6 is 100.
• The maximum number of hierarchies is three.
• A multidimensional array specified structure*7 as
well as a structure containing a multidimensional
array as a member*8 cannot be published.
Unions • Cannot be published.
• A structure containing union(s) as member(s) can-
not be published.
*1. When structure member are expanded to nodes, the members are newly counted as nodes in the num-
ber of public variables.
*2. The number of value attributes is the total of the following.
Number of value attributes = (number of variables of basic type) + (number of elements specified by ar-
ray) + (number of values in structure)
*3. Details of Number of structure definitions that can be published are as follows:
• Specify the number of definitions. Even if the same definition is used in multiple variables, the number
of definitions is not counted up.
• If the data type of the members of the structure is also a structure, the number of members (that are
structures) is also counted.
• If the data type of the members of the structure is either basic data type or array, the members are not
counted.
*4. In the unit versions of the following CPU Units, the maximum size is 1,024 bytes.
NJ501-1£00: Unit version earlier than 1.48
NX102-££££: Uni version earlier than 1.48
NX701-1£££: Unit version earlier than 1.28
*5. In the unit versions of the following CPU Units, the maximum number is 1,024.
NJ501-1£00: Unit version earlier than 1.48
A variable that is not published to the OPC UA Server due to the above restrictions is not displayed
in the OPC UA client even if it is registered as a network-published variable.
Step 1: The group of network-published variables is sorted in the ascending order of the character code
UTF-16 of the variable name.
6
For example, sorting is done in the order of single-byte numbers (in the order of 0 to 9) -> single
byte alphabets (in the order of A to Z) -> double-byte characters. Note that single-byte alphanu-
Execution Log
Item Event log (Category name - Log code (position of log
name))
Number of public variables in Too Many Public • Occurrence informa- Detailed information of
all network-published varia- Variables (Event code: tion: SERVER-0100 each published varia-
bles 35D30000 hex) (The maximum num- ble: SERVER-0111 (De-
Number of value attributes of Too Many Public Value ber of variables that tailed information of
public variables in all net- Attributes (Event code: can be published has OPC UA public varia-
work-published variables 35D50000 hex) been exceeded) bles)
Number of structure defini- Too Many Structure • Information about the
tions that can be published in Definitions (Event code: number of public var-
all network-published varia- 35D60000 hex) iables: SERV-
bles ER-0110 (Number of
OPC UA public varia-
bles)
Size of public variables of Unsupported Data Type • Occurrence informa-
each network-published vari- (Event code: 35D40000 tion: SERVER-0101
able hex) (Variables containing
Array specifications of each an unsupported data
network-published variable type)
Structures of each network-
published variable
Unions of each network-pub-
lished variable
• Both the event log and the Execution Log are registered when any of the following operations is
performed:
a) When the power is turned ON or when the Controller is reset
b) During a download
c) During a restore operation
d) When a variable added through online editing is subject to the restrictions.
For details on the event log and the Execution Log, refer to the NJ/NX-series Troubleshooting
Manual (Cat. No. W503) and 7-1-5 Execution Log File Specifications on page 7-4, respectively.
Even if a global variable is set to Network Publish in the Sysmac Studio, the OPC UA client may
not be able to refer to or read/write the variable in some cases depending on the limits sets on
variables that can be published to the OPC UA client.
Refer to the event log or Execution Log, and review which variables to be published to the net-
work depending on the cause of occurrence.
7-1-1 Overview
The Execution Logs are used to trace operations on the CPU Unit of the OPC UA Server. They are
saved to the SD Memory Card (sold separately) mounted in the CPU Unit.
The following can be checked with log codes and log names in the Execution Logs.
Refer to Category Name, Log code, Log name, and Details in the record formats of 7-1-5 Execution
Log File Specifications on page 7-4 for details.
Meaning of
Meaning of log
category Description
name
name
OPC UA OPC UA Server start- Registered when the power turns on if the OPC UA Server Use Option
server ed is set to Use.
Preparing of OPC UA Registered when the OPC UA server enters the Preparing state.
Server started
OPC UA Server run- Registered when the OPC UA server enters the Running state.
ning
OPC UA Server shut- Registered when the OPC UA server enters the Shutdown state.
down completed
OPC UA Server error Registered when the OPC UA server enters the Halt error state.
Maximum number of Registered when the maximum number of variables that can be pub-
variables that can be lished is exceeded among the global variables with the network publish
published is exceed- attribute.
ed
Variable including un- Registered for each variable when there are unsupported data types
supported data type on the OPC UA server among the global variables with the network
publish attribute.
Number of OPC UA Registered the total number of variables that the OPC UA Server pub-
public variables lishes to clients, when the address space is re-prepared or changed.
Details of OPC UA Registered details of the variables that the OPC UA Server publishes
public variables to clients, when the address space is re-prepared or changed.
Authentica- Application authenti- Registered when application authentication processing completes
tion cation (successful or failure).
User authentication Registered when user authentication processing completes (successful
or failure).
Security settings up- Registered when the security settings are updated.
dated
Certificate Server certificate up- Registered when a server certificate is generated.
dated
Notice of expiration of Registered only once when the number of days left until expiration is
server certificate less than 30.
Server certificate ex- Registered when the server certificate has expired.
pired
Server certificate mis- Registered when the IP address of the Server and the IP address of
match the Controller are different.
Meaning of
Meaning of log
category Description
name
name
Certificate added Registered when the user adds a certificate in the CPU Unit by operat-
ing the Sysmac Studio.
Certificate deleted Registered when the user deletes a certificate in the CPU Unit by using
the Sysmac Studio.
Certificate moved Registered when the user moves a certificate in the CPU Unit by using
the Sysmac Studio.
Certificate discarded Registered when a certificate received from an OPC UA client is dis-
carded without being saved because the number of certificates saved
in the CPU Unit has reached the limit.
Certificate Revocation Registered when the user adds a Certificate Revocation List in the
List added CPU Unit by operating the Sysmac Studio.
Certificate Revocation Registered when the user deleted a Certificate Revocation List in the
List deleted CPU Unit by operating the Sysmac Studio.
The Execution Logs are recorded by setting Execution Log to Record from Configurations and
Setup - OPC UA Settings - OPC UA Server Settings in Multiview Explorer of the Sysmac Studio.
When the Execution Logs are recorded, the Execution Log files are constantly saved to the SD Memo-
The Execution Logs are temporarily recorded in the internal buffer (volatile memory) of the CPU Unit
and then saved to the SD Memory Card. While the SD Memory Card is being replaced, the execution
logs are kept in the internal buffer (volatile memory) of the CPU Unit. When you insert an SD Memory
Card, the Execution Logs temporarily stored in the internal buffer are then saved automatically to the
SD Memory Card. Refer to 7-4-3 Execution Log Operation when Replacing the SD Memory Card on 7
page 7-20 for details.
When you use Execution Logs, be sure to insert an SD Memory Card into the CPU Unit.
The Execution Logs are temporarily recorded in the internal buffer of the CPU Unit and then
saved to the SD Memory Card. If no SD Memory Card is mounted at power-OFF or shutdown
processing of the CPU Unit, the Execution Logs recorded in the internal buffer will be lost. In
that case, an Execution Log Save Failed event (event code: 15000000 hex) will occur.
Step Reference
STEP1. Set Execution Log. 7-1-3 Setting the Execution Log on page 7-4
STEP2. Insert the SD Memory Card into the CPU NJ-series CPU Unit Hardware User’s Manual (Cat. No.
Unit. W500)
NX-series NX102 CPU Unit Hardware User's Manual
(Cat. No. W593)
STEP3. Start the OPC UA Server. 4-1 Starting or Stopping the OPC UA Server on page
4-2
STEP4. Check the Execution Logs. 7-2 Checking the Execution Log on page 7-13
Note The system time of the CPU Unit is used for the time information included in the file name.
• The files are stored in the following directories (in the SD Memory Card).
a) Log files:
/packages/OPCUA_Server/ExecutionLog/
b) Log control file:
/packages/OPCUA_Server/System/
Category name, Log code, Log name, and Details are as follows:
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
SERVER 0001 Start OPC UA None
Server started
0004 Prepare Preparing of None
address
space of OPC
UA Server
started
0005 Run OPC UA None
Server run-
ning
0006 Shutdown OPC UA None
Server shut-
down com-
pleted
0007 HaltError OPC UA Error message
Server error 1. Refer to*1 below this table for a list of the error
messages.
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
0100 MaxVariables Maximum Format:
number of Details 1
variables that
Details 1:
can be pub-
• MaxVariables: The number of variables exceeded
lished is ex-
the upper limit.
ceeded
• MaxValues: The number of value attributes of a
variable exceeded the upper limit.
• MaxDataTypes: The number of structure defini-
tions exceeded the upper limit.
0101 InvalidDataType Variable in- Format:
cluding un- Details 1<tab>Details 2<tab>Details 3
supported da-
Details 1:
ta type
• Variable name: Up to 60 bytes is displayed for the
name of each variable that cannot be published.
Note In the case of multi-byte characters, the last
character may not be displayed correctly.
Details 2:
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
0111 PublishedVariable Details of Format:
OPC UA pub- VarName<tab>VarSize<tab>NumOfValues<tab>N
lic variables umOfMembers
• VarName: Variable name published to OPC UA
clients (Up to 60 bytes to be displayed)
Note In the case of multi-byte characters, the last
character may not be displayed correctly.
• VarSize: Variable size (decimal number, unit is
byte)
• NumOfValues: Number of value attributes of vari-
able (decimal, unit is attribute but is not recorded)
• NumOfMembers: When the data type of the varia-
ble is structure, number of members of the struc-
ture (decimal, unit is member but is not recorded)
Note When the data type of the variable is not
structure, this is 0 (zero).
AUTH 0001 Application Application - When connected
authentication • In normal status
Format:
OPEN<tab>SessionID<tab>IP address of
connecting client<tab>Host information of
client certificate
• In error status
Format:
ERROR<tab>Error message
Note Refer to*2 below this table for a list of the er-
ror messages.
- When disconnected
Format:
CLOSE<tab>SessionID
0002 User User authenti- • In normal status:
cation Format: Success<tab>SessionID<tab>User
name
• In error status
Format: ERROR<tab>User name<tab>Error
message
Note Refer to*3 below this table for a list of the er-
ror messages.
0100 Update Security set- None
tings updated
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
CERT 0001 Update_Sever Server certifi- Format:
cate updated Distinguished name (common name) of
0002 Notify_Server Notice of ex- certificate<tab>Expiration date of certificate
piration of
• Distinguished name (common name) of certifi-
server certifi-
cate: Up to 60 bytes maximum from the beginning
cate
is output.
0003 Expired_Server Server certifi- • Expiration date of certificate: YYYY-MM-
cate expired DDThh:mm:ssZ
0004 Mismatch_Host Server certifi- (The expiration date of the certificate is expressed
cate mis- in UTC. When it is recorded in the Details, it is re-
match corded in UTC as well.)
0100 Add Certificate Format: Details 1:
added Distinguished name Type of
(common name) of certificate<tab>Store
certificate<tab>Expira location
tion date of • Type of certificate: CLI-
certificate<tab>Details ENT: Client certificate
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
0103 Discard Certificate Details 1:
discarded Type of
certificate<tab>Store
location
• Type of certificate: CLI-
ENT: Client certificate
• Store location: RE-
JECTED: Rejected cer-
tificate list (Fixed)
Note In the following cas-
es, the Certificate
discarded Execution
Log is not recorded
(it is recorded in the
event log)
• Memory all
cleared
• Unsupported
OPC UA project
downloaded
• Unsupported
OPC UA project
restored
0200 Add_Crl Certificate Format:
Revocation File name<tab>Distinguished name (common
List added name) of CA<tab>Expiration date of revocation
0201 Delete_Crl Certificate list<tab>Type of revocation list<tab>Store
Revocation location
List deleted
• File name: Up to 60 bytes from the beginning is
output.
• Distinguished name (common name) of CA: Up to
60 bytes from the beginning is output.
• Expiration date of revocation list: YYYY-MM-
DDThh:mm:ssZ
• Type of revocation list: CLIENT: Client certificate
revocation list
• Store location: TRUSTED: Certificate Trust List
ISSUER: Root certificate / intermediate certificate
list
Note Revocation list deleted only:
In the following cases, the Revocation list
deleted Execution Log is not recorded (it is re-
corded in the event log)
• Memory all cleared
• Unsupported OPC UA project downloaded
• Unsupported OPC UA project restored
Log
Category code Meaning of
Log name Details
name (Deci- log name
mal)
0300 Invalid Invalid certifi- Format:
cate Certificate distinguished name (common name)
• Example of when the power is turned ON and the OPC UA Server is started.
0 2017-10-17 14:52:50 747 SERVER 0001 Start
1 2017-10-17 14:52:50 749 SERVER 0004 Prepaire
2 2017-10-17 14:52:50 877 SERVER 0111 PublishedVariable Var1 2Byte 1 0
3 2017-10-17 14:52:50 878 SERVER 0111 PublishedVariable Var2 6Byte 3 3
4 2017-10-17 14:52:50 878 SERVER 0111 PublishedVariable Var3 2Byte 1 0
5 2017-10-17 14:52:50 878 SERVER 0111 PublishedVariable Var4 10Byte 5 0
6 2017-10-17 14:52:50 878 SERVER 0110 NumOfVariables Variables=4, Values=10, DataTypes=1
7 2017-10-17 14:52:50 889 SERVER 0005 Run
• Example of when the user moved a client certificate from the Rejected Certificate List to the Trusted
Certificate List:
10 2017-10-17 14:54:28 929 CERT 0102 Move UaClient_1@SamplePC
2022-10-03T08:19:54.000ZCLIENTREJECTED->TRUSTED
• Example of when user authentication and application authentication end successfully, following a re-
connection request from a client.
11 2017-10-17 14:54:39 250 AUTH 0002 User SUCCESS 0x2ADA356B Anonymous
12 2017-10-17 14:54:39 251 AUTH 0001 Application OPEN 0x2ADA356B 192.168.255.2 Ua-
Client_1@SamplePC
1 Go online with the CPU Unit from the Sysmac Studio, right-click OPC UA Settings under 7
Configurations and Setup in the Multiview Explorer, and select Show Operation Logs.
The following Operation Log Window is displayed. 7-2-1 How to Check the Execution Log
Execution Log
Details
Operation buttons
1 Click the Transfer From Controller Button to acquire the log files from the Controller and dis-
play a list of the log files in the following Operation Log Dialog Box.
2 Select a log file to display and click the OK Button. The log file is uploaded.
7-2-2 Checking Logs in the Operation Log Window in the Sysmac Studio
Cancel: The file list is displayed again.
Note If the selected log file is bigger than 10 MB, the following message is displayed.
2 Click the Yes Button to clear the log files in the SD Memory Card inserted in the CPU Unit.
1 Select the Use Option for the FTP server in the FTP Settings, which is displayed following
Built-in EtherNet/IP Port Settings - Configurations and Setup in the Multiview Explorer of
the Sysmac Studio.
For details on how to make the settings, refer to the NJ/NX-series CPU Unit Built-in
EtherNet/IP Port User’s Manual (Cat. No. W506).
2 Using the FTP client software, input the FTP login name and password that you set in the Built-
in EtherNet/IP Port Settings to log into the CPU Unit.
3 Move to the folder where the execution log files are stored.
cd \MEMCARD1\packages\OPCUA_Server\ExecutionLog\
6 Open the acquired Execution Log files in Microsoft Excel or a text editor or any other applica-
tion to check the contents.
7-3-1 Overview
The OPC UA Server shutdown function (hereinafter called shutdown function) is used to shut down
the OPC UA Server after saving the execution files to the SD Memory Card.
Execute the shutdown function before turning OFF the power supply to the CPU Unit. You can prevent
Execution Log data loss by executing the shutdown function.
If the power supply to the CPU Unit is turned OFF without executing the shutdown function
while the OPC UA Server is running, the contents of the Execution Logs cannot be guaranteed.
The Execution Log files may be corrupted or the data may be lost.
Additional Information
To prevent data loss due to an unexpected power interruption, we recommend that you take
measures against power interruptions such as the installation of an uninterruptible power supply
system.
CPU Unit
c. Connection
Program OPC UA server disconnected
Shutdown OPC UA
instruction Shut down
OPCUA_
b. OPC UA Connection
Shutdown EtherNet/IP port
Service Shutdown
a-2) Execute
OPCUA_Shutdown
(Shutdown OPC Execution Log
UA function) Internal buffer
instruction
SD Memory
Card Log file
a. The OPC UA Server is shut down by one of the followings: (1) Using the Sysmac Studio Or
(2) Executing the OPCUA_Shutdown (Shutdown OPC UA Function) instruction
Additional Information
When you execute the Reset Controller operation on the Sysmac Studio, the OPC UA server
shutdown function is automatically executed before resetting the Controller.
7
Instruction Execution
Confirm that the Done output variable of the OPCUA_Shutdown (Shutdown OPC UA Function) in-
struction is TRUE.
Refer to A-2 OPC UA Instruction on page A-8 for details on the OPC UA instruction.
Refer to the NJ/NX-series CPU Unit Software User’s Manual (Cat. No. W501) for details on the SD
Memory Card functions.
Operation to use the function Conditions for saving log files on SD Memory Card
Set Execution Log to Record in OPC UA Constantly saved while the OPC UA Server is running*1.
Server Settings of the Sysmac Studio.
*1. If the power supply to the CPU Unit is turned on while no SD Memory Card is mounted in the CPU Unit, an
Execution Log Save Failed event (event code: 15000000 hex) is registered in the event log when an Execu-
tion Log is saved. Recording of the Execution Logs starts when an SD Memory Card is inserted into the
CPU Unit.
Even while the Server operating status of the OPC UA Server is preparing or running, recording of the Exe-
cution Log files will just start at the point of time when an SD Memory Card is inserted.
Directory Description
/packages/OPCUA_Server/ExecutionLog Contains the Execution Log files.
/packages/OPCUA_Server/System Contains the system files (log control file).
Version Information
Combination of the CPU Unit version and SD Memory Card determines whether the SD memo-
ry card life expiration detection function can be used or not. Refer to Specifications of
Supported SD Memory Cards, Folders, and Files in the NJ/NX-series CPU Unit Software User’s
Manual (Cat. No. W501) for details.
This function is used to restrict online operations on the CPU Unit via the Sysmac Studio based on the
granted authority.
Refer to the NJ/NX-series CPU Unit Software User’s Manual (Cat. No. W501) and the Sysmac Studio
Version 1 Operation Manual (Cat. No. W504) for the details and operating procedure of the operation
authority verification function.
The following table indicates online operations related to the OPC UA Server based on the authority
level.
8-1 The Sysmac Studio Operation Authority Verification Related to the OPC UA Server
Delete certificate OP NP NP NP NP
Move certificate OP NP NP NP NP
View certificate OP OP OP OP NP
details
Add Certificate OP NP NP NP NP
Revocation List
Delete Certificate OP NP NP NP NP
Revocation List
View Certificate OP OP OP OP NP
Revocation List
details
Security settings Display and edit OP OP OP OP NP 3-2-6 Security
(user authentica- Transfer security OP NP NP NP NP Settings on page
tion settings, settings 3-21
anonymous login,
and security poli-
cy)
Service status Display and up- OP OP OP OP NP 4-2-1 Checking
date Based on OPC
Shut down server OP OP NP NP NP UA Server Status
of the Sysmac
Studio on page
4-5
Execution Logs Display OP OP OP OP NP Section 7 Execu-
Clear OP OP OP NP NP tion Log Functions
on page 7-1
8
There are four types of features for backup and restoration. Refer to the NJ/NX-series CPU Unit
Software User’s Manual (Cat. No. W501) for details on each function.
Backup Restore
Function Description
function function
SD Memory Card This function allows you to save various settings data in the Available Available
backups NJ/NX-series CPU Unit to the SD Memory Card and restore
the settings data in the CPU Unit by performing an operation
on the CPU Unit.
The Sysmac Stu- This function allows you to save various settings data in the Available Available
dio Controller NJ/NX-series CPU Unit to a PC and restore the settings data
Backup Function in the CPU Unit by using the Sysmac Studio.
Program transfer With the _ Card1PrgTransferCmd (SD Memory Card Program Unavailable Available
from SD Memory Transfer Command) system-defined variable, you can trans-
Card fer a program stored in the SD Memory Card mounted in the
CPU Unit to the Controller.
Automatic transfer This function automatically transfers the data of the backup Unavailable Available
from SD Memory file in the /autoload directory of the SD Memory Card in the
Card CPU Unit to the Controller when the power is turned on.
The server certificate is not target for backup and restore because it is information belonging to
individual CPU Units. If you replace the CPU Unit hardware, you cannot use the same server
certificate for the new CPU Unit after the replacement.
Even if you set the IP address of the built-in EtherNet IP port to the same value as the one for
the previous CPU Unit, be sure to export the server certificate of the new CPU Unit and then
perform installation again on the OPC UA clients.
Refer to 3-2-5 Setting and Displaying the Certificate on page 3-9 for how to export the server
certificate.
• When you import the data of a backup file created with the SD Memory card backup function
to a Sysmac Studio project and when you export the data of a Sysmac Studio project to a
backup file, client certificates, security settings, and Execution Logs cannot be imported/
exported. Please note that only OPC UA Server Settings can be imported/exported.
Additional Information
8
8-2-2 Restoration and Verification
Restoration Verification
Restored by one
Restored by one
of the following Verified by one
of the following
• Automatic of the following
Data group of • SD Memory
Save transfer from • SD Memory
the backup func- Card Restore
Data loca- SD Memory Card backups
tion for each da- Function
tion Card • The Sysmac
ta • The Sysmac
• Program Studio Con-
Studio Con-
transfer from troller back-
troller back-
SD Memory ups
ups
Card
OPC UA Server User program and Non- Applicable Applicable Applicable
Settings settings volatile
memory
Restoration Verification
Restored by one
Restored by one
of the following Verified by one
of the following
• Automatic of the following
Data group of • SD Memory
Save transfer from • SD Memory
the backup func- Card Restore
Data loca- SD Memory Card backups
tion for each da- Function
tion Card • The Sysmac
ta • The Sysmac
• Program Studio Con-
Studio Con-
transfer from troller back-
troller back-
SD Memory ups
ups
Card
Server certificate OPC UA server Non- Not applicable Not applicable Not applicable
certificate volatile
memory
Client certificate OPC UA security Non- Depends on the
CA certificate profile volatile selection*1
Certificate Revo- memory
cation List
Security settings
(user authentica-
tion settings,
anonymous login,
and security poli-
cy)
Execution logs --- SD Not applicable
Memory
Card
Event logs Event logs Backup Not applicable
memory
*1. You can select whether or not to allow these types of data to be restored by the function. Refer to the next
section How to Select Whether or Not to Set OPC UA Security Profile as a Restore Target on page 8-6 for
the selection procedure.
:
:
Range of
Variable name Name Function Data type
values
_Card1Restor- OPC UA Security When restoring OPC UA security BOOL TRUE,
eCmdTargetOp- Profile Transfer profile in the SD Memory Card to FALSE
cuaSPF Flag the Controller, set this to TRUE.
1 Using the Controller backup functions (i.e., SD Memory Card backup function or the Sysmac
Studio Controller backup function), back up the settings data other than the server certificate in
the CPU Unit to the SD Memory Card or the computer as a backup file.
2 Remove the SD Memory Card and insert it into the newly-installed CPU Unit.
3 Using the Controller restore functions (i.e., SD Memory Card restore function or the Sysmac
Studio Controller backup function), restore the backed-up file to the new CPU Unit*1.
*1. You can select whether to restore the OPC UA security profile (i.e., client certificate, CA certificate,
Certificate Revocation List, Security Settings) in the target data.
4 Cycle the power supply to the new CPU Unit, or reset the Controller.
A new server certificate will be automatically generated.
If the newly-installed CPU Unit has ever used the OPC UA Server, the event of Server
Certificate Mismatch (event code: 15020000 hex) may be registered in the event log. If it is reg-
istered, connect online to the CPU Unit and regenerate a server certificate in the Server
Certificate Tab Page.
5 Connect online to the new CPU Unit from the Sysmac Studio, right-click OPC UA Server
Settings, and then click the Export Button in the Server Certificate Tab Page to export the
server certificate.
7 If you have not restored the OPC UA security profile, connect online to the new CPU Unit from
the Sysmac Studio and reconfigure the security settings, the client certificate, and if necessary
the CA certificate and Certificate Revocation List.
Clear All Memory is an operation to initialize the data in the CPU Unit from the Sysmac Studio.
The following table shows whether or not each data of the OPC UA Server is target for the Clear All
Memory function.
1 Connect the Sysmac Studio to the CPU Unit online, and select Clear All Memory from the
8
Controller Menu. The following Clear All Memory Window is displayed.
• When the Clearing the OPC UA server certificate and security profile Check Box is not
selected
4 Click the Yes Button to clear all memory. All memory is cleared.
• When OPC UA Server in OPC UA Server Settings under OPC UA Settings is set to Use
for the connected CPU Unit:
The Controller must be reset. The following dialog box is displayed.
When Not Clearing the Server Certificate And OPC UA Security Profile
1 Reconfigure the OPC UA Server Settings offline from the Sysmac Studio and download them
to the CPU Unit.
3 Connect online from the Sysmac Studio to the CPU Unit, and set the Security Settings, client
certificate, and if necessary the CA certificate and Certificate Revocation List.
4 Connect online from the Sysmac Studio to the CPU Unit, and click the Export Button in the
Server Certificate Tab Page to export the server certificate.
5 Import the exported server certificate (X.509 certificate file) to the OPC UA client.
Host computer
HMI
Checking Network
Status
EtherNet/IP
Troubleshooter
Network Configurator
Built-in
NJ/NX-series EtherNet/IP port CJ-series Units
CPU Unit and NX Units
Troubleshooting
Sysmac Studio
EtherCAT
EtherCAT
slave
You can use the troubleshooting functions of the Sysmac Studio or the Troubleshooter on an HMI to
quickly check for errors that have occurred and find corrections for them.
Refer to the NJ/NX-series Troubleshooting Manual (Cat. No. W503) for types of errors, meanings, spe-
cific corrections when errors occur and for troubleshooting information on the entire NJ/NX-series Con-
troller.
Appendices
This section describes the error confirmation methods and corrections for errors that
can occur with the OPC UA Server.
Refer to the NJ/NX-series CPU Unit Software User’s Manual (Cat. No. W501) for the task and system
service operation specifications of the NJ/NX-series Controllers.
NX701-1£££
NJ501-1£00
Start-Up Time
(Unit: Second)
180.00 Percentage of task
160.00 execution time
140.00
40%
120.00
50%
100.00
60%
80.00
70%
60.00
80% Cannot be recommended
40.00 because the system service
90% time ratio becomes ≤ 20%.
20.00
0.00
0 2000 4000 6000 8000 10000
Number of Network-published Variables (Example: INT type)
NX102-££££
Start-Up Time
(Unit: Second)
160.00
0.00
0 2000 4000 6000 8000 10000
Number of Network-published Variables (Example: INT type)
100.00
1000 A
80.00
5000
NJ501-1£00
For NJ501-1£00, if sufficient system service execution time cannot be secured, the OPC UA Serv-
er may be slow in responding to requests from OPC UA clients, including reading/writing variables.
As a target to perform a satisfactory level of response to requests from OPC UA clients, design
tasks to make sure that the system service execution time ratio exceeds 20%.
The system service execution time ratio (CPU usage) of 20% or greater is just a numerical tar-
get. The appropriate system service execution time ratio depends on the CPU usage of other
services executed on the system.
Before starting actual operation, you must test performance under all foreseeable conditions on
the actual system and make sure that the OPC UA Server operates with appropriate system
service execution time.
• If the system service execution time ratio is reduced, operation failures or communications er-
rors may occur when each operation is executed from the Sysmac Studio. If an operation fail-
ure or communications error occurs when you execute an operation from the Sysmac Studio,
retry the operation after doing the following:
a) Check the cable connections.
b) Check the communications settings.
c) Increase the response monitoring time in the communications settings.
d) Start up in safe mode.
• If the Sysmac Studio cannot go online, refer to the NJ/NX-series Troubleshooting Manual
(Cat. No. W503).
• If the time set for system service monitoring cannot be secured for system services, an
Insufficient System Service Time Error will occur. The error is classified as a major fault level
Controller error. When the error occurs, user programs will be stopped. Set the System Serv-
ice Monitoring Settings to the minimum values that are required to meet the response per-
formance of the system services so that sufficient time can be allocated to the system serv-
ices and task execution. The System Service Monitoring Settings are used to monitor wheth-
er the specified system service execution time can be obtained. System services will not nec-
essarily be executed for the specified time.
• The system service execution time is affected by task execution time and tag data links. Re-
fer to the NJ/NX-series CPU Unit Software User’s Manual (Cat. No. W501) for details of task
specifications, tag data link service, and system services.
NX701-1£££
For the NX701 CPU Units, the system services are executed at the required time without being af-
fected by the task and tag data link service. It is designed to always secure sufficient time for sys-
tem service execution.
NX102-££££
For NX102-££££, the system services are executed without being affected by the tasks. Howev-
er, during execution of the tag data link service, system services are not executed.
Desktop Calculation
This is an example for a project that consists of one primary periodic task.
Refer to the NJ/NX-series CPU Unit Software User’s Manual (Cat. No. W501) to make a rough esti-
mate of the average task execution time on paper.
• For NJ501-1£00
Average task execution time < Task period x 0.8
Design the task based on the above calculation.
• For NJ501-1£00
Estimated CPU usage rate - System service execution time ratio < 80%
Design the task based on the above calculation.
The Estimated CPU usage rate shows how much of the task period is used by the total of the maxi- A
mum estimated task processing time, the tag data link service execution time ratio, and the system
service processing time.
• For NJ501-1£00
Average task execution time < Task period x 0.8
Design the task based on the above calculation.
When the project consists of multiple tasks, test the performance under all foreseeable conditions
using the actual Controller to make sure that the OPC UA clients operate within the appropriate ex-
ecution time.
FB/
Instruction Name Graphic expression ST expression
FUN
OP- Shutdown FB OPCUA_Shutdown_instance OPCUA_Shutdown_instance
CUA_Shut- OPC UA OPCUA_Shutdown (Execute, Done, Busy, Error, Er-
down Server rorID);
Execute Done
Busy
Error
ErrorID
A-2-2 Variables
Input Variables
Input varia-
Meaning Data type Valid range Unit Default Description
ble
Execute Execute BOOL TRUE or FALSE --- FALSE Specify the execution
condition.
Output Variables
Output
Meaning Data type Valid range Unit Description
variable
Done Done BOOL TRUE or --- TRUE when the instruction is normally com-
FALSE pleted.
Busy Executing BOOL TRUE or --- TRUE when the instruction is being execut-
FALSE ed.
Error Error BOOL TRUE or --- TRUE when the instruction is terminated due
FALSE to an error.
ErrorID Error Code WORD 16#0000 to --- Contains the error code when an error oc-
16#FFFF curs.
For details on errors, refer to the OPC UA Instructions in the NJ/NX-series Troubleshooting Manual
(Cat. No. W503).
A-2-5 Function
The OPCUA_Shutdown (Shutdown OPC UA Function) instruction requests the shutdown of the OPC
UA Server so that the controller power supply can be safely turned OFF.
At this time, in order to set the OPC UA Server to the shutdown state, record OPC UA server
shutdown completed in the Execution Log, and stop access to the SD memory card.
Before turning OFF the power supply to the controller, make sure this instruction has terminated nor-
mally (the value of Done has changed to TRUE).
This instruction operates separately from the function of accessing the SD Memory Card for other in-
structions. If other than the OPC UA Server accesses the SD memory card during the execution of this
instruction, this instruction will be executed asynchronously with respect to the SD memory card ac-
cess, and therefore, the processing order will be optional.
Ladder Diagram
Main Variables
Name Data type Initial value Comment
OPCUA_Shutdown_instance OPCUA_Shutdown --- Instance of OPCUA_Shutdown
(Shutdown OPC UA Function)
instruction.
Trigger BOOL FALSE Variable used as a trigger for
shutting down the OPC UA
Server.
Shutdown_OK BOOL FALSE This variable changes to TRUE
when the OPCUA_Shutdown
(Shutdown OPC UA Function)
instruction terminates normally.
Sample Programming
• Shutdown the OPC UA Server.
Shutdown the OPC UA server by setting Trigger to TRUE.
OPCUA_Shutdown_instance
Trigger OPCUA_Shutdown
Execute Done
Busy
Error
ErrorID
When the instruction is normally completed, the Shutdown_OK variable is changed to TRUE.
OPCUA_Shutdown_instance.Done Shutdown_OK
S
Main Variables
Name Data type Initial value Comment
OPCUA_Shutdown_instance OPCUA_Shutdown --- Instance of OPCUA_Shutdown
(Shutdown OPC UA Function)
instruction. A
Trigger BOOL FALSE Variable used as a trigger for
shutting down the OPC UA
Sample Programming
(*----------------------------------------------------------------------------------
♦Shutdown the OPC UA Server. ----------------------------------------------------------------------------------*)
// Start the sequence when the variable Trigger changes to TRUE.
IF ( (Trigger=TRUE) AND (LastTrigger=FALSE) ) THEN
OperatingStart := TRUE;
Operating := TRUE;
END_IF;
LastTrigger := Trigger;
OPCUA_Shutdown_instance( Execute:=FALSE );
OperatingStart := FALSE;
END_IF;
IF (Operating=TRUE) THEN
// Shutdown OPC UA Server
OPCUA_Shutdown_instance( Execute:=TRUE );
IF (OPCUA_Shutdown_instance.Done=TRUE) THEN
// Normal end processing
ShutdownOK := TRUE;
Operating := FALSE;
END_IF;
IF (OPCUA_Shutdown_instance.Error=TRUE) THEN
// Processing after error end
Operating := FALSE;
END_IF;
END_IF;
tificates Supported
Supported
This Appendix describes an overview and settings of a CA-signed client certificate, as well as how to
operate a CA-signed client certificate on the Sysmac Studio.
A
A-3-1 Overview
A-3-1 Overview
For a CA-signed client certificate, you must make the settings from the Client Authentication Tab
Page and the Issuer Authentication Tab Page in the OPC UA settings (online) from the Sysmac Stu-
dio.
The CA Certificate Revocation List is a list in which issued client certificates are registered when they
are revoked before the expiry of the valid period.
If a client certificate is registered in the CA Certificate Revocation List, the connection from the corre-
sponding client certificate fails, and the client certificate is registered in the Rejected Certificate list.
A-3-2 Setting
For a CA-signed client certificate, you must make the following settings in the OPC UA settings (on-
line) from the Sysmac Studio.
The certificates that must be registered differ depending on the authentication means and the type of
CA certificate.
Client Authentication
Display and perform client authentication for a CPU Unit connected online.
tificates Supported
Configurations and Setup - OPC UA Settings in the Multiview Explorer, and then select
Client Authentication.
A-3-3 Related Operations Performed from OPC UA Settings in the Sysmac Studio
The following Client Authentication Tab Page appears.
Item Description
(A) Trusted Certificate The Trusted Client Certificate List in the CPU Unit is displayed.
List • Common name, expiration of validity period, organization, domain name
are displayed.
• The default display order is ascending order of common names. You can
sort the list by the name of each item by clicking each column header. As-
cending and descending order are switched each time you click.
• Add Button ( ):
Adds the certificate selected in the Add Certificate Dialog Box to the
Trusted Certificate List in the CPU Unit.
• Delete Button ( ):
Deletes the selected certificate from the Trusted Certificate List in the CPU
Unit.
(B) Certificate Revoca- The Certificate Revocation List in the CPU Unit is displayed.
tion List • The File Name, Issuer, Effective Start Date, and Next Update Date are dis-
played.
• The default display order is the ascending order of the file name. You can
sort the list by the name of each item by clicking each column header. As-
cending and descending order are switched each time you click.
• Add Button ( ):
Adds the certificate selected in the Add Certificate Dialog Box to the
Trusted Certificate List in the CPU Unit.
• Delete Button ( ):
Deletes the selected certificate from the Trusted Certificate List in the CPU
Unit.
(C) Update Button The display in the Client Authentication Tab Page is updated with the data
in the CPU Unit.
Issuer Authentication
Perform display and operations of issuer authentication in the CPU Unit placed online.
1 Place the Sysmac Studio online with the CPU Unit, right-click OPC UA Server Settings under
Configurations and Setup - OPC UA Settings in the Multiview Explorer, and then select
Issuer Authentication.
A-3-3 Related Operations Performed from OPC UA Settings in the Sysmac Studio
(B) Certificate Revocation List
Item Description
(A) Trusted Certificate The Trusted CA Certificate List in the CPU Unit is displayed.
List • Common name, expiration of validity period, organization, domain name
are displayed.
• The default display order is ascending order of common names. You can
sort the list by the name of each item by clicking each column header. As-
cending and descending order are switched each time you click.
• Add Button ( ):
Adds the certificate selected in the Add Certificate Dialog Box to the
Trusted Certificate List in the CPU Unit.
• Delete Button ( ):
Deletes the selected certificate from the Trusted Certificate List in the CPU
Unit.
(B) Certificate Revoca- The Certificate Revocation List in the CPU Unit is displayed.
tion List • The File Name, Issuer, Effective Start Date, and Next Update Date are dis-
played.
• The default display order is the ascending order of the file name. You can
sort the list by the name of each item by clicking each column header. As-
cending and descending order are switched each time you click.
Item Description
• Add Button ( ):
Adds the certificate selected in the Add Certificate Dialog Box to the
Trusted Certificate List in the CPU Unit.
• Delete Button ( ):
Deletes the selected certificate from the Trusted Certificate List in the CPU
Unit.
(C) Update Button The display in the Issuer Authentication Tab Page is updated with the data
in the CPU Unit.
fined Variables
This section lists the system-defined variables related to the OPC UA Server.
A-4-1 System-defined Variables for the Overall NJ/NX-series Controller (No Category)
Functional Classification: SD Memory Card Related
Range of val-
Variable name Name Function Data type
ues
_Card1RestoreCmd- OPC UA Security Pro- When restoring OPC BOOL TRUE,
TargetOpcuaSPF file Transfer Flag UA security profile in FALSE
the SD Memory Card
to the Controller, set
this to TRUE.
NX701-1£££
Unit version of CPU Unit OPC UA standard version
Ver.1.24 or later Ver.1.03
NJ501-1£00
Unit version of CPU Unit OPC UA standard version
Ver.1.43 or later Ver.1.03
Ver.1.17 or later and earlier than Ver.1.43 Ver.1.02
NX102-££00
Unit version of CPU Unit OPC UA standard version
Ver.1.43 or later Ver.1.03
Ver.1.30 or later and earlier than Ver.1.43 Ver.1.02
NX102-££20
Unit version of CPU Unit OPC UA standard version
Ver.1.36 or later Ver.1.03
Ver.1.30 or later and earlier than Ver.1.36 Ver.1.02
A-5-2 Relationship between Unit Versions and the Sysmac Studio Ver-
sions
The following table gives the relationship between the unit versions of CPU Units and the correspond-
ing Sysmac Studio versions.
Index
Numerics number of members per structure type variable................6-9
number of structure definitions that can be published....... 6-8
_Card1RestoreCmdTargetOpcuaSPF.............................A-19 Number of value attributes................................................ 6-8
A O
address space............................................................. 23, 6-3 OPC UA.............................................................................. 22
Anonymous login............................................................. 3-23 OPC UA client.....................................................................22
application authentication............................................ 22, 5-2 OPC UA security mode.......................................................23
authentication based on anonymous.................................5-6 OPC UA security policy...................................................... 23
authentication based on user name and password........... 5-5 OPC UA security profile......................................................23
OPC UA server................................................................... 22
B OPC UA Server.................................................................. 22
OPCUA_Shutdown (Shutdown OPC UA Function) instruc-
backup and restore functions............................................ 8-4 tion..........................................................................4-2, A-8
built-in EtherNet/IP port........................................................ 5 operation authority verification...........................................8-2
C P
CA-signed client certificate..............................................A-13 permitting a rejected client certificate.............................. 3-19
Clear All Memory function................................................. 8-9 port number....................................................................... 3-7
client authentication...................................................22, 3-15
client certificate............................................................22, 5-4 R
connecting from the client..................................................6-2
reading/writing variables....................................................6-4
D reading/writing variables from the OPC UA client............. 6-3
restrictions on publishing................................................... 6-8
DeviceState....................................................................... 6-3
S
E
security policy............................................................ 23, 3-23
End point.............................................................................22 Security Settings........................................................23, 3-21
End Point Settings............................................................. 3-6 server certificate................................................. 22, 3-10, 5-3
event................................................................................... 23 setting IP addresses.......................................................... 3-2
event log............................................................................. 23 Sign - Basic128Rsa15..............................................3-23, 5-7
Execution Log..................................................................... 23 Sign - Basic256........................................................ 3-23, 5-7
Execution Log Settings......................................................3-7 Sign - Basic256Sha256............................................3-23, 5-7
SignAndEncrypt - Basic128Rsa15........................... 3-23, 5-7
I SignAndEncrypt - Basic256......................................3-23, 5-7
SignAndEncrypt - Basic256Sha256......................... 3-23, 5-7
Issuer authentication........................................23, 3-21, A-16 specifications of the OPC UA Server.................................1-4
structure containing a multidimensional array as a member..
L ....................................................................................... 6-9
system service execution time ratio.................................. A-5
list of related system-defined variables........................... A-19
list of supported CPU Units............................................... 1-4
T
M Trusted Certificate List........................................................ 22
message............................................................................. 22
U
multidimensional array specified structure........................ 6-9
use of the OPC UA Server.................................. 3-3, 3-5, 3-6
N User authentication......................................................22, 5-5
User Authentication Settings........................................... 3-23
Network Publish.................................................................6-5
node....................................................................................23
Node setting...................................................................... 3-8
V
value attributes.................................................................. 6-4
OMRON (CHINA) CO., LTD. © OMRON Corporation 2018-2022 All Rights Reserved.
OMRON ASIA PACIFIC PTE. LTD.
Room 2211, Bank of China Tower, In the interest of product improvement,
No. 438A Alexandra Road # 05-05/08 (Lobby 2),
200 Yin Cheng Zhong Road, specifications are subject to change without notice.
Alexandra Technopark,
Singapore 119967 PuDong New Area, Shanghai, 200120, China
Tel: (65) 6835-3011/Fax: (65) 6835-2711 Tel: (86) 21-5037-2222/Fax: (86) 21-5037-2200 Cat. No. W588-E1-06 0422