.. _l5_calls:

Calls
=====

.. image:: ../images/calls/sm.puri.Calls.svg
   :width: 128
   :align: right
   :alt: The Calls application icon
   :class: no-scaled-link

The **Calls** application is used to place phone calls and handle incoming calls.


.. _l5_calls_overview:

Getting Started
---------------

Launch the application by tapping its icon in the app drawer.

Once **Calls** is launched, you will be shown the **Recent** page of the application.
The first time you view this there will be no recent calls.

.. image:: ../images/calls/calls-no-recent-calls.png
   :align: center
   :scale: 50%
   :alt: No recent calls
   :class: no-scaled-link

Switch to the **Dial Pad** by selecting the icon at the bottom of the page.
This will cause the dial pad to be shown.

.. image:: ../images/calls/calls-dialpad.png
   :align: center
   :scale: 50%
   :alt: The dial pad allowing dialling to take place
   :class: no-scaled-link

If the modem is available, the blue call button will be enabled and you will be able to dial numbers and place calls.


.. _l5_calls_placing:

Placing a Call
--------------

There are several ways to place a call from within the **Calls** application:

 #. Open the *Dial Pad* page, dial the desired phone number, then press the blue dial button.
 #. Open the *Recent* page and press the handset (dial) button to the right of the contact you wish to call.

It is also possible to place a call :ref:`from the Contacts application <l5_contacts_viewing>`.

.. seealso::
   Troubleshooting: :ref:`l5_troubleshooting_calls_no_outgoing`


.. _l5_calls_during:

During a Call
~~~~~~~~~~~~~

When a call is placed, a page will appear showing the phone number, the elapsed time of the call and a collection of buttons that can be used to perform actions during the call -- some of these may be inactive.

.. image:: ../images/calls/calls-called.png
   :align: center
   :scale: 50%
   :alt: Information and available actions during a call
   :class: no-scaled-link

At the bottom of the page, a label indicates whether the call is encrypted, and the red button can be pressed to hang up the call.

.. seealso::
   Troubleshooting: :ref:`l5_troubleshooting_no_mic_input`


.. _l5_calls_receiving:

Receiving a Call
----------------

The **Calls** application will be shown when a phone call is received.
You will be prompted to accept or reject the incoming call.

.. image:: ../images/calls/calls-incoming-call.png
   :align: center
   :scale: 50%
   :alt: Handling an incoming call
   :class: no-scaled-link

Press the blue handset button to accept the call, or press the hang-up button to reject it.

Missed and rejected calls will appear in the :ref:`notifications <l5_notifications_missed>` section of the settings panel.