USBSPYDER08UM USBSPYDER08 User`s Manual
Contents
1. 1 4 Hardware Overview The USBSPYDER0O8 Discovery Kit features 1 A built in USB to BDM circuitry based on Freescale MC68HC908JB16 microcontroller which allows the host PC to communicate with the target microcontroller through a standard USB interface 2 AMC9RSO8KA MC9S08QD or MC9S08QG target microcontroller in 8 pin DIP package already programmed with a demo application 3 A provision for a header connector with all of the microcontroller signals 4 ABDMconnector for debugging external devices USBSPYDER0O8 User s Manual The following figure shows the various USBSPYDERO8 connectors On Board Target Device USB Connector User LED BDM Connector for External Debugging USBSPYDER08 Connectors 1 4 1 USB Connector The USB connector is used to connect USBSPYDER0O8 to the host PC USBSPYDERO8 is powered by the USB bus voltage 1 4 2 BDM Connector USBSPYDEROB8 uses a variation of the standard 6 pin BDM connector defined by Freescale to program and debug external MC9RSO8KA MC9S08QD and MC9S08QG devices in any package Overview 1 2 BKGD GND NC RST VPP NC VDD 5 6 BDM Connector Pin Signal Name Description 1 BKGD Single wire background interface pin 2 GND System ground 3 NC Not connected 4 RST VPP Reset signal to target system or Vpp 5 NC Not connected 6 VDD By default this signal is not used by USBSPYDERO8 If you want to enable this line yo2. Start Continue Single Step etc will continue the execution of the program from the next instruction the Step Over and Step Out commands both in a C and Assembly source code use one hardware breakpoint D Note the Single Step command in a C source code and 19 Debugging 3 3 5 Real Time Memory Update During program execution it is possible to view edit the contents of the Memory window and Data window in real time edit operations are only available for RAM locations For example it is possible to set the periodical refresh of the Memory window contents by choosing Mode gt Periodical from the pop up menu which appears by right clicking on the Memory window 20 USBSPYDER08 User s Manual 4 Troubleshooting 4 1 Common Problems and Solutions This section reports some common problems that may arise during general use Please be aware however that working with a specific target device may cause device specific issues 4 1 1 USB Driver Problems If you connected USBSPYDER O8 to the PC before installing the USBSPYDERO8 utilities the instrument s USB driver may not have been correctly installed on your system Unplugging and replugging the USB cable is of no use since Windows has marked the device as disabled As a consequence the PC cannot communicate with USBSPYDER08 To restore the USB driver provided the USBSPYDER0O8 utilities have been installed per
3. hardware installation CD or on the Windows Update Web site with your permission j our p Can Windows connect to Windows Update to search for software O Yes this time only O Yes now and every time connect a device No not this time Click Next to continue New Hardware Wizard Step 1 Select the No not this time option and click the Next gt button 2 The following dialog box will appear 12 USBSPYDER08 User s Manual 4 Found New Hardware Wizard This wizard helps you install software for USBSPYDERO8 If your hardware came with an installation CD lt gt or floppy disk insert it now What do you want the wizard to do Install the software automatically Recommended Install from a list or specific location Advanced Click Next to continue lt Back Next gt Cancel New Hardware Wizard Step 2 Click the Next gt button Windows will install the driver files to your system At the end of the installation the following dialog box will appear Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for USBSPYDEROS Click Finish to close the wizard New Hardware Wizard Step 4 Click the Finish button to exit from the Found New Hardware Wizard procedure The USBSPYDERO8 USB dri
4. 9 Recommended Reading 10 Quick Start Guide 11 Software Setup 11 2 1 1 Host System Requirements 11 2 1 2 Software Setup 11 PC Connection 12 Moving Your First Steps with CodeWarrior 14 Debugging 17 USBSPYDERO8 Working Principles 17 Working with CodeWarrior 17 3 2 1 Using the Project Wizard to Create Your Application Skeleton 17 3 2 2 Starting your First Debugging Session 18 Notes and Tips 18 3 3 1 Entering Debug Session with CodeWarrior 18 3 3 2 Reading Peripheral Status 19 3 3 3 Breakpoints and Trace 19 3 3 44 Breakpoints and BGND Instruction 19 3 3 5 Real Time Memory Update 20 Contents 4 Troubleshooting 21 4 1 Common Problems and Solutions 21 4 1 1 USB Driver Problems 21 4 1 2 Communication Can t Be Established with USBSPYDER08 21 4 1 3 CodeWarrior Specific Stepping Execution is Slow 22 5 Technical Specifications 23 USBSPYDER08 User s Manual 1 Overview 1 1 What is USBSPYDER08 The USBSPYDER0O8 Discovery Kit is a USB based in circuit debugger specific for Freescale MC9RSO8KA MC9SO08QD and MC9S08QG microcontrollers USBSPYDER0O8 comes with a MC9RSO08QG4 microcontroller mounted on its 8 pin socket Thanks to the built in BDM connector USBSPYDER608 is able to debug external MC9RSO8KA MC9SO08QD and MC9S08QG devices in any package USBSPYDER60O8 takes advantage of the CodeWarrior Development Studio Special Edition which groups an Editor Assembler C Compiler and Debugger and the Freescal
5. HP 99 jer PeriphInit 3837 BEQ L jebs 0x3842 3839 JMP 14405 mov HIGH_6_13 Syn_Table MIN_SYN_TABLE PAGESEL 383C MOV 1 34 ldx MAP_ADDR_6 Syn_Table MIN_SYN_TABLE 383F JMP 14405 3842 MOV 255 34 lt nain_loop Tda i E Resi beq increase 4 te Jak cmp MAX_SYN_TABLE SOB Auto beq decrease a o x TH DEX Ss jmp continue I aw gt s 0 status zc a Pe 13828 spe SFFD Abata d zace e Auto Symb Global nen x 175 unsigned char a i 252 unsigned char inci 125 unsigned char vaRDO001 1 unsigned char VARO0002 1 unsigned char vaR00003 1 unsigned char vaR00004 1 unsigned char anen er aroos 1 unsigned char a Woks vaRooo0s 1 unsigned char Ton EREA Mi sere 0 Bemani oles Verifing FLASH memory 2 Erasing FLASH menory Programming FLASH sales Trimming executing cmd ofTec_R808_postload cmd nike 0080 00 00 00 00 00 00 00 00 an e 1 After load the commands written below will be executed 0088 09 oo oo oo oo oo oo oo Mew BDM communication frequency 3 9591MHz 0090 00 oo oo oo oo oo oo oo done cnd SofTec_RS08_postload 5 Jooss oo oo oo oo oo oo oo oo ooao oo oo oo oo oo oo oo oo Postload command file correctly executed Jonas oo oo oo oo oo oo oo oo m ooso oo oo oo oo oo oo oo oo lt u gt ooBe oo oo oo oo oo oo oo o0 For Help press F1 MCORSOBKAZ Gone emd SoFTee RS08_postload emd A CodeWarrior Debugger 7 From the main menu choose Run gt Start Conti
6. USBSPYDER08 Discovery Kit for Freescale MC9RSO8KA MC9SO08QD and MC9S08QG Microcontrollers User s Manual J D ii Sof Tec ee We want your feedback SofTec Microsystems is always on the look out for new ways to improve its Products and Services For this reason feedback comments suggestions or criticisms however small are always welcome mark is applied on all our products This product as shipped from the factory has been verified to meet with requirements FCC as a CLASS A product This product is designed and intended for use as a development platform for hardware or software in an educational or professional laboratory C In a domestic environment this product may cause radio interference in which case the user may be Our policy at SofTec Microsystems is to comply with all applicable worldwide safety and EMC EMI regulations Our products are certified to comply to the European New Approach Directives and the CE required to take adequate prevention measures Attaching additional wiring to this product or modifying the product operation from the factory default as shipped may effect its performance and cause interference with other apparatus in the immediate vicinity If such interference is detected suitable mitigating measures should be taken SofTec Microsystems E mail general information info softecmicro com E mail marketing department marketing softecmicro com E mail technical support support soft
7. e BDM interface which allows the download and debug of the user application into the target microcontroller s Flash memory Together with CodeWarrior USBSPYDERO8 provides you with everything you need to write compile download in circuit emulate and debug user code Full speed program execution allows you to perform hardware and software testing in real time USBSPYDERO8 offers you the following debugging features Real time code execution and in circuit debugging Working frequency up to 10 MHz Socketed target microcontroller BDM connector for external debugging 3 3 V devices supported Jumperless hardware mode setting USB connection to the PC CodeWarrior IDE the same user interface of all Freescale tools with editor assembler C compiler and debugger Overview 1 2 Package Contents The USBSPYDER08 package includes the following items USBSPYDERO8 in circuit debugging unit _USBSPYDER08 CD ROM with CodeWarrior Development Studio Special Edition Soffec Microsystems Additional Components and documentation 1 3 Supported Devices USBSPYDERO8 supports the following devices MC9RSO8KA family MC9S08QD family MC9S08QG family The on board socket accepts 8 pin devices while the provided BDM connector can be used to work with external devices in any package Before working with an external target device you must remove the target device mounted on the on board socket
8. ecmicro com Web http www softecmicro com Important SofTec Microsystems reserves the right to make improvements to USBSPYDERO8 its documentation and software routines without notice Information in this manual is intended to be accurate and reliable However SofTec Microsystems assumes no responsibility for its use nor for any infringements of rights of third parties which may result from its use SOFTEC MICROSYSTEMS WILL NOT BE LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA PROFITS USE OF PRODUCTS OR INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF ADVISED OF THE POSSIBILITY THEREOF Trademarks SofTec Microsystems and the SofTec Microsystems logo are trademarks of SofTec Microsystems S p A Freescale and the Freescale logo are trademarks of Freescale Semiconductor Inc Microsoft and Windows are trademarks or registered trademarks of Microsoft Corporation PC is a registered trademark of International Business Machines Corporation Other products and company names listed are trademarks or trade names of their respective companies Written by Paolo Xausa USBSPYDER08 User s Manual Contents 1 Overview 5 1 1 1 2 1 3 1 4 1 5 1 6 1 7 2 2 1 2 2 2 3 3 3 1 3 2 3 3 What is USBSPYDER08 5 Package Contents 6 Supported Devices 6 Hardware Overview 6 1 4 1 USB Connector 7 1 4 2 BDM Connector 7 Software Overview 9 1 5 1 CodeWarrior Development Studio Special Edition 9 Getting Device Samples
9. ed to run the CodeWarrior user interface together with USBSPYDER0O8 1 A500 MHz or higher PC compatible system running Windows 98 Windows 2000 or Windows XP 2 256 MB of available system RAM plus 1 GB of available hard disk space 3 A USB port 4 CD ROM drive for installation 2 1 2 Software Setup 2000 or Windows XP you must log in as Administrator amp Note to install the USBSPYDERO8 software on Windows 1 Insert the USBSPYDER08 CD ROM into your computer s CD ROM drive A startup window will automatically appear 11 Quick Start Guide 2 Choose Install CodeWarrior and follow the on screen instructions 3 Choose Install Soffec Microsystems Additional Components and follow the on screen instructions 2 2 PC Connection After installing the software you can now plug USBSPYDER0O8 into a USB port on your PC USBSPYDER0O8 is powered by the USB bus voltage and requires a USB port capable of supplying 200 mA The first time USBSPYDER0O8 is connected to the PC Windows recognizes the instrument and starts the Found New Hardware Wizard procedure asking you to specify the driver to use for the instrument 1 On Windows XP SP2 the following dialog box will appear asking you to search for a suitable driver on the web Found New Hardware Wizard Welcome to the Found New Hardware Wizard Windows will search for current and updated software by looking on your computer on the
10. form the following steps under Windows XP Connect USBSPYDER0O8 to the PC Open the Control Panel Start gt Settings gt Control Panel Open the System options Select the Hardware tab Click the Device Manager button The USBSPYDER08 device will be shown with an exclamation mark next to it Double click on this device 7 Inthe General tab click the Reinstall Driver button Follow the on screen instructions DOV GO IN 4 1 2 Communication Can t Be Established with USBSPYDERO8 1 If you use USBSPYDERO8 to debug an external device make sure that the target board is powered on and the target microcontroller is working Programming and debugging rely on a BDM communication between USBSPYDER0O8 and the target board This means that in order to work 21 USBSPYDER08 User s Manual correctly the target microcontroller must be running In particular make sure that The BDM cable is connected to the target board All of the required BDM signals are correctly tied to the target microcontroller Make sure you are working with the correct hardware model To view change the hardware model in use in CodeWarrior choose Connect from the Soffec HCS08 or SofTec RS08 menu depending on the target device currently selected in the CodeWarrior debugger window 4 1 3 CodeWarrior Specific Stepping Execution is Slow When the Memory window is open s
11. in a 1 KB code size limited demonstration mode To break the 1 KB limit you have two options 1 Contact Freescale to request an unlimited period free license key to increase the code size limit to 16 KB 2 Contact Freescale to request a 30 day limited free license key to run the compiler without limitations This documentation covers the basic setup and operation of CodeWarrior Development Studio but does not cover all of its functions For further information please refer to the CodeWarrior on line help and on line documentation provided 1 6 Getting Device Samples You can obtain free device samples by ordering directly on www freescale com Overview 1 7 Recommended Reading This documentation describes how to use the USBSPYDERO8 Discovery Kit and how to set up basic debugging sessions with CodeWarrior Additional information can be found in the following documents 7 CodeWarrior additional documentation available from the CodeWarrior IDE Freescale datasheets Freescale application notes 10 USBSPYDER08 User s Manual 2 Quick Start Guide 2 1 Software Setup Note before connecting the USBSPYDER08 board to the PC it is recommended that you install all of the required software first see below so that the USBSPYDER08 USB driver will be automatically found by Windows when you connect the board 2 1 1 Host System Requirements The following hardware and software are requir
12. nue The program will be executed in real time and will blink the USBSPYDER08 LED 8 To stop the program execution from the main menu choose Run gt Halt 9 You can now continue to experiment with the CodeWarrior user interface and discover its potentialities step commands breakpoints watch windows etc on your own Please also read carefully the additional documentation provided in the USBSPYDERO08 CD ROM 16 USBSPYDER08 User s Manual 3 Debugging 3 1 USBSPYDER08 Working Principles USBSPYDER6O8 is an in circuit debugger t programs files into the target microcontroller and offers debugging features like real time code execution stepping and breakpoints Its debugging features are achieved thanks to the microcontroller s integrated Background Debug Module BDM also referred to as Background Debug Controller BDC The BDM peripheral communicates with the host PC board through a dedicated single wire line BKGD of the microcontroller The same line is also used during device programming Contrariwise to traditional in circuit emulation where the target application is executed and emulated inside the emulator USBSPYDERO8 uses the very same target microcontroller to carry on in circuit execution This means that all microcontroller s peripherals timers A D converters I O pins etc are not reconstructed or simulated by an external device but are the very same target microcontroller s peripheral
13. ory is automatically erased unsecured programmed with the user application and the trimming value if trimming is available for the selected microcontroller is automatically calculated and programmed in the location suggested by Freescale 18 USBSPYDER08 User s Manual Note When programming the microcontroller with the user application after having unsecured the device CodeWarrior ignores doesn t program the security bits As a result when entering a debug session the device is always unsecured regardless of other user settings 3 3 2 Reading Peripheral Status Care must be taken when reading some peripheral s status data registers since a reading operation may cause the clearing of flags This may happen when the Memory window or the Data window is open since these windows read microcontroller s resources during refresh operations 3 3 3 Breakpoints and Trace CodeWarrior offers a variety of tools for analyzing the program flow breakpoints both simple and complex watchpoints and a trace buffer All these features are implemented by taking advantage of the target microcontrollers debug peripheral 3 3 4 Breakpoints and BGND Instruction The BGND Assembly instruction forces the target microcontroller to enter the Active Background Debug mode stopping program execution CodeWarrior recognizes this event as a breakpoint and updates the contents of registers memory etc Successive commands
14. s Moreover the USBSPYDERO08 debugging approach ensures that the target microcontroller s electrical characteristics pull ups low voltage operations I O thresholds etc are 100 guaranteed 3 2 Working with CodeWarrior 3 2 1 Using the Project Wizard to Create Your Application Skeleton CodeWarrior helps you get started with your own application by including a project wizard specific for USBSPYDERO8 To create a new project with CodeWarrior for the devices supported by USBSPYDER O8 1 From the main menu select File gt New Project 17 Debugging 2 A dialog box will appear Choose your target device and select SofTec HCS08 as connection 3 Follow the remaining Project Wizard steps 3 2 2 Starting your First Debugging Session The first time you enter a debugging session by selecting Project gt Debug from the CodeWarrior s main menu the MCU Configuration dialog box will open asking you to select the debugging hardware connected to the PC Make sure that the hardware code is set to USBSPYDER08 MCU Configuration Eg g Hardware Model Code USBSPYDERO8S x Cancel Freescale Starter Kit Device Device code MCIRSOSKA2 Communication Settings The MCU Configuration Dialog Box 3 3 Notes and Tips 3 3 1 Entering Debug Session with CodeWarrior When entering a debug session the target microcontroller s Flash mem
15. s o 0 a4 L a 0 0 g a Includes 0 o a EE Project Settings y os gt export symbols XDEF _Startup main we export both _Startup and main as symbols Either can be referenced in the linker prm file or from C C later on Include derivative specific definitions INCLUDE derivative inc MAX_VALUE_SYN_TABLE EQU 100 MIN_SYN_TABLE EQU 0 MAX_SYN_TABLE EQU 99 MIN_SYN_TABLE i Variable Data Section MY_ZEROPAGE SECTION SHORT NENE DS B 1 i DS B 1 inc_i DS B 1 3 Const Section MY_TABLE SECTION Syn_Table DC B 1 DC B 1 DC B 1 DC B 1 DC B 1 DC B 1 DC B 2 DC B 2 DC B 2 DCB 3 DC B 3 DC B 4 DC B 5 DC B 5 DC B 6 g DCB 7 gt 6 files o Lie3 amp 6 Col21 gt Z CodeWarrior Editor From the main menu choose Project gt Debug This will compile the source code generate an executable file and download it to USBSPYDERO8 A new debugger environment will open 15 Quick Start Guide True Time Simulator amp Real Time Debugger _E SofTec FREESCALE _DEMOBEVB Spyder Softwares RSOSKA2 Demo SofTec_RSOB ini Joe File View Run SofTec RSOB Component Procedure Window Help leja e ei eleelea e E sour JEg E Assembt x E SofTec FREESCALE _DEMOEVB Spyder Softwares RS08KA2 Demoibin main dbg Line 670 _Startup om ran 3828 JSR 14336 a 382B MOV 225 31 382E IDX 253 3831 IDA 33 3833 BEQ 49 jabs 0x383C 3835 C
16. tep commands may execute slower since the Memory window contents need to be refreshed after every step 22 USBSPYDER0O8 User s Manual 5 Technical Specifications Parameter Value General Operating Voltage 5 V DC provided by the USB bus Power Consumption 200 mA max BDM Section BDM connector VDD out signal pin 6 3 3 V DC 100 mA max BDM connector BKGD out signal pin 1 10 MHz max at 3 3 V DC BDM connector VPP out signal pin 4 12 V DC 10 mA max Electrical Specifications Parameter Value Dimensions 83 x 28 x 20 mm BDM connector type 6 pin 2 54 mm pitch dual row header male Operating temperature 0 C to 50 C Storage temperature 0 C to 70 C Humidity 90 without condensation Physical and Environmental Specifications
17. u must solder the 0 Ohm R2 resistor the provision for the R2 resistor is placed near the BDM connector With the resistor soldered the VDD line will supply a power voltage to the target 3 3 V This is used to power on off the target microcontroller in order to force a background monitor mode entry when the RST pin is not available BDM Connector Signals Note before working with an external target device you must remove the target device mounted on the on board socket USBSPYDER08 User s Manual 1 5 Software Overview 1 5 1 CodeWarrior Development Studio Special Edition USBSPYDERO8 comes with CodeWarrior Development Studio Special Editions for HC S 08 CodeWarrior Development Studio is a powerful and easy to use tool suite designed to increase your software development productivity Its Integrated Development Environment IDE provides unrivaled features such as Processor Expert application design tool full chip simulation Data Visualization and project manager with templates to help you concentrate on the added value of your application The comprehensive highly visual CodeWarrior Development Studio for Freescale Microcontrollers enables you to build and deploy Freescale systems quickly and easily This tool suite provides the capabilities required by every engineer in the development cycle from board bring up to firmware development to final application development Without a license key the product will run
18. ver is now installed on your system 13 Quick Start Guide 2 3 Moving Your First Steps with CodeWarrior 1 Start CodeWarrior Development Studio by selecting it in the Windows Start menu 2 Open the USBSPYDER0O8 back cover in order to expose the socketed microcontroller 3 Read the microcontroller code and from the CodeWarrior main menu choose File gt Open and select the demo mep project for your specific microcontroller Projects are placed Under the Program Files Freescale CodeWarrior for HCO8 V5 1 CodeWarrior Examples HCS08 Evaluation Board Examples USBSPYDER08 directory for HCS08 devices QD QG Under the Program Files Freescale CodeWarrior for HC08 V5 1 CodeWarrior Examples RS08 Evaluation Board Examples USBSPYDER08 directory for RSO8 devices KA 4 Click Open The Project window will open 5 The code of this example is contained in either the main c or main asm file Double click on it to open it 14 USBSPYDER0O8 User s Manual E Freescale CodeWarrior main asm oe Ei Fie Edt view Search Project Processor Expert Device Initialization Window Help 8 x Pes Roo KR RAaWUGhREAe ds blo E of Path E Soffec FREESCALE _DEMOREVB Spyder Softwares RSO8KA2 Demo Sources main asm Ee A D gt Softec Rs08 WHE Sy Fies Link Order Targets s File Code Data i E3 Source
Download Pdf Manuals
Related Search