Renesas E8 manual

REJ10J0768-1000 E8 Emulato r User's Manual R0E000080KCE00E Renesas Microcom p uter Develo p ment Environment S y stem Rev.10.00 Aug. 1, 2007[...]

1. This document is provided for reference purposes only so that Renesas customers may select the appropriate Renesas products for their use. Renesas neither makes warranties or representations with respect to the accuracy or completeness of the information contained in this document nor grants any license to any intellectual property rights or any[...]

Introduction This manual d escribes the fol lowings - E8 Emulat or functions - Preparation before use - Debugger fun c t i ons - Tutorial - Appendi x: (Compone nts of the E8 Emulator, Notes on High-perform ance Embedded Workshop, and Diagnostic Test Pro cedur e) This manual does not intend to explain how to write C/C++ or assem bly language program[...]

Document Conventions This manual uses the following typograp h ic conventions: Table 1 Typograp hic Co nventions Convention Meaning [Menu->Menu Option] Bold text with ‘->’ is us ed to indicate menu options (for example, [File->Save A s...] ). FILENAME.C Uppercase names are used to indicate file n ames. “enter this string ” Used to [...]

IMPORTANT READ FIRST Before usin g this prod uct, be sure t o read th e user’s m anual (this user' s manual) care fully. Keep this use r’s manual , and refer t o this when y ou have qu estions about t his prod uct. Emulator: The emul ator in this document refers to t he followin g products t hat are m anufactured by Renesas Technology C or[...]

Usage r estrictio ns: This emulat or has been de veloped as a means of support ing system development by users. Therefore, do not use it as a devi ce used for equi pment-em bedded appl ications. Als o, do not use it for developi ng t he system s or equipment use d fo r the foll o wi n g pu r pose s either: (1) Transport ation a nd vehicu lar (2) Me[...]

Precautions for Safety READ FIRST Before usin g this prod uct, be sure t o read th e user’s m anual (this user' s manual) care fully. Keep this use r’s manual , and refer t o this when y ou have qu estions about t his prod uct.[...]

DEFINITION OF SIGNAL WORDS Be sure to rea d and unde rstand the wa rnings bel o w before using this em ulator. Note that these are the main warnings, not the complete list. This is the safety alert symbol. It is used to alert y ou to potential personal injury hazards. Obey all safety messages that follow this symbol to avoid possible injury or deat[...]

W ARNING 1. Do not repair or rem odel the emulator product by yourself for electric s hock prevention and quality assurance. 2. Always switch OFF the host computer and user system before connecting or disc onnecting any CABLES or PARTS. Failure to do so will result in a FIRE HAZARD and w ill damage the user system and the emulator product or will r[...]

[...]

Contents Contents 1 Section 1 Overview ........................................................................................... 1 1.1 Warnings ........................................................................................................................... 3 1.2 Environmental Conditions .................................................[...]

5.1.1 Ope ning the [ Configurati on] Dialog B ox ............................................................ 71 5.1.2 [Ge neral] Page ..................................................................................................... 72 5.2 Downloading a Program ....................................................................................[...]

5.6 Using the Start/Stop Function ................................................................................................ 89 5.6.1 Ope ning the [Sta rt / St op Fu nct ion Setting] Di al og B o x ........................................ 89 5.6.2 Specifying the Routine to be Executed ..........................................................[...]

E.1. System Setup to Execute the Check Program ................................................................... 143 E.2. Executing the Check Program ........................................................................................... 143 E.3 When an Error Oc curs ............................................................................[...]

[...]

[...]

Section 1 Overview The High-performance Embedde d Work shop is a Graphical User Interface in tended to ease the development and debugg ing of applications written in C/C++ programming langu age and assembly language for Renesas m icrocomputers. It s aim is to provide a powerful yet intuitive way of accessing, observing and m odifyi ng the debuggi n[...]

The emulator h as three activation m odes: (1) A mode in which the em ulator pr ogram is st arted after it has been d ownloaded to the t arget device: This mode is used when there is no emulator program in the flash memory of the target device. (2) A mode in which the emulator program i s started with out downloa ding it t o the target de vice: Thi[...]

1.1 Warnings CA UTION READ the following wa rnings before using the emulator product. Incorrect operation will damage the user system and the emulator product. The USER PROGRAM will be LOST. (1) Check all com ponents agains t the compone nt list provide d at the side of the com ponent box after unpac king the em ulator. (2) Never place heavy object[...]

1.2 Environmental Conditions CA UTION Observe the conditions listed in tables 1.1 and 1.2 when using the emulator. Failure to do so will cause illegal operation in the user system, the emulator product, and the user program. Table 1.1 Environment al Co ndi ti ons Item Specifications Temperature Operatin g: +10°C to +35°C Storage: –10°C to +50?[...]

1.3 Components Check all the c omponents unpacking. For detai ls on the E8 em ulator c omponents, refer to t he component list provide d at the side of the com ponent box. If the com ponents are not complet e, contact our E-m ail address for user re gistration or refer to the web site. 5[...]

6[...]

Section 2 E8 Emulat or Functions This section de scribes the em ulator functi ons. They di ffer accordin g to the de vice supported by the emulator. 2.1 Overview Table 2.1 gi ves a functional overview o f the em ulator. Table 2.1 Emulator Functi ons No. Item Function 1 User program execution function • Executes a program with the operating freq u[...]

Table 2.1 Emulator Functi ons (cont) No. Item Function 5 Memory access function • Downloading to RAM • Downloading to flash memory • Single-line assembly • Reverse assembly (disassembly) • Reading of memory • Writing to memory • Automatic updating of a display of selected variables during user program execution • FILL • Search •[...]

2.2 Trace Functions The branch so urce addresses, m nemonics, operan ds, an d source lines are displayed. Si nce this function uses the trace buffer built into th e device, a realtime trace can be acquired. Note: The MCUs wh ich have no t race function ca nnot use this func tion. 9[...]

2.3 Break Functions The E8 emulat or has the fol lowing four break functi ons. (1) Hardware break function H8 R8C series Uses a break cont roller incorporated in the device. The access address, instruction fetch address, data, or bus cycle condition can be set. This functio n can also be set from t he [Event] column in the [Source] window. For t he[...]

2.4 Memory Access Functions The emulator has the following m emory access functions. (1) Me mory read/write function [Memory] window: The memory contents are di splayed in the window . Only th e amount specified when the [Mem ory] window is opened can be read. If the memory is written in the [Mem ory] window, a read in the range displayed in the [M[...]

(6) Other m emory ope ration fu nctions Other functions are as follows: • Memory fill • Memory copy • Memory save • Memory ve rify • Memory search • Internal I/O display • Displaying l abel and va riable nam es and their cont ents Notes: 1. Memory access duri ng user program executi on: When memory is accesse d from the memory wind ow[...]

Section 3 Preparation before Us e 3.1 Emulator Preparation Unpack the em ulator and pre pare it for use as follows: W ARNING READ the reference sections shaded in Figure 3.1 before using the emulator product. In correct operation will damage the user system and the emulator product. The USER PROGRAM will be LOST. Unpack th e em ulator Check the co [...]

14[...]

3.2 Emulator Hardware Configuration As shown i n Figure 3. 2, the em ulator consist s of an em ulator, a USB cable, and a use r system interface cable. The em ulator is c onnected to the host com puter vi a USB 1.1, an d also to the USB port con forming t o USB 2.0. Figure 3.2 Emulator Har d ware Configurati on 15[...]

The names of e ach section of t h e emulator are explained next. Emulator Upper-side Panel: (a) (b) (c) (d) (e) Figure 3.3 Emulator Uppe r-side Panel (a) E8 logo pl ate: A pink plat e dedicated fo r the em ulator is pr ovided to be easily distinguishe d from ot her E-series em ulators. (b) Sliding switch cove r: A cover t o protect a switc h for se[...]

Emulator Host-si de Panel: (a) Figure 3.4 Emulator Host- s ide Panel (a) Host-side co nnector: A USB connec tor for t he host com puter. Be sure to connect t he provided USB cable. Emulator User-si de Panel: (a) Figure 3.5 Emulator User- si de Panel (a) User-side connector: A user sy stem interface cable is connected. 17[...]

Emulator B ottom Panel: (a) Figure 3.6 E mulator Bott om Panel (a) Seal for product management: The serial number, revision, and safety stan dar d, etc. of the emulator are written to. Th e contents differ depending on the time when y ou purchase d the pro duct. 18[...]

3.3 Emulator Software Configuration The following item is included with the emulator debug ger when it is purchased: • E8 Emulator Debugger: R0E000080KCE00 SR (CD) 3.3.1 C D Install the software as instructed by t he displaye d messages by inserting the included CD into the CD-ROM drive. The folders contain th e files and programs listed below. T[...]

3.4 Installing Emulator’s Debugger When the CD i s inserted in the host com pute r’s CD drive, execute Setup.exe from the root directory of the CD. 20[...]

3.5 Connecting the Emulator to the Host Computer This section describes how to co nnect the emulator to the host computer. For the position of each connector of th e emulator, re fer to section 3.2, Em ulator Hardware Configurat ion. Notes: 1. When [Add New Hardware Wi zard] is di spl a y e d, select the [Searc h for the best driver for your device[...]

The emulator is connected t o the host computer via t he USB 1.1, and also to t he USB po rt conformi ng to USB 2.0. Figure 3.7 shows the syst em configu ration. Figure 3.7 S ystem Configur ation when Connecting the Emulator to t he Host Comp uter 22[...]

3.6 Connecting the Emulator to the User System Use the procedure bel ow to connect the emulator to the user system with the user system interface cable, or to disconnect t hem when m ovi ng the emulator or the user system. 1. Check that the host com puter is turned off or the emulator is not connected to the host computer with the USB cable. 2. Con[...]

(2) Th e pin assignments of the connector are shown in section 2 in th e add itional documents, Notes on Connecting the xxxxx. Figure 3.9 Connecting the User Sys t em I nterface Cabl e to the User System Notes: 1. To connect t he signals out put from the connector, refer to th e MCU pin ali gnment. 2. To remove the user system interface cable from [...]

3.7 Connecting System Ground W ARNING Separate the frame ground from the signal ground at the user system. Failure to do so will result in a FIRE HAZARD and will damage the user system and the emulator product or will result in PERSONAL INJURY. The emulator's signal ground is co nnected to the user system's si gnal ground. In the emulator[...]

3.8 System Check When the soft ware is executed, use the procedure below to check that the emulator is connected correctly. Here, use the works pace for a tutorial provided on the product. Refer to section 4, Preparations for Debugging, for the other activating method to create a new project or use a workspace for the High-perform ance Em bedde d W[...]

When the [Open workspace] dialog box is ope ned, specify the following directory: <OS installation directory> WorkSpaceTutorialE8xxxxTutorial After the directory has been specified, select th e following file and click the [Open] button. Figure 3.12 [ Open Workspace] Dialog B ox Note: The directory f or a tutorial di ffers de pending o n[...]

6. The [Select Emul ator mode] di alog box is displayed . Figure 3.13 [Emulator Setting] Dialog Box Select the devi ce name in use from the [MC U Group] drop-do wn list box. Note: The [MCU Group] drop-down list box is no t displayed in the H8/Tiny or H8/Super Low Power series. Select the device nam e in use from the [Device] drop-down list box. The[...]

⎯ Program Flash This mode is used when t he emulat or is used as a flash mem ory programm er. It cannot be used for debugging prog rams. Register the l oad module i n the workspace to downloa d it. Note: It is necessary to input the ID code of th e flash m emory by the target device. For details, refer to the additional docu ment, Notes on Conn e[...]

7. The [Connecti ng] dialog box is displa yed and the emulator connection is s tarted. Figure 3.14 [Connecting] Di al o g Bo x 8. When the version of the E 8 firm ware downloaded into the emul ator is old, the message bo x shown in Figure 3.15 will be displayed. Figure 3.15 Dialog Bo x for conf irming the E8 firmware download Note: When [OK] button[...]

9. When [P ower supply is carrie d out. (MAX 300mA)] is not checke d, the dial og box sho wn in Figure 3.17 will be d isplayed. Figure 3.16 Dialog Box of the P ower- on Request Message 10. The dialog box for confirming the power supply status of the user system will b e disp layed. Figure 3.17 [Power Suppl y] Dialog Box When [Power supply is carrie[...]

11. When [Power suppl y is carrie d out. (M AX 300mA)] is not checke d, powe r on the use r system and click the [OK] button. 12. When "C onnected" is displayed in the [Output ] window of t he High-perf ormance Embedded Workshop, the emulator initiation is completed Figure 3.18 High-perform an ce Em bedded Workshop Window Note: When the u[...]

Notes: 1. If the user system interface cable is disconne cted from the connector on the use r system, the following dialog box will appear. Figure 3.19 [ Connector dis connected] Di alog Box 2. If the emulator is not properly initialized, one of the d ialog boxes shown in figures 3.20 through 3.24 will app ear. (a) The following dialo g box is disp[...]

(c) The following dialog box is displayed when an incorrect ID cod e has been inpu t. For the H8/Tiny, H8/ Su p er Low Power, R8C/10, 11, 12 and 13, if an ID code do es not match, the flash memory will be completely erased. Figure 3.22 [ID code error !] Dialog Box (d) The following dialog box is displayed when the MCU cannot comm unicate with the e[...]

3.9 Uninstalling the Emulator’s Debugger Follow this procedure to remove the installed emul ator’s debug ger from the use r’s host c omputer. As the installed product is known by the High-perfo rmance Embedde d Workshop, uninstall the product on the High-perfor mance Embedded Work shop screen. 1. Activate the High-perform ance Embedde d Works[...]

Click the [+] mark at the left of [De bugger C omponents] in the [Re gistered c omponent s] list box to list the installe d components . Then, highl ight the p roduct nam e to be uni nstalled. Figure 3.27 Highlighti n g the Produc t to be Uninstalle d Click the [Unregister] button . After the following message box is displayed , click the [Yes] but[...]

Figure 3.29 [Uninstall HE W Tool] Di alog Box Click the [St art] butto n to list t he installed co mponents. Figure 3.30 Highlighti n g the Produc t to be Uninstalle d 37[...]

Highlight the product name to b e unin stalled and click the [Uninstall] butto n. Th is is the end of uninstall ation. CA UTION A shared file may be detected while the program is being removed. If another product may be using the shared file, do not remove the file. If anothe r product does not start up after the removal process, re-install that pr[...]

Section 4 Preparations f or Debugging 4.1 Method for Activating High-pe rformance Embedded Workshop To activate the High-perform ance Embedded Wo rkshop, follow th e procedure listed below. 1. Connect the emulator to th e host computer and the user system , then turn on the user system . 2. Select [Renesa s] -> [High-pe rformance Em bedded Works[...]

4.1.1 Creating the New Work space (Toolchain Not Used) 1. In the [ Welcome!] di alog box that i s di splayed when the High -p erformance Embedded Workshop is activated, select [Create a ne w project worksp ace] radio button and click the [OK] button. Figure 4.2 [Welcome!] Dial o g Box 2. The Project Generat or is start ed. This section om its the d[...]

Figure 4.3 [New Project Works pace ] Dialog Box [Workspace Name] edit box: Enter the ne w workspace na me. Here, enter ‘test’. [Project Name] edit box: Enter the project name . When the project name is the same as the workspace name, it needs not be entered. [CPU family] drop-down list box: Select the target CPU family. M32C: Select [M16C/80, M[...]

3. The follow ing dialog box is displayed. Figure 4.4 [ Setting the T arget System for Debuggin g] Dialog B ox Select the target system for debugging and click th e [Next] button. [Target system f or debugging ] [Target MCU] M32C E8 SYSTEM : M32C M16C E8 SYSTEM : M16C R8C E8 SYSTEM: R8C/Tiny H8 Tiny/S uper Low Po wer E8 SYS TEM 300H: H8/300H Ti ny,[...]

Figure 4.5 [Setting the Deb ug ger Opti ons] Dialog Box This is the end of the emulator setting. Click the [Finish] button to ex it the Project Generator. The High-performance Embedded Workshop is activated. 5. After the High-perform ance Em bedded Worksh op has been act ivated, the em ulator is automatically connected. For operation during co nn e[...]

4.1.2 Creating the New Wo rkspace (Toolchain Used) 1. In the [Welcome!] dialog box that is disp layed when the High-p erfo rmance Embedded Workshop is activated, select [Create a ne w project worksp ace] radio button and click the [OK] button. Figure 4.6 [Welcome!] Dial o g Box 2. The Project Generator is started. If you have purchased the toolchai[...]

Figure 4.7 [New Project Works pace ] Dialog Box 45[...]

[Workspace Name] edit box: Enter the ne w workspace na me. Here, enter ‘test’. [Project Name] edit box: Enter the project name. When the project name is the same as the workspace nam e, it needs not be entered. [CPU family] drop-down list box: Select the target CPU family. [Tool chain] drop-down li st box: Select the target toolchain name whe n[...]

3. Make the required sett ing for the t oolchain. Figure 4.8 [ New Project-1/ 6-Select Target CP U. Toolch ain version] D ialog Box Select your toolchain vers ion, CPU series and click the [Next] button. 47[...]

4. Make the required sett ings for t he RTOS. Figure 4.9 [ New Project-2/ 6-Select RTOS] Dialog Bo x Select the RTOS you use, type of star tup file and click the [Next] button. Note: In the H8/Tiny or H8/Sup er Low Power se ries this dialog box will not be displayed. 48[...]

5. Make the required settings for the heap area etc. Figure 4.10 [ New Project- 3/6-Settin g the Contents of Files to be Generated] Di alog Box Set the heap size etc. and click the [Next] button. Note: In the H8/Tiny, H8 / Super Low Power series, the content of the dialog box will differ. 49[...]

6. Make the re quired sett ing for the stac k area. Figure 4.11 [New Project-4 / 6-Se tting the Stack Are a] Di al og Box Set the stack size and click th e [Next] button. 50[...]

7. When the t ool chain set tings have bee n complete d, the foll owing dialo g box is di splayed. Figure 4.12 [ New Project- 5/6-Settin g th e Target System for Debugging] Dialog Box Select the target system for debugging and click th e [Next] button. [Target system f or debugging ] [Target MCU] M32C E8 S YSTEM: M32C M16C E8 S YSTEM: M16C R8C E8 S[...]

8. Set a configuration file name. The configuration file saves the settings of the High-perfor mance Embedded Worksh op except for the emulator. Figure 4.13 [ New Project- 6/7-Settin g the Debugger Opt ions] Dialo g Box 52[...]

9. Finally, confirm the file name you create. Figure 4.14 [ New Project- 7/7-Chan ging the File N ames to be Create d] Dialog B ox The files which will be generated by the High-performance Embedded Workshop are displayed If you want to change the file name, select and click it then enter the new name. This is the end of the emulator settings. Exit [...]

10. After the High-pe rformance Em bedded Works hop has bee n activated, co nnect the emul ator. However, it is not needed to co nnect the em ulator immediately afte r the High-perform ance Embedded Works h op has bee n activated. To connect t he emulat or, use one o f the metho ds (a) and (b) below. For operatio n during connection, refer to secti[...]

(b) Co nnecting the emulator withou t the setting at emulator activation The emulator c an be easily co nnected by swi tching the sessi on file that t he setting f or the emulator use h as been regi st e red. Figure 4.15 Selecting the Session File In the list box that is circled in Figure 4.15, se lect the session file name including the character [...]

4.1.3 Selecting an Existing Workspace 1. In the [ Welcome!] di alog box that i s di splayed when the High -p erformance Embedded Workshop is activated, select [Browse to anot her project works pace] radio button and cl ick the [OK] button. Figure 4.16 [Welcome!] Dialog Box 56[...]

2. The [Open Workspace] di alog box is displayed. Select a di rectory in which you have c reated a workspace. After that, select the workspace file (.hws) and press the [Open] button. Figure 4.17 [ Open Workspace] Dialog B ox 3. This activates the High-performance Embedde d Workshop and recovers the state of the selected workspace at the time it wa[...]

4.2 Setting at E8 Emulator Activation 4.2.1 Setting a t Em ul at or Activati on When the emulator is activate d, the command chai n can be automatically executed. It is also possible to register m ultiple load modules to be downloaded. The registere d load modules are displayed on the workspace window. 1. Select [Deb ug Settings…] from the [Debug[...]

Figure 4.19 [Debug Setting s] Di al o g B o x ([O pti ons] Page) xecute d at the specified timi ng is registered. T he following three timings can be specified: • Immediatel y after downloadi ng in file that is executed at the s pecified timing in t he [Comm and Line Bat ch Processi ng] list b ox. The command chain that is a utomatically e • At[...]

4.2.2 Downloading a Program A downloa d module is added un der [Dow nload m odules] in the [Workspac e] windo w. Open the load m odule of [Download m odules] in the [Workspace] window by clicking the right- hand mouse button and select [Downl oad modul e] to start downloadin g the m odule. Figure 4.20 Download Me nu of the [Workspace] Window ([Pr o[...]

4.2.3 Settin g the Wri ting Flash Memory Mode The followin g describes the procedures w hen the emul ator is used as the programm ing tool. T he load module to be download e d to the new workspace is registered and programmed. (a) Select the new project worksp ace. Figure 4.21 [New Project Work sp ace] D i al og Box 61[...]

(b) Select the target MCU an d click the [Next] bu tton. Figure 4.22 [Setting the Target System for Debuggin g] Dialog B ox 62[...]

(c) Set a configuration file name and click the [Finish ] button. Figure 4.23 [Setting he Debug ger Op tions] Dialog Bo x 63[...]

(d) Th e [Emulator Setting] dialog box is displayed. Figure 4.24 [ Select Emulat or mode] Dial og Box Select the [Program Flash] mode. When the [Power Target from Emulator. (MAX 300mA)] check box is selected, power will be supplied to t he user system up to 300 m A. Then select 3.3 V or 5. 0 V accordin g to the power voltage of t he user system . 6[...]

(e) When [Power supply is ca rri e d out. (MAX 300m A)] is not checke d, the di al og b ox shown in Figure 4.25 will be displayed. Figure 4.25 Dialog Box of Pow er- on request message When [Po wer supply is ca rried out . (MAX 3 00mA)] is not checked, t urn on the power to the user system. (f) Enter the ID code printed on the flash m em ory. Figure[...]

(g) Select [Debug Setting… ] from th e [Debug] menu. Figure 4.27 High-perform an ce Em bedded Workshop Window 66[...]

(h) Select the target MCU an d then the d ownload m odule with the [Add…] bu tton. Figure 4.28 [Debug Setting] Dialog Box ([Target] Page) (i) The down load file is disp layed on [Proj ect Files]. Figure 4.29 [Workspace] Window ([Pro ject Files]) 67[...]

(j) Select and do wnload the file wit h the right- hand mouse button. Figure 4.30 Download Me nu of the [Wo r ksp ace] Win dow ([Pr oject Files]) (k) The dialog box for sum checking is displayed and writin g is completed. Figure 4.31 Message for Comple ti on of Flash Memory Writing 68[...]

(l) When the following dialog box is displaye d, close and restart or exit the workspace. Figure 4.32 Message for Restarting or Exiting Wri ting Flash Me mory Mod 69[...]

70[...]

Section 5 Debugging This section de scribes the de bugging operat ions and t heir related wi ndows and di alog boxes. F or details on the comm on functions of the High -performa nce Embedded Wor kshop pro ducts, refer t o the High-performance Em bedded Workshop User ’s Ma n ual. 5.1 Setting the Environment for Emulation 5.1.1 Opening the [ Co n f[...]

5.1.2 [Gener al] Page Sets the emulator operation conditions. Figure 5.1 [ Configur ation] Dial og Box ( [General] Page ) Items that can be displayed in the sheet are listed below. [Device] com bo box Displays the MCU nam e. [Emulati on mode] combo box Selects the emulat ion mode at user program execution. Select Norm al to perform norma l emulati [...]

[Flash m emory synchr onization] combo box Selects whether or not the cont ents of the flash mem ory are acquired by t he emulat or when the u ser program is stopped or the position where the PC break is set is put back as the original c ode. When the flash memory is not progr a mmed by the user program, it s contents nee d not be acq uired by the [...]

5.2 Downloading a Program This section de scribes how t o download a program and view it as s ource code or assembly- language m nemonics. Note: After a break has been detected, the Hi gh-performance Em bedded Works hop displa ys the location of the program counter (PC). In most cases, for example if an Elf/ Dwarf2-base d project is moved from its [...]

5.2.2 Viewing the Source Code Select a source file name in the [Workspace] wi ndow and click [Open] in the popup menu to make the High-performance Embedded Work shop display the source file in the editor. It is also possible to display your source files by double-clicking on their na mes in the [Workspace] window. Figure 5.2 [ Source] Windo w 75[...]

In this window, the following items are shown on the left as line information. The first colum n (Line Number colum n) Line number The second colum n (Source addr ess column): Address information The third column (Event column): Event information (break cond ition) The fourth c olumn (S/ W Breakpoint s column): PC, bookm ark, and break point inform[...]

To switch off a column in all source files 1. Click t he right-han d mouse bu tton on the [Source] wi ndow or select the [Edit] menu. 2. Click the [Define Column Format…] menu ite m. 3. The [Global Edi t or Colum n States] dialog box is displayed. 4. A check box indicates whether the col umn is enabled or not. If it is checked, the column is enab[...]

5.3 Stopping Your Program This section de scribes how y ou can halt exec utio n of your application's code. This section describes how to stop the pr ogram by sett ing an address match breakp oints at specific l ocations i n your code. 5.3.1 Address Inter rupt Breakpoints When you are trying to debug your program you will want to be able to st[...]

5.4 Using the Event Points The emulator has the event p oint functio n that per forms breaki ng by specify ing higher-lev el conditions along with the PC br eakpoints standard for the Hig h-p erformance Embedded Workshop. 5.4.1 PC B reakpoin ts When the inst ruction of the s pecified addres s is fetched, t he user pro gram is stopped. Up to 255 poi[...]

This window displays and sets the breakpoints. It ems that can be displayed in the sheet a re listed below. [Type] Breakpoint [State] Whether the breakpoint is en ab led or disabled [Condition] An address that the breakpoint is set Address = Program counter (Cor responding file name, l ine, and sym bol name) [Action] Operati on of th e emulator whe[...]

5.4.11 Go to Source Only enabled whe n one breakpoi nt is selected. Opens the [ Source ] window at the address of the breakpoint . 5.4.12 [Set Break] Di alog Box Figure 5.6 [ Set Break] Di alog Box This dialog box specifies break conditions. A breakpoint a ddress to be set is speci fied in the [Address] edit box. Up to 255 breakpoints can be specif[...]

Notes on Se tting the [Se t Break] Dialog B ox 1. When an odd ad dress is set for the H8/Tiny and H8/ Super Low Power series, the address is rounded d own to an eve n address. 2. A Breakpoint is accom plished by replacing instructions. Accordingly, it can be set only to the flash mem ory or RAM area. However, a so ftware break ca nnot be set t o th[...]

Notes on Setting the Break Condition: 1. When [ Go to cursor] , [Step In] , [Step Over] , or [Step Out] is sel ected, the setti ngs of Break Condition 1 are disab led . 2. Setting of Break Condition 1 is d isabled when an instruction to wh ich a BREAKPOINT has been set is executed. 3. When step over function is used, the settings of BREAKPOINT and [...]

5.4.16 Disa ble Disables the selected break cha nnel(s). When a break channel is disabled, a break will not occur even if specified cond itio ns have been satisfied. 5.4.17 Dele te Initializes the condition of the selected break channel. To retain the details of the break chann el but not have i t cause a break when its c onditions are met, use t h[...]

5.4.25 Deleti ng Break Con ditions Select a break condition and choose [Delete] from the popup menu to remove the selected break condition. To retain the br eak condition but not have it cau se an event when its co nditions are met, use the [Disa ble] option (see section 5. 4.24, Disabl ing Break C onditions ). 5.4.26 Deletin g Al l Break Condi tio[...]

The [Address] group box sets address bus con d itions. Option Description [Don’t care] check box Does not set address conditions. [Address] radio button Sets the use of the normal address bus as break conditions. [Only program fetched address after] radio button Sets a break after prefetched address e xecution as break conditions. [Address] edit [...]

5.5 Viewing the Trace Information For the descri ption on the t race functio n, refer to section 2. 2, Trace F unctions. Note: The R8C/Tiny series MCUs d o not have trac e functions. 5.5.1 Openin g the [Trace] Window To open the [Trace] windo w, choose [View -> Code -> Trace] or click the [Trace] tool bar button ( ). 5.5.2 Acquiring Trace Inf[...]

5.5.3 Clearing the Trace Information When [Clear] is selected from the popup m enu, the trace buffer that stores the trace inform ation becomes empty. If se veral [Trace] windows are ope n, all [Trace] windows will be cleared as they all access the same buffer. 5.5.4 Saving the Trace Inf ormation in a File Select [Save...] from the popup m enu to o[...]

5.6 Using the Start/Stop Function The emulator executes the s pecifie d routine of the user program im mediately bef ore starting a nd immediately after halting program execution . This function is used to contro l th e user system in synchronization with execution and haltin g of the user p rogram. Note: The start/sto p function is not suppo rted [...]

If no specified routine is exec ut ed immedi atel y before st art i ng use r pr o gra m execution, do not select the [The specified routine is executed i mmediat ely before executio n of the use r’s program .] check box. When the [The specified routine is executed immediately after th e stop of the user’s program .] check box is selected, the r[...]

5.6.3 Restric tions on the S tart/Stop Func tion The start/st op function has the fol lowing rest rictions. • Do not change the SFR used by the firmware. • When the watchdog timer is used, refresh the watchdog ti mer in the specified routine. • Do not set any breakpoints in the specified routine. • When a s tack is u sed in th e specifie d [...]

92[...]

Section 6 Tutorial 6.1 Introduction This section de scribes the m ain functio ns of the emul ator by using a tutorial pr ogram. The tutorial pr ogram is based on the C pr ogram that sort s ten rand om data item s in ascending or descending order. Th e tutorial program performs the fo llowing actions: • The main functi on generates random data to [...]

6.2 Running the High-performance Embedded Workshop To run the Hig h-performance Em bedded Works hop, refer to section 3.8, System Check. 6.3 Setting up the E8 Emulator This section de scribes the basi c settings of the em ulator. 94[...]

6.4 Setting the [Configuration] Dialog Box • Select [Emulator] then [Systems …] from the [Setup] menu for t he basic settings of t he emulator. T he [Configu ration] dial og box is displayed. Figure 6.1 [Configur ation] Dial o g B o x Note: The items t hat can be set in t his dialog box differ de pending on the prod uct. For t he settings for e[...]

Set options as follows: Table 6.1 [G eneral] Page Opti ons Option Value Device Select a device you use Emulation mode Normal (normal execution, def ault) User interface clock According to the system clock frequency, the maxim um use r interface clock is automatically set. Flash memory synchronizati o n Disable (default) Click the [OK] button to set[...]

6.5 Checking the Operation of RAM Check that RAM is operating correctly. Display and edit the contents of th e memory in th e [Memory] window to check that the memory is operating correctly. Note: The memory can be installed on the board i n som e microcomputers. In t his case, however, the above way of checking t he operation of m emory m ay be in[...]

Figure 6.3 [ Memory] Window • Placing the mouse cursor on a point in th e display of data in the [Memory] window and double-clicking allows the values at that poin t to be changed. Data can also be directly ed ited around the current po sition of the text cursor. 98[...]

6.6 Downloading the Tutorial Program 6.6.1 Dow nloading the Tutorial Pr ogram Download the ob ject pr o gram to be debugged. In this emulator, it is enabled to download the program and set the PC breakpoint in the internal flash mem ory area. For the m ethod to set the PC breakpoi nt, refer to sect ion 6.16.1 , PC Break Function. • Select [Downl [...]

6.6.2 Displaying the Source Program The High-performance Embedde d Workshop allows the user to debug a user program at the source level. • Double-click [tutorial.c] under [C source file]. Figure 6.5 [Source] Window (Displaying the Source Program ) Select the [Display] option from the [Setup] m enu to set a font a nd size that are legible, i f nec[...]

6.7 Setting a PC Breakpoint A PC breakpoint is a simple debugging function. The [Source] window provid es a very sim ple way of sett ing a PC brea kpoint at any point in a program. For e xample, to set a PC breakp oint at the sort function call: • Select by double-clicking the [S/W Breakp oints] column on the line containing the sort function cal[...]

6.8 Setting Registers Set values of t he program counter and the st ack pointer before execut ing the pro gram. • Select [Registe rs] from t he [CPU] subm enu of the [View] menu. The [Register] window is displayed. Figure 6.7 [ Register] Win dow 102[...]

z To change the value of the pro gram counter (PC), double-click th e value area in the [Register] window wit h the m ouse. The foll owing dialo g box is t hen display ed, and the value can be changed. Set the prog ram counter to 0E612 in this t utorial pr ogram, and cli ck the [OK] button. Figure 6.8 [ Register] Di alog Box (P C) 103[...]

6.9 Executing the Program Execute the pr ogram as described i n the followi ng: • To execute the program , select [Go] from the [Debug] menu, or click the [Go] button on the toolbar. Figure 6.9 [ Go] Button When the program execution is started, ‘**RUNNING’ is displayed on the status bar. The program will be executed up to the break point tha[...]

Figure 6.10 [Source] Window (Bre ak St a te) 105[...]

The user can see the ca use of the break t hat occurred last time in the [Status] window. • Select [Status] from the [CPU ] submenu o f th e [View] m enu. After the [Status] window is displayed, open the [Platform] sheet, an d check the Status of Cause of last break . Figure 6.11 [Status] Windo w Note: The items that can be set in this window d i[...]

6.10 Reviewing Breakpoints The user can s ee all the break points set in t he program i n the [Eventpoi nt] window. • Select [Eventp oints] from the [Code] subm enu of t he [View] m enu. The [Eve ntpoint] w indow is displayed. Select the [Breakpoin t] sheet. Figure 6.12 [Eventpoint] Window The popup menu, ope ned by cli c ki ng t he [E ventpoint [...]

6.11 Viewing Memory When the label nam e is specified, the user can vi ew the m emory contents that the label has been registered in the [Memory] win dow. For e xample, t o view the mem ory contents c orrespondi ng to _ main in word size: • Select [Mem ory …] from the [CPU] subm enu of the [View] m enu, enter _main in the [Display Address] edit[...]

6.12 Watching Variables As the user steps through a program, it is possible to watch that the values of variables used in the user program are changed. For exampl e, set a watch on the long-typ e array a declared at the beginning of the pro gram, by usin g the follo wing proce dure: • Click the left of displayed array a in the [Sou rce] window to[...]

The user can al so add a variab le to th e [Watch] window by specifying its name. • Click the [Wat ch] windo w with the right -hand m ouse button an d select [Add Wat ch…] from the popup menu. The following dialog box will be displayed. En ter variable i . Figure 6.17 [Add Watch] Dialog Bo x • Click the [OK] button. The [Watch] window will no[...]

The user can cl ick mark ‘+’ at the left side of array a in the [Watch] window to watch all the elements. Figure 6.19 [ Watch] Window (Displaying Array Elements) 111[...]

6.13 Stepping Through a Program The High-perf ormance Embedde d Worksho p provides a ra nge of step m enu commands t hat allow efficient progra m debugging. Table 6.2 Step Option Menu Command Description Step In Executes each statement, incl uding stateme nts within functions. Step Over Executes a function call in a single ste p. Step Out Steps out[...]

6.13.2 Executing [Step Out] Command The [Step Out] command steps out of t he called fu nction and stops at the next statement of the calling statement in the main function . • To step out of the sort function, select [Step Out] from the [Debug] menu, or click the [Step Out] button on the toolbar. Note: It takes time to execu te th is function. Wh[...]

6.13.3 E xecuting [Step O ver] Com mand The [Step Over] command executes a function call as a si ngle step an d stop s at the next statem ent of the main program. • To step through all statements in the change function at a single st ep, select [Step Over] from the [Debug] menu, or click the [Step Over] bu tton on the toolbar. Figure 6.24 [Step O[...]

6.14 Forced Breaking of Program Executions The High-performance Embedde d Workshop can for ce a break in t he exec ution of a program. • Cancel all breaks. • To execute the rem aining sections of the main f unction, select [G o] from t he [Debug] m enu or the [Go] but t on o n the toolbar. Figure 6.26 [ Go] Button • The program goes into an e[...]

6.15 Displaying Local Variables The user can display local vari ables in a funct ion using the [Locals] window. For exam ple, we will examine the local variables in the main f unc t i on, w hic h de clares four local varia bl es: a , j , i , and p_sam . • Select [Locals] fr om the [Sym bol] subm enu of the [Vie w] menu. The [Locals] window is dis[...]

6.16 Break Function The emulator has PC and ha rdware break f unctions. With the High -performa nce Embedded Workshop, a PC breakpoi nt can be set using the [Breakpoi nt] sheet of t he [Event] window, and a hardware break condition can be set using the [Breakcondition] sheet. An overview and setting of the br eak fun ction are described below. 6.16[...]

• Click the [Eve nt] wind ow with the right-ha nd mouse b utton and sel ect [Add…] f rom the popup menu. • Enter H'0E1F2 in the [Address] edit box. Figure 6.30 [Set Break] Dialog Box • Click the [OK] button. 118[...]

The PC breakp oint that has been set is di splayed in t he [Eventpoi nt] windo w. Figure 6.31 [Eventpoin t] Window (P C Breakp oint Setting) To stop the t utorial program at the PC brea kpoint, the followin g procedure m ust be executed: • Close the [E ventpoint] window. • Set the program counter value (PC = H’0E6C6) th at was set in section [...]

The [Status] window d isplays the following co ntents. Figure 6.33 Displayed Co nten ts of the [Status] Window (PC Break) Note: The items that can be set in this window d iffer depending on the product. For the settin gs for each pro duct, refer to the online help. 120[...]

6.17 Hardware Break Function A method is gi ven below in which the a ddress bus condition is set under Break Condition 1 as hardware break cond itions. • Select [Eventp oints] from the [Code] subm enu of t he [View] m enu. The [Eve ntpoint] w indow is displayed. • The PC breakp oint that has been pre viously se t is deleted. Click the [Eve ntpo[...]

• The [Break condition 1] dialog box is displayed. • Clear the [Don't care] check bo x in the [Address] group box. • Select the [Only progra m fetch ed address after] radio button and enter H'0E1F2 as the value in the [Address] edit box. Figure 6.35 [condition ] Page ([Break co ndi ti o n 1] Di a l og B o x) Click the [OK] button. T[...]

The program runs and then stops at the condition specified under Break Condition 1. Figure 6.36 [ Source] Wind ow at Execution Stop (Brea k Condition 1 ) The [Status] window d isplays the following co ntents. Figure 6.37 Displayed Co nten ts of th e [Status] Window (Break Conditio n 1) Note: The items that can be set in this window d iffer dependin[...]

6.18 Trace Functions The emulator has a bra nch -instruction trace function. The branch s ource addre sses, mnem onics, operands, source lines, a nd labels are displaye d for four bran ches. Note: The trace function uses the tr a ce buffer housed in the device. Devices which have no trace function ca nnot use this function. 6.18.1 Di splaying t he [...]

6.19 Stack Trace Function The emulator uses the inform ation on the stack to displ ay the nam es of functi ons in the sequence of calls that led to the functio n to which the program counter is curren tly poin ting. Note: This functio n can be use d only whe n the load m odule that has t he IEEE695-ty pe debugging inform ation is load ed. • Doubl[...]

• After the break in program execu tion, select [Stack Trace] fr om the [Code] submenu of t he [View] menu to open the [Sta ck Trace] window. Figure 6.40 [Stack Trace] Window Figure 6.4 0 shows that t he positi on of the prog ram counter is currently at the selected line of the sort() function, and that the sort() function is called from the tuto[...]

6.20 What Next? This tutorial has describe d the m ajor features o f the emulator a nd the use of the High-pe rformance Embedded Works hop. Sophisticated debugging ca n be carried out by using t he emulation functions t hat the emulat or offers. This provides for effectiv e investigation of hardwa re and s oftware problem s by accurately isolating [...]

128[...]

Appendix A Components of the E8 Emulat or Table A.1 lists the components of the R8C E8 em ulator. Table A.1 Components o f the Emulator (R 0E000080KCE00) Classi- fication Component Appearance Quantity Remarks Hard- ware E8 emulator (Model: R0E0000 80KCE00) 1 R0E000080KCE00: Depth: 65 mm, Width: 97 mm, Height: 21 mm, Mass: 60.0 g User system interfa[...]

130[...]

Appendix B Window Functions This section describes the window function s that can be u sed with the High-performance Embedded Works hop for E8 em ulator. Here, the Hig h -pe rforma nce Em bedde d Worksho p common functions are omitted , and only the emulation function s are described. Table B.1 Window Func tions Menu Option Shortcut Toolbar Button [...]

Table B.1 Window Functions (cont) Menu Option Shortcut Toolbar Button Remarks Setup Radix Hexadecimal Uses a hexadecimal for displayi ng a radix in which the num erical values will be displaye d and e ntered by default. Decimal Uses a decimal for displaying a radix in which the num erical values will be displaye d and e ntered by default. Octal Use[...]

Table B.1 Window Functions (cont) Menu Option Shortcut Toolbar Button Remarks Run… Launches the [Run Pro gram] dialog box allowing the user to enter the PC or PC breakpoint during executing the user program. Debug (cont) Display PC Shift + Ctrl + Y Displays the current PC value. Step In F11 Executes a bl o ck of user program before breaking. Step[...]

Table B.1 Window Functions (cont) Menu Option Shortcut Toolbar Button Remarks Download Mod ules Downloads the object program. Unload Mo dules Unlo ads the object program. 134[...]

Appendix C Command-Line Functions The emulator s upports the co mmands that c an be used i n the comma nd-line win dow. For details, refer to the online help. 135[...]

136[...]

Appendix D Notes on High-performan ce Embedded Workshop 1. Note on Moving Source File Position after Creating Load Module When the so urce file is m oved after creat ing the load m odule, the [Ope n] dialog bo x may be displayed to s pecify the sourc e file duri ng the debug ging of the c reated load m odule. Select the correspondin g source fi l e[...]

⎯ Variable updating For updating of th e content of th e variable that has been registered in the [Watch] window, read the data after the break i n user progra m execution. The realtime ope ratio n for the user program is disabled because t he user progra m is tem porarily stop ped. 5. Line Assem bly ⎯ Input ra dix Regardless of the Radix setti[...]

10. Note on [Register] Window Operation During Program Execution The register value cannot be c hanged in th e [Register] window dur ing program executi o n. Even if the c hanged value is displ ayed, the re gister conte nts are not c hanged actuall y. 11 Using R egister Cont ents Use the value cont ained in a C PU regist er by specifyi ng the regis[...]

⎯ MEMORY_F ILL command The [Format] specification in the [Copy Memory ] dialog box is ignor ed. Memory is copied in a byte unit. 17. Note on Using the [Run Pro gram] Di alog Box When [Run...] is selected from the [Debug] menu to specify th e stop add ress, th ere is th e following note: ⎯ When the brea kpoint that ha s been set as Di sabl e is [...]

24 Usage wi th Othe r Products To install the Supe rH™ RISC en gine C/C++ co m piler package or H8, H8/300 series C/C ++ compiler package after installing the em ulat or debugge r fo r Hi g h- per f orm ance Embedded Workshop, sel ect [High-pe rformance Em bedded Wor kshop] as the com ponent t o be instal led in [Select Componen ts] du ring insta[...]

142[...]

Appendix E Diagnost ic Hardware Program This manual d escribes the tro ubleshootin g procedure t hat applies t he check pr ogram for the E 8 emulator. E.1. System Setup to Execute the Check Program (1) The follo wing equipm ents are require d to ex ecute the check program. Do not connect the user system interface cable or the user syst em while the[...]

(2) Click the ‘START’ button appeared on t he window. This starts ex ecution of the check program showing the message ‘RUNNING’ . Figure E.2 Running the Check Program (3) The message ‘FAIL’ or ‘PASS’ will be displa yed. ‘PASS’ indicates that the emulator is working correctly. Click th e ‘QUIT’ b u tton to exit the ch eck pro[...]

E.3 When an Error Occurs (1) If ‘FAIL’ is displayed durin g execution o f the chec k program , a status number is also displayed at the right bottom of the window. (2) Click the ‘LOG’ button to create a lo g file. Figure E.4 ‘ FAIL’ Messag e (3) Send a file ‘SCP_LOG.T XT’ , whi c h has been created in the folder where ‘E8SCP.EXE?[...]

146[...]

E8 Emulator User's Manual Publication Date: Aug. 1, 2004 Aug. 1, 2007 Rev.1.00 Rev.10.00 Published by: Sales Strategic Planning Di v. Renesas Technology Corp . Edited by: Microcomputer Tool Development Department Renesas Solutions Co rp. © 2007. Renesas Technology Corp. and Renesas Solutions Corp., All rights reserved. Printed in Japan.[...]

E8 Emulato r User's Manual[...]