CARLO GAVAZZI XAP10RSEXX Instruction sheet

XAP10RSEXX
CONFIGURATION MANUAL
Oct. ’19

XAP1.0 –Configuration manual
2
Index
Index.......................................................................................................................................... 2
Updated version......................................................................................................................... 4
Introduction ............................................................................................................................ 5
Assumptions....................................................................................................................... 5
General description............................................................................................................. 5
Requirements and Limitations............................................................................................. 6
Architecture......................................................................................................................... 7
Default parameters................................................................................................................. 8
Getting Started with CODESYS................................................................................................. 9
Procedures............................................................................................................................. 9
Create a CODESYS account.............................................................................................. 9
CODESYS V3 Development System installation................................................................10
Package Manager.................................................................................................................13
Things to know...................................................................................................................13
Procedures............................................................................................................................13
Additional CODESYS packages installation.......................................................................13
Updating old CODESYS Packages....................................................................................17
XAP HMI Runtime installation with CODESYS license.......................................................18
Thing to know........................................................................................................................18
Creation of a new PLC project ...........................................................................................19
Download PLC application.................................................................................................20
Upload PLC Application.....................................................................................................22
Exporting SYMBOL File configuration from CODESYS.........................................................23
Procedures........................................................................................................................23
Communication Setup in Wizard Studio.............................................................................25
Importing Symbol Files in Tag Editor..................................................................................26
Things to know...................................................................................................................27
Memory Layout..................................................................................................................27
Things to know...................................................................................................................28
Getting start with OPC-UA........................................................................................................29
Things to know......................................................................................................................29
Procedures............................................................................................................................29
Enable OPC-UA.................................................................................................................29
Test OPC-UA client............................................................................................................30
Getting start with Node-RED.....................................................................................................32

XAP1.0 –Configuration manual
3
Things to know......................................................................................................................32
Procedures............................................................................................................................32
Install Node-RED on XAP device.......................................................................................32
User interface ....................................................................................................................33
Procedures............................................................................................................................33
Create a CloudMQTT account ...........................................................................................33
Create a new Instance.......................................................................................................34
Import the Node-RED example project...............................................................................35
Appendix...................................................................................................................................38
System settings.....................................................................................................................38
Procedures............................................................................................................................38
System settings access from Web browser........................................................................38
Change the language.........................................................................................................39
System tab............................................................................................................................40
Logs tab................................................................................................................................40
Date & Time tab ....................................................................................................................40
Network tab...........................................................................................................................41
Services ................................................................................................................................42
Avahi Daemon...................................................................................................................42
Bridge Service ...................................................................................................................43
Fast Boot...........................................................................................................................43
Router Service...................................................................................................................43
SNMP Server.....................................................................................................................44
SSH Server........................................................................................................................45
Plugins ..................................................................................................................................46
Management.........................................................................................................................46
Restore to factory settings .................................................................................................46
Restart...............................................................................................................................46
Authentication....................................................................................................................47
Certificate's parameters.....................................................................................................47

XAP1.0 –Configuration manual
4
Updated version
Content subject to change.
Download the updated version: www.productselection.net

XAP1.0 –Configuration manual
5
Introduction
XAP 1.0 is a rugged and compact controller designed as a powerful IIoT gateway and a
programmable unit for building automation functions. It is empowered by a configurable web
interface which makes it an outstanding HMI without screen. It integrates the standard IEC 61131
PLC (Codesys), so that any building automation function can be programmed by means of a
standard and well-known tool. The powerful software Wizard Studio permits an easy setup of
graphic pages, functions and protocols.
Assumptions
We assume that readers have a basic understanding of computers, Microsoft Windows, and the
specific network environment where the application will run.
This manual is intended for users or technicians directly involved in the installation of XAP device
and its integration to UWP 3.0 systems.
Note: This manual is not intended as CODESYS V3 programming manual, for
detailed documentation regarding CODESYS V3 Development System please
refer to the CODESYS web site www.codesys.com and to its on-line help.
Note: For detailed information regarding the use of Wizard Studio software and
related to the communication with HMI Runtime please refer to the Wizard Studio
manual available on productselection.net.
General description
This manual describes
CODESYS V3:
⚫How toconfigureaCODESYS V3environment and Wizard Studio integration
⚫How toprogram internal CODESYS V3 PLC availableinXAP device
⚫How to create a project to get communication with XAP device
OPC-UA:
The OPC UA Client communication driver is designed to connect XAP devices to OPC
UA servers. This implementation of the protocol operates as a client only in order to
public tags that are already defined in a Wizard project.
Node-RED:
Node-RED is a programming tool for wiring together hardware devices, APIs and online
services.

