How to Add Register Details View in Eclipse

The standard Eclipse registers view only shows the core registers:

Standard Registers View in Eclipse

Standard Registers View in Eclipse

I think it would be great to have a view to see all the device peripheral registers too?

Embedded System Registers View

Embedded System Registers View

If you want the same, then this article is for you. It works both for stock Eclipse and Freescale Kinetis Design Studion (KDS) 🙂

EmbSysRegView Project

An open source project makes it possible: the EmbSysRegView project  (http://embsysregview.sourceforge.net/)

EmbSysRegView Project Page

EmbSysRegView Project Page

The released binaries are hosted on SourceForge (http://sourceforge.net/projects/embsysregview/) and sources are available in a SVN repository at http://sourceforge.net/p/embsysregview/code/HEAD/tree/.

Installation

In Eclipse, use the menu Help > Install New Software and use the following update site:

http://embsysregview.sourceforge.net/update
EmbSysRegView Update from Eclipse

EmbSysRegView Update from Eclipse

Alternativly, the menu Help > Eclipse Marketplace can be used. Search for ‘register view’:

Eclipse Market Place

Eclipse Market Place

Install both the Embedded Systems Register View and the EmbSysRegView Data.

The plugin comes with periperhal (XML) files for many architectures: Atmel, NXP, SiliconLabs, STMicroelectronics, Texas Instruments, Holtek, Nuvoton, Spansion.

❗ As of the current 0.2.4 release of EmbSysRegView, Freescale devices are *not* supported. This is foreseen for 0.2.5. If you are using Freescale devices, follow the steps below to add support for Freescale ARM devices.

XML Device Files

The data plugin installs XML files describing the peripherals in the following folder inside Eclipse (path depends on the version number of the plugin!):

eclipse\plugins\org.eclipse.cdt.embsysregview.data_0.2.4.r168\data
Register Description XML Files

Register Description XML Files

Here I can add extra XML description files to support more microcontroller. The really cool part is that the plugin supports CMSIS-SVD files. SVD (System View Description) files are standard introduced by ARM (see http://www.keil.com/pack/doc/CMSIS/SVD/html/index.html). Originally ARM intended to host on their side all CMSIS-SVD files from all the ARM licensees, but somehow this did not work out (probably because every vendor wanted to their own stuff). But as the EmbSysRegView plugin supports SVD files, and you get them from your vendor (if not already delivered with the plugin), I have peripheral register detail level debugging support 🙂

SVD and Freescale ARM Device Support

The 0.2.4 release (the latest version at the time of writing this article) does *not* support the CMSIS-SVD files produced by Freescale. The reason is that the Freescale CMSIS-SVD files are using SVD files which are not supported by the plugin. For example the files have value entries like

<value>0x</value>
<value>#1xx</value>
<value>10x1</value>

which confuses the EmbSysRegView parser (see http://sourceforge.net/p/embsysregview/patches/21/?limit=25). The 0.2.4 plugin has that fix not included, so I have a patch and extra data files for Freescale users.

 

Freescale Kinetis Patch for v0.2.4

Follow the steps below to apply the patch to the v0.2.4 plugins and data files to support Freescale Kinetis devices:

  1. Make sure that you have the 0.2.4 plugins installed (from above).
  2. Download the latest zip archive file version from here.
  3. Close Eclipse if running.
  4. Unpack the archive files over your ‘eclipse’ folder.
  5. Restart Eclipse.

Using the Plugin

Open the ‘EmbSys Registers’ view (menu Window > Show View > Others > Debug > EmbSys Registers):

Opening the EmbSys Registers View

Opening the EmbSys Registers View

The first time I open that view, it has no chip/device selected:

First time opening the EmbSys Registers View

First time opening the EmbSys Registers View

There are two ways to set the device:

  1. Using the workspace settings with the menu Window > Preferences > C/C++ > Debug > EmbSys Register View:

    EmbSys Register View in Workspace Preferences

    EmbSys Register View in Workspace Preferences

  2. To faster way is to use the little icon in the view itself:

    Icon to select device

    Icon to select device

In the dialog then select the device you want to debug. For Freescale Devices select  SVD(CMSIS).

To read the register values from the device, double-click on the item: the icon turns green:

Double Click to read register values

Double Click to read register values

Double click again to return to ‘do not read from device’ mode.

A drop-down menu in the Hex column is used to change the value, and gives hints about the bit settings:

Hex Column Drop-Down with Hint

Hex Column Drop-Down with Hint

The binary column is used to change bits:

Binary View to change bits

Binary View to change bits

Summary

With the Embedded Systems Register View I have now a way to inspect and change the peripheral registers of my device under debug. something I do not have with stock Eclipse, but possible with open source software and CMSIS-SVD files.

Happy Registering 🙂

 

 

 

Advertisements

33 thoughts on “How to Add Register Details View in Eclipse

  1. Hello Erich, I’ve learned a lot from you blog and this one is especially great and timely. I always have to fall back to CW under Windows to debug, just because the lack of register info from stock Eclipse. Now I am able to do it without leaving my Mac. Thank you!

    Like

  2. Hello Erich, Your blog has been very helpful for me in coming up the curve on using Eclipse tools with Kinetis K10 processor.

    I tried to use the “Embedded Systems Register View” in my Eclipse Kepler instance, and couldn’t get the viewer to update any of the register values. The processor I am using is MK10DN512VLL10, along with IAR compiler and J-link lite debugger. I have selected the processor as “MK10D5”. I see that the Eclipse register view is updating its value, but not the “Embedded Systems Register View”. I did try to clicking the variable to turn it Green, and of no use.

    Do you have any suggestions?

    Like

  3. When I was trying to look into PCRx registers for PORTy of my KL25Z, this plugin showed all PCRs as one “PCR%S”, which only shows PCR0 for PORTy. Do you have any idea how to check the PCRx (eg. PCR14) for PORTA/B/C/D/E? Thanks.

    Like

    • The issue is that the %s syntax of CMSIS-SVD is not supported in that plugin. With %s arrays of registers are described. This is a missing thing in this plugin. Two options: a) someone implements that in the plugin or b) you go into your XML file and ‘unroll’ that section. I might have a look at the plugin sources, unless someone else volunteers?

      Like

  4. Pingback: EmbSys Registers View with CMSIS-SVD dimElementGroup | MCU on Eclipse

  5. Pingback: Updated Eclipse EmbSysReg Viewer with extra Freescale SVD Files | MCU on Eclipse

  6. Hi Erich,

    I have refer to your tutorials (How to Add Register Details View in Eclipse | MCU on Eclipse) did step by step , and also
    Updated Eclipse EmbSysReg Viewer with extra Freescale SVD Files . while in my kds ,it still can’t check the freescale’ products.
    “Unpack the archive files over your ‘eclipse’ folder.” can you tell me what’s the meaning of this words ? and put the “FSL_SVD_Patch V0.3 for EmbSysReg” to where ? I put it here :
    “C:\Freescale\KDS_1.1.1\eclipse”

    it doesn’t work ,then i put them to here :
    “C:\Freescale\KDS_1.1.1\eclipse\plugins\org.eclipse.cdt.embsysregview.data_0.2.4.r168\data\SVD(CMSIS)\Freescale”

    it still can’t work .
    What should I do ? I test on kds 1.1.1 and kds 2.0.0 , both are can’t work well.

    Thank you !

    Like

    • Hi Linda,
      ‘unpack’ means that you unzip the files. The zip file has a folder ‘eclipse’ in it: place that folder over your existing eclipse folder of KDS. It replaces few Java files and adds extra CMSIS-SVD files.
      If you just place the .zip into your installation, this will not work: you need to unpack/unzip the files.
      I hope this helps?
      Erich

      Like

  7. Thank you very much for this tutorial ! Its a way more comfortable now to debug. I use it to debug a MKL24z64 from freescale. Just a little hint for other users. If you are downloading the package and while installing you get an error like this:

    “Failed to remove eclipse.exe” – just do the following steps: (they worked for me, windows 7, 64bit)

    1. Do not close eclispe (this is very important)
    2. Go to your ‘eclipse’ folder and rename the ‘eclipse.exe’ into something else, like ‘eclipse_1.exe’ (Normaly, you shouldn’t be able to do that, but for eclipse it works)
    3. Try to download the package again, now it should be able to remove the ‘eclipse.exe’ and install the package.
    4. After downloading and installing the package, restart eclipse.
    5. You are done$

    Like

  8. Hi Erich,
    Thanks for the article, but I may have missed something. I am trying to inspect registers for the new KL46Z, but after following the above steps, there is no Freescale option for the Cortex-M0, and the SVD(CMSIS) option only gives one chip choice. Did I do something wrong, or does this patch not cover this device….?

    Thanks for all the really great articles…

    Like

  9. Hi,
    thanks for the useful tutorial.
    I tried to follow your instruction but now the current version of EmbSysRegView is 0.2.5, so I am guessing that your patch is not suitable for this version.

    Any update planned?

    Thanks in advance.

    Greetings,

    Alex

    Like

  10. Pingback: Freescale CMSIS-SVD Register Files with Eclipse MARS and EmbSysRegView | MCU on Eclipse

  11. Erich,
    using KDS 3.2 with FRDM-KL27. Register view is not available. So I installed the EmbSysRegView V0.2.5 and installed the latest xml files into C:\Freescale\KDS_v3\eclipse\plugins\org.eclipse.cdt.embsysregview.data_0.2.4.freescale\data\SVD(CMSIS). Using SVD(CMSIS), the MKL27 is not listed. But the XML files exist for MKL27 (MKL27Z4.xml and MKL27Z644.xml). Andy ideas?.

    Like

    • Hi Brad,
      the folder, where the SVD files have to be installed depends on the version of the plugin you are using. So if you are using the version 0.2.5, then the data has to be in a 0.2.5 (and not 0.2.4) subfolder.
      Erich

      Like

      • Thanks. That did the job.
        Wasn’t KDS 3.2 supposed to have the register view included after you installed it?

        Like

      • Yes, KDS 3.2 comes with the register view included and installed. Could it be that you updated the installed one with a newer version?

        Like

  12. I would love to install this plug-in, but Eclipse is telling me “Unable to install selected solutions” and “The following solutions are not compatible with this version of Eclipse”, “EmbSysRegView”.

    I was using Eclipse Neon.1, but updated to Neon.3 Release 4.6.3 and am still having this same issue.

    Please let me know if you know how to fix this issue.

    Like

    • Hi Joe,
      I have not used it with Neon. I quickly tried it with Neon.2, and it installs. But somehow the view does not show up under Window > Show Views. I know that Eclipse Neon has changed many things and can render plugins not to work. It seems that EmbSysReg is one of it :-(. I suggest you report this to the plugin owner?

      Like

      • Erich,
        Good idea. I went there trying to create a bug report, but found that it’s already existed since July of 2016. The final word on the response was “So for now, sorry, no Neon support.”

        Like

  13. Pingback: MCUXPresso IDE: Unified Eclipse IDE for NXPs ARM Cortex-M Microcontrollers | MCU on Eclipse

  14. Pingback: EmbSysRegView 0.2.6 for Eclipse Neon and Oxygen | MCU on Eclipse

  15. Pingback: Adding CMSIS-SVD Files to EmbSysRegView 0.2.6.r192 and Eclipse | MCU on Eclipse

What do you think?

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s