diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cc36afd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# ADC ft. PWM
+
+Code from a make-up assignment.
+
+Pin layout:
+
+5v out --> variable resistor --> PA1 **(ADC)**
+
+PE14 --> LED --> gnd **(PWM)**
+
+PA11 --> LED + Resistor --> gnd **(optional, "ON" light)**
+
+PA12 --> LED + Resistor --> gnd **(optional, "ERR" light)**
+
+---
+
+To use UART on linux:
+- install `minicom` with your package manager
+- run `./uart.sh`
+