MOARkNOBS-42 Hardware-Test Package

This repository is currently packaged as a hardware-test bundle for the MOARkNOBS-42 prototype. It is meant for bench validation of the current board, firmware, OLED, controls, MIDI paths, LEDs, envelope followers, WebSerial telemetry, and bridge/configurator connectivity.

It is not a public v1.0 release. It is not a fabrication-ready manufacturing package. It does not claim a verified Gerber and NC-drill release bundle.

Start with HARDWARE_TEST_README.md.

Choose Your Path

• Validating prototype hardware: start with HARDWARE_TEST_README.md, then follow docs/hardware-test/Bringup.md and docs/hardware-test/TestMatrix.md.
• Changing firmware: use firmware/README.md for PlatformIO lanes and CONTRIBUTING.md for the build/test contract.
• Using the controller musically: start with docs/getting-started/QuickstartForPerformers.md, then use docs/getting-started/GuidedRoutes.md when you want the broader docs map.
• Checking fabrication or release readiness: read hardware/CurrentBuild.md and keep the non-release caveats above in mind before treating any hardware artifacts as orderable.

Package Entry Points

• HARDWARE_TEST_README.md explains what the package is, what it is not, and the expected bring-up flow.
• docs/hardware-test/Bringup.md is the first-boot checklist.
• docs/hardware-test/TestMatrix.md lists the supported test lanes and commands.
• docs/hardware-test/KnownIssues.md records current package limits.
• docs/hardware-test/PackageManifest.md lists included and excluded lanes.
• hardware/CurrentBuild.md identifies the current hardware reference files.

Included Test Surfaces

• firmware/ for the Teensy 4.0 firmware and test environments
• hardware/ for the current schematic, PCB drawing, BOM, and hardware notes
• App/ for WebSerial configurator validation
• bridge/ for OSC and virtual MIDI bridge validation
• tools/ for link checks, bench capture, and package export

Primary Build Command

Run PlatformIO from firmware/, not the repo root:

pio run -d firmware -e teensy40_main

Hardware Reference Files Present

• Schematic PDF: hardware/MN42-machineDrawings/SCH_MOAR_Schematic_2025-08-30.pdf
• PCB/reference drawing PDF: hardware/MN42-machineDrawings/PCB_MOAR_Board_2025-09-03.pdf
• Prototype BOM export: hardware/fabrication/BOM_MOAR_MOAR_Board_2026-03-17.csv

Use those as bench-validation references only. See hardware/CurrentBuild.md for the current status notes.