diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..d686ce3
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+# Homie DS18B20 #
+
+## ESP01 and DS18B20 temperature sensor using Homie convention over MQTT ##
+
+## Notes ##
+
+* Using powered mode for ds18b20. Must supply power to power pin.
+* Used 10k resistor which works, 4.7k is what's suggested.
+* Using the Dallas Temperature library