diff --git a/README b/README
new file mode 100644
index 000000000..5151dc7d0
--- /dev/null
+++ b/README
@@ -0,0 +1,72 @@
+libmc1322x is a library and build system for using the mc13224v from
+Freescale.
+
+Getting Started
+---------------
+$ cd tests
+$ make
+
+this will build all the test files in libmc1322x/tests _for each_ board
+defined in libmc1322x/board. You will have programs like:
+
+  rftest-tx_redbee-dev.bin
+  rftest-tx_redbee-r1.bin
+
+  rftest-rx_redbee-dev.bin
+  rftest-rx_redbee-r1.bin
+
+if you only wanted to build binaries for one board you can do:
+
+$ make BOARD=redbee-dev
+
+You can use mc1322x-load.pl in tools to run your code:
+
+$ ../tools/mc1322x-load.pl -f rftest-tx_redbee-dev.bin
+
+
+Incorporating libmc1322x into your own code
+-------------------------------------------
+
+The best way is to incorporate libmc1322x as a git submodule in your
+own code. 
+
+$ mkdir newproject
+$ cd newproject
+$ git init
+
+Initialized empty Git repository in /home/malvira/newproject/.git/
+
+$ git submodule add git://git.devl.org/git/malvira/libmc1322x.git
+
+This will add libmc1322x to your repository. Now to setup the
+Makefile:
+
+$ cp libmc1322x/tests/Makefile .
+
+You need to edit the Makefile to point MC1322X to libmc1322x:
+
+Change line 1
+
+MC1322X := ..
+
+to 
+
+MC1322X := libmc1322x
+
+and edit COBJS and TARGETS accordings. COBJS are all of your common
+code for any of your programs. TARGETS are the names of you programs.
+
+For instance, you can have a common routine that prints a welcome
+message that is used by two programs a and b. You would add common.o
+to COBJS and your target line would read:
+
+TARGETS := a b 
+
+COBJS are made for each board --- so it is ok to have board specific
+code in there. As an example, tests uses this to print which board you
+are running.
+
+
+
+
+