diff --git a/source/_docs/installation/virtualenv.markdown b/source/_docs/installation/virtualenv.markdown index b928a5bb2f2..3b46c19fced 100644 --- a/source/_docs/installation/virtualenv.markdown +++ b/source/_docs/installation/virtualenv.markdown @@ -104,30 +104,3 @@ Upgrading Home Assistant is simple, just repeat steps 3, 5 and 6. ### {% linkable_title Starting Home Assistant on boot %} The [autostart instructions](/getting-started/autostart/) will work just fine, just be sure to replace `/usr/bin/hass` with `/srv/homeassistant/bin/hass` and specify the `homeassistant` user where appropriate. - -### {% linkable_title Installing python-openzwave in a virtualenv %} - -If you want to use Z-Wave devices, you will need to install `python-openzwave` in your virtualenv. This requires a small tweak to the instructions in [the Z-Wave Getting Started documentation](/getting-started/z-wave/) - -Install the dependencies as normal (Note: you will need to do this as your normal user, since `homeassistant` isn't a sudoer). - -```bash -$ sudo apt-get install cython3 libudev-dev python3-sphinx python3-setuptools git -``` - -Then, activate your virtualenv (steps 3 and 5 above) and upgrade cython. - -```bash -(homeassistant)$ pip3 install --upgrade cython==0.24.1 -``` - -Finally, get and install `python-openzwave`. - -```bash -(homeassistant)$ mkdir /srv/homeassistant/src -(homeassistant)$ cd /srv/homeassistant/src -(homeassistant)$ git clone https://github.com/OpenZWave/python-openzwave.git -(homeassistant)$ cd python-openzwave -(homeassistant)$ PYTHON_EXEC=`which python3` make build -(homeassistant)$ PYTHON_EXEC=`which python3` make install -``` diff --git a/source/_docs/z-wave.markdown b/source/_docs/z-wave.markdown index 68a1ac888f0..f7be5fbca42 100644 --- a/source/_docs/z-wave.markdown +++ b/source/_docs/z-wave.markdown @@ -14,57 +14,17 @@ redirect_from: /getting-started/z-wave/ There is currently support for climate, covers, lights, locks, sensors, switches and thermostats. All will be picked up automatically after configuring this platform. -### {% linkable_title Installation in Virtualenv (python-OpenZWave) %} - -If you installed Home Assistant using a virtual environment then please read the instructions on [Installing python-OpenZWave in a virtualenv](https://home-assistant.io/docs/installation/virtualenv/#installing-python-openzwave-in-a-virtualenv). - ### {% linkable_title Installation %} -To allow Home Assistant to talk to your Z-Wave USB stick you will have to compile the OpenZWave library and install the related [python-OpenZWave package](https://github.com/OpenZWave/python-openzwave). This can be done as follows. _(Note: The Home Assistant docker image and the All In One installer have support for Z-Wave already built-in!)_ +As of version 0.45, Home Assistant automatically installs python-openzwave from PyPI as needed. -Make sure you have the correct dependencies installed before running the script: +There is one dependency you will need to have installed ahead of time: ```bash -$ sudo apt-get install cython3 libudev-dev python3-sphinx python3-setuptools git +$ sudo apt-get install libudev-dev ``` -Make sure you have at least version 0.23 and at the most 0.24.1 of cython. - -```bash -$ sudo pip3 install --upgrade cython==0.24.1 -``` - -Then get the OpenZWave files: - -
Do not use root to build python-openzwave as it will surely fail.
- -```bash -$ git clone https://github.com/OpenZWave/python-openzwave.git -$ cd python-openzwave -$ PYTHON_EXEC=$(which python3) make build -$ sudo PYTHON_EXEC=$(which python3) make install -``` - --Instead of `make install`, you can alternatively build your own python-openzwave package which can be easily uninstalled: -
- -```bash -$ sudo apt-get install -y checkinstall -$ sudo PYTHON_EXEC=$(which python3) checkinstall --pkgname python-openzwave --pkgversion 1.0 --provides python-openzwave -``` - -With this installation, your `config_path` needed below will resemble: - -```bash -/usr/local/lib/python3.4/dist-packages/libopenzwave-0.3.0b8-py3.4-linux-x86_64.egg/config -``` - -If you followed along with setting up a virtual environment, your path will be: - -```bash -/srv/homeassistant/python-openzwave/openzwave/config -``` +_Note: The Home Assistant docker image, HASSbian, and the All In One installer all have support for Z-Wave already built-in!_ ### {% linkable_title Configuration %} @@ -77,7 +37,7 @@ zwave: Configuration variables: - **usb_path** (*Optional*): The port where your device is connected to your Home Assistant host. -- **config_path** (*Optional*): The path to the Python OpenZWave configuration files. Defaults to the folder `config` in your Python OpenZWave install directory. +- **config_path** (*Optional*): The path to the Python OpenZWave configuration files. Defaults to the 'config' that is installed by python-openzwave - **autoheal** (*Optional*): Allows disabling auto Z-Wave heal at midnight. Defaults to True. - **polling_interval** (*Optional*): The time period in milliseconds between polls of a nodes value. Be careful about using polling values below 30000 (30 seconds) as polling can flood the zwave network and cause problems. - **device_config** (*Optional*): This attribute contains node-specific override values. (For releases prior to 0.39 this variable is called **customize**) See [Customizing devices and services](https://home-assistant.io/getting-started/customizing-devices/) for format: @@ -116,12 +76,12 @@ $ ls /dev/cu.usbmodem* ```-Depending on what's plugged into your USB ports, the name found above may change. You can lock in a name, such as `/dev/zwave`, by following [these instructions](http://hintshop.ludvig.co.nz/show/persistent-names-usb-serial-devices/). +Depending on what's plugged into your USB ports, the name found above may change. You can lock in a name, such as `/dev/zwave`, by following [these instructions](http://hintshop.ludvig.co.nz/show/persistent-names-usb-serial-devices/).
### {% linkable_title Adding Devices %} -To add a Z-Wave device to your system, go to the Services menu and select the `zwave` domain, and select the `add-node` service. Then find your device's add button and press that as well. +To add a Z-Wave device to your system, go to the Services menu and select the `zwave` domain, and select the `add-node` service. Then find your device's add button and press that as well. ### {% linkable_title Adding Security Devices %}