Using the Vesternet Zigbee 1 Zone Wall Controller (VES-ZB-WAL-006) with SmartThings

Vesternet VES-ZB-WAL-006 1 Zone Wall ControllerVesternet VES-ZB-WAL-006 1 Zone Wall Controller

Vesternet Zigbee 1 Zone Wall Controller (VES-ZB-WAL-006)

Thanks for purchasing this Vesternet Device for use in your SmartThings Smart Home Controller!

The VES-ZB-WAL-006 is a Zigbee Wall Controller / Remote Control and offers the following features:

  • Two buttons with simple on / off markings
  • Pushed, held and released events for each button
  • Standard 80mm x 80mm form factor with sticky pad or screw mounting
  • Indicator LED
  • Long life CR2450 Battery
  • Zigbee 3.0 works with Zigbee ZHA & Zigbee ZLL Hubs & Bridges

The SmartThings Smart Home Controller needs a "Device Handler" for each hardware Device that you wish to use so that it functions correctly. A Device Handler is a piece of software / code written in the Groovy programming language and these are created by SmartThings themselves, by manufacturers of hardware devices or by the SmartThings Community.

Vesternet hardware is no different in this respect, but fortunately for the end user we've created our own Device Handlers for our full range of hardware. This means that you don't need to search and scour the web to try and find code and information in getting the Device to work!

For best compatibility with the SmartThings Smart Home Controller we recommend that you use our supporting Device Handler.

Vesternet Zigbee Device Handlers

Available here.

Two files are required for this particular Device:

  • Vesternet VES-ZB-WAL-006 1 Zone Wall Controller.groovy
  • Vesternet VES-ZB-WAL-006 1 Zone Wall Controller Child Button.groovy

