(optional) Tools to debug the firmware

The following instructions are to install and configure the tools needed to flash and debug the STM8 firmware.

• Install Eclipse
◇ Install Zylincd plugin
• Configure OpenOCD
• Configure Flash and Debug
• Some notes

Install Eclipse

Go to Eclipse site and download Eclipse Neon: http://www.eclipse.org
Why Eclipse Neon version and not the most recent version? Because we will be using Zylincdt plugin that works on Eclispe Neon version but not on the most recent version.

Install Zylincd plugin

On Eclipse, got to Help -> Install new software... and the next link as the source for the plugin, as seen on next picture: http://opensource.zylin.com/zylincdt



Website of the plugin: http://opensource.zylin.com/embeddedcdt.html

Configure OpenOCD

On Eclipse, go to “External tools -> External tools configuration..." and add a new launch configuration, using the following data seen on the next image (adapt for your specific folder names):



If you have the hardware connected and the motor controller powered on, run the configuration you just created and you should see the following on the Eclipse console window:

Configure Flash and Debug

On Eclipse, go to “Debug -> Debug configuration..." and add a new Zylin Embedded debug (Native) configuration, using the following data seen on the next images (adapt for your specific folder names):










With OpenOCD running, run the flash and debug configuration you just created and you should see the following on the Eclipse console window:



Now you can use the options on Eclipse menu Run to run, halt, step, view and edit memory variables, etc, as seen on the next image:

Some notes

Ubuntu 16.04 and Eclipse Mars menu problem

My OS is Ubuntu 16.04. I downloaded Eclipse Version: Mars.2 Release (4.5.2) and I had a problem with the main menu not showing.
I solved it by running Eclipse with UBUNTU_MENUPROXY=0 and the menu is visible but now I have another problem. Some of the options in the menu don't work.
For example the Window->Preferences only shows the General page and I can't select any other option.



Try to start Eclipse after editing your eclipse.ini file and tweaking the launcher entry like this:
--launcher.GTK_version
2
Example file:
-startup
plugins/org.eclipse.equinox.launcher_1.3.100.v20150511-1540.jar
--launcher.GTK_version
2
-product
org.eclipse.epp.package.cpp.product
--launcher.defaultAction
openFile
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=1.7
-XX:MaxPermSize=256m
-Xms256m
-Xmx1024m

See: http://stackoverflow.com/questions/36822242/eclipse-doesnt-work-with-ubuntu-16-04/36859485