1
0
Fork 0

improve and simplify installation guide

Signed-off-by: Xander Sanger <BlimpLover1000@protonmail.com>
Signed-off-by: Xander Sanger <81831075+BlimpLover1000@users.noreply.github.com>
This commit is contained in:
Xander Sanger 2021-08-26 09:35:12 +00:00 committed by Daniel Thompson
parent 1696c33b36
commit fe8f6c799c

View file

@ -55,37 +55,53 @@ tested using the `GNU-RM toolchain
Install prerequisites via docker Install prerequisites via docker
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To build via docker, simply invoke `tools/docker/shell` from the root directory
after having docker installed. This will build the docker image and also drop
you into a shell with wasp os's source code shared into the container at
``/home/user/wasp-os``. All ``make`` commands should be usable from this shell,
including ``make sim`` and ``make check``. Some commands that interact with
bluetooth such as ``wasptool`` may not work, for now.
.. note:: .. note::
If you want to use the Docker-based setup, it is assumed that you're using If you want to use the Docker-based setup, it is assumed that you're using
and x86 machine on Linux, running Xorg. Other setup may require some and x86 machine on Linux, running Xorg. Other setups may require some
patching for now. patching for now.
Fetch the code from To build wasp-os with docker, ensure it is installed and running, then open a terminal and run the following commands in your home directory:
`https://github.com/daniel-thompson/wasp-os <https://github.com/daniel-thompson/wasp-os>`_ and download the prerequisites:
.. code-block:: sh .. code-block:: sh
git clone https://github.com/daniel-thompson/wasp-os git clone https://github.com/daniel-thompson/wasp-os
cd wasp-os cd wasp-os
~/wasp-os/tools/docker/shell
This will create a new user with restricted privilages, and drop you into a bash shell.
Some important things to note:
All ``make`` commands should be usable from this shell,
including ``make sim`` and ``make check``. Some commands that interact with
bluetooth such as ``wasptool`` may not work, for now.
We can compile the modules required with the following commands:
.. code-block:: sh
make submodules make submodules
make softdevice make softdevice
To build the firmware select the command appropriate for your board from the We can the compile source code that you will be flashing to your device with the following commands for each device:
list below:
For the pinetime we use:
.. code-block:: sh .. code-block:: sh
make -j `nproc` BOARD=pinetime all make -j `nproc` BOARD=pinetime all
For the k9 we use:
.. code-block:: sh
make -j `nproc` BOARD=k9 all make -j `nproc` BOARD=k9 all
For the p8 we use:
.. code-block:: sh
make -j `nproc` BOARD=p8 all make -j `nproc` BOARD=p8 all
The output of these will be stored in ``build-${BOARD}/``. The output of these will be stored in ``build-${BOARD}/``.