List of Abbreviations 3 Release Notes Contact Information 4

Size: px

Start display at page:

Download "List of Abbreviations 3 Release Notes Contact Information 4"

Adrian Cox
5 years ago
Views:

1 Preface 1 Release Notes 2 X-Tools List of Abbreviations 3 Release Notes Contact Information 4 Release Release / 12

2 Safety Guidelines This document contains notices which you should observe to ensure your own personal safety as well as to avoid property damage. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring to property damage only have no safety alert symbol Danger indicates an imminently hazardous situation which, if not avoided, will result in death or serious injury. Warning indicates a potentially hazardous situation which, if not avoided, could result in death or serious injury. Caution used with the safety alert symbol indicates a potentially hazardous situation which, if not avoided, may result in minor or moderate injury. Notice used without the safety alert symbol indicates a potential situation which, if not avoided, may result in an undesirable result or state When several danger levels apply, the notices of the highest level (lower number) are always displayed. If a notice refers to personal damages with the safety alert symbol, then another notice may be added warning of property damage. Qualified Personnel The device/system may only be set up and operated in conjunction with this documentation. Only qualified personnel should be allowed to install and work on the equipment. Qualified persons are defined as persons who are authorized to commission, to earth, and to tag circuits, equipment and systems in accordance with established safety practices and standards. Intended Use Please note the following: Trademarks Warning This device and its components may only be used for the applications described in the catalog or technical description, and only in connection with devices or components from other manufacturers approved or recommended by Siemens. This product can only function correctly and safely if it is transported, stored, set up and installed correctly, and operated and maintained as recommended. All designations marked with are registered trademarks of Siemens AG. Other designations in this documentation might be trademarks which, if used by third parties for their purposes, might infringe upon the rights of the proprietors. Copyright Siemens AG All rights reserved. Reproduction, transmission or use of this document or its contents is not permitted without express written authority. Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserved. Disclaimer of Liability We have checked the contents of this document for agreement with the hardware and software described. Since deviations cannot be precluded entirely, we cannot guarantee full agreement. However, the data in the manual are reviewed regularly, and any necessary corrections will be included in subsequent editions. Suggestions for improvement are welcomed. Siemens AG Industry Sector P.O. Box Nuremberg Germany Siemens AG 2014 Technical data subject to change Release / 12

3 Table of Contents 1 Preface Purpose of this Document Validity of this Document Audience Release Notes Microsoft IEEE1394 Hotfix Number of connectable IEEE1394 Devices Usage of IEEE1394 Cables Usage of multiple CTN WatchGuard T Data Supervision Time for CTN WatchGuard T001 Devices Hibernation Storage on USB Harddrives DirectX Redistributables ION BinaryInput T001 and high Sample Rates Administrator Rights Unsupported Record Mode Changes and Interval Unsupported Data Format Big Endian (Motorola, MSB first) using Bit Arrays Possible Side-Effect at the Moment of File Splitting Massive Amounts of Log Entries may be caused by the Sequence Control Unsupported Update of the ANFs Avg and RMS Unsupported Update of the ANF FFT and of windowing ANFs within Analyzing Scripts Unsupported Update of the ANF OutTCP within Analyzing Scripts Impaired loading of very big Offline Data Files Device Name of ION SIMATIC TDC T001 Devices Legacy IEEE1394 Driver of Windows OPC UA Server Endpoint URL Multiple OPC UA Server Endpoints OPC UA Output Data Table Possible wrong automatic Update of Analyzing Models/User Functions Missing Offset Compensation for ION AnalogInput T001 Devices Too small Ring Buffers may confuse Storage Profiles Automatic Assigning of Sequence IDs can cause Damage Possible wrong first Timestamps from ION SIMATIC TDC T001 Devices No cancelling of the Post Trigger Time through Storage Profiles for offline Data Memory Management Data Snapshots may freeze the X-Tools Client Delay during the Creation of automatic Reports for offline Data /openmvf may discard changed Monitoring Views Possibly not established Connection to Socket Devices... 9 Release / 12

