diff --git a/source/_components/binary_sensor.w800rf32.markdown b/source/_components/binary_sensor.w800rf32.markdown new file mode 100644 index 00000000000..b4cdfae4176 --- /dev/null +++ b/source/_components/binary_sensor.w800rf32.markdown @@ -0,0 +1,69 @@ +--- +layout: page +title: "W800rf32 Binary Sensor" +description: "Instructions on how to integrate W800rf32 binary sensors into Home Assistant." +date: 2018-10-16 12:45 +sidebar: true +comments: false +sharing: true +footer: true +logo: w800rf32.png +ha_category: Binary Sensor +ha_release: 0.83 +ha_iot_class: "Local Push" +--- + +The `w800rf32` platform supports X10 RF binary sensors such as Palm Pad +remotes, key chain remotes, Hawkeye motion detectors, and many, many other X10 RF devices. +Some that have specifically been used with this are the KR19A keychain, MS16A motion detector +and the RSS18 four button wall mount keypad. + +# Setting up your devices + +Once you have set up your [w800rf32 hub](/components/w800rf32/), add the +binary sensors to your `configuration.yaml`: + +```yaml +# Example configuration.yaml entry +binary_sensor: + - platform: w800rf32 + devices: + a1: + name: motion_hall + a2: + name: motion_kitchen +``` + +{% configuration %} +devices: + description: A list of devices. + required: true + type: map + keys: + name: + description: Override the name to use in the frontend. + required: false + type: string + device_class: + description: "The [type or class of the sensor](/components/binary_sensor/) to set the icon in the frontend." + required: false + type: device_class + off_delay: + description: For sensors that only sends 'On' state updates, this variable sets a delay after which the sensor state will be updated back to 'Off'. + required: false + type: integer +{% endconfiguration %} + + +Binary sensors have only two states - "on" and "off". Many door or window +opening sensors will send a signal each time the door/window is open or closed. +However, depending on their hardware or on their purpose, +some sensors are only able to signal their "on" state: + +- Most motion sensors send a signal each time they detect motion. They stay "on" for a few seconds and go back to sleep, ready to signal other motion events. Usually, they do not send a signal when they go back to sleep. + +For those devices, use the *off_delay* parameter. +It defines a delay after which a device will go back to an "Off" state. +That "Off" state will be fired internally by Home Assistant, just as if +the device fired it by itself. If a motion sensor can only send signals +once every 5 seconds, sets the *off_delay* parameter to *seconds: 5*. diff --git a/source/_components/w800rf32.markdown b/source/_components/w800rf32.markdown new file mode 100644 index 00000000000..47602c33abc --- /dev/null +++ b/source/_components/w800rf32.markdown @@ -0,0 +1,38 @@ +--- +layout: page +title: "W800rf32" +description: "Instructions on how to integrate a W800rf32(a) into Home Assistant." +date: 2018-10-16 10:15 +sidebar: true +comments: false +sharing: true +footer: true +logo: w800rf32.png +ha_category: Hub +ha_release: 0.83 +ha_iot_class: "Local Push" +--- + +The `w800rf32` component supports W800RF32 devices by [WGL Designs](http://www.wgldesigns.com/w800.html) which +communicate in the frequency range of 310MHz or if you are outside Canada or the U.S., 433.92 MHz. + +The W800 family of RF receivers are designed to receive X10 RF signals generated from X10 products: Palm Pad +remotes, key chain remotes, Hawkeye motion detectors, and many, many other X10 RF devices. + +To enable W800rf32 in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +w800rf32: + device: PATH_TO_DEVICE +``` + +{% configuration %} +device: + description: "The path to USB/serial device, example: /dev/ttyUSB0." + required: true + type: string +{% endconfiguration %} + + + diff --git a/w800rf32.png b/w800rf32.png new file mode 100644 index 00000000000..3994afa480a Binary files /dev/null and b/w800rf32.png differ