CodeWarrior Development Studio for Advanced Packet Processing v10.2

Transcription

1 Freescale Semiconductor Release Notes Document Number: CW-APP-RN CodeWarrior Development Studio for Advanced Packet Processing v10.2 Freescale Semiconductor, Inc. 1. Revision History The following modifications to this release note have been made relative to the note provided with the CodeWarrior for Advanced Packet Processing v10.2 installation: Contents 1. Revision History About this release System Requirements Release Contents Fixed Issues Known Issues Date Jan 12, 2016 Jan 15, 2016 Description v10.2 release Updated fixed issues list An updated version of this document is available on CodeWarrior for Advanced Packet Processing product support page. 2. About this release 2.1 Version information This release note provides important information for users of CodeWarrior Development Studio for APP. You are encouraged to read this document to become familiar with this release s supported targets, new 2016 Freescale Semiconductor, Inc. All rights reserved

2 About this release features, errata with workarounds, and other useful information. CodeWarrior for Advanced Packet Processing includes compile, debug, trace, and profile tools for the AIOP packet processor in the LS2085A device and the LS2085A-RDB and LS2085A-QDS boards. v is an incremental release of v including fixes and stability improvements in CodeWarrior for APP and LS Series Device Simulator. In addition it brings new software analysis features. This release has been validated with the LS2085A EAR6 Linux SDK release candidate. All CodeWarrior components with LS2085A support including CodeWarrior for Advanced Packet Processing are delivered by means of a single installer named CW4NET. Users are advised to install all packages in order to get full visibility and control over the LS2085A device (simulated, emulated, or real hardware). The following component versions are available: - CodeWarrior for Advanced Packet Processing v AIOP Analysis Tool CodeWarrior Converter Server b439 - CodeWarrior for QorIQ LS Series, ARMv8 ISA v CodeWarrior for QorIQ LS Series, ARMv7 ISA v LS Series Simulator m QorIQ Configuration and Validation Suite version Scenario Tools version Licensing This release is distributed under an End-User License Agreement. The EULA is displayed during product installation and a copy is located in the layout. Please read the contents of the document carefully before using this product. When used for evaluation purposes CodeWarrior will generate a temporary license valid for 15 days from installation date. Please note that the generated license certificate is node-locked to the machine running the installer; evaluation on multiple machines requires separate installs. Past expiry, external users can solicit an evaluation extension by opening a licensing SR please see section 2.4. The license certificate (license.dat) needs to be placed in the CW_NetApps_<version>/Common/ folder. Note that use of the LS Series Simulator requires a separate license. A guide for obtaining the license is available here. Freescale Semiconductor 3

3 About this release 2.3 Getting Help Product documentation is included with the layout, available for off-line from the Documentation folder in the link above, or from Freescale Infocenter. If you have questions, issues, or want to provide feedback, please use the Freescale online support web page. To use this page, follow these steps: 1. In a web browser, go to Freescale s Technical Support web page appears. 2. On this page, click the Submit a service request online link. The New Service Request Category/Topic page appears. 3. From the Category dropdown menu, select Technical Request. 4. From the Topic dropdown menu, select CodeWarrior (or other appropriate topic). 5. Click Next. The New Service Request SR Details page appears. 6. In this page, enter the requested information. At a minimum, enter information in each field marked by an *. 7. Click Submit. If you are already logged in, the Service Request Confirmation page appears. Go to the last step. If you are not already logged in, the Log-in page appears. 8. If you are a registered member, login with your user name and password. The Service Request Confirmation page appears. Go to the last step. 9. If you have not yet registered, a. If you want to become registered member, click Register Now and complete the registration process. The Service Request Confirmation page appears. b. If you do not want to register, supply your contact information in the I do not want to register - Provide contact information form and click Submit. The Service Request Confirmation page appears. 10. Click Done. Your service request is submitted. 4 Freescale Semiconductor

