Atrim help

OmniSensor

Stick

Atrim OmniSensor command classes

Atrim OmniSensor contains multiple command classes which are used for communication between it and Z-Wave gateways. Some command classes can also be used to customize the sensor's settings. Please refer to your Z-Wave controller's user guide for instructions on accessing and changing command classes.

Command ClassVersion
Association2
Association Group Information3
Battery1
Configuration4
Device Reset Locally1
Firmware Update Meta Data5
Indicator3
Manufacturer Specific2
Multi-Channel Association3
Multilevel Sensor1
Notification8
Power Level1
Security 0/21
Supervision1
Transport Service2
Version3
Wakeup2
Z-Wave Plus Info2

Association Groups

OmniSensor supports 7 association groups and every group supports a maximum of 5 associated nodes. Group 1 is Lifeline group; all nodes which associated in this group will receive the messages sent by device through Lifeline.

Note: When Basic CC/ Switch Binary CC are used to control OmniSensor or sent through association groups to control other associated nodes, the variable will be phased as the follow ways:

  • 0x00~0x63 / 0xff means On
  • 0x00 means Off

Other values will be ignored.

The Command Class supported by each association group is shown in the table below:

IDNameNodesProfileDescription
1Lifeline5General: LifelineDevice Reset Locally: When factory reset.
Notification Report: See notification section for more information.
Sensor Multilevel Report: When sensors above over limit or below under limit.
Battery Report:
Indicator Report: Issued when the indicator light changed.
2Motion5General: NABasic Set: Basic Set Command will be sent to the associated device when motion trigger or untrigger. The basic set value is determined by Param3. See Param4 for more information.
3Over Heat5Sensor: TemperatureBasic Set: When the temperature change value is over or under the threshold set by Param10. Scale is determined by Param24.
4Under Heat5Sensor: TemperatureBasic Set: When the light change value is over or under the threshold set by Param11. Scale is determined by Param24.
5Over Light5Sensor: IlluminanceBasic Set: When the current light/lux is over or under the threshold set by Param12.
6Under Light5Sensor: IlluminanceBasic Set: When the current light/lux is under or over the threshold set by Param13.
7Temperature5Sensor: TemperatureAssociated device receive Temperature reports from OmniSensor

Basic CC does not map to any Command Class.

Wakeup

The device stays in sleep status for the majority of time in order to conserve battery life. This will not, however, prevent it from sending motion and other notificatioons on an immediate basis.

The minimum wakeup interval is 1,800 seconds (30 minutes)

The maximum wakeup interval is 86,400 seconds (24 hours)

The default wakeup interval is 28,800 seconds (8 hours) The value is greater, the battery life is longer. Allowable min step among each wakeup interval is 60 seconds, such as 1860s, 1920s, 1980s...

Note: If OmniSensor is in a sleep state for a long time and your gateway shows it is in offline state, you can rediscover it via pressing and holding its Action Button for 3 seconds. OmniSensor will send a wake up notification report to your gateway and let your gateway that it is still online.

Battery

OmniSensor's battery level will be checked every time the device wakes up. These includes the wake-ups owing to the wake-up timer, when motion triggers the sensor, and a pressing of OmniSensor's Action Button. When the percentage of battery life remaining changes, a battery report command will be sent to the controller.

Multilevel Sensor

The device has a temperature/ humidity sensor and an ambient light sensor. The ambient temperature and light will be checked period.

Command ClassCOMMAND_CLASS_SENSOR_MULTILEVEL
CommandSENSOR_MULTILEVEL_REPORT
TypeAir Temperature
ScaleCelsius (EU) / Fahrenheit (US)
Command ClassCOMMAND_CLASS_SENSOR_MULTILEVEL
CommandSENSOR_MULTILEVEL_REPORT
TypeIlluminance
ScaleLux

Notification

Notification TypeNotification Event/StateDescription
Home Security (0x07)State idleNotification value for the state variable going to idle.
Motion detection (0x08)When motion triggered.
Power Management (0x08)Replace battery soon (0x0A)When battery level below the param14 value.
Replace battery now (0x0B)When battery level below 2.2V.
System (0x09)System software failure (manufacturer proprietary failure code provided) (0x04)When watch dog timeout.

Manufacturer Information

ParameterValue
Manufacturer ID 10x0286
Product Type ID 10x0102
Product ID 10x0004

