This class is a facade for few other classes. More...

#include <CDebugFacade.h>

Public Member Functions
std::string	adjustAddressExpression (const std::string &expression)
	For iSYSTEM internal use only.
std::string	call (const std::string &functionName)
	See documentation of CExecutionController#call(const std::string &).
	CDebugFacade (std::shared_ptr< ConnectionMgr > connectionMgr)
	Instantiates object.
int	deleteAll ()
	See documentation of CBreakpointController#deleteAll().
int	deleteAllHWBP ()
	See documentation of CBreakpointController#deleteAllHWBP().
int	deleteBP (const std::string &fileName, int lineNumber)
	See documentation of CBreakpointController#deleteBP(const std::string &, int).
int	deleteBP (const std::string &symbolName)
	See documentation of CBreakpointController#deleteBP(const std::string &).
int	deleteBP (int memArea, ADDRESS_64 address)
	See documentation of CBreakpointController#deleteBP(int, ADDRESS_64).
int	deleteHWBP (const std::string &symbolName)
	See documentation of CBreakpointController#deleteHWBP(const std::string &).
int	deleteHWBP (int memArea, ADDRESS_64 address)
	See documentation of CBreakpointController#deleteHWBP(int, ADDRESS_64).
int	download ()
	See documentation of CLoaderController#download().
CValueType	evaluate (isys::IConnectDebug::EAccessFlags accessFlags, const std::string &expression)
	See documentation of CDataController#evaluate(IConnectDebug#EAccessFlags, const std::string &).
CValueType	evaluate (isys::IConnectDebug::EAccessFlags accessFlags, isys::IConnectDebug::EEvaluate evaluateFlags, const std::string &expression)
	See documentation of CDataController#evaluate(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &).
CAddressControllerSPtr	getAddressController ()
	Returns reference to address controller.
iconnect::AddressVector	getAddressOfSourceLine (const std::string &fileName, int line, bool isReportSize=false)
	See documentation of CAddressController::getAddressOfSourceLine(const std::string &,int,bool).
iconnect::AddressVector	getAddressOfSourceLineAtPathSource (const std::string &fileName, int line, const CAddressController::EPathSource &source, bool isReportSize=false)
	See documentation of CAddressController::getAddressOfSourceLineAtPathSource(const std::string &,int,const CAddressController::EPathSource&, bool).
CBreakpointControllerSPtr	getBreakpointController ()
	Returns reference to breakpoint controller.
int	getCodeArea (bool bPhysical)
	See documentation of CAddressController::getCodeArea(bool) .
CCPUInfo	getCPUInfo ()
	See documentation of CDataController#getCPUInfo().
CPUStatus	getCPUStatus (bool wantStopReason=true)
	See documentation of CExecutionController#getCPUStatus(bool).
CDataControllerSPtr	getDataController ()
	Returns reference to data controller.
CExecutionControllerSPtr	getExecutionController ()
	Returns reference to execution controller.
CMemAddress	getExpressionAddress (const std::string &expression)
	See documentation of CAddressController::getExpressionAddress(const std::string &).
CMemAddress	getFunctionAddress (const std::string &functionName)
	See documentation of CAddressController::getFunctionAddress(const std::string &) .
CMemAddress	getLabelAddress (const std::string &labelName)
	See documentation of CAddressController::getLabelAddress(const std::string &).
CLoaderControllerSPtr	getLoaderController ()
	Returns reference to loader controller.
int	getMemoryAreaBytesPerMAU (int memArea)
	See documentation of CDataController#getMemoryAreaBytesPerMAU(int).
CLineLocation	getSourceLineAtAddress (ADDRESS_64 address)
	See documentation of CAddressController::getSourceLineAtAddress(ADDRESS_64).
CLineLocation	getSourceLineAtAddress (ADDRESS_64 address, bool isExact, bool isAbsolutePath)
	See documentation of CAddressController::getSourceLineAtAddress(ADDRESS_64, bool, bool).
CLineLocation	getSourceLineAtAddressAtPathSource (ADDRESS_64 address, bool isExact, bool isAbsolutePath, const CAddressController::EPathSource &source)
	See documentation of CAddressController::getSourceLineAtAddressAtPathSource(ADDRESS_64, bool, bool, const CAddressController::EPathSource&).
CLineLocation	getSourceLineAtAddressAtPathSource (ADDRESS_64 address, const CAddressController::EPathSource &source)
	See documentation of CAddressController::getSourceLineAtAddressAtPathSource(ADDRESS_64, const CAddressController::EPathSource&).
std::string	getSymbolAtAddress (isys::IConnectDebug::ESymbolFlags symbolType, uint8_t memArea, ADDRESS_64 address, isys::IConnectDebug::ESymbolFlags scope=isys::IConnectDebug::sScopeExact)
	See documentation of CAddressController::getSymbolAtAddress(isys::IConnectDebug::ESymbolFlags, uint8_t, ADDRESS_64, isys::IConnectDebug::ESymbolFlags).
