The JOAN Configurator, an app available in the JOAN Portal, will connect your wireless network settings to an individual JOAN device. Connecting JOAN to your Wi-Fi takes place in three easy steps:
How to configure the JOAN Device:
1. Connect your JOAN device to the computer
Connect JOAN to the computer via the enclosed Micro-USB cable. Gently shake the device to wake it.
1.1. Sometimes JOAN devices are not detected by your computer.
Installing or upgrading the connectivity driver for FTDI serial COM port should do the trick.Please follow this guide here.
Run the JOAN Configurator from the JOAN Portal or:
- Download JOAN Configurator for Mac – OSX
– Once it is downloaded, double-click on the downloaded archive to expand the contents.
- Download JOAN Configurator for Windows.
– Once it is downloaded, run the JoanConfigurator_windows.exe.
- Download JOAN Configurator for Linux.
– Once it is downloaded, navigate to the destination folder using the terminal.
– Make it executable by running.
sudo chmod +x ./JoanConfigurator_linux
– Run it using the superuser.
3. Enter the details of your wireless connection into the app
Next, select the Wi-Fi network you want to use and choose between the different Wi-Fi encryption types supported:
- If you are running an open network, simply select JOAN’s hosting and click "Save."
Open networks are supported in all JOAN devices: Manager and Executive, Board, Premium and Classroom.
- If you are connecting to an encrypted network (WPA2-PSK), enter your Wi-Fi password into the JOAN Configurator and then select JOAN’s hosting. Please note, however, that the Wi-Fi password is limited to 63 characters only.
WPA2-PSK is supported in all JOAN devices: Manager and Executive, Board, Premium and Classroom.
- If you require enterprise encryption (WPA2-EAP), begin by entering your Wi-Fi password into the JOAN Configurator. The password is limited to 63 characters only. Next, enter the RADIUS username and password of your server and upload the necessary certificates. If you are unsure about which certificates or RADIUS credentials to use, please contact your IT department or JOAN support at email@example.com. Finally, select JOAN’s hosting.
For Enterprise security, the maximum Certificate length should be less than 12,280 bytes.
For SSL certificates, the max length is 12,280 bytes, and for Private Keys, it is 4,088 bytes. The supported EAP methods are TLS, TTLS, PEAP, FAST. It should be an ASCII character string.
EAP Method: It should be either TLS, TTLS, FAST or PEAP. And it should be an ASCII
a character string.
Inner Method: This field is valid only for TTLS/PEAP. The supported Inner Methods are MSCHAP/MSCHAPV2. If you have TLS/FAST, the Inner Method should be set to MSCHAPV2.
Due to the fact that the JOAN device does not have a full CA chain embedded, a CA certificate needs to be uploaded or the "Skip server verification" flag selected, along with a dummy CA certificate download here.
A private key, a public certificate and a CA (all .pem) need to be uploaded via the JOAN Configurator tool. Please note that the CA certificate must include only the last certificate in the chain. See test certificates to see their structure.
Download a dummy CA certificate here.
Example certificates can be downloaded here:
WPA2-EAP is supported by JOAN Executive, Board, Premium and Classroom devices only.
If all the details entered are correct, JOAN will now connect to your wireless network. Repeat this process for all of your JOAN devices, and click "Continue" in the JOAN Portal when you are done.
You can edit the Wi-Fi settings at any time by accessing the JOAN Configurator again, under "Manage" > "Devices" and downloading (see the upper right corner to download).