Diagnostic Tools

Run automated tests to identify hardware and software issues

Built-in Diagnostic Script

The Fabrica software includes a diagnostics.pymodule that can be run from the REPL.

import diagnostics

# Run the full suite
diagnostics.run_full_check()

What it checks:

  • I2C Scan: Verifies that the PCA9685 board is reachable at address 0x40.
  • Servo Range: Moves each servo through its full calibrated range.
  • Power Rails: Checks if the power supply can maintain voltage under load.
  • Storage: Verifies that folding sequences can be saved and loaded from flash.

Reviewing Log Files

If the robot crashes, check the error.log file on the Pico's internal storage:

# In the REPL:
import os
with open('error.log', 'r') as f:
    print(f.read())

This file contains the traceback of the last 5 errors that occurred.