Dolly driver

Camamoto 🎬

Precision stepper motor controller with WebUSB interface for camera sliders, timelapses, and automation projects.

✨ Features

• 🌐 Browser Control: Direct WebUSB communication - no drivers needed
• 📱 Dual Interface: Standalone OLED menu + web interface
• 💾 Persistent Storage: Save up to 5 programs in EEPROM
• ⚡ Precision Control: Customizable speed (1ms to 4.3M ms per step)
• 🔄 Auto-Recovery: Graceful USB disconnection handling
• 🎯 Infinite Programs: Forward/backward motion until manually stopped
• 📊 Real-time Feedback: Live position and status updates

🚀 Quick Start

Hardware Requirements

Connections

Arduino Leonardo/Micro:
├── Pin 10 → Stepper DIR
├── Pin 16 → Stepper STEP
├── Pin 2  → Control Button (internal pullup)
├── SDA/SCL → OLED Display (I2C)
└── USB → Computer (WebUSB + Power)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/camamoto.git
   cd camamoto

2. Upload firmware:

   • Open steppper.ino in Arduino IDE
   • Install required libraries (see Setup Guide)
   • Upload to your Arduino board

3. Access web interface:

   • Serve the webusb/ folder on localhost
   • Connect via Chrome/Edge browser
   • Click "Connect Slider" to establish WebUSB connection

📖 Documentation

• 📋 Setup Guide - Hardware assembly and software installation
• 🛠 User Manual - Operating modes and program creation
• 👨‍💻 Development - Architecture and API reference
• 🔧 Troubleshooting - Common issues and solutions

💡 Use Cases

• 📹 Camera Sliders: Smooth motion for video production
• ⏱ Timelapse Photography: Ultra-slow motion over hours/days
• 🏭 Automation: Precise positioning for manufacturing
• 🎓 Education: Learn motor control and WebUSB programming
• 🔬 Research: Laboratory positioning systems

🎮 Control Modes

Standalone Mode (OLED + Button)

• Navigate stored programs with push button
• View current position and status
• Start/stop/pause program execution

WebUSB Mode (Browser Interface)

• Create and save motion programs
• Manual jog controls with custom speed
• Real-time monitoring and control
• Bulk program management

🔧 Technical Specifications

🏗 Architecture

┌─────────────────┐    ┌──────────────────┐
│   Web Browser   │◄──►│   Pro Micro      │
│   (WebUSB UI)   │    │   (Camamoto)    │
└─────────────────┘    └──────────────────┘
                                │
                        ┌───────┴───────┐
                        │ Stepper Motor │
                        │   + Driver    │
                        └───────────────┘

Modular Firmware:

• motor_control - Movement and positioning
• command_processor - WebUSB communication
• config_manager - EEPROM storage
• display_manager - OLED interface
• menu_system - Standalone navigation

🤝 Contributing

We welcome contributions! Please see our Development Guide for:

• Code architecture overview
• Building and testing procedures
• Pull request guidelines

📚 Complete Documentation

This README provides a quick overview. For comprehensive documentation:

• Setup & Installation - Hardware wiring, software installation, troubleshooting
• Features & Usage - User manual, speed control, WebUSB features
• Development - Architecture, API reference, protocol details

Start with the Documentation Index for easy navigation.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Arduino framework and WebUSB standard
• OLED support via Adafruit libraries
• Inspired by the maker community's creativity

Ready to automate your motion? Get started with the setup guide →