(Codesys runtime )

Transcription

1 ix TxB SoftControl (Codesys runtime ) Basic settings KI Function and area of use With the HMI soft controllers in the ix TxB SoftControl series, any HMI application can have an intuitive graphic ix interface with total CoDeSys control. This document goes through the basic settings required to use TxB SoftControl with CODESYS and ix Developer and also information on how to easily get started. The SoftController can communicate with external devices, for example Remote I/O. The different communication types are explained in detail in separate documents, see next chapter for reference. 2 About this Start Up document This Start Up document should not be considered as a complete manual. It is an aid to be able to start up a normal application quickly and easily. Copyright Beijer Electronics, 2016 This documentation (below referred to as the material ) is the property of Beijer Electronics. The holder or user has a non-exclusive right to use the material. The holder is not allowed to distribute the material to anyone outside his/her organization except in cases where the material is part of a system that is supplied by the holder to his/her customer. The material may only be used with products or software supplied by Beijer Electronics. Beijer Electronics assumes no responsibility for any defects in the material, or for any consequences that might arise from the use of the material. It is the responsibility of the holder to ensure that any systems, for whatever applications, which is based on or includes the material (whether in its entirety or in parts), meets the expected properties or functional requirements. Beijer Electronics has no obligation to supply the holder with updated versions. All safety and accident prevention regulations relevant to your specific application must be observed in the system design, installation, configuration, maintenance, servicing and testing of this product. When making programs for this product make sure to leave sufficient CPU power for the HMI-part of the product to be able to execute smoothly. A good rule of thumb is to keep the CPU-load around or below 80%. The CPU load can be monitored by looking at the SystemTagCPULoad system-tag found in the ix Developer environment. 1 (14) ~ dot, Beijer Electronics Automation AB a Beijer Electronics Group company Head Office Subsidiaries Beijer Electronics Automation AB Norway, Drammen: Beijer Electronics AS, P.O. Box 426, Stora Varvsgatan 13a Denmark, Roskilde: Beijer Electronics A/S, SE Malmö, SWEDEN Telephone Fax Reg no VAT no SE info@beijer.se

2 Use the following software and drivers in order to obtain a stable application: Programming software ix Developer 2.20 SP1 or later, programming the HMI in ix TxB SoftControl CoDeSys 3.5 SP7 Patch 1 or later, programming the SoftControl (Compiler ) Image, ix TxB SoftControl IML_TxB_SC_SM_b0198(.exe) or later. Driver, ix Developer CoDeSys_SoftControl_Direct_Access version or later, driver to communicate between ix HMI and CODESYS SoftControl. Device description, ix TxB SoftControl TxB_SoftControl.devdesc(.xml), to enable ix TxB SoftControl in CoDeSys Driver version for communication to Remote I/O StartUp document: - KI00376 EtherCAT (NA-9286) - KI00377 ModbusTCP (NA-9189/NA-9289) - KI00378 Modbus RTU (NA-9173/NA-9473) In this document we have used following software CoDeSys 3.5 SP7 Patch 1 (compiler version ) ix Developer 2.20 SP1 In this document we have used following hardware ix T7B SoftControl Remote I/O, Crevis FnIO-S Series For further information we refer to ix Developer Reference Manual (MAxx831) ix Developer User's Guide (MAxx832D) Driver help in ix Developer CoDeSys, Manuals and help in the software This document and other Start Up documents can be obtained from our homepage. Please use the address manual@beijer.se for feedback on our Start Up documents. 2 (14)

3 3 Table of Contents 1 Function and area of use About this Start Up document Table of Contents First Step Files in Basic Settings ix TxB SoftControl connections Programming tools and compiler version Compiler version Drivers - ix Developer and CODESYS with Remote I/O Persistent variables (32 kbyte) Important settings Boot after Online Change and Restart of ix TxB SoftControl Project backup CODESYS, Create backup files CODESYS, Project Archive CODESYS, Source Download to ix TxB SoftControl CODESYS project to ix TxB SoftControl using USB memory Diagnostic, SoftController (14)

4 4 First Step For best understanding and easy working with ix TxB SoftControl we recommend: Prepare the computer with the programming tools CODESYS and ix Developer. Basic knowledge of CODESYS. There is a quick start in CODESYS help file. Download manuals Install ix TxB SoftControl device description in CODESYS. Note! Always use the correct version of the drivers and software! 5 Files in Basic Settings Supplied with this document there is a folder containing example program för ix Developer and CODESYS. This is a very basic program that can be opened and/or downloaded to the ix TxB SoftControl panel for reference. Included is also a export folder to upload the project via USB-memory. By importing the CODESYS project the installation of the ix TxB device is automaticly made on your computer. 4 (14)

5 6 ix TxB SoftControl connections 24 VDC COM 1/2 LAN A USB LAN B COM 3/4 RTU TCP Ethernet Modbus EtherCAT Note! The Ethernet port "LAN B" is always dedicated to the EtherCAT driver (even when the EtherCAT driver is not used in the application). LAN B can not be used for other functions such as Modbus TCP or downloading of ix- Developer or CODESYS-project. 5 (14)

