Installing the WCM on a product using Linux has four steps: verifying the dependencies, getting the right binary, registering the device, and installing.
On Linux, the WCM has the following dependencies:
|Function||Libraries we have integrated with||Notes|
|HTTP client library||libcurl|
|Interface to Wi-Fi radio||wpa_supplicant|
|DHCP client||udhcpc, dhclient|
|Wireless access point||hostapd||Only used for SoftAP, ZipKey AP|
|DNS||dnsmasq||Only used for SoftAP, ZipKey AP|
|DHCP server||dnsmasq||Only used for SoftAP, ZipKey AP|
|HTTP server||microhttpd||Only used for SoftAP, ZipKey AP|
You will want to verify that your platform has all of these components installed before trying to install the WCM. To do this, just run the compatibility checker that you can download from here.
If your platform uses other implementations of these libraries, contact us so that we can integrate with the libraries that your platform supports.
Getting the Binary
Registering the device
Every device (even test devices) needs to be registered with the Cirrent cloud by going to the Device Management console. You will need a unique identifier for the device (such as its MAC address or a memorable and unique name). Take note of the device secret that is generated when you add your device to your account as you will need it to personalize your device.
If you are using Raspberry Pi 2, you'll need an external radio (The Raspberry Pi 3 has an internal radio). We find that the Panda radios work best because they support hotspot 2.0 by default.
Installing the WCM
These instructions are specific to a Raspberry Pi. You'll follow a similar process for another product -- contact us if you need help.
Installing a .deb package:
- Connect your device to the internet, preferably by ethernet.
- Download the binary file from the link above.
- Make sure your packages are up to date:
sudo apt-get update
- Install gdebi if you do not have it already:
sudo apt-get install gdebi
- Install the package using gdebi:
sudo gdebi wcm_armhf.deb
As part of the installation process the script will ask you for info to configure your device.