diff --git a/atom.xml b/atom.xml index 377c5c00ec..8e2d065c0f 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@
A switch platform that issues 433 MHz commands using pilight to turn a 433 MHz device on or off. The pilight HA hub has to be set up.
+The pilight
switch platform is issuing 433 MHz commands using pilight to turn a 433 MHz device on or off. The Pilight Home Assistant hub has to be set up.
Additionally RF commands can be defined that trigger this switch to turn on and off. This allows you to also use the remote shipped with your 433 MHz switch without mixing up the HA states. You can even define several on/off commands, thus several RF remotes to toggle this switch.
+Additionally RF commands can be defined that trigger this switch to turn on and off. This allows you to also use the remote shipped with your 433 MHz switch without mixing up the Home Assistant states. You can even define several on/off commands, thus several RF remotes to toggle this switch.
-To be really sure that HA knows the actual state of your device it is recommended to use the RF remote with codes unknown to any of your 433 MHz devices. Thus you use the remote to trigger this switch to send the correct RF code to the device.
+To be really sure that Home Assistant knows the actual state of your device it is recommended to use the RF remote with codes unknown to any of your 433 MHz devices. Thus you use the remote to trigger this switch to send the correct RF code to the device.
-To define a pilight switch, add the following lines to your configuration.yaml
:
To define a Pilight switch, add the following lines to your configuration.yaml
:
# Example configuration.yaml entry
switch:
- platform: pilight
- switches:
- Bed light:
- on_code:
- protocol: intertechno_old # protocol has to be defined
- unit: 3 # these entries are protocol specific and can differ
- id: 4 # these entries are protocol specific and can differ
- 'on': 1 # on has to be in apostrophes to be parsed correctly
- off_code:
- protocol: intertechno_old # protocol has to be defined
- unit: 3 # these entries are protocol specific and can differ
- id: 4 # these entries are protocol specific and can differ
- 'off': 1 # off has to be in apostrophes to be parsed correctly
- on_code_receive: # optional
- protocol: daycom # protocol has to be defined
- systemcode: 14462 # these entries are protocol specific and can differ
- unit: 6 # these entries are protocol specific and can differ
- id: 34 # these entries are protocol specific and can differ
- state: 'on' # off has to be in apostrophes to be parsed correctly
- off_code_receive: # optional
- protocol: daycom # protocol has to be defined
- systemcode: 14462 # these entries are protocol specific and can differ
- unit: 6 # these entries are protocol specific and can differ
- id: 34 # these entries are protocol specific and can differ
- state: 'off' # on has to be in apostrophes to be parsed correctly
+ - platform: pilight
+ switches:
+ Bed light:
+ on_code:
+ protocol: intertechno_old
+ 'on': 1
+ off_code:
+ protocol: intertechno_old
+ 'off': 1
Configuration variables:
Variables for the different codes:
+ +intertechno_old
or daycom
.'on'
or 'off'
has to be in apostrophes to be parsed correctly.1
or 0
1
or 0
For possible code entries look at the pilight API. All commands allowed by pilight-send can be used.
+switch:
+ - platform: pilight
+ switches:
+ Bed light:
+ on_code:
+ protocol: intertechno_old
+ unit: 3
+ id: 4
+ 'on': 1
+ off_code:
+ protocol: intertechno_old
+ unit: 3
+ id: 4
+ 'off': 1
+ on_code_receive:
+ protocol: daycom
+ systemcode: 14462
+ unit: 6
+ id: 34
+ state: 'on'
+ off_code_receive:
+ protocol: daycom
+ systemcode: 14462
+ unit: 6
+ id: 34
+ state: 'off'
+
+If you are using templates then those parts needs to be escaped. Otherwise they will be rendered and appear blank on the website.
-Note that you can replace yaml
next to ``` with the language that is within the block.
When you’re writing code that is to be executed on the terminal, prefix it with $
.
For the configuration templating is Jinja used.
-You need to embed all templates with ...
otherwise they will be rendered and this result in an empty output.
If you are using templates then those parts needs to be escaped. Otherwise they will be rendered and appear blank on the website.