WiFi
=====

The phyCORE-i.MX7 comes equipped with a mini-PCIe connector (X12) capable of interfacing a WiFi/Bluetooth Card. This guide will use an Intel Dual Band Wireless-AC 8265 WiFi Card and the M.2 to Mini-PCIe Adapter. It is also highly recommend to utilize a compatible WiFi antenna to make connecting to your network as easy as possible.


.. image:: ../../images/phycore-imx7/pcm-061_wifi-X12.webp
  :width: 600px

Replacement
--------------

* `M.2 Mini-PCIe WiFi Card <https://www.intel.com/content/www/us/en/products/sku/94150/intel-dual-band-wirelessac-8265/specifications.html>`_

  #. Intel Dual Band Wireless-Ac 8265 w/Bluetooth 8265.NGWMG

* `M.2 to Mini-PCIe Adapter <https://www.amazon.com/HUYUN-Adapter-Converter-Intel-Module/dp/B07CJT4H6M>`_

* `WiFi Antenna <https://www.digikey.com/en/products/detail/molex/2196110100/16818512?utm_adgroup=General&utm_source=google&utm_medium=cpc&utm_campaign=PMax%20Shopping_Product_Zombie%20SKUs&utm_term=&utm_content=General&gclid=CjwKCAjwtuOlBhBREiwA7agf1rkqQmZ0q48ubMWnmBlQmJiaIlqU2eQhxVQwf-Eohil_-6_jaUFGkhoCeWEQAvD_BwE>`_


Step-by-Step Guide
-----------------------

* A 'wpa_supplicant' file must contain the necessary credentials to connect to your network.

  .. code-block:: none
    :caption: Target (Linux)

    vi /etc/wpa_supplicant.conf

* Ensure that this file reflects the following contents (replace NETWORKNAME and NETWORKPASSWORD to the corresponding credentials for your target network):

  .. tip:: The vi text editor begins in "Command Mode" and you must first hit the 'i' key in order to enter "Insert Mode". Using the arrow keys to navigate, make the necessary changes and then hit ESC to go back to "Command mode". Now enter ":wq" to write the file and quit.

.. code-block:: none
    :caption: /etc/wpa_supplicant.conf

    ctrl_interface=/var/run/wpa_supplicant
    ctrl_interface_group=0
    update_config=1

    network={
            ssid="NETWORKNAME"
            key_mgmt=WPA-PSK
            psk="NETWORKPASSWORD"
    }

Setup the Interface
----------------------

* Load the credentials from the previous step:

  .. code-block:: none
    :caption: Target (Linux)

    wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf

* Launch the WiFi client

  .. code-block:: none
    :caption: Target (Linux)

    udhcpc -i wlan0

* Wait until you obtain an IP address.

* Test your connection

  .. code-block:: none
    :caption: Target (Linux)

    ping google.com -c 10