CSymbolInfo	getSymbolInfo (uint32_t flags, const std::string &expression)
	See documentation of CAddressController::getSymbolInfo(uint32_t, const std::string &).
CMemAddress	getVariableAddress (const std::string &variableName)
	See documentation of CAddressController::getVariableAddress(const std::string &).
void	gotoAddress (uint8_t memArea, ADDRESS_64 address)
	See documentation of CExecutionController#gotoAddress(uint8_t, ADDRESS_64).
void	gotoFunction (const std::string &functionName)
	See documentation of CExecutionController#gotoFunction(const std::string &).
std::string	modify (isys::IConnectDebug::EAccessFlags accessFlags, const std::string &expression, const CValueType &value, bool readBack=true)
	See documentation of CDataController#modify(IConnectDebug::EAccessFlags, const std::string &, const CValueType &, bool).
std::string	modify (isys::IConnectDebug::EAccessFlags accessFlags, const std::string &expression, const std::string &value, bool readBack=true)
	See documentation of CDataController#modify(IConnectDebug::EAccessFlags, const std::string &, const std::string &, bool).
std::string	modify (isys::IConnectDebug::EAccessFlags accessFlags, isys::IConnectDebug::EEvaluate evaluateFlags, const std::string &expression, const CValueType &value, bool readBack=true)
	See documentation of CDataController#modify(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &, const CValueType &, bool).
std::string	modify (isys::IConnectDebug::EAccessFlags accessFlags, isys::IConnectDebug::EEvaluate evaluateFlags, const std::string &expression, const std::string &value, bool readBack=true)
	See documentation of CDataController#modify(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &, const std::string &, bool).
std::vector< uint8_t >	readMemory (isys::IConnectDebug::EAccessFlags accessFlags, uint8_t memArea, ADDRESS_64 aAddress, ADDRESS_64 aNumMAUs, uint8_t bytesPerMAU)
	See documentation of CDataController#readMemory(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, ADDRESS_64, BYTE) .
CValueType	readRegister (isys::IConnectDebug::EAccessFlags accessFlags, const std::string &registerName)
	See documentation of CDataController#readRegister(IConnectDebug::EAccessFlags, const std::string &).
CValueType	readValue (isys::IConnectDebug::EAccessFlags accessFlags, uint8_t memArea, ADDRESS_64 aAddress, const SType &type)
	See documentation of CDataController#readValue(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, const SType &).
int	reapplyAll ()
	See documentation of CBreakpointController#reapplyAll().
void	reset ()
	See documentation of CExecutionController#reset().
int	run ()
	See documentation of CExecutionController#run().
int	run (CExecutionController::ETimeoutMode timeoutMode)
	See documentation of CExecutionController#run(CExecutionController::ETimeoutMode, bool).
int	runUntilAddress (uint8_t memArea, ADDRESS_64 address)
	See documentation of CExecutionController#runUntilAddress(uint8_t, ADDRESS_64).
int	runUntilAddress (uint8_t memArea, ADDRESS_64 address, CExecutionController::ETimeoutMode timeoutMode)
	See documentation of CExecutionController#runUntilAddress(uint8_t, ADDRESS_64, CExecutionController::ETimeoutMode, bool).
int	runUntilExpression (const std::string &expression)
	This method evaluates the given expression, which must evaluate to address.
int	runUntilExpression (const std::string &expression, CExecutionController::ETimeoutMode timeoutMode)
	This method evaluates the given expression, which must evaluate to address.
int	runUntilFunction (const std::string &functionName)
	See documentation of CExecutionController#runUntilFunction(const std::string &).
int	runUntilFunction (const std::string &functionName, CExecutionController::ETimeoutMode timeoutMode)
	See documentation of CExecutionController#runUntilFunction(const std::string &, CExecutionController::ETimeoutMode, bool).
int	runUntilReturn ()
	See documentation of CExecutionController#runUntilReturn().
int	runUntilReturn (CExecutionController::ETimeoutMode timeoutMode)
	See documentation of CExecutionController#runUntilReturn(isys::CExecutionController::ETimeoutMode, bool).
int	setBP (const std::string &symbolName, int conditionCount=0, const std::string &conditionExpression="")
	See documentation of CBreakpointController#setBP(const std::string &, int, const std::string &).
int	setBP (int lineNumber, const std::string &fileName, int conditionCount=0, const std::string &conditionExpression="")
	See documentation of CBreakpointController#setBP(int, const std::string &, int, const std::string &).
int	setBP (int memArea, ADDRESS_64 address, int conditionCount=0, const std::string &conditionExpression="")
	See documentation of CBreakpointController#setBP(int, ADDRESS_64, int, const std::string &).
int	setEnabled (bool isEnabled, const std::string &fileName, int lineNumber)
	See documentation of CBreakpointController#setEnabled(bool, const std::string &, int).
