Aeon Multisensor 6

The Unofficial SmartThings Blog
Jump to: navigation, search

The Aeon MultiSensor 6 is the latest device from Aeotec that acts a motion, temperature, humidity sensor along with reading the UV index, luminosity and being able to detect vibration/tamper motion. This device can work indoors or outdoors, making it a very versatile device. It connects to SmartThings via Z-Wave. You can read more about this device here: https://aeotec.com/z-wave-sensor

AeonMS6DTH.png

Summary

Product: Aeon MultiSensor 6

Capabilities: Acceleration Sensor, Battery, Configuration, Health Check, Illuminance Measurement, Motion Sensor, Refresh, Relative Humidity Measurement, Sensor, Tamper Alert, Temperature Measurement, Ultraviolet Index

Type: Motion Sensor

Protocol: Z-Wave

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

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

Latest Version

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

   Aeon MultiSensor (Advanced) 6 DTH: 
   Version: 1.0.3
   https://raw.githubusercontent.com/MichaelStruck/SmartThingsPublic/master/devicetypes/michaelstruck/aeon-multisensor-6-advanced.src/aeon-multisensor-6-advanced.groovy

Open Source License/Trademarks

Licensed under the Apache License, Version 2.0 (the "License"); you may not use the Aeon MultiSensor 6 Device Type Handler (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://raw.githubusercontent.com/MichaelStruck/SmartThingsPublic/master/devicetypes/michaelstruck/aeon-multisensor-6-advanced.src/aeon-multisensor-6-advanced.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 virtual dimmer 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


Find the section labeled My Devices at the top of http://ide.smartthings.com. Click this link.

MyDevices.png

From here, you can add your device to SmartThings as normal. Typically, when SmartThings finds the device it tries the IDE code first to find a match to the devices. The Aeon MultiSensor 6 does have a default device handler, so if you integrate the device and you don't have this device handler activated (if it says (Advanced) after the title you have the correct device handler) , please proceed with the instructions.

Once you have named the device and have it within SmartThings, find the device in the IDE under <<My Devices>>. Once you find the device, click on the left-hand side to open up the properties. From there, go to the bottom and click <<Edit>>.

You will load a page where you can change the device handler type. Simply find he section labeled <<Type>> and scroll down until you find "Aeon MultiSensor 6 (Advanced)". Choose that and then click <<Update>> at the bottom of the page

AeonMSIDE1.png

Finally, you should include this newly added device in an automation/application that can use temperature, humidity, motion, etc.

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 Aeon MultiSensor 6 (Advanced) 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:
   Aeon MultiSensor 6 (Advanced): devicetypes/michaelstruck/aeon-multisensor-6-advanced.src/aeon-multisensor-6-advanced.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.

Interface

There is a lot of useful information on the device screen.

AeonMS6DTH-1.png

Item Name Notes
A Temperature This information is shown as the 'primary' information from this sensor in the SmartThings interface. The color of the background is based on the temperature displayed (cold = blue, hot = red).
B Device Configuration/Power This area shows a variety of information about the device, including the firmware version on the device, the configuration status and the battery percentage and life (if on battery power and the battery replacement time is set in the preferences)
C Humidity The percentage displayed will be relative humidity
D Luminosity The value can be between 0 and 30,000 (with an offset available in the preferences) and is measured in 'lux'.
E UV Index This area is the Ultraviolet Index, which is a number that represents the intensity of the sunlight. The color of the background also represents the safety level. More information on this can be found here: https://en.wikipedia.org/wiki/Ultraviolet_index
F Motion Indicator This will become active when the device senses motion. Typically, the reading returns to normal with no motion and after the timeout you designate in the preferences. If you find the motion gets 'stuck' to on even when there is no motion, you can reset this by pressing the tamper indicator area in the middle of the interface. This will reset not only the motion but the vibration/tamper display as well.
G Tamper Indicator This will become active when the device senses the device has motion. Typically, the reading returns to normal with no additional physical motion. If you find the tamper sensor gets 'stuck' even when the even when there is no motion, you can reset this by pressing the tamper indicator area in the middle of the interface. This will reset not only the vibration/tamper display but the motion (PIR) sensor as well.
H Configuration When you change your preferences, many times new information will need to be uploaded to the device. A small orange dot will appear in the configuration button when an update is required.

Configure@2x.png

The update is automatic and will happen on the next device wake time.

I Refresh This will refresh the data on the screen such as firmware and battery. It will NOT wake the device and refresh the environmental data.
* Settings/Preferences This area will allow you to configure many of the setting of the device type handler. See below for the items you can configure.

Settings/Preferences

Parameter Details Default
Battery or USB This setting determines the behavior of some aspects of the device and what is displayed on the main screen. It is assumed the device is on battery power unless otherwise stated.
Enable Selective Reporting Selective reporting is used to reduce network traffic between the device and the SmartThings hub. When enabled, the device will only transmit measurements when certain threshold or percentage are reached. Default is 'No'
Temperature Threshold When used with Enable Selective Reporting above, this determines when temperature is polled from the device if the amount of change exceeds this number. Please note that for every 10 in threshold is 1.0 degrees in change 20 (2 degrees)
Humidity Threshold When used with Enable Selective Reporting above, this determines when humidity is polled from the device if the amount of change exceeds this number. Please note that for every 10 in threshold is 10% in change 10 (10 %)
Luminance Threshold When used with Enable Selective Reporting above, this determines when luminance is polled if the amount of change exceeds this number. Please note that for every 10 in threshold is 10 lux in change 100 (100 Lux)
Battery Threshold When used with Enable Selective Reporting above, this determines when the battery is polled if the amount of change exceeds this number. Please note that for every 10 in threshold is 10% in battery level change 10 (10 %)
Ultraviolet Threshold When used with Enable Selective Reporting above, this determines when the UV index is polled if the amount of change exceeds this number. Please note that for every 1 in threshold is 1 unit in UV index change 2
PIR reset time Number of seconds to wait to report motion has cleared after it is sensed. 240 seconds (4 minutes)
PIR motion sensitivity Allows you to set the motion sensor sensativity. The valid range is (0) disabled to (5) high sensitivity The default is high sensitivity (5)
Reporting Interval This will tell the device how often to wake up and report out changes. When on battery the minimum is 240 seconds (4 minutes) and when on USB power you can go down to 30 seconds. Increase this to extend battery life. Please note that this does NOT impact motion or tamper monitoring 3600 seconds (1 hour)
Temperature offset Allows you to adjust the displayed temperature. The displayed value = standard value - offset value. For example, if the device natively reads 60 degrees and you know the value in that area (possibly from a highly calibrated thermostat) that the temperature is actually 61.5 degrees, you could set the offset to 1.5 and the display will give you the reading you desire. Default is 0 offset (natively displayed temperature)
Humidity offset Like the temperature offset, this setting allows you to adjust the displayed humidity. The displayed value = standard value - offset value. Simply enter the offset (positive or negative) to adjust the displayed humidity. Default is 0 offset (natively displayed humidity)
Luminance offset Like the above offsets, this setting allows you to adjust the displayed luminance. The displayed value = standard value - offset value. Simply enter the offset (positive or negative) to adjust the displayed luminance. Default is 0 offset (natively displayed luminance)
Ultraviolet offset Like the above offsets, this setting allows you to adjust the displayed ultraviolet index. The displayed value = standard value - offset value. Simply enter the offset (positive or negative) to adjust the displayed ultraviolet index. Default is 0 offset (natively displayed ultraviolet index)
Command option Designates what command should be sent when the motion sensor is triggered. Basic set
Disable LED This will disable the LED when reading motion. Only available with firmware version 1.08 and above. Please note that the LED will still light when the device is tampered with. Default is "On"
Stay Awake Time Sets the the device will remain awake when the device wakes up to report the various status. This only operated on firmware 1.08 and above. This may need to be increased to be able to send configuration data to the device before it goes back to sleep. Default is 30 seconds.
Enable Debug Logging This will send additional information to the SmartThings IDE Live Logging. This is helpful for troubleshooting purposes. Default is 'Off'
Battery Replacement Counter When the device is on battery power you can enter the date and time in which the battery was replaced. The displayed duration the battery has been in use will then be shown on the main interface, along with the battery reading. N/A