XAP1.0 –Configuration manual
6
Requirements and Limitations
The following firmware and software versions are required to work with the CODESYS V3 PLC
Runtime:
Element
Version
Wizard Studio suite
2.8.0 build 441 or higher
HMI Runtime application
Note: HMI is an application installed on the XAP device
by using Wizard Studio
2.8.0.441 or higher
CODESYS V3 Development System
V3.5 SP15 - 32 bit version ONLY
Note: The XAP HMI Runtime is compatible with CODESYS V3.5 Development
System only. CODESYS V2.3 Development System is NOT compatible with
CODESYS V3 Runtime.
If anewerversionof CODESYS V3Development System is already installed, make sureto
use3.5.15.0versions of libraries toprogramXAP deviceHMIs.
System requirments
Element
Details
Supported Platforms/ Devices
Windows 7 (Service Pack 1 or higher) / 8 / 10
(32/64 Bit), suitable PC hardware for the
corresponding Windows platform
Additional Requirements
Microsoft Internet Explorer 11, or higher
Licensing
-
Required Accessories
-

XAP1.0 –Configuration manual
7
Architecture
HMI and PLC based on Internal PLC (CODESYS) and CODESYS V3 can be applied in different
configurations. The picture below shows how HMI and PLC can be configured.
Note: Refertotableabovetoknow whichoptional plugins andfieldbusses are
availableforyourhardware configuration

XAP1.0 –Configuration manual
8
Default parameters
The device is set in the factory with the following parameters.
To access the XAP device for the first time, use these parameters.
PARAMETER
DEFAULT VALUE
ETH0 / WAN
Set as DHCP client
ETH1/LAN
IP Address: 192.168.0.1
Subnet mask: 255.255.255.0
System settings page
https://192.168.0.1/machine_config
Username
admin
Password
Gav@zzi!2015
Note: The username and password are case-sensitive.
WARNING: For security reasons, change the default passwords for both usernames
(passwords can be modified from the System Settings > Authentication command)
See the procedures in this manual.

XAP1.0 –Configuration manual
9
Getting Started with CODESYS
This chapter provides the necessary information on howto set-up the XAPdevice and CODESYS
V3 PLC system.
The required operations are listed below and explained in the forthcoming chapters.
▪CODESYS V3 Development Systeminstallation
▪Additional CODESYS packages installation
▪HMI Runtimeinstallationon XAP device
▪Activationof theCODESYS V3licenseontheHMI
▪Creation of a new PLCproject
▪Download/upload PLCapplication
▪CommunicationSetupinWizard Studio
▪Symbol File configurationwith CODESYS V3 Development System
Procedures
Create a CODESYS account
Access to https://store.codesys.com/customer/account/ select a type of account and click to
Create an Account to proceed.
Follow the indication on screen to finish the registration procedure.

XAP1.0 –Configuration manual
10
CODESYS V3 Development System installation
The CODESYS V3 Development System suite can be downloaded for free from the Codesys
website after registration. Follow this procedure to download and install the software on your
computer.
Step
Action
1
Click to https://store.codesys.com/ to access the CODESYS Store.
2
Select CODESYS Development System V3 and click to DOWNLOAD 32 BIT
option.
Be sure to download the 32bit version, the other versions are not supported.
3
In the popup that appears, click on Accept button to confirm the Licence agreement
to start the software download.
4
Perform the Setup_CODESYSV.exe to start the installation assistant which will
guide you.
5
Click Next > button to continue.

XAP1.0 –Configuration manual
11
6
Select I accept the terms in the license agreement and click Next button to continue
7
Select I have read the information option and click Next to continue.
8
Select the Destination folder and click Next button to continue.

XAP1.0 –Configuration manual
12
9
Select Complete option and press to Next.
10
Click to Install to start the installation procedure.
Note: The installation procedure takes several times due to your Computer
performance.
11
Click Finish button to end the installation procedure.