int	setEnabled (bool isEnabled, const std::string &symbolName)
	See documentation of CBreakpointController#setEnabled(bool, const std::string &).
int	setEnabled (bool isEnabled, int memArea, ADDRESS_64 address)
	See documentation of CBreakpointController#setEnabled(bool, int, ADDRESS_64).
int	setEnabledAll (bool isEnabled)
	See documentation of CBreakpointController#setEnabledAll(bool).
int	setHWBP (uint32_t rwAccess, uint32_t accessSize, uint32_t usedDataBytes, bool isEntireObject, const std::string &symbolName, uint32_t data)
	See documentation of CBreakpointController#setHWBP(DWORD, DWORD, DWORD, bool, const std::string &, DWORD).
int	setHWBP (uint32_t rwAccess, uint32_t accessSize, uint32_t usedDataBytes, int memArea, ADDRESS_64 address, uint32_t data)
	See documentation of CBreakpointController#setHWBP(DWORD, DWORD, DWORD, int, ADDRESS_64, DWORD).
int	setHWEnabled (bool isEnabled, const std::string &symbolName)
	See documentation of CBreakpointController#setHWEnabled(bool, const std::string &).
int	setHWEnabled (bool isEnabled, int memArea, ADDRESS_64 address)
	See documentation of CBreakpointController#setHWEnabled(bool, int, ADDRESS_64).
int	setHWEnabledAll (bool isEnabled)
	See documentation of CBreakpointController#setHWEnabledAll(bool).
void	setPollingEnabled (bool isEnabled)
	See documentation of CExecutionController#setPollingEnabled(bool).
int	setSlowRun (bool isSlowRun)
	See documentation of CExecutionController#setSlowRun(bool).
void	stepHigh (CExecutionController::ETimeoutMode timeoutMode=CExecutionController::TOUT_10s, bool throwOnTimeout=true)
	See documentation of CExecutionController#stepHigh().
void	stepInst (CExecutionController::ETimeoutMode timeoutMode=CExecutionController::TOUT_10s, bool throwOnTimeout=true)
	See documentation of CExecutionController#stepInst().
void	stepOverHigh (CExecutionController::ETimeoutMode timeoutMode=CExecutionController::TOUT_10s, bool throwOnTimeout=true)
	See documentation of CExecutionController#stepOverHigh(CExecutionController::ETimeoutMode, bool).
void	stepOverInst (CExecutionController::ETimeoutMode timeoutMode=CExecutionController::TOUT_10s, bool throwOnTimeout=true)
	See documentation of CExecutionController#stepOverInst(CExecutionController::ETimeoutMode, bool).
void	stop ()
	See documentation of CExecutionController#stop().
bool	waitUntilStopped (int timeoutMs=0, uint32_t pollingIntervalMs=100)
	See documentation of CExecutionController#waitUntilStopped(int, uint32_t, bool).
bool	waitWhileRunning (int timeoutMs, uint32_t pollingIntervalMs=100)
	See documentation of CExecutionController#waitWhileRunning(int, uint32_t, bool).
std::vector< uint8_t >	writeMemory (isys::IConnectDebug::EAccessFlags accessFlags, uint8_t memArea, ADDRESS_64 aAddress, ADDRESS_64 aNumMAUs, uint8_t bytesPerMAU, std::vector< uint8_t > &buff)
	See documentation of CDataController#writeMemory(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, ADDRESS_64, BYTE, std::vector<BYTE> &).
void	writeRegister (isys::IConnectDebug::EAccessFlags accessFlags, const std::string &registerName, const CValueType &registerInfo)
	See documentation of CDataController#writeRegister(IConnectDebug::EAccessFlags, const std::string &, const CValueType &).
void	writeValue (isys::IConnectDebug::EAccessFlags accessFlags, bool isRefreshWinIDEAGUIAfterWrite, uint8_t memArea, ADDRESS_64 aAddress, const CValueType &value)
	See documentation of CDataController#writeValue(IConnectDebug::EAccessFlags, bool, BYTE, ADDRESS_64, const CValueType &).
void	writeValue (isys::IConnectDebug::EAccessFlags accessFlags, uint8_t memArea, ADDRESS_64 aAddress, const CValueType &value)
	See documentation of CDataController#writeValue(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, const CValueType &).
virtual	~CDebugFacade (void)

Detailed Description

This class is a facade for few other classes.

It adds no new functionality, but provides all-in-one interface for the most common isystem.connect operations. It contains most of the functionality of the following classes:

Constructor & Destructor Documentation

◆ CDebugFacade()

isys::CDebugFacade::CDebugFacade ( std::shared_ptr< ConnectionMgr > connectionMgr )

Instantiates object.

Parameters

connectionMgr class which maintains connection to winIDEA. Connection must be established before this call.

Since: 9.12.288

Python example: test_get_controllers.py

◆ ~CDebugFacade()

virtual isys::CDebugFacade::~CDebugFacade ( void )

virtual

