Omron SYSMAC-XR005 User Manual

Sysmac Library

User’s Manual
for EtherCAT

® N-Smart Series Library

W549-E1-06

SYSMAC-XR005

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.

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 information contained in this manual is
subject to change without notice. Every precaution has been taken in the preparation of this manual. Neverthe­less, OMRON assumes no responsibility for errors or omissions. Neither is any liability assumed for damages
resulting from the use of the information contained in this publication.

• Sysmac and SYSMAC are trademarks or registered trademarks of OMRON Corporation in Japan and other
countries for OMRON factory automation products.

• Microsoft, Windows, Windows Vista, Excel, and Visual Basic 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.

• The SD and SDHC logos are trademarks of SD-3C, LLC.

Other company names and product names in this document are the trademarks or registered trademarks of their
respective companies.

Trademarks

Copyrights

NOTE

Microsoft product screen shots reprinted with permission from Microsoft Corporation.

1

Introduction

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Introduction

Thank you for purchasing an NJ/NX-series CPU Unit or an NY-series Industrial PC.

This manual contains information that is necessary to use the function blocks in the EtherCAT N-Smart
Series Library. (“Function block” is sometimes abbreviated as “FB”.) 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.

This manual provides function block specifications. It does not describe application restrictions or com­bination restrictions for Controllers, Units, and components.

Refer to the user’s manuals for all of the products in the application before you use any of the products.

Keep this manual in a safe place where it will be available for reference during operation.

The EtherCAT N-Smart Series Library is used to back up and restore the parameters for an OMRON
E3NW Sensor Communications Unit (an EtherCAT type). You can use this library to reduce manpower
of programming when implementing the processing for a Sensor Communications Unit.

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.

For the model numbers and versions of an NJ/NX-series CPU Unit, NY-series Industrial PC, and the
Sysmac Studio that this library supports, refer to Sysmac Library Version Information in the SYS-

MAC-XR



Sysmac Library Catalog (Cat. No. P102). This catalog can be downloaded from the

