Difference between revisions of "The simplest TinyOS program"

From TinyOS Wiki
Jump to: navigation, search
m
 
(7 intermediate revisions by one other user not shown)
Line 1: Line 1:
There is some value in knowing the the simplest code that can be compiled without errors. The C equivalent is
+
There is some value in knowing the simplest code that can be compiled without errors. The C equivalent is
 
 
 
  int main () {
 
  int main () {
 
   return 0;
 
   return 0;
 
  }
 
  }
 
 
 
which is written in a file, say, simple.c and compiled with the command
 
which is written in a file, say, simple.c and compiled with the command
 
 
<code bash>
 
<code bash>
 
  $ gcc test.c
 
  $ gcc test.c
 
</code>
 
</code>
 +
which produces the executable file <tt>a.out</tt>, which of course does nothing!
  
which produces the executable file <tt>a.out</tt>, which of course does nothing!
 
  
 
In TinyOS, to get the same thing, you need to create three files. Suppose the program we create is called <tt>Simple</tt>.  
 
In TinyOS, to get the same thing, you need to create three files. Suppose the program we create is called <tt>Simple</tt>.  
Line 29: Line 25:
 
  implementation{  
 
  implementation{  
 
  components SimpleC, MainC;
 
  components SimpleC, MainC;
 
+
SimpleC.Boot -> MainC.Boot;
+
SimpleC.Boot -> MainC.Boot;
 
  }
 
  }
 
</code>
 
</code>
Line 39: Line 35:
 
<code>
 
<code>
 
  module SimpleC{
 
  module SimpleC{
uses interface Boot;
+
uses interface Boot;
 
  }
 
  }
 
+
 
  implementation{
 
  implementation{
event void Boot.booted()
+
event void Boot.booted()
{
+
{
}
+
          //The entry point of the program
 +
}
 
  }  
 
  }  
 
</code>
 
</code>
Line 66: Line 63:
  
 
which should work successfully provided you have set up the environment properly.
 
which should work successfully provided you have set up the environment properly.
 +
 +
Now you can start extending this skeleton code by adding more components. The first thing is to try adding the Leds component to glow a specific pattern of leds. After that you can add the Timer component and start to Blink them, as shown in the Blink example in the tutorial.
 +
 +
[[Category:TinyOS]]

Latest revision as of 22:42, 9 November 2009

There is some value in knowing the simplest code that can be compiled without errors. The C equivalent is

int main () {
  return 0;
}

which is written in a file, say, simple.c and compiled with the command

$ gcc test.c

which produces the executable file a.out, which of course does nothing!


In TinyOS, to get the same thing, you need to create three files. Suppose the program we create is called Simple.

0. Create a new directory to put the files. We can name this directory Simple:

$ mkdir Simple
$ cd Simple

1. You need to create a Configuration file SimpleAppC.nc (following the suggested naming convention).

configuration SimpleAppC{
}
implementation{ 
	components SimpleC, MainC;

	SimpleC.Boot -> MainC.Boot;
}

There are two components in this program: your component called SimpleC and the Main component MainC. The MainC component provides the Boot.booted signal which essentially is the entry point of the application.

2. You need to create the Component file SimpleC.nc. This has definition (implementation) of the component SimpleC.

module SimpleC{
	uses interface Boot;
}

implementation{
	event void Boot.booted()
	{
          //The entry point of the program
	}
} 

3. Now you need to create a Makefile so that the compiler can compile it. Create the file called Makefile with the following two lines:

COMPONENT=SimpleAppC
include $(MAKERULES)

I.e., you put the name of the top level configuration in the COMPONENT field.


Now you are ready to compile:

$ make micaz

which should work successfully provided you have set up the environment properly.

Now you can start extending this skeleton code by adding more components. The first thing is to try adding the Leds component to glow a specific pattern of leds. After that you can add the Timer component and start to Blink them, as shown in the Blink example in the tutorial.