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

Software

  • Ubuntu 18.04 LTS x86_64

Hardware

  • Host PC with at least 8 cores and 16 GB of memory

Procedure

  1. 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}
  1. 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
  1. 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
  1. 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

Return home