+-------------------------------------------------------------------+
|                                                                   |
|            WIKI - WiFi connection with wpa_supplicant             |
|                                                                   |
+-------------------------------------------------------------------+

PREREQUISITES

- Make sure your interface shows up in 'ip link'. See:
    - https://k1ss.org/install
    - https://k1ss.org/wiki/Loading-a-module-at-boot


* Bring your interface up.

  $ ip link set <interface> up


* Create a configuration file for the wireless access point.

  $ wpa_passphrase SSID password > \
    /etc/wpa_supplicant/wpa_supplicant-<interface>.conf

NOTE: A complete documentation of all the possible options can be 
      found here: <a href="https://w1.fi/cgit/hostap/tree/wpa_supplicant/wpa_supplicant.conf">wpa_supplicant.conf</a>


USING A SCRIPT

* Start wpa_supplicant in the foreground to make sure the connection 
  succeeds.

  $ wpa_supplicant \
        -i <interface> \
        -c /etc/wpa_supplicant/wpa_supplicant-<interface>.conf


* If all is well, run it as a daemon in the background by adding the 
  -B option.

  $ wpa_supplicant -B \
        -i <interface> \
        -c /etc/wpa_supplicant/wpa_supplicant-<interface>.conf


* Start the interface with dhcpcd.

  $ dhcpcd <interface>


* Check your connection.

  $ ping k1ss.org


* A way of automation could be to put this in a shell script.

  #!/bin/sh
  wpa_supplicant -B \
      -i <interface> \
      -c /etc/wpa_supplicant/wpa_supplicant-<interface>.conf

  dhcpcd <interface>


USING DHCPCD HOOKS

* Create the necessary symbolic link.

  ln -s /usr/share/dhcpcd/hooks/10-wpa_supplicant \
        /usr/libexec/dhcpcd-hooks/

* Start the dhcpcd service. 

  See https://k1ss.org/wiki/Managing-Services

* Check your connection.

  $ ping k1ss.org