Update README.md

diff --git a/README.md b/README.md
index 4f065b53c9fa6ca55c94766ab06f4fd89b4b8d0e..35e19215674bb64734877df38198bf30a528b873 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1 +1,20 @@
 # stmos
+
+stmos is an operating system for STM microprocessors. It aims to support (or be able to support) all STM Cortex-M processors.  
+  
+Features:  
+* Unprivileged code execution
+* ELF loading and execution (loads an init from the initrd)
+* Near-full C standard library support for loaded ELFs
+* libgpio: GPIO access for loaded ELFs
+  
+Currently supported processors:
+* STM32L476RG (board: NUCLEO-L476RG)
+  
+### building  
+To build stmos, you'll need the following programs:  
+* The arm-stmos toolchain (see the ```arm-stmos``` folder)
+* openocd
+* gdb (with multiarch support)
+  
+To compile stmos simply run ```make``` (-j option supported). To upload, use ```run.sh``` to start openocd/gdb; do ```lo``` to load stmos, and ```c``` to run it.