Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swedishembedded/workstation
Docker based development environment for coding, building and flashing embedded firmware.
https://github.com/swedishembedded/workstation
docker-image embedded-c swedishembedded zephyr
Last synced: 2 months ago
JSON representation
Docker based development environment for coding, building and flashing embedded firmware.
- Host: GitHub
- URL: https://github.com/swedishembedded/workstation
- Owner: swedishembedded
- License: apache-2.0
- Created: 2022-08-05T20:57:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-25T07:15:56.000Z (3 months ago)
- Last Synced: 2024-05-03T09:34:04.509Z (2 months ago)
- Topics: docker-image, embedded-c, swedishembedded, zephyr
- Language: Emacs Lisp
- Homepage: https://swedishembedded.com/sdk
- Size: 37 MB
- Stars: 18
- Watchers: 2
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Lists
- awesome-zephyr-rtos - Swedish Embedded Platform SDK Docker Image - Docker containers for CI & development. (Tools / Build & Config)
README
# Swedish Embedded Workstation
This is a complete embedded firmware development workstation based on Linux.
- **Base Image (_ci-base_):** contains only the minimal set of software needed for basic development without the toolchains.
- **CI Image (_ci_):** contains toolchains, the zephyr sdk and additional packages needed for ci operations.
- **Developer Image (_zephyr-build_):** includes additional tools that can be useful for Zephyr
development.
- Workstation: a fully integrated development environment with tools for
building additional documentation, emacs, vim etc.
See [Documentation](doc/index.rst) for more detailed documentation.
It includes:
- Zephyr RTOS base tools included as official Zephyr RTOS docker image
- Docker images: 2 main docker images for CI builds and develop builds.
- Local bootstrapping scripts
- Tmux configuration
- i3wm configuration
- Vim configuration (see [Awesome Vim](https://swedishembedded.com/insights-vim-in-minutes/) article)
## Quick Start
```
docker pull swedishembedded/build:latest
```
## Contact
- Community: https://swedishembedded.com/community
```
docker run -ti -v $HOME/Work/zephyrproject:/workdir \
docker.io/zephyrprojectrtos/zephyr-build:latest
```
#### Building Developer Docker Image
The developer docker image can be built using the following command:
```
docker build -f Dockerfile.devel --build-arg UID=$(id -u) --build-arg GID=$(id -g) -t zephyr-build:v .
```
It can be used for building Zephyr samples and tests by mounting the Zephyr workspace into it:
```
docker run -ti -v :/workdir zephyr-build:v
```
### Usage
#### Building a sample application
Follow the steps below to build and run a sample application:
```
west build -b qemu_x86 samples/hello_world
west build -t run
```
#### Building display sample applications
It is possible to build and run the _native POSIX_ sample applications that produce display outputs
by connecting to the Docker instance using a VNC client.
In order to allow the VNC client to connect to the Docker instance, the port 5900 needs to be
forwarded to the host:
```
docker run -ti -p 5900:5900 -v :/workdir zephyr-build:v
```
Follow the steps below to build a display sample application for the _native POSIX_ board:
```
west build -b native_posix samples/subsys/display/cfb
west build -t run
```
The application display output can be observed by connecting a VNC client to _localhost_ at the
port _5900_. The default VNC password is _zephyr_.
On a Ubuntu host, this can be done by running the following command:
```
vncviewer localhost:5900
```