Commit 664ce054 authored by David Boddie's avatar David Boddie

Reorganized the structure further.

Added more chapters for future completion.
Signed-off-by: David Boddie's avatarDavid Boddie <>
parent e1d35604
.. _development_environment:
Setting up a Development Environment
.. toctree::
.. _requirements:
Software can be developed for the Librem 5 on a variety of systems and
platforms. Typically, the developer will be using a desktop or laptop computer
with sufficient resources to run a modern GNU/Linux distribution, such as
PureOS or Debian, and the GNOME desktop environment. This provides access to
the tools that are recommended for building applications for the Librem 5.
.. _hardware_ref:
Hardware Reference
.. _history:
History of the Librem5
Developing a dev kit and eventually a phone is a long process that
requires many hardware iterations over time to test and determine
which pieces are good to use in the final product and which aren't.
What defines a good hardware component for the Librem 5 phone? There
are several metrics such as performance, freedom of the firmware
(if any), physical size, voltage required, features supported and
more that are taken into account when selecting hardware components
for the Librem 5 phone.
On the freedom front, we have been committed to the i.MX line of
CPUs as opposed to something less freedom respecting such as Intel
hardware. Since the i.MX8 CPU had not been released when the Librem
5 team started testing (January 2018), we started our investigation
with the `Nitrogen6 MAX i.MX6 board <>`_.
Once the i.MX8 CPU was released, and the
`EmCraft i.MX 8M SoM <>`_
was available, a few were ordered so the rest of the dev board
could be designed around this EmCraft SoM. Until the dev kit is
available, the :ref:`Dev-kit` page will remain empty. However
once the dev kit *is* available, this is where you will find
complete information on the hardware and how to set up your dev
kit to start using it.
.. _introduction:
The Librem 5 will be an i.MX8 phone running PureOS, a Debian derivative. The
kernel will be the 4.18 mainline kernel with some additional drivers. For the
graphical windowing system, it will make use of a Wayland compositor together
with a shell named phosh. The graphical environment will be based on the GNOME
platform with a variety of modifications. Below you can find a diagram on the
overall software architecture stack.
.. image:: images/L5-stack.png
:width: 700px
:height: 500px
:align: center
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment