Yocto Programming with Eclipse v2
This guide describes how to use Eclipse to develop and debug applications on the VAR-SOM-MX8M-NANO.
1 Create your rootfs with Eclipse debug support
Append the following to the conf/local.conf file in your Yocto build directory:
EXTRA_IMAGE_FEATURES = " \ eclipse-debug \ ssh-server-openssh \ "
Now bitbake your image.
2 Setup Host Computer Environment
Please follow the steps below to prepare a fresh Ubuntu 20.04 installation for Eclipse debugging:
2.1 Install Dependencies
$ sudo apt-get -y update $ sudo apt-get -y install build-essential gdb gdb-multiarch git default-jre
2.2 Install Yocto Toolchain
To install the toolchain followguide.
2.3 Download Eclipse
Download Eclipse 2021-06 from here: https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2021-06/R/eclipse-cpp-2021-06-R-linux-gtk-x86_64.tar.gz
Run the following command to unpack and install the downloaded Eclipse IDE tarball into a clean directory using the default name eclipse:
$ cd ~ $ tar -xf ~/Downloads/eclipse-cpp-2021-06-R-linux-gtk-x86_64.tar.gz
3 Create and run a simple application
3.1 Run the Eclipse IDE
Run the Eclipse IDE with the following commands:
$ cd eclipse $ ./eclipse
Select a new workspace (you can just click OK).
3.2 Create the Project
You can create different types of projects: C Managed Build, CMake, Meson, or Makefile. This section describes how to create "C Managed Build" projects from within the Eclipse IDE. To create a new project from a "Hello World" template and then display the source code, follow these steps:
- File->New->C/C++ Project
- Select C Managed Build and click Next.
- Enter a name for the project under the Project name field. Do not use hyphens as part of the name.
- Select Hello World ANSI C Project.
- Select Cross GCC toolchain
- Click Next.
- Add information in the Author field and make sure the License field is correct and click Next.
- Accept the default Debug/Release configurations and click Next.
aarch64-poky-linux-under Cross compiler prefix
/opt/fsl-imx-xwayland/4.14-sumo/sysroots/x86_64-pokysdk-linux/usr/bin/aarch64-poky-linuxunder Cross compiler path
- Click "Finish".
- Click on "Workbench".
- You should now be in the C/C++ perspective. The left-hand navigation pane shows your project. You can display your source by double clicking the project's source file.
3.3 Configure Cross Compiler
The sysroot flag must be added to the linker and C/C++ compilers within Eclipse:
- Right click on the project and select Properties
- Under C/C++ Build, select Settings
- Add the following include path to Cross GCC Compiler->Includes
C/C++ Build -> Settings -> Cross GCC Compiler -> Includes
- Append the following to Cross GCC Compiler -> Miscellaneous -> Other Flags:
C/C++ Build -> Settings -> Cross GCC Compiler -> Miscellaneous
- Append the following to Cross GCC Linker -> Miscellaneous -> Other Flags:
C/C++ Build -> Settings -> Cross GCC Linker -> Miscellaneous
3.4 Configure Remote Debugging
Using the console of your target set a password with "passwd" command. choose a simple one named "root".
The target should be connected to the network via Ethernet or WIFI.
Use the "ifconfig" command on the target to get its IP address.
- Click Run->Debug Configurations...
- Double click on C/C++ Remote Application.
- In the Main tab, click on New... to create a new connection.
- Select SSH for the connection type and click OK.
- Enter the Target IP Address.
- Enter root for the user.
- Change to "Password based authentication" and enter password configured in previous step.
- Click Finish
- Type "/home/root/hello-world" in the Remote Absolute File Path for C/C++ Application field
- Click on the Debugger tab
aarch64-poky-linux-gdbin the GDB debugger field
- Click Apply and Close to finish configuring the debugger
3.5 Remote debug
Follow the below steps to remotely debug your application on the VAR-SOM-MX8M-NANO.
- Use the keyboard shortcut ctrl-b to rebuild the application.
- Click the bug icon in the toolbar and select "hello-world debug" (or whichever name you supplied in the previous step)
- Follow the prompt to switch to the Debug perspective
You can now run and debug your program via eclipse. The actual program execution is done on the target, and the output is seen on the Remote Shell on Eclipse.