OMRON website (http://www.ia.omron.com/products/family/3459/download/catalog.html).

Features of the Library

Intended Audience

Applicable Products

Manual Structure

2

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Manual Structure

Special information in this manual is classified as follows:

Precautions for Safe Use

Precautions on what to do and what not to do to ensure safe usage of the product.

Precautions for Correct Use

Precautions on what to do and what not to do to ensure proper operation and performance.

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 CPU Units and Industrial PCs
with different unit versions and for different versions of the Sysmac Studio are given.

Note References are provided to more detailed or related information.

Special Information

3

Manual Structure

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

CONTENTS

4

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

CONTENTS

Introduction ..............................................................................................................1

Features of the Library................................................................................................................................. 1

Intended Audience....................................................................................................................................... 1

Applicable Products..................................................................................................................................... 1

Manual Structure ......................................................................................................2

Special Information...................................................................................................................................... 2

CONTENTS................................................................................................................4

Terms and Conditions Agreement ..........................................................................6

Warranty, Limitations of Liability .................................................................................................................. 6

Application Considerations .......................................................................................................................... 7

Disclaimers .................................................................................................................................................. 7

Safety Precautions ..................................................................................................8

Definition of Precautionary Information........................................................................................................ 8

Symbols....................................................................................................................................................... 8

Cautions....................................................................................................................................................... 9

Precautions for Correct Use.................................................................................. 10

Related Manuals ..................................................................................................... 11

Revision History .....................................................................................................14

Procedure to Use Sysmac Libraries..................................................................... 15

Procedure to Use Sysmac Libraries Installed Using the Installer .............................................................. 16

Procedure to Use Sysmac Libraries Uploaded from a CPU Unit or an Industrial PC................................ 20

Common Specifications of Function Blocks ....................................................... 23

Common Variables .................................................................................................................................... 24

Precautions................................................................................................................................................ 30

Individual Specifications of

Function Blocks ....................................................................................................31

Backup_E3NW .......................................................................................................................................... 32

Restore_E3NW.......................................................................................................................................... 45

Appendix .................................................................................................................55

Referring to Library Information ................................................................................................................. 56

Referring to Function Block and Function Source Codes .......................................................................... 59

5

CONTENTS

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Terms and Conditions Agreement

6

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Terms and Conditions Agreement

 Exclusive Warranty

Omron’s exclusive warranty is that the Products will be free from defects in materials and workman­ship for a period of twelve months from the date of sale by Omron (or such other period expressed 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
responsible 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 Companies
shall not be liable for the suitability or unsuitability or the results from the use of Products in combi­nation with any electrical or electronic components, circuits, system assemblies or any other materi­als 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.

See http://www.omron.com/global/ or contact your Omron representative for published information.

OMRON COMPANIES SHALL NOT BE LIABLE FOR SPECIAL, INDIRECT, INCIDENTAL, OR CON­SEQUENTIAL DAMAGES, LOSS OF PROFITS OR PRODUCTION OR COMMERCIAL LOSS IN ANY
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.

Warranty, Limitations of Liability

Warranties

Limitation on Liability; Etc

7

Terms and Conditions Agreement

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

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
Buyer’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 com­plete determination of the suitability of the Product in combination with the end product, machine, sys­tem, or other application or use. Buyer shall be solely responsible for determining appropriateness of
the particular Product with respect to Buyer’s application, product or system. Buyer shall take applica­tion responsibility 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.

Omron Companies shall not be responsible for the user’s programming of a programmable Product, or
any consequence thereof.

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 perfor­mance is subject to the Omron’s Warranty and Limitations of Liability.

Product specifications and accessories may be changed at any time based on improvements and other
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 establish
key specifications for your application. Please consult with your Omron’s representative at any time to
confirm actual specifications of purchased Product.

Information presented by Omron Companies has been checked and is believed to be accurate; how­ever, no responsibility is assumed for clerical, typographical or proofreading errors or omissions.

Application Considerations

Suitability of Use

Programmable Products

Disclaimers

Performance Data

Change in Specifications

Errors and Omissions

Safety Precautions

8

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Safety Precautions

The following notation is used in this user’s manual to provide precautions required to ensure safe
usage of an NJ/NX-series Controller and an NY-series Industrial PC.

The safety precautions that are provided are extremely important to safety. Always read and heed the
information provided in all safety precautions.

The following notation is used.

Definition of Precautionary Information

Symbols

The circle and slash symbol indicates operations that you must not do.

The specific operation is shown in the circle and explained in text.

This example indicates prohibiting disassembly.

The triangle symbol indicates precautions (including warnings).

The specific operation is shown in the triangle and explained in text.

This example indicates a precaution for electric shock.

The triangle symbol indicates precautions (including warnings).

The specific operation is shown in the triangle and explained in text.

This example indicates a general precaution.

The filled circle symbol indicates operations that you must do.

The specific operation is shown in the circle and explained in text.

This example shows a general precaution for something that you must
do.

WARNING

Caution

Indicates a potentially hazardous situation which, if not
avoided, could result in death or serious injury. Addition­ally, there may be severe property damage.

Indicates a potentially hazardous situation which, if not
avoided, may result in minor or moderate injury, or
property damage.

9

Safety Precautions

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Cautions

Caution

Read all related manuals carefully before you use this library.

Emergency stop circuits, interlock circuits, limit circuits, and similar safety measures
must be provided in external control circuits.

Check the user program, data, and parameter settings for proper execution before
you use them for actual operation.

Precautions for Correct Use

10

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Precautions for Correct Use

• When you use the library, functions or function blocks that are not described in the library manual
may be displayed on the Sysmac Studio. Do not use functions or function blocks that are not
described in the manual.

• Do not change the names and the contents of any object list.

• Do not attempt to turn OFF the power supply to the Controller and EtherCAT slaves or stop the Eth­erCAT communications until the processing for this function block ends normally or ends in an error.

• During a restore, do not use the measurement data for the E3NW to control machine operation.

• The sample programming shows only the portion of a program that uses the function or function
block from the library.

• When using actual devices, also program safety circuits, device interlocks, I/O with other devices,
and other control procedures.

• Create a user program that will produce the intended device operation.

• Check the user program for proper execution before you use it for actual operation.

Using the Library

Using Sample Programming

11

Related Manuals

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Related Manuals

The following are the manuals related to this manual. Use these manuals for reference.

Manual name Cat. No. Model numbers Application Description

NX-series CPU Unit

Hardware User’s Manual

W535 NX701- Learning the basic specifi-

cations of the NX-series
NX701 CPU Units, includ­ing introductory information,
designing, installation, and
maintenance. Mainly hard­ware information is pro­vided

An introduction to the entire NX701 CPU Unit
system is provided along with the following infor­mation on the CPU Unit.

Features and system configuration

Overview

Part names and functions

General specifications

Installation and wiring

Maintenance and inspection

NX-series NX102 CPU
Unit Hardware
User’s Manual

W593 NX102- Learning the basic specifi-

cations of the NX102 CPU
Units, including introductory
information, designing,
installation, and mainte­nance. Mainly hardware
information is provided.

An introduction to the entire NX102 system is
provided along with the following information on
the CPU Unit.

Features and system configuration

Introduction

Part names and functions

General specifications

Installation and wiring

Maintenance and Inspection

NX-series NX1P2 CPU
Unit Hardware User’s
Manual

W578 NX1P2- Learning the basic specifi-

cations of the NX-series
NX1P2 CPU Units, includ­ing introductory information,
designing, installation, and
maintenance. Mainly hard­ware information is pro­vided

An introduction to the entire NX1P2 CPU Unit
system is provided along with the following infor­mation on the CPU Unit.

Features and system configuration

Overview

Part names and functions

General specifications

Installation and wiring

Maintenance and Inspection

NJ-series CPU Unit
Hardware User’s Manual

W500 NJ501-

NJ301-

NJ101-

Learning the basic specifi­cations of the NJ-series
CPU Units, including intro­ductory information, design­ing, installation, and
maintenance.

Mainly hardware informa­tion is provided

An introduction to the entire NJ-series system is
provided along with the following information on
the CPU Unit.

Features and system configuration

Overview

Part names and functions

General specifications

Installation and wiring

Maintenance and inspection

NY-series IPC Machine
Controller Industrial
Panel PC Hardware
User’s Manual

W557 NY532- Learning the basic specifi-

cations of the NY-series
Industrial Panel PCs,
including introductory infor­mation, designing, installa­tion, and maintenance.
Mainly hardware informa­tion is provided

An introduction to the entire NY-series system is
provided along with the following information on
the Industrial Panel PC.

Features and system configuration

Introduction

Part names and functions

General specifications

Installation and wiring

Maintenance and inspection

Related Manuals

12

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

NY-series IPC Machine
Controller Industrial Box
PC Hardware User's
Manual

W556 NY512- Learning the basic specifi-

cations of the NY-series
Industrial Box PCs, includ­ing introductory information,
designing, installation, and
maintenance. Mainly hard­ware information is pro­vided

An introduction to the entire NY-series system is
provided along with the following information on
the Industrial Box PC.

Features and system configuration

Introduction

Part names and functions

General specifications

Installation and wiring

Maintenance and inspection

NJ/NX-series CPU Unit
Software User’s Manual

W501 NX701-

NX102-

NX1P2-

NJ501-

NJ301-

NJ101-

Learning how to program
and set up an NJ/NX-series
CPU Unit.

Mainly software informa­tion is provided

The following information is provided on a Con­troller built with an NJ/NX-series CPU Unit.

CPU Unit operation

CPU Unit features

Initial settings

Programming based on IEC 61131-3 language
specifications

NY-series IPC Machine
Controller Industrial
Panel PC / Industrial Box
PC Software User’s
Manual

W558 NY532-

NY512-

Learning how to program
and set up the Controller
functions of an NY-series
Industrial PC

The following information is provided on
NY-series Machine Automation Control Software.

Controller operation

Controller features

Controller settings

Programming based on IEC 61131-3 language
specifications

NJ/NX-series Instruc­tions
Reference Manual

W502 NX701-

NX102-

NX1P2-

NJ501-

NJ301-

NJ101-

Learning detailed specifica­tions on the basic instruc­tions of an NJ/NX-series
CPU Unit

The instructions in the instruction set (IEC
61131-3 specifications) are described.

NY-series Instructions
Reference Manual

W560 NY532-

NY512-

Learning detailed specifica­tions on the basic instruc­tions of an NY-series
Industrial PC

The instructions in the instruction set (IEC
61131-3 specifications) are described.

NJ/NX-series CPU Unit
Motion Control User's
Manual

W507 NX701-

NX102-

NX1P2-

NJ501-

NJ30

1-

NJ101-

Learning about motion con­trol settings and program­ming concepts of an
NJ/NX-series CPU Unit.

The settings and operation of the CPU Unit and
programming concepts for motion control are
described.

NY-series IPC Machine
Controller Industrial
Panel PC / Industrial Box
PC Motion Control
User’s Manual

W559 NY532-

NY512-

Learning about motion con­trol settings and program­ming concepts of an
NY-series Industrial PC.

The settings and operation of the Controller and
programming concepts for motion control are
described.

NJ/NX-series Motion
Control Instructions Ref­erence Manual

W508 NX701-

NX102-

NX1P2-

NJ501-

NJ301-

NJ101-

Learning about the specifi­cations of the motion con­trol instructions of an
NJ/NX-series CPU Unit.

The motion control instructions are described.

NY-series Motion Control
Instructions Reference
Manual

W561 NY532-

NY512-

Learning about the specifi­cations of the motion con­trol instructions of an
NY-series Industrial PC.

The motion control instructions are described.

NJ/NY-series NC Inte­grated Controller User’s
Manual

O030 NJ501-5300

NY532-5400

Performing numerical con­trol with NJ/NY-series Con­trollers.

Describes the functionality to perform the numer­ical control. Use this manual together with the

NJ/NY-series G code Instructions
Reference Manual (Cat. No. O031) when pro-

gramming.

Manual name Cat. No. Model numbers Application Description

13

Related Manuals

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

G code Instructions Ref­erence Manual

O031 NJ501-5300

NY532-5400

Learning about the specifi­cations of the G code/M
code instructions.

The G code/M code instructions are described.
Use this manual together with the NJ/NY-series
NC Integrated Controller User’s Manual (Cat. No.
O030) when programming.

Sysmac Studio Version 1
Operation Manual

W504 SYSMAC

-SE2

Learning about the operat­ing procedures and func­tions of the Sysmac Studio.

Describes the operating procedures of the Sys­mac Studio.

CNC Operator
Operation Manual

O032 SYSMAC

-RTNC0D

Learning an introduction of
the CNC Operator and how
to use it.

An introduction of the CNC Operator, installation
procedures, basic operations, connection opera­tions, and operating procedures for main func­tions are described.

Manual name Cat. No. Model numbers Application Description

Revision History

14

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Revision History

A manual revision code appears as a suffix to the catalog number on the front and back covers of the
manual.

Revision code Date Revised content

01 April 2015 Original production
02 December 2015 Corrected mistakes.
03 July 2016 • Added compatible models.

• Changed the manual name.
04 November 2016 Changed the manual name.
05 March 2017 Added compatible models.
06 January 2019 Added compatible models.

W549-E1-06

Revision code

Cat. No.

15

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Procedure to Use Sysmac Libraries

Procedure to Use Sysmac Libraries Installed Using the Installer

16

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Procedure to Use Sysmac Librar­ies Installed Using the Installer

This section describes the procedure to use Sysmac Libraries that you installed using the installer.

There are two ways to use libraries.

• Using newly installed Sysmac Libraries

• Using upgraded Sysmac Libraries

Version Information

To use Sysmac Libraries, you need the Sysmac Studio version 1.14 or higher.

1 Start the Sysmac Studio and open or create a new project in which you want to use Sysmac

Libraries.

Precautions for Correct Use

If you create a new project, be sure to configure the settings as follows to enable the use of
Sysmac Libraries. If you do not configure the following settings, you cannot proceed to the step
2 and later steps.

• Set the project type to Standard Project or Library Project.

• Set the device category to Controller.

• Set the device version to 1.01 or later.

Using Newly Installed Libraries

17

Procedure to Use Sysmac Libraries Installed Using the Installer

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

2 Select Project – Library – Show References.

Precautions for Correct Use

If you have more than one registered device in the project, make sure that the device selected
currently is an NJ/NX-series CPU Unit or an NY-series Industrial PC. If you do not select an
NJ/NX-series CPU Unit or an NY-series Industrial PC as the device, Library References does
not appear in the above menu. When the device selected currently is an NJ/NX-series CPU

Unit or an NY-series Industrial PC, the device icon is displayed in the Multiview Explorer.

3 Add the desired Sysmac Library to the list and click the OK Button.

The Sysmac Library file is read into the project.

Now, when you select the Ladder Editor or ST Editor, the function blocks and functions included
in a Sysmac Library appear in the Toolbox.

For the procedure for adding and setting libraries in the above screen, refer to the Sysmac Stu-
dio Version 1 Operation Manual (Cat. No. W504).

4 Insert the Sysmac Library’s function blocks and functions into the circuit using one of the follow-

ing two methods.

• Select the desired function block or function in the Toolbox and drag and drop it onto the pro­gramming editor.

Device

Drug & Drop

Procedure to Use Sysmac Libraries Installed Using the Installer

18

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• Right-click the programming editor, select Insert Function Block in the menu, and enter the
fully qualified name (\\name of namespace\name of function block).

Precautions for Correct Use

After you upgrade the Sysmac Studio, check all programs and make sure that there is no error
of the program check results on the Build Tab Page.

Select Project

– Check All Programs from the Main Menu.

1 Start the Sysmac Studio and open a project in which any old-version Sysmac Library is

included.

2 Select Project – Library – Show References.

Precautions for Correct Use

If you have more than one registered device in the project, make sure that the device selected
currently is an NJ/NX-series CPU Unit or an NY-series Industrial PC. Otherwise, Library Refer­ences does not appear in the above menu. When the device selected currently is an

NJ/NX-series CPU Unit or an NY-series Industrial PC, the device icon is displayed in the
Multiview Explorer.

3 Select an old-version Sysmac Library and click the Delete Reference Button.

Using Upgraded Libraries

Device

19

Procedure to Use Sysmac Libraries Installed Using the Installer

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

4 Add the desired Sysmac Library to the list and click the OK Button.

Procedure to Use Sysmac Libraries Uploaded from a CPU Unit or an Industrial PC

20

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Procedure to Use Sysmac Librar­ies Uploaded from a CPU Unit or
an Industrial PC

You can use Sysmac Libraries uploaded from a CPU Unit or an Industrial PC to your computer if they
are not installed.

The procedure to use uploaded Sysmac Libraries from a CPU Unit or an Industrial PC is as follows.

Version Information

To use Sysmac Libraries, you need the Sysmac Studio version 1.14 or higher.

1 Start the Sysmac Studio and create a new project in which you want to use Sysmac Libraries.

2 Connect the computer to the CPU Unit or the Industrial PC and place it online.
3 Upload POUs in which any Sysmac Library is used to the computer.

Now, when you select the Ladder Editor or ST Editor, the function blocks and functions included
in the Sysmac Library used in the uploaded POUs appear in the Toolbox.

4 Insert the Sysmac Library’s function blocks and functions into the circuit using one of the follow-

ing two methods.

• Select the desired function block or function in the Toolbox and drag and drop it onto the Lad­der Editor.

Drug & Drop

21

Procedure to Use Sysmac Libraries Uploaded from a CPU Unit or an Industrial PC

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• Right-click the programming editor, select Insert Function Block in the menu, and enter the
fully qualified name (\\name of namespace\name of function block).

Precautions for Correct Use

• The Sysmac Studio installs library files of the uploaded Sysmac Stutio to the specified folder
on the computer if they are not present. However, the Sysmac Studio does not install library
files to the specified folder on the computer if they are present.

The specified folder here means the folder in which library files are installed by the installer.

• Note that uploading Sysmac Libraries from a CPU Unit or an Industrial PC does not install
the manual and help files for the Sysmac Libraries, unlike the case where you install then
using the installer. Please install the manual and help files using the installer if you need
them.

Procedure to Use Sysmac Libraries Uploaded from a CPU Unit or an Industrial PC

22

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

23

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Common Specifications of Function Blocks

Common Variables

24

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Common Variables

This section describes the specifications of variables (EN, Execute, Enable, Abort, ENO, Done, Cal­cRslt, Enabled, Busy, CommandAborted, Error, ErrorID, and ErrorIDEx) that are used for more than

one function or function block. The specifications are described separately for functions, for exe­cute-type function blocks, and for enable-type function blocks.

Common input variables and output variables used in functions and function blocks are as follows.

Definition of Input Variables and Output Variables

Var iab le I/O

Data
type

Function/function

block type to use

Meaning DefinitionFunction block

Function

Execute-

type

Enable-

type

EN Input BOOL OK Execute The processing is executed while the

variable is TRUE.

Execute OK Execute The processing is executed when the

variable changes to TRUE.

Enable OK Run The processing is executed while the

variable is TRUE.

Abort BOOL OK Abort The processing is aborted.

You can select the aborting method.

25

Common Variables

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• Processing starts when Execute changes to TRUE.

• When Execute changes to TRUE, Busy also changes to TRUE. When processing is completed nor­mally, Busy changes to FALSE and Done changes to TRUE.

• When continously executes the function blocks of the same instance, change the next Execute to
TRUE for at least one task period after Done changes to FALSE in the previous execution.

• If the function block has a CommandAborted (Instruction Aborted) output variable and processing is
aborted, CommandAborted changes to TRUE and Busy changes to FALSE.

• If an error occurs in the function block, Error changes to TRUE and Busy changes to FALSE.

• For function blocks that output the result of calculation for motion control and temperature control,
you can use the BOOL input variable Abort to abort the processing of a function block. When Abort
changes to TRUE, CommandAborted changes to TRUE and the execution of the function block is
aborted.

ENO Output BOOL OK Done The variable changes to TRUE when the

processing ends normally.

It is FALSE when the processing ends in
an error, the processing is in progress, or
the execution condition is not met.

Done BOOL OK Done The variable changes to TRUE when the

processing ends normally.

It is FALSE when the processing ends in
an error, the processing is in progress, or
the execution condition is not met.

Busy BOOL OK OK Executing The variable is TRUE when the process-

ing is in progress.

It is FALSE when the processing is not in
progress.

CalcRslt LREAL OK Calculation

Result

The calculation result is output.

Enabled BOOL OK Enabled The variable is TRUE when the output is

enabled. It is used to calculate the con­trol amount for motion control, tempera-

ture control, etc.
Command
Aborted

BOOL OK Command

Aborted

The variable changes to TRUE when the

processing is aborted.

It changes to FALSE when the process-

ing is re-executed the next time.
Error BOOL OK OK Error This variable is TRUE while there is an

error.

It is FALSE when the processing ends

normally, the processing is in progress,

or the execution condition is not met.
ErrorID WORD OK OK Error Code An error code is output.
ErrorIDEx DWORD OK OK Expansion

Error Code

An expansion error code is output.

Execute-type Function Blocks

Varia ble I/O

Data
type

Function/function

block type to use

Meaning DefinitionFunction block

Function

Execute-

type

Enable-

type

Common Variables

26

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• If Execute is TRUE and Done, CommandAborted, or Error changes to TRUE, Done, Command­Aborted, and Error changes to FALSE when Execute is changed to FALSE.

• If Execute is FALSE and Done, CommandAborted, or Error changes to TRUE, Done,Command­Aborted, and Error changes to TRUE for only one task period.

• If an error occurs, the relevant error code and expansion error code are set in ErrorID (Error Code)
and ErrorIDEx (Expansion Error Code). The error codes are retained even after Error changes to
FALSE, but ErrorID is set to 16#0000 and ErrorIDEx is set to 16#0000 0000 when Execute changes
to TRUE.

This section provides timing charts for a normal end, aborted execution, and errors.

 Normal End

 Canceled Execution

Timing Charts

In-out variables

Input variables

In-out variables

Output variables

Abcd_instance

InOut_Val InOut_Val

Error

ErrorID

ErrorIDEx

CommandAborted

Abcd

Execute Done

Busy

Busy

Done

CommandAborted

Error

16#00000000

16#0000

ErrorID

ErrorIDEx

Execute

Busy

Abort

CommandAborted

Error

16#00000000

16#0000

ErrorID

ErrorIDEx

Execute

27

Common Variables

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 Aborted Execution

 Errors

Busy

Done

CommandAborted

Error

16#00000000

16#0000

ErrorID

ErrorIDEx

Execute

Busy

Done

CommandAborted

Error

16#0000 16#0000

ErrorID

16#00000000 16#00000000ErrorIDEx ErrorIDEx

ErrorIDEx

Execute

ErrorIDErrorIDErrorID ErrorID

Common Variables

28

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• Processing is executed while Enable is TRUE.

• When Enable changes to TRUE, Busy also changes to TRUE. Enabled is TRUE during calculation of
the output value.

• If an error occurs in the function block, Error changes to TRUE and Busy and Enabled change to
FALSE. When Enable changes to FALSE, Enabled, Busy, and Error change to FALSE.

• If an error occurs, the relevant error code and expansion error code are set in ErrorID (Error Code)
and ErrorIDEx (Expansion Error Code). The error codes are retained even after Error changes to
FALSE, but ErrorID is set to 16#0000 and ErrorIDEx is set to 16#0000 0000 when Enable changes to
TRUE.

• For function blocks that calculate the control amount for motion control, temperature control, etc.,
Enabled is FALSE when the value of CalcRslt (Calculation Result) is incorrect. In such a case, do not
use CalcRslt. In addition, after the function block ends normally or after an error occurs, the value of
CalcRslt is retained until Enable changes to TRUE. The control amount will be calculated based on
the retained CalcRslt value, if it is the same instance of the function block that changed Enable to
TRUE. If it is a different instance of the function block, the control amount will be calculated based on
the initial value.

This section provides timing charts for a normal end and errors.

 Normal End

Enable-type Function Blocks

Timing Charts

In-out variables

Input variables

In-out variables

Output variables

Abcd_instance

InOut_Val InOut_Val

Busy
Error

ErrorID

Abcd

Enable Enabled

CalcRslt

ErrorIDEx

Busy

Enabled

Error

16#00000000

16#0000

ErrorID

ErrorIDEx

Enable

CalcRslt

Retained

Retained

29

Common Variables

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 Errors

Busy

Enabled

Error

16#000016#0000 16#0000

ErrorID

ErrorIDEx

Enable

ErrorIDErrorIDErrorID ErrorID

16#00000000

16#00000000

ErrorIDErrorIDErrorID ErrorID

16#0000

CalcRslt

Retained

Retained

Precautions

30

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Precautions

This section provides precautions for the use of this function block.

You can nest calls to this function block for up to four levels.

For details on nesting, refer to the CPU Unit software user’s manual.

You cannot use the upward differentiation option for this function block.

Execute-type function blocks cannot be re-executed by the same instance.

If you do so, the output value will be the initial value.

For details on re-execution, refer to the CPU Unit motion control user’s manual.

Nesting

Instruction Options

Re-execution of Function Blocks

31

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Individual Specifications of

Function Blocks

Function block name Name Page

Backup_E3NW E3NW Parameter Backup P.32

Restore_E3NW E3NW Parameter Restore P.45

Backup_E3NW

32

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Backup_E3NW

The Backup_E3NW function block backs up the parameters for the Sensor Amplifier Unit that is con­nected to an E3NW-ECT Sensor Communications Unit or E3NW-DS Distributed Sensor Unit and
stores them on the SD Memory Card inserted into the Controller.

Hereinafter, E3NW-ECT Sensor Communications Units and E3NW-DS Distributed Sensor Units are
collectively referred to as E3NW Units.

Function block

name

Name

FB/

FUN

Graphic expression ST expression

Backup_E3NW E3NW Parameter

Backup

FB Backup_E3NW_instance(

Execute,
NodeAdr,
DirName,
OverWrite,
TimeOut,
Done,
Busy,
SdoBusy,
Error,
ErrorID,
ErrorIDEx);

Function Block and Function Information

Item Description

Library file name OmronLib_EC_E3NW_V1_2.slr
Namespace OmronLib\EC_E3NW
Function block and function number 00015
Source code published/not published Not published
Function block and function version 1.10

Compatible Models

Item Name Model numbers Versi on

Device

Sensor Communications Unit E3NW-ECT

Version 1.03 or later

*1

*1. Version 1.06 or later is required to use a Color Fiber Amplifier (E3NX-CA0)

Distributed Sensor Unit E3NW-DS --­Smart Laser Amplifier Unit E3NC-LA0 --­Smart Laser (CMOS) Amplifier
Unit

E3NC-SA0 ---

Smart Fiber Amplifier Unit E3NX-FA0 --­Contact-Type Smart Amplifier
Unit

E9NC-TA0 ---

Color Fiber Amplifier E3NX-CA0 --­SD Memory Card HMC-SD ---

NodeAdr

DirName

OverWrite

TimeOut

Execute

Backup_E3NW_instance

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

Done

\\OmronLib\EC_E3NW\Backup_E3NW

33

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Variables

Name Meaning I/O Description Valid range Unit Default

Execute Execute Input

TRUE: Executes the instruction.

FALSE: Does not execute the
instruction.

TRUE or
FALSE

---

FAL SE

NodeAdr

Slave Node
Address

Input Specifies the node address.

1 to 512

*1

*1. The valid range is 1 to 192 for NJ-series CPU Units.

1

DirName Directory Name Input

Specifies the directory on the SD
Memory Card. A backup file will
be created in this directory.

40 bytes max.

*2

*2. If DirName is omitted, this specifies the root directory on the SD Memory Card.

OverWrite Overwrite Enable Input

TRUE: Enables overwrite.

FALSE: Prohibits overwrite.

TRUE or
FALSE

FAL SE

TimeOut Timeout Time Input

0: 2.0 s

1 to 65535: 0.1 to 6553.5 s

0 to 65535 0.1 s

0

(2.0 s)

Done Done Output

TRUE: Normal end

FALSE: Error end, execution in
progress, or execution condition
not met

TRUE or
FALSE

---

---

Busy Executing Output

TRUE: Execution processing is in
progress.

FALSE: Execution processing is
not in progress.

TRUE or
FALSE

---

SdoBusy

Processing Sdo
Communications

Output

This flag is TRUE when an SDO
communications command is

sent to an E3NW Unit.

*3

*3. You can use it to identify that communications processing is in progress.

TRUE or
FALSE

---

Error Error Output

TRUE: Error end

FALSE: Normal end, execution in
progress, or execution condition
not met

TRUE or
FALSE

---

ErrorID Error Code Output

This is the error ID for an error
end.

The value is WORD#16#0 for a
normal end.

*4

*4. For details, refer to Troubleshooting on page 38.

---

ErrorIDEx

Expansion Error
Code

Output

This is the error ID for an Expan­sion Unit Hardware Error.

The value is DWORD#16#0 for a
normal end.

*4

---

Backup_E3NW

34

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Name

Bo
ole

an

Bit strings Integers

Real

num-

bers

Times, durations,

dates, and text strings

BOOL

BYTE

WORD

DWORD

LWORD

USINT

UINT

UDINT

ULINT

SINT

INT

DINT

LINT

REAL

LREAL

TIME

DATE

TOD

DT

STRING

Execute

OK

NodeAdr OK

DirName OK
OverWrite OK
TimeOut OK
Done OK
Busy OK
SdoBusy OK
Error OK
ErrorID OK
ErrorIDEx OK

35

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• The Backup_E3NW function block reads parameters for the E3NW Unit at the node address speci­fied with NodeAdr (Node Address) when Execute changes to TRUE and creates a backup file in the
directory specified with DirName (Directory Name) on the SD Memory Card.

• To use this function block, you need to create in advance a directory named OM_ObjList\Sensor in
the root directory on the SD Memory Card and store object lists provided by OMRON in it. Be sure to
store all the object list files. Then, access the object lists to back up the parameters with this function
block.

• Object lists provided by OMRON are installed in ‘C:\OMRON\Data\Attachement’ when libraries are
installed. Extract the ZIP file for the applicable series and save the files in an SD memory card.

• A backup file is binary data that has the name “BackupFile_Node

.Bin.” Here,  is a

slave node address in decimal (e.g., 00001 for Node 1).

• If the directory specified with DirName (Directory Name) does not exist, the function block creates a
new directory with the specified directory name. If DirName (Directory Name) is omitted, the function
block assumes that the root directory on the SD Memory Card is specified.

Function

EtherCAT

CPU Unit or Industrial PC

Sensor Communications
Unit

Sensor Amplifier Unit

Node1, version 1.00 Node10

E3NW-ECT

SD Memory Card

Root directory

Directory: OM_ObjList

Directory: Sensor

ObjList_E3NW-ECT_Rev00010000.Bin

ObjList_E3NW-ECT_Rev00010002.Bin

. . . . .

BackupFile_Node00001.Bin

Directory: DirName



E3NX-FA0



E3NC-LA0



E3NC-SA0

Backup_E3NW

36

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 Procedure

1 Create a directory named OM_ObjList\Sensor in the root directory on the SD Memory Card and

store all the object lists provided by OMRON in it.

2 Execute the function block.

For NodeAdr (Slave Node Address), specify the node address of the backup target slave.

If necessary, set DirName (Directory Name) and TimeOut (Timeout Time).

3 A backup file is created in the directory specified with DirName (Directory Name) when execu-

tion of the function block is ended.

The following figures show the timing charts for the function block.

• Busy (Executing) changes to TRUE when Execute changes to TRUE.

• When backup file creation is ended, Done changes to TRUE.

• If an error occurs when execution of the function block is in progress, Error changes to TRUE and
Busy (Executing) changes to FALSE.

You can find out the cause of the error by accessing the values output to ErrorID (Error Code) and
ErrorIDEx (Expansion Error Code).

• If Execute changes to FALSE before execution of the function block is ended, Done and Error are
TRUE only for one task period after execution of the function block is ended.

• If Execute remains TRUE even after execution of the function block is ended, the output values of
Done and Error are held.

 Timing Chart for Normal End

Timing Charts

Scan

#0000

#00000000 # 00 000000 #00000000 #00000000

#0000 #0000 #0000

1

Execute

Done

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

2

3

45678

9

10 11

37

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 Timing Chart for Error End

• An object list is binary data that stores, by the revision number of EtherCAT slaves, SDO parameter
information (Index, Subindex, and Complete Access) for the backup target parameters.

• For information on the characters that can be used in DirName, refer to Specifications of Supported SD
Memory Cards, Folders, and Files in the software user’s manual.

• In backup or restore processing, the value of SdoBusy is TRUE when data objects are being sent.
The value of SdoBusy is FALSE when data objects are not being sent due to the internal processing
of the function block.

• Execution of this function block will be continued until processing is ended even if the value of Exe-
cute changes to FALSE or the execution time exceeds the task period. The value of Done changes to
TRUE when processing is ended. Use this to confirm normal ending of processing.

• This function block executes one EC_CoESDORead instruction within the part. Refer to the
EC_CoESDORead instruction in the instructions reference manual for the maximum number of
instructions that can be executed at the same time.

• An error will occur in the following cases. Error will change to TRUE.

a) No object list file exists.

b) The EtherCAT master is not in a state that allows message communications.

