.. _ug_matter_gs_testing_wifi_mobile:

Matter over Wi-Fi: Configuring CHIP Tool for Android
####################################################

.. contents::
   :local:
   :depth: 2

In this setup, the Matter controller is installed on mobile, and a dedicated Wi-Fi Access Point is used.

.. figure:: ../../../nrf/images/matter_wifi_setup_mobile.png
   :width: 600
   :alt: Matter over Wi-Fi setup with Matter controller on mobile

   Matter over Wi-Fi setup with Matter controller on mobile

Requirements
************

To use this setup, you need the following hardware:

* 1x smartphone with Android 8+
* 1x Wi-Fi Access Point supporting IPv6 (without the IPv6 Router Advertisement Guard enabled on the router)
* 1x compatible Nordic Semiconductor's DK - for the Matter accessory device (compatible and programmed with one of :ref:`matter_samples`)

Configuring the environment
***************************

To configure and use CHIP Tool for Android with Matter over Wi-Fi, complete the following steps.

.. rst-class:: numbered-step

Program the sample
==================

Program the development kit for the Matter accessory device with one of available :ref:`matter_samples`.
We recommend using :ref:`Matter light bulb <matter_light_bulb_sample>`.

.. rst-class:: numbered-step

Configure the CHIP Tool for Android
===================================

|matter_chip_tool_android_recommended_line|

To use CHIP Tool for Android, complete the following steps:

1. Choose one of the following options:

   * Use the prebuilt tool package from the `Matter nRF Connect releases`_ GitHub page.
     Make sure that the package is compatible with your |NCS| version.
   * Build the package manually from the source files available in the :file:`modules/lib/matter/src/android/CHIPTool` directory and using the building instructions from the :doc:`matter:android_building` page in the Matter documentation.

#. Complete the following steps from the :doc:`matter:nrfconnect_android_commissioning` user guide in the Matter documentation:

   * Building and installing CHIP Tool for Android - which prepares the controller for commissioning.
   * Preparing accessory device - which prepares your device programmed with the Matter sample for commissioning and provides you with the commissioning QR code.

     .. note::
         In the |NCS|, you can also use :ref:`NFC tag for Matter commissioning <ug_matter_configuring_optional_nfc>`.

   * Commissioning accessory device - which lets you commission your device into the Wi-Fi network (Wi-Fi Access Point).
   * Sending Matter commands - which checks the IPv6 connectivity.

.. rst-class:: numbered-step

Continue to testing the sample
==============================

Depending on which Matter sample you programmed onto the development kit, go to this sample's documentation page and complete the steps from the Testing section.