Since: 9.12.288

Member Function Documentation

◆ adjustAddressExpression()

std::string isys::CDebugFacade::adjustAddressExpression ( const std::string & expression )

For iSYSTEM internal use only.

Since: 9.12.288

◆ call()

std::string isys::CDebugFacade::call ( const std::string & functionName )

See documentation of CExecutionController#call(const std::string &).

If you need to specify function parameters, use overloads of this method in CExecutionController.

Since: 9.12.288

◆ deleteAll()

int isys::CDebugFacade::deleteAll ( )

See documentation of CBreakpointController#deleteAll().

Since: 9.12.288

◆ deleteAllHWBP()

int isys::CDebugFacade::deleteAllHWBP ( )

See documentation of CBreakpointController#deleteAllHWBP().

Since: 9.12.288

◆ deleteBP() [1/3]

int isys::CDebugFacade::deleteBP	(	const std::string &	fileName,
		int	lineNumber )

See documentation of CBreakpointController#deleteBP(const std::string &, int).

Since: 9.12.288

◆ deleteBP() [2/3]

int isys::CDebugFacade::deleteBP ( const std::string & symbolName )

See documentation of CBreakpointController#deleteBP(const std::string &).

Since: 9.12.288

◆ deleteBP() [3/3]

int isys::CDebugFacade::deleteBP	(	int	memArea,
		ADDRESS_64	address )

See documentation of CBreakpointController#deleteBP(int, ADDRESS_64).

Since: 9.12.288

◆ deleteHWBP() [1/2]

int isys::CDebugFacade::deleteHWBP ( const std::string & symbolName )

See documentation of CBreakpointController#deleteHWBP(const std::string &).

Since: 9.12.288

◆ deleteHWBP() [2/2]

int isys::CDebugFacade::deleteHWBP	(	int	memArea,
		ADDRESS_64	address )

See documentation of CBreakpointController#deleteHWBP(int, ADDRESS_64).

Since: 9.12.288

◆ download()

int isys::CDebugFacade::download ( )

See documentation of CLoaderController#download().

Since: 9.12.288

◆ evaluate() [1/2]

CValueType isys::CDebugFacade::evaluate	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		const std::string &	expression )

See documentation of CDataController#evaluate(IConnectDebug#EAccessFlags, const std::string &).

Since: 9.12.288

◆ evaluate() [2/2]

CValueType isys::CDebugFacade::evaluate	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		isys::IConnectDebug::EEvaluate	evaluateFlags,
		const std::string &	expression )

See documentation of CDataController#evaluate(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &).

Since: 9.12.288

◆ getAddressController()

CAddressControllerSPtr isys::CDebugFacade::getAddressController ( )

Returns reference to address controller.

Python example: test_get_controllers.py

Since: 9.12.288

◆ getAddressOfSourceLine()

iconnect::AddressVector isys::CDebugFacade::getAddressOfSourceLine	(	const std::string &	fileName,
		int	line,
		bool	isReportSize = false )

See documentation of CAddressController::getAddressOfSourceLine(const std::string &,int,bool).

Since: 9.12.288

◆ getAddressOfSourceLineAtPathSource()

iconnect::AddressVector isys::CDebugFacade::getAddressOfSourceLineAtPathSource	(	const std::string &	fileName,
		int	line,
		const CAddressController::EPathSource &	source,
		bool	isReportSize = false )

See documentation of CAddressController::getAddressOfSourceLineAtPathSource(const std::string &,int,const CAddressController::EPathSource&, bool).

Since: 9.12.288

◆ getBreakpointController()

CBreakpointControllerSPtr isys::CDebugFacade::getBreakpointController ( )

Returns reference to breakpoint controller.

Python example: test_get_controllers.py

Since: 9.12.288

◆ getCodeArea()

int isys::CDebugFacade::getCodeArea ( bool bPhysical )

See documentation of CAddressController::getCodeArea(bool) .

Since: 9.12.288

◆ getCPUInfo()

CCPUInfo isys::CDebugFacade::getCPUInfo ( )

See documentation of CDataController#getCPUInfo().

Since: 9.12.288

◆ getCPUStatus()

CPUStatus isys::CDebugFacade::getCPUStatus ( bool wantStopReason = true )

See documentation of CExecutionController#getCPUStatus(bool).

Since: 9.12.288

◆ getDataController()

CDataControllerSPtr isys::CDebugFacade::getDataController ( )

Returns reference to data controller.

Python example: test_get_controllers.py

Since: 9.12.288

◆ getExecutionController()

CExecutionControllerSPtr isys::CDebugFacade::getExecutionController ( )

Returns reference to execution controller.

Python example: test_get_controllers.py

Since: 9.12.288

◆ getExpressionAddress()

CMemAddress isys::CDebugFacade::getExpressionAddress ( const std::string & expression )

See documentation of CAddressController::getExpressionAddress(const std::string &).

Since: 9.12.288

◆ getFunctionAddress()

