.. include:: /substitutions.rst
.. include:: /urls.rst

.. _librem_awesim_setup:

Setup
=====


.. _librem_awesim_setup_overview:

Overview
--------

The Librem AweSIM SIM card will work in almost any device.
Most Android and iOS devices will configure automatically.
If they do not, use the Librem 5 settings below.

#. :ref:`Install the AweSIM SIM card <l5_sim_tray>`.
#. Configure the :ref:`carrier settings <librem_awesim_carrier_settings>`.
    #. Add or select the APN:
        * Settings → Mobile → Access Point Names
    #. Set the "Network Mode" to "4G Only":
        * Settings → Mobile → Network Mode
    #. Configure Chats application with APN/MMSC/Proxy parameters:
        * Chats → ☰ → Preferences → Protocol Settings → SMS and MMS Settings
#. Contact the Wireless Support department (|email_wireless_support|) to activate your AweSIM voice+data plan.

.. warning::
   Be very careful with the SIM Lock option!
   Only proceed if you fully understand how this feature works.

   It takes a couple business days to process a PIN unlock (PUK) request.
   Contact the Wireless Support department (|email_wireless_support|) to request a PUK reset.

   The default PIN is 1111.


.. _librem_awesim_carrier_settings:

Carrier settings
----------------

.. **Phones**

+-----------+--------------------------------+
| Setting   |                                |
+===========+================================+
| APN       | ``NXTGENPHONE``                |
+-----------+--------------------------------+
| User      | <leave blank>                  |
+-----------+--------------------------------+
| Pass      | <leave blank>                  |
+-----------+--------------------------------+
| MMSC      | ``http://mmsc.mobile.att.net`` |
+-----------+--------------------------------+
| MMS APN   | ``NXTGENPHONE``                |
+-----------+--------------------------------+
| MMS Proxy | ``proxy.mobile.att.net``       |
+-----------+--------------------------------+

.. **Data Device**

.. * **APN**: Broadband
.. * **User**: <leave blank>
.. * **Pass**: <leave blank>

.. seealso::
   * `AT&T device data settings`_


.. _librem_awesim_voicemail:

Voicemail
---------


Configuration
~~~~~~~~~~~~~

#. Dial your own number (or hold '1' on Apple or Android devices).
#. Follow the steps starting at step 2 as described in the `AT&T voicemail setup procedure`_.


Reset password
~~~~~~~~~~~~~~

Contact the Wireless Support department (|email_wireless_support|) to reset your voicemail password.


Reset voicemail
~~~~~~~~~~~~~~~

Contact the Wireless Support department (|email_wireless_support|) to reset your voicemail account.

.. warning::
   You will lose all voicemails in this process.


.. _librem_awesim_call_forwarding:

Call forwarding
---------------

Librem AweSIM supports call forwarding but it must be manually enabled by the MVNE by request.
Contact the Wireless Support department (|email_wireless_support|) to enable or disable this service.

If enabling call forwarding, please provide:

 #. Identifying account information
 #. The 10-digit Librem AweSIM phone number you wish to foward from
 #. The 10-digit phone number(s) you wish to forward to