c) The slave specified with NodeAdr does not exist.

d) The slave specified with NodeAdr is not in a state that allows communications.

e) The slave is not in a state that allows reading of parameters.

f) The EC_CoESDORead instruction exceeded the maximum number of instructions that can be

executed at the same time.

g) SD Memory Card access failed (no SD Memory Card inserted, write protection enabled, etc.).

Precautions for Correct Use

• Do not execute the same instance while an instance is being executed.

• Do not execute restore for slaves from which parameters are being backed up.

• Do not change the names and the contents of any object list.

• Do not attempt to turn OFF the power supply to the Controller and EtherCAT slaves or stop
the EtherCAT communications until the processing for this function block ends normally or
ends in an error.

Additional Information

Precautions for Correct Use

Scan

Execute

Done

Done

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

1234567891011

#0000

#00000000 ErrorIDEx #00000000 ErrorIDEx

ErrorID #0000 ErrorID

Backup_E3NW

38

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Related System-defined Variables

Name Meaning Data type Description

_Card1Ready

SD Memory Card
Ready Flag

BOOL

TRUE when the SD Memory Card is
recognized. It is FALSE when the SD
Memory Card is not recognized.

TRUE: Can be used.

FALSE: Cannot be used.

_EC_MBX_SlavTbl

Message Communica­tions Enabled Slave
Ta bl e

