NESCDT

From TinyOS Wiki
Revision as of 03:36, 20 April 2008 by Rasped (talk | contribs)
Jump to: navigation, search

Using the nescdt plugin for Eclipse

A basic nesC editor plugin for Eclipse with syntax highlighting and .nc file content detection for the follow types:

  • interface Inter.gif,
  • module Mod.gif,
  • generic module Genmod.gif,
  • configuration Conf.gif,
  • generic configuration Genconf.gif
  • safe Safe.gif(experimental).

The same symbols are used as in nesdoc. The source is included in the plugin jar file, and it is possible to refine it. To install the plugin:

  • Download the nescdt_0.0.9.jar file [here]
  • Save it in the root of Eclipse plugin directory (where the other (jar) plugins also reside)
  • Restart Eclipse (perhaps verify for yourself that it is installed: Help->About Eclipse SDK->Plug-in Details)
  • Associate the *.nc files with this editor: Windows->Preferences->General->Editors->File Associations

Nxtmote-fileassosi.png

  • Create a new empty project Nxtmote-newproject.jpg and name it what you want to (for example nescsampleproject)
  • Create a new folder in the project (right-click on the project) and name it what you want (recommended to name it similar to the folder name that we will link to in the next step)
  • Import and link to the part of the TinyOS tree or your own code(right-click on the nescsampleproject folder and press import)

Nxtmote-folderlink.jpg

  • Choose the Link to folder in the file system option and proceed (this will not change your TinyOS code at all and it will not copy any files on your computer)
  • When you are done the Eclipse IDE could look something like this (note that the content of the files have been analyzed and that the icons reveal that we have some configurations, generic configurations, modules, and generic modules in the mica2 folder):

Nxtmote-editor.png

  • When you open some .nc file it will be syntax colored (according some some predefined rules in the plugin):

Nxtmote-editorsyntax2.png

  • Side notes
    • The nescdt plugin is < 50 kB
    • If it detects safe code (looking for *COUNT, *SIZE, or *SAFE) a rhombus shape is added to the icon. A safe module could look like this Nxtmote-safedemo.png in the file navigator.
    • If the CVS decorators annoy you (if, for example, another CVS client than Eclipse is being used), then turn them off from Window->Preferences->General->Appearance->Label Decorations.
    • You can also consider downloading the CDT plugin for editing header files and perhaps C files in Eclipse. Enter the http://download.eclipse.org/tools/cdt/releases/europa as a new Remote site in the Eclipse update manager and choose the CDT main plugin:

Nxtmote-cdtdownload.png