Commit bdeba4ae authored by Alberto Fanjul Alonso's avatar Alberto Fanjul Alonso

Document QEMU VM setup

Fixes #21, #23
parent e2ad4519
......@@ -12,8 +12,9 @@ Once the i.MX8 CPU was released, and the `EmCraft i.MX 8M SoM <https://www.emcra
Also take a look at the :ref:`mini-tutorials` page for some common commands and some application setup that is not board specific.
.. toctree::
:maxdepth: 1
Boards/imx6
Boards/Dev-kit
Boards/mini-tutorials
Boards/real-hardware
Boards/emulators
Boards/additional-tutorials
.. _additional-tutorials:
Additional tutorials
====================
.. toctree::
mini-tutorials
.. _emulators:
Emulators
=========
.. toctree::
qemu
This diff is collapsed.
.. _qemu:
QEMU
====
There's an experimental QEMU image available that includes:
- phosh: phone graphical shell
- Common apps: geary, ephiphany, contacts, calls
- phone / network services: NetworkManager, ModemManager, ...
Download:
---------
1. Check the last succesful job on CI
https://arm01.puri.sm/job/Images/job/Image%20Build/
2. Download:
wget https://arm01.puri.sm/job/Images/job/Image%20Build/133/artifact/qemu-x86_64.img.xz
3. Decompress it:
unxz qemu-x86_64.img.xz
4. Run it:
qemu-system-x86_64 -boot menu=on -drive file=qemu-x86_64.img,format=raw -vga virtio -display sdl,gl=on -m 1G -enable-kvm
If you prefer a GUI:
- install org.gnome.Boxes from flatpak: https://flathub.org/apps/details/org.gnome.Boxes
- Create a new Box from archive selecting qemu-x86_64.img
5. Use it:
.. image:: librem5fromqemu.gif
:alt: QEMU VM running phosh and default apps
Resources:
----------
- repo: https://source.puri.sm/Librem5/image-builder
.. _real-hardware:
Real hardware
=============
.. toctree::
imx6
Dev-kit
......@@ -6,5 +6,4 @@ Community
.. toctree::
Volunteering/HowTo
Volunteering/DevEnv
Development Environment
=======================
Right now the development environment available is an x86 VM with the same packages and environment as the development board. `Download x86 VM image <https://storage.puri.sm/librem5/binaries/unstable/x86_64-VMs/qemu-x86_64.img>`_
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment