diff --git a/README.md b/README.md
index 8f46a06..3be61a3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,39 @@
-# esp8266_bms
+# Battery management system, based on esp8266 wireless SoC
 
-A stoopid BMS based on an esp8266
\ No newline at end of file
+An ESP8266's input voltage is 2.8-3.6V, which makes it ideal for being powered 
+from a single LiFePo4 cell, whoose nominal voltage is 3.2V
+
+The second premise is that the ESP8266 has a WiFi capability on board already, 
+this can send the voltages and / or perform more complex tasks on a floating 
+potential and does not need additional power supply, or setpup / stepdown
+convertors
+
+## High level design
+ - Use of ESP8266, directly connected to a single cell
+ - Decision to use internal, or external ADC to measure voltage,
+   have to test the precision for multiple, averaged measurements. Should be 
+   precise enough, if WiFi is turned off and no PWM is used
+   
+### Architecture
+
+        ESP 8266 pins
+        1, 3V3 --> To battery +         2, RX  --> NC
+        3, RST --> PULL UP              4, IO0 --> PWR Dump relay start
+        5, EN  --> PULL UP              6, IO2 --> FREE, blink indicator?
+        7, TX  --> NC                   7, GND --> To Battery -
+
+
+## Hardware requiered
+ - ESP8266, version not dependent. v01 will be used for testing
+ - 8 pins (Dupont male) exposed, only internal measurement possible
+ - some cabling needed, should be simple. 
+ - Wifi router in range, so it can send data to somewhere
+ - additional hardware required for a running database, or visualization 
+   software
+
+## Software requirements
+ - obviously a NW infrastructure, TCP / http capable
+ - Linux server
+ - InfluxDB ?
+ - SQLite ?
+ - Dockerized ?