Skip to main content

Overview

This page documents known issues in the Open Robot Actuator Hardware project. As issues are discovered and resolved, they will be documented here.
Always check this page before starting a new build or troubleshooting an existing system.

Reporting Issues

If you encounter issues not listed here, please report them through the appropriate channels:

Common Issue Categories

Mechanical Issues

Mechanical issues typically relate to:
  • 3D printed part tolerances
  • Assembly alignment
  • Fastener specifications
  • Interface compatibility

Electrical Issues

Electrical issues typically relate to:
  • Wiring connections
  • Encoder signals
  • Motor driver configuration
  • Power supply stability

Calibration Issues

Calibration issues typically relate to:
  • Encoder index position detection
  • Joint angle offsets
  • Calibration tool alignment
  • Sensor readings

Issue Resolution Process

  1. Identify the Issue: Determine whether it’s mechanical, electrical, or software-related
  2. Check Documentation: Review the relevant build guides and specifications
  3. Verify Assembly: Ensure all components are correctly assembled
  4. Test Systematically: Isolate the problem by testing individual components
  5. Consult Community: If needed, reach out through the forum or GitHub

Contributing

If you’ve resolved an issue that should be documented here, please consider contributing:
  • Share your solution on the forum
  • Submit a pull request with documentation updates
  • Create detailed issue reports with photos and measurements

Build docs developers (and LLMs) love