4 2.35 Pausing of Monitoring Views in low Memory Situations Band Recognition through MonSpmEnv() Band Recognition through MonXYEnv() OutV2D(), Unit and Description Big Log Files can not be opened properly Undefined Path when ShllExe() is used with find under Windows 7 or later Conversions between Time Domains can fail Wrong Timestamp Generation in case of OutOrbit() and Interval Only Handling of Gaps within the input Data through the Analyzing System Handling of Gaps within the input Data through the Monitoring System Peaks within the Spectrogram Visualization No Update of Storage ID Values Possibly wrong Calculation of Spp Possibly wrong Memory Management List of Abbreviations Contact Information Release / 12

5 1 Preface 1.1 Purpose of this Document This document contains release notes for the software X-Tools of SIPLUS product line. In order to learn about the usage and functionality of SIPLUS X-Tools, the following documentation is available: X-Tools - User Manual Introduction o provides an introduction into the basic functionalities of X-Tools X-Tools - User Manual Master Data System o provides detailed information about the functionality which is provided by the Master Data System X-Tools - User Manual Main Management System o provides detailed information about the functionality which is provided by the Main Management System X-Tools - User Manual Device Management System o provides detailed information about the functionality which is provided by the Device Management System X-Tools - User Manual Monitoring System o provides detailed information about the functionality which is provided by the Monitoring System X-Tools - User Manual Analyzing System o provides detailed information about the functionality which is provided by the Analyzing System X-Tools - User Manual Storage System o provides detailed information about the functionality which is provided by the Storage System X-Tools - Change Log o provides an overview about the changes which have been introduced with the current version of X-Tools 1.2 Validity of this Document This document is valid for the following software: X-Tools Pro V X-Tools ODV V During the following pages, these software packages will be referred to by the term X-Tools. 1.3 Audience This document is intended for personnel involved in the commissioning and using of the software: X-Tools Release / 12

6 2 Release Notes 2.1 Microsoft IEEE1394 Hotfix On some computers with Windows XP SP2 or Windows XP SP3 it has been observed that Windows does not recognize the detach of IEEE1394b devices, like IFNs or RPNs. In the error case, the Device Manager of Windows still shows the detached devices as to-be-present and accordingly also X-Tools can not recognize the detach. In order to solve this issue, Microsoft provides an according hotfix (958347). After the hotfix has been installed, detaching of IEEE1394b devices is recognized properly again. The hotfixes for the following operating systems are being delivered together with X-Tools (see the Hotfixes subdirectory of the installation media): Microsoft Windows XP SP3,, x86 Microsoft Windows XP SP3, German, x86 In case you are using another operating system or another language, please download the according version of the hotfix from Microsoft directly: Install this hotfix in case your computer does not recognize the detach of IEEE1394b devices correctly. 2.2 Number of connectable IEEE1394 Devices The maximum number of devices which shall be connected via IEEE1394 is restricted to 30 participants. 2.3 Usage of IEEE1394 Cables Do not to use cables for the electrical connection of IEEE1394 with a length of 0,5 m or with a length of longer than 4,5 m. 2.4 Usage of multiple CTN WatchGuard T001 It is not possible to use multiple CTN WatchGuard T001 at once at the same computer. 2.5 Data Supervision Time for CTN WatchGuard T001 Devices The data supervision which is configured within the Device Profile of CTN WatchGuard T001 devices must be configured to 1.5 or more seconds. 2.6 Hibernation Hibernation must be disabled at the computer while it is running X-Tools. 2.7 Storage on USB Harddrives It is not recommended to use the disk clean-up types Delete old Files and Limit used Memory in combination with USB HDD devices. 2.8 DirectX Redistributables In seldom cases Setup.exe is unable to properly determine the currently installed version of the DirectX redistributables. In case X-Tools is unable to use DirectX for the visualization within the Monitoring System, switch to OpenGL via the Global Options or try to install the DirectX redistributables manually. 2.9 ION BinaryInput T001 and high Sample Rates In case higher sample rates (> 50 khz) are being configured for an ION BinaryInput T001, starting of the according Device Profile can fail in rare cases. In most cases the internal data supervision is able to resume the Release / 12

