debugger.Option.AccessDuringExecution

debugger.Option.AccessStopExecution

debugger.Option.AccumulateTraceTime

debugger.Option.AfterTraceMemoryFull

debugger.Option.Coverage

debugger.Option.MainClockFrequency

debugger.Option.OpenBreak

debugger.Option.ResetMask

debugger.Option.ReuseCoverageData

debugger.Option.SupplyPower

debugger.Option.SupplyPowerVoltage

debugger.Option.Timer

debugger.Option.Trace

debugger.Option.TraceBranchPC

debugger.Option.TraceDataAccess

debugger.Option.TracePriority

debugger.Option.TraceTarget

debugger.Option.UseTraceData


This property sets or refers to the options of the debug tool.

[Specification format]

debugger.Option.AccessDuringExecution = accessDuringExecution
debugger.Option.AccessStopExecution = afterTrace
debugger.Option.AccumulateTraceTime = accumulateTraceTime
debugger.Option.AfterTraceMemoryFull = accessStopExecution
debugger.Option.Coverage = coverage
debugger.Option.MainClockFrequency = mainClockFrequency
debugger.Option.OpenBreak = openBreak
debugger.Option.ResetMask = [targetReset, internalReset]
debugger.Option.ReuseCoverageData = reuseCoverageData
debugger.Option.SupplyPower = supplyPower
debugger.Option.SupplyPowerVoltage = voltage
debugger.Option.Timer = timer
debugger.Option.Trace = trace
debugger.Option.TraceBranchPC = traceBranchPC
debugger.Option.TraceDataAccess = traceDataAccess
debugger.Option.TracePriority = tracePriority
debugger.Option.TraceTarget = traceTarget
debugger.Option.UseTraceData = useTraceDataType

[Setting(s)]

Setting

Description

accessDuringExecution

Set whether to allow access to memory during execution. [RH850][E1/E20/Full-spec emulator/IE850A]

True: Allow access to memory during execution.

False: Do not allow access to memory during execution.

afterTrace

Set the operation to be taken after using up trace memory.

The values that can be specified are shown below.

Value

Description

AfterTraceMemoryFull.NoneStop

Overwrite trace memory and continue execution.

AfterTraceMemoryFull.StopTrace

Stop tracing.

AfterTraceMemoryFull.Stop

Stop execution (stop the program).

accumulateTraceTime

Set whether to display the trace time with accumulated time. [Simulator]

True: Display the trace time with accumulated time.

False: Display the trace time with differential value.

accessStopExecution

Set whether to instantaneously stop execution and make an access.

True: Stop execution for a moment and make an access.

False: Stop execution for a moment but do not make an access.

coverage

Set whether to use the coverage function. [IECUBE][IECUBE2][Simulator]

True: Use the coverage function.

False: Do not use the coverage function.

mainClockFrequency

Set the main clock frequency (numerical value) in units of kHz. [Except RX simulator]

openBreak

Set whether to use the open break function.

True: Use the open break function.

False: Do not use the open break function.

targetReset

Set whether to mask the TARGET RESET signal. [RL78 [E1/E2/E20/E2 Lite/EZ Emulator/IECUBE]] [RH850 [E1/E2/E20/Full-spec emulator/IE850A]]

True: Mask the TARGET RESET signal.

False: Do not mask the TARGET RESET signal.

Caution

Whether "True" or "False" is specifiable differs with the combination of the device and the emulator. See "CS+ Integrated Development Environment User’s Manual: Debug Tool" for details.

internalReset

Set whether to mask the INTERNAL RESET signal. [RL78 [E1/E2/E20/E2 Lite/EZ Emulator/IECUBE]] [RH850 [E1/E2/E20/Full-spec emulator/IE850A]]

True: Mask the INTERNAL RESET signal.

False: Do not mask the INTERNAL RESET signal.

Caution

Whether "True" or "False" is specifiable differs with the combination of the device and the emulator. See "CS+ Integrated Development Environment User’s Manual: Debug Tool" for details.

reuseCoverageData

Set whether to reuse the coverage result.

True: Reuse the coverage result.

False: Do not reuse the coverage result.

supplyPower

Select whether power should be supplied from the emulator. [E1/E2/E2 Lite]

True: Power should be supplied from the emulator.

False: Power should not be supplied from the emulator.

voltage

Specify the voltage in volts to be supplied as power from the emulator. [E1/E2]

For example, enter 3.3 to specify 3.3 V.

timer

Set whether to use the timer function.

True: Use the timer function.

