HEW Target Server (COM extension)

Overview
Downloads
Documentation
Further Information

HTS Methods

The HEW Target Server COM has a large API for communicating, controlling, and sharing data with the High-performance Embedded Workshop and any target MCU or MPU connected via the debug channel. The following tables briefly describe many of the methods found in the HEW Target Server API.

For complete information and details on how to use these methods, refer to the HEW Target Server User’s Manual included with the High-performance Embedded Workshop.

You can also find a wide range of sample and example applications to help understand these methods or to jump start your application coding at the RenesasRulz HEW Target Server pages.

List of HEW Target Server methods

CPU Control
Method Name	Description
GoTargetExec	Executes a program.
StopTargetExec	Stops program execution.
ResetTargetExec	Resets the debugger environment.
InitializeTarget	Initializes the debugger environment.
Step	Step executes the target program.
StepRate	Sets a speed at which the program is single-stepped.
StepOver	Runs a program by stepping-over instructions or source lines.
StepOut	Runs a program by stepping-out instructions or source lines.
IsRunning	Determines whether or not the current user program is running.

Register and Memory Functions
Method Name	Description
GetPC	Gets the current program counter value.
SetPCAddress	Sets the program counter.
SetPCSource	Sets the program counter by specifying a source file and line.
TestSetPC	Determines whether or not the PC (program counter) value can be set.
GetMemory	Gets a memory data.
SetMemory	Sets a memory data.
GetDirectMemory	Gets a direct memory data.

Debug
Method Name	Description
SetPCBreakPt	Registers the software breakpoint.
EnableBreakPt	Enable or disable the software breakpoint.
DeleteBreakPt	Delete the software breakpoint.
GetAllBreakPt	Gets the software breakpoints that have been set.
DeleteAllBreakPt	Deletes the software breakpoints that have been set.
SetDataBreakpoint	Registers the data breakpoint.
EnableDataBreakpoint	Enables or disables the data breakpoint.
DeleteDataBreakpoint	Delete the data breakpoint.
SetSymbolTrace	Sets the variable trace conditions.
ExecuteSymbolTrace	Enables or disables the variable traces.
DeleteSymbolTrace	Deletes the variable trace conditions.
SaveSymbolTraceData	Saves the variable trace result to a specified file.
SendTrigger	Sets interrupt conditions.
GetRealTimeWatch	Gets the real-time watch.
GetQuickWatch	Gets the value that corresponds to a string character.
SymbolToAddress	Converts from symbol to address.
AddressToSymbol	Converts from address to symbol.
GetLineFromAddr	Gets the source file name and the line number corresponding to the specified address.
GetAddrFromLine	Gets the address of specified source line information.
OpenFileAtLine	Opens a file by specifying the file name and line number.
GetSourceFiles	Gets source file names.
GetDownloadModules	Gets module file names.
GetDependentFiles	Gets dependent file names.

HEW Control
Method Name	Description
Download	Downloads the target program.
Unload	Unloads the target program.
InvokeHew	Starts a HEW application.
QuitHew	Closes a HEW application.
OpenWorkspace	Opens a workspace.
CloseWorkspace	Closes the workspace.
SaveWorkspace	Saves the workspace.
SaveSession	Saves the session file.
GetCurrentConfiguration	Gets the current build configuration.
SetCurrentConfiguration	Sets a build configuration.
GetConfigurations	Gets registered build configurations.
GetCurrentSession	Gets the current debug session.
SetCurrentSession	Sets a debug session.
GetSessions	Gets registered debug sessions.
GetCurrentProject	Gets the current project.
GetProjects	Gets all project names.
SetCurrentProject	Sets the active project.
AddFile	Adds a file to the project.
AddFiles	Adds multiple files to the project.
DeleteFile	Deletes a file from the project.
DeleteFiles	Deletes multiple files from the project.
BuildProject	Builds a project.
RebuildProject	Rebuilds a project.
UpDateAllDependency	Updates all dependency relations.
AddFileWithCompilerOption	Adds a file after setting compiler options for the project.
OpenFileAtLine	Opens a file by specifying the file name and line number.
GetSourceFiles	Gets source file names.
GetDownloadModules	Gets module file names.
GetDependentFiles	Gets dependent file names.

Status
Method Name	Description
GetErrorString	Gets an error string occurred in a method call.
GetHewStatus	Gets status.
GetHewStatusEx	Gets the status information (on initiation, opening a workspace, and build).
GetTargetName	Gets a target name.