WallMote now has generic compatibility with SmartThings hub, there is no more need to further install a custom device handler. This page will provide the alternative device handler, as well as steps to using WallMote with SmartApp button controller, or Group Association via Z-Wave Twe

Notes - Methods you can use to control other Z-Wave Switches or Dimmers using WallMote.

  • Button Control
  • WebCoRE
  • Other scene based Smart App type applications.
  • Group Association (direct control without SmartThings)

SmartThings Generic Device Handler.

SmartThings already has a compatible device handler to WallMote natively, so there is no need to further add a custom device handler for this device.

If you see any issues with control, try using the alternative device handler by Erocm123.

Alternative device handler WallMote Device Handler

https://github.com/erocm123/SmartThingsPublic/blob/master/devicetypes/erocm123/aeon-wallmote.src/aeon-wallmote.groovy (by Erocm1231)


Follow the steps below:

  1. Login to Web IDE (login here: https://graph.api.smartthings.com/)
  2. Click on "My Location" tab, then select your gateway.
  3. Click on the "My Device Handlers" link on the top menu 
  4. Create a new Device Handler by clicking on "New Device Handler" button in the upper-right corner. (Green button)
  5. Click on "From Code."
  6. Copy Erocm1231 code from Github (https://github.com/erocm123/SmartThingsPublic/blob/master/devicetypes/erocm123/aeon-wallmote.src/aeon-wallmote.groovy), and paste it into the code section.
  7. Click on "Save", then wait for the spinning wheel to stop.
  8. Click on "Publish" -> "Publish for me"
  9. Install it on your WallMote by going to "My Devices" page in the IDE
  10. Find your WallMote.
  11. Go to the bottom of the page for the current WallMote and click on "Edit."
  12. Find the "Type" field and select your device handler. (should be located at the bottom of the list as Aeon WallMote).
  13. Click on "Update"
  14. Save Changes

NOTES: Before moving onto Button Controller SmartApp or Group Association use, make sure that you install the device handler above.

Button Controller (Central Scene Use)

The easiest way to get started to use WallMote with SmartThings is to install the Button Controller SmartApp developed and designed by SmartThings development team.  To get install Button Controller, follow the steps below:

  1. Open SmartThings App from your Smart Phone.
  2. At the bottom click on "Automation"
  3. Near the top, select "SmartApps"
  4. Click on "+ Add a SmartApp"
  5. Scroll to the bottom of the list, and select "+ More"
  6. Click on "Button Controller" located on the top of the list.

Now you get to program Button Controller with the device desired. There are 2 separate parts, (1) first determining which button device to use, in this case you'd set the WallMote for this, (2) Programming what each button does when you tap or press and hold them which a bunch of provided options will be available to you here.

When programming each button, you will be setting up each button individually up to 4 buttons, every time you click on Next at the top right, it will move on to allow you to program the next upcoming buttons.

(1) Button 1 = Left button.

(2) Button 2 = Right button.

Here are some general steps to get started (continuing from the steps above):

  1. Tap on "Button - Tap to set"
  2. Select your WallMote (or your desired button controller).
  3. Now at the top right, click on "Next"
  4. You will now be taken to program Button #1 (top left button), scroll up and down and decide what you want to control.
  5. Click on "Next" at the top right corner"
  6. This will continue onto programming Button #2.
  7. Keep Following Steps 4 and 5 for each button control that you want to program.
  8. When you are done, and you have no need to program more buttons, just keep pressing next until the top right says "Save"
  9. Click on "Save" to finish.

Group Association

Notes - Using the below device handler, you have a few options for control using the below SmartApps:

  • Direct control of Z-Wave devices
  • Bypass SmartThings hub

The Device Handler option above provides you a method to bypass SmartThings and allow you to directly control your Z-Wave Switches and Dimmers.

The steps to install Z-Wave Tweaker (You only need to do this once, if already installed, skip this section):

  1. Login to your SmartThings IDE
  2. Click on Locations and then select your gateway
  3. Select "My Device Handlers" then click on "Add new Device Handler"
  4. Select "From Code"
  5. Go into the Z-Wave Tweaker Code, and copy all of the code from line 0 to the very last line. (can be found here directly: https://github.com/codersaur/SmartThings/blob/master/devices/zwave-tweaker/zwave-tweaker.groovy)
  6. PRO TIP - Click on the "Raw" button which exposes only code, then ctrl + a (highlight all), then ctrl + c (copy highlighted).
  7. Paste this into your SmartThings IDE.
  8. Save the code.
  9. Then click on Publish -> "Publish for me"

Now install Z-Wave Tweaker over WallMote:

  1. Click on "My Devices"
  2. Look for your WallMote and click on it
  3. Scroll to the bottom then click "Edit"
  4. Find "Type" and bring out the drop down menu
  5. First make note of the original device handler that you were using (you will need to revert back to the original device handler later)
  6. Find "Z-Wave Tweaker" and select it
  7. click on Save

Using Z-Wave Tweaker to Set a GROUP ASSOCATION


  1. Go into your SmartThings App over your Smartphone
  2. Find the WallMote and open up its page, you'll notice that everything is incredibly different. Please make note of the GREEN "Sync" symbol at the bottom.
  3. On the top right, click on the GEAR icon
  4. Scroll down and look for the "CONFIGURE ASSOCIATION GROUP" section, there are multiple parts in this section (Association Group ID, Association Group Members, Command Class)
  5. On "Association Group ID" set this to the group ID you want to program

    For step 5 on setting Association Group ID, this is the grid list of what can be set over WallMote:

    Group Association #
    Button #
    Press Function
    Toggle On/Off
    1 (Left)
    Dim up/down
    1 (Left)
    Press and Hold / Swipe up / Swipe Down
    Toggle On/Off
    2 (Right)
    Dim up/down
    2 (Right)
    Press and Hold / Swipe up / Swipe Down

  6. On "Association Group Members" set this to the Device Network ID (which can be found under SmartThings IDE -> My Devices)

    Image below is where you can find the Device Network ID (under SmartThings IDE):

    Input into SmartThings App (in belows example, we want to control backyard lights which has Device Network Id of 15 with button 1 and allow us to dim using Group #3):

  7. On "Command Class" set this to "Auto-detect"
  8. Now click on "Done" located on the top right.
  9. From step 2 you made note of the GREEN "Sync" symbol, if the color is ORANGE "Unsynced" then you will need to wait for this to change to GREEN "Sync" before moving onto the next section.
  10. Your WallMote is a battery device, Wake up the battery device now to take in the new changes. To do this, press and hold the Action Button located on the back of WallMote until the WallMote beeps its alarm and turns yellow, then release the Action Button. (The Yellow LED should be flashing rapidly during this time).
  11. If you see GREEN "Sync" at the bottom of the device page, you are now done with this section.
  12. Tap the Action Button of WallMote to bring WallMote out of its awake state, and its yellow LED should stop flashing.

Now install the original device handler over WallMote:

  1. Click on "My Devices"
  2. Look for your WallMote and click on it
  3. Scroll to the bottom then click "Edit"
  4. Find "Type" and bring out the drop down menu
  5. Find the original device handler and select it
  6. click on Save