Run the VCS 1 environment in docker container - SundanceMultiprocessorTechnology/VCS-1 GitHub Wiki
Abstract
Software developers sometimes do not have the target platforms available (e.g. the VCS-1). Nevertheless, several tools are available for emulating the environment and enable developers to deploy the system. The procedure for creating the environment and compiling two of the most commonly used libraries (opencv and librealsense) in the VCS-1.
Requirements
Dependencies:
- Ubuntu 18.04 LTS running on the host machine
- Ubuntu 18.04 LTS running on the docker container [ARMv7, ARMv8]
Documentation
- Install docker and Ubuntu 18.04 container
- Run ARM docker containers on x86 architecture
- docker command reference
- run arm64 architecture
Software
- Ubuntu 18.04 LTS x86_64
Hardware
- Host PC with at least 8 cores and 16 GB of memory
Procedure
- Meet the dependencies
$ sudo apt update
$ sudo apt install apt-transport-https ca-certificates curl software-properties-common cgroupfs-mount qemu-user qemu-user-static -y
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"
$ sudo apt update
$ sudo apt install docker-ce
$ sudo addgroup ${USER} docker
$ su - ${USER}
- Download and extract the VCS-1 container
armv7 image (armhf)
$ wget https://files.sundance.solutions/Shared/armv7_vcs-1.tar.xz
$ xz -d armv7_vcs-1.tar.xz
ARMv8 image (arm64)
$ wget https://files.sundance.solutions/Shared/vcs-1_arm64.tar.gz.xz
- Load the container
armv7 image (armhf)
$ docker load --input armv7_vcs-1.tar
ARMv8 image (arm64)
$ docker load --input vcs-1_arm64.tar.gz.xz
- Run the docker container
armv7 image (armhf)
$ docker run -v /usr/bin/qemu-arm-static:/usr/bin/qemu-arm-static --rm -it armv7/vcs-1:rs-ocv-comp
ARMv8 image (arm64)
$ docker run --network host -v /usr/bin/qemu-aarch64-static:/usr/bin/qemu-aarch64-static --rm -it arm64v8/ubuntu/vcs-1:runtime