Apex-ICE Universal Emulator Hardware and Software Installation Guide

Apex-ICE Universal Emulator Hardware and Software Installation Guide a

Notice Analog Devices, Inc. reserves the right to make changes to or to discontinue any product or service identified in this publication without notice. Analog Devices assumes no liability for Analog Devices applications assistance, customer product design, customer software performance, or infringement of patents or services described herein. In addition, Analog Devices shall not be held liable for special, collateral, incidental or consequential damages in connection with or arising out of the furnishing, performance, or use of this product. Analog Devices products are not intended for use in life-support applications, devices, or systems. Use of an Analog Devices product in such applications without the written consent of the appropriate Analog Devices officer is prohibited. Users are restricted from copying, modifying, distributing, reverse engineering and reverse assembling or reverse compiling the Apex-ICE operational software (one copy may be made for back-up purposes only). No part of this document may be reproduced in any form without permission. Trademark and Service Mark Notice The Analog Devices logo, SHARC, the SHARC logo, VisualDSP, the VisualDSP logo, and EZ-ICE are registered trademarks; and TigerSHARC, the TigerSHARC logo, White Mountain DSP, VisualDSP++, the VisualDSP++ logo, Apex-ICE, EZ-KIT Lite, Mountain-ICE, Summit-ICE, Trek-ICE, and The DSP Collaborative are trademarks of Analog Devices, Inc. Microsoft and Windows are registered trademarks and Windows NT is a trademark of Microsoft Corporation. Adobe and Acrobat are trademarks of Adobe Systems Incorporated. All other brand and product names are trademarks or service marks of their respective owners. Limited Warranty The Apex-ICE hardware is warranted against defects in materials and workmanship for a period of one year from the date of purchase from Analog Devices or from an authorized dealer. Copyright 2000-2001, Analog Devices, Inc. All rights reserved. Revision 4, January 2001 MANAPEXICE Apex-ICE Universal Emulator Hardware and Software 2

Table of Contents 1. INTRODUCTION... 5 2. REQUIREMENTS... 6 3. 3. INSTALLATION... 7 3.1. CONNECTING THE APEX-ICE TO THE PC... 7 3.1.1. Note: Proper Power-On Sequence... 7 3.1.2. General Operating Instructions... 7 3.2. WINDOWS 98 INSTALLATION... 8 3.3. WINDOWS 2000 INSTALLATION... 12 3.4. CONFIGURING THE APEX-ICE POD... 16 3.5. CONNECTING THE POD TO YOUR TARGET SYSTEM... 18 3.6. REMOVING THE APEX-ICE USB DEVICE FROM WINDOWS 2000... 18 4. APEXCONTROL SOFTWARE... 20 4.1. INSTALL THE APEX-ICE SOFTWARE... 20 4.2. TARGET TYPE SELECTION... 20 4.3. APEX CONNECTION... 21 4.4. APEX-ICE FIRMWARE DOWNLOAD... 22 4.5. APEX REBOOT... 23 4.6. ICETEST UTILITY... 23 4.7. CREATE THE VISUALDSP DEBUGAPP SESSION... 24 5. SUPPORT... 26 5.1. TECHNICAL SUPPORT... 26 5.2. QUALITY ASSURANCE... 26 6. REFERENCES... 27 Apex-ICE Universal Emulator Hardware and Software 3

List of Figures FIGURE 1. ADD NEW HARDWARE WIZARD... 8 FIGURE 2. ADD NEW HARDWARE WIZARD... 9 FIGURE 3. ADD NEW HARDWARE WIZARD... 10 FIGURE 4. ADD NEW HARDWARE WIZARD... 10 FIGURE 5. ADD NEW HARDWARE WIZARD... 11 FIGURE 6. THE DEVICE MANAGER... 11 FIGURE 7. THE APEX-ICE PROPERTIES PAGE... 12 FIGURE 8. FOUND NEW HARDWARE WIZARD... 13 FIGURE 9. FOUND NEW HARDWARE WIZARD... 13 FIGURE 10. FOUND NEW HARDWARE WIZARD... 14 FIGURE 11. FOUND NEW HARDWARE WIZARD... 14 FIGURE 12. THE WINDOWS 2000 DEVICE MANAGER... 15 FIGURE 13. THE APEX-ICE PROPERTIES PAGE... 16 FIGURE 14. JUMPERS... 17 FIGURE 15. TERMINATORS CONNECTED TO THE JTAG SIGNALS... 17 FIGURE 16. APEX CONTROL UTILITY... 20 FIGURE 17. DEVICE CONNECT... 21 FIGURE 19. ICETEST UTILITY... 24 FIGURE 20. NEW SESSION SELECTION... 25 Apex-ICE Universal Emulator Hardware and Software 4

