N00b Guide: Receive instant notification when doorbell rings

Word of warning, this is very noob friendly. So, those that are more seasoned, be warned!

Parts needed:

Total Cost: ~$75.

SmartThings Necessities:

First, kudos go to @gorf for creating the initial device type I used. It is his code that I slightly modified to work best for me.

  1. Login to https://graph.api.smartthings.com/ and click the “My Device Types” tab

  2. Click the green “Create New Device Type” button in the top right of the screen

  3. On the next page, select the middle option “From Code”

  4. Paste the following code:

    • MIMOLite Doorbell

    metadata {
    definition (name: “MIMOLite Doorbell”, namespace: “NTDCS”, author: “Adam Newcomb”) {
    capability “Contact Sensor”
    capability “Refresh”
    capability “Configuration”
    //uncomment for switch

    capability “Polling”
    capability “Switch”
    simulator {
    // reply messages
    reply “2001FF,delay 100,2502”: “command: 2503, payload: FF”
    reply “200100,delay 100,2502”: “command: 2503, payload: 00”

     	// status messages
     	status "open":  "command: 2001, payload: FF"
     	status "closed": "command: 2001, payload: 00"
         //uncomment for switch
         status "on":  "command: 2003, payload: FF"
     	status "off": "command: 2003, payload: 00"
     tiles {
         standardTile("contact", "device.contact", inactiveLabel: false) {
     		state "open", label: "DingDong!", icon: "st.security.alarm.alarm", backgroundColor: "#ffa81e"
     		state "closed", label: " ", icon: "st.security.alarm.clear", backgroundColor: "#79b821"
         standardTile("refresh", "device.switch", inactiveLabel: false, decoration: "flat") {
     		state "default", label:'', action:"refresh.refresh", icon:"st.secondary.refresh"
     	//uncomment for switch
     	standardTile("switch", "device.switch", canChangeBackground: true, canChangeIcon: true, inactiveLabel: false) {
         	state "off", label: '${name}', action: "switch.on", icon: "st.switches.switch.off", backgroundColor: "#ffffff"
     		state "on", label: '${name}', action: "switch.off", icon: "st.switches.switch.on", backgroundColor: "#ffa81e"
         valueTile("voltage", "device.voltage") {
     		state("voltage", label:'${currentValue}v', unit:"ADC")
     	main (["contact"])
         //uncomment for switch
     	details(["contact", "voltage", "refresh", "power" /* , "switch" */])


    def parse(String description) {

     def result = null
     def cmd = zwave.parse(description, [0x20: 1, 0x84: 1, 0x30: 1, 0x70: 1, 0x31: 3, 0x71: 1])
     if (cmd) {
         result = zwaveEvent(cmd)
         log.debug "parse cmd: '${cmd}' to result: '${result.inspect()}'"
     } else {
         log.debug "parse failed for event: '${description}'"


    def zwaveEvent(physicalgraph.zwave.commands.sensorbinaryv1.SensorBinaryReport cmd)
    log.debug “zwaveEvent SensorBinaryReport: ‘${cmd}’”

    def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicSet cmd)
    //BUGBUG_NOTE: this is the event that gets sent from simluated messages and also if subscribed to association group 1
    log.debug “zwaveEvent BasicSet: ‘${cmd}’”

    def zwaveEvent(physicalgraph.zwave.commands.sensormultilevelv3.SensorMultilevelReport cmd)
    log.debug “zwaveEvent SensorMultilevelReport: ‘${cmd}’”

     createEvent( name: "voltage", isStateChange:true, value:cmd.scaledSensorValue,descriptionText: "${device.displayName} measured voltage in ADC Counts")


    def zwaveEvent(physicalgraph.zwave.commands.alarmv1.AlarmReport cmd)
    log.debug “zwaveEvent AlarmReport: ‘${cmd}’”

     switch (cmd.alarmType) {
         case 8:
             def map = [ name: "power", isStateChange:true]
             if (cmd.alarmLevel){
                 map.descriptionText = "${device.displayName} lost power"
             else {
                 map.descriptionText = "${device.displayName} has power"


    def zwaveEvent(physicalgraph.zwave.commands.switchbinaryv1.SwitchBinaryReport cmd) {
    log.debug “zwaveEvent SwitchBinaryReport: ‘${cmd}’”

    def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicReport cmd) {
    log.debug “zwaveEvent BasicReport: ‘${cmd}’”



    def zwaveEvent(physicalgraph.zwave.commands.configurationv1.ConfigurationReport cmd) {
    log.debug “zwaveEvent ConfigurationReport: ‘${cmd}’”

    def zwaveEvent(physicalgraph.zwave.commands.associationv2.AssociationReport cmd) {
    cmd.nodeId.each({log.debug “AssociationReport: ‘${cmd}’, hub: ‘$zwaveHubNodeId’ reports nodeId: ‘it' is associated in group: '{cmd.groupingIdentifier}’”})
    def zwaveEvent(physicalgraph.zwave.Command cmd) {
    log.debug “zwaveEvent Command not Handled: ‘${cmd}’”
    // Handles all Z-Wave commands we aren’t interested in

    private sensorValueEvent(Short value) {

     def result = []
     if (value) {
     	log.debug "Open sensor value event: $value"
         result << createEvent(name: "contact", value: "open", descriptionText: "$device.displayName is open", isStateChange:true )
     } else {
         log.debug "Closed sensor value event: $value"
     	result << createEvent(name: "contact", value: "closed", descriptionText: "$device.displayName is closed", isStateChange:true)


    private switchValueEvent(Short value)
    createEvent([name: “switch”, value: value ? “on” : “off”, isStateChange:true ])

    def refresh() {
    log.debug “executing ‘refresh’”



    // handle commands
    def configure() {
    log.debug “executing ‘configure’”

     8v=11000101 = 197
     7v=11000001 = 193
     4v=2741=10101011 = 171
     5v=2892=10110100 = 180
     24v=11101000 = 232
     23v=11100111 = 231
     def cmd = delayBetween([
     	//zwave.configurationV1.configurationSet(parameterNumber: 2, size: 1, configurationValue: [1]).format(),  // clear pulse meter counts
     	zwave.configurationV1.configurationSet(parameterNumber: 3, size: 1, configurationValue: [1]).format(),  // sig 1 triggers relay
         zwave.configurationV1.configurationSet(parameterNumber: 4, size: 1, configurationValue: [100]).format(),  // lower threshold, high
         zwave.configurationV1.configurationSet(parameterNumber: 5, size: 1, configurationValue: [39]).format(),  // lower threshold, low
         zwave.configurationV1.configurationSet(parameterNumber: 6, size: 1, configurationValue: [232]).format(),  // upper threshold, high
         zwave.configurationV1.configurationSet(parameterNumber: 7, size: 1, configurationValue: [231]).format(),  // upper threshold, low
         zwave.configurationV1.configurationSet(parameterNumber: 8, size: 1, configurationValue: [1]).format(),  // set to analog, below bounds
         zwave.configurationV1.configurationSet(parameterNumber: 9, size: 1, configurationValue: [255]).format(),  // disable periodic reports
         zwave.configurationV1.configurationSet(parameterNumber: 11, size: 1, configurationValue: [0]).format(),  // momentary relay
         zwave.associationV1.associationSet(groupingIdentifier:1, nodeId:zwaveHubNodeId).format(),	//subscribe to basic sets on sig1
         zwave.associationV1.associationSet(groupingIdentifier:2, nodeId:zwaveHubNodeId).format(),	//subscribe to basic multisensorreports
         zwave.associationV1.associationSet(groupingIdentifier:3, nodeId:zwaveHubNodeId).format(),	//subscribe to power alarm
         zwave.associationV1.associationRemove(groupingIdentifier:4, nodeId:zwaveHubNodeId).format(),	//unsubscribe from binary sensor reports
         zwave.associationV1.associationRemove(groupingIdentifier:5, nodeId:zwaveHubNodeId).format()	//unsubscribe from pulse meter events


    //uncomment for switch
    def poll() {
    // If you add the Polling capability to your device type, this command will be called approximately
    // every 5 minutes to check the device’s state

    def on() {
    zwave.basicV1.basicSet(value: 0xFF).format(),

    def off() {
    zwave.basicV1.basicSet(value: 0x00).format(),

  5. Click the Save button in the top right of the box you just pasted the code into

  6. Click Publish -> For Me

7 ) Now that the software/code side of things is done, we need to associate the Mimolite to your ST hub and change what it auto detected as the MIMOlite’s device type. Keep reading!

  1. Temporarily power the MIMOlite by using the included AC/DC adapter and add it to your hub. It will show up as a Zwave switch, but we will change that!

  2. Now that the MIMOlite is added to your ST, go back into where you were copying/pasting the code in step 4 and click “My Devices”. You should see a new one called “Zwave Switch”, so click on it to open the device, then the red “Edit” button at the bottom.

  3. Rename the device and label to something more logical. I named mine “Doorbell Sensor” for both. Then, and this is important, we need to change the “Type” dropdown to “MIMOlite Doorbell”, which is what we created in the editor in step 4 as well.

  4. Ditch the wall wart adapter and wire the AL624 from the doorbell. Then, wire the AL624 to the MIMOlite. See pictures (worth a thousand words)

(White and black wires are what I’m trying to highlight here)

(Red and white wires are what I’m trying to highlight below)

  1. I used the “Notify Me When” smartapp. You can find it on your phone by:
  • Click the (+) symbol at the bottom of your SmartThings app (you may have to swipe down)
  • Scroll right until you are at the “More” section
  • Select the Convenience section and scroll down to "Get a push notification or text message when any of a variety of SmartThings is activated…The icon is a set of brown french doors and titled “Notify me When by SmartThings”.
  1. Configure it so that the “Contact Opens” section uses the Doorbell Sensor and optionally specify if you want it to notify you via Push or Push/SMS.

You’re done! Be sure and enclose the AL624 in some sort of project box.

Hope this helps!


+3 for mentioning a project box. :sunglasses::sunglasses::sunglasses:

I was always taught if you can see where the wires connect to the screws, dust can settle, greatly increasing fire risk. Even a top quality project box costs less than $10. A local electrical supply house will have lots to choose from, or you can get them online.


I like to buy locally because they often have interior features which change the dimensions.

But it’s always satisfying to finish a project professionally. :traffic_light: :zap:

@JDRoberts No truer words have been spoken! If it has current, it can spark.

For only a little bit more, one can get a Altronix BC100 enclosure made to mount the AL624 power supply. Another option, too. I think that part number is AL624E.

1 Like

Does the Mimolite even stay powered on long enough to send an open/closed signal??

Yep - been working wonderfully since I started this post two years ago.

1 Like