add more docs on connections

Author: f18m

README.md

@@ -60,7 +60,7 @@ want to use the HomeAssistant UI: look for Helpers and choose `Generic Thermosta
 * ESP32 relay board [bought on Aliexpress](https://it.aliexpress.com/item/1005007027676026.html?spm=a2g0o.order_list.order_list_main.31.42f53696cth4st&gatewayAdapt=glo2ita) (17.5€ in Oct 2025).
 Its main characteristics are:
 
-  * Sports an [ESP32-WROOM-32E module](./datasheets/esp32-wroom-32e_esp32-wroom-32ue_datasheet_en.pdf)
+  * Sports an [ESP32-WROOM-32E module](./datasheets/esp32-wroom-32e_esp32-wroom-32ue_datasheet_en.pdf) with 240MHz clock, 320kB RAM, 4MB Flash
   * 5V DC power supply terminal
   * 8 relay channels, both NC and NO contacts available
 
@@ -73,6 +73,14 @@ Its main characteristics are:
   * `DHT11`: Digital Temperature Humidity Sensor,
     see https://esphome.io/components/sensor/dht/
 
+Alternative sensors I also tested in an instance of this ESPHome Package are:
+
+  * `MAX31855` and a K-type thermocouple for reading pipe temperature,
+    see https://esphome.io/components/sensor/max31855/
+  * `DHT22`: Digital Temperature Humidity Sensor,
+    see https://esphome.io/components/sensor/dht/
+
+
 ## ESP32 Relay Board Pinout
 
 The ESP32 relay board currently being used has the following pinout:
@@ -96,6 +104,10 @@ In addition to these, the following GPIOs are used for the temperature sensors:
 * GPIO5: `DHT11` sensor
 * GPIO16 (MISO), GPIO17 (CLK) and GPIO15 (CS): for the SPI bus to read the `MAX6675` sensor
 
+Graph of the ESP-to-sensor connections:
+
+<img title="Sensors" alt="Sensors" src="images/ESP-to-sensors-connections.drawio.png">
+
 
 ## Full ESPHome configuration
 
@@ -126,7 +138,8 @@ esphome:
 
 which is basically assigning the secrets defined in the ESPHome global "secrets.yaml" to the variables of this package.
 Then it's overriding just the name & friendly name from the package.
-
+See e.g. [example-instance.yaml](./example-instance.yaml)
+and [example-instance-with-different-sensors.yaml](./example-instance-with-different-sensors.yaml).
 
 ## TODO
 

datasheets/DHT22.pdf

@@ -0,0 +1,24 @@
+packages:
+  remote_package_files:
+    url: https://github.com/f18m/floor-heating-controller/
+    files: 
+      - path: main.yaml
+        vars:
+          encryption_key: "MqLWuv12+mOVDxRI7E0dK8Vx0+xy1gnRHEkzhXMBCac="
+          wifi_ssid: "Some-SSID"
+          wifi_password: "supersecretpassword"
+          wifi_ap_password: "deadbeefdead"
+          ota_password: "deadbeefdeadbeefdeadbeefdeadbeef"
+    ref: main  # optional
+    refresh: 1d  # optional
+
+sensor:
+  # let's say you want to use DHT22 instead of DHT11 for ambient temperature;
+  # just override the "model" field of the "ambient_sensor"
+  - id: !extend ambient_sensor
+    model: DHT22
+
+  # let's say you want to use MAX31855 instead of MAX6675 for heating pipe temperature
+  # just override the "platform" of the "heating_pipe_sensor"
+  - id: !extend heating_pipe_sensor
+    platform: max31855