From b423230a4a72f074eaf2215a184c5893bddda97a Mon Sep 17 00:00:00 2001 From: proddy Date: Tue, 25 Jun 2024 20:18:38 +0200 Subject: [PATCH] add scheduler conditions --- docs/Configuring.md | 33 ++++++++++++++++++-- docs/_media/screenshot/web_conditions_1.png | Bin 0 -> 29000 bytes docs/_media/screenshot/web_conditions_2.png | Bin 0 -> 28369 bytes 3 files changed, 31 insertions(+), 2 deletions(-) create mode 100644 docs/_media/screenshot/web_conditions_1.png create mode 100644 docs/_media/screenshot/web_conditions_2.png diff --git a/docs/Configuring.md b/docs/Configuring.md index aa2b765f..f3e5e48a 100644 --- a/docs/Configuring.md +++ b/docs/Configuring.md @@ -154,8 +154,37 @@ The scheduler can also be used to periodically set values based on another entit ![Web](_media/screenshot/web_scheduler_custom.png) ![Web](_media/screenshot/web_scheduler_flowtemp.png) -## Creating Custom Entities +### Conditions -Custom Entities is an advanced and powerful way to extend EMS-ESP by adding your own EMS entities that extracts data from a specific EMS telegram. This is useful when EMS-ESP doesn't yet support a specific entity, or when you want to extract data from a telegram that is not yet supported. Another common use case is for debugging or watching specific behaviour when changing parameters on an EMS device. For example, a modern Heat Pump may have new features that are not included in EMS-ESP. Here you would use the `watch` command to view the incoming EMS traffic in combination with manual adjusting specific parameters and when you have located the specific telegram and the offset, create a Custom Entity to fine-tune the type and verify the the value. Then request it to be included in the next EMS-ESP release update. +Introduced in **version 3.7**, the Scheduler has been extended to support conditional statements used in the `Command` and/or `Value` fields. Conditions have a strict syntax (see below) and are evaluated every 10 seconds. The condition is only executed when the condition changes from false to true. This is powerful new feature and allows, for example, to set a schedule based on a condition, or to set a value based on a condition. + +Pay attention to the following rules: + +- a condition has to be a logic value `0` or `1`, the condition is `true` only for `1`, an arithmetic result `1` is also interpreted as `true` + schedule command executed for `3 > 2, 3 - 2` + schedule command not executed for `3 < 2`, `3 + 2` +- blanks are not needed, but makes the formula more readable +- EMS-ESP values are accessed `/` or `//value`, `` may contain prefixes like ``. +- checking enum and bool values depends on the user's API setting! Check the right value before setting a schedule + e.g. check output to see if building = "medium", create the rule with `thermostat/building == medium` + also for boolean values check if you have to use `0/1`, `off/on`, `OFF/ON`, or `false/true` +- strings containing special characters have to be written in quotations, e.g. `boiler/pumpmode == "delta-P2"`, to avoid a calculation error on delta minus P2, + other strings can be written with or without quotations +- commands followed by a divider (`/`) have to be set in parenthesis e.g. `(boiler/seltemp)/2` +- condition command is only executed on a change of the condition from `false` to `true`. If the condition stays true, the command is not repeated +- command value can also be a formula +- allowed operations : arithmetic: `+ - \* / %` and prefix- logic: `== != <= >= < > && ||` and prefix `!` + are useful for the value of onChange and condition: a single instance of ` ? : ` +- on change trigger is always one or more entities `/`, where device is not system. It can have multiple triggers. e.g. `boiler/outdoortemp custom/setpoint` and triggers on change of each value (entities never change the same time (it's a callback) and logical operations here like `&&` makes no sense) + +![Web](_media/screenshot/web_conditions_1.png) + +![Web](_media/screenshot/web_conditions_2.png) + +## Adding Custom Entities + +Custom Entities is an advanced and powerful way to extend EMS-ESP by adding your own EMS entities that extracts data from a specific EMS telegram. This is useful when EMS-ESP doesn't yet support a specific entity, or when you want to extract data from a telegram that is not yet supported. Another common use case is for debugging or watching specific behavior when changing parameters on an EMS device. + +For example, a modern Heat Pump may have new features that are not included in EMS-ESP. Here you would use the `watch` command to view the incoming EMS traffic in combination with manual adjusting specific parameters and when you have located the specific telegram and the offset, create a Custom Entity to fine-tune the type and verify the the value. Then request it to be included in the next EMS-ESP release update. ![Web](_media/screenshot/web_customentities.png) diff --git a/docs/_media/screenshot/web_conditions_1.png b/docs/_media/screenshot/web_conditions_1.png new file mode 100644 index 0000000000000000000000000000000000000000..9f4905cd195748fc26896b0c647b4a21a56be7dd GIT binary patch literal 29000 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