get_symbol_at_address.py

# This script is licensed under BSD License, see file LICENSE.txt.
#
# (c) TASKING Germany GmbH, 2023
 
"""
TODO_MK: move one example for sFunctions to test_getSymbolAtAddress, then delete this file.
 
This script demonstrates obtaining of function at the given memory
address.
"""
 
import isystem.connect as ic
import sys
 
# First we obtain connection and controller objects
 
winidea_id = ''
 
 
cmgr = ic.ConnectionMgr()
cmgr.connect(ic.CConnectionConfig().instanceId(winidea_id))
 
debugCtrl = ic.CDebugFacade(cmgr)
 
debugCtrl.download()
debugCtrl.runUntilFunction('main', ic.CExecutionController.TOUT_10s)
 
status = debugCtrl.getCPUStatus()
 
# Both prints statements print 'main' because target stopped at the start
# address of the function.
print('Current function, default scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                       status.getExecutionArea(),
                                                                       status.getExecutionPoint()))
 
print('Current function, exact scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                       status.getExecutionArea(),
                                                                       status.getExecutionPoint(),
                                                                       ic.IConnectDebug.sScopeExact))
# now we performs some steps, to get into the function
debugCtrl.stepOverHigh()
debugCtrl.stepOverHigh()
debugCtrl.stepOverHigh()
 
status = debugCtrl.getCPUStatus()
# The first two print statements print empty string as function name, because
# target stopped somewhere inside of the function. The next two statements print
# 'main'. 
print('Current function, default scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                         status.getExecutionArea(),
                                                                         status.getExecutionPoint()))
 
print('Current function, exact scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                       status.getExecutionArea(),
                                                                       status.getExecutionPoint(),
                                                                       ic.IConnectDebug.sScopeExact))
 
print('Current function, narrow scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                        status.getExecutionArea(),
                                                                        status.getExecutionPoint(),
                                                                        ic.IConnectDebug.sScopeNarrow))
 
print('Current function, wide scope: ' + debugCtrl.getSymbolAtAddress(ic.IConnectDebug.sFunctions,
                                                                      status.getExecutionArea(),
                                                                      status.getExecutionPoint(),
                                                                      ic.IConnectDebug.sScopeWide))