background image

 

   

Global Top Smart MCU Innovator, ABOV Semiconductor 

www.abovsemi.com

   

 

E-OCD II Debugger 

 

 

 

User’s Manual

 

Version 1.0.2 

 

 

Summary of Contents for E-OCD II

Page 1: ...Global Top Smart MCU Innovator ABOV Semiconductor www abovsemi com E OCD II Debugger User s Manual Version 1 0 2...

Page 2: ...ndows 18 3 1 Debugger Software Features 18 3 1 1 Common Features 19 3 2 Menu Descriptions 21 3 2 1 File 22 3 2 2 View 23 3 2 3 Emulation 28 3 2 4 Break Configure 33 3 2 5 Power Out 3 3V or 5 0V 42 3 2...

Page 3: ...5 2 USB Kernel Driver Installation 81 5 3 ABOV s SDK DLL Connections 82 5 4 IAR Project Settings 83 5 5 Download Hex File 85 5 6 Cautions for Debugging 87 5 7 SDK DLL Compatibility According to IAR V...

Page 4: ...nced function for USB driver Power out low level detection more than OCD II Power out function only supports 50mA current consumption environment 1 1 1 Software Requirements The following operating sy...

Page 5: ...e E OCD II software be used because ABOV constantly adds newer devices and features Both 32 bit and 64 bit versions are available To check the operating system details of the PC open the Control Panel...

Page 6: ...r The 32 bit installer file name starts with Setup32_ keyword The 64 bit installer file name starts with Setup64_ keyword 2 64 bit systems only Once the warning message below message box click Yes Fig...

Page 7: ...icense agreement If agree select I accept the items of the license agreement on the license agreement dialog box and click Next Figure 1 4 License Agreement 5 Enter the User Name and Company Name and...

Page 8: ...Introduction E OCD II Debugger User s Manual 8 6 Select Complete and click Next Figure 1 6 Select a Setup Type 7 Click Install Figure 1 7 Begin the Installation...

Page 9: ...II Debugger User s Manual Introduction 9 8 Wait until all the application components are installed Figure 1 8 Installing 9 Click Finish to complete the installation Figure 1 9 InstallShield Wizard Com...

Page 10: ...s Manual 10 Note the installation folder path This information is needed when you install the hardware driver 32 bit C Program Files ABOV Semiconductor OCD II_debugger32 64 bit C Program Files x86 AB...

Page 11: ...an Interface Devices Windows of Microsoft support HID USB Driver So when E OCD II debugger is connected to computer HID USB Driver is installed to the computer and user can use E OCD II debugger autom...

Page 12: ...n E OCD II Debugger User s Manual 12 2 Find Human Interface Devices in list Figure 1 11 Device Manager HID 3 Check HID properties to confirm E OCD II Hardware Vendor ID Figure 1 12 Device Manager HID...

Page 13: ...Select Hardware Ids in Detail Tap of HID properties Figure 1 13 HID compliant Device Properties 5 E OCD II Hardware vendor ID is 0x1A29 If VID_1A29 is searched E OCD II is connected properly Figure 1...

Page 14: ...II Serial supports ISP via serial interface DSCL DSDA 10 pin external connector for Debugging and programming USB HID transmission is applied to Hardware of E OCD II Include two interface lines SCLK...

Page 15: ...Cable Side View Table 2 1 Pin Assignment Pin No Name Function 1 Not Used 2 VCC Detect Detects the target system s power and interface voltage level 3 Not Used 4 GND System grounding 5 RunFlag Connect...

Page 16: ...rface supports both the OCD and OCD II interfaces But since the OCD and OCD II interface protocols are not compatible with one another the target protocol must be selected first Even if the target MCU...

Page 17: ...damage to the interface module 2 1 6 E OCD II Power Out to Target System E OCD II can Power out to target system two types of voltages 3 3V 5 0V User can select the output voltage using a switch on E...

Page 18: ...other you must first select the target MCU series Debugger software support three kinds of ABOV debugger type E OCD II OCD OCD II debugger Figure 3 1 Debugger Program 1 The power icon is black off whe...

Page 19: ...C9x A9x series developed by ABOV Semiconductor Co Ltd The following features are provided regardless of whether the OCD or OCD II interface is used Detect the target device automatically Use symbolic...

Page 20: ...D II device series which support a maximum of 12 breaks Four of them are fixed as program counter breaks The other eight breaks can be used either as program counter breaks or combined or individual e...

Page 21: ...E OCD II Debugger User s Manual Debugger Software for Microsoft Windows 21 3 3 Menu Descriptions This section introduces an overview of the menu items Figure 3 6 Debugger Program...

