Home

1 - Kozio

1. Use the command kremote run to enable the communications between kDiagnostics and TM KozioServer This kDiagnostics command relies on a number of environment variables for configuring network parameters as described in Section 3 1 NOTE This step is not required if kDiagnostics has been built to automatically run the kremote run command 21 After kremote run 1s executed the remote communications is established the terminal emulation window can no longer be used for communication with the DUT Verify the connection by issuing a host ICMP ping command to the DUT IP address which is stored in the kDiagnostics variable Sip target The following screen capture depicts what would be displayed by kDiagnostics on a terminal emulation screen after the kremote run command is executed E Kozio Tera Term COM6 VT Cc fel File Edit Setup Control Window Help Koz1o kDiagnostics A XScale Processor Detected model IXP465 A1 ID 0x69054201 max core sp eed 667 MHz clock speed 667 MHz 2 bytes 16 bits wide Eee flash block startin TG UART interrupt working snsbi n PCI Interface Bus Device 0 Device 1 Device 2 Device gea Network settings u val ip target ip gateuwa ip netmas ip peer slip target the serial port function function function e a n h n u K Ho NN I Q CA PD PO PO kremote port kremote netdev Starting the kRemote conn
2. F Registration Wizard PES Request License File Select platform and dick Request License This will take you to kozio com where you can complete the licensing process Note that the MAC Address shown below will be transmitted to kozio com This will only be used for generating your license file See www kozio com privacy for our privacy policy First Name Last Name Company Email Address MAC Address A4BA DB BE 50 E8 Platform Please Select BeagleBoard xM 4 5 Status Line Indicators A green status bar located on the Status Line at the botton of ValidationAssistant indicates the status of the test being run A spinning arrow at the bottom left hand side of the screen indicates the DUT is busy executing a command This indicator only appears when the DUT is busy executing a command E The DUT online or offline status 1s located on the status line next to the gt DUT online busy indicator 4 6 Commands The kDiagnostics architecture is built using a hierarchy of commands that range from low level commands for probing the hardware to fully functional test suites that can test every component on the board 38 4 6 1 Executing Commands Use ValidationAssistant to execute test commands on the DUT as specified by the DUT selector on the task bar See Chapter 5 for more information if multiple devices are under test simultaneously ValidationAssistant provi
3. Wh the risks of i t Change scope A b Select the Add Port button Type Kozio Server Port 1 into the Name text box Type 4333 into the Port number text box Select the UDP radio button Select OK This step enables Ethernet communications between the DUT and Kozio Server This port number must match the kozioserver properties file settings and 4333 is the default value c Select the 4dd Port button Type Kozio Server Port 2 into the Name text box Type 4334 into the Port number text box Select the UDP radio button Select OK 15 This step enables Ethernet communications between the DUT and KozioServer This port number must match the kozioserver properties file settings The port number 1s 4333 1 the initial port plus one d Select the Add Port button Type Kozio RMI into the Name text box Type 1099 into the Port number text box Select the UDP radio button Select OK This step enables Ethernet communications between the clients and KozioServer 7 Select OK to close the Windows Firewall dialog box 2 4 Updating a Previous Version of the Host Tools To install or update a new version of the Host Tools back up all test sequence and log files and then uninstall the current version NOTE you will need the install file that you used to install the previous version of the software The
4. 32 p20 channel O channel 1 channel 2 channel 3 addr 0x45004000 bus wi addr 0x48004000 bus wi test 0x45004000 to 0x4 0x45004000 to address Ox 0x48004000 to Ox480050 0x48004000 to Ox4800500 Ka Summary Test Report x SLIG SPI SNIE SPI SLIC SPI SLIC SPI ProSLIc Configuration ProSLIC Configuration de 13 78 COn gt a Passed TEST MiniPCI Burst Access Comprehensive bit test 0x48004000 to 0x48005000 Passed TEST Simultaneous Switching Output Test 32 bit 0x48004000 to 0x48005000 Passed TEST MiniPCI Card O IO Cycles Test Passed TEST MiniPCI Card O Interrupt Test Passed TEST MiniPCI LED GPIO Test All Cards Total 1 MiniPCI cards detected Turning all LEDs and GPIOs on for 3 secondsTurning all LEDs and GPIOs off Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 Unhandled interrupt vector 43 JKozioServer Timeout on Target response Timeout on DUT response Skipping DownloadScript Action named Download 12 Script to Device Under Test Skipping Message Action named Reset Board When Complete Processing Disconnect Action named Disconnect Target lEvent listener thread shut down complete Processing OperatorCorment Action named Operator Note ls Close Save Figure 6 9 SequenceReport
5. Kozio s integrated In System Diagnostics solution includes kDiagnostics The foundational component of Kozio s complete In system Diagnostics platform It is a binary application that executes from the CPU on your embedded system It contains a test and diagnostics interpreter and executive that runs on your target hardware and executes tests under user control from a test library ValidationAssistant a remote interactive hardware debugging and fault isolation tool for engineers working with embedded hardware systems ValidationAssistant runs on any computer in the network and interacts with a test executive running directly on the Device Under Test kDev Allows a developer to extend the capabilities of kDiagnostics by compiling and linking in custom source code test routinesinto new kDiagnostics binaries kPOST Permits kDiagnostics users to ship Kozio s high integrity high coverage test capabilities with their finished products enabling a full hardware check to be performed at every power cycle SequenceRunner Test operator s interface for automated testing and configuration of embedded systems including operator prompting real time functional tests device programming file transfers unique id automation and integrated SQL database for test tracking SequenceRunnerCLI provides the power of ValidationAssistant and SequenceRunner in a simple command line oriented program perfect for power users script
6. gt Windows Firewall a oe General Exceptions Advanced From the Windows task bar select Start EAT indows Firewall is blocking incoming network connections except for the Sele ct Co n tro l Pa ne l 29 programs and services selected below Adding exceptions allows some programs to work better but might increase pour security risk Double click Windows Firewall Select the Exceptions tab Programs and Services Name Adobe Dreamweaver CS3 Adobe Version Cue CS3 Server Adobe Version Cue CS3 Server Adobe Version Cue CS3 Server Adobe Version Cue CS3 Server Adobe Version Cue CS3 Server Bonjour File and Printer Sharing Java TM Platform SE binary Java TM Platform SE binary MW davalTh Platform SF hinan Display a notification when Windows Firewall blocks a program v What are the risks of allowing exceptions Cancel Select the Add Port button Execute these four steps to add all four ports a Select the Add Port button Type TFTP into the Name text box Type 69 into the Port number text box Select the UDP radio button Select OK This step enables Ethernet communications for TFTP file transfers and image downloads Add aPort Use these settings to open a port through Windows Firewall To find the port number and protocol consult the documentation for the program or service you want to use Name TFTP Port number 69 TCP O UDP
7. lt MessageText gt Enter a comment regarding the nature of the failure lt MessageText gt lt OperatorComment gt Below is what the above example looks like with some operator text filled in a Fixture 1 Enter Comment Please enter a comment regarding the nature of the failure I ehtered an invalid DUT test command Figure 5 9 OperatorComment Action Example 5 13 2 11 Prompt Prompt the operator for input Attributes Name ES OkCancel a Timeout Additional Tags lt Title gt lt Image gt lt MessageText gt lt Output gt Example 66 The name of this action as it will appear after Current Action on the SequenceRunner user interface screen The option to display OK and Cancel buttons Permissible values are Yes or No The number of seconds to wait for a response before aborting this action The text that will appear on the dialog s title bar An image to display The text that will appear in the dialog box Either a simple text or HTML formatted text can be used that is contained within a lt CDATA gt tag construct A variable to store results lt Prompt Name Prompt with image display OkCancel Yes Timeout 30 gt lt Title gt Prompt with image display lt Title gt lt Image gt example jpg lt Image gt lt MessageText gt lt CDATA lt html gt lt b gt This prompt displays a picture lt br gt lt br gt There are severa
8. 4 4 Menu Bar 4 4 1 File Menu 4 4 1 1 Log DUT Output On the Menu bar click on File and then on Log DUT Output Fixture 1 Kozio ValidationAssistan File Edit DUT Help E Log DUT Output E Log Commands Load Command Tree Exit This command will bring up a pop up window Type in a file name for the DUT log and click on the Start Logging button This will begin the logging process which logs all interactions with the DUT This 1s useful for sharing information with support or other engineers Look in L ma Recent Items Desktop File name E 4 Files of type My Documenta Kozia DUT Output Log Files txt Start Logging _ 34 A Stop DUT logging command becomes available in the File menu once the logging command has been executed Fixture 1 Kozio ValidationAssistan Edit DUT Help 3 Stop DUT Logging 7 Log Commands Load Command Tree lt i Exit 4 4 1 2 Log Commands Command logging is also available in ValidationAssistant Click on the Log Command menu from the File menu to execute this command This feature logs all commands sent to the target and logs only commands It is useful for capturing commands and then creating a script file of the specific commands you need to execute in order to complete a given task 4 4 1 3 Load Command Tree See Section 4 6 1 for more information on loading the command tree gt Fix
9. All Components Audio devices CPU d Display Devices GPIO 12C Programmed I O RTC SDRAM Suites Diagnostic tests Performance tests Test methods addr start 0x8 1000000 Verify address range pattern a 0x82000000 Display address range window Fill address range pattern Environment Variables Verify address range pattern Smem sdram decode o Memory data bus noise test burst r Test programmed I O bit test Beaute Clear l Close j L Help J Memory march test Memory data bus noise test Simultaneous Switching Output SSC Test programmed I O data pattern Test programmed I O data pattern P Low evel commands Secure Digital MultiMedia Card Timer UART 4 Ly USB Host Controller 4 DUT online 4 11 Performance Tests Some components such as SDRAM have a number of performance tests associated with that component Double click on a performance test to display a characterization of a given performance characteristic A right mouse button pop up menu is available for all Performance Tests One menu option displays help for the command and one executes the command 4 12 Diagnostic Tests A set of diagnostic tests has been built on top of test methods The tests are pre configured for a custom board based on the layout and build of materials for that board design The diagnostic tests deliver a pass fail result and do not require parameters For instance 1f the SDRAM addr
10. Fail Test Date Operator Serial Number Plaiform Failed 2009 04 30 16 11 18 CindyL not set Evaluation Failed 2009 04 30 16 05 19 CindyL _ not set Evaluation Passed 2009 04 23 14 42 47 cindyl20014 not set Passed 2009 04 23 14 30 31 cindyl2001 not set Eva luation Failed 2009 04 23 14 27 30 cindy2001 111223344 _ Evaluation 2009 04 23 14 20 18 cindyl12001 not set Evaluation Passed 2009 04 17 11 03 02 Andrew mpc8377 MPC837xE_RDB _ Passed 2009 04 17 10 08 03 Andrew impc8377 IMPC837xE_RDB Failed 2009 04 17 10 06 33 Andrew impc8377 IMPC837xE_RDB Passed 2009 04 16 18 22 29 Keith 4551 _ MPC837xE_RDB Failed 2009 04 16 18 00 25 Keith 5441 _ MPC837xE_RDB Passed 2009 04 03 11 54 11 Keith 4444 MPC837xE_RDB Passed 2009 04 02 11 49 01 Keith 4567 IMPC837xE_RDB Passed _ 2009 04 01 14 28 57 _ Andrew _ 405ex PPC405ex Kilauea Passed 2009 04 01 13 19 56 Andrew 405ex _ PPC405ex Kilauea Failed 2009 04 01 13 17 19 Andrew 405ex Failed 2009 04 01 13 13 46 Andrew 405ex IPPC405ex Kilauea Failed 2009 04 01 13 08 42 Andrew 405ex IPPC405ex Kilauea Failed 2009 04 01 13 06 56 _ Andrew 405ex PPC405ex Kilauea Passed 2009 03 26 15 19 31 Keith 1560 MPC837xE_RDB Passed 2009 03 26 13 36 22 Keith _ MPC837xE_RDB Passed 2009 03 26 11 25 10 Keith MPC837xE_RDB 6 Passed 2009 03 23 16 49 33 Keith Canyonlands PPC4 36 Passed 2009 03 23 15 25 39 Keith Canyonlands PPCA 36 Failed 2009 03 19 12 03 38
11. GetDatabase Test Action gt lt Table gt common lt Table gt lt RowName gt DebbyTest0022 lt RowName gt lt FieldNumber gt 3 lt FieldNumber gt lt Output gt GetDatabaseOutput lt Output gt lt GetDatabase gt 5 13 2 7 GetFile This test action reads the contents of a disk file and stores that data in a variable Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen FileDialog This optional attribute specifies whether to use a file browser for selecting which file to be read Valid options are yes or no and the default is no do not use a file browser Additional Tags lt Output gt A variable that stores what was read from the file lt FilePath gt Optional field denotes the file path relative to TftpRoot value which is defined in kozioserver properties If omitted file will be placed in TftpRoot lt FileName gt The name of the file to be read Example lt read a file browse for the filename gt 63 lt GetFile Name Read Disk File FileDialog yes gt lt Output gt GetFileContent lt Output gt lt FileName gt GetFileTest xml lt FileName gt lt GetFile gt lt display th file contents gt lt Message Name Data Display OkCancel yes gt lt Title gt File Data lt Title gt lt MessageText gt lt CDATA lt html gt lt b gt The data read was lt b gt lt br gt
12. SLIP for the first time 22 3 2 3 SLIP Create a New Direct Connection Select Start gt Settings gt Control Panel Double Click Network Connections Select File gt New Connection Select Next on the New Connection Wizard dialog box Select Set up an advanced connection and then select Next Select Connect directly to another computer and then select Next Select Guest and then select Next Type Kozio Target in the Computer Name text field and then select Next Choose the correct COM port in the Select a device pull down selection box and then select Next Select the Add a shortcut to this connection to my desktop check box Select Finish 2 4 SLIP Setting the Kozio Target Properties 3 e The Connect Kozio Target dialog should appear immediately following step 1 e Select the Properties button e On the General tab click Configure e Set the Maximum Speed bps pull down to 115200 or as documented in the release notes for the kDiagnostics firmware image Deselect Enable hardware flow control Ensures that Enable modem error control and Enable modem compression are not selected Select OK Select the Options tab Deselect the Prompt for name and password certificate etc check box Select the Networking tab Select SLIP Unix Connection in
13. Tag Defines a test sequence with a varying number of action tags lt TestSequence gt lt TestSequence gt Attributes Author The author s name specified will appear in the database and in the report files SequenceName This name appears in the database and in the report file Platform The name of the platform that will appear in SequenceRunner the database and report files Example lt TestSequence Author Kozio SequenceName Example Platform Evaluation gt 5 13 2 Action Tags Test sequences are created using actions that allow the operator to be prompted connection to a DUT to be established execution of test commands and a number of other options A test sequence file contains any number of action tags Here is listing of available actions Action Tag Brief Description Establish a connection with a DUT Disconnect from a DUT DownloadImage Download a binary file from the host to the DUT and store it in the indicated memory location DownloadScript Download a kScript file to the DUT using a running TFTP server This is the A most efficient means of transferring an entire script file for later execution Execute a test kScript command on the DUT Retrieve a value from a database The user chooses which table to access Get the contents of a disk file and store it in a variable Parse the text stored in a variable and return a substring Display a message to the operator Prompt the operator to
14. bar lt Input gt A variable containing the serial number used to identify uniquely a DUT Example lt SetSerialNumber Name SetSerialNumber Action gt lt Title gt Set Serial Number lt Title gt lt Input gt SerialNumber lt Input gt lt SetSerialNumber gt 5 13 2 17 SystemCommand Execute a command on the host computer This command can be used to perform any number of tasks using simple programs Possible tasks could include executing database queries using the Command Line Interface to execute DUT commands as shown below or using a program to convert a barcode value into other data Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Command gt The system command to be executed lt Output gt A variable to store results Example lt SystemCommand Name Example of External Command Execution gt lt Command gt cli s Report ksc lt Command gt 71 lt Output gt system cmd results lt Output gt lt SystemCommand gt 5 13 3 Passing Values between Test Sequence Actions Pass values from one action to the next using the lt Output gt and lt Input gt variable tags To pass a value declare a variable name using the lt Output gt tag in one action for example lt Output gt kScriptCommand lt Output gt The output from that action tag is stored in the variable Access that value using the lt Input
15. enter a comment Prompt the operator for input data Store a value in the database The user chooses which table to update PutFile Save sequence variable contents to disk file Prompt the user to scan a barcode label on the DUT Deprecated ScanLabel Prompt the user to scan a label on the DUT The results are stored in the specified variable SetSerial Number Store the DUT s unique serial number and use that serial number for all database logging Required SystemCommand Execute a system command 59 5 13 2 1 Connect Establish a connection to a DUT Attributes Name The name of this action as 1t will appear after Current Action on the SequenceRunner user interface screen Validate Verify that communication 1s setup with the right type of DUT Permissible values are Yes or No Not implemented in this release Timeout The number of seconds to wait for a response before aborting the action Example lt Connect Name Establuish Connection Validate Yes Tomecuir 30 gt 5 13 2 2 Disconnect Disconnect from a DUT Attributes Name The name of this action as 1t will appear after Current Action on the SequenceRunner user interface screen Example lt Dasconnect Name Disconnect Trom DUT gt 5 13 2 3 DownloadImage Download an image from the host to the DUT Typical uses are to download a firmware image or application image to be programmed into flash memory Any other
16. must accept the End User License Agreement Y I accept the terms of the License Agreement Kozio lt Previous Cancel 4 Select the I accept the terms of the License Agreement check box 5 Select Next to continue 6 In the setup dialog box below enter your name company name and very important IP addresses a The Client IP Address must contain the IP address of the computer where the Host Tools are installed b The KozioServer IP Address must contain the IP address of the computer where KozioServer is installed Use the command ipconfig al1 ina Microsoft Windows Command Prompt to list a computer s IP address c The DUT IP Address may change but put in a valid IP address to start See Section 3 3 for information on how to update these values after installation NOTE The entries shown below are examples only Provide values that are valid for your network configuration This dialog only appears when using the full product installer Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup N Please personalize this copy ame Kozid Any personally identifying information you provide will be kept private in accordance Company with our privacy policy Koz line Chent IP Address Please fill in the IP Addresses for the Kozio 192 168 1 2 J Server Database and DUT These values are used for client to target communications 1f Kozio Server 1P Addre
17. number of wiring and signaling standards for the physical layer through means of network access at the Media Access Control MAC Data Link Layer and a common addressing format Ethernet is standardized as IEEE 802 3 A host computer is any computer used to run the software tools This is a typical computer running Windows or Linux operating systems The host computer may be connected to a network or may be connected directly to one or more DUTs Acronym for Internet Protocol address IP is the lower level protocol within TCP IP that is used to send data between computers over a network of computers An IP address is an assigned number used to identify a computer that is connected to a network through TCP IP An IP address consists of four numbers each of which can be no greater than 255 separated by periods such as 192 168 1 1 The scripting language interpreted by kDiagnostics A separate document that describes this scripting language is available Typically a subnet represents all the machines at one geographic location in one building or on the same local area network LAN Having an organization s network divided into subnets isolates activities such as test stations Similar in form to an IP address An example of a subnet mask value is 255 255 0 0 This is the embedded device running kDiagnostics also called a device under test DUT NOTE Quoted text is paraphrased from Wikipedia 87 88 11 Contact Informatio
18. remove the software 1 Launch the install file 3 Kozio Software InstallAware Wizard Kozio Inc Kozio Software Setup Welcome to the installer for Kozio Software This wizard guides you through installing all programs and required components Hardware Verification and Validation het Diagnostics Click Next to continue lt Previous Cancel 2 Select Next 3 Read the Kozio End User License Agreement J Kozio Software InstallAware Wizard Kozio Inc Kozio Software Setup Kozio End User License Agreement You may want to close other READ THIS DOCUMENT CAREFULLY BEFORI applications before continuing with the 3 a air o or Na 7 INSTALLING THIS SOFTWARE BY SELECTING THE I installation accept the terms of the License Agreement CHECK BOX DOWNLOADING INSTALLING AND USING THIS SOFTWARE YOU AGREE TO BE BOUND BY THE aan TERMS OF THIS AGREEMENT IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT DO NOT INSTALL OR USE THE SOFTWARE YOU AGRE THAT YOUR INSTALLING OR USE OF THE SOFTWARI ACKNOWLEDGES THAT YOU HAVE READ THIS LICENSE UNDERSTAND IT AND AGREE TO BI JOUND BY ITS TERMS AND CONDITIONS This is alenal aareament between vou either an individual y I have read understood and agreed to the terms of the End User License Agreement and so signify by clicking I accept the terms of the License Agreement and proceeding to use this product To install you
19. swapped out for a new DUT on the production line Verify that this information matches your network configuration The lines below are an example of the Fixture to IP address declarations If this file is altered the Kozio Server must be restarted The installation program will only generate settings for one Fixture If you are licensed for multiple Fixtures you must manually edit kozioserver properties to insert the additional settings Fixture2 through Fixture4 in this example 25 NumberO0t Fixtures Fixturel Faxture7 Fixtures FPixture4 Starting with Release 4 1 fixture names may optionally be assigned in the properties file as shown in the following example FixtureNamel Debby 8313 DUT 1 FixtureName2 Debby 8313 DUT 2 FixtureName3 Debby Blaze If fixture names are not specified the fixtures will be named Fixturel Fixture2 etc by default Update the properties file any time a change is made to the IP addresses for the server or device under test By specifying these values during installation changes to this file will not be needed unless the IP address es of the DUT s changes If kozioserver properties is modified KozioServer must be stopped and started Refer to Section 3 3 3 for details 26 3 3 1 KozioServer Properties File Variables This table describes the variables found in kozioserver properties Modify the variables as needed Variable Example Description Notes 192 168 1 32 The I
20. the Type of dial up server I am calling pull down box Deselect all options under This connection uses the following items except for Internet Protocol TCP IP and QoS Packet Scheduler Highlight the Internet Protocol TCP IP option under This connection uses the following items e Select the Properties button e Type in the server IP address to use in the Use the following IP address field This value must match the setting configured in the DUTs Sip peer script value Both the configured IP addresses Sip peer and Sip target should reside on the same subnet The DUT command kremote debug displays the settings of all script values controlling the kDiagnostics remote connection Select the Advanced button Select the General tab if not already selected Deselect the Use default gateway on remote network check box Deselect the Use IP header compression check box Select OK on the Advanced TCP IP Settings dialog Select OK on the Internet Protocol TCP IP Settings dialog Select OK on the Kozio Target Properties dialog 3 2 5 SLIP Establishing a Kozio Target Network Connection The first time the prior steps are executed the host computer will immediately attempt to communicate with the DUT via a serial connection The DUT should be running and have executed the kremote run command If this is tru
21. type of binary image can also be downloaded and programmed into any programmable logic device such as an FPGA CPLD or other device This action provides a very fast means of transferring and programming a new image during production runs or during interactive validation The maximum length of the filename including extension 1s limited to 14 characters Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Timeout The number of seconds to wait for a response before aborting this action Additional Tags lt Path gt The full path name of the file to download The path is relative to the TFTP folder specified in kozioserver properties such as myTests 60 The actual filename including extension must be 14 characters or less lt ServerlP gt The IP address of the server that will perform the TFTP transfer lt Output gt A variable to store results Example lt DownloadiIimage Name Simple Image Download Timeout 30 gt lt Path gt customapp bin lt Path gt lt ServerlP gt 192 168 1 32 lt ServerlP gt lt Output gt dummy output lt Output gt lt DownloadImage gt 5 13 2 4 DownloadScript Download a kScript file to the DUT using a running TFTP server This is the most efficient means of transferring an entire script file for later execution The script file is sent in a single transfer to the DUT and interpreted It is b
22. AM A boot loader or JTAG interface can be used to load and run kDiagnostics from RAM on the device under test This manual does not provide instructions for installing kDiagnostics on the DUT However kDiagnostics setup instructions are included in section 3 1 2 of the kDiagnostics User Manual which is a separate document provided through your private FTP site 2 2 Host Tool Installation Instructions for Windows Execute the Host Tools installer executable provided There are several install files available The installer for ValidationAssistant only is kozio install va RxxByy exe The installer for the full product suite 1s kozio install sw RxxByy exe Note RxxByy indicates the version for example R41B19 is Release 4 1 Build 19 NOTES If installing only ValidationAssistant on a single computer you can use kozio install va eval RxxByy exe This installer installs KozioServer and ValidationAssistant and uses default configuration parameters thereby simplifying the installation process The JAVA JRE is required to run the Host Tools The installer will attempt to install the latest version if it does not exist on the host computer Adding Kozio exceptions to Windows Firewall is critical for proper execution of ValidationAssistant Instructions are provided in Section 2 3 Be sure to save the installer file for future use You will need it if you wish to upgrade the software to a newer version or if you wish to
23. Database manager used for test reporting and tracking Development kit used for building custom source code test routines and compiling customized kDiagnostics binaries Use ValidationAssistant to execute test commands on the DUT as specified by Fixture If multiple devices are being tested simultaneously see Chapter 5 for more information on multi device testing Remote access to any target resident Easily customized for test modification and configuration Control of the entire testing process DUT online ValidationAssistant v4 Capabilities Point and click executable test suites gio In System Diagnostics ISD is a powerful and proven new yw technology for comprehensive verification and validation Gru Test automation used to create control wyy and distribute test sequences for manufacturing test ie Database manager used for test reporting and tracking ox Development kit used for building custom source code WW test routines and compiling customized kDiagnostics binaries 4 1 3 Screen Overview Tool bar L Fixture 1 Kozio ValidationAssistant cn file Edit DUT Help I OUT Fixtwel v OUT Log Command tree Secre Digital MultiMe lt de Timer gt Ji UART 4 USB Host Controller Status line Title bar Menu bar Output window DUT online Command line 4 2 DUT Status Located at the bottom on the Status Line is the DUT indicator showing whe
24. File View Help EY Detailed Log F summary Report e Using the View Summary Report button on task bar KH Fixture 1 Kozio SequenceRunner File view Help plat view Summary Report e Alternately the test report can be accessed using SequenceReporter if an integrated database is being used This is discussed in Chapter 6 SequenceReporter A sample summary report file is shown below Ka Fixture 1 Summary Report Viewer serial Number 01234567 Detailed log logs koziolog 01234567 log Starting execution of Sequence Manufacturing Test at Thu Sep 25 17 04 24 MDT 2008 PASSED UART data path walking O s test PASSED UART data path walking 1 s test PASSED Interrupt Test UART transmit interrupt PASSED UART data path walking O s test PASSED UART data path walking 1 s test PASSED Interrupt Test UART transmit interrupt PASSED Verifying timer with CPU core clock PASSED SDRAM memory Data bus walking O s test addr 0x400000 bus width 32 PASSED SDRAM memory Data bus walking 1 s test addr 0x400000 bus width 32 PASSED Memory bus noise test to address 0x40400000 PASSED Address bus test testing addresses from Ox400000 to Oxs000000 PASSED SDRAM byte access Comprehensive bit test Ox40400000 to Ox40500000 PASSED SDRAM 32 bit access Comprehensive bit test Ox40400000 to Ox40500000 PASSED Memory bus noise test burst mode address Ox400000 to address Oxs000000 PASSED SDRAM burst access Comp
25. GetFileContent lt br gt lt html gt lt MessageText gt lt Message gt lt l read a file with no brows1ng gt lt GetFile Name Read Disk File FileDialog no gt lt Output gt GetFileContent lt Output gt lt FileName gt example txt lt FileName gt lt GetFile gt lt display the file contents gt lt Message Name GetFile Data Display OkCancel yes gt lt Title gt File Data lt Title gt lt MessageText gt lt CDATA lt html gt lt b gt The data read was lt b gt lt br gt 6GetFileContent lt br gt lt html gt lt MessageText gt lt Message gt 5 13 2 8 GetValue This test action retrieves a value from a variable by parsing the text Use this action to retrieve values from barcode labels and strings stored in user fields in the database Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Title gt The text that will appear on the dialog s title bar lt Input gt The variable value to parse lt LineNumber gt The line of the text to parse Line numbers start at 1 in the text lt StartOffset gt The first character in the text to extract The first character is offset 0 lt SubstringLength gt The number of characters in the text to extract Parsing will stop once the end of line character is reached even if the number of characters read is less than the val
26. Keith Canyonlands PPC4 34 Items found 282 Database connected to kozio on server 192 im i Evaluation on LON LO Di Fe UN mlali La Lay oido lun o W0 A colo o 00 amp Rio cn CO ius 6 Figure 6 4 SequenceReporter Report with no Filtering Use Serial Number Date Range Platform Operator and Runs filters to reduce the test results displayed Filter Description Serial Number A text string representing a serial number Date Range Formats that are accepted YYYY MM DD HH MM MM DD YY HH MM MM DD YYYY HH MM Representing year month day hour minute and hours and minutes are optional Dashes or slashes can be used between the month day and year Platform Text string representing platform name board s name or project s name A text string for the operator s name Select to view only Passed runs only Failed runs or Both Select Generate Report or press the Enter key to update the query results after the filter settings have been modified Here is an example with filtering A gee NY ye e s MER E ETS SOZIO SEC ue icerkeporter Diorio alioi v Filters Serial Number DateRange 03 27 2009 to 04 30 2009 Platform Operator Runs Passed Failed 0 Both de Platfo
27. P address of the computer running EventPort 4333 The base IP port used by The port number KozioServer Two port for the host numbers are used computer s and EventPort and kDiagnostics EventPort 1 remote communications variable Skremote port must match section 3 1 KozioServer ClientIP 192 168 1 32 The IP address of the This value is only computer running aclient used by the client application such as application and has ValidationAssistant no affect on the server settings TargetIP 192 168 1 100 The IP address of the DUT This value must match the kDiagnostics remote communications variable Sip target Section 3 1 TargetPort 4333 The IP port used by the by This value must the Device Under Test match EventPort TftpRoot myTests This variable specifies the This is the place to root folder where files store kScript files downloaded from the host image files for to the DUT will be stored downloading to the DUT and test sequence files TE TOPOBE The TFTP port number Set this value to zero 0 to disable the TFTP server RMIRegistryHost 192 168 1 32 The IP address of the computer running KozioServer 3 3 2 SequenceRunner Properties File Variables This table describes the variables found in seqrunner properties Modify the variables as needed 27 Example Description LogToFile true Valid options are true or Set to true to log false all t
28. Test Command lt Title gt lt MessageText gt lt CDATA lt html gt lt b gt Enter a test command to execute on the UUT lt br gt lt br gt Type a kScript command into the prompt box below lt br gt lt br gt This command will be sent to the UUT and executed lt br gt lt br gt This demonstrates the use of passing variables from one Action to another lt b gt lt html gt lt MessageText gt lt Output gt kScriptCommand lt Output gt lt Prompt gt 62 lt Connect Name Connect To DUT Validate Yes Tameout 30 J gt lt ExecuteCommand Name Execute kScript Command Timeout 15 gt lt Command gt lt Input gt kScriptCommand lt Input gt lt Output gt script results lt Output gt lt ExecuteCommand gt 5 13 2 6 GetDatabase This test action retrieves a value from a database table Use this action to retrieve values from the Common or DUT tables Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Table gt Read a value from this database table with valid values of common or dut lt RowName gt The label used to identify a given row of the table See the PutDatabase action for how to create or update rows lt FieldNumber gt Read this user field number from the row Valid values are 1 to 20 lt Output gt A variable to store results Example lt GetDatabase Name
29. To correct an invalid license issue replace the corrupted license file with the original license file Contact Kozio Sales or Technical Support if the problem cannot be corrected 86 10 Best Practices Acronyms amp Glossary 10 1 Best Practices Here is a collection of items that should help overall efficiency using the Kozio Host Tools Manufacturing Suites When creating a manufacturing test suite create a kScript file that contains the entire test configuration and test suites that are needed to validate each unit under test Store this script in a file with a ksc extension Create a test sequence file xml which will connect to the DUT Download the kScript file and execute the newly created test suite Using this method allows the tests executed on the DUT to be changed without changing the test sequence file Use one file or multiple file to store various test scripts Create one test script file for validating the UUT and another test script file for downloading images and updating memories Flash EEPROM and CPLD Using multiple files allows separate actions to be taken and enhances reuse of the test script efforts for other projects 10 2 Acronyms ASCII American Standard Code for Information Interchange ASCII is a character encoding based on the English alphabet ASCII codes represent text in computers communications equipment and other devices that work with text CLI Command Line Interface DUT De
30. Variables ana tds 26 3 33 REStartin KA A es e 29 IS A A A O 30 A Al GOTH E RR 30 4A Stir Up BAM a A E davageaenens 30 ALZAN UG ON riada 31 A EN a a E 32 A I a a E A A A aaa 32 do Validate ia 33 44 Mentb atan ari 33 AAA PP RO 33 Ad llos DUT Opt ida alas 33 AA MALOS EC a 34 4d LS lod Command LS ina E E 34 A OO 34 AAD EC Me ii 34 gA IAEA WW AMC OW a 34 Ae eo gl A RS O Te Rinne Ramee TOS E 34 a ia UO NOAA O 34 De 2 Dowmo AU Feto DUT ssa cathe A a 35 4 4 3 3 Execute SCript ii Ab 36 A eM SP E E A E E A sind Ase E E E ced EA 37 A Slats a ACA e eo 37 LOC OMMAN tna 37 AO BE XCCUtM OC OL MTV AING 8 essre na a abri 38 AO Me 38 Al Eo Command TEC ss 38 4 T2 Executune Tests throueh the COMMITTEE A E E a 39 E EOI A S 39 A a OO ae 39 49 Low Level Commands A AS 40 A Lever EE Dos oo a 40 KITO ECSU VIC A O O 41 Aid Pertormancs estuario livianas 41 412 E A ora E E A buen nadosed 41 A RO 42 2d Nie A A OA 43 IA RS REPO SR re eC Te tM A 43 4 14 Troubleshootune Test Faire Sear N 43 414 1 Troubleshootirs with Fest Methods suena alada 43 AIA rOuUDIeSNOOUNS Wilh Trace mia a eon ateuseriatatenenieiiata 43 4 143 Troubleshootins with LOOPS ua A id a 45 dl A Memory Tetu E ee auaio ss 46 AS DO woad ne SCTP ee E E E N 46 PLONE EE E TE a A EE A E E E S 47 AIT Shortcuts Key DO ALO ci ii a a a asandedBe cea 47 SoeduenceRnner ill 48 5 1 Launching SequenceRumner c cccscccscsesesesesssssscssssscssscscscscscevscssavavavsvsvacavavavavavav
31. a Raper Cape oi oe oe E AI po Timer Write t att n 0 0x202800000 to 0x9000000 UART Ly USB Host Controller i mW kozio gt test sdram address DUT online 45 If the trace level is turned up to 6 every single read and write memory access 1s displayed while executing this test The tracing feature provides additional information that is very useful for fault isolation and learning how to configure interfaces and devices _ Fixture 1 Kozio ValidationAssistant File Edit DUT Help but Fixture i v E Durtog E Command Log BeagleBoard jin piles Osnncoo0nn de All Components S Audio devices ES sde 9 Jj CPU Las 0000 Display Devices CHECK ange 0x80700000 to 0x90000000 ub GPIO 12C Programmed I O RTC J SDRAM Secure Digital MultiMeg Timer E UART USB Host Controller Y DUT online 4 14 3 Troubleshooting with Looping The looping feature provides a way to troubleshoot problems or run regression suites on the board In the Command Line type in the number of times the test is to loop followed by the command lt loop_count gt test loop test sdram address and hit Enter where lt loop_count gt is the number of times to execute the command Use a loop_count of zero 0 to run infinite times To stop the looping use the Esc key If a failure is detected the test will stop automatically This feature can be used for to loop any command Ther
32. ame followed by a status of Pending Passed or Failed Pending indicates that the test has not been executed yet This information is cleared when the platform is rebooted This same information can be accessed by entering the report command followed by a test suite name on the command line For example on the command line enter report test sdram and press the Enter key File Edit DUT Help DUT Fixture 1 w 2 DUTLog 7 Command Log 4 14 Troubleshooting Test Failures In the case of test failures ValidationAssistant provides several different options for troubleshooting 4 14 1 Troubleshooting with Test Methods Go to the Test Methods command and change the input parameters down to a smaller range or a specific device that is failing see section 4 9 for details on Test Methods A logic analyzer or other hardware devices can be hooked up to try to diagnose the failure Fixture 1 Kozio ValidationAssistant File Edit DUT e e tart DU elp DUT Fixture 1 y E DUT Log T Command Log S a Test methods Audio Fixed ton t e Stereo audio record playback test ne 1kHz tone audio seconds Execute Gear Close Help 4 14 2 Troubleshooting with Tracing kDiagnostics has tracing built into the product and this can be accessed through ValidationAssistant For example if the command test sdram address is typed into the command line limited information 1s provided In this ca
33. ault list of commands provided by Kozio or from a user defined command lt FilePath gt The filename of the script file to download to the DUT The actual filename including extension must be 14 characters or less Note See Example 2 below this shows a script file 1s sent to the DUT defining a new test suite name and then that test suite 1s executed using second ExecuteCommand action lt Input gt The value of the variable is used as the command to execute on the DUT This tag is optional Note See the Example 3 below where the variable kScriptCommand is set using a Prompt action and then passed to the ExecuteCommand action lt Output gt A variable to store results Example 1 lt ExecuteCommand Name kScript Command test sdram Timeout 30 gt lt Command gt test sdram quick lt Command gt lt Oubput gt seripe results lt OuUtput gt lt ExecuteCommand gt Example 2 lt ExecuteCommand Name kScript Command test custom final Timeout 30 gt lt Command 7 gt lt FilePath gt Mfg Test ksc lt FilePath gt lt Output gt script results lt Output gt lt ExecuteCommand gt lt ExecuteCommand Name kScript Command test custom final Timeout 60 gt lt Command gt test custom final lt Command gt lt QUEPUE gt Sscripteresults lt QuUeput gt lt ExecuteCommand gt Example 3 lt Prompt Name Prompt to Execute Test Command OkCancel Yes Timeout 30 gt lt Title gt Prompt to Execute
34. avavavavavavavavavavavavens 48 o E RR S 49 gt EE XECUUNS FeSt SEGUCICES riada 49 SA Dered MO a a 52 5 Command Emne merce El a a lone nis aa 53 SOC LLCR A DO 53 O O AA A O 54 5 0 Executie Commands with Cll ARAS 54 J Executes a Test script with Cll cai 54 10 Executi a Test sequence with CDs aldea rciia 55 Repor PINGS A A 56 SHS UE PUDE e ta sh ore rc ek roi iw EN af ed Bae Oi HRA ike ol 6 i cmon tee renner tees ia 57 SS A O OOOO 57 SL Tests e quedo Tiaa o 58 ZACH VAS aio 58 O OM pata 59 NERD IS ONC E cues area a hee teeth eae hanna nN ol at hana E A saa 59 AZ Download imag 6 anna 59 DA A tans ro o suds daetenreutssalled 60 A Exe ae A ena a a a hada sucaae enn erad uadmem ieee 60 AN andi N E E E A E 62 Fl O Oa A A IA A T EE T scettan ectatcs 62 Del E O E E E E ASAE A E ATA E E A 63 A A E TS 64 12 MO Operator omnes acia 64 IZ PON a cxpsoact ahabeacext 66 lo IAN A A ARE nee oe 67 E O O O 68 LIZ IAS CAND AUC OCG dilata 68 SA AS A de 69 A UA ss ON anne 70 SA Sc AA A O A A 70 5 13 3 Passing Values between Test Sequence ACTIONS occccccccnononocnnnnnnnnnnnnnonannnnnnnnnnnnnnannnnnnnnnnnnnnnnos 71 Se QU CIICE Ie CPO ets 72 Od Swatchins Database Mi 73 0 2 Generate REDO ucraniana 74 0o Prnt Query RESUS usina 75 Ok Sa VS REDON e aces ae atest ene edn seo ae ee eee 76 Pa ANU cere yee Wor nip E eeenmtmenrt es leetnetan mere trcueremt tamer steer sremetinr tr Seariec ram tron ater ntmer te Serre ates 79 7 1 Multi device T
35. cerunnercli k script file name 55 NOTE CLI defaults to Fixture 1 when the f parameter is not specified To execute a test script for a Fixture other than the default use sequencerunnercli f k script file name Where is the desired Fixture number and script file name is any valid kDiagnosticse script file ksc This sends the entire script file to the DUT for line by line interpretation Results are displayed to the output console and the overall success of execution 1s returned as a DOS exit status code as shown in the table above TODO need table number 5 10 Executing a Test Sequence with CLI Kozio Test Sequence files may be executed from CLI with the s option as shown here sequencerunnercli s sequence file name where sequence file name 1s the name of any valid Kozio Test Sequence file for example mytestsimfg test xml The f option may also be used to specify the desired Fixture number as with any CLT command 56 Report Files A report file for each test suite execution 1s created based on the configuration options chosen in seqrunner properties The report filename includes the Serial Number that is retrieved from a ScanBarcode action All report files are stored in the logs directory and in the database This report can be printed and packaged with a DUT View the report file using one of three methods o Using View gt Summary Report i a Fixture 1 Kozio SequenceRunner
36. command is then sent to the DUT kDiagnostics running on the DUT will respond with version and licensing information The following example depicts a DUT offline error message File Edit DUT Help DUT Fixture 1 w BeagleBoard x Audio devices j CPU Display Devices GPIO 12C Programmed I O RTC Ly SDRAM L Secure Digital MultiMed Timer Ly UART de USB Host Controller de gt DUT offline DUT offline Check power and cabling Figure 8 4Figure 8 5 ValidationAssistantIM 2 0 with DUT Offline 83 9 Troubleshooting 9 1 Timeout on command acknowledgement from DUT When running ValidationAssistan t and the error message KozioServer Timeout on command acknowledgement from Target is displayed this 1s indicative of a communications problem between KozioServer and DUT td Kozio ValidationAssistant Kozio YalidationAssistant KozioServer Timeout on command acknowledgement from Target Enter Command Clear Window Detach and Exit Figure 9 1 Error KozioServerTM Timeout on command acknowledgment from DUT Here are a few troubleshooting tips Make sure the DUT is powered on From a Microsoft Command Prompt ping the DUT to test the connection Cycle power on the DUT in case kDiagnostics is no longer communicating Make sure that kDiagnostics did not display a message on TeraTerm such as Warning link is not up for PH Y31 Thi
37. cted message was green When SequenceReporter runs it uses saved values from a prior run and automatically attempts to connect to a database The database connection status 1s show on the status line at the bottom of the window In this screen shot we see we have a successful connection 6 1 Switching Database Settings Select the menu Settings gt Database to update database settings Database Settings Eg Database Server 192 168 1 32 Database Mame kozio User name kozio_user Password koziouser Save Connect Cancel Figure 6 3 SequenceReporter Database Settings Dialog Fill in Database Server with the IP address of the machine running the PostgreSQL database The Database Name User name and Password fields must be filled in with values entered during the database installation process Select the Save button to update the stored settings Select Connect to attempt a connection to the database using the settings that have been entered 74 6 2 Generate Report Once connected to a database select the Generate Report button to query the database using the filter values that have been entered If all filters are blank all records from the database are retrieved and displayed amp Kozio SequenceReporter ie Etna Hefi Filters Serial Number Date Range to Platform Operator Runs Passed Failed 0 Both Generate Report Pass
38. des two ways to execute Commands Commands can be run through the Command Tree see section 4 3 or the Command Line see section 4 11 4 7 Command Tree The command tree can be found on the left side of the screen and 1s organized by the hardware components available on a platform The command tree is customized for each platform that kDiagnostics is delivered on by providing commands only for those components available on that platform Under each component a second level of commands is divided into five potential groups but all groups are not available for all components The groups available are Suites Diagnostics tests Performance tests Test methods and Low level commands These groups are defined in great detail in subsequent sections 4 7 1 Load Command Tree To load the command tree use the File menu option and click on Load Command Tree from the top menu options Find the location of the kct file Kozio Command Tree File for the DUT and double click The command tree will automatically load into ValidationAssistant Desktop My Documents i J A Computer e CL File name Command reeBeagleBoard kct Network Files of type Kozio Command Definition Files kct 4 7 2 Executing Tests through the Command Tree Navigate down to the specific component to be run and double click or use the Execute Script option located in the Menu Bar to select a script file that 1s sent to the DUT f
39. dh KOZIO w Kozio Host Tools User Manual SequenceRunner Version 4 Copyright 2010 Kozio Inc dh kKOZIOv yw SequenceReporter Version 4 dh kKOZIO yw ValidationAssistant Version 4 Copyright O 2011 Kozio Inc 4h A MOYA 107 yw Product names mentioned in this document are trademarks of their respective manufacturers and are used here only for identification purposes O Copyright 2011 Kozio Inc All Rights Reserved Information in this document 1s subject to change without notice The software described in this document 1s furnished under a license agreement The software may be used copied or distributed only in accordance with that agreement No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or any means electronically or mechanically including photocopying and recording for any purpose without the written permission of Kozio Inc HS DOC UM 41 R1 2011 DJ 2 Contents 1 Introduction to Kozio Host Tools Software c c cccccscsssssssssssssssssssvsvscscscsececscacscavsvevsvsvssececscacasasavavavavaevees 5 k EOUCk Start MUCHOS ad A A id 6 Z Tostal On lala 7 ZA DUT Installation IAS tUCHONS orria AAA USERE 7 2 2 Host Tool Installation Instructions for WindOWS ccccccsssssssseceececccasseeseeecceeeesaeaesseecceeeeesaaaenseeeeeess 7 225 WAIMOOWS EME Wall IMS ITUICHONS A A A 13 2 4 Updating a Previous Versi n o
40. ds This includes all commands typed in as well as executed through the command tree To re enter a previous command press the up arrow or down arrow key on the keyboard This will cycle through all commands entered Press the Enter key to execute that command You can also scroll commands and then modify the command by selecting the Command Line text entry box and making modifications before pressing Enter 48 5 SequenceRunner 5 1 Launching SequenceRunner aii ie Ru WY Launch SequenceRunner using the desktop shortcut SequenceRunner displays a startup banner followed by the main operator interface SequenceRunner Version 4 dh kKOZIO yw Copyright 2010 Kozio Inc Figure 5 1 SequenceRunner Startup Banner E at A or File View Help a A jour Fixe iT Platform Sequence File Serial Number Overall Status Overall Progress Current Action Test Progress gt START Server online Database connected to kozio on server 192 168 1 32 Figure 5 2 SequenceRunner Initial Screen with DUT Online STOP 49 5 2 Log In The operator must log in Select the File menu and then select the Login option as shown below Please enter user name I Lore JM Cancel Enter the operator s name This name is stored in the central database as the operator s name and is tracked with all test executions Once logged
41. e a network connection between the host computer and the DUT will be established 23 3 2 6 SLIP Restarting the Windows SLIP Connection After the connection has been disconnected for whatever reason reestablishing the connection can be accomplished using the Kozio Target desktop icon Kozlo Target Double click on the icon and the host will attempt to connect to the DUT Connecting Kozio Target 7 TAn Dialing Cancel If the connection fails restart the DUT making sure that the kremote run command has been executed A failed connection displays Error Connecting to Kozio Target ax A Dialing Error 277 The connection attempt failed because the modem or other connecting device on the remote computer is out of order Cancel More Info 3 2 7 SLIP Verifying the Windows SLIP Connection Follow these instructions to verify the SLIP connection Launch the Network Connections dialog box if it is not already running o Select Start gt Settings gt Control Panel o Double Click on Network Connections Under Direct the Kozio Target should have a Status of Connected with possibly other attributes As a second step ping the DUT o Launch a Command Prompt window o Execute ping 192 168 240 2 but use the DUT s SLIP IP address This value is a kDiagnostics remote connection variable as described in Section 3 1kDiagnostics R
42. e Files Test sequence files are ASCII text files containing XML tags describing the circuit board test process Each XML performs a given test action Create test sequence files that combine various test actions required for the test process The first line in a test sequence file is the XML declaration and it defines the XML version and the character encoding used in the document Such as lt xml version 1 07 gt All sequence file documents must conform to the 1 0 specification of XML For more information on the specification see http www w3 org TR REC xml The next line declares the root element of the document and points to the Document Type Definition DTD file lt DOCTYPE TestSequence SYSTEM KozioSequenceFile dtd gt The first tag 1s the lt TestSequence gt tag Within enclosing TestSequence tags one or more action tags can be listed Action tags are defined in section 5 13 2 Action Tags Some quick notes All XML elements must have a closing tag XML tags are case sensitive With XML the tag lt Letter gt is different from the tag lt letter gt Opening and closing tags must therefore be written with the same case XML elements must be properly nested XML attribute values must be quoted With XML White Space is preserved The syntax for writing comments in XML is similar to that of HTML o lt This is a comment gt With XML it is illegal to omit the closing tag 58 5 13 1 TestSequence
43. e are alternate ways of looping available and those are described in the kDiagnostics kScript Reference document 2 Fixture 1 Kozio ValidationAssistant File Edit DUT Help d BeagleBoard All Components Audio devices ub CPU de Display Devices l GPIO I2C Programmed I O RTC f HL SDRAM de Secure Digital MultiMed Timer 4 Jy UART USB Host Controller 3 DUT online To stop a running test go to the DUT menu located on the menu bar and click on the Stop DUT Command or press the Esc key on the keyboard Fixture 1 Kozio ValidationAssistan File Edit DUT Help Stop DUT Command Escape Download File to DUT Execute Script 46 4 14 4 Memory Test It is important to note that if you interrupt a test in progress kDiagnostics may leave data caching turned off If data caching 1s disabled all commands will run much slower To display the current status of data caching enter the command cpu dcache hex This will display a 0x0 or 0x1 indicating that data caching is either off or on respectively kozio gt cpu dcache enable DUT online To turn the data cache back on enter the command cpu dcache enable and press Enter This will turn data caching back on A full list of all available commands is provided in the kDiagnostics Command Reference This document is provided with purchased products only 4 15 Dow
44. e dialog box Either a simple text or HTML formatted text can be used that is contained within a lt CDATA gt tag construct lt Output gt A variable to store results Example lt ScanBarcode Name Scan Barcode to Start Test OkCancel Yes Timeout 30 gt lt Title gt Scan Barcode lt Title gt lt Image gt images example jpg lt Image gt lt MessageText gt lt CDATA lt html gt lt font size 4 1 face Verdana gt lt br gt Verify that all cables are connected and power on the Ona ts lt p lt br gt lt b gt Scan the barcode to proceed lt br gt lt b gt lt html gt lt MessageText gt lt Output gt SerialNumber lt Output gt lt ScanBarcode gt 5 13 2 15 ScanLabel Receive input from a barcode reader and store the results in a variable Use this action to retrieve barcode text to parse using the GetValue action or store in the database using the PutDatabase action Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen OkCancel The option to display OK and Cancel buttons Permissible values are yes or no When yes 1s chosen the operator 1s forced to select a button to continue the test sequence When no is chosen the dialog disappears after lt LineCount gt number of lines are read Additional Tags lt Title gt The text that will appear on the dialog s title bar
45. e test sequence Here 1s an example of a test in progress Fixture1 Kozio SequenceRunner File View Help Ros E E Dur Fixture 1 Platform Evaluation Sequence File SystemCommand xml Serial Number not set Overall Status Overall Progress cc Current Action Example of External Command Execution Test Progress START STOP Server online Database connected to kozio on server 192 168 1 32 Figure 5 4 SequenceRunner Test in Progress 52 Fixture 1 Kozio SequenceRunner File View Help E E pur Fixture w Platform Evaluation Sequence File Mfg_Test xml Serial Number ZDM1000DS Overall Status Alltests passed Overall Progress Current Action Test Sequence Ended gt OR START STOP Server online Database connected to kozio on server 192 168 1 32 Test Progress e Fixture 1 Kozio SequenceRunner Sai eee 3 E DUT Fixture 1 wi Platform Evaluation Sequence File Mfg_Test xml Serial Number ZDM1100DS Overall Status kScript test failed Overall Progress Current Action Test Sequence Ended Test Progress f START STOP Server online Database connected to kozio on server 192 168 1 32 Figure 5 5 SequenceRunner Test PASS amp FAIL Status 5 4 Detailed Log A SequenceRunner log file stores a record of all activities This log file is useful for debugging a config
46. ection in 3 seconds Type CTRL C to bypass Establishing kRemote connection initialize physical IDEAT TSTS phy31 Initializing remote connecti Sever port 192 168 1 18 333 target port 192 168 1 210 4333 3 1 3 Establishing Ethernet Communications to the DUT kDiagnostics enables remote communications as soon as kremote run is successfully configured and executed Choose an Ethernet connection by using the appropriate kremote netdev value described in section 3 1 No special setup is required for the host computer when an Ethernet is used To quickly verify the Ethernet connection to the DUT use a host ping command with the DUT IP address as the argument This is the IP address stored in the kDiagnostics variable Sip target 3 2 Establishing an Optional SLIP Communications to the DUT Optionally choose a SLIP connection by using the appropriate kremote netdev value described in Section 3 1 When using a SLIP connection SLIP must also be enabled on the host computer 3 2 1 Creating a SLIP Connection under Windows XP This section describes how to create a new SLIP connection on the host server computer running Microsoft Windows This connection is optional and these steps are not required if an Ethernet connection is chosen from the host computer to the DUT 3 2 2 SLIP Creating a New Network Connection Complete the steps below once for setting up a host computer to communicate with a DUT over
47. el used to identify a given row of the table If RowName does not exist a new row is created If the RowName exists the row 1s updated This field only applies to the Common table For the DUT table we use the row associated with the DUT currently being tested An error is generated if SetSerialNumber has not been executed to assign a serial number with a DUT lt FieldNumber gt Read this user field number from the row Valid values are 1 to 20 lt Input gt A variable storing a value to be placed in the database Example lt PutDatabase Name PutDatabase Test Action gt lt Table gt common lt Table gt lt RowName gt DebbyTest002 lt RowName gt lt FieldNumber gt 3 lt FieldNumber gt lt Input gt ScannedLabel lt Input gt lt PutDatabase gt 68 5 13 2 13 PutFile This test action saves the contents of a sequence variable to a disk file This action 1s useful for exporting database contents or variable values Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Input gt A variable storing a value that will be written to the file lt FilePath gt This optional field denotes the file path relative to the TftpRoot value which is defined in kozioserver properties If omitted the file will be placed in TftpRoot lt FileName gt The name of the file to be created or overwritten lt Input gt A variab
48. emote Communications If the IP address has been changed be sure to use the new value 24 Cix gt ping 192 168 249 2 Pinging 192 168 249 2 with 32 bytes of data Reply from 192 168 249 2 bytes 32 time lims TTL 32 Reply from 192 168 240 2 bytes 32 time lims TTL 32 Reply from 192 168 240 2 bytes 32 time 1lims TTL 32 Reply from 192 168 240 2 bytes 32 time 1ims TTL 32 Ping statistics for 192 168 240 2 Packets Sent 4 Received 4 Lost Az loss gt Approximate round trip times in milli seconds Minimum iims Maximum iims Average iims oN 3 3 Kozio Properties Files KozioServer and the client applications each use a properties file for configuration values These files are located in the root folder of the Kozio Host Tools installation directory e g C Program Files Kozio 9 The following files are used NOTE Application Program Properties File SequenceRunner and SequenceRunnerCLI SequenceReporter kozioreporter properties ValidationAssistant kozioserver properties contains configuration data linking one or more Virtual Fixtures to their IP Addresses A Virtual Fixture 1s either an actual hardware networking device provided by Kozio or the DUT directly The client applications such as ValidationAssistant refer to a Fixture which is mapped by KozioServer to an actual DUT This allows the client applications to always refer to the same Fixture even though a given DUT may be repeatedly
49. equirement to alter each DUT s default MAC Address and IP Address 7 3 Properties File The kozioserver properties file contains configuration data linking a virtual fixture to an IP Address Verify that this information matches the network configuration The file is located in the root installation folder The default location is C Program Files Kozio 80 The lines below are an example of the fixture to IP address declarations If this file 1s altered Kozio Server must be restarted NumberOfFixtures Fixturel Fixture2 Fixture3 Fixture4 7 4 SequenceRunner SequenceRunner provides a single instance user interface suitable for addressing all DUTs SequenceRunner executes a selected test sequence Sample test sequences are provided in the examples folder of the root installation directory SequenceRunner provides the ability to select a fixture and displays a status line at the bottom of the dialog box amp Fixture 1 Kozio SequenceRunner File View Help Platform Sequence File Serial Number Overall Status DUT online Overall Progress Current Action Test Progress pe a START STOP Server online Database connected to kozio on server 192 168 1 32 Figure 7 2 SequenceRunner with DUT Online 81 8 kHeader Use the utility kHeader to wrap a binary file with header information before sending it to kDiagnostics on the DUT This feature ensures that a corrupted
50. er Detailed Log Dialog Operator Comments x GPIO test failed Figure 6 10 SequenceReporter Operator Comments Dialog 79 7 Multi device Testing Multi device testing is an advanced feature of the kDiagnostics Host Tools Multi device configuration allows software tools running on a host computer to communicate with multiple devices under test Each Host Tool ValidationAssistant SequenceRunner and SequenceReporter provides the capability to select a Virtual Fixture VF and send test commands to the device connected to that fixture See the specific sections for each Host Tool for details 7 1 Multi device Testing Equipment Virtual Fixture Set Up Example The test set up described in Figure 1 is a configuration for testing four devices simultaneously Complete configuration information is provided for the 16 port Switch and Virtual Fixtures Connect the 16 port switch to the test computer s NIC Connect VF 1 s WAN port to the 16 port switch repeat for VF 2 VF 3 and VF 4 Connect VF 1 s LAN port to DUT 1 repeat for VF 2 VF 3 and VF 4 Enable power for the switch and each Virtual Fixture Apply power to each DUT aS o Figure 7 1 Four DUT Virtual Fixture Configuration 7 2 Software Installation The device under test must be running kDiagnostics 2008 2 or later kDiagnostics must be running and the remote interface must be initialized TheVirtual Fixtures feature eliminates the r
51. erator Comments can be viewed Serial Number DateRange 03 27 2009 to 04 30 2009 Platform Operator Runs Passed Failed Both M _ PassiFait TestDate Operator Serial Number _ Platform Tests Passed 2009 0423 144247 angy2001 motsey Evawan o Passed 2009 0423 1430 31 cinay2001 aotsesp Evaluation jo Failed 0080423142018 anay12001 mote fevauaton Passed 2009 04 17 110302 Andrew mpce377 mecene RDB i Passed 2009 04 17 10 08 03 Andrew mpes377 mPce37eRDB o Failed 2009 04 17 10 06 33 Andrew mpes377 mecene RB Jo 2009 04 9 TestSummay Passed Detailed Log EA ssed 2009 04 BO Passed 200004 REPARAR 2009 04 01 13 19 56 009 04 01 13 17 19 009 04 01 13 13 46 assed ailed ailed ninn a o o Bd w a a o o D a o i OO e ak 2 RB ny a ag S S SB BTR elololojojolan aaa iaa ajo O DD d d NR PS gt x lt gt x lt lt iled 009 04 01 13 08 42 Failed 009 04 01 13 06 56 PPC405ex Kilauea Items found 17 Database connected to kozio on server 192 168 1 32 eS Figure 6 7 SequenceReporter Pop up Menu Options From the Test Summary dialog the test report can be viewed and saves to a file From the Detailed Log 7 dialog the detailed log can be viewed and saved it to a file The Operator Comments dialog displays any note
52. ess bus test is run it will use an SDRAM Address Test to test the entire range of SDRAM memory that is available on the platform 42 A right mouse button pop up menu is available for all Diagnostic Tests One menu option displays help for the command and one executes the command Fixture 1 Kozio ValidationAssi File Edit DUT Help DUT Fixturei _ DUT Log Lo BeagleBoard p All Components Audio devices CPU Display Devices fi GPIO j 12C Programmed I O Test SDRAM Test SDRAM SDRAM data Test SDRAM data pattern walking zero Execute Help Test SDRAM data pattern walking one SDRAM march test Simultaneous Switching Output Test Test SDRAM word access B Performance tests o Test methods de Low level commands Secure Digital MultiMedia Card j Timer _ UART y USB Host Controller DUT online 4 13 Test Suites E Command Log ozio gt TEST SDRAM ADDRESS Ss e es ess bus test testing addresses fror 0x80700000 to 0x90000000 Test suites are collections of diagnostic tests or other test suites Quick and comprehensive test suites are available for all devices Test suites can also be nested For example under the All Components folder on the command tree over 140 tests are packaged into a single command labeled Example Test Suite long version Multiple components are tested and there are multiple levels of nesting under eac
53. est for the script file to contain definitions of new commands for later execution The maximum length of the filename including extension is limited to 14 characters Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Timeout The number of seconds to wait for a response before aborting this action Additional Tags lt Path gt The full path name of the file to download The path is relative to the TFTP folder specified in kozioserver properties such as myTests The actual filename including extension must be 14 characters or less lt ServerlP gt The IP address of the server that will perform the TFTP transfer lt Output gt A variable to store results Example lt DownloadScript Name Simple kScript Command Timeout 90 gt lt Path gt Report ksc lt Path gt lt ServerliP gt 192 168 1 32 lt ServerlP gt lt Output gt dummy output lt Output gt lt DownloadScript gt 5 13 2 5 ExecuteCommand Command kDiagnostics to execute a test command on the DUT Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Timeout The number of seconds to wait for a response before aborting this action Additional Tags 61 lt Command gt The kDiagnostics command to be executed The command must exist in kDiagnostics either from the def
54. est results to text file stored in the logs folder under the main installation folder LogFileName koziolog The name of the file used Created in the for test logging when logs folder under LogToFile is true the main installation folder LogFileExtension The extension of the file used for test logging when LogToFile is true e isd e for test reports ReportFileExtension The extension of the file used for test reports LogFileSave always Valid options are This variable always never or determines when a error detailed execution log is saved to disk This log is useful for troubleshooting DBURL jdbc postgresql 192 168 1 22 kozio Valid JDBC URL for the This field is only database needed if the optional database is installed and enabled DBUserName kozio_user User name for database Used by application the database ee ee O access 28 fe Home View EE le kozio properties startup parameters for Kozio Lite software z Copyright c 2009 Kozio Inc All rights reserved Use of this computer program is protected by the Universal Copyright Convention UCC U S Copyright laws and subject to the terms of Kozio s f license agreement IP and port of machine running the Kozio Server software EventIP localhost EventPort 4333 z IP address of machine running the client software ClientIP localhost z Base port address f
55. esting Equipment Virtual Fixture Set Up Example ooccccccnnnconcncnnnnnononnnnnonnnnnss 79 ELIO A E a asco 79 Fo Prope reS EMC sis celine E E E Peece emanates 79 TAs Segue Ce unne A eaa E E E ES 80 S k Heddle einen e os PE EE A O E E E 81 SUSU US AO SIS 83 9 1 Timeout on command acknowledgement from DUT oonnononnnnnnnnnnnnnnnnocnnnnnnnnnnnnnononnnnnnnnnononaninonoss 83 DL AMOS DCC UY AO Ucayali eres E dane es Saree iio ie 84 2S Windows Firewall NSS renere node alee rr ena ya aaa Ao al aia versa ale eatin Aoi alain eaaales leaareled nee 84 OA LICccnse Errol iia a 84 TO Best Practices Acronyms Ge GIOSS Y serui aeaa aaa ins 86 A o E cna bel ot cee achat 86 LOD ACTO IMS c 86 NOS ratio 86 MUS a A IN renee tae O NS 88 1 Introduction to Kozio Host Tools Software Kozio s Host Tools consists of programs that provide a simple yet powerful user interface to Kozio s kDiagnostics For engineering the Host Tools streamline the creation execution and automated recording of board level test sequences used to quickly validate troubleshoot and program hardware devices The Host Tools offer an effective means of providing in system programming For manufacturing the Host Tools efficiently validate and serialize devices during the manufacturing and support phases of a product s lifecycle Manufacturers save time and money while increasing test coverage and gaining efficiency in design and manufacturing processes
56. f the Host Tools cin aa 15 3 Communications Setup Host Computer to DUT ooonnnnnncccnnccnnccnnnnnnnnnnnnnnonnnnnnnnnononnnnnnnncnnnnnnnonaninnnnnss 19 3 1 kDiagnostics Remote Communica ONS std oia cgi 19 3 1 1 Displaying Remote Communications Variables occccconononnnnnnnnnnnnnnonononnnnnnnnnononnnanonncnnnnnnnnnnnos 20 3 1 2 Enabling kDiagnostics Remote CommuniCatons icss socetsvinwtivcedeocdieosinaiares i 20 3 1 3 Establishing Ethernet Communications to the DUT oooonnnnnnnnncncnnnnnocnnnnnnnnnonnnonnnnnnnnnnnnnnnnos 21 3 2 Establishing an Optional SLIP Communications to the DUT oooccnnncccnnncnocnnnncnnnncnonnnonocnnnnnnnononnnans 21 3 2 1 Creating a SLIP Connection under Windows XP cc ccseeeesecceccceceeeeseeeeeeeeeeeaaeaeseeeeeeeeeeseeenees 21 3 2 2 SLIP Creating a New Network CONMECIOMi 21 3 2 3 SLIP Create a New Direct oOmnecton ascii ardid ideal li dd 22 3 24 SLIP Setting the Kozio Target Properties oisneneririnna aeai an 22 3 2 5 SLIP Establishing a Kozio Target Network Connection ccccccccccecceceeeeeeeeeeeeeseeeeeeees 22 3 2 6 SLIP Restarting the Windows SLIP Connection ccccccccnnonnncncnnnnnnnnnnnnnncnnnnnnnnonnnnnnnncnnnnnnnnnnnos 23 3 2 7 SLIP Verifying the Windows SLIP Connection ccccccccnnnnnocnnnnnnnnnnnnnnnnnnnnnnnnononnnannnnnnnnnnnnnnnnos 23 NOZIO Properties Els aos 24 NOZIO Server Eroperties File Vata Dl OS oi 26 Zoe quenceRunner Properties File
57. file is not programmed into flash memory The header of a wrapped file contains a CRC value for the binary image kDiagnostics will strip the header from the downloaded file and recalculate the CRC value for the file received An error message is displayed 1f the file was corrupted during transmission Use kHeader to wrap all files before transmitting them to the DUT Usage is displayed below Kozio kHeader v01 Usage kHeader exe 1 INPUT FILE o OUTPUT FILE a DEST ADDR d DEST TYPE Creates a binary file with a header for use with the Kozio TFTP program i lt file name gt Use the specified file name as input a lt address gt Address to store the image in the target d lt dest type gt Defines the type of memory in which the image will be stored 0 Flash 1 EEPROM 2 RAM 3 NAND o lt file name gt Use the specified file name for output Figure 8 1 kHeader Usage Fixture 1 Kozio ValidationAssistant o x File Edit DUT Help DUT Fixture 1 DUTLog _ Command Log d BeagleBoard a All Components Copyright 2008 2010 Kozio Inc All rights reserved Audio devices CPU Display Devices GPIO 12C Programmed I O RTC SDRAM Secure Digital MultiMec Timer UART USB Host Controller DUT online Figure 8 2Figure 8 3 ValidationAssistantTM with DUT Online 82 Enter the version command to see if the connection to the DUT is working properly The
58. gt tag in a subsequent action tag Such as lt Input gt kScripeCommand lt Input gt The name of the variable must match exactly and is case sensitive See ExecuteCommand for an example 72 6 SequenceReporter fh SequenceReporter allows the generation saving and printing of test reports for publishing Re from any LAN connection Given the right networking set up checks on contract manufacturers test results over a WAN connection can also be made The SequenceReporter user interface allows an engineer or manager instant access to circuit board test results and generates queries to see full circuit board test results Report data includes board type serial test date operator station operator notes and a complete test summary Launch SequenceReporter using the desktop shortcut SequenceReporter displays a startup banner followed by the main operator interface SequenceReporter Version 4 Ah K 2 074 0 A Copyright 2010 Kozio Inc Figure 6 1 SequenceReporter Startup Banner 73 Kozio SequenceReporter N File Settings Help Filters Serial Number Date Range to Platform Operator Runs Passed Failed Both Generate Report Pass Fail Test Date Operator Serial Number Platform No items selected Database connected to kozio on server 192 168 1 32 Figure 6 2 SequenceReporter Initial Screen In old version of screen above Database conne
59. h suite A right mouse button pop up menu is available for all Test Suites One menu option displays help for a test and one executes the test Test Suites also have two additional menu options labeled Tree and Report which are described in the next two sections Fixture 1 Kozio ValidationAssista File Edit DUT Help Js BeagleBoard de All Components di Suites Example Test Suite sh Audio devices CPU Display Devices GPIO 12C y Programmed I O pp RTC SDRAM Secure Digital MultiMedia Card de Timer Jo UART USB Host Controller DUT online example Test Suite lors DUT Fixture1 7 DUTLog T Command Log o 0 Audio device test suite Execute Report Tree Help 43 4 13 1 Test Suites Tree The Tree command can be accessed by right See clicking on a highlighted test suite Select Tree and a P complete listings of all of the nested suites and tests that are included in the suite will be displayed on the Output _ Window ou This same information can be accessed by entering EN the tree command followed by a test suite name on the command line For example on the command line enter tree test sdram and press the Enter key 4 13 2 Test Suites Report Click on Report and ValidationAssistant displays a full report on the selected test suite The information displayed is the test n
60. h high level component such as SDRAM may have low level command Double click on the command to be executed A dialogue box will appear prompting for the parameters Type in the parameters for the specific command and click Execute A right mouse button pop up menu is available for all Low level Commands One menu option displays help for the command and one executes the command File Edit Suites 7 Diagnostic tests Performance tests Test methods Low level commands Clears a bit in memory Clear a bit in memory Clear a bit in memory Seta bit in memory Seta bitin memory Seta bit in memory Display address range 32 bit Display address range ASCII by Display address range 8 bits Display address range 16 bit Query end of test RAM Query start of test RAM Query end of test RAM uncache pole Jo o E Query start of test RAM uncact e NES Clear a single bit in memory Clear a single bit in memory Clear a single bit in memory Set a single bit in memory Set a single bit in memory Seta single bit in memory Read address 32 bit Read address 8 bit Read address 16 bit Display SDRAM test parameters Write address 32 bit Write address 8 bit Write address 16 bit 111 4 9 1 Low Level Help A help menu is available for all low level commands To access this menu select the command and then use the right mouse button Thi
61. he Download radio button to begin the operation Note For this release to program a device on the target with a downloaded file the user must select an image file that has been wrapped using the Kozio utility kHeader exe This utility is freely available from Kozio This utility will encode information into the image file such as where to program the data on the target such as Flash memory This method also provides a cyclic redundancy check CRC for the image to verify the transfer Browse 4 Use Default 4 4 3 3 Execute Script Fixture 1 Kozo ValdatonAstertar The execute script command can be found on the DUT menu located on File Edit DUT Help the menu bar Click on the Execute Script option to download and pur jg WpDUTCommend execute a script Download File to DUT Execute Script 36 37 4 4 4 Help Menu Product registration can be found under the Help command which is located on the menu bar To register click on Register Product under the Help menu and fill out the form with the requested information From the Platform pull down select the platform being used for the DUT Listed on the Platform pull down are evaluation platforms and a separate item for purchased products These two choices work by taking you to a Kozio web page form where you data 1s transferred A license file will be generated and sent to the email address included in the registration information
62. iewer 5 5 Command Line Interface CLI The Command Line Interface CLI allows test commands and script files to be sent to kDiagnosticse running on the device under test DUT Select the fixture under test using the f option The CLI program communicates with KozioServer which then sends commands to the DUT specified by the f option The default value for f is 1 The CLI can be invoked directly from a command window or from third party programs so it can easily be added into existing production test processes The CLI is a host tool that can be used by third party programs to execute Kozio functional tests on the DUT The CLI tool can be called by scripting languages such as Perl The main benefit is the ability to quickly add Kozio functional tests into an existing production test process 5 6 CLI Return Value In accordance with DOS program conventions the CLI returns a positive integer exit status code A return value of zero 0 indicates success A positive value indicates that an error occurred as shown in the following table Exit Status Code Oo Success S O kDiagnostics test failed or sequence execution failed 54 Input error e g file not found Runtime error e g no license file Invalid kDiagnostics command or other DUT error The best way to capture the exact error codes for each failure 1s to redirect output to a log file and parse that log file when a positive return value is encountered More information abo
63. in additional menu options are available to open a test sequence file and to logout To switch operators select the File gt Logout menu option and then log in the new operator 5 3 Executing Test Sequences One of the main purposes of SequenceRunner is to execute test sequences All test sequences are stored in ASCII files using XML tags Find additional information on the format of test sequence files in Section 5 13 Test Sequence Files Several example sequence files and kScript files are provided under the examples folder in C Program Files Kozio examples To start the testing process load a test sequence file using one of two methods e Choose File gt Open Sequence and then ELAN SequenceRunner select the Open Sequence File icon Y view Help MN Open Sequence Exit Sequence rie Serial Number e Choose the task bar icon for Open Sequence File Kozio SequenceRunner File View Help The Open dialog box allows browsing of the test sequence files available Select the desired test sequence file and then select Open SequenceRunner opens and validates the file Section 5 12 XML Validation section describes the validation process NOTE Anytime a test sequence file is modified that file must be reopened so that it is re validated After the test sequence file is loaded the title bar Platform text and Sequence File text are updated based on data from the test seq
64. ing and integrating Kozio software with your existing production test process SequenceReporter Test reporting and tracking used to report the status of board testing by a variety of criteria KozioServer an application that connects all clients to multiple targets simultaneously KozioServer maintains the direct connection to the target Requirements for using the Kozio Host Tools e Windows XP Windows Vista or Windows 7 e If you are using Windows Vista or Windows 7 Microsoft removed support for SLIP Serial Line IP As a result if you are using SLIP and a serial connection from the Kozio host tools to a DUT you must find a SLIP connection or install the Windows XP emulation mode which still offers SLIP e Release 2008 2 or later of kDiagnostics NOTE Execution of any of ValidationAssistant requires the acquisition of a license Once purchased a license can be obtained by going to www kozio com license and providing information that validates the purchase of Kozio software 1 1 Quick Start Instructions The steps below provide a brief description of the steps that must be taken to get Kozio s automated design and manufacturing tests running on the test station On the Device Under Test DUT Section On the Host Section Program or load kDiagnostics on to the DUT If not already running on the DUT Configure the kDiagnostics remote communications variables using kDiagnostics and a terminal emulato
65. l options with prompt actions Lars lt li gt Display lt li gt DAS Lay lt li gt Display reader lt b gt lt 1i gt lt li gt Dusplay lt b gt with lt b gt an image lt li gt lt b gt without lt b gt an image lt li gt and receive user input from a lt b gt barcode and receive user input from a lt b gt text box lt b gt lt 1i gt lt li gt Store data in a variable to pass to other actions lt li gt lt ul gt lt p gt Select OK to continue lt br gt lt b gt lt html gt lt MessageText gt lt Output gt kScriptCommand lt Output gt lt Prompt gt 67 Ka Fixture 1 Prompt with image display E scanner This prompt displays a picture You have several options with prompt actions 8 Display with an image 8 Display without an image 8 Display and receive user input from a barcode reader 8 Display and receive user input from a text box 8 Store data in a variable to pass to other actions Select OK to continue OK Cancel Figure 5 10 Prompt Action from previous Example 5 13 2 12 PutDatabase This test action stores a value in a database table either in the Common or DUT table may be specified Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Table gt Specify the database table with valid values of common or dut lt RowName gt The lab
66. le storing a value to be placed in the database Example lt Get the serial number for test documentation and device programming gt lt ScanLabel Name Input Test Script OkCancel yes gt lt Title gt Scan Label lt Title gt lt MessageText gt lt CDATA lt html gt lt b gt This test uses lt a 2D Scanner to scan a 1D Label br gt Scan the label when ready and click OK when done lt b gt lt html gt lt MessageText gt lt haneCounts2 lt 7hinecount gt lt Output gt ScannedText lt Output gt lt ScanLabel gt lt PutFile Name Save to Disk gt lt Input gt ScannedText lt Input gt lt FilePath gt label lt FilePath gt lt FileName gt label info txt lt FileName gt lt PutFile gt 5 13 2 14 ScanBarcode Receive input from a barcode reader It is recommended that you use ScanLabel in new sequence files as a replacement for ScanBarcode Note that ScanBarcode requires SetSerialNumber Attributes Name Name of this action as it will appear after Current Action on the SequenceRunner user interface screen OkCancel The option to display OK and Cancel buttons Permissible values are Yes or No Timeout Number of seconds to wait for a response before aborting this action Additional Tags 69 lt Title gt The text that will appear on the dialog s title bar lt Image gt An image to display lt MessageText gt The text that will appear in th
67. llAware Wizard Kozio Inc fe Kozio Software Setup Choose the Start Menu group Start Menu group Kozio Suite A new program group will be created in your Start Menu to contain product icons You may create icons for all users to see or just for yourself Create shortcuts for All users of thus computer All users of this computer can see and use the product shortcuts Just me Only you may see the product shortcuts Kozia lt Previous Cancel 11 Select Next The system is now ready to be updated The Previous button returns to the previous page to allow modification any of the parameters specified prior to completing the installation 12 3 Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup Ready to update your system The Installer Wizard has collected all required information and is ready to update your system configuration Hardware Verification and Validation ut Diagnostics Click Next to continue ooo Kozia lt Previous next Cancel 12 Select Next 13 The Installer will now install all Host Tools selected 3 Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup Hardware Verification and Validation Jet Diagnostics File wrapper exe Directory C Program Files Kozio Size 204800 a Kozia lt Previous Herts _ Cance _ 14 When the Kozio Host Tools installation i
68. lt MessageText gt The text that will appear in the dialog box Use simple text or HTML formatted text that 1s contained within a lt CDATA gt tag construct lt LineCount gt The number of text lines to read from the barcode label When the line count is reached no more input is stored in the variable and the dialog is closed This variable allows the test sequence to continue automatically once a barcode is scanned instead of the operator selecting the OK button lt Output gt A variable to store results Example lt ScanLabel Name Enter Serial Number OkCancel no gt 70 lt Title gt Scan Label lt Title gt lt MessageText gt lt CDATA lt html gt lt b gt This test uses the 2D scanner to scan a 1D ADI label lt br gt Scan the label when ready and click OK when done lt lt Do lt arm lt MessageText gt lt Linetount gt 2 lt LaneCount gt lt Output gt ScannedLabel lt Output gt lt ScanLabel gt 5 13 2 16 SetSerial Number This action stores a serial number used for all DUT related database queries This action is required even is a default serial number is used for all DUTs If each DUT has a unique serial number that value can be used for report generation Attributes Name The name of this action as it will appear after Current Action on the SequenceRunner user interface screen Additional Tags lt Title gt The text that will appear on the dialog s title
69. lt br gt lt b gt lt b gt lt font gt lt html gt Fixture Two Welcome lt MessageText gt lt Message gt Operator Plug the phone cable into voice port one 1 Click OK to proceed i Cancel Figure 5 8 Message Action from the Example 5 13 2 10 OperatorComment Prompt the operator to enter a comment The comment is stored in the database as part of the test results record This action must be placed after actions for executing commands for example the ExecuteCommand action 65 Attributes Name The name of this action as 1t will appear after Current Action on the SequenceRunner user interface screen OkCancel The option to display OK and Cancel buttons Permissible values are Yes or No AskWhen Defines when the operator should be prompted to enter a comment into the test database Permissible values are OnError or Always Timeout The number of seconds to wait for a response before aborting this action Additional Tags lt Title gt The text that will appear on the dialog s title bar lt MessageText gt The text that will appear in the dialog box Either a simple text or HTML formatted text can be used that is contained within a lt CDATA gt tag construct This example uses simple text Example lt OperatorComment Name Enter Comment OkCancel Yes AskWhen OnError Timeout 30 gt lt Title gt Enter Comment lt Title gt
70. n dh KOZIO YY Fastest path to reliable hardware gt For additional support contact Kozio Web site www kozio com E mail Technical Support support kozio com Phone Sales 1 303 776 1356 x1 Technical Support 1 303 776 1356 x2 Fax 1 303 776 1357 License Registration www kozio com license
71. nications Setup Host Computer to DUT This section provides information on how to configure the DUT and adjust KozioServer properties as necessary to allow communication between the Host Tools and the DUT With the Kozio Host Tools installed the host computer is now ready to communicate with the DUT Before beginning a testing sequence a kDiagnostics command to enable DUT and Host Tools communication MUST be executed The required kDiagnostics command enables a communication protocol between kDiagnostics and KozioServer This command may be executed automatically through a kScript file built into the DUT image or manually from the kDiagnostics command line kDiagnostics is typically delivered with the remote communications protocol kRemote automatically enabled To manually manage the remote communications protocol modify the communications settings as described below and then start the kRemote communications protocol on the DUT NOTE KozioServer is automatically launched during the Host Tools installation Details about changing server configuration properties and restarting KozioServer to work with the network configuration changes are provided in section 3 3 The Host Tools SequenceRunner ValidationAssistant or the SequenceRunner CLI can be used to remotely communicate with the DUT 3 1 kDiagnostics Remote Communications The variables used by kRemote are listed in the following table Before s
72. nloading Scripts To download a script file select the DUT menu and then select Download File to DUT Fixture 1 Kozio ValidationAssistant File Edit Help DUT F Stop DUT Command Escape Download File to DUT Beaglet All Execute Script 1 Lo Andin devires This will bring up a pop up menu Click on the Browse button and find the location of the desired ksc file Kozio uses the ksc file extension to differentiate Kozio kScript files Select the file Then click on the Download button located in the pop up window File Mame C Program Files Kozio myTests 2c_Scan ksc TFTP Server IP localhost Use Default Parameters Destination kScript Wrap with kHeader Timeout 30 seconds Transfer Status Progress The scripts will automatically be downloaded to the DUT and the also displayed in the Output Window 47 Command Logging For more information on Script and Command creation see the kDiagnostics User Manual 4 16 TFTP File Transfer TFTP file transfer is available through ValidationAssistant for kScript and kHeader wrapped files only The kHeader program is freely distributed by Kozio Please inquire through support kozio com if you would like to receive this additional tool 4 17 Shortcuts Keyboard To do this Press M u Abort a command a YT Copy CTL Paste CTL ValidationAssistant provides a buffer of previously executed comman
73. ogrammed I O am DUT online 4 7 3 Command Tree Prompt For a number of test commands kDiagnostics requires confirmation from the operator When ValidationAssistant du Do you see the color bars receives such a prompt from the target a dialog box is presented to the operator Click Yes or No to complete Le Ne each action Selecting No will fail the test 4 8 Command Line Tests can be executed through the Command Line Type in the name of the command in the Command Line and press the Enter key ValidationAssistant will send each command to the DUT and all output from kDiagnostics will appear in the Output Window To send multiple commands to the the DUT select the text and copy it then select the Command Line and paste the text All copies lines will be sent to the DUT for interpretation by kDiagnostics and all output will be sent to the Output Window This option can also be used to send an entire script file to the DUT A third option of executing commands stored in a script file is to browse for the file using a tool such Windows Explorer and then drag the file onto the Output Window All lines of the file will be sent to the DUT and interpreted by kDiagnostics 39 H RTC SDRAM Je Secure Digital MultiMedia Card ae DUT online kanname 4 9 Low Level Commands 40 Many low level commands are available for the operator to execute Low level commands require parameters Eac
74. ools 16 17 3 Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup Hardware Verification and Validation Diagnostics Kozio Software Installation m Kozia lt Previous Next gt _ Cancel 8 After the process completes select Finish closing the last dialog box 3 Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup Kozio Software Setup is complete The operation was successfully completed Hardware Verification and Validation For installation copy the Kozio license file into your installation folder If you need a license file visit www kozio com license Also if installing the database please follow the finishing instructions in the user manual Kozia lt Previous Finish Cancel NOTE This process will not uninstall the Java Runtime Environment JRE If uninstalling those items is necessary return to Windows Start Control Panel Add or Remove Program and remove these applications from that dialog box 18 It is important to note that the install file should not be deleted as it will be needed for upgrading or removing the product Install the new version of the Kozio Host Tools by running the latest Kozio installer as described in Section 2 2 Host Tool Installation Instructions Review the test and configuration files that were backed up Merge or overwrite changes with the new files as required 19 3 Commu
75. or communicating with Devices Under Test DUTs Two ports are used the base port and base port 1 z TargetPort 4333 DUT Declaration NumberOtFixtures must be declared If it exceeds the licensed value the licensed value will be used instead FixtureNN numbers start at 1 and must be consecutive Do not use a leading zero Fixture IP addresses need not be consecutive and can be any desired value that complies with network configuration NumberOfFixtures 1 Fixturel 192 168 1 230 z Settings for TFTP server Note Root directory is relative to the base installation directory f Set T tpPort to 0 to disable the TFTP server Default port for TFTP is 69 T tpRoot myTests T tpPort 69 z IP Address RMI Registry which should be the same as the Kozio Server Leave blank for localhost z EMTRegistryHost localhost a 29 3 3 3 Restarting KozioServer Anytime kozioserver properties is modified KozioServer must be stopped and restarted NOTE Using Restart does not work The proper sequence is to first Stop then Start KozioServer 1 From the Windows task bar select Start Select Control Panel for Vista users it is recommended to switch to Classic mode to execute these instructions Select Administrative Tools Select Services Highlight the line labeled KozioServer Select Stop the ser
76. or interpretation Commands can also be executed by typing the command in the Command Line See Section 4 7 for more information on the Command Line Fixture 1 Kozio ValidationAssistant File Edit DUT Help DUT Fixture 1 2 DUTLog Z Command Log Ly BeagleBoard W All Components d Suites Example Test Suite long version Example Test Suite short version G One Sec count test Le Audio devices unt 4 32781 Diff 32777 One t test W Suites i count test 32796 Audio device 0 test suite W Test methods Audio Fixed tone Stereo audio record playback test Audio Sine 1kHz tone G e oe ER re eee on fake Ly Low4evel commands unt 4 count 4 5 CPU Li Low4evel commands SDR st Suite L Query CPU data cache 5 5 lking 0 s test addr 0x80700000 bus width 32 Disable CPU data cache Enable CPU data cache Display CPU MMU table Display CPU status Disable interrupt vector Enable interrupt vector o Disable Ctrl C A est testing addresses from 0x80700000 to 0x90000000 Enable Ctrl C CPU Execution Jump S cess Comprehensive bit test 0xc0700000 to 0xc0800000 D Display Devices Je Suites Ss access Comprehensive bit test 0xc0700000 to 0xc0800000 Test display HDMI 24 bit Diagnostic tests Low level commands Congure HDMI output resolution B GPIO access Comprehensive bit test 0x80700000 to 0x90000000 Low4evel commands 12C Pr
77. r Enable kDiagnostics remote communication using the kDiagnostics command kremote run This may be done automatically by creating a kDiagnostics binary that runs this command automatically products or use kozio install va eval exe to only install ValidationAssistant Add exceptions to Windows Firewall settings Optional Establish a SLIP connection to the DUT if using a serial connection SequenceRunner or E UsingValidationAssistant type in version in the command line to verify quickly that all steps have been completed properly Install the host tools using kozio install va exe to install all 2 Installation The Host Tools installation program installs the tool on one or more host computers for use by engineering manufacturing and support The execution requires the installation of kDiagnostics on the Device Under Test DUT ValidationAssistant interacts with kDiagnostics through KozioServer KozioServer can run from the same computer as ValidationAssistant or from any computer that is network accessible When using a direct connection such as serial KozioServer must be installed on the computer connected to the DUT 2 1 DUT Installation Instructions There are two main options for executing kDiagnostics either program the self booting kDiagnostics image into the boot memory on the DUT or use an external loader to load the kDiagnostics binary image that executes directly from R
78. rehensive bit test Ox400000 to Ox s000000 PASSED Simultaneous Switching Output Test 32 bit Ox40400000 to 0x45000000 PASSED Flash walking O s test flash address Oxffece0000 bus width 16 PASSED Flash erase test start address OxffeeDO00 end address Oxffef0000 PASSED PCI Discovery and Configuration Test on interface O 19 tests completed 19 passed O failed End of execution at Thu Sep 25 17 07 25 MDT 2008 Figure 5 7 SequenceRunner Sample Summary Test Report File 57 5 11 SQL Database The database provides a means for tracking test stations operators and test results A full test report 1s stored for each DUT based on barcode and serial number The DUT serial number can be a simple barcode label value or a database mapping of barcode values to UUT Serial Number can be created The database must be pre filled with Barcode UUT Serial Number mappings for this method The entire database schema is open The pgAdmin tool can also be used to traverse the database and execute queries A graphical reporting tool called SequenceReporter provides a quick and easy means of creating custom reports 5 12 XML Validation Every test sequence file must follow a strict set of XML rules defined in a file called KozioSequenceFile dtd Every time a new test sequence file is opened in SequenceRunner it is validated against this set of rules The syntax rules of XML are very simple and very strict 5 13 Test Sequenc
79. rm Passed 2009 04 2314 4247 cindy200t motsey Evaluation O Passed 2009 04 2314 3031 cindy2001 nmotse _ Evaluation oF Failed 2009 04 1710 0633 Andrew mpc8377_ MPC837 ERDB_ o Passed 2009 04 1618 2229 Keith 455 Failed 2009 04 1618 0025 Keith 544 Passed 2009 04 0211 4901 Keith 4567 MPC837XE_RDB Passed 2009 04 01 13 19 56 Andrew 405 PPC405exKilauea Failed 2009 04 0113 1719 Andrew 405ex_ PPC 405 ex Kilauea Failed 2009 04 0113 0842 Andrew 405ex Failed 2009 04 01 13 06 56 Andrew 405ex PPC405ex Kilauea Items found 17 Database connected to kozio on server 192 168 1 32 Figure 6 5 SequenceReporter Report with Filtering 6 3 Print Query Results Use the File gt Print Report menu option to print the query results This saves the display on the main screen Print x pte eseeeeneneeeenes E General Page Setup Appearance Mensnnnancancanarananod Print Service Name adobe PDF v Properties Status Accepting jobs Type I Print To File Copies Number of copies 1 Collate Cancel Figure 6 6 SequenceReporter Print Query Results 75 76 6 4 Save Report Additional options are available when an item displayed in the results pane is selected Select a line item and use the right mouse button to display a pop up menu Access to information stored in the database 1s now available The stored Test Summary Detailed Log or Op
80. ry image file or parsed in real time by kDiagnostics The script file can be sent to kDiagnostics using ValidationAssistant terminal emulation software such as TeraTerm or to an associate via email Ei kRemote ksc WordPad File Edit View Insert Format Help Deh Si a As BB Kozio R kDiagnostics R Script File C Copyright 2003 2008 Kozio Inc This simple script file sets all remote communications Variables and then enables the remote communications This is an example only and must be updated for each computer and target combination NOTE Use 1 netdev show to determine which network device to use Y Y Y Y a kremote debug ip 192 168 1 100 gt ip target ip 192 168 1 1 gt ip gateway ip 255 255 255 0 gt ip netmmask ip 192 168 1 32 gt ip peer 4333 gt kremote port 3 gt kremote netdev kremote debug kremote run For Help press F1 3 1 1 Displaying Remote Communications Variables Use kremote debug to display current remote communication variables and their values E Kozio Tera Term COM6 VT File Edit Setup Control Window Help Ikdiags ins gt kremote de Network settings used val 1p target val 1p gateva val 1p netmas val ip peer val slip target i d d FX nd od Y Y SOV Oo E MMTV tA A A Oa Oo E O o o m O Dopp val kremote port val kremote netdev kd1ags 1ns gt A gt 3 1 2 Enabling kDiagnostics Remote Communications
81. s entered by the operator for that test run Here are samples from the three choices PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED PASSED ProSLIC Configuration ProSLIc Configuration Voice Voice Voice Voice Interface Interface Interface Interface test to device test to device test to device test to device DTMF Tone Loopback Test on DTMF Tone Loopback Test on DTMF Tone Loopback Test on DTMF Tone Loopback Test on PCI Discovery and Configuration Test on interface O Intitializing miniPCI Test Card O miniPCI Test Card Data bus walking O s test miniPCI Test Card Data bus walking 1 s test Memory bus noise test to address 0x45004000 MiniPCI Test Card 32 bit Memory bus noise test MiniPCI Burst Access hurst mode Simultaneous Switching Output Tes MiniPCI Card O IO Cycles Test MiniPCI Card O Interrupt Test MiniPCI LED GPIO Test All Car las tests completed 45 passed O failed Operator note GPIO test failed 14 index O index 1 index 2 index 3 and Calibration Test and Calibration Test and Calibration Test and Calibration Test channel O channel 1 channel 2 channel 3 on on on on Comprehensive bit address ds Close Save Figure 6 8 SequenceReporter Summary Test Report Dialog Comprehensive bit test Gt
82. s finished the final Kozio installation dialog box is displayed 13 Kozio Software InstallAware Wizard Kozio Inc fe Kozio Software Setup Kozio Software Setup is complete The operation was successfully completed Hardware Verification and Validation ef For installation copy the Kozio license file into your Diagnostics installation folder If you need a license file visit J www kozio com license Also if installing the database please follow the finishing instructions in the user manual Kozia lt Previous Finish Cancel 15 When the Kozio license has been received be sure to copy the license file into the installation directory recommended location C Program Files Kozio 2 3 Windows Firewall Instructions The latest Service Packs from Microsoft automatically enable the Windows Firewall feature This feature adds a level of security to the host computer One feature of the firewall is that many TCP and UDP ports are blocked unless specific access is allowed ValidationAssistant uses TCP and UDP ports for communications If Windows Firewall is used and it may be automatically enabled the host computer must be configured for access in order to receive communications over four specific ports Without this access the Kozio software cannot function properly This step is only required once even if Kozio software is uninstalled and reinstalled 14 Follow these steps to enable the necessary ports
83. s indicates that the wrong port is being used or the network connection is down The DUT will display over the serial connection the message Target Server handshake successful when the DUT is connected Verify DUT and server IP address properties kDiagnostics will display remote communication properties on TeraTerm KozioServer stores IP properties in the kozioserver properties file Make sure KozioServer is running Under Windows use the Start Control Panel Administrative Tools Services to check KozioServer s status Use Stop and then Start to restart KozioServer This is required any time kozioserver properties is modified Check the Windows Firewall settings to make sure that ports 4333 4334 and 1099 are not blocked These are the port numbers listed in the properties file It may be necessary to disable the software firewall for testing 84 9 2 Windows Security Alert If a Windows Security Alert is displayed when running the RMI Server and the Name of the program is Java TM Platform SE binary select the Unblock button E Windows Security Alert Ed j To help protect your computer Windows Firewall has blocked some features of this program Do you want to keep blocking this program Name Java TM Platform SE binary Publisher Sun Microsystems Inc Keep Blocking Unblock Ask Me Later Windows Firewall has blocked this program from accepting connections from the Internet or a network If yo
84. s will bring up the Help option Click on the Help button A box will appear on the screen providing command synopsis description usage and environment for the selected command DUT Fixture 1 w DUTLog Command Log e Parameters i addr start length gic a width bytes 0x8 1000000 Breau Cae Caes rep Fixture 1 Kozio Validatio Assistan File Edit DUT Help DUT Fixture 1 ww 7 DUTLog E Command Log d BeagleBoard All Components y Audio devices J CPU Display Devices bb Suites Diagnostic tests 4 Low evel commands Programmed 1 0 SDRAM Secure Digital MultiMedia Card Timer UART USB Host Controller 3 lt DUT online Command DISP HDMI CFG Synopsis Congure HDMI output resolution Description Configures the resolution used by the HDMI display routine Pass lin o zero as the id select parameter to display all supported resolutions 41 4 10 Test Methods Test methods are a set of diagnostics tests that deliver a pass fail result Double click on the name of a test method to run it Type in the parameters for the specific command and click on Execute The results will be displayed in the Output Window A right mouse button pop up menu is available for all Test Methods One menu option displays help for the command and one executes the command DUT Fixturei DUTLog T Command Log d BeagleBoard
85. se only the test range information is displayed in the Output Window for testing the address bus bits 44 a Fixture 1 Kozio Validatic File Edit DUT Help DUT Fixture 1 w 7 DUTLog 7 Command Log Jp BeagleBoard Mi kozio gt test sdram address All Components mAddress bus test testing addresses from IRON COORD Audio devices CPU Display Devices GPIO DUT online To change the trace level type the trace level in the Command Line and hit Enter The command to change the trace level echoing is lt level gt trace level echo where lt level gt is an integer from 0 to 6 The value of zero turns off all echoing of trace commands and the larger the integer the more data that is displayed on the Output Window After changing the trace echo level reenter the command test sdram address More information about the test being run is displayed about what the test is doing in the Output Window For example with a trace level of 3 a few additional lines of information is displayed E Fixture 1 Kozio ValidationAssistan Lo x N File Edit DUT Help DUT Fixture 1 3 DUTLog T Command Log d BeagleBoard de All Components Audio devices CPU Display Devices A ess bus te testing idresse om 0x80700000 to 0x90000000 GPIO r sets in range po 120 Writ in ane Programmed I O Aj 700000 skippe a ees SDRAM Urita mu a a n OwSS to anc OwRO Teele o Ox9 DO y Secure Digital MultiMed E o
86. ss you are installing all programs on this computer they will all have the same IP 192 168 1 3 Address Database IP Address 192 168 1 4 Device Under Test DUT IP Address 192 168 1 5 To continue enter values for all helds lt Previous next Cancel 7 Select Next 10 8 The dialog box below selects which programs will be installed on the host computer Select a feature on the left panel and the feature description is updated Use the right mouse menu over a feature to exclude or include a feature The installation path may also be changed but it is recommended to select the default path C Program Files Kozio 3 Kozio Software InstallAware Wizard Kozio Inc Ta Kozio Software Setup iption Select features to install Feature description oo E v Kozio Server o E y ValidationAssistant The Kozio Server program is installed as a Windows System Service routine This program communicates directly with the Device Under Test DUT You must install one Kozio Server on one computer in your network Product install path Ic Program Files Kozio Browse Disk space requirements Available 158 199 MB Required 10 753 KB Remaining 158 188 MB lt Previous Cancel 9 Select Next 11 10 You can enter the name of the Windows Start Menu group identifier in the dialog box below but we suggest using the default value 3 Kozio Software Insta
87. tarting kRemote you should review each variable setting and make any changes that may be necessary as described in 3 1 1 Variable Example Description To Update Sip target 192 168 1 210 The IP address of the DUT This value is ip 192 168 1 210 gt Sip target required by KozioServer Sip gateway 192 168 1 0 The network gateway used by the DUT ip 192 168 1 0 gt Sip gateway Sip netmask 255 255 255 0 The network mask used by the DUT ip 255 255 255 0 gt Sip netmask Skremote port 4333 The TCP UDP port number used for 4333 gt Skremote port communications between the DUT and server Skremote netdev 3 The network communications device that the 3 gt Skremote netdev DUT will use for remote communications Note Use 1 netdev show to list all available network devices The last column describes how to update a given variable For IP address updates the 1p precedes the new IP address in dot notation The right arrow gt a minus sign followed immediately by a greater than sign denotes a variable assignment The last item is the variable name to be updated Update any variable by using the kDiagnostics command line or save the commands in a text file and have kDiagnostics parse the file 20 Kozio uses the ksc extension to denote a kScript test file Files of this type are ASCII text files containing Kozio kScript commands Once saved in a file commands can be built into an updated kDiagnostics bina
88. ther the DUT is online or offline Online indicates that a status command was successfully sent from the server to the DUT and back again Offline indicates a communications problem between the server and DUT DUT Fixture 1 de Default See Help EJ README DUT online ValidationAssistant v4 Capabilities o In System Diagnostics ISD is a powerful and proven new technology for comprehensive verification and validation Point and click executable test suites y 8y P dada e ah URu Test automation used to create control Rem n i i emote Scoss tO any argat resident w and distribute test sequences for manufacturing test Easily customized for test modification dh and configuration h Database manager used for test reporting and tracking 4 Control of the entire testing process ox Development kit used for building custom source code Ww test routines and compiling customized kDiagnostics binaries 32 4 3 Validating Setup 33 Run ValidationAssistant and type in version in the command line to verify quickly that all steps have been completed properly File Edit DUT Help DUT Fixture 1 T DUT Log T Command Log m BeagleBoard All Components ce Audio devices i H CPU Je Display Devices H GPIO p 12C 3 1 Programmed 1 0 p RTC SDRAM 4 y Secure Digital MultiMe gt Je Timer cH UART rr USB Host Controller kozio gt version BUT online
89. ture 1 Kozio ValidationAssi Edit DUT Help E Log DUT Output E Log Commands Load Command Tree Exit 4 4 1 4 Exit Go to the File menu located on the menu bar and click on Exit to close ValidationAssistant Fixture 1 Kozio ValidationAssistant Edit DUT Help El Log DUT Output E Log Commands Load Command Tree MN Exit 4 4 2 Edit Menu 4 4 2 1 Clear Window Go to the File menu and click This will bring the pull down menu up Click on the Clear Output Window option to clear all of the text previously displayed text in the results box File ESA OFT Help pai Clear Output Window Cisl amand tog 4 4 3 1 Stop DUT Command 4 4 3 DUT Menu DUT Help Stop DUT Command Escape Download File to Execute Script 35 Use the Stop DUT Command option to cancel a command in progress You can also use the Escape key as a shortcut for aborting a command in progress 4 4 3 2 Download File to DUT To download files to the DUT select the DUT item located on the menu bar E Fixture 1 Kozio ValdationAasistan File Edit Help Stop DUT Command Escape Download File to DUT Execute Sonipt This will bring up a pop up menu Select the menu option Download File to DUT which will bring up a dialog box Type in the name of the file to be downloaded or click on the Browse radio button to locate the file Click on t
90. u recognize the program or trust the publisher you can unblock it When should unblock a program Figure 9 2 Error Windows Security Alert To prevent this Alert from happening follow the steps described in Section 2 3 to add the port to the Windows Firewall 9 3 Windows Firewall Issues Windows XP Firewall blocks by default the UDP and TCP communications ports used by the Kozio Software applications If error messages about running any client application are encountered follow the steps in Section 2 3 to update the Windows Firewall settings When the required ports are blocked messages from the DUT are received be the host but blocked by the firewall The client applications do not receive the expected messages If the Kozio Host Tools do not receive messages double check the Windows Firewall settings 9 4 License Errors A license to use the Host Tools is required If a license file 1s missing the following message appears LICENSE ERROR Ed X No license file found Figure 9 3 Error License file missing Contact the Kozio Sales Department to purchase a license or contact Technical Support 1f a license has been purchased but there are technical issues Go to www kozio com license to request a new license file 85 The license file cannot be modified If the file 1s altered the following error message appears LICENSE ERROR Eg y License file is invalid Figure 9 4 Error License file invalid
91. ue specified here This allows variable length values to be read with one test sequence file as long as each variable is on a Separate line lt Output gt A variable to store results Example 64 lt GetValue Name GetValue Action gt lt Title gt Parse Scanned Label lt Title gt lt Input gt ScannedLabel lt Input gt lt LineNumber gt 1 lt LineNumber gt lt Startotiset gt 3 lt StartOtiset gt lt SubstringLength gt 127 lt SubstringLength gt lt Output gt SerialNumber lt Output gt lt GetValue gt 5 13 2 9 Message Display a message to the operator Attributes Name The name of this action as 1t will appear after Current Action on the SequenceRunner user interface screen OkCancel The option to display OK and Cancel buttons Permissible values are Yes or No Additional Tags lt Title gt The text that will appear on the dialog s title bar lt MessageText gt The text that will appear in the dialog box Either a simple text or HTML formatted text can be used that 1s contained within a lt CDATA gt tag construct Example lt Message Name Welcome OkCancel Yes gt lt Title gt Welcome lt Title gt lt MessageText gt lt CDATA lt html gt lt font size 4 1 face Verdana gt lt br gt lt center gt lt u gt Operator lt u gt lt center gt lt br gt Plug the phone cable into voice port one 1 lt br gt lt br gt Click OK to proceed
92. uence file In addition the START button becomes active NOTE Sample test sequence files have been provided but these must be checked and edited if necessary to match the DUT File 50 i lt Fixture 1 Kozio Lo E a View Help Platform Evaluation Sequence File SystemCommand xml Serial Number Overall Status WARNING no SetSerialNumber Action Overall Progress Current Action Test Progress gt im START STOP Server online Database connected to kozio on server 192 168 1 32 Figure 5 3 SequenceRunner With SystemCommand xml Loaded Press the START button to begin executing a test sequence As the test sequence executes the screen will be updated as follows DUT Serial Number Overall Status This specification selects the fixture under test Default Fixture Number 1 This field 1s updated by the SetSerialNumber action This field 1s updated with a pass or fail message after the test sequence is executed Overall Progress This progress bar is updated after each action in the test sequence is completed Current Action This field is updated as each action is executed The text displayed is taken Test Progress directly from the Name attribute of each action tag in the XML file This field displays status information directly from the DUT The test designer does not have control over this text 51 Select the Start button to execute th
93. uninstall procedure uses this file and will not work without it To uninstall follow these steps From the Windows task bar select Start Select Control Panel Double click Add or Remove Programs Scroll down and select the Kozio Suite item oe ee a1 x Or J EA Control Panel Programs Programs and Features Search Pr ES Uninstall or change a program jew nstalled updates To uninstal a program select it from the ist and then cick Uninstal Change or Repair Help ink http www kozio com Comments All rights reserved 5 Select the Uninstall radio button 2 Kozio Software InstallAware Wizard Kozio Inc a Kozio Software Setup PL C Add or Remove Features E Change which features are installed or remove specific features LE Uninstall Kozio Software a ty Remove Kozio Software from this computer Kozia lt Previous next Cancel 6 The Kozio Installer will launch Select the Uninstall Kozio Suite radio button and then select Next 3 Kozio Software InstallAware Wizard 215 x Kozio Inc fe Kozio Software Setup Ready to update your system The Installer Wizard has collected all required information and is ready to update your system configuration Click Next to continue Kozia Hardware Verification and Validation lt Previous Cancel 7 Select Next to begin uninstalling the Kozio Host T
94. uration or setup issue View the log file using one of the following two methods Fixture 1 Kozio SequenceRunner File View Help MTY E Summary Report e Alternately view the log file using SequenceReporter and the integrated database For more information see Chapter 6 SequenceReporter e Using View gt Detailed Log 53 An example of a run log is shown below after executing a version command on the DUT Fiture1 Detailed Log Viewer Start execution of Sequence C Program Files Kozio examples SystemCommand xml at Thu Apr Processing Message ma named Execute System Command Action Processing Connect Act named Establish Connection Processing SystemCommand Action named Example of External Command Execution SystemCommand executing command cli exe s examples Report ksc SystemCommand command output CLI connected to database Setting new fixture number i CLI unable to load sequence file examples Report ksc CLI error message is C Program Files Kozio examples Report ksc The system cannot SystemCommand standard error output of the command if any System command failed Processing Disconnect Action named Shut Down Connection Event listener thread shut down complete Execution failed at Action Example of External Command Execution Sequence execution completed at Thu Apr 30 16 10 52 MDT 2009 Figure 5 6 SequenceRunner Detailed Log V
95. ut the failure may also be found in the Kozio log file logs koziologs log 5 7 CLI Options Execute sequencerunnercli h to view a list of available options usage SequenceRunnerCLI options command e DORE Abort currently executing command f lt fixture number gt Specify Fixture Number h Print helo Tor this application help Print help Lor tnis application 1 lt ip address gt Specify DUT IP address k lt script name gt Execute kScript file lt log file gt Capture output to logfile 0 Overwrite old logfile contents o Execute commands in quiet mode r lt repeat count gt Repeat command s lt sequence name gt Load and execute sequence file t lt cmd timeout gt Specify command timeout value seconds u lt user name gt set user name y Display version information version Display version information 5 8 Executing Commands with CLI To execute a test command use sequencerunnercli command Wy 66 The command string is any valid kDiagnosticse command such as test sdram version cpu mmu etc This option sends the command to the DUT for immediate interpretation Results are displayed to the output console and the overall success of execution 1s given by the program s exit status code A list of available commands is documented in the kDiagnostics Command Reference manual 5 9 Executing a Test Script with CLI To execute a test script for a single fixture use sequen
96. vice Select Start the service IS A ae NOTE It is good practice to run ValidationAssistant and type in the simple version command to verify server to DUT communications 30 4 ValidationAssistant 4 1 Getting Started dh TVA ANY ValidationAssistant provides a means to execute test commands and acts as an event listener displaying all information received from a device under test DUT Launch ValidationAssistant using the desktop shortcut 4 1 1 Start Up Banner ValidationAssistant interface displays a startup banner followed by a welcome screen and the main operator ValidationAssistant Version 4 dh A XOyA 10 yw Copyright 2010 Kozio Inc 4 1 2 Welcome Screen 31 A welcome screen will pop up providing shortcuts to valuable information and documents Click the red X in the upper right hand corner of the screen to close A Don t show again box is also provided in the bottom left hand corner ValidationAssistant v4 Capabilities 2 Point and click executable test suites Remote access to any target resident Easily customized for test modification and configuration Control of the entire testing process mi Don t show again N In System Diagnostics ISD is a powerful and proven new technology for comprehensive verification and validation Test automation used to create control and distribute test sequences for manufacturing test
97. vice Under Test DTD Document Type Definition DTD is one of the XML schema languages used to detail the syntactical requirements of a given XML file type KSC The file extension used to denote Kozio kScript files RMI The Java Remote Method Invocation API or Java RMI is a Java application programming interface for performing remote procedure calls SLIP The Serial Line Internet Protocol SLIP is an encapsulation of the Internet Protocol designed to work over serial ports It is documented in RFC 1055 SLIP is often used with microprocessors instead of using the Point to Point Protocol PPP due to its very small overhead XML The Extensible Markup Language XML is a general purpose markup language much like HTML It allows its users to define their own tags and enables the structured sharing of data 10 3 Glossary Connection This describes the physical cabling between the host computer and DUT The connection types may be a serial cable Ethernet cable or other type of supported Cygwin Ethernet Host IP Address kScript Net Mask Serial Target connection Linux like environment for Windows making it possible to port software running on POSIX systems such as Linux BSD and Unix systems to Windows See www cygwin com for additional information Ethernet is a family of frame based computer networking technologies for local area networks LANs The name comes from the physical concept of the ether It defines a

1 - Kozio

Contents

Download Pdf Manuals

Related Search

Related Contents