Xiaomi Aqara switch: how to connect to the network and the smart home system

Xiaomi Aqara smart switches have become one of the most popular lighting automation solutions in the Mi Home ecosystem, allowing you to control light from your smartphone, voice through Alice or Google Assistant, and integrate into complex smart home scenarios. However, many users face difficulties already at the connection stage: improper wire connection can cause a device to fail, and errors in settings lead to unstable operation.

In this article, we will discuss all the stages of connection - from the choice of the switch model (Aqara). D1, H1, Opple) before setting up in the Mi Home app and alternative systems like Home Assistant, you’ll learn how to avoid typical installation errors, which wires to plug in (even if you don’t have experience with electrical work), and how to solve Wi-Fi or Aqara Hub gateway problems. Particular attention will be paid to compatibility with two-key switches and features of work without a neutral wire - this is a frequent headache when installing.

1. Choosing the Aqara switch model: which one is right for you?

Before buying it is important to decide on the model, because it depends on the capabilities of the device and the complexity of installation.

• 🔹 Aqara D1 (WL-S1) — single-key switch with neutral wire, supports Zigbee 3.0. Perfect for beginners thanks to simple installation.
• 🔹 Aqara H1 (ZNCLDJ12LM) — Two-key model without neutral, requires the Aqara Hub gateway M2 or M3. Suitable for replacing standard switches in homes with old wiring.
• 🔹 Aqara Opple is a series of stylish switches (1-3 keys) with Zigbee support and the ability to control through the application. Compatible with Mi Home and Home Assistant.
• 🔹 Aqara T1 (ZNCLDJ11LM) — single-key version without neutral, works only with the Aqara gateway.

The key to choosing is that you have a neutral wire in your electrical wiring, and if you don't have one (which is typical of Soviet-built homes), look at the models. H1 or T1. They use No Neutral technology but require a mandatory connection to the Aqara gateway for power.

⚠️ Note: Models without neutralization (H1, T1) They won't work without the Aqara Hub gateway. If you don't have one, go for the Aqara. D1 Opple with support for neutral wire.

Preparation for installation: tools and safety

Before you start mounting, make sure you have everything you need. Electricity requires caution -- if you're not sure about yourself, you'd better get an electrician.

• 🔧 Tools:
• 📋 Materials:

Pay special attention to the power outage. Turn off the switchboard, which is responsible for the lighting line. Don't limit yourself to the switch on the wall, it can only open phase, and zero will remain energized!

⚠️ Attention: If you have aluminum wiring in your home, use terminal pads to connect to the copper circuit breaker wires. Direct twisting of aluminum and copper leads to oxidation and overheating.

💡

If you're not sure which wire is phased and which is zero, use a tester: touch the wires with probes when the machine is on. ~220B, zero - 0B.

3. Connection schemes: step-by-step instructions

The circuitry depends on the switch model and the type of wiring. Let's look at two of the most common cases: a connection with a neutral wire (Aqara). D1) and without him (Aqara) H1).

3.1. Connecting Aqara D1 (neutral)

This model requires a neutral wire (N) in the distribution box.

1. Phase (L) – connects to the terminal L on the switch.
2. Neutral (N) - to the terminal N.
3. The load (L1) — The wire that goes to the lamp is connected to the terminal. L1.

Example of wiring:

Electric shield




│




├── Phase (L) → Clem L on the switch




├── Neutral (N) → Clem N on the switch




└── Earth (PE) → Not connected to a switch




│




Aqara D1 switch




│




└── Clemma L1 → Lamp

3.2. Aqara connection H1 (neutral)

Non-neutral models (H1, T1) They're powered through the Aqara Hub gateway and they use the power phase:

1. Phase (L) – connects to the terminal L.
2. The load (L1/L2) — wires to lamps are connected to terminals L1 and L2 (two-key).

Important: Aqara Hub gateway must be connected to the network and be within range of Zigbee (up to 10-15 meters indoors).

💡

Non-neutral switches (Aqara) H1/T1) They cannot operate autonomously – they depend on the Aqara Hub gateway for power and control.

4.Setting up in the Mi Home app

After installation, the switch must be added to the smart home system, using the official Mi Home app (or Aqara Home if you prefer proprietary software).

1. Step 1. Install the Mi Home app from the App Store or Google Play and log in.
2. Step 2. Go to the Devices section → Add the device.
3. Step. 3. Choose the category of Smart Home → Switches and find your model (Aqara) D1/H1/Opple).
4. Step 4: Follow the instructions on the screen: turn the switch on (press and hold the 5-second button until the indicator flashes) and wait for the connection.
5. Step 5: Once you have successfully added, assign the device to the room and set the name (e.g., “Light in the room”).

If the switch is not located, check:

• 🔹 Distance to Aqara Hub lock (must be no more than 10 meters).
• 🔹 Internet access on the phone and gateway.
• 🔹 Correct connection of wires (phase must be applied to the switch).

💡

If the switch doesn’t connect, try resetting it to factory settings: press and hold the 10 second button until the indicator blinks quickly.

5. Integration with Home Assistant and other systems

If you use alternative smart home platforms, such as Home Assistant, you can connect the Aqara switch via Zigbee.

• 🔹 Zigbee Coordinator (Songoff Zigbee 3.0) USB Dongle Plus or ConBee II).
• 🔹 Installed Home Assistant with Integration ZHA (Zigbee Home Automation).

Instructions for Home Assistant:

1. Connect Zigbee-dongle to a server (such as a Raspberry Pi).
2. In Home Assistant, go to Settings → Devices and services → Add Integration and Choose ZHA.
3. Follow the setup wizard by selecting your Zigbee adapter.
4. Click Add Device and activate the pairing mode on the switch (hold the 5 seconds button).

Once added, the device will appear in the entity list, so you can control it through the Home Assistant interface or create automations, such as:

automation:




- alias: "Switch on the lights on the motion"




trigger:




- platform: state




entity_id: binary_sensor.motion_sensor_living_room




to: "on"




action:




- service: switch.turn_on




entity_id: switch.aqara_switch_living_room

Typical errors and their solution

Even with the right connection, users often face problems.

Pay special attention to the problem of blinking LED-Cheap LED lights can light up or blink even when they're off because of current flowing through the circuits of the switch:

• 🔹 Install a condenser parallel to the lamp 0.22 μf/400V.
• 🔹 Replace the lamp with a high-quality model (e.g., Philips Hue or Xiaomi Yeelight).
• 🔹 Use the cutoff relays to completely break the chain.

⚠️ Note: If the Aqara switch is H1/T1 You've stopped responding to the presses, but the light is on, try reconnecting it to the gateway.

7. Voice control and automation

One of the main advantages of smart switches is the ability to control voice. Aqara is compatible with:

• 🔹 Alice (Yandex) – through integration with Mi Home.
• 🔹 Google Assistant – Requires you to connect Mi Home to your Google account.
• 🔹 Apple HomeKit – Home Assistant with HomeKit Bridge.

An example of setting up for Alice:

1. Open the Yandex app and go to Devices → Add the device.
2. Select Xiaomi Mi Home and sign in.
3. After syncing, tell Alice, “turn on the light in the hall” (the name should match the device name in Mi Home).

To create automation in Mi Home:

1. Go to the Automation section → Create.
2. Select a condition (e.g. Time or Motion Sensor).
3. Add Action: Device Management → Aqara switch → Turn on.

💡

For stable voice control, make sure that the Aqara Hub gateway and switch are on the same Wi-Fi network as the phone.

FAQ: Frequent questions about Aqara switches