CMemAddress isys::CDebugFacade::getFunctionAddress ( const std::string & functionName )

See documentation of CAddressController::getFunctionAddress(const std::string &) .

Since: 9.12.288

◆ getLabelAddress()

CMemAddress isys::CDebugFacade::getLabelAddress ( const std::string & labelName )

See documentation of CAddressController::getLabelAddress(const std::string &).

Since: 9.12.288

◆ getLoaderController()

CLoaderControllerSPtr isys::CDebugFacade::getLoaderController ( )

Returns reference to loader controller.

Python example: test_get_controllers.py

Since: 9.12.288

◆ getMemoryAreaBytesPerMAU()

int isys::CDebugFacade::getMemoryAreaBytesPerMAU ( int memArea )

See documentation of CDataController#getMemoryAreaBytesPerMAU(int).

Since: 9.12.288

◆ getSourceLineAtAddress() [1/2]

CLineLocation isys::CDebugFacade::getSourceLineAtAddress ( ADDRESS_64 address )

See documentation of CAddressController::getSourceLineAtAddress(ADDRESS_64).

Since: 9.12.288

◆ getSourceLineAtAddress() [2/2]

CLineLocation isys::CDebugFacade::getSourceLineAtAddress	(	ADDRESS_64	address,
		bool	isExact,
		bool	isAbsolutePath )

See documentation of CAddressController::getSourceLineAtAddress(ADDRESS_64, bool, bool).

Since: 9.12.288

◆ getSourceLineAtAddressAtPathSource() [1/2]

CLineLocation isys::CDebugFacade::getSourceLineAtAddressAtPathSource	(	ADDRESS_64	address,
		bool	isExact,
		bool	isAbsolutePath,
		const CAddressController::EPathSource &	source )

See documentation of CAddressController::getSourceLineAtAddressAtPathSource(ADDRESS_64, bool, bool, const CAddressController::EPathSource&).

Since: 9.12.288

◆ getSourceLineAtAddressAtPathSource() [2/2]

CLineLocation isys::CDebugFacade::getSourceLineAtAddressAtPathSource	(	ADDRESS_64	address,
		const CAddressController::EPathSource &	source )

See documentation of CAddressController::getSourceLineAtAddressAtPathSource(ADDRESS_64, const CAddressController::EPathSource&).

Since: 9.12.288

◆ getSymbolAtAddress()

std::string isys::CDebugFacade::getSymbolAtAddress	(	isys::IConnectDebug::ESymbolFlags	symbolType,
		uint8_t	memArea,
		ADDRESS_64	address,
		isys::IConnectDebug::ESymbolFlags	scope = isys::IConnectDebug::sScopeExact )

See documentation of CAddressController::getSymbolAtAddress(isys::IConnectDebug::ESymbolFlags, uint8_t, ADDRESS_64, isys::IConnectDebug::ESymbolFlags).

Since: 9.12.288

◆ getSymbolInfo()

CSymbolInfo isys::CDebugFacade::getSymbolInfo	(	uint32_t	flags,
		const std::string &	expression )

See documentation of CAddressController::getSymbolInfo(uint32_t, const std::string &).

Since: 9.12.288

◆ getVariableAddress()

CMemAddress isys::CDebugFacade::getVariableAddress ( const std::string & variableName )

See documentation of CAddressController::getVariableAddress(const std::string &).

Since: 9.12.288

◆ gotoAddress()

void isys::CDebugFacade::gotoAddress	(	uint8_t	memArea,
		ADDRESS_64	address )

See documentation of CExecutionController#gotoAddress(uint8_t, ADDRESS_64).

Since: 9.12.288

◆ gotoFunction()

void isys::CDebugFacade::gotoFunction ( const std::string & functionName )

See documentation of CExecutionController#gotoFunction(const std::string &).

Since: 9.12.288

◆ modify() [1/4]

std::string isys::CDebugFacade::modify	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		const std::string &	expression,
		const CValueType &	value,
		bool	readBack = true )

See documentation of CDataController#modify(IConnectDebug::EAccessFlags, const std::string &, const CValueType &, bool).

Since: 9.12.288

◆ modify() [2/4]

std::string isys::CDebugFacade::modify	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		const std::string &	expression,
		const std::string &	value,
		bool	readBack = true )

See documentation of CDataController#modify(IConnectDebug::EAccessFlags, const std::string &, const std::string &, bool).

Since: 9.12.288

◆ modify() [3/4]

std::string isys::CDebugFacade::modify	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		isys::IConnectDebug::EEvaluate	evaluateFlags,
		const std::string &	expression,
		const CValueType &	value,
		bool	readBack = true )

See documentation of CDataController#modify(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &, const CValueType &, bool).

Since: 9.12.288

◆ modify() [4/4]

std::string isys::CDebugFacade::modify	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		isys::IConnectDebug::EEvaluate	evaluateFlags,
		const std::string &	expression,
		const std::string &	value,
		bool	readBack = true )

