Documentation for RFXtrx tcp change (#11026)

* Documentation for RFXtrx tcp change

* Update rfxtrx.markdown

* ✏️ Tweaks


Co-authored-by: Franck Nijhof <frenck@addons.community>
This commit is contained in:
foxy82 2019-12-03 09:15:15 +00:00 committed by Franck Nijhof
parent bd3c137b07
commit a646c14ef4

View File

@ -7,33 +7,58 @@ ha_category:
ha_release: pre 0.7 ha_release: pre 0.7
--- ---
The `rfxtrx` integration supports RFXtrx devices by [RFXCOM](http://www.rfxcom.com) which communicate in the frequency range of 433.92 MHz. The `rfxtrx` integration supports RFXtrx devices by [RFXCOM](http://www.rfxcom.com), which communicate in the frequency range of 433.92 MHz.
To enable RFXtrx in your installation, add the following to your `configuration.yaml` file: To enable RFXtrx in your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry for local serial device
rfxtrx: rfxtrx:
device: PATH_TO_DEVICE device: /dev/ttyUSB0
```
OR
```yaml
# Example configuration.yaml entry for TCP connected device using ser2net
rfxtrx:
host: 192.168.0.2
port: 50000
``` ```
{% configuration %} {% configuration %}
device: device:
description: "The path to your device, e.g., `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0` or `/dev/ttyUSB0`." description: "The path to your device, e.g., `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0` or `/dev/ttyUSB0`. Required if you are using a locally connected USB device."
required: true required: false
type: string type: string
host:
description: "The hostname the remote RFXtrx is available on if connecting via TCP. If this is set, a port is required."
required: false
type: string
port:
description: "The TCP port the remote RFXtrx is available on. If this is set, a host is required."
required: false
type: integer
debug: debug:
description: If you want to receive debug output. description: "If you want to receive debug output."
required: false required: false
default: false default: false
type: boolean type: boolean
dummy: dummy:
description: Then you have need a connected drive to test your settings. Can be useful for debugging and testing. description: "Then you need a connected drive to test your settings. Can be useful for debugging and testing."
required: false required: false
default: false default: false
type: boolean type: boolean
{% endconfiguration %} {% endconfiguration %}
Supported protocols ## Supported protocols
Not all protocols as advertised are enabled on initial setup of your transceiver. Enabling all protocols is not recommended either. Your 433.92 product not showing in the logs? Visit the RFXtrx website to [download RFXmgmr](http://www.rfxcom.com/epages/78165469.sf/nl_NL/?ObjectPath=/Shops/78165469/Categories/Downloads) and enable the required protocol. Not all protocols as advertised are enabled on the initial setup of your transceiver. Enabling all protocols is not recommended either. Your 433.92 product not showing in the logs? Visit the RFXtrx website to [download RFXmgmr](http://www.rfxcom.com/epages/78165469.sf/nl_NL/?ObjectPath=/Shops/78165469/Categories/Downloads) and enable the required protocol.
### ser2net
You can host your device on another computer by setting up ser2net and example configuration for ser2net looks like this and then using host/port in your home assistant config.
```text
50000:raw:0:/dev/ttyUSB0:38400 8DATABITS NONE 1STOPBIT
```