Xiaomi Mi Wireless Switch: the principle of operation, configuration and hidden functions

Xiaomi Mi Wireless Switch is one of the most versatile devices in the Xiaomi smart home ecosystem. This compact gadget allows you to control lighting, appliances and automation scenarios without wires and complex installation. But how exactly does it work? Why do some users praise it for reliability, while others face delays?

In this article, we will discuss the physical principle of the switch, its interaction with the Mi Home Gateway hub, as well as the nuances of settings through the application. We will pay special attention to hidden features that are not written in the official instructions – for example, how to use the device to control not only Yeelight lamps, but also any smart sockets through scripts. IFTTT.

If you are just planning a purchase or have already faced problems (for example, the switch does not respond to clicks or falls off the network), here you will find unique solutions, proven in practice - from resetting settings to alternative firmware for advanced users.

1. Device and specifications

Xiaomi Mi Wireless Switch (model) WXKG01LM or WXKG03LM For the neutral wire version, it's a wireless relay that runs on ZigBee protocol. Unlike the classic switches, it doesn't need a constant power supply: it's powered by kinetic energy when you press a button.

Inside the hull are hidden:

  • πŸ”‹ Capacitor – accumulates energy from pressing to send a signal.
  • πŸ“‘ ZigBee module (CC2530 or CC2652) β€” provides communication with the hub at a frequency of 2.4 GHz.
  • πŸ”Œ Connection plugs - in the version WXKG03LM there are contacts for phase and neutrals (for working with backlighting).

Key parameters of the device:

CharacteristicsMeaning
Protocol of communicationZigBee 3.0 (compatible with Mi Home, Aqara, Home Assistant)
Range of actionUp to 30 m indoors (depending on obstacles)
Type of installationInvoice (included in standard rosette)
Maximum loadingUp to 800 W for model WXKG03LM)
Temperature rangeFrom -10Β°C +40Β°C

Important: model WXKG01LM It doesn't require a neutral wire, but it's only suitable for controlling lamps. WXKG03LM universal - it can include even fans or pumps, but it is necessary to have an N-wire in the electrical wiring.

πŸ“Š What hub do you use with Xiaomi Mi Wireless Switch?
Mi Home Gateway 3
Aqara Hub M2
Home Assistant with ZigBee-dongle
Other

2.The principle of operation: how the signal is converted into a command

The algorithm of the switch can be divided into 4 stages:

  1. Mechanical pressing – the user presses the button, the spring mechanism is triggered.
  2. Energy generation – A kinetic element converts movement into an electrical impulse (up to 3 V).
  3. Signal generation – The microcontroller encodes the command (on/off/switch).
  4. Transmission via ZigBee – the signal is sent to the hub, which already controls the actuator (lamp, socket).

The Mi Wireless Switch is not battery-free, which is a plus (no need to change the power), but also a minus: if the press is too weak, the energy may not be enough to send a signal, in which case double pressing or replacing the spring mechanism (when disassembling the device) helps.

The response rate depends on:

  • πŸ“Ά Quality of communication between the switch and the hub (the more walls – the worse).
  • πŸ–₯️ The load of the hub (if connected to it) >30 devices, possible delays).
  • ⚑ Type of controlled device (Yeelight lamp will react faster than a smart outlet from a third-party brand).

πŸ’‘

If the switch works again, try placing the hub closer or adding a ZigBee repeater (such as an Aqara smart lamp) to the network.

3. Connection to the Mi Home system: step-by-step instructions

To work Mi Wireless Switch must have a ZigBee-hub (fit Mi Home Gateway 3, Aqara Hub or Sonoff ZigBee Bridge).

  1. Open the Mi Home app and go to Devices β†’ Add the device.
  2. Select the category "SwitchesΒ» β†’ Β«Wireless switchΒ».
  3. Press and hold the switch button for 5 seconds until the indicator blinks.
  4. Wait for the notification in the app for a successful addition.

Once connected, the device will appear in the list, but you need to tie it to a specific scenario.

  • πŸ”§ Go to Automation. β†’ Create a script.
  • πŸ“± Select the β€œPush the button” trigger and specify your switch.
  • ⚑ Set an action (for example, turn on the Yeelight lamp or the Mi Smart Plug socket).

Make sure the hub is connected to Wi-Fi|Update the hub firmware in Mi Home|Check that the switch is within a 5m radius of the hub|Turn it off. VPN on your phone (can block communication with Xiaomi servers)-->

⚠️

Warning: If the switch is not added, try resetting it to factory settings. To do this, press and hold the 10 second button until the indicator blinks 3 times red. After reset, repeat the connection procedure.

Use cases: from basic control to complex automation

The basic function of the Mi Wireless Switch is to turn the lights on/off, but with scripts in the Mi Home or Home Assistant, you can accomplish more complex tasks:

Example 1: Managing multiple devices with a single button

  • πŸ’‘ One tap - turns on the lamp in the living room.
  • πŸ”„ Double pressing - turns on the lamp + fan-outlet.
  • 🚫 Long pressing turns everything off.

Example 2: Integration with sensors

Connect the switch to the Aqara motion sensor:

  • 🚢 If the sensor detects movement, the lights are turned on automatically.
  • ⏱️ After 5 minutes without activity, the lights go off.
  • πŸ”˜ The switch serves as a manual switch in case of false positives.

Example 3: A smart alarm clock

Set up a scenario where:

  • ⏰ At 7:00 the lamp is turned on at 30% brightness.
  • β˜• In 10 minutes, a socket with a coffee maker.
  • πŸ›οΈ Clicking the switch turns everything off and triggers "Leave Home" modesΒ».