Array[1..512] OF BOOL

This table indicates the slaves that
can perform message communica­tions. Slaves are given in the table in
the order of slave node addresses.

TRUE: Message communications
are possible.

FALSE: Message communications
are not possible.

Troubleshooting

Error code

Expansion
error code

Status Description Correction

16#0000 16#00000000 Normal End --- --­16#3C0F 16#00000001 VenderID Not

Matched

The VenderID in object lists
does not match the VenderID of
the backup target node.

Use object lists that match the
VenderID of the backup target
node.

16#3C0F 16#00000002 ProductCode

Not Matched

The ProductCode in object lists
does not match the Product­Code of the backup target
node.

Use object lists that match the
ProductCode of the backup tar­get node.

16#3C0F 16#00000003 Unsupported

Sensor Amplifier
Unit

A Sensor Amplifier Unit that is
not supported by this function
block is connected.

Check that the Sensor Ampli­fier Unit is supported by this
function block.

16#3C0F 16#00000004 Unsupported

Device

The device is not supported by
this function block.

Check that the specified device
is an E3NW Unit.

16#0400 16#00000000 Input Value Out

of Range

The value of NodeAdr is out of
range.

Set the value of NodeAdr cor-

rectly.
The directory name specified
with DirName contains one or
more characters that cannot be
used.