4 System Requirements 3. System Requirements CodeWarrior Host Windows OS: Intel Pentium 4 processor, 2 GHz or faster, Intel Xeon, Intel Core, AMD Athlon 64, AMD Opteron, or later Linux OS: 1.8 GHz Intel Pentium class processor (or better). At least 2 GB of RAM At least 3 GB of free disk space. Internet connectivity for web downloads and update access. LS Series Device Simulator Host A 64-bit host running a supported Linux distribution (see below). 64-bit host OS required. Minimum 2 GB, recommended 4 GB of RAM Operating System Windows Host OS SP Level 32-bit 64-bit Windows 7 SP1 X X Windows 8.1 U1 X Windows 10 X Linux Host OS Version 64-bit Ubuntu X Ubuntu X Fedora 20 X Fedora 21 X Open SUSE 13.2 X RedHat Enterprise Linux 5.8 X RedHat Enterprise Linux / CentOS 6.5 X RedHat Enterprise Linux / CentOS 6.6 X Mint 17.3 X NOTE CodeWarrior installation on 64-bit Linux hosts requires presence of dependent 32-bit libraries in the system. For supported distributions the installer detects missing dependencies and provides options to install them automatically. For unsupported distributions please follow the instructions provided by the installer and/or installation README. Installation on non-lts distributions (e.g. Ubuntu 13.x) is not recommended as the package repository changes URL once support for that particular Freescale Semiconductor 5

5 System Requirements version ends. Please consult the vendor web site for finding out the new repository location and proceed with manual installation of CW dependencies. It is recommended (although not required) that all product maintenance operations be done with administrative privileges. When running the installer in GUI mode with admin privileges please use the graphical sudo command recommended by your Linux distribution (ie. gksu/gksudo). CodeWarrior installer may update system drivers for probe connectivity. It is highly recommended that any CW4NET versions or products should be closed before installing or updating an existing CW. 6 Freescale Semiconductor

6 Release Contents 4. Release Contents This section describes the main product feature in this general availability release (v10.2). 4.1 General This release is based on Eclipse CodeWarrior tools assume the target board is configured for ARM debugger compliant mode, as opposed to Boundary Scan mode. The following switches need to be applied: - LS2085A-RDB: SW7.7 set to ON (TBSCAN_EN_B=1) - LS2085A-QDS: SW5.7 set to ON (TBSCAN_EN_B=1) Failure to apply the correct switch configuration results in inability to connect to the target. Connectivity in Boundary Scan mode is no longer supported. The following picture shows the location of the switch on the LS2085A-RDB: Freescale Semiconductor 7

7 Release Contents 4.2 Device Support Matrix The following hardware configuration targets are supported: Device Board GPP cores AIOP cores Comments LS2085A LS2085A-RDB 8 (A57) 16 Main personality of the LS2 family. LS2045A LS2085A-RDB 4 (A57) 16 LS2045A variant with reduced number of GPP cores of the above. LS2085A LS2085A-QDS 8 (A57) 16 - LS2045A LS2085A-QDS 4 (A57) 16 - The following simulator configuration targets are supported: Device GPP cores AIOP cores Comments LS2085A 8 (A57) 16 Main personality of the LS2 family. 4.3 Installer and Product Layout CodeWarrior for APP is incorporated in CodeWarrior for Networked Applications Suite alongside CodeWarrior for ARMv8 tools, CodeWarrior for ARMv7 tools, and the LS Series simulator. There is a single product installer for the CW4Net suite, users being allowed to select only the desired components. 4.4 Build Tools The product incorporates an embedded, optimizing build system targeted for AIOP packet processor. The build tools include a C99 compliant compiler, linker, and assembler. The build tools are fully integrated with CodeWarrior Eclipse IDE and are also available as commandline tools. 8 Freescale Semiconductor

