CARLO GAVAZZI XAP10RSEXX Configuration Manual
CARLO GAVAZZI XAP10RSEXX Configuration Manual

CARLO GAVAZZI XAP10RSEXX Configuration Manual

Hide thumbs Also See for XAP10RSEXX:

Advertisement

Quick Links

XAP10RSEXX
CONFIGURATION MANUAL
Oct. '19

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the XAP10RSEXX and is the answer not in the manual?

Questions and answers

Summary of Contents for CARLO GAVAZZI XAP10RSEXX

  • Page 1 XAP10RSEXX CONFIGURATION MANUAL Oct. ’19...
  • Page 2: Table Of Contents

    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...
  • Page 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...
  • Page 4: Updated Version

    Updated version Content subject to change. Download the updated version: www.productselection.net XAP1.0 – Configuration manual...
  • Page 5: Introduction

    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.
  • Page 6: Requirements And Limitations

    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 2.8.0.441 or higher by using Wizard Studio CODESYS V3 Development System...
  • Page 7: Architecture

    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: Refer to table above to know which optional plugins and fieldbusses are available for your hardware configuration XAP1.0 –...
  • Page 8: Default Parameters

    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 IP Address: 192.168.0.1 ETH1/LAN Subnet mask: 255.255.255.0 System settings page https://192.168.0.1/machine_config Username...
  • Page 9: Getting Started With Codesys

    Getting Started with CODESYS This chapter provides the necessary information on how to set-up the XAP device and CODESYS V3 PLC system. The required operations are listed below and explained in the forthcoming chapters. ▪ CODESYS V3 Development System installation ▪...
  • Page 10: Codesys V3 Development System Installation

    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 Click to https://store.codesys.com/ to access the CODESYS Store. Select CODESYS Development System V3 and click to DOWNLOAD 32 BIT option.
  • Page 11 Select I accept the terms in the license agreement and click Next button to continue Select I have read the information option and click Next to continue. Select the Destination folder and click Next button to continue. XAP1.0 – Configuration manual...
  • Page 12 Select Complete option and press to Next. Click to Install to start the installation procedure. Note: The installation procedure takes several times due to your Computer performance. Click Finish button to end the installation procedure. XAP1.0 – Configuration manual...
  • Page 13: Package Manager

    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.
  • Page 14 Select Complete setup option and click Next button. XAP1.0 – Configuration manual...
  • Page 15 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. Select Complete setup option and click to Next to continue. Check the CODESYS V3.5 SP15 option before continuing and click Next. XAP1.0 –...
  • Page 16 Click Next to start the installation procedure. Click to Finish to end the installation. XAP1.0 – Configuration manual...
  • Page 17: Updating Old Codesys Packages

    Updating old CODESYS Packages When a new version of Package is released XAP device always tries to guarantee the complete compatibility with the previous versions. When a new version of the CODESYS Package is available, it can be installed to update the Package information accordingly to the latest CODESYS V3 PLC Runtime features.
  • Page 18: Xap Hmi Runtime Installation With Codesys License

    XAP HMI Runtime installation with CODESYS license Thing to know Activate Codesys license on XAP device As the CODESYS PLC Runtime is part of the HMI Runtime it is necessary to install the HMI Runtime on the HMI to have the PLC Runtime running. Step Action In Wizard Studio select Run >...
  • Page 19: Creation Of A New Plc Project

    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 Select File > New Project or click on the icon from the upper tools bar.
  • Page 20: Download Plc Application

    Download PLC application The selection of the PLC where to download the project must be done from Device communication settings tab before proceeding with the download operation. Step Action Double click on Device (<device_name>) in the project tree to display the Device properties in the work area.
  • Page 21 Example In the next figure the string is “0000.29D8”, the last part of the string “29D8” corresponds to the last 2 bytes of the XAP IP Address in Hex format so, in this case, the corresponding XAP device is the one with IP address xxx.xxx.41.216 as 29Hex corresponds to 41Dec and D8 Hex corresponds to 216 Dec.
  • Page 22: Upload Plc Application

    Upload PLC Application The upload of the PLC project is possible only if the project Source has been previously downloaded into the PLC. To download the project source, while Online, select the Online > Source download to connected device command. To upload a PLC project from the XAP device, select the Source upload command from the File menu, as shown in the following figure, then select the XAP device from Select Device window.
  • Page 23: Exporting Symbol File Configuration From Codesys

    Exporting SYMBOL File configuration from CODESYS The Symbol file is designed to easily share variables between CODESYS V3 and Wizard Studio projects for XAP devices. The Symbol file created in CODESYSYS V3 can be imported into Wizard Studio projects in order to make all the Codesys variables available for use. Procedures When creating the project using CODESYS V3, properly configure the symbol file to contain the required variables.
  • Page 24 Symbol configuration item contains a list of all the variables available into the CODESYS V3 project, single variables or groups of variables can be selected by checking the corresponding item in the list. After the symbols have been configured, download the project or use the Generate code function (Build >...
  • Page 25: Communication Setup In Wizard Studio

    Communication Setup in Wizard Studio XAP Runtime communicates with the internal CODESYS V3 Runtime using the CODESYS V3 ETH protocol. Localhost 127.0.0.1 should be entered in IP Address parameter; this identifies the PLC as internal CODESYS V3 Runtime. Additional information regarding CODESYS V3 ETH driver are available in Wizard Studio Help > Communication Drivers section.
  • Page 26: Importing Symbol Files In Tag Editor

    Importing Symbol Files in Tag Editor Wizard Studio Tag Editor requires direct import of CODESYS V3 symbol file for the definition of the Tags. To import the .xml file containing Symbols, follow the procedure below: STEP ACTION In the Wizard Studio, select the CODESYS V3 ETH protocol in Tag Editor and click on the Import Tags button to start the importer.
  • Page 27: Things To Know

    Tags included in the symbol file are listed in the tag dictionary. The tag dictionary is displayed at the bottom of the screen. Things to know Memory Layout The table below shows detailed information about maximum allowed size of CODESYS V3 project.
  • Page 28: Things To Know

    Things to know The following table describes the behaviour of the toolbar items: Toolbar item Description Import Tag(s) Select tags to be imported and click on this icon to add tags from tag dictionary to the project. Update Tag(s) Click on this icon to update the tags in the project, due a new dictionary import. Recursive Check this box to import all sub-elements of a tag.
  • Page 29: Getting Start With Opc-Ua

    Getting start with OPC-UA Things to know The OPC UA Client communication driver has been designed to connect XAP devices to OPC UA servers. The service can be used to public Tags to OPC UA servers. Note: the implementation of the protocol operates as a client only. Procedures Enable OPC-UA OPCUA service has to be enabled in the Wizard Studio project you are developing.
  • Page 30: Test Opc-Ua Client

    Test OPC-UA client OPCUA service has to be enabled in the Wizard Studio project you are developing. Follow the procedure shown below: Step Action Execute UA Expert client Select Add.. from Server tab In the Add server window, click Advanced tab In the Endpoint Url field insert the OPC-UA server reference with the following syntax: opc.tcp://<XAP IP Address>:48010...
  • Page 31 The first time, in the Certificate Validation window, click on Trust Server Certificate to accept it click on Continue button. In the Address space are shown all the available Tags By Drag & drop action add the tags to the Data Access View panel XAP1.0 –...
  • Page 32: Getting Start With Node-Red

    Getting start with Node-RED Things to know To install node-RED into a XAP device, you need • an empty USB Stick • the Node-RED_package.zip available on productselection.net Procedures Install Node-RED on XAP device Follow this procedure to install Node-RED on XAP device. Note: Autorun scripts from external storage option in XAP machine_config ->...
  • Page 33: User Interface

    User interface At the first time, the Node-RED interface appears as shown in the picture below: Procedures To do a communication test with Node-RED and tags that are running on XAP device, you can use a free MQTT solution. Follow the procedures below. Create a CloudMQTT account Access to https://customer.cloudmqtt.com/signup...
  • Page 34: Create A New Instance

    Create a new Instance Step Action Access to CloudMQTT account. Click to button in the top right corner. a) Enter an indentification name in Name field. b) Select Cute Cat (Free) value form brop-down menu. Note: see https://www.cloudmqtt.com/plans.html for details about available plans c) Enter option tags value in Tags field.
  • Page 35: Import The Node-Red Example Project

    Import the Node-RED example project The file Generic_MQTT_example.txt is a Node-RED flow available in the “Node-RED package.zip” folder. Follow this procedure to import and set the example within your references: In the Wizard Studio project, the Security option (ProjectView > Security) must be disabled.
  • Page 36 Double click on the Read Tag node to enter the settings page: Set in the Id field the same Tag name that is shown in Wizard Studio in Tags tab. In the Name field you can enter a description to identify the variable. Click on Done button to store the changes.
  • Page 37 Click to Deploy button to compile the project: The status indicator is shown below the CloudMQTT server node Click to Debug tag to see the updated value that are sent to MQTT broker (CloudMQTT) in real-time. Example In the example shown below the project is running on Node-RED. The UWP3.0 – Humidity and UWP3.0 –...
  • Page 38: Appendix

    Appendix System settings The user interface of System Settings is based on HTML pages and can be accessed remotely using a Web browser. Procedures System settings access from Web browser To access System Settings, follow this procedure: STEP ACTION From any standard web browser, enter the IP address of the XAP device, in the following format: https://IP Address/machine_config Since the certificate is not signed from a Certificate Authority you will get a warning...
  • Page 39: Change The Language

    Browse through the options available in the menu on the left: the active item is highlighted and related information is displayed in the right: Notes: To change values, enter in edit mode by clicking the button on the right top. The edit button is available only inside the dialogs that contains modifiable parameters.
  • Page 40: System Tab

    System tab The System menu collects device information Parameter Description Info Device information Status Device status (Free RAM, Up time, CPU Load) Timer Device timers (System on, Back light on) Plugin Hardware plugin information Logs tab From the Logs menu you can set the persistent log option if you want to maintain the log files saved after a power reset.
  • Page 41: Network Tab

    Network tab Note: Network parameters are available in edit mode: Parameter Description Device hostname General Settings Avahi Hostname (see "Avahi Daemon") Network parameters of the available interfaces: DHCP ⚫ Network Interface IP Address ⚫ Net Mask ⚫ Gateway ⚫ DNS Servers Generally provided from the DHCP servers, but can be modified in edit mode Search Domains...
  • Page 42: Services

    Services Note: Services are available only when logged as admin. Mouse click on the enable button to enable/disable the service. Click the service name to list the associate parameters. Avahi Daemon Avahi is a system which enables programs to publish and discover services and hosts running on a local network.
  • Page 43: Bridge Service

    Bridge Service Using the bridge service is possible connect together the WAN (ETH0) network adapter with the LAN (ETH1) network adapters. When used, the two Ethernet adapters are bridged and both Ethernet adapters are sharing the same IP address. Bridge Service creates a Linux-based layer-2 Network Bridge between two or more network interfaces.
  • Page 44: Snmp Server

    SNMP Server SNMP is a network protocol that allow to manage network infrastructures. It is commonly used to monitor network devices as switches, routers, etc. connected to a LAN network. When the SNMP service is enabled, an SNMP Manager can retrieve information from the HMI device using the SNMP protocol.
  • Page 45: Ssh Server

    SSH Server SSH service has been designed only for advanced users. It provides remote login to HMI device using the secure shell protocol. On PC you can run a SSH Client as, for example, PuTTY that is an open source software distributed under the MIT license. SSH Server runs on TCP port 22 The default password for the username is “admin”.
  • Page 46: Plugins

    Plugins This page will show the parameters available to configure the optional plugins modules attached to the XAP device. See the description of each plug-in module to additional information. Management Note: Management is available only when logged as admin. From the management area is possible Update System Components of the XAP device. CAUTION: Working in the Management area is a critical operation and, when not performed correctly, may cause product damages requiring service of the product.
  • Page 47: Authentication

    Authentication Enter in edit mode to change the authentication passwords. Administrator username with full access right is "admin" with default password "admin". Generic username is “user” with default password “user”. WARNING: For security reasons, change the default passwords for both usernames x.509 Certificate XAP device use a self-certificate to encrypt the Internet communication trough the HTTPS protocol.
  • Page 48 Copyright © 2019, CARLO GAVAZZI Controls SpA All rights reserved in all countries. CARLO GAVAZZI Controls SpA reserves the right to apply modifications or make improvements to the relative documentation without the obligation of advance notice. XAP1.0 – Configuration manual...

Table of Contents