docs

Author: philbowles

README.md

@@ -9,24 +9,45 @@ Unfortunately the standard [ESPAsyncTCP](https://github.com/me-no-dev/ESPAsyncTC
 
 You must replace that library with this [bugfixed version](https://github.com/philbowles/ESPAsyncTCP)
 
-# Code
+# Compiling with SSL
 
-You must provide a SHA1 fingerprint to confirm the server identity, and call `serverFingerprint` before connection, e.g.
+SSL Features are NOT available by default. This is because they add about 64k to the binary, *even if you don't use them*! 
+
+In order to use TLS, you first need to enable SSL in both the [bugfixed library](https://github.com/philbowles/ESPAsyncTCP): Edit `async_config.h` 
+and PangolinMQTT itself: Edit `config.h`
+
+In both files, find the line which says:
+`#define ASYNC_TCP_SSL_ENABLED 0`
+
+and change it to:
+`#define ASYNC_TCP_SSL_ENABLED 1`
+
+before compiling.
+
+# Your Code
+
+You must provide a 20-byte SHA1 fingerprint to confirm the server identity, and call `serverFingerprint` before connection, e.g.
 
 ```cpp
 ...
 const uint8_t cert[20] = { 0x9a, 0xf1, 0x39, 0x79,0x95,0x26,0x78,0x61,0xad,0x1d,0xb1,0xa5,0x97,0xba,0x65,0x8c,0x20,0x5a,0x9c,0xfa };
 ...
   mqttClient.serverFingerprint(cert);
+  ...
+  mqttClient.connect(...
 ...
 ```
 
-# Example sketches
+---
+
+## Find me daily in these FB groups
 
-quickstart bare size: 271052
-+ TLS = 334604
-diff 63552
+* [Pangolin Support](https://www.facebook.com/groups/pangolinmqtt/)
+* [ESP8266 & ESP32 Microcontrollers](https://www.facebook.com/groups/2125820374390340/)
+* [ESP Developers](https://www.facebook.com/groups/ESP8266/)
+* [H4/Plugins support](https://www.facebook.com/groups/h4plugins)
 
+I am always grateful for any $upport on [Patreon](https://www.patreon.com/esparto) :)
 
 
-Apart from the "QuickStart_X" and STM32 sketches, the examples include a simple `#define ASYNC_TCP_SSL_ENABLED` at the head of the sketch. Set your own `cert` finfingerprint and make sure `ASYNC_TCP_SSL_ENABLED` is defined - the rest happens automatically.
+(C) 2020 Phil Bowles