[RELEASE] Enhanced ZigBee Keypad Lock - Centralite, IRIS, UEI and Xfinity Keypads Device Handler


(www.rboyapps.com - Make your home your butler!) #1

On popular request request here is a device handler that can make your keypad work like a lock device in SmartThings so it can work with SmartApps designed for managing locks and user codes (while maintaining compatibility with existing keypad SmartApps).

This Device Handler is compatible with most ZigBee keypads like the Centralite, UEI, Xfinity and Lowes Iris keypads.

The IRIS keypad can be bought from Lowes or from Amazon for about $40

The Centralite keypad can be bought from Amazon or from eBay for about $45

The UEI keypad can be bought from eBay for about $15

The Xfinity keypad(s) can be purchased from Comcast Home Security or from eBay (3400-X and XHK1) for about $10 to $20

Centralite Iris

This device handler supports the following features:

  1. Work as a keypad lock in SmartThings
    • Set/use 4 digit codes
    • Enable/disable keypad
    • Enable/disable auto lock
    • Lock and unlock using user codes
    • Invalid code notifications
  2. Ability to arm/disarm SHM directly from supported keypads
  3. Read the following sensors
    • Temperature (auto convert to F or C depending upon your location)
    • Motion
    • Battery (new battery calibration algorithm)
    • Tamper
  4. Use as a Tone capability device
  5. Locate keypad using a beep
  6. Ability to configure the following parameters:
    • Auto lock delay
    • Number of beeps (for beep command)
    • Temperature offset (for correcting the temperature reported by the sensor)
    • Ability to configure the Inactivity timeout (the number of minutes since the last motion was detected after which the motion sensor sends a no motion detected event)
  7. Compatible with legacy SmartApps designed for direct keypad integration
  8. Compatible with SmartLocks and lock/code management apps like Door Lock Code User Management and Rental Lock Automater
  9. Use with Lock & Door Synchronizer to control Garage Doors, Patio Doors and synchronize with other locks/devices

Supported apps like Rental Lock Automater, Door Lock Code User Management and CoRE/WebCORE can allow the keypad to arm/disarm SHM directly:

  • Door Lock Code User Management and Rental Lock Automater -> Enable the option for Control smart home monitor using keypad under the Lock/Unlock actions.
  • CoRE/WebCoRE -> Use the parameter armMode in the data field of the “lock” event while creating a custom action. The reported values are:
    • 0 for Disarm
    • 1 for Armed Stay
    • 2 for Armed Night
    • 3 for Armed Away
  • CentraliteS UEI%20CodeCentralite/UEI/Xfinity keypad (assuming the user code has been programmed):
    • to arm SHM press one of the 3 modes buttons on top followed by a valid 4 digit user code
    • to disarm SHM enter a valid 4 digit user code
  • IrisS IRIS keypad (assuming the user code has been programmed already):
    • to arm SHM enter a valid 4 digit user code followed by the Partial button (Armed Stay) or the On button (Armed Away)
    • to disarm SHM enter a valid 4 digit user code, press the OFF button
  • When SHM is armed via the keypad, the LED light on top will glow red and the appropriate mode button will light up (if present)
  • When SHM is disarmed via the keypad, the LED light will be green


Low Battery: If your battery below 20% consider replacing it. The unit will start flashing a red light when the battery level is low.

More features to added, if you have any suggestions or ideas please feel free to ask and we’ll try to add it.


It is recommended to install the Device Handler BEFORE paring the device for easier setup.

  1. Remove the batteries from the device
  2. Open the SmartThings mobile app and click on + or Add a thing to put the hub into pairing mode
  3. Make sure you’ve inserted the covering piece at the back of the device so that pairing button is pressed

Centralite/Xfinity 3400-X Models

  1. Insert one battery into the device (use CR123A Lithium batteries)
  2. It should complete pairing within 30 seconds and it should show up on your SmartThing mobile device
  3. The device wifi/signal LED should be flashing green
  4. Insert the second battery and the wifi/signal LED should stop flashing (you can leave the covering piece inserted)


UEI/Xfinity XHK1 Models

  1. Insert the 4 batteries (use AA Lithium 1.5v batteries for best performance, Alkaline AA batteries will have a shorter life, do NOT use rechargeable NiMH/NiCD/etc batteries as the voltage is too low for reliable operation)
  2. The Pairing LED light should start flashing (indicating it’s in pairing mode). If the light is not flashing, follow the Exclusion Instruction below to get it back into pairing mode
  3. The device wifi/signal LED should be flashing green
  4. On successful pairing the pairing LED should flashing and the the wifi/signal LED should be lit


