Getting Started

What do you need to get started with Jumpstarter?

To start using Jumpstarter you need a test-harness (i.e., a dutlink-board) and a device under test (DUT).

You will also need an image to flash into your DUT, it could be an .iso or a raw device image. In the case of the dutlink-board, this image is flashed on a usb storage device which then can be attached to the DUT.

Installation

# install jumpstarter binary
wget https://github.com/jumpstarter-dev/jumpstarter/releases/download/${JUMPSTARTER_VERSION}/jumpstarter-${JUMPSTARTER_VERSION}-linux-amd64.tar.gz
tar -xzf jumpstarter-${JUMPSTARTER_VERSION}-linux-amd64.tar.gz
export PATH=${PATH}:$(pwd)

Setup

If you will be using a test harness that works through USB (like the dutlink-board), it is recommended to use a physical host. QEMU is still possible but you will need to pass through the whole USB host controller to the VM, this is recommended because the USB devices will come and go as devices are manipulated through the test-harness.

Hello World

You can use the jumpstarter list-devices command to get a list of detected devices from your drivers.


Concepts

In this section you can find a more detailed explanation of the concepts used in the Jumpstarter project.

Last modified January 25, 2024: Rename jumpstarter board to DUTlink (febb291)