Skip to content

harp-tech/device.hobgoblin

Repository files navigation

Harp Hobgoblin

A simple multi-purpose device for learning the basics of the Harp standard. Although the repository contains working device metadata, firmware and high-level interface, the Harp Hobgoblin device is made to be adapted and modified for a variety of purposes.

Assembling the device

The Harp Hobgoblin is designed to operate directly from a Raspberry Pi Pico / Pico 2 board. To make it easier to interface with a variety of inputs and outputs we recommend the Gravity: Expansion Board.

Note

The following links are provided as a reference only. We are not connected to or in any other way affiliated with the suppliers listed below.

Flashing the firmware

  1. Press-and-hold the Pico BOOTSEL button while you connect the device to the computer USB port.
  2. Drag-and-drop the .uf2 file matching your Pico board into the new storage device that appears on your PC.

Using the device

Harp Hobgoblin is designed for use with the Bonsai visual reactive programming language.

  1. Install the Harp.Hobgoblin package using the Bonsai package manager.
  2. Insert the Device source from the editor toolbox.
  3. For additional documentation and examples, refer to the official Harp documentation.

Building the firmware

Prerequisites

  1. Install Visual Studio Code.
  2. Install the Raspberry Pi Pico extension.
  3. Update the Harp Core submodule:
git submodule update --init --recursive

Follow the steps outlined in Firmware/README.md.

Editing device metadata

Prerequisites

  1. Install Visual Studio Code.
  2. Install the YAML extension.

The device.yml file in the root of the project contains the Hobgoblin device metadata. A complete specification of all device registers, including bit masks, group masks, and payload formats needs to be provided.

Generating the device interface

Prerequisites

  1. Install dotnet.
  2. Install dotnet-t4.
dotnet tool install -g dotnet-t4

The Generators folder contains all text templates and project files required to generate both the firmware headers and the interface for the Hobgoblin device. To run the text templating engine just build the project inside this folder.

dotnet build Generators

About

A simple multi-purpose device for learning the basics of the Harp standard

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •