Technical Docs — Standards, Architecture, CAD & Fabrication

Overview

This doc defines baseline technical standards for AiTWobo projects so teams can collaborate across chapters with consistent practices.

Hardware Standards

• Wiring discipline: color conventions, labeled connectors, strain relief
• Power safety: fuses, switch, proper gauge wires, protected LiPo storage
• Connectors: prefer XT30/XT60 for battery power, JST for signals
• Grounding: common ground rules, separate high-current paths from sensor lines
• Testing: bench-test subsystems before integration

Software Architecture

Recommended structure (works for small to large projects):

• Module separation: drivers / logic / UI / logging
• Config-driven: settings in config files (not hard-coded)
• Observability: logs, simple metrics, error handling
• Version control: Git branches + PR reviews for serious projects

ROS2 teams: define nodes, topics, and launch files clearly with diagrams and a README.

CAD & Fabrication

• CAD naming: consistent part naming and folder structure
• Material selection: print vs laser-cut vs machined
• Tolerances: plan for clearance, fasteners, and assembly
• Assembly docs: exploded views, BOM, step-by-step instructions

Integration Checklist

1. Subsystem tests complete (motors, sensors, compute, power)
2. Failsafe behavior defined (stop on error, safe shutdown)
3. Documentation complete (wiring, repo, tests)
4. Demo reproducible (another team can follow your steps)