Z-Wave.Me RaZberry2 - Smart Home Gateway Manual

Overview

There are three parts:

1. the RaZberry Z-Wave hardware shield that is plugged on top of the Raspberry Pi,
2. the Raspberry Pi as such and
3. a Z-Wave controller software running on the Raspberry Pi itself. You can download a free copy of the certified "Z-Way" software from razberry.z-wave.me. The RaZberry shield works with all Raspberry Pi type A, B, B+, 2, Zero and 3.

Note: The RaZberry works with all third party Z-Wave software supporting Sigma Serial API.

Installation

Here are two ways to install and start Z-Way:

1. You don't have installed Linux OS on your Raspberry Pi: Please download a SD card image (SD card must have min. 4 GB) from the download section of http://razberry.z-wave.me. It is based on the Raspberry Pi distribution 'Jessie'.
2. You already have a working Linux running: Log in and execute the following command line: wget -q -O - http://razberry.z-wave.me/install | sudo bash. Please use Raspian image 'Jessie'.

In order to use Z-Way make sure that your Pi is connected to the internet using the Ethernet port. Now use a web browser from a PC in the very same network and go to http://find.zwave.me. You will see the local IP address of your Pi below the login window. Click on the IP to reach the initial setup screen of Z-Way that gives you the device ID of your RaZberry and requests you to set your admin password. (If you know your Pi's local IP address you can type this into the browser as follows: http://YOUR_IP:8083)
Now you can access your controller from outside your home too, using the service find.zwave.me. Use DEVICEID/LOGIN (e.g. 12345/admin) and your password.

Privacy Note: Z-Way always connects to the server find.zwave.me in order to give you remote access to your system. If you don't want this, you can turn off this feature after logging into Z-Way (Setup > Management > Remote Access). Please be aware that you will have to set a port forwarding to port 8083 or you will not have any remote access from outside your home. All communication between Z-Way and the server find.zwave.me is encrypted and protected by valid certificates.

1. Dashboard
2. Rooms
3. Elements
4. Events/Timeline
5. Server Time
6. Configuration Menu
7. Elements
8. Element Configuration

The user interface ("SmartHome UI") looks similar on different devices such as desktop pc, smartphone or tablet pc (both native app and browser) but it will adapt to the screen sizes. It allows controlling devices and read sensor status. Every function of any device is shown as one single Element (7). In case a physical device has multiple functions – like switching and metering – it will generate multiple elements. All elements are listed in the Element View (3) and can be filtered by function type (switch, dimmer, sensor) or other filtering criteria. Every element offers a Configuration View (8) for changing names, remove it from the screens etc. Important elements can be placed in the Dashboard (1). Additionally, the elements can be accessed using Rooms (2) assignments. Every change of a sensor value or a switching status is called an Event (4) and is shown in the Timeline (4). Filtering allows monitoring the changes of one single function or device.
All other functions such as time triggered actions, the use of information from the internet, scene plugins of other technologies and services are realized in so-called Apps. These Dashboard (1), Rooms (2), Elements (3), Events/Timeline (4), Server Time apps are ready-to-use scripts/ templates that (5), Configuration Menu (6), Elements (7), Element Configuration (8) can add extra logic and functionality such as logic rules like "IFàTHEN", scene definitions, timers, interactions with external (non Z-Wave) devices connected via USB Dongle or via internet etc. Some apps are built-in into the system. More can be an App Store. To use an app, you have to create an instance of this app and configure its properties. If useful you can create more than one instances of one single app. The apps can create none, one or multiple new elements and events. You can install new apps and manage them using the Configuration Menu (6) > Apps.

1. Raspberry Pi Connector, used GPIO pins 1-10
2. Second Open Connector, identical to (1)
3. Reset Button: Short press and release will start a service on port 8084 for 10 minutes to update/replace Z-Way version. This is a short cut of the firmware update function available within the SmartHome UI management section. Keeping this button pushed for 10 seconds will perform a factory reset and erase all settings in the Z-Wave chip plus reset all user defined settings including your admin password.
4. Open hole for a PigTail antenna. You need to break off the PCBA antenna to make this work.
5. Pads to solder an uFL connector for external antenna. See https://www.adafruit.com/products/1661 for component details. You need to break off the PCBA antenna to make this work.
6. Two LEDs for status information.

More information, including full manuals and training videos can be found in the support section of www.zwave.me or the portal z-wave.info. The support forum forum.z-wave.me may help as well.
RaZberry can be used in multiple areas of the world and adapted to the local Z-Wave frequency just using the Z-Wave Experts UI (http://YOURIP:8083/expert, Network > Management). The SKU code determines the default frequency. Do not change the frequencies outside your SKU code group.

• SKU: ZMEERAZ2 (865...869 MHz): Europe (EU) [default], India (IN), Russia (RU), Malaysia (MY), China (CN), RSA (EU), Middle East (EU)
• SKU: ZMEURAZ2 (908... 917 MHz): All America ex. Brasil and Peru (US) [default], Israel (ISL)
• SKU: ZMEARAZ2 (919... 921 MHz): Australia/NewZealand/Brazil/Peru (ANZ) [default], Hongkong (HK), Japan/Taiwan (JP), Korea (KR)