Page 22: ...ing items Figure 3 7 Menu File 1 Open Open the selected local text file in a child text window The shortcut key is Ctrl O 2 Close Closes the top most child text window 3 Close All Closes all child tex...

Page 23: ...or hides a variety of child views Only selected child views are opened Figure 3 9 Dockable Windows 2 Dockable Windows Customize The Customize dialog box enables modifications to the Command Toolbar K...

Page 24: ...Debugger Software for Microsoft Windows E OCD II Debugger User s Manual 24 Figure 3 10 Customize Commands 3 The Toolbars tab offers a Toolbar style Figure 3 11 Customize Toolbars...

Page 25: ...for Microsoft Windows 25 4 The Keyboard tab allows the user to define a shortcut key for each command or reset it to the default setting Figure 3 12 Customize Keyboard 5 In the Menu tab the user can...

Page 26: ...Manual 26 6 In the Options tab the user can change toolbar tip display icon size and so on Figure 3 14 Customize Options 7 Status Bar It turns the status bar on or off The Status bar displays informat...

Page 27: ...soft Windows 27 8 Caption Bar It turns the Caption bar on or off The Caption bar displays the device name and what device is connected to the OCD or OCD II interface 9 Application Look This menu item...

Page 28: ...al 28 3 3 3 Emulation This menu is to control the start and stop of the code Figure 3 16 Menu Emulation 3 3 4 Emulation Load Hex It displays a dialog box to enter the hex file name The target device i...

Page 29: ...r downloading the hex file 5 Keep device data FILE data will be ignored following range With this option checked the user can keep the device data not the hex file data within the specified address ra...

Page 30: ...the dialog box If the target device has configurations the Configuration dialog box below is opened 10 Configurations To activate the device configuration a Write the configuration b Power off the tar...

Page 31: ...alog Window 3 3 7 Emulation Run Continue It starts emulation from the device s current address Current address means The address where the previous emulation has stopped If the target device is reset...

Page 32: ...n halt it by clicking the Stop button 3 3 11 Emulation Stop It halts the current emulation or step run immediately 3 3 12 Emulation Apply Reset Target OCD devices have a variety of reset options as gi...

Page 33: ...gs emulation options device configurations and so on You can emulate your program with more options by using these controls Some items under this menu do not apply to the OCD device series because the...

Page 34: ...CD II devices a total of 12 break event triggers are supported Four of them are program counter breaks The other eight breaks can be used as program counter breaks or as combined or individual event t...

Page 35: ...tion in detail either in the Multi byte break section or in the bit break section Figure 3 23 Fill Data Break 1 Multi byte break section This section supports byte count comparison Byte count Choose t...

Page 36: ...ables value ranges Table 3 1 Variable Value Ranges Byte Count Signed value Unsigned value Min Max Min Max 1 128 127 0 255 2 32 768 32 767 0 65 535 4 2 147 483 648 2 147 483 647 0 4 294 967 295 Big End...

Page 37: ...k AFTER exec When the OCD logic detects a break event the target device is stopped after the OPCODE of the program counter break is executed 3 3 17 Break Configure Emulation Time Measuring This menu i...

Page 38: ...tion You can select the unit of step runs between the source line level and OPCODE level Figure 3 25 Step Run Option Dialog 3 3 20 Break Configure Peripheral Control Selecting this prompts you to sele...

Page 39: ...all data in the device will be erased This is an important device specification that protects data from being hacked If the target device configuration does not exist the following dialog box appears...

Page 40: ...red because the debugger can get real emulation time 3 3 23 Break Configure Change OCD Series The OCD interface can detect most of its compatible devices automatically But as some devices have a sligh...

Page 41: ...will be selected by default You must select one of the listed series else this dialog box will not close 2 Turn off the target system and click Yes Figure 3 32 Message Box 3 Wait for a few seconds un...

Page 42: ...black off when the E OCD II is first connected to the PC 2 When the power icon is selected the icon color is changed and the power voltage is output The output voltage can be changed from E OCD II sw...

Page 43: ...target board with the power of E OCD II is on it may cause breakage of the target board 7 Connecting E OCD II with the power of target board is on it may cause breakage of E OCD II 8 User must connec...

Page 44: ...this menu are designed to for maker test purpose and not for end users Figure 3 35 Menu Test for OCD Device Series Figure 3 36 Menu Test for OCD II Device Series 1 Open test dialog box This function i...