XAP1.0 –Configuration manual
13
Package Manager
Things to know
CODESYS Development System includes a tool called Package Manager for the installation of
the CODESYS Package. Package Manager tool can be launched from CODESYS Tools menu,
selecting the proper menu item. This tool can be used both for checking the installed Packages
and for installing new ones.
There are two dedicated CODESYS packages that are required to allow the standard CODESYS
V3 programming software to program XAP device HMI Runtime. These packages are provided
with the Wizard Studio installation suite.
Procedures
Additional CODESYS packages installation
This document explains where to find and how to install the CODESYS packages, containing the
needed information regarding the XAP device to be programmed. These are required to allow the
standard CODESYS v3 workbench to programme Codesys based PLCs.
Step
Action
1
Start CODESYS application.
2
From Tools menu, select Package manager option, in the window that appears,
click on Install button:
3
Browse the folder
C:\Program Files (x86)\CG\Wizard Suite2.8.0.441\CODESYS\V3
4
Select the first package called CODESYS_JMobile_3.5.10.50_8.package and click
Open to install the package.

XAP1.0 –Configuration manual
14
5
Select Complete setup option and click Next button.
6
7

XAP1.0 –Configuration manual
15
8
Select the second package POWERLINK for CODESYS_4.0.0.20.package and
click Open to install it.
Check the box to accept the License agreement under the window.
9
Select Complete setup option and click to Next to continue.
10
Check the CODESYS V3.5 SP15 option before continuing and click Next.

XAP1.0 –Configuration manual
16
11
Click Next to start the installation procedure.
12
Click to Finish to end the installation.

XAP1.0 –Configuration manual
17
Updating old CODESYS Packages
Whenanew versionof Packageis releasedXAP devicealways tries toguaranteethe
completecompatibility withtheprevious versions.
Whenanew versionof theCODESYS Packageis available, it canbe installedto
updatethe Packageinformation accordingly tothelatest CODESYS V3PLC Runtime
features.
If thenew Packageis not fully compatiblewith theprevious versionsomechanges toadapt the
PLC applicationtothenew Package may berequired.
ThePackageupdateprocedureis identical tothefirst installationof theCODESYS Package,
pleaserefertothe proper chapter for specificinformation.

XAP1.0 –Configuration manual
18
XAP HMI Runtime installation with CODESYS license
Thing to know
Activate Codesys license on XAP device
As theCODESYS PLC Runtime is part of theHMI Runtimeit is necessary toinstall theHMI
RuntimeontheHMI tohave the PLC Runtimerunning.
Step
Action
1
InWizard Studio select Run > ManageTarget.
2
From Target field select the XAP device among those available
3
Click on Update runtime button to proceed.
4
Once the HMI runtime is installed into the XAP device it is automatically
rebooted.
Note: It takes up to three minutes to complete the upgrading process.
For further information on installing the HMI Runtime, please refer to Wizard Studio
Manual.

XAP1.0 –Configuration manual
19
Creation of a new PLC project
When you start the programming system the first time after first installation on the system, you
will be asked to choose the default collection of settings and features:
Step
Action
1
Select File> New Project orclick onthe iconfromtheuppertools bar.
2
Select Standard Project in the Templates section.
Note: In the "Standard" environment the user interface is adapted for most effective
usability and some rarely used features are left out.
3
Select Standard project in the Templates field and enter a Name and a Location
path for the project file. Press OK to confirm.
4
In the wizard dialog, choose device 600L/700 (Linux) and the programming
language for PLC_PRG project.
5
Press OK to open the new project.

XAP1.0 –Configuration manual
20
Download PLC application
Theselectionof thePLC wheretodownloadthe project must bedonefromDevicecommunication
settings tabbefore proceedingwiththedownloadoperation.
Step
Action
1
Double click on Device (<device_name>) in the project tree to display the Device
properties in the work area. Insert the IP address of the XAP device and press Enter key.
2
A green dot over the device graphical representation informs that the device is correctly
recognizedandavailableintothe network.
Note: Communication with the availabledevices is established through a Gateway, a
default Gateway is available, and it is generally not needed to change the standard
Gateway settings. For more information about the Gateway set-up please refer to
CODESYS V3 documentation.
3
If PLC IP Address is unknown, select the Communication Settings tab then click on
the Scan Network…button.
4
TheSelect Devicedialogwill bedisplayed. This dialoglists allthecompatibledevices
available in the network. Select from the list the XAP device to be programmed then
press onOK.
5
In case several XAP devices using CODESYS V3 PLC Runtime arepresent into the
network,eachXAP device is recognizedby adifferent stringbetweensquarebrackets
reportedafter Devicename field.