Add tutorial infrastructure and getting started guide for Harp Hobgoblin (#26)

* Add device.hobgoblin to src
* Add tutorials folder and Hobgoblin setup article
* Add installation and firmware flashing instructions
* Add Hobgoblin Hello World
* Add uv and harp-python installation instructions
* Add device image for Hobgoblin built with pico and gravity shield

Co-authored-by: glopesdev <[email protected]>
Co-authored-by: jfrazao <[email protected]>

Author: 3 people

.gitmodules

@@ -43,3 +43,6 @@
 [submodule "docfx-tools"]
 	path = docfx-tools
 	url = https://github.com/bonsai-rx/docfx-tools.git
+[submodule "src/device.hobgoblin"]
+	path = src/device.hobgoblin
+	url = https://github.com/harp-tech/device.hobgoblin

images/device-hobgoblin-pico2.png

@@ -0,0 +1,48 @@
+# Getting Started
+
+The [Harp Hobgoblin](https://github.com/harp-tech/device.hobgoblin) is a simple multi-purpose device designed for learning the fundamentals of the Harp ecosystem. The principles demonstrated in this tutorial series can also be applied to other Harp devices.
+
+![Harp Hobgoblin Pico2](../images/device-hobgoblin-pico2.png){width=300}  
+*<small>Pico2 board mounted on Gravity: Expansion Board</small>*
+
+> [!NOTE]
+> The `Hobgoblin` can be interfaced with a variety of input and output modules using the [Gravity: Expansion Board](https://www.dfrobot.com/product-2393.html). For more information on how to assemble the board, along with recommended sensor kits, refer to the resources in the [harp-tech/device.hobgoblin](https://github.com/harp-tech/device.hobgoblin) repository.
+
+## Installation
+
+- Install [Bonsai](https://bonsai-rx.org/docs/articles/installation.html).
+- Install the `Harp.Hobgoblin` package by searching for it in the [Bonsai package manager](https://bonsai-rx.org/docs/articles/packages.html).
+
+## Flashing the firmware
+
+- Download the latest version of the [firmware](https://github.com/harp-tech/device.hobgoblin/releases/) that matches your Pico board.
+- Press-and-hold the Pico `BOOTSEL` button while you connect the device to your computer's USB port. The Pico will be mounted as a new flash drive.
+- Drag-and-drop the `.uf2` file into the drive.
+
+## Testing the device
+
+:::workflow
+![Hobgoblin Hello World](~/workflows/hobgoblin-helloworld.bonsai)
+:::
+
+- Connect a push button to analog input channel `0` (`GP26`) on the `Hobgoblin`.
+- Set the `PortName` property of the [`Hobgoblin`](xref:Harp.Hobgoblin.Device) operator to the communications port of the `Hobgoblin` (e.g. COM7).
+- Run the workflow and double-click the output of `AnalogInput0`. The value should change when the push button is pressed.
+
+## Installing harp-python
+
+The [harp-python](../articles/python.md) library provides a low-level interface to read and manipulate data from Harp devices. You can create a Python environment with `harp-python` using [`uv`](https://docs.astral.sh/uv/):
+
+- Install [`uv`](https://docs.astral.sh/uv/).
+- Create a new folder for the project.
+- Navigate to the folder and initialize a new environment:
+
+```cmd
+uv venv
+```
+
+- Install `harp-python` as a dependency:
+
+```cmd
+uv pip install harp-python 
+```

src/device.hobgoblin

@@ -0,0 +1,2 @@
+- name: Harp Hobgoblin
+- href: hobgoblin-setup.md

tutorials/hobgoblin-setup.md

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<WorkflowBuilder Version="2.8.5"
+                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                 xmlns:p1="clr-namespace:Harp.Hobgoblin;assembly=Harp.Hobgoblin"
+                 xmlns:harp="clr-namespace:Bonsai.Harp;assembly=Bonsai.Harp"
+                 xmlns="https://bonsai-rx.org/2018/workflow">
+  <Workflow>
+    <Nodes>
+      <Expression xsi:type="Combinator">
+        <Combinator xsi:type="p1:Device">
+          <harp:OperationMode>Active</harp:OperationMode>
+          <harp:OperationLed>On</harp:OperationLed>
+          <harp:DumpRegisters>true</harp:DumpRegisters>
+          <harp:VisualIndicators>On</harp:VisualIndicators>
+          <harp:Heartbeat>Disabled</harp:Heartbeat>
+          <harp:IgnoreErrors>false</harp:IgnoreErrors>
+          <harp:PortName>COM7</harp:PortName>
+        </Combinator>
+      </Expression>
+      <Expression xsi:type="p1:Parse">
+        <harp:Register xsi:type="p1:AnalogData" />
+      </Expression>
+      <Expression xsi:type="MemberSelector">
+        <Selector>AnalogInput0</Selector>
+      </Expression>
+    </Nodes>
+    <Edges>
+      <Edge From="0" To="1" Label="Source1" />
+      <Edge From="1" To="2" Label="Source1" />
+    </Edges>
+  </Workflow>
+</WorkflowBuilder>