.. _nus_client_readme:

Nordic UART Service (NUS) Client
################################

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

The Nordic UART Service Client module can be used to interact with a connected peer that is running the GATT server with the :ref:`nus_service_readme`.
The client uses the :ref:`gatt_dm_readme` module to acquire the attribute handles that are necessary to interact with the RX and TX Characteristics.

The NUS Service Client is used in the :ref:`central_uart` sample.


RX Characteristic
*****************

To send data to the RX Characteristic, use the send API of this module.
The sending procedure is asynchronous, so the data to be sent must remain valid until a dedicated callback notifies you that the Write Request has been completed.

TX Characteristic
*****************

To receive data coming from the TX Characteristic, enable notifications after the service discovery.
After that, you can request to disable notifications again by returning the STOP value in the callback that is used to handle incoming data.
Another dedicated callback is triggered when your request has been completed, to inform you that you have unsubscribed successfully.

API documentation
*****************

| Header file: :file:`include/nus_client.h`
| Source file: :file:`subsys/bluetooth/services/nus_client.c`

.. doxygengroup:: bt_nus_client
   :project: nrf
   :members: