- Incompatible Routers
- Routers with Known Issues
- Mesh Networks
- OpenWRT
- Gateway Puck won't Connect during WiFi Setup
- Gateway Puck Repeatedly Disconnects from WiFi
- Puck Won't Reconnect After a Power Outage
Incompatible Routers
The following routers have known issues with the chip used with Flair. Please contact support if you have one of these routers.
- Arris D63450, D63450A
- Asus RT-AX92U
- Cisco RV160 (EOL router)
- Linksys WRT3200ACM
Routers with Known Issues
- Asus RT-AC55U: If the router goes offline, when it comes online, Gateway Pucks are unable to re-connect to WiFi. Perform "Forget WiFi" for all Gateway Pucks, then re-add Gateway Pucks via the PLUS.
- Netgear Orbi: Netgear Orbi has some Armor feature that filters traffic. Check to see if this is active/on and remove/disable/turn it off.
Mesh Networks
Bridge Mode
Try setting up the access points in bridge mode.
- eero router: Setup eero in Bridge Mode
- TP-Link Deco: if you're using a separate router, setup Deco in Wireless Access Point Mode. If you're using the Deco as the router, setup Deco in Wireless Router Mode.
Other Solutions
If the above doesn't work, try the following:
- For dual band routers, make sure the 2.4 GHz network network name is unique and different from the 5.0 GHz network name.
- Try creating/enabling a 2.4GHz guest network with a unique SSID, and see if the Gateway Puck will connect to the guest network.
- Disable the mesh access points, so only the main router is powered on, and see if the Gateway Puck will connect to the main router. If so, then power on the access points.
OpenWRT
Issue
OpenWrt is open-source router software. There's a bug that prevents the router from assigning an IP address to the Puck, which prevents the Puck from connecting to the internet and communicating with the Flair app.
These articles explain that OpenWrt has interoperability issues with IoT devices with ESP chip sets (Flair Puck uses the ESP-8266 chipset):
- Some IoT devices can’t connect to WiFi APs provided by the router
- ESP8266/Embedded devices unable to connect to 2.4Ghz Radio
- Enabling WMM causes issues
Solution
There are two options:
- Disable WMM <-- may result in speed loss
- Enable WMM but Disable LDPC
We recommend option 1. If the user can create a dedicated network used only for IoT devices, they can just disable WMM for that network.
Gateway Puck won't Connect during WiFi Setup
The router broadcasts 2.4 and 5.0 GHz networks but seems to only allow devices to connect to 5.0GHz. Once a device is connected to 5.0GHz, the router will then allow connection to 2.4GHz. This has been identified as the WiFi router rejecting new connections under 2.4GHz.
- Google WiFi
- Archer TP-Link AX-1800
- Single (Combined) 2.4GHz and 5.0GHz Network
- Ubiquity Unifi Dream Machine SE
Google WiFi
- Temporarily rename the home WiFi to "Temp 123" - do not change the password
- Create a Guest network that uses 2.4GHz. Give it the original name for the home WiFi - and use the same password.
For example, if the original home WiFi name was "Mi Casa" and you renamed it to "Temp 123", then name the Guest network "Mi Casa". Both should use the same password. - Connect the Gateway Puck to the Guest network
- Disable the Guest network
- Rename the home WiFi network back to its original name
- Power off the Gateway Puck, wait 60 seconds, and then power it back on
- The Puck will reconnect to the home WiFi network
Archer TP-Link AX-1800
- On the WiFI router
- Log into the router admin
- Wireless > [Wireless Settings] > Network Name: "Temporary"
- Wireless > [Guest Network] > Network Name: (what your main network name was)
- Wireless > [Guest Network] > Password: (same as your main network's password)
- Save (at the bottom)
- In the Flair App
- Tap the PLUS sign
- Select "Add new Gateway Puck"
- Connect the Gateway to the Guest network
- On the WiFi router:
- Wireless > [Guest Network] > uncheck 2.4GHz (to disable it)
- Wireless > [Wireless Settings] > Network Name (main network's name)
- Save (at the bottom)
- Power-cycle the Puck, waiting 60 seconds before plugging in
- The Puck will reconnect to the WiFi network
Single (Combined) 2.4GHz and 5.0GHz Network
Some mesh routers create a single 2.4 and 5.0 network instead of two separate networks. Pucks may not be able to connect to these routers. It's a known issue in the industry:
The best solution is to manually set up a separate low-cost 2.4GHz router that’s attached to the mesh network. This will create a separate 2.4GHz network to allow the Puck (or other smart home devices) to connect to the mesh network.
Ubiquity Unifi Dream Machine SE
A number of countries may be Geo IP blocked as possible malware/phishing threat sources in the threat management settings.
Remove "Colombia" from the Geo IP block list. The router may be assuming the ".co" of "api.flair.co" is for the country of Colombia and mistakenly blocking access to api.flair.co.
Are they using Ubiquiti AC Pro Access Points? These are access points that give coverage from what is effectively a mesh network, but broken into the 2 frequencies.
Gateway Puck Repeatedly Disconnects from WiFi
Is it happening frequently at the same time of day/night? Check to see if your router is set to reboot every night (or on a schedule). This will cause all devices to disconnect from WiFi. Most devices will easily be able to reconnect to WiFi when it comes back up.
Is it happening randomly? Check to see if the router is running out of DHCP leases and try increasing the number of devices that can connect to the router. Maybe when someone connects a phone or a laptop to WiFi it's bumping the Gateway Puck off the Wifi. In most cases, a WiFi router has an estimated 50 devices that can connect before it cycles through the Lease Pool and stops allowing devices to connect. Note: this is a known issue with the Google Nest Pro mesh router.
Puck Won't Reconnect After a Power Outage
A Gateway Puck should reconnect once WiFi is established, but in some cases, it won't reconnect.
The fastest solution is to do a "Forget WiFi" on all Gateway Pucks and go through WiFi Setup again. This is a good short-term solution to get the system up and running again. However, this will have to be done every time there's a power outage. For a long-term solution, try one of the following:
- Dedicated IP Address: Create dedicated IP addresses for each Gateway Puck. This is the best solution, especially for office environments.
- Increase DHCP Lease Time: When trying to reconnect, the Gateway Puck may show a WiFi symbol but appears offline in the Flair app. Increase the DHCP lease time from x hours to 7 days. This is okay for most homes. It allows the DHCP lease to last for a long time - longer than most outages - so when the Gateway Puck comes back online, the lease is still valid.
Additional solutions for mesh routers:
- Blacklist the MAC address of the Pucks on the main router. Whitelist the MAC address of the Pucks on the other access points.
- eero: Unplug Gateway Puck(s) so they will stop trying to reconnect. Wait 1 hour after the router is back online before the Flair Puck can be powered.
Note 1: A Puck's MAC address is in the Status menu (push Puck to enter menus, rotate to the Status menu and push to select).
Note 2: Reboot the Puck after any router changes.