Skip to main content

Smart buttons and scene controllers trigger automations with physical button presses. This guide covers general troubleshooting.

Button Press Not Detected

When presses aren't registered:

  • Battery: Replace battery - most use CR2032 or CR2450
  • Range: Move closer to hub or add repeaters
  • Pairing: Re-pair button to hub
  • Hub online: Verify hub is connected
  • Wake up: Battery devices may need wake-up press

Understanding Press Types

Different actions available:

  • Single press: Quick tap and release
  • Double press: Two quick taps
  • Long press: Press and hold
  • Triple press: Some support triple tap
  • Release: Some detect button release event

Zigbee Buttons

For Zigbee scene controllers:

  • Binding: Can bind directly to lights for instant control
  • Groups: Bind to Zigbee groups for multi-device control
  • Events: Button presses generate events for automations
  • Battery life: Zigbee buttons typically last 1-2 years

Z-Wave Buttons

For Z-Wave scene controllers:

  • Central scene: Uses central scene command class
  • Associations: Direct association for instant response
  • Wake up: Configure wake-up interval for battery life
  • Secure pairing: S2 security for encrypted commands

Setting Up Automations

Configuring button actions:

  • Hub automations: Create in hub's app or interface
  • Home Assistant: Use device triggers in automations
  • Scenes: Trigger predefined scenes
  • Multiple actions: One button can do different things based on press type

Troubleshooting Tips

General fixes:

  • Re-pair: Remove and re-add to hub
  • Check automation: Verify automation is enabled and configured
  • Logs: Check hub logs for button events
  • Test event: Test button generates event in hub