How to connect with Google Assistant or Alice?
To control voice, you need: 1. Connect Mi Home to Google Home or Yandex.Stations through official integration. 2. Create a virtual device in Home Assistant (if you use it), which will duplicate the switch commands. 3. Set up routines in the voice assistant, where the trigger is a command like β€œAlice, turn on the light in the living room”, and the action is to activate the script in Mi Home.

5. Common Problems and Their Solutions

Even a device that's so simple can fail, and let's look at the typical cases and the ways to fix them.

Problem.Possible causeDecision
The switch doesn't respond to the pressing.The condenser or weak contact is dischargedTake the device apart and check the spring. Try pressing harder.
Delayed response >2 secondsWeak ZigBee signal or overloaded hubAdd a repeater (like an Aqara lamp) or restart the hub.
The switch spontaneously triggers.Interference from other ZigBee devicesChange the ZigBee channel in the hub settings (optimally 11, 15 or 20).
Not added to Mi HomeOutdated firmware of the hub or deviceUpdate the Hub Software through Settings β†’ Update.

⚠️

Note: If after updating the firmware hub switch stopped working, try to roll back to the previous version of the software. To do this, in Mi Home go to the Hub Settings β†’ Update β†’ Back to the factory. This only works for the 2nd and 3rd hubs.

For advanced users: if standard methods do not help, you can flash the switch with alternative software (for example, Tasmota or other software). ZigBee2MQTT). This will open access to advanced settings, but will deprive you of guarantees.

πŸ’‘

90% of Mi Wireless Switch problems are solved by reconnecting to the hub or changing the ZigBee channel, and only 10% of them require repair or firmware.

6. Comparison with analogues: which is better to choose

Xiaomi Mi Wireless Switch is not the only wireless switch on the market.

ModelProtocolPlusesCons
Xiaomi Mi Wireless SwitchZigBeeNo battery, compact, cheap.Requires hub, no feedback
Aqara Wireless SwitchZigBeeSupports double/triple pressing, there is a backlit versionMore expensive than Xiaomi 30-40%
Sonoff SNZB-01ZigBeeWorks with Home Assistant without the cloudI need a battery. CR2032
Shelly Button1Wi-Fi/BluetoothNo need for a hub, works directlyA large ping, depends on Wi-Fi

The choice depends on your ecosystem:

  • 🏠 If you already have Mi Home Gateway, Xiaomi Mi Wireless Switch is the best option.
  • πŸ”§ For advanced automation, Aqara or Sonoff (compatible with Home Assistant) are better).
  • 🌐 If you don’t want to depend on the hub, Shelly. Button1 (But be prepared for delays).

7. Disassembly and modifications for experienced users

If you're willing to lose the warranty, disassembling the switch opens up opportunities for upgrades.

  • πŸ”§ Replace the spring with a stiffer one (if the presses do not work).
  • πŸ”‹ Add an external capacitor for reliability (soldier to points) C1 and C2 board-board).
  • πŸ“‘ Sending custom software (for example, ZigBee2MQTT Work without the cloud Xiaomi).

You'll need firmware.

  1. CC Debugger (programmer for ZigBee chips).
  2. Dad-mama wires to connect to the board.
  3. Firmware file (download from GitHub).

⚠️

Attention: If the firmware is not properly developed, the device can turn into a brick. Before you start, back up the original firmware with the command: python cc_tool.py -p /dev/ttyUSB0 -b 115200 -r

After the switch is installed, the switch can be controlled through MQTT, Integrate with Node-RED or even use it in OpenHAB-based smart home systems.

8 Where to buy and what to look for when choosing

The new Xiaomi Mi Wireless Switch can be found here:

  • πŸ›’ Official stores: Mi Store, AliExpress (official Xiaomi store).
  • 🌍 Marketplaces: Wildberries, Ozon, Amazon (but check the seller!).
  • πŸ”„ B/u: Avito, Yula (risk of buying a fake or a device with a discharged capacitor).

When buying, pay attention to:

  • πŸ†” Model: WXKG01LM (free of neutrality or WXKG03LM (neutral).
  • πŸ“¦ Set: the box must have fasteners and instructions in Chinese/English.
  • πŸ” Appearance: the original has a matte coating of the button, fakes - glossy.

Average price (2026):

  • WXKG01LM β€” 800–1200 β‚½.
  • WXKG03LM β€” 1200–1600 β‚½.

⚠️

Attention: AliExpress often sells fakes under the guise of the original Mi Wireless Switch, and can be distinguished by: No Mi logo on the back, low quality plastic (smells like chemistry), incorrect work with the official Mi Home app.

FAQ: Answers to Frequent Questions

Can I use a switch without a Xiaomi hub?
No, Mi Wireless Switch only works through a ZigBee hub (such as Mi Home Gateway or Aqara Hub, ZigBee2MQTT) Connect to the Home Assistant.
Why does the switch go off with a delay?
The reasons can be different: weak signal ZigBee (add repeater), overloaded hub (disable unnecessary devices), interference from the Wi-Fi router (change the ZigBee channel in the hub settings).
How to reset the switch to factory settings?
Press and hold the 10 seconds button until the indicator blinks 3 times red, and then the device disappears from the list in Mi Home, and it can be reconnected.
Can I connect a switch to a lamp of another brand (for example, Philips Hue)?
Yes, but only through scripts in Mi Home or third-party systems (like Home Assistant).Naturally, Mi Wireless Switch only works with ecosystem devices. Xiaomi/Aqara.
What if the switch stopped responding to the press?
Try: Reset the device (hold the 10 sec button); check contacts (disassemble and clean the board with alcohol); replace the condenser (if you know how to solder); if nothing helps, the device fails (average life is 3-5 years).