diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f4a02c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# CMSIS OS2
+
+Library using cmsis_os2.h functionality for RTOS projects.
+
+
+
+## System events
+
+Enable via `STA_SYSTEM_EVENT_ENABLE` defined in `sta/config.hpp`.
+
+Requires setup of a `systemEvent` EventFlag in the project.