1. Introduction The Analog Devices White Mountain Apex-ICE Universal Serial Bus Emulator system provides state-of-the-art emulation and support for the Analog Devices JTAG Family of DSPs. The key features of the Apex-ICE system are as follows: Plug-n-Play USB product Runs under Windows 98 or Windows 2000 Emulation for the industry standard Analog Devices JTAG family of DSPs Rugged high-speed 3V/5V JTAG emulation for Analog Devices DSPs Multiprocessor support Apex-ICE Universal Emulator Hardware and Software 5

2. Requirements The minimum PC host requirements for the Apex-ICE are as follows: Pentium 166 MHz or better Minimum of 32 megabytes of RAM memory Windows 98 or Windows 2000 operating system One full speed USB port Apex-ICE Universal Emulator Hardware and Software 6

3. 3. Installation 3.1. Connecting the Apex-ICE to the PC For specific instructions on connecting a USB device to your computer consult the documentation that is provided by the manufacturer of your computer. In general you should be able to use the following instructions. Important! The Apex-ICE, Analog Devices JTAG Family of DSPs emulator contains ESD (electrostatic discharge) sensitive devices. Electrostatic charges readily accumulate on the human body and equipment and can discharge without detection. Permanent damage may occur to devices subjected to high-energy discharges. Proper ESD precautions are recommended to avoid performance degradation or loss of functionality. 3.1.1. Note: Proper Power-On Sequence 1. Attach the probe to a un-powered target using the 14-pin header. (Never connect an un- powered Apex-ICE to a powered target board.) 2. Apply power to the Apex-ICE 3. Apply power to the target DSP board. 4. Invoke the debugger software. 3.1.2. General Operating Instructions 1. Connect the power supply to a wall outlet. 2. Connect the other end of the power supply to the 5V connector on the Apex-ICE unit. 3. Connect the Apex-ICE USB connector to a full speed port on your PC. The Apex- ICE can be connected to a powered PC. 4. The Apex-ICE status LED will flash when the Apex-ICE emulator is ready for a connection from either ApexControl or VisualDSP. NOTE: The status LED will flash approximately 20 seconds after power is applied and the USB cable is connected to the PC. Apex-ICE Universal Emulator Hardware and Software 7

3.2. Windows 98 Installation The Apex-ICE requires one full speed USB port. Configuration of the board is performed automatically at boot up or insertion due to plug-n-play hardware support. Prior to using your Apex-ICE for the first time the Windows 98 Driver must first be installed. This is accomplished as follows: 1. Follow section 3.1 on connecting the Apex-ICE to a PC. 2. Insert the CD-ROM labeled Emulator Drivers CD into the CD-ROM drive. If the VisualDSP++ Emulator Tools Installation splash screen is displayed click Exit. 3. The connection of the device to the USB port will activate the Window 98 Add New Hardware Wizard as shown in figure 1. Click Next. Figure 1. Add New Hardware Wizard Apex-ICE Universal Emulator Hardware and Software 8

4. Select Search for the best driver for your device as shown in figure 2. Click Next. Figure 2. Add New Hardware Wizard 5. Insert the CD-ROM labeled Emulator Drivers CD into the CD-ROM drive and click next. Windows 98 will then automatically detect and install the Apex-ICE driver from the disk as shown in figure 3. Click Next. Apex-ICE Universal Emulator Hardware and Software 9

Figure 3. Add New Hardware Wizard 6. The Add New Hardware Wizard will locate the ApexICE.inf file on the CD-ROM as shown in figure 4. Click Next. Figure 4. Add New Hardware Wizard 7. The driver installation is now completed as shown in figure 5. Click finish to exit the wizard. Apex-ICE Universal Emulator Hardware and Software 10

Figure 5. Add New Hardware Wizard Verify proper installation of the Apex-ICE through the Windows 98 Device Manager as follows: 1. Click on the Start button. 2. Select Settings then Control Panel. 3. Double click the System icon. 4. Select the Hardware tab. 5. Select the Device Manager tab. 6. Double click DSP Emulators. A window similar to that shown in figure 6 should be displayed. Figure 6. The Device Manager Apex-ICE Universal Emulator Hardware and Software 11