EXCLUSION INSTRUCTIONS: Click on the gear icon (top right corner) in your SmartThings mobile phone device page. Scroll down to the bottom and click Remove and follow instructions.

  • If the exclusion was not successful (which can happen if the device did not receive the exclusion notification from the hub, when not paired the wifi/signal LED will not be lit), remove the cover and the batteries, keep the tamper/pairing button pressed while inserting the batteries and then release the tamper/pairing button. For the XHK1 models it should make the pairing LED start flashing

This device type handler is available on the RBoy Apps Server, http://www.rboyapps.com. Refer to our website or facebook page below to get access to the server.

Visit our Facebook page for updates on new apps and to get access to our Premium Apps. http://www.facebook.com/RBoySTApps

[RELEASE] Rental Lock Automater - Automate user codes with AirBnB, HomeAway and VRBO
[RELEASE] Door lock code/lock user management (create, delete and schedule codes) with automatic lock/unlock, custom user actions and SHM integration
[RELEASE] Rental Lock Automater - Automate user codes with AirBnB, HomeAway and VRBO
Door open sensor --> Chime/Speaker in office setting?
Xfinity 2nd generation keypad help
[RELEASE] Lock and Door Synchronizer, synchronize your locks with other locks, doors, switches/relays
FAQ: Can I add a keypad to control my garage door?
Xfinity 2nd generation keypad help
POPP - Z-Wave Plus KeyPad? Other U.K. Keypad Options?
(MacTechGenius) #2

Is this a device handler or a smart app?

So it works with Lock Manager but does it work with [RELEASE] Keypad Coordinator - Bring out the power of your Keypads

(www.rboyapps.com - Make your home your butler!) #3

It’s a device handler and it works with all the legacy/older SmartApps that relied on the custom keypad DTH (see first post).

It has added new capabilities to allow it to work the SmartApps that use “lock” capabilities like Lock Code User Management, lock manager and SmartLocks.

(Tim) #4

What are the main differences or advantages from this one?

Does it work with ArnB’s Delay and Xfinity 3400?

Thank you!

(www.rboyapps.com - Make your home your butler!) #5

This DTH retains compatibility with the older DTH so works with the Apps you’ve mentioned (on request from users, see below)

We’ve added new capabilities of locks and user programming so that it can be used with SmartApps that are designed to work with locks.

So you can use it with the SmartApps you’ve mentioned and the newer Lock/User management SmartApps (at the same time).

Yes it’s compatible with the Xfinity 3400 (see the screenshots) and the IRIS 2405, we’re working on adding more keypads models to it. If you have any requests for specific models please send them in.

(Joel W) #6

I have a problem, I replaced the standard Centralight DTH with yours and the status says unknown. Did I miss something? Is that because I have no door locks? If so it would be nice if it could be removed if no lock present.

(www.rboyapps.com - Make your home your butler!) #7

That’s the “lock” status, since it’s never been used as yet it’s showing “unknown”, just tap on it and it’ll initialize itself.
Not sure what you mean by remove since this is a lock DTH so it will show the “current” status of the last action taken (locked or unlocked)

EDIT: We have a new app coming out shortly that will complement this DTH and would probably address your question for the use of the lock

(Jeremiah Goode) #8

I have the device handler installed and am using your “Door lock code user management with notifications and automatic relock, Lock User Management v07.01.00” and am having an issue.

I have configured the lock “Xfinity 3400-X keypad” lock\unlock actions to the following:

Keypad Unlock Actions: Run a routine, Change mode to Home and Disarm Smart Home Monitor
Keypad Lock Actions: Run a routine, Change mode to Away and Arm Smart Home Monitor to Away
Manual Unlock Actions: Run routine, Change mode to Home and Disarm Smart Home Monitor
Manual Lock Actions: Run a routine, Change mode to Night and Arm Smart Home Monitor to Home

I hit one of the three button on the top of the Xfinity keypad and enter my code. It beeps to confirm and doesn’t change the SHM mode, the mode stays on Disarmed. If I manually change the mode to Armed(away) or Armed(stay) and push any of the three buttons on the top of the Xfinity keypad and enter my code, the SHM mode changes to Disarmed. If I just put in my code w/out pressing any of the three buttons on the top of the Xfinity keypad it also changes the SHM mode to Disarmed if in any other SHM mode besides Disarmed.

I’m not sure what I am doing wrong, is there something wrong w/ my setup?


(www.rboyapps.com - Make your home your butler!) #9

Update to the latest version 07.05.01, it adds support for the keypad locks - you should also see a new option to directly arm/disarm SHM from the keypads.

(Jeremiah Goode) #10