Set DirName correctly.

The directory name specified
with DirName is too long.

Check the length of the direc-

tory name specified with Dir-

Name and set it to within the

valid range.

16#1400 16#00000000 SD Memory

Card Access
Failure

An SD Memory Card is either
not inserted or is not inserted
properly.

Insert an SD Memory Card cor-

rectly.

The SD Memory Card is bro­ken.

Replace the SD Memory Card

with one that operates nor-

mally.
The SD Memory Card slot is
broken.

If this error persists even after

making the above two correc-

tions, replace the CPU Unit or

the Industrial PC.

39

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

16#1401 16#00000000 SD Memory

Card Write-pro­tected

An attempt was made to write
to a write-protected SD Mem­ory Card.

Remove write protection from
the SD Memory Card. Slide the
small switch on the side of the
SD Memory Card from the
LOCK position to the writable
position.

16#1402 16#00000000 SD Memory

Card Insufficient
Capacity

The SD Memory Card ran out
of free space.

Replace the SD Memory Card
for one with sufficient available
capacity.

16#1403 16#00000000 File Does Not

Exist

Object lists are not stored. Check the SD Memory Card

and store correct object lists on
it.

16#1405 16#00000000 File Already in

Use

An instruction attempted to
read or write a file already
being accessed by another
instruction.

Correct the user program so
that this function block is exe­cuted only when the Busy out-
put variable for all other
instructions for the same file is
FALSE.

16#1409 16#00000000 That File Name

Already Exists

The backup file exists on the
SD Memory Card when Over-
Write is FALSE.

Change the directory in which
to store the backup file. Or,
delete the existing backup file
in advance.

16#140A 16#00000000 Write Access

Denied

The file or directory specified
for the function block to write is
write-protected.

Remove write protection from
the file or directory specified for
the function block.Or, change
the file name of the file to write.

16#140B 16#00000000 Too Many Files

Open

The maximum number of open
files was exceeded when open­ing a file for the function block.

Correct the user program to
decrease the number of open
files.

16#140E 16#00000000 SD Memory

Card Access
Failed

The SD Memory Card is bro­ken.

Replace the SD Memory Card.

The SD Memory Card slot is
broken.

If this error occurs even after
making the above correction,
replace the CPU Unit or the
Industrial PC.

16#1800 16#00000000 EtherCAT Com-

munications
Error

The EtherCAT network is not in
a usable status.

Check the operation status of
the EtherCAT network by
checking the status of the Eth­erCAT master. Use this infor­mation to correct the cause of
the problem.

16#1801 16#00000000 EtherCAT Slave

Does Not
Respond

The target slave does not exist. Specify an existing node

address.
The target slave is not in an
operating condition.

Check the status of the target

EtherCAT slave. Make sure

that the target slave is in a

usable status.

16#1802 16#00000000 EtherCAT Time-

out

Communications with the target
slave timed out.

Check the operating status of

the target slave and correct the

cause of the problem.

16#1803 16#00000000 Reception Buf-

fer Overflow

The receive data from an Eth­erCAT slave overflowed the
receive buffer.

Set the size of the reception

buffer to a value larger than the

size of the receive data from

the slave.

Error code

Expansion

error code

Status Description Correction

Backup_E3NW

40

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Precautions for Correct Use

• The sample programming shows only the portion of a program that uses the function or func­tion block from the library.

• When using actual devices, also program safety circuits, device interlocks, I/O with other
devices, and other control procedures.

• Create a user program that will produce the intended device operation.

• Check the user program for proper execution before you use it for actual operation.

This is an example of programming for backing up and then restoring parameters for the E3NW Unit at
node address 1.

• The backup file is created in the TestDir directory.

• The backup file is write-protected (default).

• The timeout time is 2 s (default).

1 Make sure that the target slave is in a state that allows communications, that SD Memory Card

Ready Flag is TRUE, and that SD Memory Card Write Protected Flag is FALSE (not write pro-

tected). Also confirm that the same instance is not being executed and that parameters are not
being restored to the same node.

2 Execute BACKUP_E3NW_instance.

1 Make sure that the target slave is in a state that allows communications, that SD Memory Card

Ready Flag is TRUE, that the same instance is not being executed, and that parameters are not
being backed up from the same node.

2 Execute RESTORE_E3NW_instance.

16#1804 SDO Abort

Code

*1

SDO Abort Error The cause of this error

depends on the specifications
of the EtherCAT slave.

Refer to the manual for the Eth­erCAT slave and correct the
problem.

16#1808 16#00000000 Communica-

tions Resource
Overflow

More than 32 EtherCAT com­munications instructions were
executed at the same time.

Correct the user program so
that no more than 32 EtherCAT
communicat16#1ions instruc­tions are executed at the same
time.

*1. An SDO abort code is shown here. Refer to SDO Abort Codes in the instructions reference manual for a list of SDO abort

codes.

Sample Programming

Conditions

Backup Processing

Restore Processing

Error code

Expansion
error code

Status Description Correction

41

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 External Variables

 Internal Variables

LD

Varia ble Data type Constant Comment

_EC_MBXSlavTbl

ARRAY[1..N *1] OF BOOL

*1. N = 192 for NJ501, NJ301 and NJ101. N = 512 for NX701.



Message Communications
Enabled Slave Table

_Card1Ready BOOL  SD Memory Card Ready Flag

Name Data type Default Comment

BACKUP_E3NW_instance OmronLib\EC_E3NW\Backup_E3NW
RESTORE_E3NW_instance OmronLib\EC_E3NW\Restore_E3NW
InitTrigger BOOL FALSE
BackupTrigger BOOL FALSE Backup execution condition
RestoreTrigger BOOL FALSE Restore execution condition
TargetSlave UINT 1 Target slave node Address
TargetDirectory STRING[41] '' SD card directory
TargetTimeOut UINT 0 Time out value
BackupBusy BOOL
RestoreBusy BOOL
BackupOperating BOOL Backup processing
RestoreOperating BOOL Restore processing

