it won't connect to my wifi during setup, just spins forever on the app.

Diagnosis

The "infinite spinning" loop during the Ecovacs Deebot X2 Omni setup process is typically caused by a handshake failure between the robot's network card and your router's broadcast frequency. The X2 Omni is engineered to operate exclusively on the 2.4GHz band because it provides better range and penetration through walls, which is critical for a device moving throughout a home. When your smartphone is connected to a 5GHz band—or a "Smart Connect" mesh network that blends both frequencies—the app attempts to pass 5GHz credentials to the robot, which the X2 Omni cannot process, resulting in a timeout. Beyond frequency issues, this failure often stems from security protocol mismatches or SSID naming. If your WiFi password contains special characters (like &, %, or #) or if your router is using WPA3 security, the X2 Omni's firmware may struggle to authenticate. You can confirm this by checking if other 2.4GHz-only smart home devices are having similar connection issues or by checking your router's admin panel to see if the Deebot is appearing as a "connected" device but failing to communicate with the Ecovacs cloud server.

How to Fix It

To resolve the connection loop, you must isolate the 2.4GHz band and ensure a clean handshake. Follow these exact steps:

1. Log into your router's admin gateway (usually 192.168.0.1 or 192.168.1.1) via a web browser.
2. Navigate to Wireless Settings and locate the "Smart Connect" or "Dual-Band Steering" option. Toggle this OFF.
3. Rename your bands to distinguish them. For example, name your 2.4GHz network "Home_Wifi_2G" and your 5GHz network "Home_Wifi_5G". Save and restart the router.
4. On your smartphone, go to Settings > WiFi and manually connect to "Home_Wifi_2G". Forget the 5GHz network temporarily to ensure the phone doesn't hop back.
5. Power cycle the X2 Omni by toggling the physical power switch on the side of the unit off and then back on.
6. Open the Ecovacs Home app and start the adding process. When prompted for the password, do not use auto-fill. Type the password manually to avoid hidden trailing spaces.
7. Place the robot within 3 feet of the router for the initial pairing process to maximize signal strength, then move it back to its Omni station once the connection is confirmed.

If That Didn't Work

• Change Security Protocol: Access your router settings and change the security mode from WPA3 to WPA2-PSK (AES). The X2 Omni frequently fails to authenticate on WPA3-only networks, which are common on newer WiFi 6 routers.
• Create a Guest Network: If you cannot disable the 5GHz band on your main network, create a dedicated Guest Network. Set it exclusively to 2.4GHz with a simple alphanumeric password (no symbols) and connect the Deebot to this isolated band.
• Disable Firewall/VPN: Ensure any active VPNs on your smartphone are disabled during setup. Additionally, if your router has a "MAC Address Filtering" or "Access Control" list, ensure it is set to "Allow All" or manually add the MAC address found on the sticker under the robot's main brush cover.
• Hard Reset the Network Card: Press and hold the "Home" and "Spot Clean" buttons simultaneously for 5 seconds until the voice prompt indicates the network settings have been reset. This clears any cached, failed attempts that might be blocking a new connection.

Heads Up

• Password Complexity: Avoid using emojis or non-ASCII characters in your WiFi SSID or password; the X2 Omni's network module cannot interpret these and will spin indefinitely.
• Signal Dead Zones: If the robot disconnects frequently after setup, check if the Omni station is placed against a mirrored wall or near a microwave, as these cause significant 2.4GHz interference.
• Firmware Updates: As soon as you successfully connect, immediately check for firmware updates in the app. Ecovacs frequently releases patches specifically to improve WiFi stability and connectivity for the X2 series.
• App Permissions: Ensure the Ecovacs Home app has "Precise Location" and "Local Network" permissions enabled in your phone's OS settings, or the app cannot "see" the robot during the broadcast phase.