Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Release Note
Document type:
Release Note
Document number:
D-153-RAD-20-001
Document revision:
1.1
Release version:
1.12.0.1 (2016a)
Release date:
04-Mar-2016
Status:
Released
TTControl GmbH
Schoenbrunner Str. 7, A-1040 Vienna, Austria, Tel. +43 1 585 34 34-0, Fax +43 1 585 34 34-90, office@ttcontrol.com
The information contained in this document does not affect or change any General Terms and Conditions of TTControl and/or any
agreements existing between TTControl and the recipient regarding the product or Sample concerned.
The reader acknowledges that this document may not be reproduced, stored in a retrieval system, transmitted, changed, or translated, in
whole or in part, without the express prior written consent of TTControl.
The reader acknowledges that any and all of the copyrights, trademarks, trade names, patents (whether registrable or not) and other
intellectual property rights embodied in or in connection with this document are and will remain the sole property of TTControl or the
respective right holder. Nothing contained in this legal notice, the document or in any TTControl web site shall be construed as conferring to
the recipient any license under any intellectual property rights, whether explicit, by estoppel, implication, or otherwise.
The product or Sample is only allowed to be used in the scope as described in section System Overview. Please note that based on the
current state of the art in science and technology, it is impossible to develop software that is bug-free in all applications.
Copyright 2016 TTControl GmbH. All rights reserved.
TTControl GmbH Confidential and Proprietary Information.
Contents
1 Introduction
1.1 Version Overview
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
3
2 Compatibility
2.1 Usage of USB flash memory devices and memory cards . . . . . . . . . . . . . . . . . .
4
4
3 Installation Instructions
3.1 CODESYS Install Location . . . . .
3.2 Troubleshooting . . . . . . . . . . .
3.2.1 Unavailable network resource
3.2.2 OpenGL version insufficient .
.
.
.
.
5
5
5
5
5
4 Update Instructions
4.1 Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
7
9
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5 Revision Details
11
5.1 New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2 Fixed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
6 Known Issues
16
7 Appendix
18
7.1 Compatibility Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Acronyms
20
References
21
Legal Disclaimer
22
1 Introduction
This document lists all new features, new functions and bug fixes which are available with the software
release 1.12.0.1 for HY-eVision family. Please read this document carefully, it also contains information
on compatibility and instructions on updating projects and devices.
The latest software release and documentation can be found on the service area on our website.
URL
https://www.ttcontrol.com/service-area/
Username
ttcontrol
Password
+Flexibility
Version
IDE
1.12.0.1
Devices
1.12.0.1
CODESYS
Target
TTC Download library
3.5.6.0
1.12.0.1
1.4.0
2 Compatibility
For a matrix of compatible versions, please see table 1 on page 18.
Strings read out with the function SysFileRead are not NULL-terminated; it must be added
manually.
A variable called BytesRead must be added to the variable definition as depicted in red in the
following image (showing function DeviceBootPathUsb):
.
n
.
The same two modifications must be made to the function FreeMemOnUsb.
3 Installation Instructions
A general description of the installation process is given in the Quickstart Guide [1]. In addition please
also observe the following instructions for installing this release.
3.2 Troubleshooting
3.2.1 Unavailable network resource
In some cases setup might show message The feature you are trying to use is on
a network resource that is unavailable. Please navigate to the correct source location manually: C:\TTControl\Targets_2016a\HY-eVision2\1.12.0.1\instData. See
also known issue 60223.
3.2.2 OpenGL version insufficient
To run HY-eVisions CODESYS IDE successfully your computer must support at least OpenGL 1.3 with
the appropriate drivers installed. Before running the installation program, please update your graphics
drivers to the most recent version. If you are unsure whether your computer fulfills this requirement, ask
your computer vendor or system administrator.
Setup will check the version during installation. If it does not detect an appropriate version it will display
the error message below. However, you can decide to continue installation. In this case the visualization
editor might not work properly.
4 Update Instructions
It might be necessary to update your projects and/or devices to use this software release. Once a
project is updated, it is not possible to revert this change. Also, it can only be downloaded to a device
with a matching software revision as explained in section 2.
Devices and libraries are stored in a common repository for all installed versions
of CODESYS. Thus all versions of a device or library present are available in any
CODESYS version, even if it is a newer device or library that is not supported. To
prevent confusion and failed project updates we recommend the following rules:
n
Include all libraries as placeholders. The only exception are your own and
third-party libraries (e.g. OSCAT). This makes sure all libraries are included
in the correct version for this release.
When updating the device, double-check that updating to the correct version
for this release. Section 1.1 defines which device version is appropriate.
4.1 Project
1. Create a backup copy of your project, including its resource files.
2. Launch CODESYS with the following link on your desktop: HY-eVision2 1.12.0.1 (CODESYS
V3.5 SP6)
3. Open the project. If a message Do you want to upgrade the storage format for this project?
appears accept it with Yes .
4. After a few seconds window Project Environment shows up. This dialog allows you to update
compiler settings and required library versions.
a) Select tab Compiler version and as action choose Update to 3.5.6.0.
b) Select tab Visualization Code Generator and choose the desired code generator.
Update device. . .
6. In dialog Update device the correct device should be selected by default in list Devices, please
check nevertheless. Column Version must show 1.12.0.1. Close with OK .
7. Perform Build
Clean All .
8. Save the project and restart CODESYS before continuing working on the project.
4.2 Device
A USB flash memory drive with at least 2 GB capacityformatted with either FAT or FAT32 filesystem
is needed. Please make sure the drive is empty before continuing with the following steps.
Never interrupt power or switch device off while an update is in progress! This can
result in a damage that can only be fixed by sending the unit to TTControl Service!
The screenshots show the update process on a HY-eVision 7.0. The updater is
equal on all other devices, except for the location of the keys on a HY-eVision 10.4.
5. The device will perform a reboot now and prepare the update. Please be patient, this might take
a few minutes.
10
6. When the updater is ready to perform the update, screen shown below is displayed. Please press
the button next to the checkmark to start the release update.
7. The device will now be updated. After the updater finished a summary of completed work items
is shown. Disconnect the USB drive and press checkmark to reboot.
If the update failed please save the logs that are located on the USB drive in folder
updater-logs. They are essential for providing assistance!
11
5 Revision Details
For further information on how to use new software features please refer to online help in CODESYS
IDE: Help Contents and choose topic HY-eVision Visualization Unit.
39661/IDE
Predefined actions can be automatically performed when a key is pressed. See also 39662.
Predefined actions on touch or key events
39662/IDE
Predefined actions can be executed on a touch or key press additional to running a code snippet. These
actions include Change Page, Change Language, and Toggle Variable.
Defineable standard font
46528/IDE
The font that should be used as standard for newly inserted labels can be defined in the project settings.
Adjustable line spacing for label text
50608/IDE
A new property Spacing has been added to labels that allows to set the line spacing.
Sort alphabetically in Element Order View
52580/IDE
53826/IDE
A generic keypad component for editing alphanumeric values has been added.
Updates to tutorial projects
69498,78950,89137,73331,79959,85770,86541,89241/IDE
Several updates and amendments to the tutorials. New tutorials for USB storage devices and multilanguage support.
Unattended release and application update
78245/Updater
Release- and application updates can be put together in one updater and executed automatically in the
correct order without the need to start the update process twice.
New component Image Gauge
78441/IDE
A gauge component that supports user-defined images for background and needle has been added.
Support for RTC wakeup
79207/RTS
New HY-eVision devices support automatic wakeup from suspend at a predefined time.
12
79935/IDE
A gauge component that supports user-defined images for background and foreground has been added.
Specify mount options
80063/HAL
When mounting a USB drive, mount options like synchronous access can be specified.
New component Image Lamp
83151/IDE
An image lamp component that supports user-defined images for on and off states has been added.
Support for firewall
84402/OS,IDE
Wireless connections are protected by a firewall. The updater allows to configure the firewall.
Wireless networking
86089/OS,RTS
86095/IDE
A library of professionally designed dashboard elements is provided to kick-start application development. These elements include the following types in various resolutions and color schemes:
n
n
n
n
n
n
Buttons
Gauges (for component Image Gauge)
Icons
Lamps (for component Image Lamp)
Progress bars (for component Image Bargraph)
Switches
The images can be found in folder Dashboard Design Elements in the installation directory.
Gauge
Icon
Switch
13
38834/RTS
Not all properties of the visualization were reset to their default values on an RTS reset.
Missing compiler error when using wrong library namespace
44299/IDE
It was possible to call local functions with a (wrong) namespace. The compiler now shows an error in
that case.
Project archive: Filenames with non-ASCII characters unsupported
47726/IDE
Files that have non-ASCII characters in their name had a wrong name after being extracted from a
project archive.
FB ScaleBehaviour not working
56404/RTS
A missing function in the runtime system led to an error during project download when a ScaleBehaviour
function block was used.
Some key events not handled in visualization code
63859/IDE
By default, the bus cycle task is now set to Visualization when adding a Visualization Manager object
to the project to allow the visualization to correctly consume all key events (e g for numpad).
Multiselection in Element Order View improved
74024,89661/IDE
Selecting multiple elements using the checkboxes in Element Order View has been improved.
Improve update stability
75567/Updater
Additional checks were added to the updating process to improve stability and avoid occurence of error
message Could not read Bootloader Environment (50).
Function FormatString*() not thread-safe
74370/RTS
Functions FormatString() and FormatStringW() were not thread-safe. This caused garbled
texts and label flickering.
Remove deprecation for I/O-mapping Wakeup
79209/IDE
New HY-eVision devices do have support for pin Wakeup. This value will still always return FALSE for
devices that do not have a wakeup pin.
Wrong default value for property of component ImageContainer
79522/IDE
Property Reactive of component ImageContainer was incorrectly initialized to TRUE even if it was set
to FALSE in the visualization editor.
14
80048/HAL
In some cases a call to function HalUdevStart() led to a segmentation fault in the runtime system.
Application stops working after standby
80981/OS
After several hundred suspend/resume cycles with high frequency it could happen that the application
stopped due to a problem when restoring the system state during resume.
Touch inoperative after several suspend/resume cycles
81092/OS
The touchscreen could stay unresponsive after several suspend/resume cycles when woken up with a
key press.
Display backlight off after resume
81598/OS
After fast suspend/resume cycles the display backlight was not re-enabled.
CODESYS *.app files not selectable when creating update
83860/IDE
The update creation tool did not allow to select files with extension .app.
Applications can be downloaded to password-protected units
83948/Updater
If a unit was password-protected it was not possible to download a new application file or write the
EEPROM.
Better visibility of numpad and keypad
85225/RTS
The color scheme of numpad and keypad components have been improved for better contrast.
Settings not saved in Visualization Manager
85315,89466/IDE
Some values regarding the keypad (in Visualization Manager ) were not saved to the project file when
changed.
Support USB drives without partition table
85385/HAL
Mounting USB drives formatted without a partition table led to a segmentation fault.
ECUs not identified when scanning
87038/Updater
ECUs were not identified during device scan when there was high load on the CAN bus.
Assigning textlist strings to labels not possible
87108/IDE
Assigning a textlist entry to property Text of a label as a reference caused a compiler error.
15
88817/Updater
After an application update the version attribute in the APDB was not correct.
Update not possible with USB devices not containing a UUID
91769/Updater
Some USB devices are pre-formatted with a deprecated partition table format that does not have a
unique identifier. Updates contained on such USB drives did not succeed to execute.
ECUs not reset after update
93082/Updater
ECUs were not automatically restarted after they have been updated.
16
6 Known Issues
Segmentation fault during shutdown
58158/RTS
Runtime system crashes with SIGSEGV during shutdown. The runtime system is only shut down on a
power off or restart of the device. The problem will not cause any data loss or damage, the system will
shut down cleanly.
Workaround
None.
Updating device messes up I/O mappings
59533/IDE
In rare cases performing a device update can cause problems in the I/O mappings of device System
and/or the CAN interfaces: duplicated mapping lines, lost variable assignments, duplicate device nodes.
It may also be that some variables do not hold valid values during application runtime.
Workaround
Update the HY-eVision device to CODESYS Control Win V3. After that update again to the appropriate
HY-eVision device as stated in 4.1. During this process all I/O mappings will be erased and need to
be set again. Using File Print... on the System I/O-mapping of your backup project you can print out
all mappings as a guide. Missing CANopen devices can be copied from the backup project and pasted
using Edit Copy and Edit Paste .
Setup does not find required files
60223/Setup
In some cases the IDE setup does not find required files, although they are available. This might occur
due to a corrupt registry.
Workaround
Navigate to the correct source location manually. It is folder instdata in the installation directory. If
the problem persists, please check the solutions provided at
http://support.microsoft.com/mats/Program_Install_and_Uninstall.
Some resources not freed on application reset
61414/OS
Some system resources are not freed when the CODESYS application is ended. After 30 to 40 application start/end cycles (e. g. during development) the application might not start or show unexpected
behaviour.
Workaround
Power-cycle the device.
17
65372/IDE
When draging new elements from the toolbox to a visualization page, sometimes another visualization
element than the selected one is is added.
Workaround
Select the entry in the toolbox by clicking it once before dragging it.
Precompiling gives spurious warnings and errors
74731/IDE
Due to issues CDS-42980 and CDS-42981 precompiling does not work reliably. Thus, CODESYS
feature Underline Errors in the Editor must not be used.
Workaround
Precompiling option is disabled during package installation. If necessary it can be changed under
Tools Options. . . , Category SmartCoding, option Underline Errors in the Editor.
Error when mapping BIT values in I/O mapping
77881/IDE
Due to issue CDS-42502 it is not possible to map variables of type BIT to an I/O mapping. The following
compiler error will be generated: System [Device]: Types of channel and mapped
87107/IDE
If an I/O mapping variable is used only in a place managed by the code generator (e.g. in a POU that is
soley called through OnButtonPress/Release), assignments to this mapping variable are ignored and it
is displayed in grey in the System I/O mapping view.
Workaround
Add a dummy statement (<variable>;) to a POU that is executed by task Visualization.
Camera image may show a white stripe at bottom
91034/RTS
When displaying the camera image on a dark background a thin white stripe may be visible at the very
bottom of the image.
Workaround
If necessary use clipping on the camera texture to remove the stripe.
1.1.0.0
1.2.0.0
1.3.0.0
1.3.1.0
1.4.0.0
1.4.2.0
1.4.2.1
1.6.0.1
1.6.0.2
1.6.0.3
1.6.0.4
1.6.1.0
1.8.0.1
1.10.0.0
1.12.0.1
1.0.6.2
1.1.0.0
1.2.0.0
1.3.0.0
1.4.0.0
1.4.2.0
1.4.2.1
1.6.0.1
1.6.0.2
1.6.0.3
1.6.0.4
1.6.0.5
1.6.1.0
1.6.1.2
1.8.0.1
1.10.0.0
1.12.0.1
1.0.6.2
Target
IDE
7 Appendix
6. . . Incompatible
Q. . . Update
Copyright 2016 TTControl GmbH. All rights reserved.
TTControl GmbH Confidential and Proprietary Information.
l. . . Compatible
19
20
Acronyms
APDB Application Descriptor Block
CAN Controller Area Network
ECU Electronic Control Unit
EEPROM Electrically Erasable Programmable Read-Only Memory
IDE Integrated Development Environment
RTS Runtime System
21
References
[1] TTControl GmbH. Quickstart guide, 01 2016. D-153-GU-20-001, V.1.13.
[2] TTControl GmbH. AN: USB Host Functionality, 08 2011. D-153-AN-20-001, V.1.0.
[3] TTControl GmbH. HY-eVision 10.4 User Manual, 01 2015. D-153-G-02-003, V.1.24.
[4] TTControl GmbH. HY-eVision 7.0 User Manual, 05 2015. D-153-G-02-002, V.1.31.
22
Legal Disclaimer
THE INFORMATION GIVEN IN THIS DOCUMENT IS GIVEN AS SUPPORT FOR THE USAGE OF THE
ECU/DISPLAY UNIT AND SHALL NOT BE REGARDED AS ANY DESCRIPTION OR WARRANTY OF
A CERTAIN FUNCTIONALITY, CONDITION OR QUALITY OF THE ECU/DISPLAY UNIT. THE RECIPIENT OF THIS DOCUMENT MUST VERIFY ANY FUNCTION DESCRIBED HEREIN IN THE REAL
APPLICATION. THIS DOCUMENT WAS MADE TO THE BEST OF TTCONTROLS KNOWLEDGE.
NEVERTHELESS AND DESPITE GREATEST CARE, IT CANNOT BE EXCLUDED THAT MISTAKES
COULD HAVE CREPT IN. TTCONTROL PROVIDES THE DOCUMENT FOR THE ECU/DISPLAY UNIT
AS IS AND WITH ALL FAULTS AND HEREBY DISCLAIMS ALL WARRANTIES OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ACCURACY OR COMPLETENESS, OR OF RESULTS TO THE EXTENT PERMITTED BY APPLICABLE LAW. THE ENTIRE RISK, AS TO THE QUALITY, USE OR PERFORMANCE OF THE DOCUMENT, REMAINS WITH
THE RECIPIENT. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW TTCONTROL
SHALL IN NO EVENT BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOSS OF DATA, DATA BEING
RENDERED INACCURATE, BUSINESS INTERRUPTION OR ANY OTHER PECUNIARY OR OTHER
LOSS WHATSOEVER) ARISING OUT OF THE USE OR INABILITY TO USE THE DOCUMENT EVEN
IF TTCONTROL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
IF THE ECU/DISPLAY UNIT IS MARKED AS PROTOTYPE, THE DELIVERED ECU/DISPLAY UNIT
IS A DEVELOPMENT SAMPLE (SAMPLE). THE RECIPIENT ACKNOWLEDGES THAT HE IS ALLOWED TO USE THE SAMPLE ONLY IN A LABORATORY FOR THE PURPOSE OF DEVELOPMENT.
IN NO EVENT IS HE ALLOWED TO USE THE SAMPLE FOR THE PURPOSE OF SERIES MANUFACTURING.
TTCONTROL PROVIDES NO WARRANTY FOR ITS PRODUCTS OR ITS SAMPLES, INCLUDING
BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW
DISCLAIMS ALL LIABILITIES FOR DAMAGES RESULTING FROM OR ARISING OUT OF THE APPLICATION OR USE OF THESE PRODUCTS OR SAMPLES.
THE EXCLUSION OF LIABILITY DOES NOT APPLY IN CASES OF INTENT AND GROSS NEGLIGENCE. MOREOVER, IT DOES NOT APPLY TO DEFECTS WHICH HAVE BEEN DECEITFULLY
CONCEALED OR WHOSE ABSENCE HAS BEEN GUARANTEED, NOR IN CASES OF CULPABLE
HARM TO LIFE, PHYSICAL INJURY AND DAMAGE TO HEALTH. CLAIMS DUE TO STATUTORY
PROVISIONS OF PRODUCT LIABILTY SHALL REMAIN UNAFFECTED.