This Vesternet Device has the following features when used with our supporting Device Handler in the SmartThings Smart Home Controller (tested with SmartThings firmware version 000.032.00012).

  • Supports Pushed, Held, and Released Events for both buttons (SmartThings doesn't offer an Event for "Released" so our Device Handler utilises the "Double Pushed" Event instead).
  • Reports battery level in the Device Details section of the App
  • Allows assigning of "Actions" for all button Events from the Device Details section of the App.
  • Allows adding of "Automations" for the battery level from the Automations section of the App.

To ease your journey with Vesternet hardware, our manual will show you how to .....

Physical Device Installation

Installation of this Vesternet Device couldn't be easier - simply remove the battery cover, pull out the battery tab and then replace the battery cover.

The Device can be left loose (like a remote control) or you can use the included sticker or screws to permanently fix it to the surface of your choice.

Physically Installing the Vesternet VES-ZB-WAL-006 1 Zone Wall Controller | Vesternet

For further information please see the manual that was included with the Device.

....back


Device Operation

The Device has two buttons, each supporting Pushed, Held, and Released Events.

SmartThings doesn't offer an Event for "Released" so our Device Handler utilises the "Double Pushed" Event instead.

For further information please see the manual that was included with the Device.

....back


Installing the Device Handler

Access the SmartThings Groovy Integrated Development Environment here. If you're new to the SmartThings IDE you can read more about it at SmartThings Classic Documentation

  • Click "My Device Handlers". You'll see a list of any Device Handlers that you've already loaded. To create a new one, click on "Create New Device Handler".

    Adding a Device Handler to SmartThings | Vesternet
  • Click "From Code" to load a blank editor document.

    Adding a Device Handler to SmartThings | Vesternet
  • The editor is very basic and is best used for simply pasting in code from another location.

    Adding a Device Handler to SmartThings | Vesternet
  • Visit the Vesternet GitHub Repository at the location mentioned at the beginning of this manual and view the file containing the Device Handler Groovy code.

    To ensure only valid Groovy code is copied, click on the "Raw" button.

    Adding a Device Handler to SmartThings | Vesternet
  • Select all of the text on the page and copy it.

    Adding a Device Handler to SmartThings | Vesternet
  • Copy the code from the GitHub page, paste it into the SmartThings editor and then click "Create".

    Adding a Device Handler to SmartThings | Vesternet
  • Make sure that the SmartThings editor confirms with a "Created SmartDevice" message.

    Adding a Device Handler to SmartThings | Vesternet
  • Finally click on the "Publish" button and select "For Me". This is an important step as it makes the Device Handler live on your SmartThings Smart Home Controller!

    If the Device requires multiple Device Handlers, be sure to repeat the process from the start and create all that are required.

    Adding a Device Handler to SmartThings | Vesternet
  • To update or make changes to the Device Handler in the future you can simply click on the link in the "Namespace/Name" column in the initial list shown on the "My Device Handlers" page.

    You will be taken to the SmartThings editor for that Device Handler where you can edit the code, select it all and overwrite with a new copy, etc.

    Don't forget to click the "Save" button to save any changes. Then once again ensure to click the "Publish" button and select "For Me".

    Adding a Device Handler to SmartThings | Vesternet

....back


Pair the Device

Open the SmartThings App on your smartphone or tablet. If you're new to the SmartThings App you can read more about it at the SmartThings Getting Started guide.

  • From the SmartThings App Dashboard, touch the "+" in the top right corner of the App, then touch "Device".

    Pairing A Zigbee Device In SmartThings | Vesternet Pairing A Zigbee Device In SmartThings | Vesternet
  • Scroll down the screen and touch "Scan Nearby". If you have multiple SmartThings Smart Home Controllers you'll be shown a "Select hub" screen.

    Pairing A Zigbee Device In SmartThings | Vesternet Pairing A Zigbee Device In SmartThings | Vesternet
  • Touch one of the hubs to put a tick next to it, then touch "Select" to initiate the scan.

    Pairing A Zigbee Device In SmartThings | Vesternet Pairing A Zigbee Device In SmartThings | Vesternet
  • To confirm the pairing request on the Device, press and hold down both buttons on the Device until the LED flashes, then immediately press the left button ("On").

    That's all there is to it, BE PATIENT and SmartThings should eventually show a success message!

    You can change the Device name if you wish by touching on "Rename". Touch the back arrow in the top left corner to return back to the Dashboard.

    Pairing A Zigbee Device In SmartThings | Vesternet Pairing A Zigbee Device In SmartThings | Vesternet
  • You'll find that the Device hasn't been assigned to a room, so you can now do so if you wish by touching "Move to other room".

    Once the "Choose room" screen appears you can change the room and touch "Save" to finish.

    Pairing A Zigbee Device In SmartThings | Vesternet Pairing A Zigbee Device In SmartThings | Vesternet
  • Return to the Dashboard and view your new Device.

    Pairing A Zigbee Device In SmartThings | Vesternet

....back


Configure the Device

There aren't any configuration settings available for this Device, it is "ready-to-use" as soon as it's been Paired to your Zigbee network!

....back


App Control

Since this Device is used for "Input" functionality there's nothing to control from within the App.

You can however view the current status of the battery on the App Dashboard or by clicking on the Device to access its details screen.

Here you can also view the button Events in real-time!

Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet

Touching the "History" tab at the bottom of the screen will open the history of all the previous Events from the Device.

You can also access further screens by touching the menu icon at the top right of the screen, with options for editing the Device name and changing the room that it's in.

Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet

....back


Usage in Automations, Scenes, Schedules & Logic

Open the SmartThings App on your smartphone or tablet. If you're new to the SmartThings App you can read more about it at the SmartThings Getting Started guide.

SmartThings offers several different ways to use your Devices, here we'll take a look at direct Device "Actions" and general "Automations".

Actions

  • From the Device details screen, touch one of the Events under the "Button" that you wish to create an Action for.

    Remember that SmartThings doesn't offer an Event for "Released" so our Device Handler utilises the "Double Pushed" Event instead.

    Once the "Add automation" screen appears you can see that the Event has already been pre-populated. Touch "Add action" to move on.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • On the next screen you can choose between "Control devices" to directly control devices and "Run scenes" to run a Scene that you've already created.

    Choose a Device to control on the next screen.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • The screen will change to show a "tick" next to the Device, touch "Save" to confirm the selection.

    SmartThings will helpfully default to setting up a "toggle" Action for the Device. Touch "Done" if you're happy with that, or you can change it by touching the Action.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • To change the Action from toggle touch the "slider" and instead choose an explicit Action such as "On". Touch "Save" to confirm the selection.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • You can then add further Actions if you need to or touch "Done" to finish up.

    Depending on the type of Device you may have other options for Actions, for example the ability to set a dimming level.

    Activate the Action by touching the "slider" and then choose a dimming percentage. Touch "Save" to confirm the selection.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • There are also options to set a "delay" on an Action so that it won't happen immediately....

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • .... and you can automatically turn off the Device by setting an "auto turn off" timer.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet

Automations

  • From the Dashboard, expand the main menu and touch "Automations".

    Once the "Automations" screen appears touch "Add automation" to move on.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • This takes you to the familiar "Add automation" screen but this time the "If" condition isn't pre-filled in.

    Touch "Add condition" and then "Device status" since we're interested in reacting to a Device Event.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • Devices with available conditions will be shown, so touch one to select it.

    The next screen will show the available conditions for the Device, so here we can select the "Battery" condition by touching it.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • You'll now be shown the possible tests for the condition.

    For the battery level we can test against the percentage so we'll set that to be "Equal or below" the percentage of "20".

    Touch "Save" to confirm the condition.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • Touch "Save" again and you'll automatically be taken to the "Then" part of the Automation.

    For this we'll elect to send a push notification to ourselves when the battery level is low, so touch on "Notify someone" to proceed.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • Next touch on "Send notification to members" and then type in your message.

    Here we chose a simple "wall controller battery is low" text, but you could include more information if you wish, for example the room name.

    Touch "Save" when you are finished.

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet
  • Finally, enter a name for this Automation or keep the default one, touching "OK" to confirm.

    Back on the Automations screen you'll notice that you can disable / enable the Automation if needed by touching on the "slider".

    Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet Vesternet VES-ZB-WAL-006 1 Zone Wall Controller In SmartThings | Vesternet

....back


Getting Help and Support

We hope that you are satisfied with your purchase and don't experience any issues with installing and using your new Vesternet Device. As always, help is at hand should you need it by simply following the links below.

Vesternet Technical Suppport

Vesternet SmartThings Zigbee Device Handlers

Vesternet Devices

....back