6 7 Programming tools and compiler version ix Developer for ix HMI application CODESYS for the SoftControl TxB SoftControl ix HMI application SoftControl EtherCAT Modbus TCP/RTU Ethernet 7.1 Compiler version It s importatnt to take notice of the device runtime version for CODESYS devices. This decides which compiler version that shall be used in your project. Using the wrong compiler version can result in errors and unwanted behaviour! It becomes especially important when using a CODESYS developer (called IDE) version that is higher than that of the device, which is perfectly OK. When you add a object in CODESYS, for example a driver, this have to comply to the runtime version that the device uses. There are specific librarys that are connected to the device runtime and therefor it s recommended to install the a matching IDE version of that of the device to make sure that all libraries are available. After this version have beens installed it s OK to download later CODESYS versions as long as the correct versions is used. In this document we describe TxB SoftControl with runtime version , that is: CODESYS 3.5 Service pack 7 patch (14)

7 8 Drivers - ix Developer and CODESYS with Remote I/O The terminal uses two drivers for communication between ix HMI, ix TxB SoftControl and remote I/O. Driver 1: - ix HMI application with ix TxB SoftControl (CODESYS SoftControl Direct Access) Driver 2: ix TxB SoftControl with Remote I/O - EtherCAT on LAN B, - Modbus TCP on LAN A - Serial Modbus RTU at COM1: RS-232, COM2: RS-485, COM3: RS-232 TxB SoftControl Driver 1 Example: Crevis FnIO-S Series ix HMI application ix-driver Direct access SoftControl Driver (14)

8 9 Persistent variables (32 kbyte) Persistent variables (non-volatile memory) can ONLY be declared in a special global variables list, which is assigned to an application. There might be only ONE such list per application. Highlight the Application entry in Devices Right click and select Add Object Choose PersistentVariables.. Persistent variables, function. ix TxB SoftControl supports Persistent variables. 8 (14)

9 10 Important settings 10.1 Boot after Online Change and Restart of ix TxB SoftControl This is highly recommended! Boot application can be regarded as the compiled, executable code. Default setting when creating a new project is that, when performing a Online Change, the boot application is not overwritten automaticly but instead saved in temporary memory which will result in that the project will return to previous program (before change) on application restart. To make sure that the online changes is always saved set the following: Highlight the Application in the Device and right click Select Properties and Boot application Select Create implicit boot application on Online Change This should be the default setting in ix TxB SoftControl 9 (14)

10 11 Project backup 11.1 CODESYS, Create backup files If this option is activated, at each saving the project will not only be saved in <projectname>.project but also copied to a file <projectname>.backup. If needed you can rename this backup-file and re-open in CoDeSys. Tools - Options Menu \Tools\Options 11.2 CODESYS, Project Archive The best way to get all components from a CODESYS project is to make a Save/Send Archive. That will save and pack all files referenced by and used within the currently opened project in to one archive file. The archive file can either be stored or sent as attachment of an . The archive file can easily be unpacked by use of Extract Archive Note! The archive function is not intended for restoring a project environment. It is designed for an easy packing of all files belonging to a project! 10 (14)

11 11.3 CODESYS, Source Download to ix TxB SoftControl The CODESYS project can be saved in the terminal and uploaded to CoDeSys. A projectarchive file will be saved on the device. Upload / Download Project setting Alternative to upload the archive.prj file 11 (14)

12 11.4 CODESYS project to ix TxB SoftControl using USB memory It is possible to export a CODESYS project and then save it in the root on a USB memory stick. If booting the ix TxB SoftControl panel with the USB memory plugged in, it is possible to upload the CODESYS project from the USB memory to the ix TxB SoftControl. Note! SD memory can also be used. Export project from CODESYS programming tool In menu Online select Create boot application and save the project files (.app/.crc) in the root of the USB memory Note! Use default name on the project files! Copy CODESYS project from USB to ix TxB SoftControl Restart the ix TxB SoftControl panel with USB memory You will be asked if you wish to load the CODESYS project Copy PLC project from USB memory? Important note! When download a CODESYS project the SoftControl memory will be cleared! Also the Persistent area (the battery powered memorycells and register) Tip! It s also possible to download the ix Developer project in same way! 12 (14)

13 12 Diagnostic, SoftController The driver supports some diagnostics tags, for example the RUN-state of the controller application. These tags are all addressed by the prefix "Diagnostics.", which is why tags which start with "Diagnostics." can't be used in the controller application. All diagnostics tags are listed below. Up to 20 Tasks are supported and can be addressed by changing the task-number in the tagsyntax between For example the name of task 6 (the seventh since the number begins at 0) is addressed with Diagnostics.Task6.Name. All diagnostics times and intervals are given in microseconds. From example project Diagnostic and RUN / STOP of the SoftControl 13 (14)

14 Tip! Import Diagnostic Tag to your project: - Import the following file: TxX Diagnostic Tags Import to ix.txt (14)