Ok I’ve updated to 07.05.01. I did see a new option under lock/unlock actions for the xfinity keypad unlock actions that now says “control smart home monitor using keypad” instead of what it used to say and still says under Manual Unlock Actions “Disarm Smart Home Monitor” but I haven’t found the new option to directly arm/disarm SHM from the keypads.

Where is that option? I’m still not able to arm w/ the new version. I can disarm but can’t arm stay or away.


(www.rboyapps.com - Make your home your butler!) #11

This is it

EDIT: And I verified it’s working fine with both locks and keypads.

(www.rboyapps.com - Make your home your butler!) #12

On popular request:

Enhanced ZigBee Keypad Lock - Version 01.01.00

  • Added support for UEI and Xfinity XHK1-UE keypads
  • Updated DTH to support latest ST ZigBee framework

This is a low cost keypad and can be purchased on eBay for about $10 to $20. See first post for pairing instructions.

(Jeremiah Goode) #13

under “Keypad Unlock Actions” the setting for “Control Smart Home Monitor using keypad” is enabled, it will disarm the SHM but I can’t for the life of me figure out how to get it to Arm (away or stay) the SHM.

is there a step by step walk through manual that I can follow to ensure I have the proper things setup?

I chose the option to “Seperate actions for each door” and then configured the keypad and manual lock and unlock actions but it just won’t work.


(www.rboyapps.com - Make your home your butler!) #14

You’ve done it, that’s it (see the first post for step by step).

I tested it here with the Xfinity keypad, IRIS, UEI and Centralite and it’s working fine with all of them. I suspect something else may be going on with your account. Best way to check, open IDE Live Logging, Tap the Away button on your keypad, enter your 4 digit code and look at the logs. The SmartApp should send say sending an arm away signal to ST. Then look into your SHM logs to see what may be going on.

This is what you’ll see in your logs

8:54:34 PM: trace No individual routine configured to run when locked via keypad for Iris 3405-L Keypad
8:54:34 PM: trace Did not find per user lock actions, falling back to global lock actions
8:54:34 PM: info Arming Smart Home Monitor to Away
8:54:34 PM: trace No user Test specific lock action found, falling back to global actions
8:54:34 PM: trace Lock event name lock, value locked, device Iris 3405-L Keypad, description Locked by “Test”, data {“usedCode”:“1”,“codeName”:“Test”,“method”:“keypad”,“armMode”:“armedAway”,“microDeviceTile”:{“type”:“standard”,“icon”:“st.locks.lock.locked”,“backgroundColor”:"#00a0dc"}}
8:54:34 PM: trace Iris 3405-L Keypad locked by user 1 via keypad

It’s possible that your actions/routines are interfering with your SHM, turn off all actions and turn them back on one by one until you see which one is interfering.

(www.rboyapps.com - Make your home your butler!) #15

In addition to the above, on the first page of the SmartApp, scroll down to the bottom and under advanced settings and enable Detailed notifications, now it’ll send you a notification for actions it’s taking (arming/disarming, running routines etc). That will tell you if the SmartApp is sending the signal to arm SHM.


I’m experiencing the exact same issue using a Centralite 3400-x. Disarm works as expected, however, I can’t arm SHM no matter my settings.

(www.rboyapps.com - Make your home your butler!) #17

Did you try this and look at your IDE logs?

(Jeremiah Goode) #18

My issue was that I had specific actions defined for locks per user. I was trying to setup the General Settings\Lock/unlock actions and the user\custom actions/notifications settings appear to conflict. I removed the General Settings\Lock/unlock actions and defined the user\custom actions/notification settings actions and it is working good now.

The only minor issue I have now is that when I ARM(AWAY) or ARM(STAY) using my phone app (I have the rules setup to lock the Xfinity) the keypad doesn’t turn red like when it is armed from the keypad itself. I’m not sure if that can be fixed or not, if so that would be awesome. Right now we are putting in our code everytime we can to leave the house to disarm as we don’t know the SHM state w/out looking at our phones.

(www.rboyapps.com - Make your home your butler!) #19

Glad you figured it out. User actions take precedence over general actions when defined.
You can define the direct keypad arming/disarming also in the user specific actions so that some users can arm using the keypad while other can only lock/unlock.

This is by design, in this instance the keypad is being used as standalone lock device and not a general security keypad. The purpose of the light is to show the status of the lock device (locked or unlocked). So when you lock it via the keypad it turns red and when unlocked it’s green/white (depending on the keypad model).

(Jeremiah Goode) #20

so if you lock the keypad from the keypad it turns red, but if you lock the keypad from the smartthings app it doesn’t, right? what’s the difference? The keypad is locked, knows its locked, but only turns red if you do it from the keypad. So it doesn’t seem to have anything to do w/ your smartapp, has something to do w/ the device itself? Or the device handler?