From 902c3c1715c82ee64a14d8a43dcc5ba50cca1428 Mon Sep 17 00:00:00 2001
From: Thomas Klaehn <thomas.klaehn@perinet.io>
Date: Wed, 8 Apr 2020 04:21:27 +0200
Subject: [PATCH] Initial commit

---
 Dockerfile |  32 +++++++++++++++
 README.md  | 117 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 149 insertions(+)
 create mode 100644 Dockerfile
 create mode 100644 README.md

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..caab2c0
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,32 @@
+FROM debian:bullseye-slim
+
+ARG BUILD_DATE
+ARG VERSION
+ARG VCS_REF
+
+# https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=863199 suggests 'mkdir -p /usr/share/man/man1'
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update \
+    && apt-get install -y \
+      build-essential \
+      git \
+      bzip2 \
+      tar \
+      wget \
+      libncurses5 \
+    && mkdir -p /usr/share/man/man1 \
+    && apt clean \
+    && \
+    wget "https://developer.arm.com/-/media/Files/downloads/gnu-rm/9-2019q4/RC2.1/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2" -O - | tar -C /usr/local -xjf -
+
+# documentation
+COPY README.md /usr/doc/
+
+WORKDIR /work
+
+ENV PATH "/usr/local/gcc-arm-none-eabi-9-2019-q4-major/bin:/usr/local/bin:$PATH"
+
+
+## usage
+# docker run --rm -it buildenv-sensor-adapter /bin/bash
+#
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..83f7a9e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,117 @@
+# arm-none-eabi.buildenv
+
+Arm bare metal compilation environment.
+
+## Creating the image
+
+The following command can be used to create an image from the docker file. It is assume the Dockerfile is located in the same directory.
+
+```shell
+docker build -t arm-none-eabi.buildenv .
+```
+
+## Usage
+
+The working directory of the image is `/work`. To use the image call it similar to the following examples:
+
+```shell
+docker run --rm -v $(pwd):/work --user $(id -u):$(id -g) arm-none-eabi.buildenv make
+```
+
+This puts your current work directory into the container, builds your code and
+afterwards it removes the container.
+
+```shell
+docker run --rm -v $(pwd):/work --user $(id -u):$(id -g) -it arm-none-eabi.buildenv /bin/bash
+```
+
+This puts your current work directory into the container and starts an interactive bash from the container.
+
+## Example output
+
+```shell
+docker run --rm arm-none-eabi.buildenv arm-none-eabi-gcc --version
+arm-none-eabi-gcc (GNU Tools for Arm Embedded Processors 9-2019-q4-major) 9.2.1 20191025 (release) [ARM/arm-9-branch revision 277599]
+Copyright (C) 2019 Free Software Foundation, Inc.
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+```
+
+## Example integration (vscode)
+
+For Microsoft's open source visual studio code, the integration of how to invoke make within the docker container is shown in the following excerpt:
+
+```javascript
+{
+    "version": "2.0.0",
+    "options": {
+        "env": {
+            "PLATFORM": "nrf52",
+            // "PLATFORM": "posix",
+            "APPLICATION": "blinky",
+            // "APPLICATION": "spi",
+            // "APPLICATION": "st7789_lcd",
+            "${BUILD_CMD}": "eval docker run --env PLATFORM=${PLATFORM} --env APPLICATION=${APPLICATION} -t --rm -v '${workspaceFolder}':/work --user $(id -u):$(id -g) arm-none-eabi.buildenv",
+        },
+    },
+    "presentation": {
+        "focus": true,
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true,
+    },
+    "tasks": [
+        {
+            "label": "all",
+            "type":"shell",
+            "command": "${BUILD_CMD} make all -j8",
+            "problemMatcher": {
+                "base": "$gcc",
+                "owner": "gcc",
+                "fileLocation": [
+                    "relative",
+                    "${workspaceFolder}"
+                ]
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        },
+        {
+            "label": "clean",
+            "type":"shell",
+            "command": "${BUILD_CMD} make clean -j8",
+            "problemMatcher": {
+                "base": "$gcc",
+                "owner": "gcc",
+                "fileLocation": [
+                    "relative",
+                    "${workspaceFolder}"
+                ]
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        },
+        {
+            "label": "distclean",
+            "type":"shell",
+            "command": "${BUILD_CMD} make distclean",
+            "problemMatcher": {
+                "base": "$gcc",
+                "owner": "gcc",
+                "fileLocation": [
+                    "relative",
+                    "${workspaceFolder}"
+                ]
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        }
+    ]
+}
+```