.. include:: ../urls.rst
.. include:: images.rst

.. _l5_setup_cellular:

Configure cellular networks
===========================


.. _l5_activate_sim:

Activate the SIM card
---------------------

#. Activate the SIM card with your carrier.

.. seealso::
   `Librem AweSIM <docs_librem_awesim_>`_ users:
   Follow the `setup procedure <docs_librem_awesim_setup_>`_ to activate service, if this has not been done previously.


.. _l5_enable_mobile_networking:

Enable cellular networks
------------------------

#. Ensure that a cellular modem is installed in the device and that the modem is :ref:`appropriate for the geographic region <l5_cellular_networks_supported_networks_modems>` in which it's used.
#. Ensure that a SIM card is :ref:`properly installed and enabled <l5_sim_tray>` to enable calls, SMS messaging, MMS messaging and other cellular data services.
#. Ensure that the cellular modem :ref:`hardware killswitch <l5_kill_switch>` is in the :ref:`enabled <l5_kill_switch_terminology>` position, positioned away from the SIM slot.

   .. image:: ../images/hardware/librem5-switches.svg
      :align: center
      :width: 480
      :alt: The locations of kill switches on the edge of the phone
      :class: no-scaled-link

#. :ref:`Power on the device <l5_power_on>`, :ref:`unlock the encrypted disk <l5_disk_unlock>`, and :ref:`log in <l5_screen_unlock>` if not already completed.
#. Launch the :ref:`Settings <l5_settings>` application.
   One way to do this is to swipe down from the top of the screen to open the :ref:`settings panel <l5_settings_panel>`, then long press the **Cellular** icon.

   .. image:: ../images/phosh/phosh-settings-panel-cellular-disabled.png
      :align: center
      :scale: 50%
      :alt: The cellular toggle button on the settings panel
      :class: no-scaled-link

#. In the **Mobile** section of the **Settings** application, ensure that the mobile network software switch in enabled the upper-right corner of the screen.

   .. note::
      If the cellular modem is disabled with either the :ref:`hardware kill switch <l5_kill_switch>` or with the software toggle switch, you will see the following page.
      Notice the |cell-dis| icon at the top-left of the screen:

      .. image:: ../images/networks/cellular-no-wwan.png
         :align: center
         :scale: 50%
         :alt: The cellular page cannot be accessed until the modem is enabled
         :class: no-scaled-link


.. _l5_add_cellular_access_point:

Add a cellular access point
---------------------------

 #. Open the :ref:`Settings <l5_settings>` application
 #. Tap **Mobile**
 #. Under the **Advanced** section, tap **Access point Names**
 #. Is the access point name for your mobile carrier visible?
     * **YES**
         #. Tap the radio button to the left of your cellular network's access point name
         #. Proceed to the next step
     * **NO**
         #. Tap the **+** button at the upper-right portion of the screen
         #. Enter a **Name** and **APN** for your carrier
         #. Enter a **Username** and **Password** if required by your carrier
         #. Tap **Save** at the upper-riht section of the screen
         #. Tap the radio button to the left of your cellular network's access point name
         #. Proceed to the next step
 #. Under the **Network** section, toggle the slider switch so that it is enabled
 #. Cellular network data should now be enabled

.. seealso::
   For Librem AweSIM users, verify the `carrier settings <docs_librem_awesim_carrier_settings_>`_ for access point name details.