7 Device Profile automatically. However, it can become necessary to stop and start the affected Device Profile manually in such a case Administrator Rights Setup.exe must be executed with Windows administrator rights in order to be able to install all redistributable files properly Unsupported Record Mode Changes and Interval Within Device Profiles the Record Mode Changes and Interval can not be used within the actual version of X- Tools Unsupported Data Format Big Endian (Motorola, MSB first) using Bit Arrays Using Bit Arrays in Device Profiles the Data Format Big endian (Motorola, MSB first) can not be used within the actual version of X-Tools Possible Side-Effect at the Moment of File Splitting In case of machines with low performance and high amount of tasks, the available resources at the moment of the file splitting can be reduced so that other parts of the system are influenced. In such situations, messages about data supervision events and/or about past/future time errors can occur. In order to avoid such situations and the involved data loss for a short moment of time, a faster machine must be used and/or less tasks must be configured. In cases which are close to the limit of the used machine, also setting of the data supervision time to e.g. 10 seconds can reduce this effect Massive Amounts of Log Entries may be caused by the Sequence Control The sequence control can be used in order to automatically start and stop any other Configuration File. Each of such operation causes one or more entries to the System Log and each entry consumes a few bytes of memory, thus the overall memory usage of the X-Tools Server may be rising constantly in case of control scripts which produce a lot of entries to the System Log. Via the General logging Mode setting from the global options of the X-Tools Server, the amount of stored log entries can be reduced Unsupported Update of the ANFs Avg and RMS The input argument has been changed from PeriodOfTime to NumberOfPoints after V In case an Analyzing Model File or an Analyzing Script File from a version before V SP1 is used, this value has to be adapted accordingly Unsupported Update of the ANF FFT and of windowing ANFs within Analyzing Scripts The input argument NumberOfPoints has been removed from all windowing ANFs ( AppBhann, AppBlack, AppBlett, AppHamm, AppHann ) and from the ANF FFT after V Now the number of points will be taken from the connected ANF Bffr. In case an Analyzing Script File from a version before V SP1 is used, the no more existing input argument has to be removed from the Analyzing Script code Unsupported Update of the ANF OutTCP within Analyzing Scripts The input argument Mode has been removed from the ANF OutTCP after V In case an Analyzing Script File from a version before V SP1 is used, the no more existing input argument has to be removed from the Analyzing Script code Impaired loading of very big Offline Data Files X-Tools may be unable to load offline data files with a size of 100 MBytes or more. In case the offline data files are too big, also an interval-based loading mode can fail because of insufficient RAM. The only possibility to Release / 12