False: Do not use the timer function.

trace

Set whether to use the trace function. [IECUBE][IECUBE2][Simulator]

True: Use the trace function.

False: Do not use the trace function.

traceBranchPC

Set whether to collect PC values for source/destination instructions of branching during program execution as trace data.

True: Collect PC values as trace data.

False: Do not collect PC values as trace data.

Caution

When you are using a simulator as the debugging tool, debugger.Option.TraceDataAccess is also set to "True" if the setting of debugger.Option.TraceBranchPC is "True". Conversely, debugger.Option.TraceDataAccess is also set to "False" if the setting of debugger.Option.TraceBranchPC is "False".

traceDataAccess

Set whether to collect data information on access-related events that occurred during program execution as trace data.

True: Collect data information as trace data.

False: Do not collect data information as trace data.

Caution

When you are using a simulator as the debugging tool, debugger.Option.TraceBranchPC is also set to "True" if the setting of debugger.Option.TraceDataAccess is "True". Conversely, debugger.Option.TraceBranchPC is also set to "False" if the setting of debugger.Option.TraceDataAccess is "False".

tracePriority

Set whether the acquisition of all data or real-time operation should have priority in the acquisition of trace data. [RH850][E1/E2/E20/Full-spec emulator/IE850A]

The values that can be specified are shown below.

Value

Description

TracePriority.SpeedPriority

Real-time operation is given priority in tracing.

TracePriority.DataPriority

The CPU pipeline is temporarily stopped so that no trace data is lost.

traceTarget

Set the target of tracing. [RH850]

The values that can be specified are shown below.

Value

Description

TraceTarget.DebugOnly

Trace data will only be acquired on the CPU core being debugged.

TraceTarget.AllCore

Trace data will be acquired on all CPU cores.

useTraceDataType

Set which function to use the trace data in. [IECUBE [V850]][IECUBE2]

The functions that can be specified are shown below.

Type

Description

UseTraceDataType.RRM

RRM function

UseTraceDataType.Trace

Trace function

UseTraceDataType.Coverage

Coverage function

[Reference]

Set value

Caution

If a PM+ workspace is converted to a CS+ project, then there will be no debugging tool in the main project. For this reason, "None" will be returned if the main project is the active project.

[Detailed description]

-

This property sets or refers to the options of the debug tool.

[Example of use]

>>>print debugger.Option.AccessDuringExecution
True
>>>debugger.Option.AccessDuringExecution = False
>>>print debugger.Option.AccessDuringExecution
False
>>>

 

>>>print debugger.Option.AccumulateTraceTime
True
>>>debugger.Option.AccumulateTraceTime = False
>>>print debugger.Option.AccumulateTraceTime
False
>>>

 

>>>print debugger.Option.MainClockFrequency
10000
>>>debugger.Option.MainClockFrequency = 12000
>>>print debugger.Option.MainClockFrequency
12000
>>>

 

>>>print debugger.Option.ResetMask
[False, False]
>>>debugger.Option.ResetMask = [True, False]
>>>print debugger.Option.ResetMask
[True, False]
>>>

 

>>>print debugger.Option.SupplyPower
False
>>>debugger.Option.SupplyPower = True
>>>print debugger.Option.SupplyPower
True
>>>

 

>>>print debugger.Option.SupplyPowerVoltage
3.3
>>>debugger.Option.SupplyPowerVoltage = 1.8
>>>print debugger.Option.SupplyPowerVoltage
1.8
>>>

 

>>>print debugger.Option.TraceBranchPC
True
>>>debugger.Option.TraceBranchPC = False
>>>print debugger.Option.TraceBranchPC
False
>>>

 

>>>print debugger.Option.TraceDataAccess
True
>>>debugger.Option.TraceDataAccess = False
>>>print debugger.Option.TraceDataAccess
False
>>>

 

>>>print debugger.Option.TracePriority
SpeedPriority
>>>debugger.Option.TracePriority = TracePriority.DataPriority
>>>print debugger.Option.TracePriority
DataPriority
>>>

 

>>>print debugger.Option.TraceTarget
AllCore
>>>debugger.Option.TraceTarget = TraceTarget.DebugOnly
>>>print debugger.Option.TraceTarget
DebugOnly
>>>

 

>>>print debugger.Option.UseTraceData
Trace
>>>debugger.Option.UseTraceData = UseTraceDataType.Coverage
>>>print debugger.Option.Coverage
False
>>>debugger.Option.Coverage = True
>>>print debugger.Option.Coverage
True
>>>