Adding initial HITL layout

hitl/README.md

@@ -0,0 +1,25 @@
+# Stabilizer HITL Testing
+
+This directory contains tooling required for Stabilizer hardware-in-the-loop (HITL) testing.
+
+There is a `Stabilizer` board connected at the Quartiq office that is accessible via a private HITL
+repository in order to provide secure hardware testing of the stabilizer application in a public
+repository.
+
+**Note**: In order to ensure application security, all HITL runs must first be approved by a Quartiq
+representative before execution.
+
+# Hardware Configuration
+Stabilizer is configured with an ethernet connection to a router. The router runs a DHCP server for
+the local network, and Stabilizers MAC address has been assigned to the unique host name of
+`gonnigan.ber.quartiq.de`.
+
+# HITL Workflow
+The private HITL repository does the following:
+
+1. Check out this repository
+2. Build firmware images using Cargo
+3. Program stabilizer
+4. Execute `hitl/run.sh`
+
+In order to add new HITL tests, update `run.sh` to include the necessary tests.

hitl/run.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/bash
+
+# Title:
+#   Stabilizer hardware-in-the-loop (HITL) test script.
+#
+# Description:
+#   This shell file is executed by the hardware runner in Quartiq's office to exercise the various
+#   hardware aspects of Stabilizer.
+
+# Test pinging Stabilizer. This exercises that:
+# * DHCP is functional and an IP has been acquired
+# * Stabilizer's network is functioning as intended
+# * The stabilizer application is opeerational
+ping -c 5 -W 20 gonnigan.ber.quartiq.de
+
+# Test the MQTT interface.
+python3 miniconf.py dt/sinara/stabilizer afe/0 '"G2"'