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
- Subsystem tests complete (motors, sensors, compute, power)
- Failsafe behavior defined (stop on error, safe shutdown)
- Documentation complete (wiring, repo, tests)
- Demo reproducible (another team can follow your steps)