Table of Contents

Installation

This page covers the software you'll need to interact with the Timestamp Generator Gen3, as well as how to update the firmware on the device.

Software packages

These steps are only required the first time you connect the device to a new computer, and you can install just the packages for the functionality you need.

Bonsai is a visual reactive programming language that provides flexible and comprehensive control of the Timestamp Generator Gen3.

Bonsai package manager

  • Download and install Bonsai.
  • Launch Bonsai and install the Harp.TimestampGeneratorGen3 package by searching for it in the Bonsai package manager.
  • Install the Bonsai.StarterPack package to follow along with the examples in this user guide.

Firmware update

New features are added and bugs are fixed with firmware updates which are published on the release page in the device GitHub repository. Each release contains a .hex file tagged with the firmware (fw) and hardware (hw) version. For instance, TimestampGeneratorGen3-fw1.4-harp1.15-hw1.4-ass0.hex is firmware v1.4 for a hardware v1.4 Timestamp Generator Gen3. Download the latest firmware version that matches the hardware version of the device from the "Assets" section under each release.

Tip

The hardware version is printed on the front panel of the device (e.g. harp timestamp generator Gen3 v1.4).

The firmware can be updated from a terminal with the Harp Toolkit, or from the device setup dialog in Bonsai.

The Harp Toolkit is a command-line tool for working with Harp devices. It is distributed as a .NET tool.

  • Download and install the .NET SDK, version 8 or later.
  • Install the toolkit from a terminal with:
dotnet tool install -g Harp.Toolkit
  • Update the firmware with the serial port of the device and the downloaded .hex file:
harp.toolkit update --port COM3 TimestampGeneratorGen3-fw1.4-harp1.15-hw1.4-ass0.hex

The toolkit checks that the file matches the device before writing it, and waits for the device to restart with the new firmware. Run harp.toolkit list to find the serial port of the device. The toolkit firmware update documentation describes every option.



Documentation for release v1.4.0