Difference between revisions of "NESCDT"

From TinyOS Wiki
Jump to: navigation, search
(Using the ''nescdt'' plugin for Eclipse)
Line 5: Line 5:
 
* ''generic module'' [[Image:Genmod.gif]],
 
* ''generic module'' [[Image:Genmod.gif]],
 
* ''configuration'' [[Image:Conf.gif]],
 
* ''configuration'' [[Image:Conf.gif]],
* and ''generic configuration'' [[Image:Genconf.gif]].  
+
* ''generic configuration'' [[Image:Genconf.gif]]
 +
* ''safe'' [[Image:Safe.gif]](experimental).  
 
The same symbols are used as in [[Getting_Started_with_TinyOS#Visualizing_a_Component_Graph| nesdoc]]. The source is included in the plugin jar file, and it is possible to refine it. To install the plugin:
 
The same symbols are used as in [[Getting_Started_with_TinyOS#Visualizing_a_Component_Graph| 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.8.jar'' file [[http://nxtmote.sf.net/nescdt_0.0.8.jar here]]
+
* Download the ''nescdt_0.0.9.jar'' file [[http://nxtmote.sf.net/nescdt_0.0.9.jar here]]
 
* Save it in the root of Eclipse plugin directory (where the other (jar) plugins also reside)
 
* 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'')
 
* Restart Eclipse (perhaps verify for yourself that it is installed: ''Help->About Eclipse SDK->Plug-in Details'')
Line 23: Line 24:
 
* Side notes
 
* Side notes
 
**The ''nescdt'' plugin is < 50 kB
 
**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 [[Image:Nxtmote-safedemo.png]] in the file navigator.
 
**If the CVS [http://www.eclipse.org/articles/Article-Decorators/decorators.html 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''.  
 
**If the CVS [http://www.eclipse.org/articles/Article-Decorators/decorators.html 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 http://download.eclipse.org/tools/cdt/releases/europa] as a new ''Remote site'' in the Eclipse update manager and choose the CDT main plugin:  
 
**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 http://download.eclipse.org/tools/cdt/releases/europa] as a new ''Remote site'' in the Eclipse update manager and choose the CDT main plugin:  
 
[[Image:Nxtmote-cdtdownload.png]]
 
[[Image:Nxtmote-cdtdownload.png]]

Revision as of 04:36, 20 April 2008

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