See documentation of CDataController#modify(IConnectDebug::EAccessFlags, IConnectDebug::EEvaluate, const std::string &, const std::string &, bool).

Since: 9.12.288

◆ readMemory()

std::vector< uint8_t > isys::CDebugFacade::readMemory	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		uint8_t	memArea,
		ADDRESS_64	aAddress,
		ADDRESS_64	aNumMAUs,
		uint8_t	bytesPerMAU )

See documentation of CDataController#readMemory(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, ADDRESS_64, BYTE) .

Since: 9.12.288

◆ readRegister()

CValueType isys::CDebugFacade::readRegister	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		const std::string &	registerName )

See documentation of CDataController#readRegister(IConnectDebug::EAccessFlags, const std::string &).

Since: 9.12.288

◆ readValue()

CValueType isys::CDebugFacade::readValue	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		uint8_t	memArea,
		ADDRESS_64	aAddress,
		const SType &	type )

See documentation of CDataController#readValue(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, const SType &).

Since: 9.12.288

◆ reapplyAll()

int isys::CDebugFacade::reapplyAll ( )

See documentation of CBreakpointController#reapplyAll().

Since: 9.12.288

◆ reset()

void isys::CDebugFacade::reset ( )

See documentation of CExecutionController#reset().

Since: 9.12.288

◆ run() [1/2]

int isys::CDebugFacade::run ( )

See documentation of CExecutionController#run().

Since: 9.12.288

◆ run() [2/2]

int isys::CDebugFacade::run ( CExecutionController::ETimeoutMode timeoutMode )

See documentation of CExecutionController#run(CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ runUntilAddress() [1/2]

int isys::CDebugFacade::runUntilAddress	(	uint8_t	memArea,
		ADDRESS_64	address )

See documentation of CExecutionController#runUntilAddress(uint8_t, ADDRESS_64).

Since: 9.12.288

◆ runUntilAddress() [2/2]

int isys::CDebugFacade::runUntilAddress	(	uint8_t	memArea,
		ADDRESS_64	address,
		CExecutionController::ETimeoutMode	timeoutMode )

See documentation of CExecutionController#runUntilAddress(uint8_t, ADDRESS_64, CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ runUntilExpression() [1/2]

int isys::CDebugFacade::runUntilExpression ( const std::string & expression )

This method evaluates the given expression, which must evaluate to address.

Then it runs the target with runUntilAddress. This method aggregates calls to CDataController#evaluate and CExecutionController#runUntilAddress and does not have equivalent in CExecutionController. This method returns immediately - the target may still be in running mode after return!

Parameters

expression

expression, which evaluates to address. This can be one of

function name, for example 'main'
label, for example 'calc_speed_EXIT'
literal value, for example '0x40004356'
expression, for example: '&main + 0x42'. Note the '&' before main!

Returns: S_OK if operation passed, ICONNECT_E_TIMEOUT in case of timeout or ICONNECT_S_MSG_WARN in case of a warning Python example: test_run_until_expression.py

Since: 9.12.288

◆ runUntilExpression() [2/2]

int isys::CDebugFacade::runUntilExpression	(	const std::string &	expression,
		CExecutionController::ETimeoutMode	timeoutMode )

This method evaluates the given expression, which must evaluate to address.

Then it runs the target with runUntilAddress. This method aggregates calls to CDataController#evaluate and CExecutionController#runUntilAddress and does not have equivalent in CExecutionController.

Parameters

expression	expression, which evaluates to address. This can be one of function name, for example 'main' label, for example 'calc_speed_EXIT' literal value, for example '0x40004356' expression, for example: '&main + 0x42'. Note the '&' before main!
timeoutMode	timeout mode

Returns: S_OK if operation passed, ICONNECT_E_TIMEOUT in case of timeout or ICONNECT_S_MSG_WARN in case of warning Python example: test_run_until_expression.py

Since: 9.12.288

◆ runUntilFunction() [1/2]

int isys::CDebugFacade::runUntilFunction ( const std::string & functionName )

See documentation of CExecutionController#runUntilFunction(const std::string &).

Since: 9.12.288

◆ runUntilFunction() [2/2]

int isys::CDebugFacade::runUntilFunction	(	const std::string &	functionName,
		CExecutionController::ETimeoutMode	timeoutMode )

See documentation of CExecutionController#runUntilFunction(const std::string &, CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ runUntilReturn() [1/2]

int isys::CDebugFacade::runUntilReturn ( )

See documentation of CExecutionController#runUntilReturn().

Since: 9.12.288

◆ runUntilReturn() [2/2]

int isys::CDebugFacade::runUntilReturn ( CExecutionController::ETimeoutMode timeoutMode )

See documentation of CExecutionController#runUntilReturn(isys::CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ setBP() [1/3]

int isys::CDebugFacade::setBP	(	const std::string &	symbolName,
		int	conditionCount = 0,
		const std::string &	conditionExpression = "" )

