inDART-HCS08 User`s Manual
Contents
1. JEJEJE m 5 JEJEJEJE 3 JE 3 JE JE Copyright 2003 SofTec Microsystens http www softecmicro com eer JEJEJE JEJEJE JEJEJE JEJE 2 ADC Sample for SofTec Microsystems IDB HCS08GB Demo Board By rotating the potentiometer channel 0 you affect the results of the D conversion and the value of each conversion is displayed on the LEDs on PTF 7 0 By pressing the PTCS push button the DIP switches status on PT 7 0 is diplayed on the LEDs on PTF 7 0 Make sure that all of the LED ENABLE jumpers the SV ENABLE jumpers the POTENTIOMETER ENABLE jumper an2. InDART HCSo8 In Circuit Debugger Programmer for Motorola HCSo8 Family FLASH Devices User s Manual Chien 03 SofTec Mier osystems DCoo634 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 SofTec Microsystems E mail general information info softecmicro com E mail marketing department marketing softecmicro com E mail technical support support softecmicro com Web http www softecmicro com Important SofTec Microsystems reserves the right to make improvements to the inDART Series In Circuit Debuggers their 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 inDART is a trademark of SofTec Microsystems Motorola and DigitalDNA are trademarks or registered trademarks of Motorola Inc Metrowerks and CodeWarrior are trademarks or registered trademarks of Metrowerks Corp Microsoft and Windows are trademarks or regi
3. FF FF ecm 1190 FF FF FF FF FF FF FF FF FF FF ianh 1140 FF FF FF FF FF FF FF FF FF FF 11B0 FF FF FF FF FF FF FF FF FF FF dE 11 0 FF FF FF FF FF FF FF FF FF FF Not Available 11D0 FF FF FF FF FF FF FF FF FF 11 0 FF FF FF FF FF FF FF FF FF FH Option Bytes 11FD FF FF FF FF FF FF FF FF FF FH d 1200 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF Not Available 1210 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1220 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1230 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1240 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1250 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1260 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1270 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1280 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1290 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1240 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 1280 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF e Ready Motorola MC9S08GB60 inDART HCS08 HCS08 FLASH MCUs FLASH 60KB The DataBlaze User Interface DataBlaze Notes The Mass Erase operation always blanks the device even if the device is protected or secured and unsecures the device the NVOPT FLASH register is programmed with oxFE Blank Check operation doesn t blank check the FLASH register The Program operation automatically verifies
4. User s Manual b Power the board via the REG VDD connector The REG VDD connector accepts a voltage up to the microcontroller s operating voltage 3 3 V DC in the case of the MCoSO8GB60 When powering the board through this connector make sure the VDD SOURCE jumper selects the REG position The REG VDD voltage directly powers the microcontroller and the rest of the board The REG VDD connector has been designed to be used together with inDART HCS08 s VDD OUT connector the VDD OUT cable can be conveniently inserted into the VDD OUT connector on the inDART HCSo8 board and into the REG VDD connector on the demo board This way inDART HCSo8 powers the demo board Please refer to the following figure to get an overview of the inDART HCSo8 unit inDART HC 508 mium SofTec MICROSYSTEMS www softecmicro com 1 USB Connector 2 BDM Connector 3 VDD OUT Connector The inDART HCSO08 Unit Page 13 2 Getting Started Note both Windows 2000 and Windows XP may issue a warning the first time inDART HCS0O8 is connected to the PC This warning is related to the fact that the USB driver used by inDART HCSO6 is not digitally signed by Microsoft and Windows considers it to be potentially malfunctioning or dangerous for the system However you can safely ignore the warning since every kind of compatibility security test has been carried out by Sof
5. the programmed data by reading back the programmed data and checking it against the buffer sent to the target device The Verify operation is much more secure but slower since it reads back the programmed data and checks it against the data buffer present in the host PC Page 25 3 inDART HCS08 Operations Incase of programming error please verify that the NVOPT FLASH register is programmed with a value different from oxFF Read Program and Verify operations are performed when possible by setting the target microcontroller s FLL peripheral so that the maximum BDC communication speed is achieved Onalldevices which support the trimming calibration the FLASH location suggested by Motorola where to store the trimming value is reserved by DataBlaze DataBlaze automatically calculates the trimming value and writes it to that location Page 26 inDART HCSO08 User s Manual 4 Troubleshooting Common Problems and Solutions This section reports some common problems that may arise during general use However working with a specific target device may cause device specific issues Communication Can t Be Established with inDART HCS08 1 Make sure the inDART HCSOS in circuit debugger is connected to the PC and powered on inDART HCS08 is powered by the USB connection Make sure you are working with the correct inDART hardware model To view change the inDART hardware model
6. working with and the inDART HCSo8 board as emulator Page 19 3 inDART HCS08 Operations MCU Configuration The first time you start the debugging of your application with the command Project Debug the MCU Configuration dialog box will appear allowing you to select the hardware model and the target microcontroller you are working with MCU Configuration Hardware Model HW code inpART HCS08 2 Device Device code MC9S08GB60 i Communication Settings The MCU Configuration Dialog Box First ensure that the Hardware Model parameter is set to inDART HCSo8 Then set the Device Code parameter to the specific target microcontroller you are working with Additional communication parameters can be specified by clicking the Communication Settings button Communication Settings The BDC communication speed depends on a clock source which in turn is selected by the CLKSW bit in the Status register If the CLKSW bit is set to 1 the BDC communication clock source is the microcontroller s bus frequency if the CLKSW bit is set to o the BDC communication clock source is a constant clock source which can vary depending on the specific 08 derivative In the case of the MC9So8GB60 for example this constant clock source is a 8 MHz internal clock Other derivatives may use the external crystal frequency Which CLKSW setting to use depends on the target s
7. 000 or Windows XP you must have logged in as Administrator Installing the Hardware The inDART HCSOS in circuit debugger is connected through USB port to a host PC Connection steps are listed below in the recommended flow order 1 Install all the required system software as described in the previous section 2 Insert one end of the USB cable into a free USB port 3 Insert the other end of the USB cable into the USB connector on the inDART HCSO8 board The green POWER LED on the instrument should turn on Windows will automatically recognize the instrument and will load the appropriate USB driver 4 Insert one end of the BDM cable into the 6 way connector on the inDART HCSO8 board 5 Insertthe other end of the BDM cable into the BDM connector of the demo board or target application 6 Powerthe demo board or target application When using a SofTec Microsystems demo board there are two power options a Power the board via the UNREG VDD connector The UNREG VDD connector accepts 9 12 V DC 200 mA wall plug in power supply with a 2 1 mm pin and sleeve plug with positive in the center and sleeve as ground When powering the board through this connector make sure the VDD SOURCE jumper selects the UNREG position The UNREG VDD voltage is internally regulated to the microcontroller s operating voltage 3 0 V DC in the case of the MC9So8GBo00 Page 12 inDART HCS08
8. Reset Communication Lost During Debugging Diagnostic Test Getting Technical Support Appendix A Electrical and Physical Specifications 27 27 28 28 28 28 29 31 inDART HCSO08 User s Manual 1 Overview What is inDART HCS08 inDART HCSOS is a powerful entry level tool for Motorola HCS08 based systems inDART HCSOS takes advantage of Metrowerks CodeWarrior HC S o8 Integrated Development Environment and the BDC Background Debug Controller feature to debug the user program Together with CodeWarrior HC S o8 inDART HCSOS provides you with everything you need to compile download program in circuit emulate and debug user code Full speed program execution allows you to perform hardware and software testing in real time inDART HCS08 is connected to the host PC through a USB port while the 6 pin BDM connector of the product fits into the target s standard BDM connector Design Kit packages also include a full featured experiment board for a specific HCS12 microcontroller inDART HCS08 offers you the following benefits Real time code execution without probes works with all packages BDM compatible connector n circuit debugging Built in FLASH programmer DataBlaze programming utility 1 8 to 5 5 V devices supported Standard chip used no bondouts 100 electrical characteristics guaranteed Working frequency up to the microcontroller s maximum Jumperless hardware mode setting A
9. SofTec Microsystems inDART HCSOS8 additional components be installed in the host PC Note Metrowerks CodeWarrior HC S 08 IDE must be installed first Please note that inDART HCS08 only works with CodeWarrior for HC S 08 version 3 0 or above Installing Metrowerks CodeWarrior IDE To install the CodeWarrior IDE insert the CodeWarrior CD ROM into your computer s CD ROM drive A startup window will automatically appear Follow the on screen instructions Installing SofTec Microsystems Additional Components SofTec Microsystems additional components install all of the other required components to your hard drive These components include inDART HCSo8 USB driver inDART HCSO8 software plug in for CodeWarrior HC S 08 Sample source code for SofTec Microsystems evaluation boards SofTec Microsystems DataBlaze programming utility inDART HCSO8 hardware diagnostic test utility Documentation in PDF format To install SofTec Microsystems additional components insert the SofTec Microsystems System Software CD ROM into your computer s CD ROM drive A startup window will automatically appear Choose Install Instrument Software from the main menu A list of available software will Page 11 2 Getting Started appear Click on the inDART HCSo8 Additional Components option Follow the on screen instructions Note if you are installing the inDART HCSO8 additional components Windows 2
10. Tec Microsystems Additionally under Windows XP the Found New Hardware Wizard procedure may occur twice Application Tutorial This section will provide a step by step guide on how to launch your first inDART HCSO8 project and get started with the CodeWarrior HC S o8 user interface Note the example provided assumes that inDART HCSO6 is used with the IDB HCSOo8GB demo board If you have a different demo board some procedures may differ slightly This tutorial is based on an Assembly example Additional examples in C are also provided For evaluation board specific features please refer to the evaluation boards PDF manuals installed by Sof Tec Microsystems additional components The sample application does the following By rotating the potentiometer you affect the results of the A D conversion and the value of each conversion is displayed on the LEDs pressing the PTC5 push button the DIP switches status is displayed on the LEDs 1 Ensure that the inDART HCSOS board is connected to the PC via the USB cable and that the demo board is powered on via the REG VDD Page 14 inDART HCSO08 User s Manual connector the VDD OUT cable must be connected and the VDD SOURCE jumper must select the REG option 2 Ensure that the inDART HCSO8 board is connected to the demo board via the BDM connector 3 Make sure that all of the evaluation board s jumpers are set to their facto
11. d the ATD REFERENCE jumpers are all in their default position 5 EREJE E JEJEJE JEJEJE JEJEJE XDEF Entry main L 9696 963 Peripheral registers definition DERE JE XC E XC JE XE CE PTAD EQU 0000 Port A data register PTCD EQU 0008 Port C data register PTCPE EQU 0009 Port C pull up enable register PTFD EQU 0040 Port F data register PTFDD EQU 0043 Port F data direction register EQU 0050 ATD control register EQU 0051 ATD status and co
12. dow or the Data window is open since these windows read microcontroller s resources during refresh operations 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 Start Continue Single Step etc will continue the execution of the program from the next instruction 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 Periodical from the pop up menu which appears by right clicking on the Memory window Page 23 3 inDART HCS08 Operations DataBlaze Programming Utility A full featured programming utility DataBlaze is also provided with inDART HCSo8 To start the DataBlaze utility select Start gt Programs gt SofTec Microsystems gt inDART HCSo8 gt DataBlaze Programmer DataBlaze offers the following advanced features Code memory editing Data memory EEPROM editing Blank check erase program verify operations on Code memory and Data memory Read operations from Code memory and Data memory Project handling On
13. e an executable file and will download it to the demo board 8 Anew debugger environment will open In the Source window the first line to be executed is highlighted Page 16 inDART HCS08 User s Manual Bb True Time Simulator amp Real Time Debugger C Program Files Metrowerks CodeWarrior CW08_V3 0 CodeWarrior_Examples HC Loe File View Run SofTec HCS08 Component Source Window Help ere gt gt 4 S Source A C Program Files Metrowerks Codewarrior 08_ _ 508 Line 58 Entry Entry RSP main CLI rsp SP lt OxFF BSR 17 abs 182C cli Enables interrupts BRCLR 5 0x08 15 cabs 184 bsr init Peripheral initialization 7 main_loop lt I HCS08 Auto 0 E Tu EO SR 68 Status VHINZC pr 183R d Entry r Auto 0000 FA 00 00 00 00 00 00 00 A 0008 00 00 00 00 00 00 00 00 4 0010 00 00 00 00 00 00 00 0018 00 04 00 00 CO 00 00 00 0020 00 04 00 00 CO 00 00 00 main dbg Auto Symb Global 0028 04 00 00 20 00 0030 00 00 00 00 00 00 00 00 0038 00 00 00 00 00 00 0040 00 00 00 00 00 00 00 00 0048 28 70 68 01 08 7F 98 m en i 19 MARKPOINTS SAVE OFF Entry Auto Symb Local done C Program Files Metrowerks CodeWarrior C Postload command file does not exist im gt F
14. e button multiple operations programming Auto feature Automatic trimming calibration Serial numbering Page 24 inDART HCS08 User s Manual Y DataBlaze Programmer Code aax Fie Project Edit Operations Window Help Lip 19 Lh gt BW ES Ge by m 2 Project Select Blank Erase Read Program Verify Auto Code Help Project Properties Device Check Memory S ae Sa GNU GEN SEHR lal Due 1080 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF SofTec BDC08 1090 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF HCS08 Programmer 1040 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF v 1 00 Beta2 10B0 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 10CO FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 10D0 FF FF FF FF FF FF FF FF FF FF EXXx er Xr Device 10E0 FF FF FF FF FF FF FF FF FF FF Auto Motorola 10FO FF FF FF FF FF FF FF FF FF FF 95086 60 1100 FF FF FF FF FF FF FF FF FF Steps 1110 FF FF FF FF FF FF FF FF FF FF 1120 FF FF FF FF FF FF FF FF FF 7 Blank Check Code Code Memory 1130 FF FF FF FF FF FF FF FF FF FF V Program Code Exit Reet ean 1140 FF FF FF FF FF FF FF FF FF FF V Verify Code epee Melee 1150 FF FF FF FF FF FF FF FF FF FF Program ICGTAM FFBE Wate 1160 FF FF FF FF FF FF FF FF FF 1170 FF FF FF FF FF FF FF FF FF FH EEEN 1180 FF FF FF FF FF FF FF FF
15. ec Microsystems System Software CD ROM contains the DataBlaze programming utility targeted to the inDART HCS08 board DataBlaze is a full featured programming utility which offers a complete set of programming features like memory editing blank check erase verify operations and read write operations Demo Boards Design Kit packages include a full featured microcontroller specific experiment board The demo board can be used for evaluation experiments in the absence of a target application board Recommended Reading This documentation describes how to use inDART HCSOS together with Metrowerks CodeWarrior HC S o8 IDE and DataBlaze programming environment Additional information can be found in the following documents Page 7 1 Overview Evaluation Board Specific Information If you bought a Design Kit additional documentation which explains the evaluation board s details is available under Start gt Programs gt SofTec Microsystems gt inDART HCSOS gt User s Manuals Metrowerks Additional Documentation Available from the CodeWarrior IDE Motorola HCSo8 Datasheets Include detailed information on the devices background debug controller BDC Software Upgrades The latest version of the inDART HCSO8 system software is always available free of charge from website http www softecmicro com Metrowerks CodeWarrior upgrades can be found at http www metrowerks com Page 8 inDART HCS08 Use
16. g the SofTec HCSOoS8 gt Trigger Module Settings menu while in debug When setting an instruction breakpoint CodeWarrior does the following 1 Ifavailable uses the hardware address breakpoint built into the BDC module 2 Otherwise if possible sets one hardware breakpoint using the DBG peripheral 3 Ifnohardware breakpoints are available in the DBG peripheral or if the trigger mode is not set to Automatic a warning message is displayed and the instruction breakpoint will not be set Page 21 3 inDART HCS08 Operations Note when setting an instruction breakpoint on a RAM location a software breakpoint is set the opcode present at that location is automatically replaced by the BGND Assembly instruction Therefore no hardware breakpoints are wasted Note the Single Step command in a C source code and the Step Over and Step Out commands both in a C and Assembly source code use one hardware breakpoint Using Existing Projects with inDART HCS08 If your project has been targeted to an emulator simulator other than inDART HCSo8 and you wish to use inDART HCSOS8 as the debugger for your project please do the following 1 CodeWarrior is interfaced to the inDART HCSO8 engine through a so called GDI interface From the CodeWarrior HC S o8 debugger interface select Component gt Set Target and choose HCSo8 as processor and GDI Target Interface as target interface 2 Adialog box
17. in use choose inDART HCSo8 MCU Configuration the CodeWarrior HC S o8 debugger s main menu IftheinDART HCSOS menu is not present in the CodeWarrior HC S o8 debugger s main menu this is because the target has not been recognized by CodeWarrior No link to Target appears in the status bar In this case you must do the following Fromthe GDI menu choose MCU Configuration and verify that the hardware code and device code parameters are set correctly Pressthe Communication Settings button and verify that all of the communication parameters are set correctly Make sure the demo board target application board is powered on and the target microcontroller is working Programming and debugging rely on a BDM communication between the inDART HCS08 board and the demo board target application This means that in order to work correctly the target microcontroller must be running In particular make sure that The BDM cable is connected to the demo board target application s BDM connector All of the required BDM connector signals are correctly tied to the target microcontroller Page 27 4 Troubleshooting Stepping Execution is Slow When the Memory window is open step commands may execute slower since the Memory window contents need to be refreshed after every step STOP Assembly Instruction Causes a Microcontroller Reset If the STOPE bit in the SOPT register is not set the STOP instruction is recogn
18. ip sw Push button pressed gt DIP switched status on LEDs sta SRS Refreshes the watchdog lda PTAD Reads DIP switches status sta PTFD Writes the value on Port 7 0 bra main loop Forever Breakpoint Set 13 Rotate the potentiometer slightly Then from the main menu choose Run gt Start Continue The application will restart from where it was previously stopped The application will stop at the breakpoint location as soon as the next A D conversion is done 14 From the main menu choose Run gt Single Step The Ida ATDRH instruction will be executed In the Registers window you can see how that instruction affected the value contained on the Accumulator This value is the result of the A D conversion 15 Issue another Single Step command Run gt Single Step The Accumulator value will be displayed on the LEDs Congratulations You have successfully completed this tutorial You can continue to experiment with the CodeWarrior user interface and discover by yourself its potentialities For an in depth guide of all of the user interface features select Help gt CodeWarrior Help or Help gt Online Manuals from the CodeWarrior HC S o8 IDE s main menu Page 18 inDART HCSO08 User s Manual 3 inDART HCSO08 Operations inDART HCS08 Working Principles inDART HCSOS is an in circuit debugger as well as a programming tool It programs files into the 08 microcontrollers and offers deb
19. ized as an illegal opcode causing the microcontroller to reset The SOPT register can be written only once after reset Communication Lost During Debugging This problem may have several causes 1 The microcontroller s bus frequency has been changed by the user application and the CLKSW bit is set to 1 In this case set the CLKSW bit to 0 in the Communication Settings dialog box 2 The BKGDPE bit in the SOPT System Option Register register has been set to configuring the BKGD pin as a generic I O pin The BKGD pin must be reserved for the BDC communication BKGDPE 1 3 Amicrocontroller reset has occurred Among other things this may be caused by the COP peripheral After reset the COP is enabled so your program must either disable it or reset its timer Diagnostic Test inDART HCSOS has built in self test capabilities This means that you can verify by yourself at any time the correct operation of the instrument s hardware The diagnostic test is accessible through a small separate test utility To perform the diagnostic test 1 Start the inDART HCSOS diagnostic test utility by selecting Start gt Programs gt SofTec Microsystems gt inDART HCSo8 gt inDART HCSo8 Diagnostic Test The following dialog box will appear Page 28 inDART HCSO08 User s Manual inDART HCSO8 Diagnostic Test This diagnostic test performs a general hardware check and a foolproof test of all of the BDM Exit connector
20. ntrol register EQU 0054 ATD pin enable register EQU 0052 ATD result register high EQU 0053 ATD result register low EQU 1800 SIM reset status register 199969969 DEFAULT_ROM SECTION JE Peripheral Initialization 19636999 IOI III III III III III III III III II III IIIS AIM init bset 5 PTCPE Enables port C5 internal pull ups mov FF PTFDD Configures port F 0 as output mov ATDC on 8 bit left justified unsigned PRESC 64 mov 01 ATDPE Enables ADC pin 0 mov 20 ATSDC Selects input channel 0 continuous conversion mode rts Line 16 Col 13 4 The Example s Source Code 7 From main menu choose Project gt Debug This will generat
21. or Help press F1 Automatic triggers breakpoints watchpoints and trace possible MC9S508GB60 0 Debugging Session Started 9 From main menu choose Run gt Start Continue The program will be executed in real time Please note that the BUSY LED on the inDART HCSO8 unit turns on By rotating the potentiometer on the demo board you affect the results of the A D conversion and the value of each conversion is displayed on the LEDs 10 From the main menu choose Run gt Halt The program execution will stop The next instruction to be executed is highlighted in the Source window 11 From the main menu choose Run gt Single Step The instruction highlighted in the Source window will be executed and the program execution will be stopped immediately after Page 17 2 Getting Started 12 In the Source window insert a breakpoint at the ATDRH instruction in the main loop subroutine To insert the breakpoint right click on the 1 ATDRH line and from the pop up menu select Set Breakpoint s Source BAX C Program Files Metrowerks CodeW arrior CW08_V3 0 CodeW arrior_Examples HCS 085 main dbg Line 66 wait eoc Push button released gt Potentiometer value on LEDs sta SRS Refreshes the watchdog brclr 7 ATSDC wait eoc Waits for ADC end of conversion lda ATDRH Reads ADC value sta PTFD 7 Writes the value on port 7 0 bra main loop Forever read d
22. r s Manual 2 Getting Started inDART HCS08 Components The inDART HCSo8 package includes the following items The inDART HCSO8 in circuit debugger programmer unit 20 cm 6 conductor BDM cable A 30 cm 1 conductor VDD OUT cable A USB cable The Metrowerks CodeWarrior HC S o8 CD ROM The SofTec Microsystems inDART HCS08 System Software CD ROM A full featured microcontroller specific experiment board Design Kit packages only 8 This user s manual 9 2 Getting Started Development Tools y Y 4 System ferie Embedded World In Circuit Debugger Programmer for Motorola HCSO8 Family FLASH Devices inDART HCSOS delima Q mororora ever inDART HCS08 Components Host System Requirements The inDART HCSO8 in circuit debugger is controlled by an Integrated Development Environment running under Windows CodeWarrior HC S o8 The following hardware and software are required to run the CodeWarrior HC S o8 user interface together with inDART HCSo8 1 A133 MHz or higher PC compatible system running Windows 98 Windows 2000 or Windows XP 2 128 MB of available system RAM plus 500 MB of available hard disk space 3 A USB port Page 10 inDART HCS08 User s Manual 4 CD ROM drive for installation Installing the Software inDART HCSOS requires that both Metrowerks CodeWarrior IDE and
23. rior Integrated Development Environment inDART HCSO8 comes with a free version of CodeWarrior Development Studio for HC S o8 Microcontrollers Special Edition CodeWarrior Development Studio for HC S 08 is a powerful and easy to use tool suite designed to increase your software development productivity Its Page 6 inDART HCSO08 User s Manual 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 Motorola HC S 08 Microcontrollers enables you to build and deploy HC S 08 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 To use the Special Edition you must have a valid license key Without the license key the product will run in a 1 KB code size limited demonstration mode To request the license key please refer to Metrowerks website This documentation covers the basic setup and operation of the CodeWarrior IDE but does not cover all of its functions For further information please refer to the CodeWarrior on line help and online documentation provided SofTec Microsystems DataBlaze Programming Utility The SofT
24. ry position 4 Start the CodeWarrior HC S o8 IDE by selecting Start gt Programs gt Metrowerks CodeWarrior gt CWo8 gt CodeWarrior IDE The CodeWarrior HC S o8 IDE will open 5 From the main menu choose File gt Open Select the Demo mcp workspace file that is located under the Program Files Metrowerks CodeWarrior CWo8 CodeWarrior_Examples HCS08 SofTec Microsystems inDART HCSo8MDB HCSo8GBMAsm Demo directory Click Open The following window will appear xxi Demo mcp 49 SoffecinDaRTHCSOa dg x Q5 iy Files Link Order Targets File Code Data 3X Bl readme txt n a n a E Sources 0 0 main asm 0 0 Ea Pm 0 0 burner bbl n a n a AB default prm n a n a 0 0 E Debugger Project File 0 0 Bl SofT ec_inDART HCSO8 ini n a n a E Debugger Cmd Files 0 0 Bl Postload cmd n a n a B Preload cmd n a n a iB Reset cmd n a B Startup cmd n a n a amp amp amp amp ls bs ha ka Ls Ls ba ha Dc eee The Project Window 6 The Assembly code of this example is contained in the main asm file Double click on it to open it The following window will appear Page 15 2 Getting Started E main asm Wee b 0 tn B d Path C Program FilesNMetrowerksNCode Warrior CWO8_V3 0 CodeWarriorExamples HCSO8 SofT ec Microsystems inD main asm lt gt EENE
25. s 1 0 lines Before to start the test make sure that inDART HCSO8 is connected to the PC via the USB connector and the target system is NOT connected to the instrument Press OK when ready The inDART HCS08 Diagnostic Test Utility 2 Make sure that inDART HCS08 is connected to the host PC Make sure that no target system is connected to inDART HCS08 4 Click OK The test will be performed In case of problems please contact our technical support Getting Technical Support Technical assistance is provided free to all customers For technical assistance documentation and information about products and services please refer to your local SofTec Microsystems partner SofTec Microsystems offers its customers a free technical support service at support softecmicro com Before getting in contact with us we advise you firstly to visit our online FAQ section and to be sure you are working with the latest version of the inDART HCSOS8 user interface upgrades are available free of charge at http www softecmicro com download html Page 29 inDART HCSO08 User s Manual Appendix A Electrical and Physical Specifications Operating Voltage Operating Current Vpp Voltage Supplied by the Vpp Line on the VDD OUT Connector loo Current Drawn by the Target via the Vpp Line on the VDD OUT Connector Dimensions Weight Operating Temperature Storage Temperature Humidit
26. stered 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 inDART HCSO08 User s Manual Contents 1 Overview What is inDART HCS08 Background Debug Controller BDC CodeWarrior Integrated Development Environment SofTec Microsystems DataBlaze Programming Utility Demo Boards Recommended Reading Software Upgrades 2 Getting Started inDART HCSo8 Components Host System Requirements Installing the Software Installing Metrowerks CodeWarrior IDE Installing SofTec Microsystems Additional Components Installing the Hardware Application Tutorial 3 inDART HCS08 Operations inDART HCS08 Working Principles Configuring a Debugging Session Creating Your Own Application MCU Configuration Communication Settings Breakpoints and Trace Using Existing Projects with inDART HCSOo8 Notes and Tips Entering Debug Session with CodeWarrior Reading Peripheral Status Breakpoints and BGND Instruction Real Time Memory Update DataBlaze Programming Utility DataBlaze Notes O ONNN 00 jus s Oo oo 21 Contents 4 Troubleshooting Common Problems and Solutions Communication Can t Be Established with inDART HCSo8 Stepping Execution is Slow STOP Assembly Instruction Causes a Microcontroller
27. ugging features like real time code execution stepping advanced breakpoints and trace buffer Its debugging features are achieved thanks to the microcontroller s integrated Background Debug Controller BDC The BDC peripheral communicates with the inDART HCSo8 board through a single wire dedicated line 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 inDART HCS08 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 peripherals Moreover the inDART HCSo8 debugging approach ensures that the target microcontroller s electrical characteristics pull ups low voltage operations I O thresholds etc are 100 guaranteed Configuring a Debugging Session Creating Your Own Application CodeWarrior HC S o8 helps you get started with your own application by including a project wizard specific for the inDART HCSO8 board To create new inDART HCSO8 project 1 From the main menu select File gt New 2 A dialog box will appear Select HC S o8 New Project Wizard 3 Follow the Project Wizard steps making sure you select the correct microcontroller derivative you are
28. utomatic target frequency detection Hardware self diagnostic test USB connection to the PC Metrowerks CodeWarrior IDE the same user interface of all Motorola tools with editor assembler C compiler and debugger Page 5 1 Overview Background Debug Controller BDC All MCUs in the HCS08 family contain a single wire background debug interface which supports in circuit programming of on chip non volatile memory and sophisticated non intrusive debug capabilities This system does not interfere with normal application resources It does not use any user memory or locations in the memory map and does not share any on chip peripherals The background debug controller BDC uses a single wire communication interface to allow non intrusive access to target system memory and registers inDART HCSOS uses the standard 6 pin BDM connector defined by Motorola to program and debug the target device You must therefore provide such connector see the diagram below on your target board 1 BKGD 1 gH o gt 2 GND NOC 4 RESET 5 e 5 5 6 VDD BDM Connector BKGD Single wire background interface pin This signal is required GND System ground This signal is required RESET Reset signal to target system This signal is optional but it s useful during debugging VDD Power supply voltage from target This signal is required by inDART HCSo8 signal conditioning CodeWar
29. will appear asking you to locate the GDI dll file needed to interface with inDART HCSO8 Select the Soffec_BDCo8 dll file located into the NProgram Files Metrowerks CodeWarrior CWo8 prog directory 3 CodeWarrior will then recognize inDART HCSOS as the target interface for your project The MCU Configuration dialog box will appear allowing you to select the derivative you are working with 4 Onthe CodeWarrior HC S o8 debugger interface a new menu SofTec HCS08 will be created From this menu select Load and locate the object file your project is based on Page 22 inDART HCSO08 User s Manual Notes and Tips Entering Debug Session with CodeWarrior When entering a debug session the target microcontroller s FLASH memory 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 to the location suggested by Motorola 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 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 win
30. y 4 75 to 5 0 V DC provided by the USB connection 300 mA max 3 0 V or 5 0 V 100 mA max 95 x 55 x 15 mm 25g 0 to 50 C 20 C to 70 C 90 without condensation Electrical and Physical Specifications Page 31
31. ystem and on the user application The idea is to set the CLKSW bit so that the highest and less subject to changes clock frequency is used for the BDC communication A low clock frequency will result in slow BDC communication and therefore slow debugging and slow programming while a clock frequency which changes frequently as in the case of the user application modifying the FLL peripheral may result in loss of BDC communication Page 20 inDART HCSO08 User s Manual The value of the CLKSW can be changed in the Communication Settings dialog box Communication Settings Clock CLKSW C Use alternate frequency CLKS w 0 The clock that drives the BDC communication is Cancel the alternate fixed frequency source The exact clock source depends on the HCSO8 derivative Use system bus frequency CLKSW 1 You should avoid using this option while running user program that might change the bus frequency because this could result in loss of BDC communication The Communication Settings Dialog Box Breakpoints and Trace CodeWarrior offers a variety of tools for analyzing the program flow breakpoints both simple and complex watchpoints and a trace buffer AII these features are implemented by taking advantage of the target microcontroller s DBG peripheral To access breakpoints watchpoints and trace buffer settings open the Trigger Module Settings dialog box by choosin
Download Pdf Manuals
Related Search