diff --git a/README.md b/README.md
index 6ba31981..4056c1c4 100644
--- a/README.md
+++ b/README.md
@@ -201,14 +201,31 @@ Depending on your HP model, SG3 might be configurable in "ECO mode", "Normal mod
Note: Smart Grid needs to be switched ON in the heatpump configuration menu, otherwise SG1 and SG2 contacts are not evaluated.
## Step 5 (optional) - Pulse Meter feature
+_Needs step 4 - Smart grid features_
ESPaltherma can communicate how much energy the HP should consume via a pulse meter. For this, uncomment and confugre `PIN_PULSE`, `PULSES_PER_kWh` and `PULSE_DURATION_MS` in `src/setup.h`. Send energy amount in Watt to MQTT channel `espaltherma/pulse/set`. Current Watt setting is available in `espaltherma/pulse/state`.
-*TODO more close description what it is to do*
+### Hardware
+Similar to the SG1 and SG2 connections, an additional relay is needed for the pulse meter. As relays have a rather limited cycle count and switching is slow, it is strongly recommended to use alternatives like optocouplers. The relay/optocoupler needs to be connected to the S4S contacts of your heat pump and needs a 200 Ohm resistor on the positive side of the connection.
-Note the limits to reporded Watt. Both limits depend on
+For the optocoupler I used the [LTV 815](https://cdn-reichelt.de/documents/datenblatt/A200/LTV815_LTV825_LTV845_LIT.pdf). Be aware of the supported Voltage. On my heat pump I measured between 12 and 20 Volt on all connections (SG1, SG2 and Smart Grid). Here is the resulting PCB, note that also the SG1, SG2 contacts as well as the serial connection is implemented. _Important: The 200 Ohm resistor on the Smart Grid (S4S) connection is missing_
+
+
+
+### Heat Pump Settings
+[9.A.2] Installer settings > Energy Metering > Electricity meter 2: Set to "1000/kWh for PV-Panel". Keep this in sync with the `PULSES_PER_kWh` setting in `src/setup.h`.
+
+Possibly following settings are also needed
+[9.8.4] Installer settings > Benefit kWh power supply > Benefit kWh power supply: Set to "Smartgrid"
+
+### Usage
+Set the Smart Grid value to "2 - Recommended ON" and set a set the desired Watt to be consumed in the MQTT channel `espaltherma/pulse/set`.
+
+Note: This is not a direct command for the heat pump. It was build to be an additional information of a smart meter, thus the heat pumpt decides wheather or not to turn on or not. Could very well be, that the heat pump needs to see a certain level of power over a duration of time.
+
+Note the limits to reporded power. Limits are depnendend on these settings:
* `PULSES_PER_kWh` (default is 1000)
-* `PULSE_DURATION_MS` (default is 75)
-For these defaults, the minimum reported power is 60 and the maximum is 21 kWh. If you need to represent more power, try reducing `PULSE_DURATION_MS`. If this is not sufficient, adapt `PULSES_PER_kWh` but keep it in sync with the HP setting.
+* `PULSE_DURATION_MS` (default is 50)
+For the above defaults, the minimum reported power is 60 W and the maximum is 18 kWh. If you need to represent more power, try reducing `PULSE_DURATION_MS` to at most 10. If this is not sufficient, adapt `PULSES_PER_kWh` but keep it in sync with the heat pump setting.
# Troubleshooting
diff --git a/doc/images/PCB_bottom.jpg b/doc/images/PCB_bottom.jpg
new file mode 100644
index 00000000..9a2bb3a1
Binary files /dev/null and b/doc/images/PCB_bottom.jpg differ
diff --git a/doc/images/PCB_top.jpg b/doc/images/PCB_top.jpg
new file mode 100644
index 00000000..50963a47
Binary files /dev/null and b/doc/images/PCB_top.jpg differ
diff --git a/doc/images/PCB_wiring.jpg b/doc/images/PCB_wiring.jpg
new file mode 100644
index 00000000..27ecc73a
Binary files /dev/null and b/doc/images/PCB_wiring.jpg differ
diff --git a/include/mqtt.h b/include/mqtt.h
index 8fdc78b7..1bf6af89 100644
--- a/include/mqtt.h
+++ b/include/mqtt.h
@@ -270,9 +270,10 @@ void callbackPulse(byte *payload, unsigned int length)
target_watt = (long) WH_PER_PULSE * 60;
Serial.printf("Capping pulse to %d Watt to ensure pulse rate is <= 60 sec\n", target_watt);
}
- if (ms_until_pulse < 20) {
- // ensure a 20 ms gap between two pulses
- ms_until_pulse = 20;
+ if (ms_until_pulse < 100) {
+ // ensure a 100 ms gap between two pulses
+ // taken from https://www.manualslib.de/manual/480757/Daikin-Brp069A61.html?page=10#manual
+ ms_until_pulse = 100;
long original_target = target_watt;
target_watt = (long) ((1000 * WH_PER_PULSE * 3600) / (ms_until_pulse + PULSE_DURATION_MS));
Serial.printf("WARNING pulse frequency to high, capping at %d Watt! Target is %d Watt. Decrease PULSE_DURATION or PULSES_PER_kWh\n", target_watt, original_target);
diff --git a/src/setup.h b/src/setup.h
index 5f564885..190ae127 100644
--- a/src/setup.h
+++ b/src/setup.h
@@ -42,7 +42,7 @@
//Uncomment and set to enable Pulse Meter mqtt functions
// #define PIN_PULSE 25// Pin connected to pulse meter relay
// #define PULSES_PER_kWh 1000 // match setting on HP (TODO hint for setting path)
-// #define PULSE_DURATION_MS 75 // Duration of the pulse, decrease on very high energy settings (TODO give example)
+// #define PULSE_DURATION_MS 50 // Duration of the pulse, decrease on very high energy settings (TODO give example)
// #define PULSE_LED_BUILTIN 1 // also pulse the build in LED
// DO NOT CHANGE: Defines the SG active/inactive relay states, according to the definition of the trigger status