BackupOperatingEnd BOOL

Backup processing

completed

RestoreOperatingEnd BOOL

Restore processing

completed
RS_Backup_instance RS
RS_Restore_instance RS

Backup_E3NW

42

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

43

Backup_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 External Variables

 Internal Variables

// Backup and Resotre parameters setting.
IF InitTrigger=FALSE THEN

TargetSlave:=1;
TargetDirectory:='TestDir';
TargetTimeOut:=0;
InitTrigger:=TRUE;

END_IF;

// Detect when BackupTrigger changes to TRUE.
IF ( (BackupTrigger=TRUE) AND (BackupLastTrigger=FALSE) AND

(_EC_MBXSlavTbl[TargetSlave]=TRUE) AND
(_Card1Ready=TRUE) AND (BackupBusy=FALSE) AND

(RestoreBusy=FALSE) ) THEN
BackupOperatingStart:=TRUE;
BackupOperating :=TRUE;

END_IF;
BackupLastTrigger:=BackupTrigger;

// Initialize Backup_E3NW instruction.
IF (BackupOperatingStart=TRUE) THEN

BACKUP_E3NW_instance(

Execute :=FALSE);

BackupOperatingStart:=FALSE;

END_IF;
// Execute Backup_E3NW instruction.

ST

Varia ble Data type Constant Comment

_EC_MBXSlavTbl

ARRAY[1..N *1] OF BOOL

*1. N = 192 for NJ501, NJ301 and NJ101. N = 512 for NX701.



Message Communications
Enabled Slave Table

_Card1Ready BOOL  SD Memory Card Ready Flag

Name Data type Default Comment

BACKUP_E3NW_instance OmronLib\EC_E3NW\Backup_E3NW
RESTORE_E3NW_instance OmronLib\EC_E3NW\Restore_E3NW
InitTrigger BOOL FALSE
BackupTrigger BOOL FALSE Backup execution condition
RestoreTrigger BOOL FALSE Restore execution condition
TargetSlave UINT 1 Target slave node Address
TargetDirectory STRING[41] '' SD card directory
TargetTimeOut UINT 0 Time out value
BackupBusy BOOL FALSE
RestoreBusy BOOL FALSE

BackupLastTrigger BOOL FALSE

Value of BackupTrigger from
previous task

RestoreLastTrigger BOOL FALSE

Value of RestoreTrigger from

previous task
BackupOperating BOOL FALSE Backup processing
RestoreOperating BOOL FALSE Restore processing
BackupOperatingStart BOOL FALSE Backup processing started
RestoreOperatingStart BOOL FALSE Restore processing started

Backup_E3NW

44

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

IF (BackupOperating=TRUE) THEN

BACKUP_E3NW_instance(

Execute :=TRUE,
NodeAdr:=TargetSlave,
DirName:=TargetDirectory,
OverWrite:=FALSE,
TimeOut:=TargetTimeOut,
Busy=>BackupBusy);

IF (BACKUP_E3NW_instance.Done=TRUE) THEN

// Processing after normal end.

BackupOperating:=FALSE;
END_IF;
IF (BACKUP_E3NW_instance.Error=TRUE) THEN

// Processing after error end.

BackupOperating:=FALSE;
END_IF;

END_IF;

// Detect when RestoreTrigger changes to TRUE.
IF ( (RestoreTrigger=TRUE) AND (RestoreLastTrigger=FALSE) AND

(_EC_MBXSlavTbl[TargetSlave]=TRUE) AND
(_Card1Ready=TRUE) AND (BackupBusy=FALSE) AND

(RestoreBusy=FALSE) ) THEN
RestoreOperatingStart:=TRUE;
RestoreOperating :=TRUE;

END_IF;
RestoreLastTrigger:=RestoreTrigger;

// Initialize Restore_E3NW instruction.
IF (RestoreOperatingStart=TRUE) THEN

RESTORE_E3NW_instance(

Execute :=FALSE);

RestoreOperatingStart:=FALSE;

END_IF;
// Execute Restore_E3NW instruction.
IF (RestoreOperating=TRUE) THEN

RESTORE_E3NW_instance(

Execute :=TRUE,
NodeAdr:=TargetSlave,
DirName:=TargetDirectory,
NoProductChk:=FALSE,
TimeOut:=TargetTimeOut,
Busy=>RestoreBusy);

IF (RESTORE_E3NW_instance.Done=TRUE) THEN

// Processing after normal end.

RestoreOperating:=FALSE;
END_IF;
IF (RESTORE_E3NW_instance.Error=TRUE) THEN

// Processing after error end.

RestoreOperating:=FALSE;
END_IF;

END_IF;

45

Restore_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Restore_E3NW

The Restore_E3NW function block restores the backup data on the SD Memory Card to the Sensor
Amplifier Unit that is connected to an E3NW-ECT Sensor Communications Unit or E3NW-DS Distrib­uted Sensor Unit.

Hereinafter, E3NW-ECT Sensor Communications Units and E3NW-DS Distributed Sensor Units are
collectively referred to as E3NW Units.

Function block

name

Name

FB/

FUN

Graphic expression ST expression

Restore_E3NW E3NW Parameter

Restore

FB Restore_E3NW_instance(

Execute,
NodeAdr,
DirName,
NoProductChk,
TimeOut,
Done,
Busy,
SdoBusy,
Error,
ErrorID,
ErrorIDEx);

Function Block and Function Information

Item Description

Library file name OmronLib_EC_E3NW_V1_2.slr
Namespace OmronLib\EC_E3NW
Function block and function number 00016
Source code published/not published Not published
Function block and function version 1.10

Compatible Models

Item Name Model numbers Versio n

Device

Sensor Communications Unit E3NW-ECT

Version 1.03 or later

*1

*1. Version 1.06 or later is required to use a Color Fiber Amplifier (E3NX-CA0)

Distributed Sensor Unit E3NW-DS --­Smart Laser Amplifier Unit E3NC-LA0 --­Smart Laser (CMOS) Amplifier Unit E3NC-SA0 --­Smart Fiber Amplifier Unit E3NX-FA0 --­Contact-Type Smart Amplifier Unit E9NC-TA0 --­Color Fiber Amplifier E3NX-CA0 --­SD Memory Card HMC-SD ---

Restore_E3NW_instance

NodeAdr

DirName

NoProductChk

TimeOut

Execute

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

Done

\\OmronLib\EC_E3NW\Restore_E3NW

Restore_E3NW

46

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Variables

Name Meaning I/O Description Valid rang e Unit Default

Execute Execute Input

TRUE: Executes the instruction.

FALSE: Does not execute the
instruction.

TRUE or
FALSE

---

FALSE

NodeAdr

Slave Node
Address

Input Specifies the node address.

1 to 512

*1

*1. The valid range is 1 to 192 for NJ-series CPU Units.

1

DirName Directory Name Input

Specifies the directory on the SD
Memory Card. The backup file(s)
stored in this directory will be
restored.

40 bytes max.

*2

*2. If DirName is omitted, this specifies the root directory on the SD Memory Card.

NoPro­ductChk

Product Code
Check

Input

This function block does not use
this variable.

TRUE or
FALSE

FALSE

TimeOut Timeout Time Input

0: 2.0 s

1 to 65535: 0.1 to 6553.5 s

0 to 65535 0.1 s

0

(2.0 s)

Done Done Output

TRUE: Normal end

FALSE: Error end, execution in
progress, or execution condition
not met

TRUE or
FALSE

---

---

Busy Executing Output

TRUE: Execution processing is in
progress.

FALSE: Execution processing is
not in progress.

TRUE or
FALSE

---

SdoBusy

Processing Sdo
Communications

Output

This flag is TRUE when an SDO
communications command is

sent to an E3NW Unit.

*3

*3. You can use it to identify that communications processing is in progress.

TRUE or
FALSE

---

Error Error Output

TRUE: Error end

FALSE: Normal end, execution in
progress, or execution condition
not met

TRUE or
FALSE

---

ErrorID Error Code Output

This is the error ID for an error
end.

The value is WORD#16#0 for a
normal end.

*4

*4. For details, refer to Troubleshooting on page 51.

---

ErrorIDEx

Expansion Error
Code

Output

This is the error ID for an Expan­sion Unit Hardware Error.

The value is DWORD#16#0 for a
normal end.

*4

---

47

Restore_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• When Execute changes to TRUE, the Restore_E3NW function block restores the backup file(s) in the
directory specified with DirName (Directory Name) on the SD Memory Card to each Sensor Amplifier
Unit that is connected to the E3NW Unit specified with NodeAdr (Node Address).

• Before you restore a file, use the Backup_E3NW function block to create one or more backup files.

