User's Manual Rev. 1.00 2003 REJ10J0063-0100Z Active Microso

The Datasheet Archive - 100 Million Datasheets from 7500 Manufacturers.

User's Manual Rev. 1.00 2003 REJ10J0063-0100Z Active Microso

Datasheet Thumbnail

Top Searches for this datasheet

PDxxSIM
User's Manual
Rev. 1.00 2003 REJ10J0063-0100Z
Active Microsoft, MS-DOS, Visual Basic, Visual C++, Windows Windows either registered trademarks trademarks Microsoft Corporation United States other countries. registered trademarks International Business Machines Corporation. Intel Pentium registered trademarks Intel Corporation. Adobe, Acrobat, Acrobat Reader trademarks Adobe Systems Incorporated. other brand product names trademarks, registered trademarks service marks their respective holders. Keep safety first your circuit designs! Renesas Technology Corporation Renesas Solutions Corporation maximum effort into making semiconductor products better more reliable, there always possibility that trouble occur with them. Trouble with semiconductors lead personal injury, fire property damage. Remember give consideration safety when making your circuit designs, with appropriate measures such placement substitutive, auxiliary circuits, (ii) nonflammable material (iii) prevention against malfunction mishap. Notes regarding these materials These materials intended reference assist customers selection Renesas Technology product best suited customer's application; they convey license under intellectual property rights, other rights, belonging Renesas Technology Corporation, Renesas Solutions Corporation third party. Renesas Technology Corporation Renesas Solutions Corporation assume responsibility damage, infringement third-party's rights, originating product data, diagrams, charts, programs, algorithms, circuit application examples contained these materials. information contained these materials, including product data, diagrams, charts, programs algorithms represents information products time publication these materials, subject change Renesas Technology Corporation Renesas Solutions Corporation without notice product improvements other reasons. therefore recommended that customers contact Renesas Technology Corporation, Renesas Solutions Corporation authorized Renesas Technology product distributor latest product information before purchasing product listed herein. information described here contain technical inaccuracies typographical errors. Renesas Technology Corporation Renesas Solutions Corporation assume responsibility damage, liability, other loss rising from these inaccuracies errors. Please also attention information published Renesas Technology Corporation Renesas Solutions Corporation various means, including Renesas home page (http://www.renesas.com). When using information contained these materials, including product data, diagrams, charts, programs, algorithms, please sure evaluate information total system before making final decision applicability information products. Renesas Technology Corporation Renesas Solutions Corporation assume responsibility damage, liability other loss resulting from information contained herein. Renesas Technology semiconductors designed manufactured device system that used under circumstances which human life potentially stake. Please contact Renesas Technology Corporation, Renesas Solutions Corporation authorized Renesas Technology product distributor when considering product contained herein specific purposes, such apparatus systems transportation, vehicular, medical, aerospace, nuclear, undersea repeater use. prior written approval Renesas Technology Corporation Renesas Solutions Corporation necessary reprint reproduce whole part these materials. these products technologies subject Japanese export control restrictions, they must exported under license from Japanese government cannot imported into country other than approved destination. diversion reexport contrary export control laws regulations Japan and/or country destination prohibited. Please contact Renesas Technology Corporation Renesas Solutions Corporation further details these materials products contained therein.
inquiries about contents this document product, fill text file installer generates following directory email your local distributor. Renesas Tools Homepage http://www.renesas.com/en/tools
Preface
PDxxSIM provided purpose extending functions M3T-PDxxSIM simulator debuggers. Microsoft Visual C++, Windows application development environment available market, needed create DLLs. This user's manual shows basic information necessary PDxxSIM kit. details about language specifications method using Visual C++, refer user's manual included with your product online help.
Supported simulator debuggers
PDxxSIM cannot used M3T-PDxxSIM simulator debuggers. simulator debuggers their versions which conjunction with PDxxSIM kit, refer release notes PDxxSIM which they detailed.
Rights
rights PDxxSIM come under provisions Software License Agreement M3T-PDxxSIM simulator debuggers used. Please also aware that PDxxSIM only used developing your product, cannot used other purpose.
Technical support
Please note that technical support PDxxSIM obtained visiting homepage (URL: http://www.renesas.com/ en/tools which latest information available.
[MEMO]
Contents
Contents
ABSTRACT. ABSTRACT. CONFIGURATION METHOD CREATING DLL. DLL. 3.1. 3.2. METHOD USING IODLLTEMPLATE PROJECT METHOD CREATING DLL.
METHOD USING METHOD DEBUGGING DEBUGGING FUNCTIONS THAT SEND INFORMATION SIMXX.EXE. FUNCTIONS THAT INFORMATION FROM SIMXX.EXE PROGRAM SPECIFYING TARGET PROGRAM SYMBOLS NOTES
Contents
[MEMO]
PDxxSIM
Abstract
means Dynamic Link Library (DLL) that operates conjunction with simulator engine Simulator Debugger PDxxSIM denotes model name such 30). Simulator Debugger when properly load DLL, operate synchronously with timing which program executes instruction, read/writes memory generates interrupt. This allows debug target program simulating operation microcomputer's input/output ports internal peripheral functions. This also makes data input/output other linked operations with external tools possible. desired created using C/C++ languages. Microsoft Visual C++, Windows application development environment available market, needed create DLLs.
Configuration
accesses simulator engine simxx.exe denotes model name such obtain information memory register values, etc. turn, simxx.exe notifies various information including memory read/write information number cycles which program executed each instruction. simulator debugger configured manner shown below.
PDxxSIM
pdxxsim.exe
(Simulator debugger)
Notifies information from simxx.exe. number cycles executed instruction timing resetting information memory. etc.
simxx.exe
(Simulator engine)
(Create) Puts/gets information simxx.exe from DLL. Puts/gets memory value, register value. Interrupt generation, verification interrupt generation conditions. stopping execution target program. etc.
PDxxSIM
Method Creating
This chapter describes create DLLs using Microsoft Visual (hereafter abbreviated VC++). details VC++, VC++ user's manual help. created making sample project "IodllTemplate" which included with newly from scratch. IodllTemplate project VC++ template project provided creating DLLs.
3.1. Method Using IodllTemplate project
following explains create DLLs from IodllTemplate project using PD308SIM example. create DLLs other simulator models, change model name "308" described here with desired model name (e.g., "30" "32R"). Choose "Open Workspace." from File menu VC++. Open project file "IodllTemplate.dsp" IodllTemplate project which stored directory under directory which package installed (hereafter referred Choose "Setting." from Project menu VC++. Check path settings library files sim308.lib IodllExpLib(d).lib which specified "Object/library modules:" column category "General" Link tab. (The file locations must specified using absolute relative paths.) These library files stored "Library" directory settings made Win32 Debug, specify IodllExpLibd.lib.
settings made Win32 Release, specify IodllExpLib.lib.
Choose "Setting." from Project menu VC++. Change filename "IodllTemplate.dll" which specified "Output file name:" column category "General" Link another filename want (extension ".dll") that output destination directory which installed PD308SIM (hereafter referred
Open then write code simulation. implemented functions called from sim308.exe. function that accesses sim308.exe desired function write code simulation.
When build, (sample.dll) created under directory
PDxxSIM
3.2. Method Creating
create without using IodllTemplate project, follow procedure described below. Choose "New." from File menu VC++. Then create project with settings shown below. Select AppWizard (dll) Projects tab. project name location. (Example: "sample" project) Choose "Create workspace". Check Win32 "Platforms:". Click [OK]->[Close].
PDxxSIM
Choose "Setting." from Project menu VC++ enter settings described below. Select C/C++ definition "IODLL_EXPORTS" "Preprocessor definitions:" column category "General."
Select Link specify library files sim308.lib IodllExpLib(d).lib using absolute relative paths "Object/library modules:" column category "General." These library files stored "Library" directory settings made Win32 Debug, specify IodllExpLibd.lib.
settings made Win32 Release, specify IodllExpLib.lib.
Choose "Setting." from Project menu VC++. "Output file name:" column category "General" Link that output destination directory
Copy iofunc.cpp iofunc.h from "iofunc" directory IodllTemplate project into directory project you've created, them project following procedure described below. Choose "Add Project" "Files." from Project menu VC++, select iofunc.cpp from ensuing list, click
Open infunc.h change main header file specification application included main header filename you've created. Example: #include "#include
Open iofunc.cpp, then write code simulation. When build, (sample.dll) created under directory
PDxxSIM
Method Using
This chapter describes PDxxSIM after loading Before DLL, must first register simxx.exe. simxx.exe registered when start, loads registered before starting simulation. following explains after registering PDxxSIM using PD308SIM example. DLLs other simulator models, change model name "308" described here with desired model name (e.g., "30" "32R"). Copy file (.dll file) want into Register simxx.exe. this, write filename sim308.exe's environment setup file "sim308.ini." sim308.ini file exists However, this file nonexistent have never started PD308SIM since installed that case, this file needs newly created using editor. sim308.ini file, create [DLLNAME] section write filename after "IODLL=," with extension ".dll" removed shown below. Example When file name "Sample.dll". [DLLNAME] IODLL=Sample When start PD308SIM, loaded. DLL, delete description [DLLNAME] section that created sim308.ini file before starting PD308SIM. [DLLNAME] IODLL=Sample Delete Delete
PDxxSIM
Method Debugging
This chapter describes debug you've created. debug VC++, need change settings project. following shows contents changes need make using case debugging PD3008SIM example. debug DLLs other simulator models, change model name "308" described here with desired model name (e.g., "30" "32R"). Following procedure described preceding section, register make usable. Choose "Setting." from Project menu VC++. "Output file name:" column category "General" Link that output destination directory
Choose "Setting." from Project menu VC++. "Executable debug session:" column Debug that simulator engine executable file "sim308.exe" stored becomes debug-time executable file.
After finished setting choose "Start Debug" "Go" from Build menu VC++ start debugging. dialog shown below will appear. Because debugged, click continue.
debug DLL, start PD308SIM after simulator engine sim308.exe started (After sim308.exe started registered (displayed) Windows system tray. that sim308.exe running before start PD308SIM.) details debugging function VC++, VC++ user's manual help.
PDxxSIM
Functions that Send Information
This chapter describes specifications functions that send information simulator engine side DLL. These functions implemented project's source file simulator engine simxx.exe calls these functions sends information DLL. Make sure codes simulation written these functions. Function name NotifyStepCycle NotifyPreExecutionPC NotifyReset NotifyStart NotifyEnd NotifyInterrupt NotifyPreReadMemory NotifyPostWriteMemory Abstract Notifies number execution cycles each time instruction executed. Notifies current value immediately before executing instruction. Notifies that target program reset. Notifies that simulator engine started. Notifies that simulator engine terminated. Notifies vector number (vector address) interrupt when that interrupt generated. Notifies read address data length immediately before reading from memory when memory read from target program occurred. Notifies write address, data length data value after data written from target program memory.
Below shows specification function.
Notifies number execution cycles instruction executed Function name: void NotifyStepCycle(int cycle) Parameter: cycle number executed cycles.
Return value: None Functions: Notifies number execution cycles each time instruction executed.
Notifies current value before executing instruction Function name: void NotifyPreExecutionPC(unsigned long address) Parameter: unsigned long address value before executing
Return value: None Functions: Notifies current value immediately before executing instruction.
Notifies reset Function name: void NotifyReset(void) Parameter: None
Return value: None Functions: Notifies that target program reset.
PDxxSIM
Notifies start simulator engine Function name: void NotifyStart(void) Parameter: None
Return value: None Functions: Notifies that simulator engine started.
Notifies terminate simulator engine Function name: void NotifyEnd(void) Parameter: None
Return value: None Functions: Notifies that simulator engine terminated.
Notifies generate interrupt Function name: void NotifyInterrupt(unsigned long vec) Parameter: unsigned long Vector number. (Vector address) PD308SIM, PD30SIM Vector number. PD32RSIM vector entry. (Only 0x00000080) Return value: None Functions: Notifies vector number (vector address) interrupt when that interrupt generated.
Notifies immediately before reading from memory Function name: void NotifyPreReadMemory(unsigned long address, length) Parameter: unsigned long address length Return value: None Functions: Notifies read address data length immediately before reading from memory when memory read from target program occurred. Memory address.
Data length memory data. byte byte byte byte
PDxxSIM
Notifies after data written from memory Function name: void NotifyPostWriteMemory(unsigned long address, length, unsigned long data) Parameter: unsigned long address length Memory address.
Data length memory data. byte byte byte byte
unsigned long data Memory data value. Return value: Functions: None Notifies write address, data length data value after data written from target program memory.
PDxxSIM
following shows example write above functions. shaded sections this example template part above functions that implemented iofunc.cpp file. void NotifyStepCycle(int cycle) unsigned longtabsrData, ta0Data, ta0icData; (sCountFlag FALSE) Check count beginning flag. return; RequestGetMemory(TABSR, &tabsrData); ((tabsrData 0x01) 0x01) Check count beginning flag. sCountCycle cycle; RequestGetMemory(TA0, &ta0Data); (sCountCycle ta0Data Count down counter. RequestGetMemory(TA0IC, &ta0icData); RequestInterrupt(TA0INT, ta0icData 0x7); Generation timer interrupt. sCountCycle
return; void NotifyPreExecutionPC(unsigned long address) return; void NotifyPostWriteMemory(unsigned long address, length) (address TABSR) ((data 0x01) 0x01) Check count beginning flag. sCountFlag TRUE; return;
PDxxSIM
Functions that Information from simxx.exe
This chapter describes specifications functions that information simulator engine side from DLL. These functions implemented simxx.exe side. calls these functions information from simulator engine. these functions write codes simulation within functions implemented project's source file Function name RequestGetMemory RequestPutMemory RequestGetRegister RequestPutRegister RequestInterrupt RequestInterruptStatus RequestTotalCycle RequestInstructionNum RequestStop RequestErrorNum Abstract Gets memory data from specified address. Sets memory data specified address. Gets value from specified register. Sets value specified register. Generates specified interrupt. Gets status generated interrupts. Inspects total number current execution cycles. Inspects total number currently executed instructions. Causes target program stop running. Gets error number when error occurred immediately preceding function that executed.
Below shows specification function.
Gets memory data Function name: RequestGetMemory(unsigend long address, length, unsigend long data) Parameter: unsigned long address length Memory address.
Data length memory data. byte byte byte byte Memory data storage area.
unsigned long data Return value: status TRUE FALSE Functions:
Succeeded. Error.
Gets memory data from specified address. read access information performed this function reflected virtual port input script facilities.
PDxxSIM
Sets memory data Function name: RequestPutMemory(unsigend long address, length, unsigend long data) Parameter: unsigned long address length Memory address.
Data length memory data. byte byte byte byte
unsigned long data Memory data. Return value: status TRUE FALSE Functions: Succeeded. Error.
Sets memory data specified address. write access information performed this function reflected output, virtual port output script facilities.
PDxxSIM
Gets register value Function name: RequestGetRegister(int regNo, unsigned long regValue) Parameter: regNo Register number. register numbers, header file that included sample program. Register numbers defined this file. Example: Definition PD308SIM. regNo REG_Rx_F REG_RxH_F REG_RxL_F REG_Ax_F REG_FB_F REG_SB_F REG_Rx_R REG_RxH_R REG_RxL_R REG_Ax_R REG_FB_R REG_SB_R REG_Rx REG_RxH REG_RxL REG_Ax REG_FB REG_SB REG_USP REG_ISP REG_FLG REG_PC REG_INTB REG_SVF REG_SVP REG_VCT REG_DMDx REG_DCTx REG_DRCx REG_DMAx REG_DSAx REG_DRAx Register Bank0 registers. High-order bits Bank0 register. Low-order bits Bank0 register. Bank0 registers. Bank0 register. Bank0 register. Bank1 registers. High-order bits Bank1 register. Low-order bits Bank1 register. Bank1 register. Bank1 register. Bank1 register. register indicated flag. High-order bits register indicated flag. Low-order bits register indicated flag. register indicated flag. register indicated flag. register indicated flag. register. register. register. Program counter. INTB register. register. register. register. DMDx registers. DCTx registers. DRCx registers. DMAx registers. DSAx registers. DRAx registers.
Description example: register value bank RequestGetRegister( REG_R0_F, &regValue
unsigned long regValue
Register value storage area.
PDxxSIM
Return value: status TRUE FALSE Functions: Succeeded. Error.
Gets value from specified register.
Sets register value Function name: RequestPutRegister(int regNo, unsigned long regValue) Parameter: regNo Register number. Register value.
unsigned long regValue Return value: status TRUE FALSE Functions:
Succeeded. Error.
Sets value specified register.
Generates interrupt Function name: RequestInterrupt(unsigned long vec, ipl) Parameter: unsigned long Vector number. (Vector address) PD308SIM, PD30SIM Vector number. PD32RSIM vector entry. (Only 0x00000080) Priority. PD32RSIM, specify because there interrupt priority. Return value: status TRUE FALSE Functions: Succeeded. Error.
Generates specified interrupt.
Gets status generated interrupts Function name: RequestInterruptStatus(unsigned long vec) Parameter: unsigned long Vector number. (Vector address) PD308SIM, PD30SIM Vector number. PD32RSIM vector entry. (Only 0x00000080) Return value: happen Generation status interrupt. TRUE FALSE Functions: Generated. Vector number stored vec. Un-generated. indeterminate.
Gets status generated interrupts.
PDxxSIM
Inspects total number execution cycles Function name: void RequestTotalCycle(unsigned long cycle) Parameter: unsigned long cycle total number execution cycles.
Return value: None Functions: Inspects total number current execution cycles.
Inspects total number executed instructions. Function name: void RequestInstructionNum(unsigned long inst) Parameter: unsigned long inst total number currently executed instructions.
Return value: None Functions: Inspects total number currently executed instructions.
Causes target program stop running Function name: void RequestStop(void) Parameter: None
Return value: None Functions: Causes target program stop running.
PDxxSIM
Gets error information Function name: RequestErrorNum(void) Parameter: None Error number.
Return value: errNum errNom Functions:
Contents error. Address value range. Can't read/write, because there memory that area. Can't enough memory. Data size range. Can't access specified address. Description register illegal. Data value illegal. Specified vector range. Specified level priority range. Can't enough memory.
Gets error number when error occurred immediately preceding function that executed. This function allows information what error occurred when following functions called returned value false. RequestGetMemory function RequestPutMemory function RequestGetRegister function RequestPutRegister function RequestInterrupt function
example: unsigned long data; char str[5]; sprintf( str, "%d", RequestErrorNum() MessageBox( NULL, str, "Error number", MB_OK Display error number message box. RequestGetMemory( 0x800, data FALSE
PDxxSIM
following shows example write above functions. shaded sections this example template part above functions that implemented iofunc.cpp file. void NotifyPostWriteMemory(unsigned long address, length, unsigned long data) (address 0x3e0) RequestGetRegister(REG_PC, &val); Value. RequestPutMemory(0x800, val); Store value 0x800 address. else (address 0x3e1) RequestPutRegister(REG_R0_F, data); Store value bank0 register. RequestInterrupt(21, Generation timer interrupt.
return;
PDxxSIM
Specifying Target Program Symbols
This chapter describes specify target program symbols DLL. symbols defined target program specified DLL, necessary that symbol information loaded into using symbol window which extension window PDxxSIM. following explains procedure specifying target program symbols using PD308SIM example. DLLs other simulator models, change model name "308" described here with desired model name (e.g., "30" "32R"). Register symbol window PD308SIM. symbol window, output symbol information file. Load output file into register symbol information. Specify symbol DLL.
Each step detailed below. Register symbol window PD308SIM. Follow procedure described below register symbol window PD308SIM. Copy symbol window file "SymbolWindow.dll" from directory into Open PD308SIMDLL.DEF file existing using editor increment "WindowCount" counts [GENERAL] section. [GENERAL] ProductName=PD308SIM WindowCount=9 WindowCount=10
Append following contents PD308SIMDLL.DEF. Contents: [Window9] Title=Symbol Window ID=50000
Module=SymbolWindow
Create=CreateMDIChildFrame GetOptionMenuID=GetOptionMenuID Append=1
Make sure number section name added section "[Window9]" that follows those other windows. remove registered symbol window, restore contents PD308SIMDLL.DEF that modified.
PDxxSIM
symbol window, output symbol information file. Below shows process. Start PD308SIM when started choose [Add-In Windows] [Symbol Window] from Optional Windows menu open symbol window.
Download target program into PD308SIM. After downloading, click "Create Symbol List" button toolbar symbol window select file which output symbol information. Note: output symbol information, information local symbols that module files whose scopes PD308SIM. (The term "scope" refers effective range local symbols/ local labels.) output information local symbols/ local labels included other module files, change scope settings PD308SIM. details, description scope command "PD308SIM Help," online help PD308SIM.
PDxxSIM
When symbol information output file, symbol information displayed symbol window.
following displayed contents. Symbol type Symbol name Symbol address Symbol types displayed order G_SYMBOL (global symbols), L_SYMBOL (local symbols), G_LABEL (global labels) L_LABEL (local labels). symbol types displayed unless they exist target program.
search symbols, click "Search Symbol" button toolbar enter symbol name want search. target program downloaded again, symbol information being displayed symbol window updated. this case, symbol information written over file which symbol information previously output. change symbol information output files, click "Create Symbol List" button specify symbol file again. Note: Once symbol information output file selected (i.e., symbol information displayed symbol window), symbol information automatically updated next time download target program. download target program while symbol information being displayed symbol window, symbol information updated. Therefore, click "Create Symbol List" button output symbol information.
PDxxSIM
Load output file into register symbol information. Below shows process. register symbol information DLL, RegistrationSymbolList FreeSymbolList functions. Below shows specification function.
[Registration symbol information]
Function name: Parameter: BOOL RegistrationSymbolList(const char pszFile) const char pszFile Symbol file name. Specify file with absolute path. Can't network pathname. Return value: BOOL status TRUE FALSE Succeeded. Error.
error dialog displayed error occurs. Below show contents error. Error message symbol file can't open. Contents symbol file cannot opened. Check whether specified symbol file correct whether exists. enough memory symbol file cannot opened lack open symbol file. memory. Check whether sufficient memory available. format symbol symbol file invalid format. Create file wrong. symbol file correctly again.
Functions:
This function loads created symbol file into symbol window register symbol information. symbol information registered this function retained memory. Therefore, whenever symbol information becomes unnecessary, call FreeSymbolList function delete symbol information free memory space).
[Delete symbol information]
Function name: Parameter: Return value: Functions: void FreeSymbolList(void) None None Delete symbol information free memory space).
PDxxSIM
Below shows example. void NotifyReset(void) When reset, load symbol information register. RegistrationSymbolList( return; void NotifyEnd(void) Delete symbol information loaded into when exiting PDxxSIM. FreeSymbolList( return;
Note: RegistrationSymbolList function registers only symbol information included symbol file. this function called twice more, deletes previous symbol information free memory space) before registering symbol information. same symbol file specified, function inspects file's timestamp only when been updated, reregisters symbol information.
PDxxSIM
Specify symbol DLL. Below shows process. convert symbol value DLL, ChangeSymtToVal function. Below shows specification function.
[Convert value symbol]
Function name: BOOL ConvertSymToVal(const char pszSym, unsigned long ulAddr, nType) Parameter: const char pszSym unsigned long ulAddr Symbol name. Pointer which converted symbol value stored. nType Symbol types which given priority when searched. TYPE_SYMBOL TYPE_LABEL Return value: BOOL status TRUE FALSE Functions: Succeeded. symbol isn't found. Symbol. Label.
This function searches corresponding value symbol stores found value ulAddr. table below shows what search priority will assigned each symbol type when specified nType.
priority level
level level level level Attention:
TYPE_SYMBOL Local symbol Global symbol Local label Global label
TYPE_LABEL Local label Global label Local symbol Global symbol
symbol name specified pszSym parameter ConvertSymToVal function, sure that displayed symbol window. example, symbol name displayed symbol window prefixed underbar case "_strl," symbol name specified pszSym parameter must also prefixed underbar.
PDxxSIM
Below shows example. void NotifyPreReadMemory(unsigned long address, length) unsigned long s_addr; unsigned long data; When address 0x3e0 read, store value symbol "strl" 0x3e0 address 0x3e0 return; ConvertSymToVal("_str1", &s_addr, TYPE_LABEL FALSE return; RequestGetMemory(s_addr, length, &data); RequestPutMemory(address, length, data);
Notes
Changes values input/output from memory using cannot referenced using output, virtual port input/output script facilities PDxxSIM. Only specified PDxxSIM. cannot specify multiple DLLs.
PDxxSIM User's Manual
Rev. 1.00 2003 REJ10J0063-0100Z COPYRIGHT ©2003 RENESAS TECHNOLOGY CORPORATION RENESAS SOLUTIONS CORPORATION RIGHTS RESERVED

User's Manual Rev. 1.00 2003 REJ10J0063-0100Z Active Microso

Top Searches for this datasheet

Other recent searches