8 load parts of such big offline data is to use a Time Input Mode of Minimum Time and Time Interval, Minimum Time and Maximum Time or Time Interval and Maximum Time and to specify a smaller period of time of the offline data file for the loading Device Name of ION SIMATIC TDC T001 Devices In case an ION SIMATIC TDC T001 is renamed via the DMS Explorer of the X-Tools Client and in case the new name is longer than 200 characters, the used TDC rack can fall into a system error. A restart of the TDC rack is necessary in this case Legacy IEEE1394 Driver of Windows 7 Microsoft Windows 7 is delivered with two versions of the basic IEEE1394 bus driver: The so-called new driver with advanced support for IEEE1394b devices and the so-called legacy driver. In case the new driver is installed and the IEEE1394 devices are not detected or operating properly, the legacy driver must be installed. The legacy driver also must be installed in case the used IEEE1394 host adapter uses an IEEE PHY. Refer to the user manual for detailed information about how to switch between the new and the legacy driver OPC UA Server Endpoint URL The X-Tools Server uses the combination of Domain Name/IP Address and the port number as endpoint URL to connect to an OPC UA server. It does not read the provided endpoint URL from the OPC UA server. In case the OPC UA server needs the exact endpoint URL definition, the X-Tools Server may not be able to connect to this OPC UA server. Examples: IP Address = , Port = 4841 o the resulting Endpoint URL would be opc.tcp:// :4841 Domain Name = Localhost, Port = o the resulting Endpoint URL would be opc.tcp://localhost: Multiple OPC UA Server Endpoints The X-Tools Server does not support multiple endpoint URLs. In case the OPC UA server provides more than one endpoint URL, the X-Tools Server tries to connect in the same way as described above OPC UA Output Data Table Cyclically writing of values to OPC UA variables (Output Data Table in OPC UA Device Profile) will not work, if there is no variable defined for reading (Input Data Table in OPC UA Device Profile). You have to add as minimum one variable to the Input Data Table. This input variable can be disabled, so it will not appear as Online Data in the MDS Explorer Possible wrong automatic Update of Analyzing Models/User Functions In case the new version of an Analyzing Function provides a smaller amount of configurable input or output arguments, the automatic update through the AME Standard T001 or UFE Standard T001 may fail Missing Offset Compensation for ION AnalogInput T001 Devices The hardware offset of ION AnalogInput T001 devices is not compensated during the measurement. Therefore, the measured values from the 8 channels can be different by several digits Too small Ring Buffers may confuse Storage Profiles In case the ring buffer of an offline data is much too small (e.g. it is overwritten multiple times per second), a Storage Profile which is using this online data as input may not detect this error and can produce unwanted results without a notification to the user. Release / 12

9 2.27 Automatic Assigning of Sequence IDs can cause Damage In case of Analyzing Models/User Functions which use recursion, the automatic assigning of sequence IDs can result in an order of sequence which does not allow the desired calculation to run properly Possible wrong first Timestamps from ION SIMATIC TDC T001 Devices The first timestamps which are delivered by an ION SIMATIC TDC T001 directly after the start of its Device Profile can be wrong. They can cause log entries about timestamp errors after the start No cancelling of the Post Trigger Time through Storage Profiles for offline Data Storage Profiles which use offline data as input do not cancel the post trigger time even in case a start event occurs during the post trigger time Memory Management Although the memory management has been significantly improved in V 03.05, it is not able to cover all possible effects of low memory. The current memory management does not consider the fragmentation of the address room of the process, it does not use a totally deterministic approach for the order of Configuration Files and it does not react in case the maximal free block of the process drops too low. The possible effects are that the status of currently suspended and running Configuration Files is dependent to values which are not clearly visible to the user and that the status can be different for the same Configuration Files at different moments in time Data Snapshots may freeze the X-Tools Client In case a to-be-created data snapshot has to process a big amount of data, the X-Tools Client could freeze during this time Delay during the Creation of automatic Reports for offline Data Monitoring Views which create reports on base of offline data may wait up to one second after each created report. This delay can cause a long processing time in case of long offline data and/or a lot of to-be-created reports /openmvf may discard changed Monitoring Views In case /openmvf is used in order to open an already opened Monitoring View and in case this already opened Monitoring View contains unsaved changes, /openmvf discards all of these changes and opens the Monitoring View according to the current settings within the file at the disk Possibly not established Connection to Socket Devices In case an Interface Profile for socket devices was paused it may not be able to establish the connection to its configured devices after it is continued Pausing of Monitoring Views in low Memory Situations Pausing of Monitoring Views may fail in case there is not enough memory available for the copying of the currently displayed online data Band Recognition through MonSpmEnv() The upper and lower bands which are provided via the inputs of the Analyzing Function MonSpmEnv() must provide a valid spectrum at the moment of the first call (= at the first cycle of the parent Analyzing Model/Analyzing Script) of MonSpmEnv(). This Analyzing Function always uses the band information from this first call for the further monitoring and would use amplitudes of 0 for the monitoring in case no valid spectrum is provided at the first call. Release / 12

