Ansible Role: TinyPilot

This is an Ansible role for setting up TinyPilot KVM.

Role Variables

Here are some variables you can use, along with their default values (check defaults/main.yml for more):

tinypilot_interface: '127.0.0.1'  # The network interface TinyPilot will use
tinypilot_port: 8000               # The port TinyPilot will listen on
tinypilot_keyboard_interface: /dev/hidg0  # The keyboard interface path
tinypilot_debian_package_path: null  # Path or URL to the TinyPilot Debian package

Dependencies

This role depends on:

• tiny-pilot.ustreamer
• tiny-pilot.nginx

Example Playbook

Building a TinyPilot Debian Package

To install TinyPilot using this Ansible role, you need to provide a path or URL to a TinyPilot Debian package.

To create a TinyPilot Debian package, run this command:

cd $(mktemp -d) && \
  git clone https://github.com/tiny-pilot/tinypilot.git . && \
  ./dev-scripts/build-debian-pkg

This will create a TinyPilot Debian package in the ./debian-pkg/releases directory.

example.yml

This is what your playbook could look like:

- hosts: all
  roles:
    - role: ansible-role-tinypilot
      vars:
        tinypilot_debian_package_path: /path/to/tinypilot.deb

Running the Example Playbook

To run the example playbook, use these commands:

ansible-galaxy install git+https://github.com/tiny-pilot/ansible-role-tinypilot.git
ansible-playbook example.yml

Documentation

• Introduction to the USB gadget driver

License

This project is licensed under MIT.

Author Information

The role was created in 2020 by Michael Lynch.