Introduction Purpose This training module provides an overview of debugging features in H8S Simulator. Objectives Understand how to use the Simulator.

Introduction Purpose This training module provides an overview of debugging features in H8S Simulator. Objectives Understand how to use the Simulator. Explore various debugging features: CPU status, registers, memory, breakpoints, and stepping. Content 21 pages 3 questions Learning Time 35 minutes 1

H8S Simulator What is a simulator? A software development tool that runs on a PC and substitutes for the MCU Represents the MCU architecture and operating instructions Advantages of a simulator Enables debugging when target hardware is not available Helps reduce overall embedded system development time H8S Simulator functions CPU instructions Memory access Register access Complementary HEW features Help make the H8S Simulator more hardware-like Include simulated I/O, Trigger, and TCL toolkit 2

Before Debugging Session Begins 1.Begin Project Generation 2.Select the Target CPU 3.Set the Target System for Debugging Selecting this option automatically generates a simulator session 3

Enter Code Example: Tutorial program with sorting routine is used for simulation /********************************************************/ /* TUTORIAL PROGRAM */ /********************************************************/ #include <machine.h> #include "string.h" #define NAME (short)0 #define AGE (short)1 #define ID (short)2 #define LENGTH 8 const char LED[]={0x12, 0x12, 0x11}; struct namelist { char name[length]; short age; long idcode; }; struct namelist section1[] = { "Naoko", 17, 1234, "Midori", 22, 8888, "Rie", 19, 7777, "Eri", 20, 9999, "Kyoko", 26, 3333, "", 0, 0 }; int count; void sort(); void main(void) { } void sort(list, key) struct namelist list[]; short key; { count = 0; for ( ; ; ){ } short i,j,k; long min; char *name; struct namelist worklist; sort(section1, NAME); count++; sort(section1, AGE); count++; sort(section1, ID); count++; Initialization Main switch(key){ list[j].name; Sort list[j].idcode; } } case NAME : for (i = 0 ; *list[i].name!= 0 ; i++){ name = list[i].name; k = i; for (j = i+1 ; *list[j].name!= 0 ; j++){ if (strcmp(list[j].name, name) < 0){ name = } } worklist = list[i]; list[i] = list[k]; list[k] = worklist; } break; case AGE : for (i = 0 ; list[i].age!= 0 ; i++){ min = list[i].age; k = i; for (j = i+1 ; list[j].age!= 0 ; j++){ if (list[j].age < min){ } k = j; } worklist = list[i]; list[i] = list[k]; list[k] = worklist; } break; case ID : for (i = 0 ; list[i].idcode!= 0 ; i++){ min = list[i].idcode; k = i; for (j = i+1 ; list[j].idcode!= 0 ; j++){ if (list[j].idcode < min){ min = } break; Switch to Simulator session } worklist = list[i]; list[i] = list[k]; list[k] = worklist; } min = list[j].age; k = j; k = j; 4

Basic Debugging View Debug 5

Basic Debugging: View Menu View Debug Display assembly code View CPU registers View memory View peripheral registers View CPU status View simulated I/O View/configure simulated interrupts View/configure labels View/modify variables View/modify local variables 6

Basic Debugging: Debug Menu View Debug Execute code Reset CPU and execute code Execute until PC reaches the cursor position Set PC value and execute Display PC value Step into deeper level Step to the next line Step out to the higher level 7 Download into target

PROPERTIES On passing, 'Finish' button: On failing, 'Finish' button: Allow user to leave quiz: User may view slides after quiz: User may attempt quiz: Goes to Next Slide Goes to Slide After user has completed quiz After passing quiz Unlimited times

Download Module 1. Right click and select Download module to load module into simulator target Download into target 2. After downloading, the Simulator displays starting address for each line of C code 9

View Status 1. Select to view CPU status 2. Status window shows memory and downloaded module information 10

Disassembly 1. Select Disassembly to view corresponding assembly code 2. Right-click on Disassembly and select Set Address to set the starting address 3. Enter 000800 and click OK 11

View Assembly Instructions 4. Disassembly window shows assembly code, starting from address 000800 ( main function) 12

Registers Window 1. Select to open Registers window 2. Register values can be edited directly in the Registers window 13

Watch Window 1. Select to open Watch window 2. Right-click in Watch window and select Add Watch 3. Enter section1 and click OK 4. View values of section1 array in Watch window 14

Examine Memory Content 1. Select to view memory content 2. Enter address of section1 (from Watch window) 3. Memory window appears. (Values of section1 won t be updated until Reset Go is executed) 15

Set and View Breakpoints 1. Right-click on line, then select Toggle Breakpoint 2. Red dot appears 3. Select to open Eventpoint window 4. See all breakpoints in program 16

Execute Program Program Counter stopped at Breakpoint 1. Select Reset Go to begin executing program 2. Execution stops at breakpoint. (Yellow arrow indicates current position of program counter.) 3. Register values are updated in Registers window. (Program counter value corresponds to position marked by yellow arrow in Edit menu.) 18

Content of Memory Window 4. See values of section1 array 19

Stepping Through the Code Three basic levels of stepping: Step In - Takes you deeper into function call - Moves PC to start of sub-function Step Over - Executes current line of source code, including all instructions in sub-function - Moves PC to next line Step Out - Lets you go back to next-higher level of code; i.e., return from the function call HEW also supports flexible stepping, which is accessible from the Step... menu option. 20

Step In Example: 1. Select Step In to go deeper into function call 2. Arrow in Edit window shows program counter position at the beginning of the called function after stepping 3. Registers window updates program counter value If source line does not call a function, a Step-In operation is the same as a Step-Over operation. 21

Step Over Example: 1. Select Step Over to step to the next line 2. Arrow in Edit window shows program counter position after stepping 22 3. Registers window updates program counter value If source line does not call a function, a Step-In operation is the same as a Step-Over operation.

Step Out Example: 1. Select Step Out to go back to next higher level of code Before Step Out 2. Arrow in Edit window shows program counter position at the next line of the calling function after stepping After Step Out 3. Registers window updates program counter value 23

Track Variable in Watch Window 1. Add the variable count to Watch window Breakpoint 2. Step Over to next line Program Counter 3. Value of count is updated in Watch window 24

Course Summary Definition of a simulator Key features of H8S Simulator Using H8S features for debugging Download a free evaluation copy of HEW at: www.renesas.com/hew 26