Software Overview  |  Sitemap  |  Downloads  |  Developers  |  Forums

Z-Wave HomeSeer Multi Sensor

The HomeSeer Multi Sensor is a battery powered device which senses motion, temperature, and light. The sensitivity of the motion sensor is configurable. Temperature is reported in both Celsius and Fahrenheit. If the temperature sensor values are inaccurate, the sensor can be calibrated. Light intensity is reported on a scale of 0-100, where 0 means there is no light, and 100 means the sensor is saturated.

Being a battery powered device, the Multi Sensor spends most of its time "sleeping". It sleeps to conserve its batteries. When the device is sleeping, it can still sense and report motion, but it won't listen to any messages from the Z-Wave network. The device will occasionally "wake up", and then it will report its battery state, temperature reading, light reading, and it can receive messages from the network. The time between wake ups is programmable. Longer intervals prolong battery life, but make the device less responsive to the network and delay the time between temperature and light readings.

Terminals Description

The HomeSeer Multi Sensor Device has five output status terminals. The "motion" terminal shows if it senses motion (on), or not (off). The "light" terminal senses light intensity (from 0% to 100%). The "temp_F" terminal shows the temperature in Fahrenheit, and the "temp_C" terminal shows the temperature in Celsius. The "battery" terminal shows the state of the battery. The battery terminal has values of 100 or less. 100 means the battery is at 100% of its capacity.

Installing a HomeSeer Multi Sensor

Create the HomeSeer Multi Sensor Device by running the SensorHomeSeerMulti Script. The parameters required by the SensorHomeSeerMulti Script are:

address :

port_location :

  • this parameter is only necessary when there is more than one Z-Wave network. The port_location is the USB port of the network's Z-Wave controller. It is used to differentiate Z-Wave networks. In *nix systems, this is in the /dev directory with a name like /dev/ttyUSB0 or /dev/cu.usbserial-00001004. Type "ls -lrt /dev/*" for hints. On Windows systems, the location is COMx where "x" is a number (1,2,3, etc.).

The following are optional parameters. If you set any one of these values to nil, your Multi Sensor will use the last value it was sent (or, if it's a new device, its pre-programmed value).

led_on :

  • if set to 255, the device's LED will turn on when it is transmitting data. If set to 0, the LED will never turn on. New devices are set to 255.

motion_sensitivity :

  • if set to 255, it is most sensitive to motion. If set to 0, it is least sensitive. Here are some rough guidelines:
    10 => using with pets (and don't wish them to trigger the sensor)
    50 => outdoor use
    100 => hallway use
    200 => general use
    New devices are set to 200.

on_time :

  • time, in minutes, the motion detect output will stay on, after it's last trigger. Higher values will keep the message rate down when there is steady activity (and save battery power). Values can be from 1-100. New devices are set to 20.

temp_adjust :

  • amount to change the measured temperature when reporting a temperature. The change value can be from -128 to +127. The adjustment value will be divided by 10 and added to the sensed Fahrenheit temperature. These numbers translate to changes from -12.8F to +12.7F. The Celsius temperature will be adjusted so it agrees with the Fahrenheit value. New devices are set to 0.

wakeup_interval :

  • the time, in seconds, between wake ups (typical intervals are an hour to a few hours long).


To add a HomeSeer Multi Sensor Device with ID "multi", a wakeup interval of 12 hours, and a Z-Wave address of 10 to a system with one Z-Wave network, run the SensorHomeSeerMulti Script with the following parameters:

id: "multi"
wakeup_interval: 43200    # 60 * 60 * 12
address: 10

Catalina Computing, LLC.

Copyright © Catalina Computing, LLC. (2013-2018)

Page last updated: Wed Jan 7 14:44:56 2015 (UTC)