8 Release Contents AIOP specific enhancement in the build tools are summarized as follows: - Complete support for AIOP-specific instructions via dedicated intrinsics (built-in functions). - Supports entry point qualifiers (an AIOP task starts at an entry point) - Supports task specific variables (similar to thread local variables) - Static stack usage analysis report (to optimize available workspace) - Supports gcov format code coverage data generation - Standard C99 and runtime library support This release includes build 306 of Freescale AIOP build tools. There are important changes in debug information relative to AIOP build tools included in previous public release (build 302) and also other bug fixes. 4.5 Documentation Product documentation is available in several formats: - Integrated with the help system of the Eclipse IDE - In the product layout in PDF format (CW_APP/LS/Help/PDF/) - Off-line download from Compass Extranet - Freescale Infocenter Getting Started Guide Use these document to quickly get started with setting up boards, creating & debugging projects, collecting the trace data, or installing a service pack. CodeWarrior for AP Getting Started Guide Explains how to install the CodeWarrior software and then create, build, and debug a simple project for an LS2 hardware target. CodeWarrior APP Simulator Getting Started Guide Explains how to install the CodeWarrior software, run the simulator supported by the current release, and then create, build, and debug a simple project. Quick Start for CW for APP Explains how to install CodeWarrior Development Studio for APP and how to create and debug a simple project. Application Notes AN AIOP SDK Applications Debug Describes how to import and build AIOP SL and AIOP reflector projects with CW, and how to debug them when loaded within the QorIQ LS2085A Linux SDK. AIOP Task Aware Debug Describes AIOP specific features in CodeWarrior debugger and task level debug scenarios: task specific breakpoints, task stepping, and viewing task specific information. Freescale Semiconductor 9

9 Release Contents Application notes are not included in the product build but they are available for download form CodeWarrior for Advanced Packet Processing product support page. User Guides Use these documents to learn how to perform what to perform, solve the most common problems using the FAQs guide, or simply learn more about the built-in features. CodeWarrior APP Targeting Manual Explains how to use the CodeWarrior development tools to develop software that targets the Power Architecture cores; includes examples, definition of target-settings panel options, and a debugging tutorial. CodeWarrior Common Features Guide Describes the CodeWarrior IDE and debugger features that are common across all the CodeWarrior products. LS Series Simulator User Guide Describes the software simulation models released with CodeWarrior Development Studio for APP. CodeWarrior APP Build Tools Reference Explains how to use CodeWarrior tools to build programs. EWL C Reference Documents the CodeWarrior implementation of the C standard library. EWL C++ Reference Documents the CodeWarrior implementation of the C++ standard library. CodeWarrior TAP Users Guide Explains how to set up the CodeWarrior TAP debug probe so it can communicate with the debugger and the target hardware. CodeWarrior for APP - Frequently Asked Questions Provides answers to the most frequently asked questions about the CodeWarrior IDE and the APP tools. Cheat Sheets Use these cheat sheets to complete moderate-to-complex tasks by following instructions that you execute real-time within the CodeWarrior IDE. Select Help > Cheat Sheets in CodeWarrior IDE to see and run one of the available cheat sheets. 10 Freescale Semiconductor

10 4.6 Simulator This release includes simulator version m0146, supporting LS2085A functional model. Release Contents Simulator m0146 integrates a major change relative to f0137_ (included in previous release). ARM cores simulation is now performed using Freescale functional models instead of ARM Fast Model from ARM Ltd., which was used in previous versions of LS Series Simulator. The Freescale ARM core models are functionally compatible to previously used AFM models. Known Issue: The simulator must be started with the following parameter in order to make sure it instantiates LS2085A configuration: -simconfig=ls2085a Example:./start_sim_bare_metal -simconfig=ls2085a 4.7 Debugger The product includes an AIOP baremetal debugger, integrated in CodeWarrior Eclipse IDE. The debugger includes support for all hardware and simulated devices listed in sections 4.2 Device Support. The AIOP debugger uses a CodeWarrior TAP hardware probe for interfacing with the target. Simultaneous connection with CodeWarrior for ARMv8 debugger is possible from the AIOP debugger using a single run control server (CCS) instance and a single JATG hardware probe (CodeWarrior TAP). AIOP debugger is designed to be used in two the following scenarios: - Attach to AIOP applications included in Freescale LS2085A Linux SDK - Download and debug of standalone AIOP applications (available in CodeWarrior examples) The following AIOP specific features are included in CodeWarrior debugger: - Dynamic list of tasks running on the AIOP core complex - Visibility of task specific information: ID, core, entry point name, scheduling state, OSM details, etc. - Visibility of debug context of background tasks in Debug views: Stack, local variables, core registers, workspace memory, etc. - Per-task breakpoint functionality - Per-task run control commands: step and resume 4.8 Software Analysis New Features Freescale Semiconductor 11

