GE Z-Wave Motion Sensor

The Unofficial SmartThings Blog
Jump to: navigation, search

The GE Z-Wave Plus Portable Smart Motion Sensor (Model 34193) is a GE developed motion sensor that can be used within SmartThings to control actions based on movement. This document outlines the installation and usage of this custom DTH (Device Type Handler).

GEMotionGUI.png

Summary

Product: GE Z-Wave Portable Smart Motion (Model 34193)

Capabilities: Motion Sensor

Type: Stand-alone motion sensor with either battery or USB power

Protocol: Z-Wave Plus

Device Type Author: MichaelStruck (talk) 17:02, 3 January 2016 (EST) with code originally from @jwillaz

ST Community Handle: https://community.smartthings.com/users/michaels/activity

Latest Version

The latest version of the device code is as follows (as of 10/1/18):

   GE Z-Wave Plus Portable Motion Sensor DTH: 
   Version: 1.0.1
   https://github.com/MichaelStruck/SmartThingsPublic/blob/master/devicetypes/michaelstruck/ge-portable-smart-motion-sensor-34193.src/ge-portable-smart-motion-sensor-34193.groovy

Open Source License/Trademarks

Licensed under the Apache License, Version 2.0 (the "License"); you may not use the GE Z-Wave Motion Sensor DTH code except in compliance with the License. You may obtain a copy of the License at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

All product and company names are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.

Installation

First, copy the code from the following GitHub location:

   https://github.com/MichaelStruck/SmartThingsPublic/blob/master/devicetypes/michaelstruck/ge-portable-smart-motion-sensor-34193.src/ge-portable-smart-motion-sensor-34193.groovy

Click the Raw link, and then select all of the code (CTRL+A), and then copy it (CTRL+C) to your computer’s clipboard. Then go to the SmartThings IDE at http://ide.smartthings.com. Log into the site and proceed to the link at the top labeled My Device Types. Click on this link.

MyDeviceTypes.png

This will present you with a list of custom device types that you may have within your account. If you do not yet have the GE Z-Wave Motion Sensor Dimmer Switch listed, click the link +New Device Type in the upper right-hand corner of the screen.

+newDevice.png

There will be three tabs at the top, which represent the different ways to add a device. Choose From Code and you will be presented an empty area where the code you copied earlier can be placed. In the open area in the middle paste (CTRL+V) this code.

From here, simply Save and Publish this code.

DeviceSavePublish.png

   Notice
   The code for the GE Z-Wave Motion Sensor only needs to be installed in this manner once; 
   you can add multiple Z-Wave Motion Sensors as long as this code is in place.

You can now go through the normal process of adding devices to SmartThings.

Advanced Installation

For advanced users who have their SmartThings IDE integrated with GitHub, the installation and maintaining of code becomes very simple. This manual will not go into detail about setting up your IDE with GitHub; those instructions can be found here: http://docs.smartthings.com/en/latest/tools-and-ide/github-integration.html?highlight=git

Once you have integration, the code you might need will be available to you to download and keep in sync with the latest versions.

  • First, find the Settings button at the top of your SmartThings IDE page under My SmartApps or My Device Handlers(this button will only appear after you integrate with GitHub). For the virtual dimmer, you should be under the My Device Handlers section

IdeSettings.jpg

  • Clicking this button will open the GitHub Repository Integration page. To find the GE Z-Wave Motion Sensor Dimmer Switch code, enter the information as you see it below:

Owner: MichaelStruck

Name: SmartThingsPublic

GitHubIntegration.jpg

  • Close the GitHub Repository Integration page
  • Next, click the Update from Repo button at the upper-right corner of the IDE
  • On the right-hand column, scroll down to click the apps you want to install. This will typically be:
   GE Z-Wave Motion Sensor: devicetypes/michaelstruck/ge-portable-smart-motion-sensor-34193.src/ge-portable-smart-motion-sensor-34193.groovy
  • Click the Execute Update in the bottom-right corner of the screen. When done syncing, the new device handler should now appear in your IDE. If they ever change color, that indicates a new version is available.

Settings

General SmartThings Options

Option Settings/Notes
Name This is the name of the sendor that will be seen by other applications and SmartThings.

DTH Specific Options

   Please Note
   The settings marked as 'Default' will be applied to the switch regardless
   of whether you have set them within the Settings area. 
   
   Also note that tapping 'SAVE' on the Settings page will send the 
   commands to the motion sensor. An update will happen when the device updates 
   or if you press the button on the back of the device.
Option Name Settings/Notes
Moition Sensitivity This sets the sensitivity of the detector from low, medium to high (Default)
Moition Timeout Duration This is the amount of time after motion stops that the device will report out that the motion has stopped. This is a numeric entry between 1 and 60. Each number represents the number of minutes to delay after seeing motion to revert back to no motion. The default is 4 minutes. Entering 255 sets the duration to only 5 seconds.
Enable LED Flash Indicator This will enable or disable the red LED when motion is sensed. The default is off.

Interface

The interface for the DTH is rather straight forward and is consistent with other SmartThings devices. The main difference is that the battery level is shown within the top area.

GEMotionGUI.png

To modify the settings, click the gear icon in the upper-right hand corner of the screen. When you are done editing the setting, click the button on your motion sensor. A blue light should flash on the sensor, then click 'Save' in the upper-right hand corner DTH interface. The settings should update within a few minutes.

GEMotionSetting.png

Community Discussion

You may participate in the community discussion for this DTH here:

https://community.smartthings.com/t/release-ge-z-wave-plus-portable-motion-sensor-34193/138099