7. Double click on Apex-ICE USB Emulator. This will display the Apex-ICE Properties page as shown in figure 7. The status of the Apex-ICE will be shown in the window. The device status should report that the device is working properly. Note: Status LED should be blinking. Figure 7. The Apex-ICE Properties Page 3.3. Windows 2000 Installation The Apex-ICE requires one full speed USB port. Configuration of the board is performed automatically at boot up due to plug-n-play hardware support. Prior to using your Apex-ICE for the first time the Windows 2000 Driver must first be installed. This is accomplished as follows: 1. Follow section 3.1 on connecting the Apex-ICE to a PC. 2. Insert the CD-ROM labeled Emulator Drivers CD into the CD-ROM drive. If the VisualDSP++ Emulator Tools Installation splash screen is displayed click Exit. Apex-ICE Universal Emulator Hardware and Software 12

3. The connection of the device to the USB port will activate the Windows 2000 Found New Hardware Wizard as shown in figure 8. Click Next. Figure 8. Found New Hardware Wizard 4. Select Search for a suitable driver for my device as shown in figure 9, click Next. Figure 9. Found New Hardware Wizard Apex-ICE Universal Emulator Hardware and Software 13

5. In the Locate Driver Files dialog box ensure the CD-ROM drivers box is checked and click Next. Figure 10. Found New Hardware Wizard 6. The Add New Hardware Wizard will locate and install the correct driver on the disk. This will complete the driver installation. You will see a window similar to that in figure 11. Click Finish. Figure 11. Found New Hardware Wizard Apex-ICE Universal Emulator Hardware and Software 14

Verify proper installation of the Apex-ICE through the Windows 2000 Device Manager as follows: 1. Click on the Start button. 2. Select Settings then Control Panel. 3. Double click the System icon. 4. Select the Hardware tab. 5. Click the Device Manager button 6. Double click DSP Emulators. A window similar to that shown in figure 12 should be displayed. Figure 12. The Windows 2000 Device Manager 7. Double click Apex-ICE USB Emulator. This will display the Apex-ICE Properties page as shown in figure 13. The status of the Apex-ICE will be shown in the window. The device status should report that the device is working properly. Click Ok and close all windows and remove CD-ROM. Apex-ICE Universal Emulator Hardware and Software 15

Figure 13. The Apex-ICE Properties Page 8. To install the ApexControl software go to Section 4 ApexControl software. 3.4. Configuring the Apex-ICE Pod Note: This section is optional. This procedure is used to reduce noise related issue. The Apex-ICE pod contains two internal jumpers for reducing noise issues associated with JTAG signals. These jumpers are accessible by removing the four screws on the bottom of the plastic enclosure and removing the top of the enclosure. The jumpers are shown in figure 14. Apex-ICE Universal Emulator Hardware and Software 16

Figure 14. Jumpers There are two jumpers provided to help reduce problems that may arise because of ringing and reflections on the JTAG signals on the target board. These jumpers are not installed when shipped from the factory. Jumpers JP1 and JP2 are used for adding a parallel terminator on the TDO and CLKIN signals. When the jumpers are installed a parallel terminator of 120Ω and 91Ω is connected to the TDO and CLKIN signals. Figure 15 shows how the terminators are connected to the JTAG signals. It is important to note that the target MUST be able to drive a 51Ω load before these jumpers are installed. The DSP cannot drive this load directly, a driver should be inserted between the JTAG signals at the DSP and the JTAG signals at the header. Figure 15. Terminators Connected to the JTAG Signals Apex-ICE Universal Emulator Hardware and Software 17

3.5. Connecting the Pod to Your Target System The pod connects to the target processor through the JTAG interface. The target board must be built with an appropriate JTAG connector. Please note the position of the key pin. The key pin should be used as a guide to connect the pod to the target. Included with the Apex-ICE system are two extender connectors. These extenders are used to connect the Apex-ICE system to a target, which was designed for use with the ADI ICEPAC. These extenders allow connection to the JTAG pins on the ICEPAC header. For more information on designing a JTAG interface refer to EE-68. 3.6. Removing the Apex-ICE USB device from Windows 2000 1. From the Windows task bar double-click on the Unplug or Eject Hardware icon. A window similar to that shown in figure 16 should be displayed. Figure 16 Unplug or Eject Hardware Apex-ICE Universal Emulator Hardware and Software 18