Page 45: ...ssword is required to access this function Figure 3 38 nor for End Users 3 Calc checksum It reads the target device s code memory and displays the checksum If you attempt to read a protected device th...

Page 46: ...t You can split the text file window s view as shown in two as shown below You can move or remove the splitter by dragging the mouse Figure 3 42 Example Original View Split View 2 Window number file n...

Page 47: ...dows Dialog 3 3 27 Help This menu supports to check the debugger version Figure 3 44 Menu Help Figure 3 45 Program Information 3 3 28 Toolbar The toolbar provides easy one click access to the most use...

Page 48: ...code 3 4 1 Child Window Alignment You can re size move dock and hide each child window and perform various other actions for them All windows are dockable except for the text window What is docking D...

Page 49: ...Debugger Software for Microsoft Windows 49 Figure 3 48 Example Moving Cocked Child View in the Debugger All dockable windows can be moved out of the debugger frame as shown below Figure 3 49 XDATA Wi...

Page 50: ...D II Debugger User s Manual 50 All dockable windows have Hide and Close buttons The Hide button moves the child window aside in the debugger frame but does not close it The Close button closes the chi...

Page 51: ...age Up or Page Down keys to move to the previous or next page The upper side of this widow displays the address of the current caret position 1 Edit You can edit data here directly by typing Note that...

Page 52: ...he Intel Hex format Figure 3 53 Pattern Load Dialog 5 Save pattern Save a code area as a hex file The code area is specified by entering its start and end addresses Figure 3 54 Pattern Save Dialog 6 F...

Page 53: ...le only to OCD II devices Double click on data in the window to set or remove a data break Double clicking on an already set data break will pop up the dialog box shown below Once a data break is set...

Page 54: ...bers The current device program counter is colored in dark gray Lines having source file information are marked with a red asterisk Double click on this mark to open the source file and move to the te...

Page 55: ...the Mnemonic area of a line allows you to modify the assembly code Once you modify the code click Modify Figure 3 59 Modifying the Assembly Code 1 Move button Move the display address and caret posit...

Page 56: ...Up or Page Down keys to move to the previous or next page The upper side of this widow displays the address of the current caret position 1 Edit You can edit data here directly by typing Note that da...

Page 57: ...e 3 63 Pattern Load Dialog 4 Save pattern Save a code area as a hex file The code area is specified by entering its start and end addresses The only available format is the Intel Hex format Figure 3 6...

Page 58: ...le only to OCD II devices Double click on data in the window to set or remove a data break Double clicking on an already set data break will pop up the dialog box shown below Once a data break is set...

Page 59: ...r side of this widow displays the address of the current caret position 1 Edit You can edit data here directly by typing Note that data changes made in this editor are not transmitted to the target de...

Page 60: ...le only to OCD II devices Double click on data in the window to set or remove a data break Double clicking on an already set data break will pop up the dialog box shown below Once a data break is set...

Page 61: ...Enter Addresses 0x80 0xFF are the direct addressing area Figure 3 69 SFR View Window 2 Refresh button Reload data from the target device and re new the current display The SFRs include a control regi...

Page 62: ...View This view shows the target device s registers in the hex dumped format PSWs program status words use a binary format 1 Edit You can edit data here directly by typing Note that data changes made i...

Page 63: ...tion of each occurrence includes When the break occurred Next program counter Target device s clock count Emulation time If you are using an OCD II device and the RTIME pin is connected it shows real...

Page 64: ...Software for Microsoft Windows E OCD II Debugger User s Manual 64 2 Breaks tab This tab lists the set breaks If you are using an OCD II device refer to Set data break too Figure 3 73 Output Window Br...

Page 65: ...the Symbol file has already been loaded the Source file will display the line numbers and real addresses combined as shown in the screenshot below Figure 3 74 Source View Window If you double click t...

Page 66: ...colors the result Figure 3 76 Find 2 The following example shows that all occurrences of the search text are colored in red Figure 3 77 Searched Text 3 Find Next N This finds the next occurrence of t...

Page 67: ...s Manual Debugger Software for Microsoft Windows 67 4 Goto line G This takes you to your desired line in the text file Selecting this will prompt you to type in a decimal line number Figure 3 79 Get...

Page 68: ...iew shows and allows editing global variables of the source code Figure 3 80 Global Variable View 1 Add global variable Add global symbols to this view This button is disabled when the symbol informat...

Page 69: ...E OCD II Debugger User s Manual Debugger Software for Microsoft Windows 69 Double click on the symbol name you want to add Select the variable and click Add Type in the symbol name and click Add...

