diff --git a/Dockerfile_fwbuild b/Dockerfile_fwbuild new file mode 100644 index 0000000000000000000000000000000000000000..6845cb52fb3715dc885ec5670e38cb40b41c3e31 --- /dev/null +++ b/Dockerfile_fwbuild @@ -0,0 +1,10 @@ +FROM ubuntu + +RUN apt-get update && apt-get -y install gcc-arm-none-eabi binutils-arm-none-eabi libnewlib-arm-none-eabi python3 python3-pip ninja-build git + +RUN pip3 install meson crc16 pillow + +VOLUME /firmware +WORKDIR /firmware + +CMD ./bootstrap.sh && ninja -C build && chown -R --reference=/firmware build diff --git a/Documentation/how-to-build.rst b/Documentation/how-to-build.rst index 33a6dc9791f1123b6cfbaec4b3e51e82f77ef1b6..1cfee7f69580067ded27d32457e91e45847ecabd 100644 --- a/Documentation/how-to-build.rst +++ b/Documentation/how-to-build.rst @@ -111,3 +111,25 @@ In order to do a rebuild you can issue a clean command to ninja via $ ninja -C build/ -t clean Otherwise, rerunning ``./bootstrap.sh`` will also clean the build-directory. + +Docker +====== +Alternatively, clone the ``master`` branch of the firmware repository and enter it: + +.. code-block:: shell-session + + $ git clone https://git.card10.badge.events.ccc.de/card10/firmware.git + $ cd firmware + +Afterwards, build a docker-container which will build the firmware via: + +.. code-block:: shell-session + + $ docker build -f Dockerfile_fwbuild -t card10-firmware-builder . + +Now, you can start the container with the firmware directory mounted, which will build the +firmware into the firmware/build directory: + +.. code-block:: shell-session + + $ docker run -v $(pwd):/firmware card10-firmware-builder