diff --git a/devicetypes/besense/besense-door-window-sensor.src/besense-door-window-sensor.groovy b/devicetypes/besense/besense-door-window-sensor.src/besense-door-window-sensor.groovy new file mode 100644 index 0000000..d130f6e --- /dev/null +++ b/devicetypes/besense/besense-door-window-sensor.src/besense-door-window-sensor.groovy @@ -0,0 +1,256 @@ +/** + * Besense z-wave Door/window sensor + */ + +metadata { + definition (name: "BeSense Door/Window Sensor", namespace: "BeSense", author: "BeSense") { + capability "Contact Sensor" + capability "Sensor" + capability "Battery" + capability "Configuration" + + fingerprint mfr: "0214", prod: "0002", model: "0001", deviceJoinName: "BeSense Door/window sensor" + } + + // simulator metadata + simulator { + // status messages + status "open": "command: 2001, payload: FF" + status "closed": "command: 2001, payload: 00" + status "wake up": "command: 8407, payload: " + } + + // UI tile definitions + tiles(scale: 1) { + standardTile("contact", "device.contact", width: 3, height: 3, canChangeIcon: true) { + state ("open", label: '${name}', icon: "st.contact.contact.open", backgroundColor: "#ea0f46") + state ("closed", label: '${name}', icon: "st.contact.contact.closed", backgroundColor: "#27CC73") + } + valueTile("battery", "device.battery", inactiveLabel: false, decoration: "flat") { + state "battery", label:'${currentValue}% battery', unit:"" + } + + main "contact" + details(["contact", "battery"]) + } +} + +def parse(String description) { + def result = null + if (description.startsWith("Err 106")) { + if (state.sec) { + log.debug description + } else { + result = createEvent( + descriptionText: "This sensor failed to complete the network security key exchange. If you are unable to control it via SmartThings, you must remove it from your network and add it again.", + eventType: "ALERT", + name: "secureInclusion", + value: "failed", + isStateChange: true, + ) + } + } else if (description != "updated") { + def cmd = zwave.parse(description, [0x20: 1, 0x25: 1, 0x30: 1, 0x31: 5, 0x80: 1, 0x84: 1, 0x71: 3, 0x9C: 1]) + if (cmd) { + result = zwaveEvent(cmd) + } + } + log.debug "parsed '$description' to $result" + return result +} + +def updated() { + def cmds = [] + if (!state.MSR) { + cmds = [ + command(zwave.manufacturerSpecificV2.manufacturerSpecificGet()), + "delay 1200", + zwave.wakeUpV1.wakeUpNoMoreInformation().format() + ] + } else if (!state.lastbat) { + cmds = [] + } else { + cmds = [zwave.wakeUpV1.wakeUpNoMoreInformation().format()] + } + response(cmds) +} + +def configure() { + commands([ + zwave.manufacturerSpecificV2.manufacturerSpecificGet(), + zwave.batteryV1.batteryGet() + ], 6000) +} + +def sensorValueEvent(value) { + if (value) { + createEvent(name: "contact", value: "open", descriptionText: "$device.displayName is open") + } else { + createEvent(name: "contact", value: "closed", descriptionText: "$device.displayName is closed") + } +} + +def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicReport cmd) +{ + sensorValueEvent(cmd.value) +} + +def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicSet cmd) +{ + sensorValueEvent(cmd.value) +} + +def zwaveEvent(physicalgraph.zwave.commands.switchbinaryv1.SwitchBinaryReport cmd) +{ + sensorValueEvent(cmd.value) +} + +def zwaveEvent(physicalgraph.zwave.commands.sensorbinaryv1.SensorBinaryReport cmd) +{ + sensorValueEvent(cmd.sensorValue) +} + +def zwaveEvent(physicalgraph.zwave.commands.sensoralarmv1.SensorAlarmReport cmd) +{ + sensorValueEvent(cmd.sensorState) +} + +def zwaveEvent(physicalgraph.zwave.commands.notificationv3.NotificationReport cmd) +{ + def result = [] + if (cmd.notificationType == 0x06 && cmd.event == 0x16) { + result << sensorValueEvent(1) + } else if (cmd.notificationType == 0x06 && cmd.event == 0x17) { + result << sensorValueEvent(0) + } else if (cmd.notificationType == 0x07) { + if (cmd.v1AlarmType == 0x07) { // special case for nonstandard messages from Monoprice door/window sensors + result << sensorValueEvent(cmd.v1AlarmLevel) + } else if (cmd.event == 0x01 || cmd.event == 0x02) { + result << sensorValueEvent(1) + } else if (cmd.event == 0x03) { + result << createEvent(descriptionText: "$device.displayName covering was removed", isStateChange: true) + if(!state.MSR) result << response(command(zwave.manufacturerSpecificV2.manufacturerSpecificGet())) + } else if (cmd.event == 0x05 || cmd.event == 0x06) { + result << createEvent(descriptionText: "$device.displayName detected glass breakage", isStateChange: true) + } else if (cmd.event == 0x07) { + if(!state.MSR) result << response(command(zwave.manufacturerSpecificV2.manufacturerSpecificGet())) + result << createEvent(name: "motion", value: "active", descriptionText:"$device.displayName detected motion") + } + } else if (cmd.notificationType) { + def text = "Notification $cmd.notificationType: event ${([cmd.event] + cmd.eventParameter).join(", ")}" + result << createEvent(name: "notification$cmd.notificationType", value: "$cmd.event", descriptionText: text, displayed: false) + } else { + def value = cmd.v1AlarmLevel == 255 ? "active" : cmd.v1AlarmLevel ?: "inactive" + result << createEvent(name: "alarm $cmd.v1AlarmType", value: value, displayed: false) + } + result +} + +def zwaveEvent(physicalgraph.zwave.commands.wakeupv1.WakeUpNotification cmd) +{ + def event = createEvent(descriptionText: "${device.displayName} woke up", isStateChange: false) + def cmds = [] + if (!state.MSR) { + cmds << command(zwave.manufacturerSpecificV2.manufacturerSpecificGet()) + cmds << "delay 1200" + } + if (!state.lastbat || now() - state.lastbat > 53*60*60*1000) { + cmds << command(zwave.batteryV1.batteryGet()) + } else { + cmds << zwave.wakeUpV1.wakeUpNoMoreInformation().format() + } + [event, response(cmds)] +} + +def zwaveEvent(physicalgraph.zwave.commands.batteryv1.BatteryReport cmd) { + def map = [ name: "battery", unit: "%" ] + if (cmd.batteryLevel == 0xFF) { + map.value = 1 + map.descriptionText = "${device.displayName} has a low battery" + map.isStateChange = true + } else { + map.value = cmd.batteryLevel + } + state.lastbat = now() + [createEvent(map), response(zwave.wakeUpV1.wakeUpNoMoreInformation())] +} + +def zwaveEvent(physicalgraph.zwave.commands.manufacturerspecificv2.ManufacturerSpecificReport cmd) { + def result = [] + + def msr = String.format("%04X-%04X-%04X", cmd.manufacturerId, cmd.productTypeId, cmd.productId) + log.debug "msr: $msr" + updateDataValue("MSR", msr) + + retypeBasedOnMSR() + + result << createEvent(descriptionText: "$device.displayName MSR: $msr", isStateChange: false) + + if (msr == "011A-0601-0901") { // Enerwave motion doesn't always get the associationSet that the hub sends on join + result << response(zwave.associationV1.associationSet(groupingIdentifier:1, nodeId:zwaveHubNodeId)) + } else if (!device.currentState("battery")) { + if (msr == "0086-0102-0059") { + result << response(zwave.securityV1.securityMessageEncapsulation().encapsulate(zwave.batteryV1.batteryGet()).format()) + } else { + result << response(command(zwave.batteryV1.batteryGet())) + } + } + + result +} + +def zwaveEvent(physicalgraph.zwave.commands.securityv1.SecurityMessageEncapsulation cmd) { + def encapsulatedCommand = cmd.encapsulatedCommand([0x20: 1, 0x25: 1, 0x30: 1, 0x31: 5, 0x80: 1, 0x84: 1, 0x71: 3, 0x9C: 1]) + // log.debug "encapsulated: $encapsulatedCommand" + if (encapsulatedCommand) { + state.sec = 1 + zwaveEvent(encapsulatedCommand) + } +} + +def zwaveEvent(physicalgraph.zwave.Command cmd) { + createEvent(descriptionText: "$device.displayName: $cmd", displayed: false) +} + +private command(physicalgraph.zwave.Command cmd) { + if (state.sec == 1) { + zwave.securityV1.securityMessageEncapsulation().encapsulate(cmd).format() + } else { + cmd.format() + } +} + +private commands(commands, delay=200) { + delayBetween(commands.collect{ command(it) }, delay) +} + +def retypeBasedOnMSR() { + switch (state.MSR) { + case "0086-0002-002D": + log.debug "Changing device type to Z-Wave Water Sensor" + setDeviceType("Z-Wave Water Sensor") + break + case "011F-0001-0001": // Schlage motion + case "014A-0001-0001": // Ecolink motion + case "014A-0004-0001": // Ecolink motion + + case "0060-0001-0002": // Everspring SP814 + case "0060-0001-0003": // Everspring HSP02 + case "011A-0601-0901": // Enerwave ZWN-BPC + case "0214-0002-0002": // Besense pir or ceiling sensor + log.debug "Changing device type to Z-Wave Motion Sensor" + setDeviceType("Z-Wave Motion Sensor") + break + case "013C-0002-000D": // Philio multi + + log.debug "Changing device type to 3-in-1 Multisensor Plus (SG)" + setDeviceType("3-in-1 Multisensor Plus (SG)") + break + case "0109-2001-0106": // Vision door/window + log.debug "Changing device type to Z-Wave Plus Door/Window Sensor" + setDeviceType("Z-Wave Plus Door/Window Sensor") + break + case "0109-2002-0205": // Vision Motion + log.debug "Changing device type to Z-Wave Plus Motion/Temp Sensor" + setDeviceType("Z-Wave Plus Motion/Temp Sensor") + break + } +} \ No newline at end of file