AEF Conformance Test System Getting Started Guide
AEF Conformance Test System Getting Started Guide
AEF Conformance Test System Getting Started Guide Rev 0 1 2 3
Revision 3
Author
REVISION HISTORY Date Description of Change First Draft 7/17/12 Changed Tools locations 11/9/12 Added Test result information 11/29/12 Changed SUT screen and added TestStand Version Selector information
Page 2 of 28
AEF Conformance Test System Getting Started Guide TABLE OF CONTENTS 1
Overview ..................................................................................................................... 5 1.1 Scope .................................................................................................................... 5 1.2 Acronyms.............................................................................................................. 5 1.3 References ............................................................................................................ 5 2 Getting Started............................................................................................................ 5 2.1 Items needed prior to running the AEF ISOBUS Conformance Test .................... 5 2.2 Files for the Conformance Test ............................................................................ 6 2.2.1 Configuration Files ........................................................................................ 6 2.3 File locations for the Conformance Test .............................................................. 7 2.4 Starting the AEF ISOBUS Conformance Test ........................................................ 7 2.5 Edit the location of the Configuration File Paths file ........................................... 9 2.6 Edit the Test Environment xml file ....................................................................... 9 2.7 Edit the Test Lab Configuration xml file ............................................................. 11 2.8 Create the SUT Description xml file ................................................................... 12 2.9 Edit the Configuration File Paths xml file ........................................................... 15 2.10 Open and run the AEF Conformance Test ......................................................... 16 Appendix A Conformance Tool File Locations .................................................................. 18 A.1 Configuration Files ............................................................................................. 18 A.2 Tools ................................................................................................................... 18 A.3 Simulators........................................................................................................... 18 A.4 Test Sequences ................................................................................................... 18 A.5 Log Files .............................................................................................................. 18 A.6 Object Pools ....................................................................................................... 18 A.7 SUT Description Files .......................................................................................... 18 A.8 Test Reports for individual tests ........................................................................ 18 A.9 Test report for database submission ................................................................. 18 Appendix B AEF Conformance Tool Installation Instructions ........................................... 20 B.1 Installing the AEF Conformance Tool ................................................................. 20 B.1.1 AEF ISOBUS Conformance Tester Install ..................................................... 20 B.1.2 Start Installation.......................................................................................... 20 B.1.3 Installation Complete .................................................................................. 20 Appendix C TestStand Installation Instructions ................................................................ 21 C.1 Installing TestStand 2010 Sp1 ............................................................................ 21 C.1.1 Self-Extractor .............................................................................................. 21 C.1.2 Unzip OK...................................................................................................... 21 C.1.3 Start Screen ................................................................................................. 21 C.1.4 Welcome Screen ......................................................................................... 22 C.1.5 Destination Directory .................................................................................. 22 C.1.6 Features ...................................................................................................... 23 C.1.7 Product Notifications .................................................................................. 23
Revision 3
Page 3 of 28
AEF Conformance Test System Getting Started Guide C.1.8 C.1.9 C.1.10 C.1.11 C.1.12 C.1.13 C.1.14 C.1.15 C.1.16 C.1.17
Revision 3
License Agreement ..................................................................................... 24 Start Installation.......................................................................................... 24 Installation Complete .................................................................................. 25 License Activation ....................................................................................... 25 NI Activation Wizard registration ............................................................... 26 NI Activation Wizard - Enter Serial Number ............................................... 26 NI Activation Wizard - User registration ..................................................... 27 NI Activation Wizard - User name and company ........................................ 27 Product Activated ....................................................................................... 28 Restart ......................................................................................................... 28
Page 4 of 28
AEF Conformance Test System Getting Started Guide
1 Overview The AEF ISOBUS Conformance Test Suite consists of a family of related tools and utilities centered on the National Instruments (NI) TestStand™ commercial product that will facilitate automated execution of conformance tests necessary to verify compliance with the interoperability objectives of ISO11783.
1.1 Scope This scope of this document describes the steps to follow to get started using the AEF ISOBUS Conformance Tester and its associated tools. Descriptions will be provided for running the Conformance Tester, the Configuration Tools, File locations and the minimum entries needed to setup configuration files and running of tests.
1.2 Acronyms
SUT PGN AEF CF
Acronym
Description
System Under Test Parameter Group Number Agricultural Industry Electronics Foundation Control Function
1.3 References [1] ISO11783
2 Getting Started 2.1 Items needed prior to running the AEF ISOBUS Conformance Test 1. CAN Interface hardware type – The following devices have been verified to operate with the Conformance Test: a. Peak USB b. Vector c. Sontheim d. National Instruments USB-CAN 2. TestStand 2010 SP1.
Revision 3
Page 5 of 28
AEF Conformance Test System Getting Started Guide a. If TestStand is not installed, download the TestStand 2010 SP1 installer from the Conformance test section on the AEF Database by selecting the “Download NI Teststand” button. b. Follow the instructions in Appendix C to install TestStand 2010 SP1. c. If a different version of TestStand is installed, use the TestStand Version Selector and select 2010 SP1 (4.5.1) and Make Active. This will set the TestStand Evnironment variables to the correct version. 3. AEF Conformance Tool a. If the AEF Conformance Tool is not installed, download the Conformance Test installer from the Conformance test section on the AEF Database by selecting the “Download Conformance test” button. b. Follow the instructions in Appendix B to install the AEF Conformance Tool. 4. System Under Test (SUT) description – this system needs to have at least one Control Function identified by an ISO NAME: a. The ISO NAME contains the following items: • Self-Configurable Address bit • Industry Group • Device Class Instance • Device Class • Function • Function Instance • ECU Instance • Manufacturer Code • Identity Number
2.2 Files for the Conformance Test The Conformance Test uses multiple files to setup and run the tests. These files break down into: 1. Configuration Files 2. Tools 3. Test Sequences 4. Simulators 5. Log Files 6. Object Pools
2.2.1 Configuration Files The Configuration Files are xml files that are used by the Conformance Test to allow for multiple configurations of computers, interface hardware and devices that are being tested. The descriptions of these files are as follows:
Revision 3
Page 6 of 28
AEF Conformance Test System Getting Started Guide 1. Configuration File Paths This file is the first file that is loaded when the test is started. It is used by the Conformance Test to load the Test Lab Configuration File, the SUT Description File, the Test Environment Configuration File, the User Prompt file and the Log File location. 2. Test Lab Information This file contains information about the Location and the operator of the Conformance Test. This includes the name of the Test Lab, The Address, The Tester name and the Certification level of the Test Lab. This information is printed in the header of the result file. 3. Test Interface Hardware Environment This file contains information about the ISOBUS CAN simulators and Hardware that is used by the Conformance Test. This file is used to change the type of CAN adapter that will be used by the Conformance test. 4. SUT Description This file contains the information about the device that will be tested. The SUT Description contains all of the information for the each of the Control Functions that the device contains. This is used by the test to determine what tests to run and to provide data for comparison while the test is running. 5. User Prompt Directory This is used by the test to provide a location of the descriptions for manual operation and images that may be needed to verify operation of the device.
2.3 File locations for the Conformance Test The files and folder locations used by the Conformance Test are listed in Appendix A.
2.4 Starting the AEF ISOBUS Conformance Test To run the Conformance Tester, select Start> All Programs >AEF >ISOBUS Test >Conformance Tester or select the Conformance Test shortcut on the desktop (Figure 1). This will start the AEF Conformance Test (Figure 2).
Revision 3
Page 7 of 28
AEF Conformance Test System Getting Started Guide
Figure 1
Figure 2
Revision 3
Page 8 of 28
AEF Conformance Test System Getting Started Guide
2.5 Edit the location of the Configuration File Paths file To set up the location of the ConfigurationFilePaths.xml file for first time use, Select Tools> Set Configuration File Path This will launch the editor for the Configuration File Path (Figure 3). 1
2
3
Figure 3
1. Press the “Browse” button and navigate to the StationXMLFiles folder and open the ConfigurationFilePaths.xml file. 2. To save your changes, press the “Save” button. 3. Close the Test Environment Editor. 4. Re-start the AEF Conformance Tool
2.6 Edit the Test Environment xml file To set up the test environment the first time, Select Tools> Edit TestEnvironment Configuration This will launch the editor for the Test Environment (Figure 4).
Revision 3
Page 9 of 28
AEF Conformance Test System Getting Started Guide
3
4
1
2
Figure 4
1. Select File>Open or select the Open icon and browse to the StationXMLFiles folder and open the TestEnvironmentTwoSims.xml file. 2. In the CAN Interface column on the first row, change the selection to the type of CAN hardware you are using. Leave the CAN Interface on the second row set to Peak USB. 3. To save your changes, Select File>Save or press the Save icon. 4. Close the Test Environment Editor.
Revision 3
Page 10 of 28
AEF Conformance Test System Getting Started Guide
2.7 Edit the Test Lab Configuration xml file To set up the Test Lab information, Select Tools> Edit Test Lab Configuration This will launch the editor for the Test Lab (Figure 5). 1 6
7
2
3 4 5
Figure 5
1. Select File>Open or select the Open icon and browse to the StationXMLFiles folder and open the TestLab.xml file. 2. In the Test Lab field, enter the name of the company. 3. In the Address field, enter the address of the company. 4. In the Tester field, enter the name individual who is running the tests. 5. In the Certification field, enter the Certification Level. 6. To save your changes, Select File>Save or press the Save icon. 7. Close the Test Lab Editor.
Revision 3
Page 11 of 28
AEF Conformance Test System Getting Started Guide
2.8 Create the SUT Description xml file To create a file that describes the unit that you are testing, Select Tools> SUT Description Editor This will launch the editor for the SUT Description (Figure 6).
1
3
2
4
5
6
7
Figure 6
To create a new SUT Description file, 1. Enter a Product Name. The product name is required as an entry for the AEF database. 2. Enter a Hardware Version. 3. Enter the amount of time that it takes the SUT to perform the address claim after power is applied. 4. Enter the amount of time that it takes for the SUT to power down and stop transmitting. 5. Enter a name for the Control Function. If the SUT has multiple Control Functions, enter each of the control functions in the table. 6. The “DELETE” button will remove a CF from the SUT Description file. 7. Select the “EDIT” button to add the specific entries for this Control Function. Pressing this button opens a new dialog with specifics for this CF.
Revision 3
Page 12 of 28
AEF Conformance Test System Getting Started Guide 8. Select the “General Information” tab to enter the ISO NAME information. 8
11
10 9
Figure 7
9. Enter the ISO NAME from a CAN trace or enter each of the ISO NAME elements. 10. Enter the Default Address used by the CF. 11. Close the window. This completes the editing of this CF for the minimum required data. If the SUT has additional CFs, repeat steps 7 through 12 for each CF. For information regarding the rest of the entries for the CF, refer to the SUT Description Editor Users Manual
Revision 3
Page 13 of 28
AEF Conformance Test System Getting Started Guide 12. To save your changes, Select File>Save (Save As) or press the Save icon. Create a descriptive name for your device and save the file to the SUT Descriptions Folder. The editor will save your file with this filename and also create a zip file with the same name. 13. Close the SUT Description Editor.
13
12
Figure 8
Revision 3
Page 14 of 28
AEF Conformance Test System Getting Started Guide
2.9 Edit the Configuration File Paths xml file To select a SUT Description for running the Conformance Test, the SUT Configuration File Path in the Configuration File Path xml file needs to be updated. To edit this file, Select Tools> Edit Configuration File Paths This will launch the editor for the Configuration File Paths (Figure 10). 1
3 4
2
Figure 9
1. Select File>Open or select the Open icon and browse to the StationXMLFiles folder and open the ConfigurationFilePaths.xml file. 2. Press the Browse button for the SUT Configuration File Path and browse to the SUTDescriptions folder. Select the xml file that was previously created. 3. To save your changes, Select File>Save or press the Save icon. 4. Close the Test Lab Editor.
Revision 3
Page 15 of 28
AEF Conformance Test System Getting Started Guide
2.10 Open and run the AEF Conformance Test 1
2
Figure 10
1. Select File>Open or browse to the Test Sequences folder and ISO11783-01001.seq file. 2. Select Execute>Single Pass or press the ‘Single Pass’ button. This will start the execution of the test. The test loads all of the xml files and runs the tests based on the CF data. If the SUT description has more than one CF, the test will ask which CF you want to run. When the test is complete, a report will be generated (Figure 11). 3. If the test is performed more than 1 time, the results of the all of the tests are available in this location. 4. Press the “Sequence Files” or “Executions” to switch back and forth between the test sequences and the completed runs. 5. During the test, CAN simulators will run. The AEF Simulator Framework (Figure 13) and other simulators (Task Controller and GPS) will run during different parts of the tests. 6. The following results are available after running the ISO11783-01-001 test: a. ISOBUSComplianceCertification.xml database report – This is the file that can be uploaded to the AEF database. This file is saved in the ResultFiles folder in the SUT Description File folder. Revision 3
Page 16 of 28
AEF Conformance Test System Getting Started Guide b. TestStand report – This file is saved in the TestStandFiles folder in the SUT Description File folder. c. Log Files – The CAN traces and other support files are compressed into a zip file and saved in the TestStandFiles folder in the SUT Description File folder.
4
3
Figure 11
AEF Simulator Framework
Figure 12
Revision 3
Page 17 of 28
AEF Conformance Test System Getting Started Guide
Appendix A Conformance Tool File Locations A.1 Configuration Files 1. Windows XP – Documents and Settings\All Users\Documents\AEF\StationXMLFiles 2. Windows 7 – Users\Public\Documents\AEF\StationXMLFiles A.2 Tools 1. Windows XP – Documents and Settings\All Users\Documents\National Instruments\TestStand 2010 SP1\Components \Tools 2. Windows 7 – Users\Public\Documents\National Instruments\TestStand 2010 SP1\Components\Tools A.3 Simulators 1. Windows XP – Documents and Settings\All Users\Documents\AEF\Simulators 2. Windows 7 – Users\Public\Documents\AEF\Simulators A.4 Test Sequences 1. Windows XP – Program Files\AEF\ISOBUS Test\Test Suites 2. Windows 7 (32bit) – Program Files\AEF\ISOBUS Test\Test Suites 3. Windows 7 (64bit) – Program Files (x86)\AEF\ISOBUS Test\Test Suites A.5 Log Files 1. Windows XP – \AEFFiles\LogFiles 2. Windows 7 – Users\Public\Documents\AEFFiles\LogFiles A.6 Object Pools 1. Windows XP – \AEFFiles\ObjectPools 2. Windows 7 – Users\Public\Documents\AEFFiles\ObjectPools A.7 SUT Description Files 1. Windows XP – Documents and Settings\All Users\Documents\AEF\SUTDescriptions 2. Windows 7 – Users\Public\Documents\AEF\SUTDescriptions A.8 Test Reports for individual tests 1. Windows XP – Documents and Settings\All Users\Documents\AEF\TestReports 2. Windows 7 – Users\Public\Documents\AEF\TestReports A.9 Test report for database submission 1. Windows XP – Documents and Settings\All Users\Documents\AEF\SUTDescriptions\ManuName\device1\ResultFiles
Revision 3
Page 18 of 28
AEF Conformance Test System Getting Started Guide 2. Windows 7 – Users\Public\Documents\AEF\SUTDescriptions\ManuName\device1\ResultFiles
Revision 3
Page 19 of 28
AEF Conformance Test System Getting Started Guide
Appendix B AEF Conformance Tool Installation Instructions B.1 Installing the AEF Conformance Tool After downloading the installation file from the database, run the ConformanceTest.exe file. B.1.1 AEF ISOBUS Conformance Tester Install Press the “Yes” button and the file will be extracted to the Temp folder:
B.1.2
Start Installation
Press “Next>>>”
B.1.3 Installation Complete Press “Next>>>”
Revision 3
Page 20 of 28
AEF Conformance Test System Getting Started Guide
Appendix C TestStand Installation Instructions C.1 Installing TestStand 2010 Sp1 After downloading the installation file from the database, run the TestStand2010SP1.exe file. C.1.1
Self-Extractor
Press the Unzip button and the file will be extracted to the location in the Unzip to folder:
C.1.2
Unzip OK
Press the OK Button
C.1.3
Start Screen
Select the “Install NI TestStand 2010 SP1”
Revision 3
Page 21 of 28
AEF Conformance Test System Getting Started Guide C.1.4
Welcome Screen
Press the “Next >>” button
C.1.5
Destination Directory
Change the default directory if needed, then press the “Next>>” button
Revision 3
Page 22 of 28
AEF Conformance Test System Getting Started Guide C.1.6
Features
The following entries can be unchecked to reduce the install time and options that are not required: User Interfaces, Optional Step Types Tools Press “Next>>”
C.1.7
Product Notifications
Uncheck the checkbox in the Product Notification page then press “Next>>”
Revision 3
Page 23 of 28
AEF Conformance Test System Getting Started Guide C.1.8
License Agreement
Select the “I accept the above “X” License Agreement(s). The X will vary due to how many preloaded programs are on your computer, then press “Next>>”
C.1.9
Start Installation
Press “Next>>”
Revision 3
Page 24 of 28
AEF Conformance Test System Getting Started Guide C.1.10 Installation Complete If you have a serial number to Activate TestStand, leave the checkmark. If not, uncheck the box and press “Next>>” this will take you to B.1.17.
C.1.11 License Activation TestStand will operate in the evaluation mode for 30 days. Starting TestStand without the having the License activated will bring up the following window. In Evaluation mode, the screen will show the number of Fully-Featured days remaining and Total Days remaining. Select Activate here to enter the serial number or Evaluate to continue to use TestStand in the evaluation mode.
Revision 3
Page 25 of 28
AEF Conformance Test System Getting Started Guide C.1.12 NI Activation Wizard registration The Activation Wizard has 3 options to activate the license. Select the one appropriate to how you will need to activate the license.
C.1.13 NI Activation Wizard - Enter Serial Number Depending on the type of license purchased, enter the serial number for that product in the field and press “Next>>” The licenses are as follows: 1. Base Deployment Engine – Allows running of tests but does not have edit capability 2. Custom Sequence Editor – Allows running of tests and the ability to create and edit test sequences in the AEF Conformance Tool environment 3. Debug Deployment Environment – Allows running of tests and the ability to create and edit tests in the native TestStand Sequence editor and in the AEF Conformance Tool environment 4. Development System – Full Development License
Revision 3
Page 26 of 28
AEF Conformance Test System Getting Started Guide C.1.14 NI Activation Wizard - User registration Select an entry for user registration and press “Next>>”
C.1.15 NI Activation Wizard - User name and company Enter data into the fields and press “Next>>”
Revision 3
Page 27 of 28
AEF Conformance Test System Getting Started Guide C.1.16 Product Activated The following screen shows that the license that was successfully activated. Press “Finish”
C.1.17 Restart
Revision 3
Page 28 of 28