See documentation of CBreakpointController#setBP(const std::string &, int, const std::string &).

Since: 9.12.288

◆ setBP() [2/3]

int isys::CDebugFacade::setBP	(	int	lineNumber,
		const std::string &	fileName,
		int	conditionCount = 0,
		const std::string &	conditionExpression = "" )

See documentation of CBreakpointController#setBP(int, const std::string &, int, const std::string &).

Since: 9.12.288

◆ setBP() [3/3]

int isys::CDebugFacade::setBP	(	int	memArea,
		ADDRESS_64	address,
		int	conditionCount = 0,
		const std::string &	conditionExpression = "" )

See documentation of CBreakpointController#setBP(int, ADDRESS_64, int, const std::string &).

Since: 9.12.288

◆ setEnabled() [1/3]

int isys::CDebugFacade::setEnabled	(	bool	isEnabled,
		const std::string &	fileName,
		int	lineNumber )

See documentation of CBreakpointController#setEnabled(bool, const std::string &, int).

Since: 9.12.288

◆ setEnabled() [2/3]

int isys::CDebugFacade::setEnabled	(	bool	isEnabled,
		const std::string &	symbolName )

See documentation of CBreakpointController#setEnabled(bool, const std::string &).

Since: 9.12.288

◆ setEnabled() [3/3]

int isys::CDebugFacade::setEnabled	(	bool	isEnabled,
		int	memArea,
		ADDRESS_64	address )

See documentation of CBreakpointController#setEnabled(bool, int, ADDRESS_64).

Since: 9.12.288

◆ setEnabledAll()

int isys::CDebugFacade::setEnabledAll ( bool isEnabled )

See documentation of CBreakpointController#setEnabledAll(bool).

Since: 9.12.288

◆ setHWBP() [1/2]

int isys::CDebugFacade::setHWBP	(	uint32_t	rwAccess,
		uint32_t	accessSize,
		uint32_t	usedDataBytes,
		bool	isEntireObject,
		const std::string &	symbolName,
		uint32_t	data )

See documentation of CBreakpointController#setHWBP(DWORD, DWORD, DWORD, bool, const std::string &, DWORD).

Since: 9.12.288

◆ setHWBP() [2/2]

int isys::CDebugFacade::setHWBP	(	uint32_t	rwAccess,
		uint32_t	accessSize,
		uint32_t	usedDataBytes,
		int	memArea,
		ADDRESS_64	address,
		uint32_t	data )

See documentation of CBreakpointController#setHWBP(DWORD, DWORD, DWORD, int, ADDRESS_64, DWORD).

Since: 9.12.288

◆ setHWEnabled() [1/2]

int isys::CDebugFacade::setHWEnabled	(	bool	isEnabled,
		const std::string &	symbolName )

See documentation of CBreakpointController#setHWEnabled(bool, const std::string &).

Since: 9.12.288

◆ setHWEnabled() [2/2]

int isys::CDebugFacade::setHWEnabled	(	bool	isEnabled,
		int	memArea,
		ADDRESS_64	address )

See documentation of CBreakpointController#setHWEnabled(bool, int, ADDRESS_64).

Since: 9.12.288

◆ setHWEnabledAll()

int isys::CDebugFacade::setHWEnabledAll ( bool isEnabled )

See documentation of CBreakpointController#setHWEnabledAll(bool).

Since: 9.12.288

◆ setPollingEnabled()

void isys::CDebugFacade::setPollingEnabled ( bool isEnabled )

See documentation of CExecutionController#setPollingEnabled(bool).

Since: 9.12.288

◆ setSlowRun()

int isys::CDebugFacade::setSlowRun ( bool isSlowRun )

See documentation of CExecutionController#setSlowRun(bool).

Since: 9.12.288

◆ stepHigh()

void isys::CDebugFacade::stepHigh	(	CExecutionController::ETimeoutMode	timeoutMode = CExecutionController::TOUT_10s,
		bool	throwOnTimeout = true )

See documentation of CExecutionController#stepHigh().

Since: 9.12.288

◆ stepInst()

void isys::CDebugFacade::stepInst	(	CExecutionController::ETimeoutMode	timeoutMode = CExecutionController::TOUT_10s,
		bool	throwOnTimeout = true )

See documentation of CExecutionController#stepInst().

Since: 9.12.288

◆ stepOverHigh()

void isys::CDebugFacade::stepOverHigh	(	CExecutionController::ETimeoutMode	timeoutMode = CExecutionController::TOUT_10s,
		bool	throwOnTimeout = true )

See documentation of CExecutionController#stepOverHigh(CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ stepOverInst()

void isys::CDebugFacade::stepOverInst	(	CExecutionController::ETimeoutMode	timeoutMode = CExecutionController::TOUT_10s,
		bool	throwOnTimeout = true )

See documentation of CExecutionController#stepOverInst(CExecutionController::ETimeoutMode, bool).