11 Release Contents The release includes the first version of the statistical profiler for AIOP. Instead of program trace, the statistical profiler is based on PC (program counter) and task state samples collected during the execution of the application to profile. The profiler generates a statistical view of this data, offering multiple perspectives of the profiled data: - Distribution of tasks running time per function - Distribution of accelerator running time per accelerator - Distribution of tasks running time and accelerator running time - Distribution of running, waiting, and idle time All perspectives are able to show the source location of the accelerator call instructions executed during the execution. The profiler is able to collect samples using the JTAG debug connection and using a Linux debug agent. The Linux debug agent has superior performance (more than 100 times higher sample rate compared to JTAG version). It is able to run continuously, does not have any constraints related to execution time or required space. New GCov code coverage capability that permits removing individual lines or entire code regions from the GCov reports. It uses by default the LCOV comment tags to mark the code. The supported tags are LCOV_EXCL_LINE, LCOV_EXCL_START and LCOV_EXCL_STOP. The support can be enabled or disabled from CodeWarrior Preferences on the Software Analysis page. Included code profilers based on program trace for AIOP. The profilers can be used by selecting Performance or Code Coverage views for collected trace. There is an architecturally accepted shortcoming for AIOP that doesn t allow all hardware trace events to be collected by the debug tool (due to limited bandwidth). This limitation is further propagated in code profilers based on program trace. The mitigation is to use only one or two AIOP cores. Added "Upload trace" functionality to overcome limitation of collecting trace only on "Terminate" (user can upload multiple times on simulator and only once on hardware) Display accelerator name instead of its code in Trace Viewer Trace This release incorporates the tools for extracting the hardware trace for the devices listed in sections 4.2 Device Support. The feature is integrated in CodeWarrior IDE and is also available from command line. There is also the possibility to generate and collect trace for the simulated devices. Program trace collected from hardware and simulated targets can be visualized in IDE with the following viewers: 12 Freescale Semiconductor

12 Release Contents - Trace viewer - shows all program events that are found and recognized in the compressed data that was previously collected. - Timeline shows the evolution of the execution in time. - CodeCoverage - shows code coverage data in two views: top view displays functions summary, and bottom view displays which source line and assembly instruction was executed or not for the selected function. - Performance - shows a hierarchical profiler with invocation information and execution times for each function (with and without children). It does not support task awareness. - Call Tree - shows all execution paths of the application, highlighting critical execution path (longest call chain) and (simulator only) deepest execution stack. It does not support task awareness AIOP Analysis Tool AIOP Analysis Tool represents a set of advanced AIOP specific functionalities installable on top of CodeWarrior release. The feature set is summarized as follows: Present data in a number of useful views o APP element & resource utilization views over time o Task timeline o Contention time by resource o Task & resource utilization correlation view o Export to CSV for spreadsheet analysis Easy to configure and use o Operates like a real-time experience with on-chip hardware buffers o Option to use offline trace streams o Retrieve data using JTAG & CodeWarrior TAP Additional features: o Zoom in on time spans o Markers & measurements o Filter, sort, & find o Export to CSV for spreadsheet analysis AIOP Analysis Tool is not available in CodeWarrior by default, it has to be manually installed into the product using the Install New Software functionality (Help->Install New Software -> FSL APP Eclipse Update Site-> AIOP Analysis Tool) Profiling on Simulator Point to Point Profiler This release incorporates the point to point profiler for simulator (p2pprof) which allows the user to define start and end points in code (referred as regions) between which performance data is extracted and presented in reports. Freescale Semiconductor 13

