WiFi troubleshooting in offices, schools, and enterprise networks

The MagWLED-1’s ESP32-C3 supports 2.4GHz WiFi only. This is the most common cause of connection failures in office, school, and enterprise environments.

2.4GHz only — no 5GHz support

If your network uses a 5GHz-only SSID, the MagWLED-1 won’t connect. Make sure you’re connecting to the 2.4GHz band of your network. Many routers broadcast separate SSIDs for each band (e.g. MyNetwork and MyNetwork_5G) — use the 2.4GHz one.

VLAN isolation between buildings or zones

Some enterprise networks segment different areas into separate VLANs, even when they share the same SSID. If the MagWLED-1 connects in one room but not another on the “same” network, it may be on a different VLAN with no route between them.

Workaround: Ask your network admin to ensure the controller’s IP range can reach your control device, or place both on the same VLAN/subnet.

Captive portals

Enterprise networks that require clicking through a web login page (captive portals) are not compatible with the MagWLED-1. The device has no browser to complete the login flow.

Workaround: Use a dedicated mobile hotspot or a router in AP mode on a separate network for your LED controllers.

MAC address filtering

If the network uses MAC address whitelisting, you’ll need to register the MagWLED-1’s MAC address with your network admin before it can connect.

The MAC address is visible in the WLED interface under Info once the device is connected to WLED-AP.

Recommended approach for schools and offices

For reliable operation in managed environments, the simplest solution is a dedicated mobile hotspot that only your MagWLED devices and your control phone/laptop connect to. This eliminates all enterprise network complications.

If running multiple controllers, see also Using multiple MagWLED-1 controllers in the same location.