WCM as the only Connection Manager
The default installation for the WCM is for the WCM to take complete responsibility for the internet connection state on the device. On startup, the WCM scans for Wi-Fi networks and decides which network to join, giving precedence to any configured private network. If it cannot join a private network, the WCM will join a nearby ZipKey network if available. When the WCM is running in this configuration, you should disable any other connection manager on the product so it will not interfere with the WCM. There is no need for an alternative connection manager. The WCM is a robust connection manager that can ensure that the product stays connected to the best available network at all times.
WCM co-existing with other Connection Manager
Having the WCM as the only connection manager is the best configuration for most connected products. There are some connected products, however, where having the WCM manage the connection at all times may not be appropriate. If the connected product has an ethernet connection, then it may be preferable to not join a nearby Wi-Fi network when the ethernet connection is active. The WCM does not actively manage the ethernet connection. There may also be products, such as Wi-Fi extenders, where the WCM may not have visibility to the connection state within the mesh, and thus should not manage the Wi-Fi connection. For these products, the WCM can be configured to run in Unmanaged mode, where it does not manage the internet connection. A typical configuration would be:
- On initial startup, if there is no private network configured, bring WCM up in managed mode.
- The WCM will try to join a ZipKey network, and download network credentials.
- When the WCM has successfully joined the private network, it will call the registered callback to notify it of the connection status.
- Change the WCM to unmanaged mode.
- When in unmanaged mode, the WCM will do basic housekeeping, such as performing periodic upkeep (Upload logs, get network config, get action, put status, etc), but will not try to reconnect if it detects a loss of connectivity.
- If the WCM needs to actively manage the connection (e.g. after a factory reset), change the WCM to managed mode.
If your product requires the WCM to run in unmanaged mode at times, please contact Cirrent so that we can review the design to ensure that the WCM and your connection manager will co-exist well under all circumstances.