13 Release Contents For improved performance, point to point profiler is capable to run integrated in LS simulator, allowing the profiler to generate statistics reports without storing the trace file. Performance data consists of counter values of various resources. In this version the following counters are presented in the reports: - Number of executed instructions - Number of memory accesses and memory read bytes - Number of calls to the following: TMAN, MFLU, AAP, CTLU, CDMA, FDMA - Estimated count of core cycles spent The following types of reports are available for presenting the performance data: Report Type Region summary Region instances Task instances Task accelerators Description Gathers data across cores/tasks and can be viewed as a summary of the regions instance report with averages calculated and results summed up. Presents the data collected for each region, instance by instance. A region can be hit multiple times, from multiple cores/tasks, during a single execution. This report presents each of this runs individually Similar to the Region instances report. However, the collected data is for an entire task and not for a region. The columns generated by the report are similar to the ones generated in the Region instances report Displays the number of times each accelerator produced a task switch for each task The feature is integrated in CodeWarrior IDE and is also available from command line. Details are presented in CodeWarrior_APP_Targeting_Manual. There is a new CodeWarrior example which defines several code regions and has the settings ready to generate the above reports: CW_APP/LS/CodeWarrior_Examples/P2PProf_Examples Gcov Code Coverage Gcov source code coverage analysis is available for profiling AIOP code running of the LS simulator. CodeWarrior integrates the open source Gcov project (Eclipse Linux Tools), users being able to experience the functionality inside CodeWarrior IDE. Command line based translator from tarmac (ISS trace format) to.gcda is also available. Example project for Gcov is available at: CW_APP\LS\CodeWarrior_Examples\GCov_Examples For the Beta 1 release a new feature has been added that permits removing individual lines or entire code regions from the GCov reports. It uses by default the LCOV comment tags to mark the code. The 14 Freescale Semiconductor

14 Fixed Issues supported tags are LCOV_EXCL_LINE, LCOV_EXCL_START and LCOV_EXCL_STOP. The support can be enabled or disabled from CodeWarrior Preferences on the Software Analysis page. 4.9 New Project Wizard The New Project Wizard allows generation of sample C projects for all hardware and simulated devices listed in sections 4.2 Device Support. In wizard pages the user is able to configure and enable build, debug, and software analysis settings Product Examples CodeWarrior for Advanced Packet Processing integrates the following example projects. For every example, the table below indicates the features that are suitable to be exercised. The examples are all available for import from the following layout location: CW_APP\LS\CodeWarrior_Examples\ Project Name Features Comments Ordering scope management example AIOP_OSM_example Build, debug, task aware debug, task specific breakpoints, per-task stepping, hardware trace, point to point profiler, and code coverage. Simulator and hardware targets Point to point profiler example AIOP_P2PProf_exampl e-aiop Build, debug, and point to point profiler. Simulator target GCov Example AIOP_GCov_Coverage _example-aiop Build, debug, and code coverage. Simulator target 5. Fixed Issues The following defects present in previous product errata have been addressed by this release (relative to previous v release). Freescale Semiconductor 15

15 Fixed Issues Please consult the latest version of this document for the accurate list of fixed issues, available on CodeWarrior for Advanced Packet Processing product support page. DTDBGPG-192 DTDBGPG-126 DTDBGPG-64 DTDBGPG-379 DTDBGPG-66 DTDBGPG-67 DTDBGPG-12 DTDBGPG-275 DTDBGPG-468 Debugger/CCS LS1088A initialization script overwrites preloaded instructions [License] Can not debug project because "Debugger license error" [Sim]Accel Id column not updated with current executing accelerator For LS2040 all memory operations through SCS are performed using incorrect chain when target is configured as LS2080A AIOP Real Example - can not step into fdma_terminate_task Stepping over accellerator calls gets stuck sometimes aiop::taskinfo command does not work for taskentrypoint and taskosm properties "Reset" shows error when not on first task Cannot debug AIOP Reflector in a reliable way Build Tools ENGR ENGR ENGR Peephole forward reuses a value that may have been modified by an instruction with SideEffects attribute Local variable addres information should be accessed via the DW_AT_frame_base information, rather than the stack pointer Watchpoint addresses should be determined from the DW_AT_frame_base information, rather than the stack pointer IDE NTR Software Analysis DTSA-335 [SA][APP] No code correlation for accelerator calls for cores other than core 0 DTSA-781 Upload Trace button not getting enabled for simulator targets DTSA-738 [LS2045A] There is an error message when opening debug configuration DTSA-466 The line that be commented by the exclude options is traced normally DTSA-336 [SA][APP] sampling trace data is not processed on terminate DTSA-367 Trace and profile do not enable on Simulator project DTSA-102 The covered code line showing uncovered in the coverage report DTSA-7 Timeline generated for trace that contains timestamps displays incorrect data for the first function DTSA-6 [Timeline] Time interval after one task is finished is appended into the last function from that task DTSA-262 [10.1.1] [SA] when collect tracedata, it takes too much time. DTSA-336 [SA]sampling trace data is not processed on terminate DTSA-358 [Timeline] No data for core 1 when drag one of the source tabs to a valid area DTSA-368 Cannot decode CodeCoverage on AIOP Reflector SDK Project DTSA-712 "Enable code coverage" in debug configuration is not checked when creating 16 Freescale Semiconductor

