Aqara wall switches and wireless buttons use Zigbee for reliable smart home control. This guide covers common issues.
Switch Won't Pair
Pairing issues:
- Aqara Hub: Need Aqara Hub M1S, M2, or M3 for pairing
- Pairing mode: Hold button until LED blinks
- Close to hub: Pair within 2 meters of hub
- Zigbee channel: Hub sets channel - ensure compatibility
- Third-party hubs: Works with ZHA, Zigbee2MQTT, SmartThings
No Neutral vs With Neutral
Understanding wiring requirements:
- H1 No Neutral: Works without neutral wire but has limitations
- H1 With Neutral: Better performance, requires neutral
- Minimum load: No-neutral needs 3W minimum LED load
- Bypass: May need bypass for low-wattage loads
Wireless Button Issues
For Aqara wireless switches:
- Battery: Replace CR2032 battery
- Press types: Single, double, long press, shake (Cube)
- Automations: Set up actions in Aqara or hub app
- Range: Keep within Zigbee mesh range
Opple Remote
For Aqara Opple 6-button:
- 6 buttons: Each button has single, double, hold press
- Scenes: Configure scenes for each button action
- Pairing: Hold all buttons until LED flashes
- Battery: CR2450 battery
Cube Controller
For Aqara Cube T1 Pro:
- Gestures: Shake, rotate, flip, slide, tap
- Scenes: Each gesture triggers different scene
- Pairing: Shake vigorously to enter pairing mode
- Sensitivity: Adjust in app if not detecting gestures
HomeKit Integration
Using with Apple Home:
- Aqara Hub: Hub bridges to HomeKit
- Scenes: Button presses trigger HomeKit scenes
- Switches: Appear as switches in Home app
- Automations: Full HomeKit automation support