.. _librem_5_status_line:

Status Line
===========

The status line at the top of the screen contains indicators and icons showing the status of various phone features.

.. contents::
   :local:

The following sections cover the icons related to each function and provide links to the relevant chapters in this guide.

Overview
--------

The status line contains the current time in the center, separating indicators for connectivity on the left from other indicators on the right.

.. image:: ../images/phosh/phosh-status-line.png
   :align: center
   :scale: 75%
   :alt: The status line at the top of the screen

In the above image, the line shows indicators for the cellular signal strength, wireless connection, and general networking status. On the right, the only indicator is the battery level.

.. See https://source.puri.sm/Librem5/phosh/-/issues/40 for the design of the status line's indicator layout.

Cellular Network
----------------

Cellular networks are used for voice communication and data connections to the Internet.

The strength of the cellular network signal is indicated by these icons that provide a simple overview.

=========== =========== =========== =========== ==================
|cell-none| |cell-weak| |cell-ok|   |cell-good| |cell-excellent|
No signal   Weak        OK          Good        Excellent
=========== =========== =========== =========== ==================

Another icon that may appear indicates a disabled connection.

=========== ==================================================
|cell-dis|     Cellular networking is configured but disabled.
=========== ==================================================

The type of cellular network in use is presented as a simple label alongside the signal strength. Most users will see **2G**, **3G** or **4G**.

.. image:: ../images/phosh/phosh-status-line-3G.png
   :align: center
   :scale: 75%
   :alt: The status line showing a 3G cellular network in use

Other variations, such as **2.5G**, may also occur.

Wireless Network
----------------

Wireless networks are used for data connections to the Internet.

When connected to a wireless (Wi-Fi) network, the signal strength is indicated by one of these icons.

=========== =========== =========== =========== ==================
|wlan-none| |wlan-weak| |wlan-ok|   |wlan-good| |wlan-excellent|
No signal   Weak        OK          Good        Excellent
=========== =========== =========== =========== ==================

At other times, the wireless indicator shows the status of the connection to a wireless network.

=================== ==============================================================================
|wlan-offline|      Wireless networking is offline.
|wlan-acquire|      The phone is acquiring a connection to a wireless network.
|wlan-connect|      The phone is connected to a wireless network. |br|
                    This icon is usually replaced very quickly by one showing
                    the signal strength.
|wlan-dis|          Wireless (Wi-Fi) networking is configured but disabled.|br|
                    See :ref:`librem_5_wlan` for instructions on how to enable it.
=================== ==============================================================================

Networking
----------

Alongside the cellular and wireless indicators is an indicator showing the general status of networking. The icons that appear can be used to diagnose problems with connections to the Internet, either via a cellular data connection or a wireless connection.

=================== ==============================================================================
|network-txrx|      Networking is functioning. Traffic is sent and received normally.
|network-offline|   Networking is offline. Neither cellular nor wireless networking are available.
|network-no-route|  Networking is enabled but traffic cannot be routed.
=================== ==============================================================================

Battery Level
-------------

At the right edge of the display, the battery indicator shows the level of charge held by the phone's battery. It also shows whether the battery is being charged, indicating this with a spark symbol in the bottom-right corner of the icon.

=================== =================== ======================================
|battery-empty|     |charging-empty|    The battery is nearly empty.
|battery-low|       |charging-low|      The battery level is low.
|battery-full|      |charging-full|     The battery is fully charged.
=================== =================== ======================================

Other icons may be shown in the exceptional case where the phone is powered without a battery.

.. include:: ../defs.txt

.. Larger icons for inline use in tables

.. Networking

.. |network-txrx| image:: ../images/icons/network-transmit-receive-symbolic.svg
   :width: 40

.. |network-offline| image:: ../images/icons/network-offline-symbolic.svg
   :width: 40

.. |network-no-route| image:: ../images/icons/network-no-route-symbolic.svg
   :width: 40

.. Cellular

.. |cell-dis| image:: ../images/icons/network-cellular-disabled-symbolic.svg
   :width: 40

.. |cell-excellent| image:: ../images/icons/network-cellular-signal-excellent-symbolic.svg
   :width: 40

.. |cell-good| image:: ../images/icons/network-cellular-signal-good-symbolic.svg
   :width: 40

.. |cell-ok| image:: ../images/icons/network-cellular-signal-ok-symbolic.svg
   :width: 40

.. |cell-weak| image:: ../images/icons/network-cellular-signal-weak-symbolic.svg
   :width: 40

.. |cell-none| image:: ../images/icons/network-cellular-signal-none-symbolic.svg
   :width: 40

.. WLAN

.. |wlan-excellent| image:: ../images/icons/network-wireless-signal-excellent-symbolic.svg
   :width: 40

.. |wlan-good| image:: ../images/icons/network-wireless-signal-good-symbolic.svg
   :width: 40

.. |wlan-ok| image:: ../images/icons/network-wireless-signal-ok-symbolic.svg
   :width: 40

.. |wlan-weak| image:: ../images/icons/network-wireless-signal-weak-symbolic.svg
   :width: 40

.. |wlan-none| image:: ../images/icons/network-wireless-signal-none-symbolic.svg
   :width: 40

.. |wlan-dis| image:: ../images/icons/network-wireless-disabled-symbolic.svg
   :width: 40

.. |wlan-offline| image:: ../images/icons/network-wireless-offline-symbolic.svg
   :width: 40

.. |wlan-acquire| image:: ../images/icons/network-wireless-acquiring-symbolic.svg
   :width: 40

.. |wlan-connect| image:: ../images/icons/network-wireless-connected-symbolic.svg
   :width: 40

.. Battery

.. |battery-empty| image:: ../images/icons/battery-empty-symbolic.svg
   :width: 40

.. |charging-empty| image:: ../images/icons/battery-empty-charging-symbolic.svg
   :width: 40

.. |battery-low| image:: ../images/icons/battery-low-symbolic.svg
   :width: 40

.. |charging-low| image:: ../images/icons/battery-low-charging-symbolic.svg
   :width: 40

.. |battery-full| image:: ../images/icons/battery-full-symbolic.svg
   :width: 40

.. |charging-full| image:: ../images/icons/battery-full-charging-symbolic.svg
   :width: 40
