Create pulse-catcher.rst

components/index.rst

@@ -1096,6 +1096,7 @@ Cookbook
     Sonoff Fishpond Pump, cookbook/sonoff-fishpond-pump, cookbook-sonoff-fishpond-pump.jpg
     Arduino Port Extender, cookbook/arduino_port_extender, arduino_logo.svg
     EHMTX a matrix status/text display, cookbook/ehmtx, ehmtx.jpg
+    Pulse Catcher, cookbook/pulse-catcher, pulses.png
 
 Contributing
 ------------

cookbook/pulse-catcher.rst

@@ -0,0 +1,34 @@
+Pulse Catcher
+=============
+
+.. seo::
+    :description: Example to use the pulse meter sensor as a pulse catcher.
+    :image: pulses.png
+
+The :doc:`/components/sensor/pulse_meter` can be used as a very fast pulse catcher. This can be useful
+if you would like to detect an incoming pulse on a GPIO pin shorter than the typical ``16ms`` loop interval.
+
+.. code-block:: yaml
+
+    sensor:
+      - platform: pulse_meter
+        pin: GPIOXX
+    #    internal_filter: 1ms # If a pulse shorter than this time is detected, it is discarded. Defaults to 13us.
+        id: trigger
+        filters: 
+          - lambda: return {}; # Don't return any pulses/s to not spam the logs
+        total:
+          id: pulses 
+          on_value: 
+            then:
+              # Do something cool when a pulse is detected, like flashing a led e.g.
+              - output.turn_on: led
+              - delay: 500ms
+              - output.turn_off: led
+
+See Also
+--------
+
+- :doc:`/automations/index`
+- :doc:`/components/sensor/pulse_meter`
+- :ghedit:`Edit`