The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

PST02B Slim Multi-Sensor (PIR/Temperature/Illumination)

This describes the Z-Wave device PST02B, manufactured by Philio Technology Corp with the thing type UID of philio_pst02b_00_000.

The device is in the category of Sensor, defining Device used to measure something.

PST02B product image

The PST02B supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is unable to participate in the routing of data from other devices.

The PST02B does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. The wakeup period can be configured in the user interface - it is advisable not to make this too short as it will impact battery life - a reasonable compromise is 1 hour. The wakeup period does not impact the devices ability to report events or sensor data. The device can be manually woken with a button press on the device as described below - note that triggering a device to send an event is not the same as a wakeup notification, and this will not allow the controller to communicate with the device.

Overview

No device information is provided in the database. Consider updating the database to improve the documentation.

Channels

The following table summarises the channels available for the PST02B -:

Channel Channel Id Category Item Type
Binary Sensor sensor_binary Door Switch
Sensor (temperature) sensor_temperature Temperature Number
Sensor (luminance) sensor_luminance Temperature Number
Alarm (burglar) alarm_burglar Door Switch
Battery Level battery-level Battery Number

Binary Sensor

Indicates if a sensor has triggered.

The sensor_binary channel supports the Switch item and is in the Door category. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
ON Triggered
OFF Untriggered

Sensor (temperature)

Indicates the current temperature.

The sensor_temperature channel supports the Number item and is in the Temperature category. This is a read only channel so will only be updated following state changes from the device.

Sensor (luminance)

Indicates the current light reading.

The sensor_luminance channel supports the Number item and is in the Temperature category. This is a read only channel so will only be updated following state changes from the device.

Alarm (burglar)

Indicates if the burglar alarm is triggered.

The alarm_burglar channel supports the Switch item and is in the Door category. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF Ok
ON Alarm

Battery Level

Represents the battery level as a percentage (0-100%). Bindings for things supporting battery level in a different format (e.g. 4 levels) should convert to a percentage to provide a consistent battery level reading.

The battery-level channel supports the Number item and is in the Battery category.

Device Configuration

The following table provides a summary of the 14 configuration parameters available in the PST02B. Detailed information on each parameter can be found in the sections below.

Param Name Description
2 Basic Set Level BASIC command value sent when turning on lights
3 PIR Sensitivity PIR Sensitivity setting.
4 Light Threshold Illumination threshold for turning on associated lights.
5 Operation Mode Mode of operation and enabled multisensor functions
6 Multisensor Function Switch Enable or disable functions of the multisensor.
7 Customer Function Enable or disable functions of the multisensor.
8 PIR Re-Detect Interval Time Time period to wait until reporting motion detected again.
9 Turn Off Light Time Time to wait before sending command to turn off lights
10 Auto Report Battery Time The interval time for auto reporting the battery level.
12 Auto Report Illumination Time The interval time for auto reporting the illumination state
13 Auto Report Temperature Time The interval time for auto reporting the temperature.
20 Auto Report Tick interval The interval time for auto report each tick.
21 Temperature differential report The temperature differential to report
22 Illumination differential report The illumination differential to report.
  Wakeup Interval Sets the interval at which the device will accept commands from the controller
  Wakeup Node Sets the node ID of the device to receive the wakeup notifications

Parameter 2: Basic Set Level

BASIC command value sent when turning on lights BASIC command value to send when turning on the light.

  • -1 (0xFF): turn on the light
  • 0: turn off the light
  • 1–100: send this dimmer value Values in the range -1 to 100 may be set.

The manufacturer defined default value is -1.

This parameter has the configuration ID config_2_1 and is of type INTEGER.

Parameter 3: PIR Sensitivity

PIR Sensitivity setting. Sensitivity for the PIR (Passiv Infrared) sensor

  • 0: Disable PIR motion detection.
  • 1–99: Motion detection sensitivity, where 1 is the lowest and 99 is the highest. Values in the range 0 to 99 may be set.

The manufacturer defined default value is 70.

This parameter has the configuration ID config_3_1 and is of type INTEGER.

Parameter 4: Light Threshold

Illumination threshold for turning on associated lights. When the event is triggered and the environment illumination is lower than the threshold, the device will turn on the associated lights.

  • 0: turn off the illumination detection function and never turn on the lights
  • 1: darkest threshold level
  • 99 brightest threshold level
  • 100: turn off the illumination detection function and always turn on the lights.

