Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
inbox:eclipse [2020/04/05 01:15] – #2 noblepepperinbox:eclipse [2021/10/15 08:21] – ↷ Links adapted because of a move operation bobafetthotmail
Line 1: Line 1:
- 
 ====== Using Eclipse for C/C++ Programming and Debugging ====== ====== Using Eclipse for C/C++ Programming and Debugging ======
  
 When you develop a new program or adapt an existing program for use on OpenWrt a graphical ide like [[https://www.eclipse.org/ide/|Eclipse]] can be useful especially for debugging. When you develop a new program or adapt an existing program for use on OpenWrt a graphical ide like [[https://www.eclipse.org/ide/|Eclipse]] can be useful especially for debugging.
  
-This tutorial was was developed and tested on a fresh install of Debian 10 in VirtualBox and a Buffalo WZR-600DHP running OpenWrt 19.07.2 but it shouldn'be difficult to adapt it to your preferred systems.+This howto was was developed and tested on a fresh install of Debian 10 in VirtualBox, Eclipse Version: 2020-03 (4.15.0) and a Buffalo WZR-600DHP running OpenWrt 19.07.2. Minor changes may be needed to adapt it to your preferred systems. 
 +The directory layout used was 
 + 
 +<code>/home/pep/Hack 
 +  ->openwrt 
 +  ->openwrt-sdk-19.07.2-ath79-generic_gcc-7.5.0_musl.Linux-x86_64 
 +  ->eclipse 
 +    ->eclipse-workspace 
 +</code> 
 + 
 +You can certainly use a different layout but you will need to adapt some paths in this howto if you put things somewhere else. 
 +   
 +1. Get a functioning build system.  
 + 
 +You can use the [[docs/guide-developer/using_the_sdk|OpenWrt SDK]] or you can [[docs/guide-developer/build-system/start|build your own]]. If you use the SDK, the instruction page hadn't been updated when this was written but 19.07.2 SDKs were available, this tutorial was tested with [[https://downloads.openwrt.org/releases/19.07.2/targets/ath79/generic/openwrt-sdk-19.07.2-ath79-generic_gcc-7.5.0_musl.Linux-x86_64.tar.xz|this SDK version]]. If you build your own you need to [[docs:guide-developer:toolchain:install-buildsystem|install the build system]] 
 +and [[docs/guide-developer/build-system/use-buildsystem|build an image for your platform]]. This tutorial was tested by checking out v19.07.2 with and configuring for a ATH79 Target System and Buffalo WZR-HP-300H Target Profile. 
 + 
 +2. Install Eclipse 
 + 
 +Eclipse itself is simple to install, just download the installer from [[https://www.eclipse.org/downloads/]] untar it, change into the directory created and run ./eclipse-inst. Select Eclipse IDE for C/C%%++%% Developers, enter the location where you want eclipse installed in the first dialog and enter the location for the workspace in the first dialog after launching eclipse for the first time. 
 +  
 +You need to install some eclipse plugins, this is done through the Install New Software... entry on the Help menu. In the Available Software dialog, select --All Available Sites-- in the Work with dropbox and enter remote in the filter textbox. Now find and check 
 +<code> 
 +C/C++ Remote Launch Developer Resources 
 +Remote System Explorer End-User Runtime 
 +Remote Launch Targets Developer Resources 
 +Terminal (Console) View Developer Resources 
 +</code> 
 +Click Next twice, accept license terms and then click Finish. Allow eclipse to restart itself. 
 + 
 + 
 +3. Find your toolchain location and prefix and gdb executable. 
 + 
 +Toolchain location is <buildsystem root>/staging_dir/toolchain-<whatever>/bin 
 + 
 +Toolchain prefix is the part of the filenames in the toolchain directory before the tool name. For example, if you see a file named mips-openwrt-linux-musl-gcc, the toolchain prefix is mips-openwrt-linux-musl-. 
 + 
 +The gdb executable is in the toolchain location. 
 + 
 +You can find these by using these commands from the buildsystem root: 
 + 
 +Toolchain location: 
 +<code> 
 +find $(pwd)/staging_dir -type f -name '*-gcc' -printf "%h/\n"|grep -v initial 
 +</code> 
 +Toolchain prefix: 
 +<code> 
 +find $(pwd)/staging_dir -type f -name '*-gcc' -printf "%f\n"|sed s/gcc// 
 +</code> 
 +gdb executable: 
 +<code> 
 +find $(pwd)/staging_dir -type f -name '*-gdb'</code> 
 +4. Cross compile hello world 
 + 
 +On the main menu bar use File->New->C/C%%++%% Project, select the C%%++%% Managed Build option, click next. Name your project (I used hellocpp), select the Hello World C%%++%% Project and Cross GCC Toolchain, click next three times. 
 + 
 +Enter your toolchain location in the Cross compiler path textbox. 
 +For the test system using the locally built toolchain this directory is 
 +<code>/home/pep/Hack/openwrt/staging_dir/toolchain-mips_24kc_gcc-7.5.0_musl/bin/</code>  
 +For the test system using the SDK toolchain this directory is 
 +<code>/home/pep/Hack/openwrt-sdk-19.07.2-ath79-generic_gcc-7.5.0_musl.Linux-x86_64/staging_dir/toolchain-mips_24kc_gcc-7.5.0_musl/bin/</code> Enter your toolchain prefix in the Cross compiler prefix textbox The toolchain prefix for the test system is <code>mips-openwrt-linux-musl-</code> Click Finish 
 + 
 +If you are still on the Welcome Screen, click the Workbench icon in the upper right. Select the project you just created and on the main menubar use Project->Build project and you should see Build Finished. 0 errors, 0 warnings in the Console area. 
 + 
 +5. Set up remote target 
 +Select Window->Show View->Others from the menubar. 
 + 
 +Expand Remote Systems, select Remote Systems from the dialog and click open. 
 + 
 +Select File->New->Other from the menubar 
 + 
 +Expand Remote System Explorer in the dialog, select Connection and click Next 
 + 
 +Select Linux and click next 
 + 
 +Enter your routers ipaddress in the Host name text box, click Next, 
 + 
 +Check the ssh.files checkbox, select Ssh/Sftp File Service, click Next, 
 + 
 +Check the processes.shell.linux checkbox, click Next, 
 + 
 +Check the ssh.shells checkbox, and finally click Finish 
 + 
 +6. Access files on remote system 
 + 
 +In the Remote Systems Tab expand the entry with your router's ipaddress, expand Sftp files, expand the Root entry 
 + 
 +In the Enter Password dialog change the User ID to root, enter your router's password, check Save User ID and Save Password checkboxes. Answer Yes to the questions about connecting over ssh. You can set a password hint if you want but it is not required. 
 + 
 +You can now browse the file system on your router in the Remote Systems tab. 
 + 
 +7. Debugging on remote system 
 + 
 +On the menubar use Run->Debug Configurations, Select C/C%%++%% Remote Application, click on the New Configuration icon 
 + 
 +In the main tab: 
 + 
 +Click the New button next to the Connection Dropdown, use the dropdown to select ssh, Click OK 
 +Enter your router's ipaddress for Host, root for User,  
 +Check password based checkbox, enter password in Password text box. Click Finish. 
 +Select Remote Host in Connection Dropdown 
 + 
 +Enter the program name in the Remote Absolute Path textbox, it must include a path (I use either /hellocpp or /root/hellocpp)  
 + 
 +In the debugger tab: 
 + 
 +In the GDB debugger text box enter the gdb executable found in step 3 
 + 
 +Click Apply, Click Debug 
 + 
 +Allow the IDE to switch to the Debug perspective. The program will launch on the router and stop at the first line in main, you can step, continue, etc with the icons on the toolbar, the ide will follow in the source file tab and output will be shown in the Console tab. 
 +   
 +8. Using existing makefile programs 
 + 
 +9. Debugging existing makefile programs 
 + 
 +10. Credits
  
-First you need to have a functioning build system. You can use the [[docs/guide-developer/using_the_sdk|OpenWrt SDK]] or you can [[docs/guide-developer/build-system/start|build your own]]. If you use the SDK the instruction page hadn't been updated when this was written but 19.07.2 SDKs are available, this tutorial was tested with [[https://downloads.openwrt.org/releases/19.07.2/targets/ath79/generic/openwrt-sdk-19.07.2-ath79-generic_gcc-7.5.0_musl.Linux-x86_64.tar.xz|this SDK version]]. If you build you own you need to [[docs/guide-developer/build-system/install-buildsystem|install the build system]] 
-and [[docs/guide-developer/build-system/use-buildsystem|build and image for your platform]]. This tutorial was tested by checking out v19.07.2 with and configuring for a ATH79 platform and Buffalo WZR-HP-300H target. 
  
-Install Eclipse 
  
-Install "additional software" 
  
-Cross compile hello world 
  
-Set up remote system 
  
-Access files on remote system 
  
-Set up debugging on remote system 
  
-Debugging on remote system 
  
-Using existing makefile programs 
  
-Debugging existing makefile programs 
  
-Credits+{{tag>WIP}}
  
  
  • Last modified: 2021/10/15 09:06
  • by bobafetthotmail