Since: 9.12.288

◆ stop()

void isys::CDebugFacade::stop ( )

See documentation of CExecutionController#stop().

Since: 9.12.288

◆ waitUntilStopped()

bool isys::CDebugFacade::waitUntilStopped	(	int	timeoutMs = 0,
		uint32_t	pollingIntervalMs = 100 )

See documentation of CExecutionController#waitUntilStopped(int, uint32_t, bool).

Since: 9.12.288

◆ waitWhileRunning()

bool isys::CDebugFacade::waitWhileRunning	(	int	timeoutMs,
		uint32_t	pollingIntervalMs = 100 )

See documentation of CExecutionController#waitWhileRunning(int, uint32_t, bool).

Since: 9.12.288

◆ writeMemory()

std::vector< uint8_t > isys::CDebugFacade::writeMemory	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		uint8_t	memArea,
		ADDRESS_64	aAddress,
		ADDRESS_64	aNumMAUs,
		uint8_t	bytesPerMAU,
		std::vector< uint8_t > &	buff )

See documentation of CDataController#writeMemory(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, ADDRESS_64, BYTE, std::vector<BYTE> &).

Since: 9.12.288

◆ writeRegister()

void isys::CDebugFacade::writeRegister	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		const std::string &	registerName,
		const CValueType &	registerInfo )

See documentation of CDataController#writeRegister(IConnectDebug::EAccessFlags, const std::string &, const CValueType &).

Since: 9.12.288

◆ writeValue() [1/2]

void isys::CDebugFacade::writeValue	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		bool	isRefreshWinIDEAGUIAfterWrite,
		uint8_t	memArea,
		ADDRESS_64	aAddress,
		const CValueType &	value )

See documentation of CDataController#writeValue(IConnectDebug::EAccessFlags, bool, BYTE, ADDRESS_64, const CValueType &).

Since: 9.12.288

◆ writeValue() [2/2]

void isys::CDebugFacade::writeValue	(	isys::IConnectDebug::EAccessFlags	accessFlags,
		uint8_t	memArea,
		ADDRESS_64	aAddress,
		const CValueType &	value )

See documentation of CDataController#writeValue(IConnectDebug::EAccessFlags, BYTE, ADDRESS_64, const CValueType &).

Since: 9.12.288

winIDEA SDK

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CDebugFacade()

◆ ~CDebugFacade()

Member Function Documentation

◆ adjustAddressExpression()

◆ call()

◆ deleteAll()

◆ deleteAllHWBP()

◆ deleteBP() [1/3]

◆ deleteBP() [2/3]

◆ deleteBP() [3/3]

◆ deleteHWBP() [1/2]

◆ deleteHWBP() [2/2]

◆ download()

◆ evaluate() [1/2]

◆ evaluate() [2/2]

◆ getAddressController()

◆ getAddressOfSourceLine()

◆ getAddressOfSourceLineAtPathSource()

◆ getBreakpointController()

◆ getCodeArea()

◆ getCPUInfo()

◆ getCPUStatus()

◆ getDataController()

◆ getExecutionController()

◆ getExpressionAddress()

◆ getFunctionAddress()

◆ getLabelAddress()

◆ getLoaderController()

◆ getMemoryAreaBytesPerMAU()

◆ getSourceLineAtAddress() [1/2]

◆ getSourceLineAtAddress() [2/2]

◆ getSourceLineAtAddressAtPathSource() [1/2]

◆ getSourceLineAtAddressAtPathSource() [2/2]

◆ getSymbolAtAddress()

◆ getSymbolInfo()

◆ getVariableAddress()

◆ gotoAddress()

◆ gotoFunction()

◆ modify() [1/4]

◆ modify() [2/4]

◆ modify() [3/4]

◆ modify() [4/4]

◆ readMemory()

◆ readRegister()

◆ readValue()

◆ reapplyAll()

◆ reset()

◆ run() [1/2]

◆ run() [2/2]

◆ runUntilAddress() [1/2]

◆ runUntilAddress() [2/2]

◆ runUntilExpression() [1/2]

◆ runUntilExpression() [2/2]

◆ runUntilFunction() [1/2]

◆ runUntilFunction() [2/2]

◆ runUntilReturn() [1/2]

◆ runUntilReturn() [2/2]

◆ setBP() [1/3]

◆ setBP() [2/3]

◆ setBP() [3/3]

◆ setEnabled() [1/3]

◆ setEnabled() [2/3]

◆ setEnabled() [3/3]

◆ setEnabledAll()

◆ setHWBP() [1/2]

◆ setHWBP() [2/2]

◆ setHWEnabled() [1/2]

◆ setHWEnabled() [2/2]

◆ setHWEnabledAll()

◆ setPollingEnabled()

◆ setSlowRun()

◆ stepHigh()

◆ stepInst()

◆ stepOverHigh()

◆ stepOverInst()

◆ stop()

◆ waitUntilStopped()