Estimated reading time: 2 minutes

This documentation was last modified: Monday, April 16th, 2018 at 3:48 am

Picroft - manually configure WiFi

There may be cases where the more automated method of connecting your Picroft Device to WiFi doesn't work, and you need to manually configure your Picroft's WiFi settings. This documentation walks you through that process.

Make sure you can edit files on the filesystem of the Picroft.

There are two ways to do this.

  1. Plug the Picroft into a keyboard and HDMI monitor then type Ctrl + C to get to the command line or
  2. SSH in to the Picroft device

Manually configuring WiFi

Next, we edit the wpa_supplicant.conf file.

  1. Type sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
  2. Using the down arrow key, navigate to the bottom of the file, and add credentials for your SSID
    network={
            ssid="MyNetworkSSID"
            psk="mypassword"
    }
  1. Type Ctrl + X to exit and Y then Enter to save your changes.
  2. Type sudo reboot now

Manually configuring WPA2 Enterprise WiFi with MSCHAPV2 authentication

If you are on an enterprise network, your network security might use WPA2 with MSCHAPV2 authentication. Configuring Picroft to use MSCHAPV2 is similar to the above, but requires some additional steps.

First, we need to generate a hash of your SSID's password.

echo -n your_password| iconv -t utf16le | openssl md4

This will use the NTLM hash which is a 16 bit MD4 hash. Make sure to copy this as we will need it for later steps.

Next, run the following commands:

cd /etc/wpa_supplicant
sudo nano wpa_supplicant.conf

Add the following to the bottom of the wpa_supplicant.conf file, replacing ssid with your SSID name, identity with your username and password with the hash generated earlier. Type Ctrl + O to save, then Ctrl + x to exit.

Next, reboot the Picroft using sudo reboot now. If these steps have worked, you will be connected to your enterprise WiFi shortly after rebooting.

network={
    ssid="ssid network name"
    priority=1
    proto=RSN
    key_mgmt=WPA-EAP
    pairwise=CCMP
    auth_alg=OPEN
    eap=PEAP
    identity="user_name"
    password=hash:hash_key_here
    phase1="peaplabel=0"
    phase2="auth=MSCHAPV2"
}

Help us serve you better by rating this documentation