docker/arm-none-eabi.buildenv
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Thomas Klaehn 2020-04-08 04:21:27 +02:00
commit 902c3c1715
2 changed files with 149 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
Dockerfile Normal file
View File

@ -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
#

117
README.md Normal file
View File

@ -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
}
}
]
}
```