88x2bu-20210702/docs/Update_wpa_supplicant_v3a.md

2022-02-14

How to Upgrade wpa_supplicant

Tested on: Linux Mint 20.2 - kernel 5.13

Info: Some distros may require additional updates beyond wpa_supplicant
to support WPA3 in managed (client) mode. Hopefully, as time passes,
making modifications will no longer be necessary for the Realtek
drivers to fully support WPA3. No modifications, such as this, are
necessary at this time for AP mode with the Raspberry Pi OS.

Note: This document applies only to the following drivers:

```
https://github.com/morrownr/8821au-20210708
https://github.com/morrownr/8812au-20210629
https://github.com/morrownr/88x2bu-20210702
https://github.com/morrownr/8821cu-20210118
```

Purpose: Provide instructions for upgrading wpa_supplicant. As of the
date of this document, the specified Realtek USB WiFi adapter drivers
cannot support WPA3 without a very new version of wpa_supplicant
installed on most Linux distros. The version of wpa_supplicant required
currently is not even released yet. It is the git main.

This guide and its effectiveness has had limited testing but has been
requested by users. It is now up to you, should you decide this is what
want to do, to report success or failure so that we can improve this
guide.

Disclaimer: This guide attempts to help you install software that has
not been released. This may break your system. If it does break your
system, you own it.


Step 1) Install dependencies required by wpa_supplicant.

```
$ sudo apt install -y libssl-dev build-essential pkg-config libnl-3-dev

$ sudo apt install -y libdbus-1-dev libdbus-glib-1-2 libdbus-glib-1-dev

$ sudo apt install -y libreadline-dev libncurses5-dev libnl-genl-3-dev

$ sudo apt install -y dbus libnl-route-3-dev 
```

Step 2) Go to the `src` directory.

```
$ cd ~/src
```

The `~/src` directory has already been created if you followed the
instructions for installing any of the wifi drivers listed above.


3) Download the wpa_supplicant source package.

```
$ git clone git://w1.fi/hostap.git
```

4) Go in to wpa_supplicant folder.

```
$ cd ~/src/hostap/wpa_supplicant
```

If an error is returned, check whether the directory name is correct.


5) Create a build configuration file.

```
$ sudo nano .config
```

Add the following contents into .config and save ( Ctrl + X, Y, Enter ) 

```
# 2021-11.29
# .config for wpa_supplicant
# Required for WPA3
CONFIG_TLS=openssl
CONFIG_IEEE80211W=y
CONFIG_SAE=y
CONFIG_LIBNL20=y
CONFIG_LIBNL32=y
#
# Defaults per defconfig
CONFIG_DRIVER_WEXT=y
CONFIG_DRIVER_NL80211=y
CONFIG_DRIVER_WIRED=y
CONFIG_DRIVER_MACSEC_LINUX=y
CONFIG_IEEE8021X_EAPOL=y
CONFIG_EAP_MD5=y
CONFIG_EAP_MSCHAPV2=y
CONFIG_EAP_TLS=y
CONFIG_EAP_PEAP=y
CONFIG_EAP_TTLS=y
CONFIG_EAP_FAST=y
CONFIG_EAP_GTC=y
CONFIG_EAP_OTP=y
CONFIG_EAP_PWD=y
CONFIG_EAP_PAX=y
CONFIG_EAP_LEAP=y
CONFIG_EAP_SAKE=y
CONFIG_EAP_GPSK=y
CONFIG_EAP_GPSK_SHA256=y
CONFIG_EAP_TNC=y
CONFIG_WPS=y
CONFIG_EAP_IKEV2=y
CONFIG_MACSEC=y
CONFIG_PKCS12=y
CONFIG_SMARTCARD=y
CONFIG_BACKEND=file
CONFIG_CTRL_IFACE=y
CONFIG_CTRL_IFACE_DBUS_NEW=y
CONFIG_CTRL_IFACE_DBUS_INTRO=y
CONFIG_IEEE80211R=y
CONFIG_DEBUG_FILE=y
CONFIG_DEBUG_SYSLOG=y
CONFIG_IEEE80211AC=y
CONFIG_INTERWORKING=y
CONFIG_HS20=y
CONFIG_AP=y
CONFIG_P2P=y
CONFIG_TDLS=y
CONFIG_WIFI_DISPLAY=y
CONFIG_DPP=y
#
# Not defaults per defconfig
CONFIG_READLINE=y
CONFIG_DEBUG_SYSLOG_FACILITY=LOG_DAEMON
#
# Extra
CFLAGS += -I/usr/include/libnl3
#
# End of .config
```

6) Compile

```
$ make
```

7) Install

```
$ sudo make install
```

8) Reboot

```
$ sudo reboot 
```

9) Check version

```
$ wpa_supplicant -v
```

-----