16 Known Issues DTSA-738 project with check "Enable coverage support" option. [LS2045A] There is an error message when opening debug configuration 6. Known Issues Please consult the latest version of this document for the accurate list of known issues, available on CodeWarrior for Advanced Packet Processing product support page. The following defects are known to be present in this release. Wherever applicable, the workaround is listed below defect description. DTDBGPG-474 CMPAIOPCW-39 DTDBGPG-61 ENGR DTDBGPG-279 Debugger/CCS [AIOP] Multicore resume/suspend operations not doing anything when task awareness is disabled Workaround: Enable task awareness Local variables from functions in user-defined sections cannot be viewed due to faulty debug information Workaround: Use as single default section per compilation unit (C file) [AIOP] Cannot step over e_dni & se_dni instructions Workaround: Use breakpoints or run to line [AIOP] Scan timeout generated when resuming in a while (1) { i++; } loop. Limitation in the design: TKT Workaround: Use loops with at least 5 instructions: while (1) { i=1; i++; } [APP 10.1][AIOP][Debug View] The stop reason showed in thread label for a stopped thread is not always correct Workaround: None ENGR Build Tools More case statements in a switch case is causing performance degradation in AIOP code Workaround: None ENGR IDE Eclipse closes unexpectedly when closing Welcome view Freescale Semiconductor 17

17 Known Issues Workaround: 1. Uninstall kb security update. 2. Change default browser (e.g. Firefox): Window -> Preferences -> General -> Web Browser -> "Use external Web Browser" -> Firefox DTSA-374 Software Analysis [APP] Once enabled "Enable Trace and Profile" cannot disable back if Profiling on Simulator Trace is enabled Workaround: Disable Profiling on simulator trace NTR NTR Simulator Documentation 18 Freescale Semiconductor

18

19 How to Reach Us: Home Page: Web Support: Information in this document is provided solely to enable system and software implementers to use Freescale Semiconductor products. There are no express or implied copyright licenses granted hereunder to design or fabricate any integrated circuits or integrated circuits based on the information in this document. Freescale Semiconductor reserves the right to make changes without further notice to any products herein. Freescale Semiconductor makes no warranty, representation or guarantee regarding the suitability of its products for any particular purpose, nor does Freescale Semiconductor 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 Semiconductor 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 Semiconductor does not convey any license under its patent rights nor the rights of others. Freescale Semiconductor products are not designed, intended, or authorized for use as components in systems intended for surgical implant into the body, or other applications intended to support or sustain life, or for any other application in which the failure of the Freescale Semiconductor product could create a situation where personal injury or death may occur. Should Buyer purchase or use Freescale Semiconductor products for any such unintended or unauthorized application, Buyer shall indemnify and hold Freescale Semiconductor and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages, and expenses, and reasonable attorney fees arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even if such claim alleges that Freescale Semiconductor was negligent regarding the design or manufacture of the part. Freescale, the Freescale logo, CodeWarrior and ColdFire are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. Flexis and Processor Expert are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners 2016 Freescale Semiconductor, Inc. All rights reserved.