Figure 17 Stop a Hardware device 2. Click on Stop. A window similar to that shown in Figure 17 should be displayed. Figure 18 Stop a Hardware device 3. Click on Ok to display the Safe to Remove Hardware dialog box similar to that shown in figure 18. 4. Remove the Apex-ICE USB device from the USB port and click Ok. Apex-ICE Universal Emulator Hardware and Software 19

4. ApexControl Software ApexControl is a utility used to download firmware updates, reboot the Apex-ICE and run the IceTest utility. The following sections describe each of the ApexControl functions. This manual assumes the ApexControl application is used with VisualDSP ++ software. If ApexControl is provided by other third party vendors, the user should refer to the vendor s documentation. 4.1. Install the Apex-ICE Software Refer to the VisualDSP Emulation Tools Installation Guide provided on the Emulator Drivers CD Section 3.1 Installation. 4.2. Target Type Selection Before the VisualDSP software is used with Apex-ICE a target type must be selected. The Apex-ICE installation software will insert the proper target type into the target type pull down list. 1. If the ApexControl software isn t currently running, start it from the Windows start button, Start Programs VisualDSP ApexControl. Figure 19 shows the initial dialog. 2. Click on the Target Type pull down list (see figure 19) and select the appropriate target type. Figure 19. Apex Control Utility Apex-ICE Universal Emulator Hardware and Software 20

The selected target type will be available after Connect and Reboot actions are taken as described in the following sections. 4.3. Apex Connection Before any of the Apex-ICE utilities can be used, a connection to the device must be established. 1. Confirm the Apex-ICE device is turned on and operating properly as described in Chapter 3. Note: The status LED should be blinking and the green power LED illuminated. 2. The Select Apex-ICE Device drop down list should contain at least one configured device. If not, follow the instructions in section 4.1. 3. Select the desired device from the Select Apex-ICE Device drop down list. The red circle to the left of the device selection indicates that the device is currently not connected. 4. Click the Connect button. See figure 19. If the connection is successful then a green circle will appear next to the device selection and the Download, Reboot and IceTest buttons will become active. See figure 20. Note! If an error message appears then the Apex-ICE device is either not configured correctly, not turned on or is malfunctioning. Review all previous sections for correct configuration. Figure 20. Device Connect Apex-ICE Universal Emulator Hardware and Software 21

4.4. Apex-ICE Firmware Download Occasionally Apex-ICE firmware updates may be necessary. Analog Devices or other qualified thirdinitially the Apex-ICE device doesn t have any target specific software loaded. The user must perform a one-time software download to the Apex-ICE device. Review section 4.4 for details on downloading files to the Apex-ICE device. Occasionally software updates may be necessary. Please refer to the Emulator s Readme file located in the /VisualDSP/Help folder for additional information. Note: If no firmware download is needed go to the Section 4.6 IceTest Utility. Important! Only software updates from Analog Devices or qualified third party companies should be downloaded to the Apex-ICE Device. Downloading of other software to the Apex-ICE device may cause the device to stop functioning. 1. Verify the Apex-ICE device is configured and powered on. 2. Use the ApexControl utility to select the desired remote device and target type. See section 4.2. Click the Connect button to establish a connection to the Apex-ICE device. 3. Click the Download button. The File Select dialog will be displayed as in figure 21. 4. Navigate to the Apex-ICE directory (this directory was created by the Trek install utility). For SHARC DSP Processors Select SHARC directory Select and download SHARCSocStubCE.exe Click No to reboot message Repeat step 3 and download WmSharcIceCE.dll Reboot the Apex-ICE For ADSP-219x DSP Processors Select 219x directory Select and download 219xSocStubCE.exe Click No to reboot message Repeat step 3 and download Wm219xIceCE.dll Reboot the Apex-ICE Apex-ICE Universal Emulator Hardware and Software 22

