Skip to content

Commit

Permalink
add notification to Configuring.md
Browse files Browse the repository at this point in the history
  • Loading branch information
MichaelDvP authored Aug 1, 2024
1 parent 8b35449 commit d8edc92
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions docs/Configuring.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,6 +194,32 @@ Pay attention to the following rules:

![Web](_media/screenshot/web_conditions_2.png)

### Web Commands

Sending or getting data via web request can be used in a json command:
- GET a value from webserver:
`{"url":"http://server.tld/path/file"}`
- GET a json value from webserver and select the key:
`{"url":"http://server.tld/path/file", "key":"nameofkey"}`
- set a value with POST:
Command: `{"url":"http://server.tld/path/file", "header":{"content-type":"text/plain", "token":"mytoken"}`
Value: the post message, if it is a json the content-type header is set in header, no need to set it.

Examples:
- getting power state of a tasmota plug (exampleIP):
`{"url":"http://192.168.0.100/cm?cmnd=power", "key":"power"} == off`
is identical with
`{"url":"http://192.168.0.100/cm?cmnd=power"} == {"power":"off"}`
- setting a tasmoto plug:
`{"url":"http://192.168.0.100/cm?cmnd=power%20on"}`

### Notification
With web commands a service like [pushover](https://pushover.net) can be used to send a push-message on events. To send different message create a custom entity in RAM named `message`, or what you like. Create a schedule on change triggering the change of this message and sending the pushover message.

![grafik](https://github.com/user-attachments/assets/570576b5-b382-4ab2-bff3-4468291334a3)

Now you can create other scheduls with the command `custom/message` and individual text as data.

## 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.
Expand Down

0 comments on commit d8edc92

Please sign in to comment.