Configuration

User can change the default settings by the below configuration parameters. After device reset, all these parameters will be set to their default values.

Properties:

  • R = Readable
  • W = Writable
  • S = Signed Integer
  • U = Unsigned Integer
  • E = Enumerated
  • B = Bit filed

(Param 3) Motion Untrigger Time

Timeout configuration set in second for motion sensor to send no trigger status.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0320~3600240R/W/U

(Param 4) Motion Sensitivity

Set the sensitivity of motion sensor.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0410~33R/W/U
  • 0 - disable
  • 1 - minimum sensitivity
  • 3 - maximum sensitivity

(Param 7) Motion Group Control (Group 2)

ParameterSize (Byte)Available settingsDefault valueProperty
0x0710/1/2/3/4/5/60R/W/E

The follow are the definitions for the available settings for this command class.

  1. Send BASIC_SET (0xFF) when motion is triggered to associated device
    Send BASIC_SET (0x00) when motion is untriggered to associated device
  2. Send BASIC_SET (0x00) when motion is triggered
    Send BASIC_SET (0xFF) when motion is untriggered
  3. Send BASIC_SET (0xFF) when motion is triggered, Nothing when motion untriggered
  4. Send BASIC_SET (0x00) when motion is triggered, Nothing when motion untriggered
  5. Send BASIC_SET (0x00) when motion is untriggered, Nothing when motion triggered
  6. Send BASIC_SET (0xFF) when motion is untriggered, Nothing when motion triggered
  7. Send BASIC_SET (value is configured by parameter 8) when motion is triggered to associated devices
    Send BASIC_SET (value is configured by parameter 8) when motion is untriggered

(Param 8) Motion Group Value Setting

Set Basic Set value for Group2. The MSB will act as the basic set value when motion trigger. The LSB will act as the basic set value when motion untrigger. E.g. value=0x0A00, then BASIC_SET(0x0A) will be sent when motion trigger, BASIC_SET(0x00) will be sent when motion untrigger.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0820~6553565280R/W/U

(Param 9) Motion Group Control Requirement

Set threshold of Light/Lux when devices associated in group2 should be triggered by motion. Associated device only receive BASIC_SET command when light <= (this value).

ParameterSize (Byte)Available settingsDefault valueProperty
0x0920~3000030000R/W/U

(Param 10) Over Heat Group Threshold (Group3)

Set threshold of temperature. Designed to control Air Conditioners or temperature controllers ON or OFF. If measured temperature >= (this value, Scale is determined by Param64) send BASIC_SET (0xFF) to associated devices. If measured temperature < (this value) send BASIC_SET (0x00) to associated devices. E.g. Value 239 means 23.9°.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0A2270~850 (EU/AU models)
806~1850 (North American models)
270 (EU/AU)
806 (US)
R/W/S

Setting the value to 0 will disable the functionality associatd with this command class.

(Param 11) Under Heat Group Threshold (Group4)

Set threshold of temperature. Designed to control Air Conditioners or temperature controllers ON or OFF. If measured temperature <= (this value, Scale is determined by Param64) send BASIC_SET (0xFF) to associated devices. If measured temperature > (this value) send BASIC_SET (0x00) to associated devices. E.g. Value 155 means 15.5 C. Value 600 means 60.0 F.
ParameterSize (Byte)Available settingsDefault valueProperty
0x0B2-100~155 (EU/AU)
140~ 600 (US)
155 (EU/AU)
600 (US)
R/W/S

Setting the value to 0 will disable the functionality associatd with this command class.

(Param 12) Over Light Group Threshold (Group5)

Set threshold of Light/Lux. If measured light/lux >= (this value) send BASIC_SET (0xFF) to associated devices. If measured light < (this value) send BASIC_SET (0x00) to associated devices.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0C20~300002000R/W/U
  1. 0 - Disable.
  2. 1 ~ 30000 - Enable. Each number in the range of 1 ~ 30000 is equivalent to a lux unit.

(Param 13) Under Light Group Threshold (Group6)

Set threshold of Light/Lux. If measured light/lux <= (this value) send BASIC_SET (0xFF) to associated devices. If measured light/lux > (this value) send BASIC_SET (0x00) to associated devices.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0D20~30000100R/W/U

(Param 14) Low Battery Threshold