Figure 21. Find File Dialog. 4.5. Apex Reboot The ApexControl utility can be used to reboot the Apex-ICE emulator. 1. Confirm the Apex-ICE device is turned on and operating properly as described in Chapter 3. 2. If the ApexControl software isn t currently running, start it from the Windows Start button, Start Programs VisualDSP ApexControl. Figure 19 shows the initial dialog. 3. Confirm the Apex-ICE device is configured and connected as described in sections 4.2 and 4.3. 4. Click the Reboot Apex button. A confirmation dialog will appear. Click Yes to reboot the Apex device. 5. The Apex status LED will flash when the Apex emulator is ready for a connection from either ApexControl or VisualDSP. NOTE: The status LED will stop flashing when ApexControl or VisualDSP is currently connected to the Apex emulator. 4.6. IceTest Utility The IceTest utility is used to verify and test a target JTAG connection. 1. If the ApexControl software isn t currently running, start it from the Windows Start button, Start Programs VisualDSP ApexControl. 2. Confirm the Apex-ICE device is configured and connected as described in sections 4.2 and 4.3. Apex-ICE Universal Emulator Hardware and Software 23

3. Confirm a target DSP board is connected to the Apex-ICE device. 4. Click the IceTest button. The IceTest dialog will appear as shown in figure 22. 5. Click the Start button to run the IceTest utility. If Continuous scan is selected the IceTest will run until the Stop button is pressed. Figure 22. IceTest Utility 4.7. Create the VisualDSP DebugApp Session This section assumes that the user has installed the VisualDSP application software and is familiar with its use. Important! The Apex-ICE device must be installed before proceeding with this section. 1. Verify the Apex-ICE device is connected and powered on. 2. Run the IceCfg utility located in the VisualDSP/System directory to set up DSP target types. See the VisualDSP Emulation User s Manual for more information. Note: The Base Address entry isn t required for Apex-ICE. 3. Start the VisualDSP DebugApp from the start menu, Start Programs VisualDSP Debugger 4. Select Session from the menu bar. Then choose New Session from the list. 5. Under the Debug Target pull down list select ADSP-21xxx Apex JTAG Emulator. See figure 23. 6. Under Platform choose the desired DSP target type connected to the Apex-ICE device. 7. Click OK. The VisualDSP DebugApp is now ready to use. Apex-ICE Universal Emulator Hardware and Software 24

Figure 23. New Session Selection Apex-ICE Universal Emulator Hardware and Software 25

5. Support 5.1. Technical Support For technical support of the Apex-ICE, you may contact the Analog Devices DSP Tools Technical Support Group in one of the following ways: Fill out the DSP Tools Technical Support web form at: http://www.analog.com/dsp/tools/form_techsupport.html Send a description of the problem by email to dsptools.support@analog.com Call the customer support hotline at 1-800-ANALOG-D (1-800-262-5643 U.S.A. only) For direct support of the Analog Devices DSPs, call the Analog Devices DSP Applications Engineering group at 1-800-ANALOG-D. 5.2. Quality Assurance Analog Devices Inc. is committed to providing quality products and services. In efforts to continually provide this quality, please contact our Quality Assurance Department directly if you have any concerns at (603) 883-2430 Monday-Friday during normal business hours or via e-mail at quality@wmdsp.com. Our Quality Assurance Manager will listen to your concerns and provide a timely and effective solution. Apex-ICE Universal Emulator Hardware and Software 26

6. References This section discusses other documentation resources you will need to develop your application. For information on designing the interface between an Analog Devices SHARC DSP and the emulation header on your custom DSP target board, refer to Analog Devices JTAG Emulation Technical Reference (2.0) EE-68. For information on the architecture and system interface of the ADSP processor, refer to the appropriate Analog Devices JTAG Family of DSPs User s Manual. For ADSP timing specification and other hardware design information, refer to the appropriate Analog Devices JTAG Family of DSPs Data Sheet. For complete information on software development tools (Assembler, Linker, PROM Splitter, Assembly Library, and Simulator), refer to the following documents: ADSP-21000 Family Development Software/ ADSP-21000 Family C Tools Release 3.1 Release Note ADSP-21000 Family Assembler Tools & Simulator Manual ADSP-21000 Family C Runtime Library Manual ADSP-21000 Family C Tools Manual For information about your development platform, refer to your operating system manuals and hardware system manuals. For information about digital signal processing theory and applications, you may which to consult: Higgins. Digital Signal Processing In VLSI. Prentice-Hall, 1990. Oppenheim and Schafer. Digital Signal Processing. Prentice-Hall, 1975. For information on the emulator software, refer to the Software Users Guide. Apex-ICE Universal Emulator Hardware and Software 27

Apex-ICE Universal Emulator Hardware and Software 28