dmos

Dockerized Mongoose-OS tools.

This project is about installing and running the Mongoose-OS tools from a docker image.

You do not have to pollute your original operating system, with installing the several libs and the app itself. Instead you only need docker to be installed.

At the same time you can keep your projects on your disk, that the docker container will reach through volumes.

Use the container

This repository contains the dmos.sh bash script, that you can use to start the mos tool.

    #!/bin/bash
    # Starts the Mongoose-OS utils using the docker image.

    PROJECTS=$HOME/topics       # Set the base path to your topics/projects directory
    SANDBOX=$HOME/sandbox/mos   # Set the base path to your sandbox directory
    SERIAL_PORT=/dev/ttyUSB0    # Define the serial port you are willing to use

    docker run \
        -it \
        --rm \
        --privileged \
        -e DISPLAY=$DISPLAY \
        -p 1992:1992 \
        -v /tmp/.X11-unix:/tmp/.X11-unix \
        -v $SERIAL_PORT:$SERIAL_PORT \
        -v $PROJECTS:/home/developer/projects \
        -v $SANDBOX:/home/developer/sandbox \
        tombenke/dmos:latest \
        /bin/bash

First time you should execute the following steps:

1. Copy the dmos.sh script somewhere in your $PATH ($HOME/bin/ for example).
2. Set the volume references to your project and sandbox folders, as you can see in the code example above.
3. Also set the serial port you are using when communicate via the USB cable.

In order to start the container, execute the dmos.sh script. It starts a container named dmos. You can exit from the session simply by pressing Ctrl-D.

The container will be removed after the session. In case you want to make changes, start the container without the --rm switch, and execute the commit and push docker commands.

If you want to use the tool in several, parallel console sessions, then start the container with the dmos.sh script and use the docker exec command:

    docker exec -it dmos bash

Read about how to do the first steps with dmos, and learn more about the usage of the mos tool on the Mongoose-OS website.

References

• Mongoose-OS
• Mongoose-OS - Installation on Linux or MacOS