From e860ceb32d39e02c7805bc0de8a793da0e03fe5a Mon Sep 17 00:00:00 2001 From: Faucogney Anthony Date: Mon, 20 Jan 2020 07:38:41 +0100 Subject: [PATCH] Add derivative integration (#10323) * Add derivative component * remove the redirect_from * :pencil2: Tweak * Update derivative.markdown Co-authored-by: Franck Nijhof Co-authored-by: Paulus Schoutsen --- source/_components/derivative.markdown | 57 ++++++++++++++++++ source/images/supported_brands/derivative.png | Bin 0 -> 6929 bytes 2 files changed, 57 insertions(+) create mode 100644 source/_components/derivative.markdown create mode 100644 source/images/supported_brands/derivative.png diff --git a/source/_components/derivative.markdown b/source/_components/derivative.markdown new file mode 100644 index 00000000000..aef2586feb2 --- /dev/null +++ b/source/_components/derivative.markdown @@ -0,0 +1,57 @@ +--- +title: "Derivative Sensor" +description: "Instructions on how to integrate Derivative Sensor into Home Assistant." +ha_category: + - Utility + - Energy +ha_release: 0.105 +ha_iot_class: Local Push +logo: derivative.png +ha_qa_scale: internal +--- + +The `derivative` platform provides the numerical derivative or numerical differentiation of the values provided by a source sensor. Derivative sensors are updated upon changes of the **source**. Fast sampling source sensors provide better results. + +## Configuration + +To enable Derivative Sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: derivative + source: sensor.current_speed +``` + +{% configuration %} +source: + description: The entity ID of the sensor providing numeric readings + required: true + type: string +name: + description: Name to use in the frontend. + required: false + default: source entity ID meter + type: string +round: + description: Round the calculated derivative value to at most N decimal places. + required: false + default: 3 + type: integer +unit_prefix: + description: Metric unit to prefix the derivative result. Available units are k, M, G, T. + required: false + default: None + type: string +unit_time: + description: SI unit of time to integrate over. Available units are s, min, h, d. + required: false + default: h + type: string +unit: + description: Unit of Measurement to be used for the derivative. + required: false + type: string +{% endconfiguration %} + +If 'unit' is set then 'unit_prefix' and 'unit_time' are ignored. diff --git a/source/images/supported_brands/derivative.png b/source/images/supported_brands/derivative.png new file mode 100644 index 0000000000000000000000000000000000000000..aecf9f6db0b2d285526d61ce6c20596f3cd8693e GIT binary patch literal 6929 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 AumAu6 literal 0 HcmV?d00001