Date: July 2019 README.TXT for TekExpress Industrial Ethernet Solution Software: v1.0.0 Win 10 64 bit Contents of this Readme File: 1. Introduction 2. Before you click "RUN" 3. TekExpress Industrial Ethernet Application related changes in your system 4. Supported Tests for IEEE P802.3cg™/D3.0 Transmitter Electrical Specifications for 10 Base-T1L 5. Supported list of equipment and accessories 6. Known Limitations 6.1 TekExpress Industrial Ethernet application related limitations 6.2 TekExpress Industrial Ethernet application known issues 7. Installer Related Instructions 8. Software Licenses 9. Contacting Tektronix ================================================================================================= 1. Introduction The Tektronix TekExpress Industrial Ethernet solution provides automated compliance test support for 10 Base-T1L (IEEE P802.3cg™/D3.0) standard for Transmitter electrical specifications tests. Details are available in the Online Help. The compliance software allows for complete or selective testing of any of the transmitter electrical specifications including complete Oscilloscope control of the required setups. Software setup flexibility allows for design validation, margin analysis and repeatable compliance testing while reducing instrument setup difficulties. Additionally, the software can generate a comprehensive date-stamped test report with pass/fail results including Oscilloscope display waveforms and data plots. ================================================================================================= 2. Before you click "RUN" a) Ensure that all the required instruments are properly warmed up, Signal Path Compensation (SPC) is performed, followed by calibration and cable deskew. b) Steps for network drive connection b.1) Background information: After you first launch TekExpress, it creates the following folders on your Computer: "..\Documents\My TekExpress\" ***NOTE. Ensure that the "My TekExpress" folder has full Read and Write access. ***NOTE. If a user with a different Windows login ID launches TekExpress, a new folder is created under "My documents" of new user. "..\Documents\My TekExpress\Industrial Ethernet\" "..\Documents\My TekExpress\Industrial Ethernet\Untitled Session\", This sub-folder is created every time the "TekExpress Industrial Ethernet.exe" is launched and this sub-folder is deleted when you exit application. CAUTION: Each session has multiple files associated with it. Do not modify any of the session files and/or folders as this may result in loss of data or corrupted session files. The "My TekExpress" folder mentioned above is created as a shared folder with share name as ’s My TekExpress ================================================================================================= 3. TekExpress Industrial Ethernet application related changes in your system. After first launch of "TekExpress Industrial Ethernet" following changes take place in your Computer. a) "My TekExpress" folder is created under "Documents" folder of current user NOTE: If a user with new login ID launches "TekExpress Industrial Ethernet", "My TekExpress" folder is created under "Documents" of the new user. b) "Industrial Ethernet" folder is created under "My TekExpress" folder c) "Untitled Session" folder is created under "Industrial Ethernet" folder, note that every time "TekExpress Industrial Ethernet" is launched "Untitled Session" folder is created under "Industrial Ethernet" folder and will be deleted after proper termination of application. d) If user saves a session in TekExpress Industrial Ethernet application, all session files are saved under "Industrial Ethernet" folder. Note that each session has multiple files associated with it and do not tamper with any of the session file(s) and/or folder(s) this may result in loss of data or corrupted session files. =============================================================================================================== 4. Supported Tests for Industrial Ethernet Physical Layer Specification Tests are available for both Pre-recorded Waveform and live Signal inputs: TekExpress Industrial Ethernet application supports the following Transmitter Electrical Specifications Tests for electrical characteristics of Physical Media Attachment (PMA). * 10 Base-T1L (IEEE P802.3cg™/D3.0) tests Transmitter Electrical Specifications Tests: * Test 146.5.4.1 - Transmitter Output Voltage * Test 146.5.4.2 - Transmitter Output Droop * Test 146.5.4.3 - Transmitter Timing Jitter * Test 146.5.4.4 - Transmitter Power Spectral Density (PSD) and Power Level * Test 146.5.4.5 - Transmit Clock Frequency * Test 146.8.3 - MDI Return Loss =============================================================================================================== 5. Supported list of equipment, accessories and software for TekExpress Industrial Ethernet 5.1 Oscilloscopes: * MSO54, MSO56, MSO58, MSO64 (Windows only) 5.2 AFG: * AFG31000 series 5.3 Probes: * P6248 (with TPA-BNC Adapter), P6247 (with TPA-BNC Adapter), TDP1500 5.4 Test Fixtures: * TF-XGBT ================================================================================================= 6. Known Limitations 6.1 TekExpress Industrial Ethernet Application related limitations * You cannot stop or pause MDI Return Loss Calibration RUN during its execution. 6.2 TekExpress Industrial Ethernet Application Known issues * Measurement unit for PSD is incorrect in statistics table in report. * If TekScope application window is minimized, the scope graticule screenshot in the report will be blank. It is recommended to keep TekScope application window maximized. * Ensure that the scope is restarted after installing Industrial Ethernet application and for the first time after launch Go to Options --> Instrument Control Settings --> CLICK on Refresh button. This will list the instruments. This step must be performed before using the solution. * Oscilloscope takes a long time to boot, this is due to instruments being discovered through LAN. You can unplug the LAN cable or wait for some time until it launches. ================================================================================================= 7. Installer Related Instructions: * Installation of TekExpress Industrial Ethernet Application and other software packages are installed on C: drive only. Ensure sufficient free space on C: drive. ================================================================================================= 8. Software Licenses Newtonsoft.Json Copyright (c) 2007 James Newton-King Tektronix has incorporated Newtonsoft.Json into the TekScope applications which is an open source component. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Intel(R) Integrated Performance Primitives (Intel IPP) Tektronix has incorporated Intel(R) Integrated Performance Primitives (Intel IPP)into the TekScope application under the agreement of the end user license. Copyright (c) 2018 Intel Corporation. Use and Redistribution. You may use and redistribute the software (the “Software”), without modification, provided the following conditions are met: * Redistributions must reproduce the above copyright notice and the following terms of use in the Software and in the documentation and/or other materials provided with the distribution. * Neither the name of Intel nor the names of its suppliers may be used to endorse or promote products derived from this Software without specific prior written permission. * No reverse engineering, decompilation, or disassembly of this Software is permitted. Limited patent license. Intel grants you a world-wide, royalty-free, non-exclusive license under patents it now or hereafter owns or controls to make, have made, use, import, offer to sell and sell (“Utilize”) this Software, but solely to the extent that any such patent is necessary to Utilize the Software alone. The patent license shall not apply to any combinations which include this software. No hardware per se is licensed hereunder. Third party and other Intel programs. “Third Party Programs” are the files listed in the “third-party-programs.txt” text file that is included with the Software and may include Intel programs under separate license terms. Third Party Programs, even if included with the distribution of the Materials, are governed by separate license terms and those license terms solely govern your use of those programs. DISCLAIMER. THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT ARE DISCLAIMED. THIS SOFTWARE IS NOT INTENDED FOR USE IN SYSTEMS OR APPLICATIONS WHERE FAILURE OF THE SOFTWARE MAY CAUSE PERSONAL INJURY OR DEATH AND YOU AGREE THAT YOU ARE FULLY RESPONSIBLE FOR ANY CLAIMS, COSTS, DAMAGES, EXPENSES, AND ATTORNEYS’ FEES ARISING OUT OF ANY SUCH USE, EVEN IF ANY CLAIM ALLEGES THAT INTEL WAS NEGLIGENT REGARDING THE DESIGN OR MANUFACTURE OF THE MATERIALS. LIMITATION OF LIABILITY. IN NO EVENT WILL INTEL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. YOU AGREE TO INDEMNIFY AND HOLD INTEL HARMLESS AGAINST ANY CLAIMS AND EXPENSES RESULTING FROM YOUR USE OR UNAUTHORIZED USE OF THE SOFTWARE . No support. Intel may make changes to the Software, at any time without notice, and is not obligated to support, update or provide training for the Software. Termination. Intel may terminate your right to use the Software in the event of your breach of this Agreement and you fail to cure the breach within a reasonable period of time. Feedback. Should you provide Intel with comments, modifications, corrections, enhancements or other input (“Feedback”) related to the Software Intel will be free to use, disclose, reproduce, license or otherwise distribute or exploit the Feedback in its sole discretion without any obligations or restrictions of any kind, including without limitation, intellectual property rights or licensing obligations. Compliance with laws. You agree to comply with all relevant laws and regulations governing your use, transfer, import or export (or prohibition thereof) of the Software. Governing law. All disputes will be governed by the laws of the United States of America and the State of Delaware without reference to conflict of law principles and subject to the exclusive jurisdiction of the state or federal courts sitting in the State of Delaware, and each party agrees that it submits to the personal jurisdiction and venue of those courts and waives any objections. The United Nations Convention on Contracts for the International Sale of Goods (1980) is specifically excluded and will not apply to the Software. *Other names and brands may be claimed as the property of others. WKTOpdf Copyright (C) 2010 wkhtmltopdf/wkhtmltoimage Authors. wkhtmltopdf 0.12.1.2 will be installed along with TekScope applications. It is an open source (LGPLv3) command line tools to render HTML into PDF using the QT Webkit rendering engine. This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library. For programs licensed under the GNU General Public License (GPL) or Lesser GNU General Public License (LGPL)the complete corresponding sources are available. You can order a CD containing the sources from us for a period of three years after download of the software, by sending a written request to: Chief Intellectual Property Counsel, Tektronix, Inc. MS 50/LAW 14150 SW Karl Braun Dr. Beaverton OR, 97077 This offer is valid to anyone in receipt of this information. Your request should include: (i) the name of the product, (ii) your (company) name, and (iii) your return mailing and email address (if available). Please note that we may charge you a fee to cover the cost of performing this distribution. ================================================================================================= 9. Contacting Tektronix MyTek - One way to receive timely information on new software updates, new products from Tektronix and other useful information is to join the Tektronix community. Visit www.tek.com/userto become a member. Product Support - For application-oriented questions about a Tektronix measurement product, in North America call 1-800-833-9200 option 3, Monday-Friday, 6:00AM - 5:00PM Pacific Time or contact us by email at techsupport@tektronix.com. For service support call 1-800-833-9200 option 2, Monday-Friday, 5:00AM-5:00PM Pacific Time or contact us by email at meas-svc-feedback@tektronix.com Outside of North America: please contact your local Tektronix Sales or Distributor office. Refer to our web site at www.tek.com for listings of those offices. For all other information call 1-800-833-9200, visit our web site at www.tek.com, or write to us at: Tektronix, Inc. P.O. Box 500 Beaverton, OR 97077