10 2.37 Band Recognition through MonXYEnv() The upper and lower bands which are provided via the inputs of the Analyzing Function MonXYEnv() must provide a valid buffer at the moment of the first call (= at the first cycle of the parent Analyzing Model/Analyzing Script) of MonXYEnv(). This Analyzing Function always uses the band information from this first call for the further monitoring and would use values of 0 for the monitoring in case no valid buffer is provided at the first call OutV2D(), Unit and Description The unit and the description which are passed to OutV2D() are not added to the created output data Big Log Files can not be opened properly Log files with a size of 1 GByte or more can not be opened and displayed properly Undefined Path when ShllExe() is used with find under Windows 7 or later In case the Analyzing Function ShllExe() is used under Windows 7 or later with the find parameter, it does not open the search window for the specified path. This is an issue of Microsoft Windows 7 and later and not an error inside ShllExe() Conversions between Time Domains can fail Analyzing Models and Analyzing Scripts which are configured for action based calculations suspend in case they shall output absolute timestamps and the input data contains relative timestamps (or vice versa) and when in addition a text is used as time input format for the minimum and/or maximum time Wrong Timestamp Generation in case of OutOrbit() and Interval Only In case the Analyzing Function OutOrbit() is configured to Interval Only, the created timestamps can be wrong Handling of Gaps within the input Data through the Analyzing System The Analyzing System may suspend and create log entries each time when it reaches a gap within the to-beprocessed input data Handling of Gaps within the input Data through the Monitoring System The Monitoring System does not show gaps within its input data and does not show the values of its input properly in some cases Peaks within the Spectrogram Visualization The Spectrogram mode of the MTC ynt T001 may not show all of the peak values which are present within the displayed data No Update of Storage ID Values The value of the storage ID which is used for directory names is always the value of the associated data from the moment at which the storing was started. This value is not updated at the moment of a file splitting Possibly wrong Calculation of Spp The Analyzing Function Orbit() may calculate wrong positions for Spp Possibly wrong Memory Management The internal memory management may not be able to detect the available memory properly in all cases. As a result, it may not be able to start/use Configuration Files even in case there seems to be enough memory available. Release / 12

11 3 List of Abbreviations Abbreviation ANF AME ANS ANX ASE CTN DMS DMX DPE GOE IFN ION IPE LPE MDS MDX MMS MMX MPE MTC MTS MTX MVE ODL RPN UAE SLV SPE STS STX UPS XTC XTS Description Analyzing Function Analyzing Model Editor Analyzing System Analyzing System Explorer Analyzing Script Editor Control Node Device Management System Device Management System Explorer Device Profile Editor Global Options Editor Interface Node I/O-Node, Input/Output-Node Interface Profile Editor Loading Profile Editor Master Data System Master Data System Explorer Main Management System Main Management System Explorer Main Profile Editor Monitoring Chart Monitoring System Monitoring System Explorer Monitoring View Editor Offline Data Loader Repeater Node User Accounts Editor System Log Viewer Storage Profile Editor Storage System Storage System Explorer Uninterruptible Power Supply X-Tools Client X-Tools Server Release / 12

12 4 Contact Information Should you have any questions concerning the software application, please refer to the Industry Sector Technical Support. Department Siemens AG Industry Sector Phone +49 (0) (Monday to Friday, 09:00 am to 05:00 pm CET/CEST) Fax +49 (0) Internet Thank you for using one of the above mentioned contacts to ensure your inquiry is registered and can be processed. Release / 12

Preface 1. Device Management System 2. Contact Information 3. User Manual Device Management System. English. Release

Preface 1. Device Management System 2. Contact Information 3. User Manual Device Management System. English. Release X-Tools - User Manual - 04 - Device Management System Preface 1 Device Management System 2 Contact Information 3 X-Tools User Manual - 04 - Device Management System Release 2015-11 Release 2015-11 1 /