Note: when not in test mode, only values in the range 1–99 will enable the illumination detection function and update the illumination value. Values in the range 0 to 100 may be set.

The manufacturer defined default value is 100.

This parameter has the configuration ID config_4_1 and is of type INTEGER.

Parameter 5: Operation Mode

Mode of operation and enabled multisensor functions Bitfield for setting the device in certain modes and enabling or disabling specific functions of the multisensor device.

  • Bit 0: reserved.
  • Bit 1: device mode. 0 = normal mode; 1 = test mode.
  • Bit 2: disable the door/window function. 0 = enabled; 1 = disabled.
  • Bit 3: temperature unit. 0 = Fahrenheit; 1 = Celcius.
  • Bit 4: disable the illumination report after event triggered. 0 = enabled; 1 = disabled.
  • Bit 5: disable the temperature report after event triggered. 0 = enabled; 1 = disabled.
  • Bit 6: reserved.
  • Bit 7: disable the back key release into test mode. 0 = enabled; 1 = disabled. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_5_1 and is of type INTEGER.

Parameter 6: Multisensor Function Switch

Enable or disable functions of the multisensor. Bitfield for enabling or disabling functions of the multisensor.

  • Bit 0: Disable magnetic integrate illumination.
  • Bit 1: Disable PIR integrate Illumination.
  • Bit 2: Disable magnetic integrate PIR (Default is 1 = disabled).
  • Bit 3: When bit 2 is 0 (enabled), is the device is installed in the same room as the light? 0 = In the same room; 1 = In another room.
    • Note: If this bit is 1, it is recommended to also set bit 1 to 1, because when the PIR triggered, it doesn’t mean that a person is in the room where the lights are.
  • Bit 4: Disable the 5 seconds delay to turn off the light, when door/window is closed.
  • Bit 5: Disable auto turn off the light, after door/window opened to turn on the light.
    • Note: If bit 2 is 0, this setting has no effect.
    • Note: If configuration parameter is 0, this setting has no effect.
  • Bit 6: Reserved
  • Bit 7: Reserved Values in the range 0 to 63 may be set.

The manufacturer defined default value is 4.

This parameter has the configuration ID config_6_1 and is of type INTEGER.

Parameter 7: Customer Function

Enable or disable functions of the multisensor. Bitfield for enabling or disabling certain customer functions of the multisensor device.

  • Bit 0: Reserved.
  • Bit 1: Enable sending motion OFF report. 0=Disable; 1=Enable. Note: Depends on the value of bit 4, see below:
    • Bit 4 is 0: Report Notification CC, Type: 0x07, Event: 0xFE.
    • Bit 4 is 1: Sensor Binary Report, Type: 0x0C, Value: 0x00.
  • Bit 2: Enable PIR super sensitivity mode. 0=Disable; 1=Enable.
  • Bit 3: Disable sending BASIC OFF after door/window is closed. 1=Disable, 0=Enable.
  • Bit 4: Notification type. 0=Using Notification Report; 1=Using Sensor Binary Report.
  • Bit 5: Disable Multi CC in auto report. 1=Disable; 0=Enable.
  • Bit 6: Disable reporting battery state when the device is triggered. 1=Disable; 0=Enable.
  • Bit 7: Reserved. The following option values may be configured, in addition to values in the range 0 to 127 -:
Value Description
22 Preset for motion detection settings.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_7_1 and is of type INTEGER.

Parameter 8: PIR Re-Detect Interval Time

Time period to wait until reporting motion detected again. After sending a “motion detected” report, wait at least the configured number of seconds before sending a new “motion detected” report.

The timeout is the configured value multiplied with 8 seconds, i.e. value 3 (the default) means 24 seconds timeout.

Note: This setting applies to normal mode only. Values in the range 1 to 127 may be set.

The manufacturer defined default value is 3.

This parameter has the configuration ID config_8_1 and is of type INTEGER.

Parameter 9: Turn Off Light Time

Time to wait before sending command to turn off lights When a BASIC SET command has been sent to turn on lights and motion is no longer detected by the PIR sensor, wait the configured time before sending a “turn off light” command.

The timeout is the configured value multiplied with 8 seconds, i.e. value 4 (the default) means 32 seconds timeout.

0 means “never turn off the lights”. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 4.

This parameter has the configuration ID config_9_1 and is of type INTEGER.