Page 70: ...l symbol in one of the following ways Double click on the symbol name you want to remove Select the variable and click Remove Type in the symbol name and click the Remove 3 Values In this view values...

Page 71: ...E OCD II Debugger User s Manual Debugger Software for Microsoft Windows 71 Note Array data is not supported If you want to use array data you will need to use a Keil plug in...

Page 72: ...it variable only The input value is 0 or 1 Decimal Decimal number ex 12345 Hexadecimal Hexadecimal number ex 0x1234 5 Set break This function is available only to OCD II devices Double click on data i...

Page 73: ...eral a developer cannot see the target device s internal data But the OCD II interface supports data monitoring even while the CPU is operating Real time monitoring of global variables Is possible bec...

Page 74: ...of the source code Figure 3 86 Local Variable View 1 Add remove local variable Adding or removing local variables in this view is processed automatically by the debugger If the program counter value...

Page 75: ...ecimal or binary numbers 2 or 4 byte variables Hexadecimal or decimal numbers Arrays pointers structures 2 byte values These are pointer values and not data Note Array data is not supported If you wan...

Page 76: ...plex breakpoints watch windows and execution control as well as sophisticated features such as trace capture execution profiler code coverage and logic analyzer Using the Keil plug in you can work wit...

Page 77: ...debugger 2 Debugger Vision provides several interfaces to target hardware debugging interface such as ULINK and a variety of target monitors provided by Keil Additional hardware drivers are provided b...

Page 78: ...OOK0 HLP Release_Notes htm Release Notes GEN BOOK1 HLP C51TOOLS chm Complete User s Guide Selection C TDRV0 BIN MON51 DLL Keil Monitor 51 Driver TDRV1 BIN ISD51 DLL Keil ISD51 In System Debugger TDRV2...

Page 79: ...ur project options as shown in the following dialog box Now you can erase read or write the code to your target MCU If you are not using code banking use ABOV E OCD II Dongle Figure 4 2 ABOV E OCD II...

Page 80: ...ct Set your project options as shown in the following dialog box Now you can emulate and debug your target MCU If you are not using code banking use ABOV E OCD II Dongle Figure 4 4 ABOV E OCD II Dongl...

Page 81: ...g to IAR version Restrictions according to the number of Breakpoints that are built in ABOV s device 5 2 USB Kernel Driver Installation E OCD II Debugger Since the built in HID of Windows is used addi...

Page 82: ...y using SDK sources of IAR 2 SDK DLL compatibility between IAR versions It needs to remember that IAR SDK DLL is compatible according to IAR versions Causes Problem of IAR itself compatibility problem...

Page 83: ...hen select Debugger 2 Press OK button to connect to the Third Party Driver Figure 5 1 Debugger Driver Setting 5 4 2 IAR Third Party Driver Settings 1 Select Options then select Debugger Finally select...

Page 84: ...IAR 8051 GUI Compiler and Debugger E OCD II Debugger User s Manual 84 Figure 5 2 Third Party Driver Setting...

Page 85: ...D OCD II E OCD II debugger For each debugger select POR Power on Reset for the series to which a target device belongs Figure 5 3 OCD Target Series If the target is turned off a message box is display...

Page 86: ...get is detected normally a Hex File is downloaded into the Flash of the target If a target device has options After downloading a Hex file the corresponding option dialog for the device is displayed E...

Page 87: ...ber of Breakpoints is limited Figure 5 7 IAR Debugger After downloading a Hex file it displays the number limit of the Breakpoints 1 ABOV s devices limit the number of built in Breakpoints The number...

Page 88: ...plays a warning message if a developer sets a larger number than the number of available Breakpoints on the device Breakpoint settings made after the warning message are ignored Only by reducing the s...

Page 89: ...ded Workbench 1 Some of SDK DLL are not compatible if their Embedded Workbenches have different versions 2 As of 2019 ABOV supports the version 8 0 and 8 1 of Embedded Workbench 3 Check the IAR versio...

Page 90: ...is designed to prevent power collision between the Host PC and target hardware The operating voltage ranges between 2 8 5 5 V This is slightly higher than the regular OCD OCD II interfaces The rest ar...

Page 91: ...ebugger User s Manual Revision history 91 Revision history Version Date Description 1 0 0 Jun 28 2019 Document created 1 0 1 Sep 29 2020 New Format Document created 1 0 2 Oct 20 2020 Added contents of...

Page 92: ...hall not be responsible or liable for any injuries or damages related to use of ABOV products in such unauthorized applications ABOV and the ABOV logo are trademarks of ABOV All other product or servi...

Reviews: