diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b96e9ec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# WiFi Position System
+
+
+A wemos d1 mini (esp8266) is used to scan for ssid broadcasts once, then send connect to a wifi and send the result via mqtt.
+On the server the rssi and AP MAC addresses can be compared to previously saved locations.
+After the values have been sent the esp goes into deep sleep for a set amount of time.
+If the device is mounted to something the wake up can be triggered via a shock sensor. In this case the position is only updated when it has been moved.
+
+## Hardware
+
+- ESP8266 (Wemos D1 Mini).
+- 3x AA Battery Holder (Connect to 3V3 and GND).
+- 3x AA Batteries (Use partially emptied alkaline Batteries or NiMh rechargables. Max 3.8V)
+- Optional: Shock sensor (spring type, that connects to contacts when bumped). Connect between D0 and RST. 
+    - If no shock sensor is used connect D0 to RST to enable wake up by timer.
+- 10k and 4.7k resistor. Connection: 3V3 - 4k7 - A0 - 10k GND
+