DA_10315-004 | January 26, 2022 Advance Information | Subject to ChangeApplication NoteDOCUMENT CHANGE HISTORYDA_10315-004Version Date Authors Description of Changev1.0 May 24, 2019 sgupta, jsachs Initial release.v2.0 April 2, 2020 sumitg Add details for Arm Development Studio.v3.0 January 29, 2021 sgupta, jsachs Steps updated from latest ARM DS software version and edited for clarity.v4.0 January 26, 2022 dwan, jsachs Public release.TABLE OF CONTENTSArm DS-5/Development Studio Setup (1)System Requirements (1)License Requirements (2)To install DS-5 (2)To install Arm DS (4)To configure DS-5 or Arm DS for Your SoC (9)To prepare the kernel configuration file (10)To set up a Cortex A57 debug connection (10)To set up the BPMP debug connection to the device (12)Arm® DSTREAM high-performance debug and trace enables powerful software debug and optimization of any hardware target based on an ARM processor. Developers can leverage the full debug and trace capabilities of Arm Development Studio on ARM architectures.For more information about Arm DSTREAM, see the product description on the Arm developer website.Up to the present, Arm DSTREAM software developers have used Arm DS-5 (DS-5 for short) for development and debugging purposes. ARM is now starting to migrate from Arm DS-5 to Arm Development Studio (Arm DS for short), an Eclipse plugin, for new development.This document describes both DS-5 and Arm DS.For more information about migrating to Arm Development Studio, see DS-5 to Arm Development Studio Migration Guide.This document covers both DS-5 and Arm DS.Installation and configuration are similar for the two products. Usage isthe same, so CPU preparation and setup are the same.For simplicity, this document has separate chapters on installation forDS-5 and Arm DS. A single chapter covers configuration for both. System RequirementsFor information about system requirements and dependencies, see the following pages: ④For DS-5: ARM DS-5 Getting Started Guide: System requirements④For Arm DS: Arm Development Studio Getting Started Guide Version 2020.1.License RequirementsARM licenses are ordinarily obtained by purchase from ARM.To use DS-5 you must have an ARMv8 license. For more information, see the Support section of the Arm developer website.Arm DS is available in several editions with different features and different licensing terms. Visit Compare Editions: Which edition is right for me? to see which edition is right for you and to apply for a license.The instructions in this document have been validated with Arm DSPlatinum Edition, the edition with the broadest range of features.To install DS-51.Download the current version of DS-5 from the Arm website:https:///tools-and-software/embedded/legacy-tools/ds-5-development-studio/downloads2.Enter this command to install DS-5:setup.exe3.Start Eclipse. For example, you might enter this command:<installpath>DS-5 v5.29.2\bin\eclipse.exeWhere <installpath> is the pathname of the directory where DS-5 was installed.4.Run Debug Hardware Update to update the firmware for DSTREAM, if necessary.From the menu bar, select Window; Show View; Other. (“Other” is at the end of the Show View menu, out of alphabetic order.) Eclipse opens the Show View dialog.Select Debug Hardware Firmware Installer, then click OK.Note: The firmware changes with each new version of DS-5. The DS-5software installed in a location that incorporates the release numberinto the pathname, for example:<installdir>\DS-5 v5.29.2\sw\debughw\firmware\ARM-RVI-4.34.0-13-base.dstream5.Run Arm License Manager to install the license.From the menu bar, select Help; Arm License Manager. The installer opens a View and edit licenses dialog.6.In the dialog’s Select the toolkit that you intend to use menu, select “DS-5 UltimateEdition.” Click Add License and enter the key for your ARMv8 license. Then click Close to close the dialog.7.Restart Eclipse and DS-5 by entering the pathname (if necessary) and program namein a terminal window, for example:<installpath>DS-5 v5.29.2\bin\eclipse.exeTo install Arm DS1.Download the Development Studio software from the Arm website and start theinstaller.2.Start the installer and select Platinum or Gold Edition. The Arm DS installer displaysthe Custom Setup dialog.3.Click Next. The installer displays the “Welcome” wizard page.4.Install drivers if the installer prompts you to do so.5.The installer displays a list of products you can install. Select the Arm DS IDE.6.The installer installs Arm DS, and the Eclipse IDE, if necessary. (Arm DS isimplemented as an Eclipse plugin.) If the installer automatically starts Arm License Manager and prompts you to enter license details, skip to step 7. If not, launch ArmLicense Manager manually. From the menu bar, select Help > Arm License Manager. The installer opens Arm License manager’s View and Edit Licenses dialog.7.Enter the license details and click Next. The installer installs DS-5.8.After installation, the DS-5 software opens automatically and checks the Arm website for updates. If updates are available, it displays the following dialog as it applies them.9.When updates (if any) are complete, you must determine the DSTREAM IP address.1.Return to the installer’s main menu.2.Select the Debug Hardware Configure IP view.3.Select Window > Show View > Debug Hardware Configure IP. The installerdisplays the Debug Hardware Configure IP dialog.4.Click Browse. The software detects the DSTREAM IP address and displays it. 10.Return to the main menu and select Windows > Show View. Eclipse opens the ShowView dialog.11.Select Debug Hardware Firmware Installer. The installer opens the Debug HardwareFirmware Installer dialog and detects the IP address and the required firmwareversion. (The default firmware version is included in the DS software, and is present at the installation location.)12.Restart the Eclipse IDE and DS software to use it for development and debugging. To configure DS-5 or Arm DS for Your SoC④For DS-5 on a T186 processor (NVIDIA® Jetson™ TX2 series):The T186.tar archive is required for using DS-5. It is is not required for using Arm Development Studio. Contact your NVIDIA support contact to obtain this file if you need to use DS-5.1.The T186.tar archive contains scripts and configuration files for the SoC. Copyit to:<installdir>\<version>\sw\debugger\configdb\Boards\nVIDIA\t186Where:―<installdir> is the directory in which the SoC scripts are to be installed.If you only will use Arm Development Studio, you may skip this step.2.Rebuild the database.From the menu bar, select Window > Preferences > DS-5 > ConfigurationDatabase. Then click the Rebuild database button.④For a T194 processor (NVIDIA® Jetson AGX Xavier™ series):No script is required. The installer detects the configuration automatically.Use the Platform Configuration Editor (PCE) view to create a platform configuration with the option “Automatic/simple platform detection” or “ConfigurationDatabase.” Instructions for using PCE are at Arm DS-5 Debugger User Guide:Creating a platform configuration.The PCE view enables you to create or modify debug configurations for connecting to your platform. You can specify your system’s debug topology by defining the connections between the various processors, CoreSight components, and the debug IP address of the platform.If you are using a T194 processor (Jetson AGX Xavier series), note the platformconfiguration name shown in the PCE view. You will need it later in the installation process.To prepare the kernel configuration fileEnsure that these kernel configuration macros are commented out in the kernel configuration file to disable CPU IDLE:CONFIG_CPU_IDLECONFIG_ARM_CPUIDLEAlternatively, you can disable CPU IDLE through a device tree node:cpuidle {status = "disabled";};To set up a Cortex A57 debug connection1.Set up the Arm® Cortex® A57 debug configuration required for connection to thedevice.From the menu bar, select Run > Debug Configuration. The installer opens theConfigure, manage, and run installations dialog, which displays a list ofconfiguration types and configurations.2.Double click the configuration type DS-5 Debugger. The installer prompts you toenter a new configuration name. Enter an appropriate name, such asT186_A57_SMP, then click the Connection button.3.The dialog displays a collapsible tree of targets and subtypes. Select the target to bedebugged.●For a T186 processor (Jetson TX2 series), select nVIDIA > T186 > Bare MetalDebug > Cortex-A57x6 SMP.●For a T194 processor (Jetson Xavier NX and Jetson AGX Xavier series), selectT194 > platform name > Bare Metal Debug > V8_2-Genericx8 Multi-Cluster SMP, where platform name is the platform name shown in the PCE view.4.Click the Base Metal Debug… Browse button. The installer opens a ConnectionBrowser dialog which lists connections available to this target. Select the connection you want to use, then click Select. The installer closes the Connection Browserdialog.The installer automatically configures the DSTREAM IP address or USB ID,depending on the connection method and the type of cable that connects the Jetson device to the host.For T194 devices (Jetson Xavier NX and Jetson AGX Xavier series),the next step is optional.5.Click the Debugger tab:6.Under Run Control, select Connect only.7.Click Apply, then Debug.To set up the BPMP debug connection to the device1.Select the Debug view.From the menu bar, select Window > Open Perspective > Other > DS-5 Debug. 2.Set up the BPMP debug configuration required for connection to the device.From the menu bar, select Run > Debug Configuration. The installer opens theConfigure, manage, and run installations dialog as shown in the section To set up a Cortex A57 debug connection. This dialog displays a list of configuration types and configurations.3.Double click the configuration type DS-5 Debugger. The installer prompts you toenter a new configuration name. Enter an appropriate name, such as t186_bpmp.Then click the Connection button.4.The dialog displays a collapsible tree of targets and subtypes. Select the target to bedebugged by selecting nVIDIA > T186 > Bare Metal Debug > Debug Cortex-R5_0. 5.Click the Base Metal Debug… Browse button. The installer opens a ConnectionBrowser dialog, which lists connections available to this target. Select the connection you want to use, then click Select. The installer closes the Connection Browserdialog.The installer automatically configures the DSTREAM IP address or USB ID,depending on the connection method and the type of cable that connects the Jetson device to the host.6.Click the Debugger tab. The installer displays that tab, shown in To set up a CortexA57 debug connection, above.7.Under Run Control, select Connect only.8.Check the check box Execute debugger commands to disable auto memory verify.9.Copy this line into the Execute debugger commands box:memory 0 0xffffffff rw nocache noverify10.Click Apply.NoticeALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OR CONDITION OF TITLE, MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE MAXIMUM EXTENT PERMITTED BY LAW. Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the consequences of use of such information or for any infringement of patents or other rights of third parties that may result from its use. No license is granted by implication or otherwise under any patent or patent rights of NVIDIA Corporation. Specifications mentioned in this publication are subject to change without notice. This publication supersedes and replaces all information previously supplied. NVIDIA Corporation products are not authorized for use as critical components in life support devices or systems without express written approval of NVIDIA Corporation.TrademarksNVIDIA, the NVIDIA logo, Jetson, Jetson Xavier, and Jetson AGX Xavier are trademarks or registered trademarks of NVIDIA Corporation in the United States and other countries.ARM or Arm and Cortex are registered trademarks of ARM Limited.Other company and product names may be trademarks of the respective companies with which they are associated.Copyright© 2019-2022 NVIDIA CORPORATION and AFFILIATES. All rights reserved.。
