DDR Validation Tool Getting Started Guide Document Number: QCVSDDRVGETSTARTUG Rev 4.1, 10/2014
2 Freescale Semiconductor, Inc.
Contents Section number Title Page Chapter 1 Getting Started with DDR Validation Tool 1.1 Install DDRv tool...5 1.2 Configure DDR component... 5 1.2.1 Creating QorIQ Configuration project...6 1.2.2 Adding DDR component to existing project...10 1.3 Start DDRv tool... 12 1.4 Target connection setup... 13 1.5 Validation scenarios and tests...15 1.6 Running validation...17 1.7 Validation results and logs...18 Freescale Semiconductor, Inc. 3
4 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool QCVS provides validation features on top of the configuration capabilities. The validation capabilities are accessible only if you are having a valid license. In that case, some of the configuration panels may have validation specific widgets. Currently, there is validation support for the DDR component. For more details, see QorIQ Configuration and Validation Suite DDR Validation Tool document (QORIQCSDDRVALUG.pdf). This document describes how to create a new QorIQ configuration project and configure the DDR component. It also describes the basic operations that can be performed using the DDR validation tool. Install DDRv tool Configure DDR component Start DDRv tool Target connection setup Validation scenarios and tests Running validation Validation results and logs 1.1 Install DDRv tool DDRv is installed as part of the QCVS product installation and it is a licensed component. For installation details, see Installation guide (QCVS_Installation_Guide.pdf). Freescale Semiconductor, Inc. 5
Configure DDR component 1.2 Configure DDR component The DDRv tool is a software component installed on top of the QCS tool. The configuration of DDR component is refined by validating it using a step by step approach. Creating QorIQ Configuration project Adding DDR component to existing project 1.2.1 Creating QorIQ Configuration project Perform the following steps to create a QorIQ configuration project: 1. Select File > New > QorIQ Configuration Project. The New QorIQ Configuration Project wizard appears. 6 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool Figure 1-1. New QorIQ Configuration Project wizard 2. Enter the project name and click Next. The Devices page appears. Freescale Semiconductor, Inc. 7
Configure DDR component Figure 1-2. Devices page 3. Select the required processor and also choose a silicon revision and click Next. The Toolset selection page appears. 8 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool Figure 1-3. Toolset selection page 4. Select DDR Memory Controller Configuration option from the Components list and click Next. The DDR Configuration page appears. Freescale Semiconductor, Inc. 9
Configure DDR component Figure 1-4. DDR Configuration page 5. You can configure DDR component parameters or import DDR configuration from memory dump. Click Finish to complete the project creation. To access DDR validation features, in the Components view, double-click the DDR component, the Component Inspector view appears. Click the Validation tab in the Component Inspector view. 10 Freescale Semiconductor, Inc.
1.2.2 Adding DDR component to existing project Chapter 1 Getting Started with DDR Validation Tool To validate DDR using an existing QCS project that has no DDR component, add a new DDR component to the project using the component wizard. To add DDR component to the existing project: 1. In the Component Library view, right-click on the DDR component and select Add to project with Wizard option from the context menu. Figure 1-5. Component Inspector view - Adding DDR component 2. The DDR Configuration page appears. Freescale Semiconductor, Inc. 11
Start DDRv tool Figure 1-6. DDR Configuration page In the DDR configuration wizard page, you can configure the main parameters of DDR. 1.3 Start DDRv tool To start the DDRv tool: 1. In the Components view, expand the Components folder. 12 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool 2. In the Components folder, double-click the DDR component. The DDR Component Inspector view appears. This view displays a Validation tab. There are few pre-defined Validation scenarios. Figure below shows the various user interface elements related to DDR validation. Figure 1-7. DDR Validation views 1.4 Target connection setup The DDR validation uses a client server architecture to allow validation on both local and remote systems. If you have a target board connected (by USBTAP or ETAP) directly to your PC, you can validate it locally. Validation on the local system is used by default. To run validation tests on a target board connected to a remote system: In the Component Inspector view, click on the Target Connections button, the Hardware Configuration Manager dialog appears. It displays a list of existing target connections. Freescale Semiconductor, Inc. 13
Target connection setup Figure 1-8. Hardware Configuration Manager dialog You can select either the remote or localhost option from the Hardware accesible from combo box. Enter the IP address of the remote machine that has targets connected to it and click Connect. In either of the cases local or remote validation, after successfully connecting to the validation service, the tool retrieves the list of available target connections (either locally or on remote machine). The tool issues a warning if you have selected a target connection that has a different target than that of the QorIQ Configuration project that contains the DDR component to be validated. When connected to the validation server, you can add or remove target connections or edit existing target connections by clicking the New, Edit, and Delete buttons. For example, when adding a new target connection, you must enter the connection name, the type of the target, and the target probe type (USBTAP, ETAP, GTAP, or CWTAP) and the probe address (for example, the IP address if you are using a CodeWarrior TAP) as shown below. 14 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool Figure 1-9. New connection screen If there is any connection to a target that is same as the target of the QorIQ Configuration project, the DDRv tool will automatically select and test that target connection. However, you have the option to change the target on which you want to validate the DDR component. 1.5 Validation scenarios and tests After the tool is successfully connected to a validation server, you can select the test scenarios to validate on the selected target as shown below. Freescale Semiconductor, Inc. 15
Validation scenarios and tests Figure 1-10. Validation scenarios screen For each of the test scenarios (for example, Centering the clock, Read ODT and driver, Write ODT and driver) that are selected to run, you can customize the scripts to execute and the number of repetitions for each script by selecting the Choose Tests tab for a selected test scenario. 16 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool Figure 1-11. Validation scenarios screen - Choose Tests tab In the Choose Tests tab, you can: Check or uncheck what tests to run for a selected scenario Update the number of repetitions for each test (click-and-type in the Repetition cell) Add custom tests Remove or rename custom tests (by right clicking on the test) Edit the existing test scripts contents (by double clicking on a test) 1.6 Running validation When one or more test scenarios are selected, the Start Validation button is enabled, and then you can click on it to start the validation of the DDR component. A validation starts executing various configurations with each combination represented as a cell in the Results table as shown below. For example, you select the Centering the clock scenario and BIST and Walking Ones as test. The Centering the clock scenario varies the CLK_ADJ and WRLVL_START DDR controller parameters. When scenario runs, the chosen tests are run for each of the two parameter variation. Freescale Semiconductor, Inc. 17
Validation results and logs Figure 1-12. Results screen When the validation step for this scenario is finished, it outputs whether the test is passed or not and from the subset of passing cells, it automatically selects the Golden cell (that has the best configuration). Before proceeding to the next validation step (that is the next test scenario), the tool applies the DDR configuration corresponding to the Golden cell of the last executed test scenario. In case none of the cell has passing configurations, you should restart the validation step. In case there is at least one passing cell, if you are not satisfied with the automatic Golden cell selection, you can select a different passing cell to have its configuration applied for the next validation step. 1.7 Validation results and logs For each of the test scenario cells, the tool displays the relevant information. To view this information, you must select a test scenario that was executed, and must select a cell from the test scenario table. The ratio of number of passed tests to the number of executed tests is shown in the table cell. You can also view in Summary, Logs, and Scripts tabs of the table and can find the detailed information relevant for the test scripts that were executed for the selected cell. 18 Freescale Semiconductor, Inc.
Chapter 1 Getting Started with DDR Validation Tool Figure 1-13. Validation Results screen Summary view: Shows the DDR configuration register values that were updated for the selected cell, the number, and the status and the error register values for each test execution. Logs view: Lets you inspect the logs attached to each test execution in order to understand why a test failed or passed. Scripts view: Provides the opportunity to inspect the actual test scripts that were executed on the target. Freescale Semiconductor, Inc. 19
Validation results and logs 20 Freescale Semiconductor, Inc.
How to Reach Us: Home Page: freescale.com Web Support: freescale.com/support Information in this document is provided solely to enable system and software implementers to use Freescale products. There are no express or implied copyright licenses granted hereunder to design or fabricate any integrated circuits based on the information in this document. Freescale reserves the right to make changes without further notice to any products herein. Freescale makes no warranty, representation, or guarantee regarding the suitability of its products for any particular purpose, nor does Freescale assume any liability arising out of the application or use of any product or circuit, and specifically disclaims any and all liability, including without limitation consequential or incidental damages. Typical parameters that may be provided in Freescale data sheets and/or specifications can and do vary in different applications, and actual performance may vary over time. All operating parameters, including typicals, must be validated for each customer application by customer's technical experts. Freescale does not convey any license under its patent rights nor the rights of others. Freescale sells products pursuant to standard terms and conditions of sale, which can be found at the following address: freescale.com/salestermsandconditions. Freescale, the Freescale logo, CodeWarrior, QorIQ, and Processor Expert are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. All other product or service names are the property of their respective owners. 2011 2014 Freescale Semiconductor, Inc. Document Number QCVSDDRVGETSTARTUG Revision 4.1, 10/2014