Skip to the content
2 layers140 × 70 mmArtemis harness tester, the printed circuit board in 3D

Production-grade cable harness tester using SparkFun Artemis ATP for P3/P1/P2 assemblies with automated continuity, resistance, leakage, and zener tests

Size
140 × 70 mm
Copper layers
2
Thickness
1.6 mm
Parts
29
Nets
43
Pads
88
Tracks, vias
0, 0
Routed
Not yet
KiCad
KiCad 6 (file 20211014)
Created
22 Dec 2025
Updated
6 Apr 2026

Overview

Artemis harness tester is an open-source printed circuit board by PlanBRandom, from the PlanBRandom/artemis-harness-tester repository on GitHub. It is a 2-layer board of 140 × 70 mm with 29 parts on 43 nets.

Its parts include 1 IC and 1 connector.

README

README.md

Artemis Harness Tester

Production-grade 21-channel cable harness tester for SparkFun Artemis ATP fixtures.

Features

  • Auto-generated 21x21 connectivity matrix from a simple netlist
  • Open, short, and crosstalk detection
  • Per-channel resistance measurement with JSON output
  • Profile-based limits for automated pass/fail checks
  • Python CLI, live dashboard, and CSV viewer tools

Quick Start

Firmware

  1. Open firmware/harness_tester.ino in Arduino IDE, or build from platformio.ini.
  2. Install SparkFun Artemis board support.
  3. Flash the firmware to the Artemis ATP.
  4. Open a serial terminal at 115200 baud.

PC tools

bash
cd pc-tools
pip install -r requirements.txt
python tester_cli.py --port COM5 selftest

Repository Layout

text
firmware/      Firmware modules and entry points
pc-tools/      Python tools for CLI, dashboard, and CSV viewing
hardware/      KiCad design files, diagrams, and notes
profiles/      Example profile data
docs/          Assembly and validation notes
tests/         Basic test coverage

Core Model

The tester is built around two source files:

  • firmware/channels.h: channel index to physical pin mapping
  • firmware/nets.h: channel index to expected net assignment

The firmware derives the expected matrix from nets.h, measures the actual matrix from hardware, then compares both to flag opens, shorts, and unexpected couplings.

PC Tools

  • pc-tools/tester_cli.py: command-line access to MEASURE, MATRIX, PROFILE, SELFTEST, and CALIBRATE
  • pc-tools/live_dashboard.py: live serial console with matrix visualization
  • pc-tools/harness_viewer.py: capture CSV matrix output from the serial stream
  • pc-tools/harness_gui.py: simple CSV viewer
  • pc-tools/harness_web.py: lightweight upload-and-view web UI

Hardware Assets

  • KiCad schematic: hardware/kicad/artemis_harness_tester.kicad_sch
  • KiCad PCB: hardware/kicad/artemis_harness_tester.kicad_pcb
  • Wiring diagram: hardware/diagrams/ascii_wiring_diagram.txt
  • Validation notes: WIRECHECK.md

Development Notes

  • AGENT.md describes the safe extension boundaries for firmware and tools.
  • ARCHITECTURE.md explains the modular firmware structure and command protocol.
  • QUICKSTART.md covers bring-up, serial commands, and troubleshooting.

License

MIT. See LICENSE.

MIT License (see LICENSE file)


🤖 AI Coding Agent Notes

This repo is structured to be AI-friendly:

  • Modular headers
  • Clear separation of concerns
  • Predictable naming
  • Explicit task list (see TASKS.md)
  • Roadmap for future expansion (see ROADMAP.md)

Agents may safely:

  • Add new test modules
  • Extend PC tools
  • Add GUIs or dashboards
  • Add calibration routines
  • Add new harness profiles

Agents should NOT:

  • Modify channels.h or nets.h without explicit instruction
  • Break the matrix API
  • Remove CSV/JSON markers

📄 License

MIT License (see LICENSE file)


🤖 AI Coding Agent Notes

This repo is structured to be AI-friendly:

  • Modular headers
  • Clear separation of concerns
  • Predictable naming
  • Explicit task list (see TASKS.md)
  • Roadmap for future expansion (see ROADMAP.md)

Agents may safely:

  • Add new test modules
  • Extend PC tools
  • Add GUIs or dashboards
  • Add calibration routines
  • Add new harness profiles

Agents should NOT:

  • Modify channels.h or nets.h without explicit instruction
  • Break the matrix API
  • Remove CSV/JSON markers

Parts

29
QtyValueFootprintReferences
211kResistor_SMD:R_0805RDRV0, RDRV1, RDRV2, RDRV3, RDRV4, RDRV10, RDRV11, RDRV12, RDRV13, RDRV14, RDRV15, RDRV16, RDRV17, RDRV18, RDRV19, RDRV20 +5
4MOUNTMountingHole:MountingHole_3.2mmH1, H2, H3, H4
11k 1%Resistor_SMD:R_0805RREF
1Artemis_ATPSparkFun:Artemis_ATPU1
1Harness_21CHTerminalBlock_Phoenix:TerminalBlock_1x21_P5.08mmJ1
1RES_NODEPad:SMD_PadTP_RES_NODE

Similar boards

  • 2 layers52.3 × 10.5 mmStackLink, the printed circuit board in 3D

    StackLink

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    29 parts5.1kGPL-3.0
  • 2 layers56 × 20 mmHallEffectXY Endstop, the printed circuit board in 3D

    HallEffectXY Endstop

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    29 parts1.1kGPL-3.0
  • 2 layers50 × 23.2 mmAnalog, the printed circuit board in 3D

    Analog

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    29 parts1kGPL-3.0
  • 2 layers16.8 × 13.6 mmE Fidget Lite, the printed circuit board in 3D

    E Fidget Lite

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    29 parts915
  • 2 layers85 × 12.5 mmTERES PCB3-TOUCH BTN Rev.A, the printed circuit board in 3D

    TERES PCB3-TOUCH BTN Rev.A

    OLIMEX/DIY-LAPTOP

    Do It Yourself Open Source Hardware and Software Modular Hacker's Friendly Laptop

    29 parts578Apache-2.0
  • 2 layers33.7 × 97.8 mmHAN ESP TSS721, the printed circuit board in 3D

    HAN ESP TSS721

    UtilitechAS/amsreader-firmware

    ESP8266 and ESP32 compatible firmware to read, interpret and publish data to MQTT from smart electrical meters, both DLMS and DSMR is supported

    29 parts470
  • 2 layers80 × 55 mmGB CARTPP XC, the printed circuit board in 3D

    GB CARTPP XC

    Gekkio/gb-hardware

    Game Boy -related custom hardware by gekkio

    29 parts379CC-BY-4.0
  • 2 layers55 × 58 mmProto ads bee mcu board, the printed circuit board in 3D

    Proto ads bee mcu board

    PantsForBirds/adsbee

    Open Source Embedded ADS-B Receiver

    29 parts344GPL-3.0

Questions

How big is the Artemis harness tester PCB?

It measures 140 × 70 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Artemis harness tester use?

29 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Artemis harness tester KiCad files?

From the PlanBRandom/artemis-harness-tester repository on GitHub, at the commit this page was made from: the board is hardware/kicad/artemis_harness_tester.kicad_pcb and its schematic hardware/kicad/artemis_harness_tester.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Artemis harness tester design in my own project?

Its repository states no licence, so its author keeps all rights: ask PlanBRandom before reusing the design.