Parameter 10: Auto Report Battery Time

The interval time for auto reporting the battery level. The interval time for auto reporting the battery level. The value is multiplied with the value of configuration parameter 20 and the unit is minutes. If the value is 0, auto reporting of battery level is turned off.

If this parameter has its default value (12) and parameter 20 has its default value (30), the interval time is 6 hours. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 12.

This parameter has the configuration ID config_10_1 and is of type INTEGER.

Parameter 12: Auto Report Illumination Time

The interval time for auto reporting the illumination state The interval time for auto reporting the battery level. The value is multiplied with the value of configuration parameter 20 and the unit is minutes. If the value is 0, auto reporting of illumination is turned off.

If this parameter has its default value (12) and parameter 20 has its default value (30), the interval time is 6 hours. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 12.

This parameter has the configuration ID config_12_1 and is of type INTEGER.

Parameter 13: Auto Report Temperature Time

The interval time for auto reporting the temperature. The interval time for auto reporting the temperature. The value is multiplied with the value of configuration parameter 20 and the unit is minutes. If the value is 0, auto reporting of temperature is turned off.

If this parameter has its default value (12) and parameter 20 has its default value (30), the interval time is 6 hours. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 12.

This parameter has the configuration ID config_13_1 and is of type INTEGER.

Parameter 20: Auto Report Tick interval

The interval time for auto report each tick. The interval time for auto report each tick. Setting this configuration will effect configuration No. 10, No. 11, No. 12 and No. 13

The unit is 1 minute

Caution1: Setting to 0 means turn off all auto report function.

Caution 2: Thge value is unsigned byte. the range is from 0x00 to 0xff Values in the range 0 to 255 may be set.

The manufacturer defined default value is 30.

This parameter has the configuration ID config_20_1 and is of type INTEGER.

Parameter 21: Temperature differential report

The temperature differential to report The temperature differential to report.

0 means turn off.

The unit is fahrenheit.

Enable this function the device will detect every minute. And when the temperature is over 140 degree fahrenheit, it will continue report.

Enable this functionallity will cause some issue please see the detail in the “Temperature Report” section. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_21_1 and is of type INTEGER.

Parameter 22: Illumination differential report

The illumination differential to report. The illumination differential to report.

0 means turn off this function. The unit is percentage.

Enable this function the device will detect every minute.

Enable thsi functionallity will cause some issue please see the detail in the “Illumination Report” section. Values in the range 0 to 127 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_22_1 and is of type INTEGER.

Wakeup Interval

The wakeup interval sets the period at which the device will listen for messages from the controller. This is required for battery devices that sleep most of the time in order to conserve battery life. The device will wake up at this interval and send a message to the controller to tell it that it can accept messages - after a few seconds, it will go back to sleep if there is no further communications.

This setting is defined in seconds. It is advisable not to set this interval too short or it could impact battery life. A period of 1 hour (3600 seconds) is suitable in most instances.

Note that this setting does not affect the devices ability to send sensor data, or notification events.

This parameter has the configuration ID wakeup_interval and is of type INTEGER.

Wakeup Node

When sleeping devices wake up, they send a notification to a listening device. Normally, this device is the network controller, and normally the controller will set this automatically to its own address. In the event that the network contains multiple controllers, it may be necessary to configure this to a node that is not the main controller. This is an advanced setting and should not be changed without a full understanding of the impact.

This parameter has the configuration ID wakeup_node and is of type INTEGER.

Association Groups

Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.

The PST02B supports 2 association groups.

Group 1: Reports

This group supports 7 nodes.

Group 2: Light Control

This group supports 7 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_SENSOR_BINARY_V2  
COMMAND_CLASS_SENSOR_MULTILEVEL_V5  
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1  
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1  
COMMAND_CLASS_ZWAVEPLUS_INFO_V1  
COMMAND_CLASS_CONFIGURATION_V1  
COMMAND_CLASS_ALARM_V3  
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1  
COMMAND_CLASS_POWERLEVEL_V1  
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1  
COMMAND_CLASS_BATTERY_V1  
COMMAND_CLASS_WAKE_UP_V2  
COMMAND_CLASS_ASSOCIATION_V1  
COMMAND_CLASS_VERSION_V1  
COMMAND_CLASS_MULTI_CMD_V1  
COMMAND_CLASS_SECURITY_V1  

Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.