Usage

Using the RCLL Referee Box

After successfully installing and configuring the refbox you are ready to run it. The refbox is split into a core program, which is the actual refbox and game controller, and a user interface to interact with the human referee. The refbox implements the rules and regulations.

Starting the refbox

First you need to start the refbox. To do so go to the base directory of the rcll-refbox build. Then execute the refbox. It will print two lines indicating that the refbox environment is being created.

    $ bin/./refbox
    16:42:37.674050 RefBox: Creating CLIPS environment
    16:42:37.674437 RefBox:  refbox

The refbox is now waiting for the start signal from one of the controllers.

Docker

If you run the refbox from a container, run:

$ docker run --rm --net=host quay.io/robocup-logistics/rcll-refbox

The --net=host is necessary as the refbox is supposed to communicate with the robots through its public IP address, with --net=host we use the host's network stack instead of creating a separate Docker bridge network.

If you want to run a custom config, mount the config into the container with -v:

$ docker run --rm --net=host -v /absolute/path/to/config:/etc/refbox/config.yml quay.io/robocup-logistics/rcll-refbox

e.g.,

$ docker run --rm --net=host -v $(realpath ./config.yml):/etc/refbox/config.yml quay.io/robocup-logistics/rcll-refbox

to use the local ./config.yml.

Using the Web Frontend

The refbox can be controlled via a web-based frontend.