USER'S GUIDE Version 6.4 New editions of this guide incorporate all material added or changed since the previous edition. Update packages may be used between editions. The manual printing date changes when a new edition is printed. The contents and format of this manual are subject to change without notice. Generated: 10/1/2017, 8:10 PM Rev: cb0043d Part Number: User's Guide for VectorCAST/C++ RSP v.6.4 VectorCAST is a trademark of Vector Software, Inc. © Copyright 2017, Vector Software, Inc. All rights reserved. No part of the material protected by this copyright notice may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying, recording, or by any informational storage and retrieval system, without written permission from the copyright owner. U.S. Government Restricted Rights This computer software and related documentation are provided with Restricted Rights. Use, duplication or disclosure by the Government is subject to restrictions as set forth in the governing Rights in Technical Data and Computer Software clause of DFARS 252.227-7015 (June 1995) and DFARS 227.7202-3(b). Manufacturer is Vector Software, Inc. East Greenwich RI 02818, USA. Vector Software reserves the right to make changes in specifications and other information contained in this document without prior notice. Contact Vector Software to determine whether such changes have been made. Third-Party copyright notices are contained in the file: 3rdPartyLicenses.txt, located in the VectorCAST installation directory. 2 Table of Contents INTRODUCTION 10 About This Manual 11 Introduction 11 Overview 11 VectorCAST/RSP Concepts 11 Harness Architecture 11 RSP Communication Overview 12 RSP Communication Details 13 Execute Commands 14 Flags 18 Execution Methods 21 USING VECTORCAST/RSP 22 Introduction 23 Combining Host- and Target-based Testing 23 CLICAST - Command Line VectorCAST 23 QuickStart 23 Command Format 24 The C/C++ Options 26 The Target Options 29 CLICAST-Only Options 41 TARGET REFERENCE 43 Analog Devices VisualDSP 44 Configuration 44 Target Execution 46 ARM RVDS 48 Configuration 48 Target Execution 48 Target Debug Execution 50 Code Composer Studio 52 Configuration 52 Target Execution with Code Composer Studio 4.0 53 Target Execution with Code Composer Studio 3.3 55 Target Execution with Code Composer Studio 2 57 DSP/BIOS support on Code Composer Studio 3.3 and 4.x 61 Configuration 61 3 DSP/BIOS Configuration 61 Code Composer Studio on ezDSP28335 target board 65 Configuration 65 Target Execution with Code Composer Studio 3.3 67 Target Execution with Debug in Code Composer Studio 3.3 68 Code Composer Studio on DSK 6713 target board 69 Configuration 69 DSP/BIOS Configuration 69 Target Execution with Code Composer Studio 3.3 73 Target Execution with Debug in Code Composer Studio 3.3 74 Code Composer Studio on OMAP 35x EVM target board 75 Configuration 75 DSP/BIOS Configuration 75 Running in a Heterogeneous Multi-core environment with Code Composer Studio 3.3 79 Target Execution with Code Composer Studio 3.3 81 Target Execution with Debug in Code Composer Studio 3.3 82 Code Composer Studio v4.2.4 on TI Stellaris EKT-LM3S9B92 EVB 83 Target Configuration 83 Configuration 83 Target Execution with Code Composer Studio 4.2 85 Target Debug Execution in Code Composer Studio 4.x 87 Code Composer Studio v4.2.4 on TI TMS570LS31xHercules USB Stick 91 Target Configuration 91 Configuration 91 Target Execution with CCS 4.2 on the TMS570LS31x USB Stick 94 Target Debug Execution in Code Composer Studio 4.x 96 CodeWarrior DSP56800E 103 Configuration 103 Target Execution 105 Target Debug Execution 106 CodeWarrior StarCore SC140e 108 Configuration 108 Target Execution 109 Target Debug Execution 109 CodeWarrior for HC12 113 Configuration 113 Banked Memory Model 116 Target Execution 117 Target Debug Execution 118 CodeWarrior for HCS08 119 Configuration 119 Target Simulator Execution 123 Target Simulator Debug Execution 124 CodeWarrior for MPC 5554 126 Configuration 126 4 Target Execution 127 Target Debug Execution 128 CodeWarrior for MPC 8315 129 CodeWarrior USB TAP Installation 129 Configuration 133 Target Execution 134 Target Debug Execution 136 CodeWarrior for MPC5121 138 Configuration 138 Target Execution 139 Target Debug Execution 142 Cosmic 68HC12 and HCS12X 143 Configuration for 68HC12 143 Configuration for HCS12X 145 Target Execution 149 Target Debug Execution 151 Cosmic STM8 152 Configuration for Cosmic STM8 on ZAP Simulator 152 Configuration for Cosmic STM8 on STVD Simulator 153 Target Execution 154 Target Debug Execution 155 EVP for VD3204x 156 Configuration 156 Fujitsu Softune for FFMC Chips 159 Configuration 159 Target Execution 160 Target Debug Execution 160 Fujitsu Softune Simulator 161 Configuration 161 Target Execution 162 Target Debug Execution 162 Green Hills Simulator/Bare Target 163 Configuration 163 Configuration for a Target Board 163 Target Execution 164 Target Execution with Green Hills Multi Debugger 164 Improving Target Execution Speed 165 Green Hills INTEGRITY Simulator 167 Configuration 167 Target Execution 167 Target Execution with Green Hills Multi Debugger 168 Improving Target Execution Speed 168 Green Hills INTEGRITY mpserv 169 Configuration 169 Target Execution 171 5 Target Execution with Green Hills Multi Debugger 171 Improving Target Execution Speed 171 Green Hills INTEGRITY rtserv 172 Configuration 172 Target Execution 174 Target Execution with Green Hills Multi Debugger 175 Improving Target Execution Speed 176 HighTec TriCore-gcc 178 Configuration 178 Target Execution 181 Target Debug Execution 182 IAR Embedded Workbench 3.x MSP430 183 Configuration 183 Target Execution 184 Target Debug Execution 185 IAR Embedded Workbench 6.0MSP430X Large Memory Model 5.x 187 Configuration 187 Target Execution 189 Target Debug Execution 189 IAR Embedded Workbench 4.x ARM 9 192 Configuration 192 Target Execution 194 Target Debug Execution 195 IAR Embedded Workbench 5.x ARM 9 198 Configuration 198 Target Execution 200 Target Debug Execution 201 IAR Embedded Workbench v6.3for Amtel SAM3N 204 Configuration 204 Target Execution 206 Target Debug Execution 207 IAR Embedded Workbench for dsPIC 209 Configuration 209 Target Execution 211 Target Debug Execution 212 IAR Embedded Workbench for PIC24 target 214 Configuration 214 Target Execution 215 Target Debug Execution 217 IAR Embedded Workbench 5.x for Amtel AVR 220 Configuration 220 Target Execution 221 Target Debug Execution 222 Keil 224 6 Configuration for the C166 224 Configuration for the C51 227 Target Execution 229 Target Debug Execution 229 Keil for ARM 231 Configuration 231 Target Execution 232 Target Debug Execution 233 Keil for ARM Cortex M3 235 Configuration 235 Instrumentation Trace Macrocell (ITM) Configuration 236 Integration Notes 238 Target Execution 239 Target Debug Execution 239 Lauterbach TRACE32 242 Configuration 242 Target Execution 244 Target Debug Execution 244 Microchip MPLAB dsPIC (PIC30) and PIC24 246 Configuration 246 Target Execution 247 Target Debug Execution 248 Microchip MPLAB C30for PIC24 on Explorer 16 249 Configuration 249 Target Execution 250 Target Debug Execution 253 NEC V850 254 Configuration 254 Target Execution 257 Target Debug Execution 257 Paradigm for 80186 259 Configuration 259 Target Execution 261 Target Debug Execution 262 Paradigm for SC520 264 Configuration 264 Target Connections and Configuration 264 Target Execution 267 Target Debug Execution 268 QNX Neutrino & QNX Momentics 270 Configuration 270 Target Execution 271 Target Debug Execution 271 Renesas HEW – M16C/R8C 273 Configuring for Renesas HEW – M16C/R8C 273 7 Target Execution 273 Target Debug Execution 282 Troubleshooting 283 Compatibility 283 Renesas HEW SuperH (SH) chips 285 Configuration for Renesas HEW - SH 285 Target Execution 286 Target Debug Execution 288 Troubleshooting 288 Compatibility 290 TASKING 56k C Compiler 291 Configuration 291 Target Execution 291 Target Debug Execution 292 TASKING 563xx C Compiler 293 Configuration 293 Target Execution 293 Target Debug Execution 294 TASKING C166 Classic 296 Configuration 296 Target Execution 297 Target Debug Execution 297 TASKING C166 VX 298 Configuration 298 Target Execution 299 Target Debug Execution 299 TASKING TriCore 300 Configuration 300 Target Execution 301 Target Debug Execution 301 Tasking C166 Classic withTRACE32 Simulator on Linux 302 Configuration 302 Target Execution 302 Target Debug Execution 303 TriMedia 305 Configuration 305 Target Execution 307 Target Debug Execution 307 Wind River Diab/SingleStep Simulator 309 Configuration 309 Target Execution 309 Wind River Diab withTRACE32 Simulator on Linux 312 Configuration 312 Target Execution 313 Target Debug Execution 313 8 Wind River vxWorks 315 Overview 315 Starting vxSim in Tornado 315 Setting up the Command Line Tools for Tornado 316 Starting vxSim in Workbench 316 Setting up the Command Line Tools for Workbench 317 Configuration 318 Target Execution 318 Target Execution with vxWorks 653 319 Example Using vxSim 320 Example Using SBC 323 Troubleshooting a vxWorks Target Connection 326 Improving I/O Performance 331 Debugging with Tornado Crosswind on Windows 333 EXECUTION METHODS 336 EXECUTION VIA A REMOTE SHELL 337 Introduction 337 Execution via a Remote Shell 337 Introduction 337 Setting Up NFS 337 Setting Up Anonymous FTP 338 Setting Up scp 339 Setting Up rsh 339 Setting Up ssh 340 VectorCAST Configuration for Remote Shell Execution 342 Target Execution Using a Remote Shell 345 Target Debug Execution 345 Standard I/O 347 Introduction 347 Configuring