configure_ws_advanced.py

# This script is licensed under BSD License, see file LICENSE.txt.
#
# (c) TASKING Germany GmbH, 2023
 
"""
This script demonstrates how to use WorkspaceConfigurator in order to
create a winIDEA workspace, and configure it to use two different applications
with multiple download files on the same core. It then configures the profiler to 
record both applications at the same time. 
"""
 
import isystem.connect as ic
 
# When using this example, make sure to download also ws_cfg.py from the
# same location as this file.
from ws_cfg import WorkspaceConfigurator
 
 
winidea_id = ''
 
 
def main():
    cmgr = ic.ConnectionMgr()
    cmgr.connect(ic.CConnectionConfig().instanceId(winidea_id))
 
    wsCfg = WorkspaceConfigurator(cmgr)
 
    WORKSPACE_NAME = 'example.xjrf'
    wsCfg.create_workspace(WORKSPACE_NAME)
    wsCfg.set_emulator_type('iC5000')
    wsCfg.set_USB_comm('iC5000 (SN 12345)')
    # wsCfg.set_TCP_comm(IP='12.34.56.78', port='1234')
 
    wsCfg.set_SoC('LS1012A')
 
    wsCfg.add_application('myApplication0')
    wsCfg.add_application('myApplication1')
 
    wsCfg.add_symbol_file('myApplication0', 'program.elf', 'ELF')
    wsCfg.add_symbol_file('myApplication1', 'program2.elf', 'ELF')
 
    wsCfg.add_memory_space('memorySpace0', 'Core0',
                                         'myApplication0', isEnabled=True,
                                          useMsid=True, msidLevel='HV')
    wsCfg.add_memory_space('memorySpace1', 'Core0',
                                         'myApplication1', isEnabled=True,
                                         useMsid=True, msidLevel='VM')
    
    wsCfg.add_program_file('program.elf', 'ELF')
    wsCfg.add_program_file('program2.elf', 'ELF')
    wsCfg.add_program_file('program3.hex', 'HEX', offset=0x1000)
 
    wsCfg.set_demo_mode(True)
 
    # Download required to load symbols.
    debugCtrl = ic.CDebugFacade(cmgr)
    debugCtrl.download()
 
    TRD_FILE_NAME = "sample.trd" 
    # Create a profiler document
    profilerCtrl = ic.CProfilerController2(cmgr, TRD_FILE_NAME, 'w')
 
    analyzerTriggerIdx = wsCfg.create_analyzer_trigger(profilerCtrl, "trigger")
 
    configCtrl = ic.CConfigurationController(cmgr)
 
    # Create analyzer document Option controller instance 
    optDoc = configCtrl.doc(TRD_FILE_NAME)
    optAnalyzerTrigger = configCtrl.doc_an_triggers(optDoc).at(analyzerTriggerIdx)
 
    optProcessTrigger = configCtrl.doc_an_trig_processes(optAnalyzerTrigger)
    wsCfg.remove_existing_process_triggers(optProcessTrigger)
 
    optProcessTrigger0 = wsCfg.add_new_process_trigger(optProcessTrigger,
                                                    "myApplication0", "memorySpace0")
    # Enable profiler data trace
    optProcessTrigger0.set('Profiler.ProfileData', 'true') 
 
    optProcessTrigger1 = wsCfg.add_new_process_trigger(optProcessTrigger,
                                                    "myApplication1", "memorySpace1")
    # Enable profiler data trace
    optProcessTrigger1.set('Profiler.ProfileData', 'true') 
 
    # Create a profiler data option controller for the first and second process trigger 
    optProfilerData0 = configCtrl.doc_an_trig_process_profiler_data(optProcessTrigger0)
 
    optProfilerData1 = configCtrl.doc_an_trig_process_profiler_data(optProcessTrigger1)
 
    wsCfg.add_new_profiler_data_area(optProfilerData0, variableName="iCounter",
                                 appName="myApplication0", memorySpaceName="memorySpace0",
                                 interpretationType="State", accessType="Write")
    wsCfg.add_new_profiler_data_area(optProfilerData1, variableName="iCounter",
                                 appName="myApplication1", memorySpaceName="memorySpace1",
                                 interpretationType="State", accessType="Write")
 
    wsCfg.save_workspace()
    wsCfg.close_workspace()
 
 
if __name__ == "__main__":
    main()