• The backup file stored at the node address specified with NodeAdr (Node Address) is the restore tar­get. For example, if NodeAdr is UINT#1, the file “BackupFile_Node00001.Bin” is the restore target.

•If DirName (Directory Name) is omitted, the function block assumes that the root directory on the SD
Memory Card is specified.

• This function block will perform restore if the revision of the backup source device is either the same
as or older than the revision of the restore destination device. If the revision of the backup source
device is newer than the revision of the restore destination device, an error will occur.

• To restore backup data to a node at a different node address from that of the backup source device,
change the node address portion of the backup file name to the node address of the restore destina­tion device.

Name

Bo
ole

an

Bit strings Integers

Real

num-

bers

Times, durations,

dates, and text strings

BOOL

BYTE

WORD

DWORD

LWORD

USINT

UINT

UDINT

ULINT

SINT

INT

DINT

LINT

REAL

LREAL

TIME

DATE

TOD

DT

STRING

Execute OK

NodeAdr

OK

DirName

OK

NoProductChk

OK

TimeOut

OK

Done

OK

Busy

OK

SdoBusy

OK

Error

OK

ErrorID

OK

ErrorIDEx

OK

Function

Sensor Communications
Unit

Sensor Amplifier Unit

Node1, version 1.00 Node10

E3NW-ECT

EtherCAT

CPU Unit or Industrial PC

SD Memory Card

Root directory

BackupFile_Node00001.Bin

Directory: DirName



E3NX-FA0



E3NC-LA0



E3NC-SA0

Restore_E3NW

48

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

 Procedure

1 Execute the function block.

For NodeAdr (Slave Node Address), specify the node address of the restore target slave.

If necessary, set DirName (Directory Name) and TimeOut (Timeout Time).

2 The backup file in the directory specified with DirName (Directory Name) is restored to the

E3NW Unit when execution of the function block is ended.

The following figures show the timing charts for the function block.

• Busy (Executing) changes to TRUE when Execute changes to TRUE.

• Done changes to TRUE when restore is ended.

• If an error occurs when execution of the function block is in progress, Error changes to TRUE and
Busy (Executing) changes to FALSE.

You can find out the cause of the error by accessing the values output to ErrorID (Error Code) and
ErrorIDEx (Expansion Error Code).

• If Execute changes to FALSE before execution of the function block is ended, Done and Error are
TRUE only for one task period after execution of the function block is ended.

• If Execute remains TRUE even after execution of the function block is ended, the output values of
Done and Error are held.

 Timing Chart for Normal End

 Timing Chart for Error End

Timing Charts

12

3

4567891011

#0000

#00000000 #00000000 #00 000000 #00000000

#0000 #0 00 0 #0000

Scan

Execute

Done

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

1234567891011

Scan

Execute

Done

Done

Busy

SdoBusy

Error

ErrorID

ErrorIDEx

#0000

#00000000 ErrorIDEx #00000000 ErrorIDEx

ErrorID #0000 ErrorID

49

Restore_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

• For information on the characters that can be used in DirName, refer to Specifications of Supported
SD Memory Cards, Folders, and Files in the software user’s manual.

• Do not cycle the power supply to the E3NW Unit after completion of the restore processing.

• In backup or restore processing, the value of SdoBusy is TRUE when data objects are being sent.
The value of SdoBusy is FALSE when data objects are not being sent due to the internal processing
of the function block.

• Execution of this function block will be continued until processing is ended even if the value of Exe-
cute changes to FALSE or the execution time exceeds the task period. The value of Done changes to
TRUE when processing is ended. Use this to confirm normal ending of processing.

• This function block executes one EC_CoESDOWrite instruction or one EC_CoESDORead instruc­tion within the part. Refer to the EC_CoESDOWrite instruction in the instructions reference manual
for the maximum number of instructions that can be executed at the same time.

• An error will occur in the following cases. Error will change to TRUE.

a) The EtherCAT master is not in a state that allows message communications.

b) The slave specified with NodeAdr does not exist.

c) The slave specified with NodeAdr is not in a state that allows communications.

d) The model specified in the backup file differs from the model of the restore destination device

and NoProductChk is FALSE.

e) The slave is not in a state that allows writing of parameters.

f) The EC_CoESDOWrite instruction exceeded the maximum number of instructions that can be

executed at the same time.

g) SD Memory Card access failed (no SD Memory Card inserted, a file is being accessed, etc.).

Precautions for Correct Use

• Do not execute the same instance while an instance is being executed.

• Do not execute backup for slaves to which parameters are being restored.

• Do not attempt to turn OFF the power supply to the Controller and EtherCAT slaves or stop
the EtherCAT communications until the processing for this function block ends normally or
ends in an error.

• During a restore, do not use the measurement data for the E3NW to control machine opera­tion.

Additional Information

Precautions for Correct Use

Restore_E3NW

50

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Related System-defined Variables

Name Meaning Data type Description

_Card1Ready

SD Memory Card
Ready Flag

BOOL

TRUE when the SD Memory Card is
recognized. It is FALSE when the SD
Memory Card is not recognized.

TRUE: Can be used.

FALSE: Cannot be used.

_EC_MBX_SlavTbl

Message Communica­tions Enabled Slave
Ta bl e

Array[1..512] OF BOOL

This table indicates the slaves that
can perform message communica­tions. Slaves are given in the table in
the order of slave node addresses.

TRUE: Message communications
are possible.

FALSE: Message communications
are not possible.

51

Restore_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Troubleshooting

Error code

Expansion

error code

Status Description Correction

16#0000 16#00000000 Normal End --- ---

16#3C10 16#00000001

VenderID Not
Matched

The VenderID in the backup file
does not match the VenderID of
the restore target node.

Specify a backup file with a
VenderID that matches the
VenderID of the restore target
node.

16#3C10 16#00000002

ProductCode
Not Matched

The ProductCode in the
backup file does not match the
ProductCode of the restore
target node.

Specify a backup file with a
ProductCode that matches the
ProductCode of the restore
target node.

16#3C10 16#00000003

Revision Not
Matched

The revision number of the
restore destination is older than
the revision number in the
backup file.

Specify the E3NW Unit with a
revision number that is either
the same as or newer than the
revision number in the backup
file as the restore destination.

16#3C10 16#00000004

Configuration
Not Matched

The Sensor Amplifier Unit con­figuration in the backup file
does not match the Sensor
Amplifier Unit configuration of
the restore target node.

Specify a backup file with a
Sensor Amplifier Unit configu­ration that matches the Sensor
Amplifier Unit configuration of
the restore target node.

16#3C10 16#00000005

Unsupported
Device

The device is not supported by
this function block.

Check that the specified device
is an E3NW Unit.

16#0400 16#00000000

Input Value Out
of Range

The value of NodeAdr is out of
range.

Set the value of NodeAdr cor-

rectly.
The directory name specified
with DirName contains one or
more characters that cannot be
used.

Set DirName correctly.

The directory name specified
with DirName is too long.

Check the length of the direc-

tory name specified with Dir-

Name so that it is within the

valid range.

16#1400 16#00000000

SD Memory
Card Access
Failure

An SD Memory Card is either
not inserted or is not inserted
properly.

Insert an SD Memory Card cor-

rectly.

The SD Memory Card is bro­ken.

Replace the SD Memory Card

with one that operates nor-

mally.

The SD Memory Card slot is
broken.

If this error persists even after

making the above two correc-

tions, replace the CPU Unit or

the Industrial PC.

16#1403 16#00000000

File Does Not
Exist

There is no backup file to
restore in the directory speci­fied with DirName.

Specify the directory in which a

backup file exists specified in

this function block.

16#1405 16#00000000

File Already in
Use

An instruction attempted to
read or write a file already
be

ing accessed by another

instruction.

Correct the user program so

that this function block is exe-

cuted only when the Busy out-

put variable for all other

instructions for the same file is

FALSE.

Restore_E3NW

52

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Refer to the sample programming for the following instructions: Backup_E3NW on page 32.

16#140B 16#00000000

Too Many Files
Open

The maximum number of open
files was exceeded when open­ing a file for the function block.

Correct the user program to
decrease the number of open
files.

16#140E 16#00000000

SD Memory
Card Access
Failed

The SD Memory Card is bro­ken.

Replace the SD Memory Card.

The SD Memory Card slot is
broken.

If this error occurs even after
making the above correction,
replace the CPU Unit or the
Industrial PC.

16#1800 16#00000000

EtherCAT Com­munications
Error

The EtherCAT network is not in
a usable status.

Check the operation status of
the EtherCAT network by
checking the status of the Eth­erCAT master. Use this infor­mation to correct the cause of
the problem.

16#1801 16#00000000

EtherCAT Slave
Does Not
Respond

The target slave does not exist.

Specify an existing node
address.

The target slave is not in an
operating condition.

