diff --git a/images/ESP32-pinout-mapping.png b/images/ESP32-pinout-mapping.png
new file mode 100644
index 0000000..8031755
Binary files /dev/null and b/images/ESP32-pinout-mapping.png differ
diff --git a/images/arduino-pro-micro.jpg b/images/arduino-pro-micro.jpg
new file mode 100644
index 0000000..6546024
Binary files /dev/null and b/images/arduino-pro-micro.jpg differ
diff --git a/images/db25-female-controller-side.jpeg b/images/db25-female-controller-side.jpeg
new file mode 100644
index 0000000..ba8b860
Binary files /dev/null and b/images/db25-female-controller-side.jpeg differ
diff --git a/images/db25-male-arduino-esp-side.jpeg b/images/db25-male-arduino-esp-side.jpeg
new file mode 100644
index 0000000..8f6e109
Binary files /dev/null and b/images/db25-male-arduino-esp-side.jpeg differ
diff --git a/images/db25pins.jpg b/images/db25pins.jpg
new file mode 100644
index 0000000..55ee070
Binary files /dev/null and b/images/db25pins.jpg differ
diff --git a/images/esp32.png b/images/esp32.png
new file mode 100644
index 0000000..126ab9a
Binary files /dev/null and b/images/esp32.png differ
diff --git a/readme.md b/readme.md
index 66b4113..c98d5eb 100644
--- a/readme.md
+++ b/readme.md
@@ -16,6 +16,43 @@ supported values:
   * $output: radio, usb, usbradio, switchusb, bt, debug
   * please note not all boards are compatible with all inputs/outputs, for example esp32 can only do bt, micro can only do radio or usb
 
+Wiring
+------
+
+(quick plea: if you are good at drawing diagrams, please help!)
+
+![DB-25 Pinout](images/db25pins.jpg)
+
+| DB-25 Male Pins     | Arduino Pro Micro GPIO                                      | ESP32 GPIO                |
+|--------------|---------------------------------------------|-----------------------------------------|
+|  1 |  1       |  |
+|  2 |  2       |  |
+|  3 |  3       |  |
+|  4 |  4       |  |
+|  5 |  5       |  |
+|  6 |  6       |  |
+|  7 |  7       |  |
+|  8 |  8       |  |
+|  9 |  9       |  |
+| 10 | 10       |  |
+| 11 | 11       |  |
+| 12 |  -       |  |
+| 13 |  -       |  |
+| 14 | 14       |  |
+| 15 | 15       |  |
+| 16 | 16       |  |
+| 17 |  -       |  |
+| 18 | 18       |  |
+| 19 | 19       |  |
+| 20 | 20       |  |
+| 21 | 21       |  |
+| 22 |  -       |  |
+| 23 | 3.3V VCC |  |
+| 24 | 5V VCC   |  |
+| 25 | GND      |  |
+
+
+
 Credits / Links
 ---------------