Bkavanagh at 06:33, 18 January 2023

2023-01-18T06:33:45Z

← Older revision		Revision as of 06:33, 18 January 2023
Line 89:		Line 89:
	<youtube>https://youtu.be/bugClr0kYcE</youtube>		<youtube>https://youtu.be/bugClr0kYcE</youtube>

	[~~http~~://~~jira~~.ocetechnology.com~~:22091~~/Tcfmulti.mp4 Use this link if problems with youtube above]		[https://wiki.ocetechnology.com/Tcfmulti.mp4 Use this link if problems with youtube above]

	== Debugging multi-core program (multiple ELF image files) ==		== Debugging multi-core program (multiple ELF image files) ==
Line 156:		Line 156:
	<youtube>https://youtu.be/1IgGGY8CDXk</youtube>		<youtube>https://youtu.be/1IgGGY8CDXk</youtube>

	[~~http~~://~~jira~~.ocetechnology.com~~:22091~~/Tcfmultiimage.mp4 Use this link if problems with youtube above]		[https://wiki.ocetechnology.com/Tcfmultiimage.mp4 Use this link if problems with youtube above]
	= Debugging Source code with Eclipse, GDB and DMON =		= Debugging Source code with Eclipse, GDB and DMON =

Line 207:		Line 207:
	<youtube>https://youtu.be/1IYdakrRlIw</youtube>		<youtube>https://youtu.be/1IYdakrRlIw</youtube>

	[~~http~~://~~jira~~.ocetechnology.com~~:22091~~/Gdb.mp4 Use this link if problems with youtube above]		[https://wiki.ocetechnology.com/Gdb.mp4 Use this link if problems with youtube above]


	[[Category:backup]]		[[Category:backup]]

Bkavanagh: /* Debugging the source code */

2023-01-18T06:28:58Z

Debugging the source code

← Older revision		Revision as of 06:28, 18 January 2023
Line 68:		Line 68:
	<youtube>https://youtu.be/XAjSUXpfztk</youtube>		<youtube>https://youtu.be/XAjSUXpfztk</youtube>

	[~~http~~://~~jira~~.ocetechnology.com~~:22091~~/Tcfsingle.mp4 Use this link if problems with youtube above]		[https://wiki.ocetechnology.com/Tcfsingle.mp4 Use this link if problems with youtube above]

	== Debugging multi-core program (single ELF image file) ==		== Debugging multi-core program (single ELF image file) ==

imported>Bkavanagh: /* Debugging multi-core program (single ELF image file) */

2020-09-14T15:54:01Z

Debugging multi-core program (single ELF image file)

← Older revision	Revision as of 15:54, 14 September 2020
(No difference)

imported>Bkavanagh: /* Debugging multi-core program (single ELF image file) */

2020-09-14T15:54:01Z

Debugging multi-core program (single ELF image file)

← Older revision		Revision as of 15:54, 14 September 2020
Line 75:		Line 75:
	The sample code used in this tutorial can be copied from here [[FFTCPU0.c]] and [[fft.h]]		The sample code used in this tutorial can be copied from here [[FFTCPU0.c]] and [[fft.h]]

	The script to set up all 4 CPUs can be found here [[~~mp_script~~.txt]]		The script to set up all 4 CPUs can be found here [[mp-script.txt]]

	Use sparc-elf-gcc-4.4.2 to build FFT project with linker flags: -Ttext=0x60000000 -lm		Use sparc-elf-gcc-4.4.2 to build FFT project with linker flags: -Ttext=0x60000000 -lm

imported>Bkavanagh: 1 revision imported

2020-09-11T08:51:18Z

1 revision imported

← Older revision	Revision as of 08:51, 11 September 2020
(No difference)

oce-wiki>Bkavanagh: 1 revision imported

2020-09-09T15:10:48Z

1 revision imported

New page

= Debugging source code with Eclipse TCF =

== Eclipse TCF Introduction ==

TCF is a vendor-neutral, lightweight, extensible network protocol mainly for communicating with embedded systems (targets). TCF uses JSON (JavaScript Object Notation) as its preferred data marshalling language and supports auto-discovery of targets and services. TCF is intended to become a replacement for protocols like the GDB Serial, WDB, and GDB/MI protocols used for embedded software development. More information can be found at https://www.eclipse.org/tcf/

Eclipse TCF plug-in can be downloaded from https://www.eclipse.org/tcf/downloads.php. The user needs to select TCF plug-in compatible with installed version of Eclipse.

TCF is supported by DMON from 2.1.0.0 version.

== Installing Eclipse TCF ==

'''To install TCF plug-in in older versions of Eclipse :'''

* Eclipse Menu => Help => Install New Software...
* From https://www.eclipse.org/tcf/downloads.php copy "p2 software repository", compatible with version of Eclipse installed on your system
* Replace "type or select a site" with copied link and press "Add.."

[[File:InstallTCF.png|800px|thumb|none|Install New Software Dialog]]

* Check "Target Commubication Framework" and click "Next>"
* Follow instruction to set up plug-in.

'''To install TCF plug-in in Eclipse from 2018 :'''

* Check if TCF Launch is not available in Debug configurations
* Eclipse Menu => Help => Install New Software...
* Select "type or select a site" with --All Available Sites-- from drop down menu
* Set tcf on next line to filter out only tcf entries

[[File:Tcf-install.png|800px|thumb|none|Install New Software Dialog]]

* Check "C/C++ Remote Launcher" and "TCF C/C++ Debugger" and click "Next>"
* Follow instruction to set up plug-in.

== Starting DMON ==

DMON acts as agent between Eclipse TCF plug-in and target. To activate TCF functionality DMON should be started with "-tcf" switch. TCF icon should appear at the bottom of DMON window.

[[File:DmonTcfView.png|800px|thumb|none|DMON switches used]]

[[File:DmonTcfConsole.png|800px|thumb|none|DMON Console]]

Now DMON is ready for connection. While Eclipse is connected to DMON, DMON commands can be used in parallel. For example, when breakpoint is hit, user can examine memory, registers or cache using DMON commands.

== Creating TCF Debug Configurations ==

* Open Debug Configurations in Eclipse
* Select 'Target Communication Framework' and press 'New' button to create a configuration of the selected type

[[File:DebugConfigTcf.png|800px|thumb|none|Eclipse Debug Configurations]]

* Change Name of Configuration if have to. In the 'Available targets' DMON Agent should be listed. If not, make sure that DMON is started and '-tcf' switch was used

[[File:TcfConfig1.png|800px|thumb|none|TCF Configurations]]

* Select 'Application' tab in 'Debug Configurations' dialog. Set 'Project Name', 'Local File Path' and check or clear available check boxes like 'Stop at main' or 'Stop at program entry'

[[File:TcfConfig21.png|800px|thumb|none|TCF Application Configurations]]

* Press 'Debug' to start debugging process

== Debugging the source code ==

'''Debugging source code using Eclipse TCF plug-in and DMON tutorial''':

<youtube>https://youtu.be/XAjSUXpfztk</youtube>

[http://jira.ocetechnology.com:22091/Tcfsingle.mp4 Use this link if problems with youtube above]

== Debugging multi-core program (single ELF image file) ==

The sample code used in this tutorial can be copied from here [[FFTCPU0.c]] and [[fft.h]]

The script to set up all 4 CPUs can be found here [[mp_script.txt]]

Use sparc-elf-gcc-4.4.2 to build FFT project with linker flags: -Ttext=0x60000000 -lm

* Build Project
* Add script to initialize all 4 CPUs before start using DMON 'prerun mp_script.txt' command
* Modify TCF Debug Configurations
* Set Break points
* Start application

'''Multiprocessors Debugging using Eclipse TCF plug-in and DMON tutorial''':

<youtube>https://youtu.be/bugClr0kYcE</youtube>

[http://jira.ocetechnology.com:22091/Tcfmulti.mp4 Use this link if problems with youtube above]

== Debugging multi-core program (multiple ELF image files) ==

One project for each CPU must be created. If 4 CPUs on the target then 4 projects have to be created in Eclipse.
The CPU0 project must be first to start and other ELF images can be loaded to the target memory for each CPU using "preproc" DMON command.

The text section of each ELF file can be defined by :
<nowiki>
-Wl,-Ttext,0x40000000
</nowiki>
passed to the linker. When DMON loads ELF image to memory using "load add[cpu1] dwarf imageName" the Program Counter for CPU1 is set to start of text section of this image.

Each CPU must have own stack pointer as well.

Sample preproc.script :
<nowiki>
load add[cpu1] dwarf imageForcpu1
load add[cpu2] dwarf imageForcpu2
load add[cpu3] dwarf imageForcpu3

stack SRAM_0_END - 0x000010 cpu0
stack SRAM_0_END - 0x100000 cpu1
stack SRAM_0_END - 0x200000 cpu2
stack SRAM_0_END - 0x300000 cpu3
</nowiki>

DMON command should be called before debugging started:

<nowiki>
preproc pathToPreproc.script
</nowiki>

'''NOTE: DMON "load add[cpu1]" command sets, for example, entry point for CPU1 to the begging of text section of EFL file. It means that CPU1 is running start up code and initialization which CPU0 has done already.'''
'''If CPU0 has initialized and started using timer for system time then CPU1 will reset the same timer again and time for CPU0 is not correct any more. To avoid this DMON "ep" command can be used to set entry point for each CPU at''' "main",
'''as all initialization is done by CPU0.'''

Then preproc.script could look like this :

<nowiki>
load add[cpu1] dwarf imageForcpu1
load add[cpu2] dwarf imageForcpu2
load add[cpu3] dwarf imageForcpu3

ep cpu1:main cpu1
ep cpu2:main cpu2
ep cpu3:main cpu3

stack SRAM_0_END - 0x000010 cpu0
stack SRAM_0_END - 0x100000 cpu1
stack SRAM_0_END - 0x200000 cpu2
stack SRAM_0_END - 0x300000 cpu3
</nowiki>

'''<big>If this script is modified it must be removed first "preproc remove all" and loaded again "preproc pathToPreproc.script"</big>'''.
* Build All Projects
* Start DMON with normally used switches plus "-tcf"
* Run "preproc" DMON command to add script to load the rest of ELF images and initialize all 4 CPUs
* Modify TCF Debug Configurations for CPU0
* Set Break points
* Start application

'''Multi-core Debugging with multiple ELF files using Eclipse TCF plug-in and DMON''':

<youtube>https://youtu.be/1IgGGY8CDXk</youtube>

[http://jira.ocetechnology.com:22091/Tcfmultiimage.mp4 Use this link if problems with youtube above]
= Debugging Source code with Eclipse, GDB and DMON =

* Download latest Eclipse IDE for C/C++ Developers from https://www.eclipse.org
* Unzip
* Unzip Compilers needed to c:\opt (i.e. C:\opt\sparc-elf-4.4.2-mingw)
* Add “C:\opt\sparc-elf-4.4.2-mingw\bin” and “C:\opt\sparc-elf-4.4.2-mingw\sparc-elf\bin” to System Path
* Download and install CYGWIN from https://www.cygwin.com/
* Add C:\cygwin\bin to the System Path at the beginning
* Install DMON, follow readme in DMON folder
* Start Eclipse
* Select File -> New -> C Project in Eclipse

[[File:ConfigWindows.png|800px|thumb|none|Create C Project]]

* Select “Empty Project” or “ Hello world ANSI C Project” and Toolchains : “Cross GCC”
* Select 'Next' to last Dialog to set cross compilers prefix and Path to bin folder and press 'Finish' to create new C project

[[File:SelectPrefix.png|800px|thumb|none|Modify Cross Compiler]]

* Build the Project
* Select 'Debug Configurations' and create new 'GDB Hardware Debugging'. Set Project and application

[[File:NewConfig.png|800px|thumb|none|Create New GDB Hardware Debugging]]

* Configure 'Debugger' section

[[File:GdbConfig.png|800px|thumb|none|Set Up GDB]]

* Configure 'Startup' section if you need

[[File:SetupConfig.png|800px|thumb|none|Set Up Startup]]

* Press 'Debug' to start debugging. The Program should stop at 'main'.

[[File:EclipseSession.png|800px|thumb|none|Debugging]]

'''Debugging source code using Eclipse, GDB and DMON tutorial''':

<youtube>https://youtu.be/1IYdakrRlIw</youtube>

[http://jira.ocetechnology.com:22091/Gdb.mp4 Use this link if problems with youtube above]

[[Category:backup]]

DMON Eclipse debug - Revision history

Bkavanagh at 06:33, 18 January 2023

Bkavanagh: /* Debugging the source code */

imported>Bkavanagh: /* Debugging multi-core program (single ELF image file) */

imported>Bkavanagh: /* Debugging multi-core program (single ELF image file) */

imported>Bkavanagh: 1 revision imported

oce-wiki>Bkavanagh: 1 revision imported