Configure low battery report threshold, sends low battery report via notification and battery report when battery level drops under setting. Unit %.

ParameterSize (Byte)Available settingsDefault valueProperty
0x0E210~5020R/W/U

(Param 15) Threshold Check Enable/Disable

ParameterSize (Byte)Available settingsDefault valueProperty
0x0F20/10R/W/E
  • 0 - Disable
  • 1 - Enable

(Param 16) Temperature Threshold

ParameterSize (Byte)Available settingsDefault valueProperty
0x1010~25530R/W/U

Threshold = (Value * 0.1) 0 = disable

(Param 17) Lux Threshold

ParameterSize (Byte)Available settingsDefault valueProperty
0x1120~10000250R/W/U

0 = disable

(Param 18) Threshold Check Time

Set threshold check time in seconds.

ParameterSize (Byte)Available settingsDefault valueProperty
0x12260~65535900R/W/U

(Param 19) Sensor Limit Control

This value is bit mask. Used to enable/disable measurement reports for various sensors that is morethan the upper limit value or less than the lower limit value.

ParameterSize (Byte)Available settingsDefault valueProperty
0x1311|2|3|4|5|6|7|8|9|10|11|12|13|14|150R/W/B
  • 0 - Disabled
  • 1 - Temperature upper level
  • 2 - Lux upper level
  • 4 - Temperature lower level
  • 8 - Lux lower level

Note: this parameter supports combination setting. E.g. if value = 1+2+4+8=15, which means all thelimit reports are enabled.

(Param 20) Temperature Upper Limit

Set upper limit level for temperature set in scale of 0.1. Scale is determined by Param24. If (Current measurement) > (Upper Limit), then report sensor.

ParameterSize (Byte)Available settingsDefault valueProperty
0x142280~1000 (EU/AU)
824~2120 (US)
280 (EU/AU)
824 (US)
R/W/S

(Param 21) Temperature Lower Limit

Set lower limit level for temperature set in scale of 0.1. Scale is determined by Param24. If (Current Measurement) < (Lower limit), then report sensor.

ParameterSize (Byte)Available settingsDefault valueProperty
0x152-400~0 (EU/AU)
-400~320 (US)
0 (EU/AU)
320 (US)
R/W/S

(Param 22) Lux Upper Limit

Set lux upper limit level. If (Current measurement) > (Upper Limit), then report sensor.

ParameterSize (Byte)Available settingsDefault valueProperty
0x1620~300001000R/W/U

(Param 23) Set lux lower limit level.

Set lux lower limit level. If (Current Measurement) < (Lower limit), then report sensor.

ParameterSize (Byte)Available settingsDefault valueProperty
0x1720~30000100R/W/U

(Param 24) Temperature Scale

ParameterSize (Byte)Available settingsDefault valueProperty
0x1810/10 (EU/AU)
1 (US)
R/W/E

(Param 25) Automatic Interval Time

Interval time set in seconds to check the sensor report. Multilevel Sensor Report will be sent when timeout.

ParameterSize (Byte)Available settingsDefault valueProperty
0x19230~655353600R/W/U

11 Security Network

OmniSensor is a security enabled Z-Wave Plus product that is able to use encrypted Z-Wave Plus messages to communicate to other security enabled Z-Wave Plus products.

The device supports the security function with S0 and S2 encrypted communication. The device will auto switch to the security mode when the device included with a security controller. In the security mode, the commands will use security and security2 command class wrapped to communicate with others, otherwise the device will not response any commands.

OmniSensor supports security levels are listed in below table:

Security LevelsSupported?
SECURITY_KEY_S0Yes
SECURITY_KEY_S2_UNAUTHENTICATEDYes
SECURITY_KEY_S2_AUTHENTICATEDYes
SECURITY_KEY_S2_ACCESSNo

Further help

Help with Atrim OmniSensor

Other popular, self-help guides for OmniSensor are listed below below. You can also learn more about its features at our dedicated Atrim OmniSensor page while all Atrim OmniSensor help guides have a dedicated repository.

Setup Atrim OmniSensor

Connect OmniSensor to Home Assistant

Connect OmniSensor to SmartThings

Need assistance?

Atrim's team is just an email away and ready to answer all of your questions. If you need further help with any of our products, please let us know how we can help you.

Contact us