diff --git a/README.md b/README.md
index 271d778..77061a3 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,54 @@
-# esphome-mystrom-wifi-button-plus
+# myStrom's WiFi Button Plus ESPHome configuration yaml
 
+## Flash
+
+```
+JP1
+(○) GPIO0      ➙ GND (Bootloader mode)
+[○] TX (GPIO1) ➙ Programmer's RX
+[○] RX (GPIO3) ➙ Programmer's TX
+[○] VCC        ➙ +3.3V
+[○] GND        ➙ 0V (GND)
+```
+
+## Schematics
+
+```mermaid
+erDiagram
+    ESP32 {
+    }
+
+    ESP32 ||--|| GPIOs : ""
+    ESP32 ||--|| I2C : ""
+    ESP32 ||--|| ADC : ""
+
+    I2C {
+        GPIO21-GPIO22 SHTC3
+    }
+
+
+    ADC {
+        GPIO32  Battery-probe
+    }
+
+    GPIOs {
+        GPIO38 Top-left-key
+        GPIO39 Top-right-key
+        GPIO37 Bottom-left-key
+        GPIO36 Bottom-right-key
+        GPIO04 Red-LED
+        GPIO18 Green-LED
+        GPIO23 White-LED
+        GPIO33 USB-power-probe
+    }
+
+```
+
+## Notes
+
+ - GPIO13, GPIO14 , GPIO19 and GPIO27 are reserved for an Eink display.
+ - GPIO9 and GPIO10 are reserved for the QuadIO flash mode.
+ - GPIO25 and GPIO26 are reserved for an unknown device.
+ - GPIO34 is reserved for the unpopulated SW5.
+ - GPIO35 is reserved for the unpopulated and unknown U7.
+ - There are traces and footprints for a buzzer.
\ No newline at end of file