Check the status of the target
EtherCAT slave. Make sure
that the target slave is in a
usable status.

16#1802 16#00000000

EtherCAT Time­out

Communications with the target
slave timed out.

Check the operating status of
the target slave and correct the
cause of the problem.

16#1803 16#00000000

Reception Buf­fer Overflow

The receive data from an Eth­erCAT slave overflowed the
receive buffer.

Set the size of the reception
buffer to a value larger than the
size of the receive data from
the slave.

16#1804

SDO Abort

Code

*1

SDO Abort Error

The cause of this error
depends on the specifications
of the EtherCAT slave.

Refer to the manual for the Eth­erCAT slave and correct the
problem.

16#1808 16#00000000

Communica­tions Resource
Overflow

More than 32 EtherCAT com­munications instructions were
executed at the same time.

Correct the user program so
that no more than 32 EtherCAT
communications instructions
are executed at the same time.

*1. An SDO abort code is shown here. Refer to SDO Abort Codes in the instructions reference manual for a list of SDO abort

codes.

Sample Programming

Error code

Expansion
error code

Status Description Correction

53

Restore_E3NW

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

The following gives an object list for the backup and restore targets.

Refer to the E3NW-ECT EtherCAT® Digital Sensor Communication Unit Operation Manual (Cat. No.
E429) for details on each object.

Additional Information

Index

(N = unit number 1 to 30)

Subindex Access

Data attri-

bute

*1

*1. This is the timing when changes to writable objects are enabled.

A: Always enabled

Supported Sensor Amplifier Unit

FA0 LA0 SA0 TA 0 CA0

4004 + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

4004 + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

4005 + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

4008 + (N - 1) × 80 hex 1 RW A OK OK OK OK ---

4008 + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

400A + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

400A + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

400B + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

400E + (N - 1) × 80 hex 1 RW A OK OK OK --- OK

400E + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

400F + (N - 1) × 80 hex 1 RW A OK OK OK --- OK

400F + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

4010 + (N - 1) × 80 hex 1 RW A OK OK OK --- OK

4010 + (N - 1) × 80 hex 2 RW A OK OK OK --- OK

4011 + (N - 1) × 80 hex 1 RW A OK OK --- --- ---

4012 + (N - 1) × 80 hex 1 RW A OK OK OK --- OK

4013 + (N - 1) × 80 hex 1 RW A OK OK OK --- OK

4015 + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

4016 + (N - 1) × 80 hex 1 RW A OK OK OK OK OK

4020 + (N - 1) × 80 hex 1 RW A OK OK OK OK ---

4021 + (N - 1) × 80 hex 1 RW A OK OK OK --- ---

4021 + (N - 1) × 80 hex 2 RW A OK OK OK --- ---

4022 + (N - 1) × 80 hex 1 RW A OK OK OK OK ---

4023 + (N - 1) × 80 hex 1 RW A --- --- OK --- ---

4024 + (N - 1) × 80 hex 1 RW A --- --- OK --- ---

4025 + (N - 1) × 80 hex 1 RW A OK OK --- --- ---

4038 + (N - 1) × 80 hex 1 RW A OK OK --- OK OK

4038 + (N - 1) × 80 hex 2 RW A --- --- --- --- ---

4039 + (N - 1) × 80 hex 1 RW A OK OK --- OK OK

4039 + (N - 1) × 80 hex 2 RW A --- --- --- --- OK

403B + (N - 1) × 80 hex 1 RW A OK OK --- --- ---

403C + (N - 1) × 80 hex 1 RW A OK OK --- --- ---

4050 + (N - 1) × 80 hex 1 RW A --- --- OK --- ---

4052 + (N - 1) × 80 hex 1 RW A --- --- OK --- ---

4063 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4064 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4065 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4066 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4067 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4068 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4069 + (N - 1) × 80 hex 1 RW A --- --- --- --- OK

4071 + (N - 1) × 80 hex 1 RW A --- --- --- OK ---

4072 + (N - 1) × 80 hex 1 RW A --- --- --- OK ---

Restore_E3NW

54

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

55

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Appendix

Referring to Library Information

56

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Referring to Library Information

When you make an inquiry to OMRON about the library, you can refer to the library information to iden­tify the library to ask about.

The library information is useful in identifying the target library among the libraries provided by OMRON
or created by the user.

The library information consists of the attributes of the library and the attributes of function blocks and
functions contained in the library.

• Attributes of libraries

Information for identifying the library itself

• Attributes of function blocks and functions

Information for identifying the function block and function contained in the library

Use the Sysmac Studio to access the library information.

The following attributes of libraries, function blocks and functions are provided as the library informa­tion.

 Attributes of Libraries

 Attributes of Function Blocks and Functions

Attributes of Libraries, Function Blocks and Functions

No.

*1

*1. These numbers correspond to the numbers shown on the screen images in the next section, Referring

to Attributes of Libraries, Function Blocks and Functions on page 57.

Attribute Description

(1) Library file name The name of the library file
(2) Library version The version of the library
(3) Author The name of creator of the library

(4) Comment

The description of the library

*2

*2. It is provided in English and Japanese.

No.

*1

*1. These numbers correspond to the numbers shown on the screen images in the next section, Referring

to Attributes of Libraries, Function Blocks and Functions on page 57.

Attribute Description

(5) FB/FUN name The name of the function block or function
(6) Name space The name of name space for the function block or function
(7) FB/FUN version The version of the function block or function
(8) Author The name of creator of the function block or function
(9) FB/FUN number The function block number or function number

(10) Comment

The description of the function block or function

*2

*2. It is provided in English and Japanese.

57

Referring to Library Information

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

You can refer to the attributes of libraries, function blocks and functions of the library information at the
following locations on the Sysmac Studio.

• Library Reference Dialog Box

• Toolbox Pane

• Ladder Editor

(a) Library Reference Dialog Box

When you refer to the libraries, the library information is displayed at the locations shown below.

Referring to Attributes of Libraries, Function Blocks and Functions

(2)Library version

(1)Library file name

(3)Library author

(4)Library comment

(5)FB/FUN name

(7)FB/FUN version

(8)FB/FUN author

(10)FB/FUN comment

(6)Name
space

Referring to Library Information

58

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

(b) Toolbox Pane

Select a function block and function to display its library information at the bottom of the Toolbox
Pane.

The text “by OMRON” which is shown on the right of the library name (1) indicates that this library
was provided by OMRON.

(c) Ladder Editor

Place the mouse on a function block and function to display the library information in a tooltip.

(5)

FB/FUN name (6)Name space

(1)

Library file name

(9)

FB/FUN number

(10)

FB/FUN comment

(7)

FB/FUN version

(8)

FB/FUN author

(6)

Name space (5)FB/FUN name

(10)

FB/FUN comment

(9)

FB/FUN number

59

Referring to Function Block and Function Source Codes

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Referring to Function Block and
Function Source Codes

You can refer to the source codes of function blocks and functions provided by OMRON to customize
them to suit the user’s environment.

User function blocks and user functions can be created based on the copies of these source codes.

The following are the examples of items that you may need to customize.

• Customizing the size of arrays to suit the memory capacity of the user’s Controller

• Customizing the data types to suit the user-defined data types

Note that you can access only function blocks and functions whose Source code published/not pub­lished is set to Published in the library information shown in their individual specifications.

Use the following procedure to refer to the source codes of function blocks and functions.

1 Select a function block or function in the program.

2 Double-click or right-click and select To Lower Layer from the menu.

The source code is displayed.

Precautions for Correct Use

For function blocks and functions whose source codes are not published, the following dialog
box is displayed in the above step 2. Click the Cancel button.

Referring to Function Block and Function Source Codes

60

Sysmac Library User’s Manual for EtherCAT N-Smart Series Library (W549)

Authorized Distributor:

In the interest of product improvement,
specifications are subject to change without notice.

Cat. No. W549-E1-06

0119

© OMRON Corporation 2015-2019 All Rights Reserved.

OMRON Corporation Industrial Automation Company

OMRON ELECTRONICS LLC

2895 Greenspoint Parkway, Suite 200
Hoffman Estates, IL 60169 U.S.A.
Tel: [phone]/Fax: [phone]

Regional Headquarters

OMRON EUROPE B.V.

Wegalaan 67-69, 2132 JD Hoofddorp
The Netherlands
Tel: [phone]/Fax: [phone]

Contact: www.ia.omron.com

Kyoto, JAPAN

OMRON ASIA PACIFIC PTE. LTD.

No. 438A Alexandra Road # 05-05/08 (Lobby 2),
Alexandra Technopark,
Singapore 119967
Tel: [phone]/Fax: [phone]

OMRON (CHINA) CO., LTD.

Room 2211, Bank of China Tower,
200 Yin Cheng Zhong Road,
PuDong New Area, Shanghai, 200120, China
Tel: [phone]/Fax: [phone]