App Launch Demo

App launch demo for the Tapster 3 robot

Setup

Linux is required because of a dependency on Video4Linux and v4l2-ctl to disable automatic exposure in the connected USB camera. With a Windows or MacOS equivalent of v4l2-ctl, the rest of the code would/could/should work.

(Tested on Ubuntu 18.04)

git clone https://github.com/tapsterbot/app-launch-demo.git
cd app-launch-demo
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt

Run demo

1. First, make sure the Tapster 3 robot is plugged in and running.

2. Run demo:

./bin/run-iphone-6s--cold-start.sh

Deactivate enviroment

deactivate

Options

$ python run-test.py -h
usage: run-test.py [-h] -p PORT -c CAMERA [-n NAME] [-i ITERATIONS] [-t TYPE]
                   [-r RESULTS] [--save]

Tapster Robot - App Launch Test

optional arguments:
  -h, --help            show this help message and exit
  -p PORT, --port PORT  Serial port of robot
  -c CAMERA, --camera CAMERA
                        Integer index of camera capture device
  -n NAME, --name NAME  Phone module name: (e.g. iphone_6s, iphone_xs_max)
                        Default: iphone_6s
  -i ITERATIONS, --iterations ITERATIONS
                        Integer number of test iterations to run. Default: 1
  -t TYPE, --type TYPE  Launch type: {warm, cold} Default: warm
  -r RESULTS, --results RESULTS
                        Name of directory to store results data. Default:
                        results
  --save                Save test data in RESULTS directory. Will only save
                        results if this flag is set.

Example

v4l2-ctl -d /dev/video2 --set-ctrl=exposure_auto=1
python run-test.py \
    --port '/dev/ttyUSB0' \
    --camera 2 \
    --name iphone_6s \
    --iterations 300 \
    --type warm \
    --save \
    2> error.txt