diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..ff2e785
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,8 @@
+# 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.