https://github.com/bobberdolle1/maixcam-servo-control
AI-powered servo control for MaixCAM with YOLOv8 object detection, color tracking and motion sensing. 30 FPS real-time processing for robotics and IoT projects
https://github.com/bobberdolle1/maixcam-servo-control
ai automation color-detection computer-vision embedded iot machine-learning maix maixcam maixpy motion-detection neural-network object-detection opencv python real-time robotics servo-control sipeed yolov8
Last synced: 22 days ago
JSON representation
AI-powered servo control for MaixCAM with YOLOv8 object detection, color tracking and motion sensing. 30 FPS real-time processing for robotics and IoT projects
- Host: GitHub
- URL: https://github.com/bobberdolle1/maixcam-servo-control
- Owner: bobberdolle1
- License: mit
- Created: 2026-05-10T13:49:09.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-10T15:00:12.000Z (about 2 months ago)
- Last Synced: 2026-05-10T15:35:48.125Z (about 2 months ago)
- Topics: ai, automation, color-detection, computer-vision, embedded, iot, machine-learning, maix, maixcam, maixpy, motion-detection, neural-network, object-detection, opencv, python, real-time, robotics, servo-control, sipeed, yolov8
- Language: Python
- Homepage: https://github.com/bobberdolle1/maixcam-servo-control
- Size: 72.3 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 MaixCAM Advanced Servo Control
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/)
[](https://wiki.sipeed.com/maixpy/)
[](https://github.com/bobberdolle1/maixcam-servo-control/releases)
[](https://github.com/bobberdolle1/maixcam-servo-control/stargazers)
**Advanced AI-powered servo control system for MaixCAM with Autonomous Ballistics, YOLOv8 object detection, color tracking, and motion sensing**
[English](#english) | [Русский](#russian)
---
### 🎯 What is this?
A **production-ready**, **AI-powered** servo control system for MaixCAM that combines:
- 🚀 **Autonomous Ballistics** - Mathematical drop physics engine for drones/RC planes
- 👁️ **Optical Flow Speed** - Automatic ground speed calculation via machine vision
- 📏 **AI Rangefinder** - Automatic altitude estimation based on target size
- 🎨 **Color Detection** - LAB color space with touchscreen calibration
- 🤖 **Object Detection** - YOLOv8 neural network (80 COCO classes + Custom)
- 🏃 **Motion Detection** - Real-time frame differencing
- 📱 **Professional Touch UI** - Full-featured Grid Menu system with large 2-line buttons
- ⚡ **High Performance** - 30 FPS @ 640x480, optimized algorithms
Perfect for **drone payload drops**, **robotics**, **automation**, **IoT projects**, and **computer vision** applications!
### ✨ Key Features
#### 🚀 Autonomous Engine (v2.5.0+)
- **Ballistics Physics** (Lead time & Distance)
- **Auto Ground Speed** (Optical flow analysis)
- **Auto Altitude** (AI bounding-box sizing)
- **Standalone App** (Boot without PC)
- **Video Recording** (H.265 toggle)
#### ⚙️ Servo Control
- **Configurable angles** (0-180°)
- **ARM/DISARM mode** for safety
- **Auto-rearm** with delay
- **Repeat trigger** mode
- **Multiple PWM pins** support
#### 📱 User Interface
- **Touchscreen Grid menu**
- **Dynamic Options** (Hides irrelevant info)
- **Real-time OSD HUD** with status
- **Live settings** adjustment
- **FPS counter** and timers
#### 🎨 Detection Modes
- **YOLOv8 Objects** (80 classes + Custom)
- **Color Detection** with 8 presets
- **Motion Detection**
- **Custom Color Calibration**
### 📦 What's Included
```
📁 Project Structure
├── 🎯 advanced_servo_app.py # Main application (full-featured)
├── 📂 examples/ # Example applications
│ ├── simple_servo_app.py # Minimal version for quick start
│ ├── color_servo_app.py # Color detection example
│ └── ... # More examples
├── 🛠️ utils/ # Utility scripts
│ ├── servo_test.py # Hardware testing
│ ├── check_pwm_pins.py # PWM pin checker
│ └── calibrate_color.py # Color calibration tool
└── 📚 docs/ # Comprehensive documentation
├── QUICKSTART.md # 5-minute setup guide
├── EXAMPLES.md # 10+ real-world use cases
└── TECHNICAL.md # Deep technical dive
```
### 🚀 Quick Start (5 minutes)
#### 1️⃣ Hardware Setup
```
Servo Signal (yellow) → A18 (configurable in UI: A14-A19)
Servo GND (brown) → GND
Servo Power (red) → VBUS 5V (2A recommended)
```
#### 2️⃣ Installation (Autonomous Execution)
No PC required after installation! The app runs entirely standalone.
1. Download the `advanced_servo_drop_v1.0.0.zip` from the [Releases](https://github.com/bobberdolle1/maixcam-servo-control/releases).
2. Use MaixVision's App Store or CLI to install the app on your MaixCAM:
```bash
app_store_cli install advanced_servo_drop_v1.0.0.zip
```
3. The app **"Servo Drop"** will now appear on your camera's touch screen launcher.
#### 3️⃣ Enable Auto-Boot (Optional)
To have the camera automatically start the app when powered by a drone/power bank:
- On the camera screen, go to **Settings** -> **Boot App**.
- Select **Servo Drop**.
#### 4️⃣ Configure (Touch UI)
- Tap the screen to open the **Menu**.
- The new **Bounding Box UI** makes selecting settings easy.
- Choose Mode (Color/Object/Motion), Pins, Angles (0-180°), and Delays.
### 🎯 Use Cases
🐾 Pet Feeder
Automatic feeding when pet detected
🎨 Color Sorter
Sort objects by color
🚨 Security
Motion-activated alerts
👥 People Counter
Count visitors/customers
🚪 Auto Door
Hands-free door opener
🎮 Gesture Control
Control devices with gestures
📸 Wildlife Camera
Trigger on animal detection
✅ Quality Control
Detect defects in production
🅿️ Parking Monitor
Track parking occupancy
### 📊 Performance Benchmarks
| Mode | Resolution | FPS | Latency | Use Case |
|----------|------------|------|---------|----------------------------|
| Color | 640x480 | ~30 | ~30ms | Fast color tracking |
| Color | 1280x720 | ~15 | ~60ms | High-accuracy detection |
| Object | 640x480 | ~20 | ~50ms | Real-time object detection |
| Motion | 640x480 | ~30 | ~30ms | Motion sensing |
### 🛠️ Requirements
- **Hardware:** MaixCAM (1st gen with screen), SG90 servo (or compatible)
- **Software:** MaixPy 4.x, YOLOv8 model (`/root/models/yolov8n.mud`)
- **Power:** 5V 2A power supply recommended
- **Tools:** MaixVision IDE for deployment
### 📚 Documentation
- 📖 [**Quick Start Guide**](docs/QUICKSTART.md) - Get started in 5 minutes
- 💡 [**Examples & Use Cases**](docs/EXAMPLES.md) - 10+ real-world scenarios
- 🔧 [**Technical Documentation**](docs/TECHNICAL.md) - Deep dive & optimization
- 📝 [**Changelog**](CHANGELOG.md) - Version history
### 🤝 Contributing
Contributions welcome! Areas for improvement:
- Face detection mode
- QR code scanning
- Multi-servo support
- Web interface
- Mobile app control
- Cloud integration
### 📄 License
MIT License - See [LICENSE](LICENSE) file
### 🔗 Links
- **Repository:** https://github.com/bobberdolle1/maixcam-servo-control
- **Issues:** https://github.com/bobberdolle1/maixcam-servo-control/issues
- **MaixPy Docs:** https://wiki.sipeed.com/maixpy/
### 🏷️ Topics
`maixcam` `maix` `sipeed` `servo-control` `yolov8` `object-detection` `color-detection` `motion-detection` `computer-vision` `ai` `machine-learning` `robotics` `automation` `iot` `embedded` `python` `opencv` `neural-network` `real-time` `edge-ai` `tinyml` `maker` `diy` `raspberry-pi-alternative` `arduino-alternative` `esp32-cam-alternative`
---
### 🎯 Что это?
**Готовая к использованию** система управления сервоприводом с **искусственным интеллектом** для MaixCAM:
- 🚀 **Автономная баллистика** - Физический движок сброса для дронов/самолетов
- 👁️ **Оптический поток** - Автоматическое вычисление путевой скорости (Optical Flow)
- 📏 **AI Дальномер** - Оценка высоты по размеру цели (YOLO Bounding Box)
- 🎨 **Детекция цвета** - LAB цветовое пространство с калибровкой
- 🤖 **Детекция объектов** - Нейросеть YOLOv8 (80 классов COCO + Custom)
- 🏃 **Детекция движения** - Анализ кадров в реальном времени
- 📱 **Сенсорный UI** - Профессиональное меню (Сетка) с большими кнопками
- ⚡ **Высокая производительность** - 30 FPS @ 640x480
Идеально для **сброса грузов с дрона**, **робототехники**, **автоматизации**, **IoT проектов** и **компьютерного зрения**!
### ✨ Основные возможности
#### 🚀 Автономность (v2.5.0+)
- **Баллистика** (Упреждение и Дистанция)
- **Авто-скорость** (Анализ оптического потока)
- **Авто-высота** (Оценка по размеру цели)
- **Автозапуск** (Boot-приложение без ПК)
- **Запись видео** (Тумблер H.265)
#### ⚙️ Управление сервой
- **Настраиваемые углы** (0-180°)
- **Режим ARM/DISARM** для безопасности
- **Авто-реарм** с задержкой
- **Режим повтора** срабатывания
- **Поддержка пинов** A14-A19
#### 📱 Интерфейс
- **Новое Grid меню** (Сетка)
- **Динамические настройки**
- **HUD OSD с подложкой**
- **Настройки на лету**
- **Счетчик FPS** и таймеры
#### 🎨 Режимы детекции
- **YOLOv8** (80 классов + Custom)
- **Детекция цвета** с 8 пресетами
- **Детекция движения**
- **Калибровка цвета** через тачскрин
- **Несколько разрешений** (320x240 до 1280x720)
### 📦 Что входит
```
📁 Структура проекта
├── 🎯 advanced_servo_app.py # Основное приложение
├── 📂 examples/ # Примеры приложений
│ ├── simple_servo_app.py # Упрощенная версия
│ ├── color_servo_app.py # Пример детекции цвета
│ └── ... # Другие примеры
├── 🛠️ utils/ # Утилиты
│ ├── servo_test.py # Тест оборудования
│ ├── check_pwm_pins.py # Проверка PWM пинов
│ └── calibrate_color.py # Калибровка цвета
└── 📚 docs/ # Документация
├── QUICKSTART.md # Быстрый старт
├── EXAMPLES.md # Примеры использования
└── TECHNICAL.md # Техническая документация
```
### 🚀 Быстрый старт (5 минут)
#### 1️⃣ Подключение
```
Servo Signal (желтый) → A18 (настраивается в UI: A14-A19)
Servo GND (коричневый) → GND
Servo Power (красный) → VBUS 5V (рекомендуется 2A)
```
#### 2️⃣ Установка (Автономный запуск)
ПК для работы больше не нужен! Приложение устанавливается прямо в систему камеры.
1. Скачайте `advanced_servo_drop_v1.0.0.zip` из раздела [Releases](https://github.com/bobberdolle1/maixcam-servo-control/releases).
2. Используйте App Store в MaixVision или CLI для установки:
```bash
app_store_cli install advanced_servo_drop_v1.0.0.zip
```
3. Приложение **"Servo Drop"** появится в главном меню на экране камеры.
#### 3️⃣ Автозапуск (Опционально)
Чтобы камера сама запускала скрипт при подаче питания от повербанка/дрона:
- На экране камеры зайдите в **Settings** -> **Boot App**.
- Выберите **Servo Drop**.
#### 4️⃣ Настройка (Сенсорный экран)
- Коснитесь экрана для открытия **Меню**.
- Новый UI с **болькими кнопками** позволяет легко нажимать пункты.
- Выберите режим, пины, углы (0-180°) и задержки.
### 🎯 Примеры использования
🐾 Кормушка для питомцев
Автоматическая кормушка
🎨 Сортировщик
Сортировка по цвету
🚨 Безопасность
Детектор движения
👥 Счетчик людей
Подсчет посетителей
🚪 Авто-дверь
Открывание без рук
🎮 Жесты
Управление жестами
📸 Камера для животных
Съемка дикой природы
✅ Контроль качества
Детекция дефектов
🅿️ Парковка
Мониторинг мест
### 📊 Производительность
| Режим | Разрешение | FPS | Задержка | Применение |
|----------|------------|------|----------|----------------------------|
| Цвет | 640x480 | ~30 | ~30ms | Быстрое отслеживание |
| Цвет | 1280x720 | ~15 | ~60ms | Высокая точность |
| Объект | 640x480 | ~20 | ~50ms | Детекция в реальном времени|
| Движение | 640x480 | ~30 | ~30ms | Датчик движения |
### 🛠️ Требования
- **Железо:** MaixCAM (1-го поколения с экраном), серва SG90 (или аналог)
- **ПО:** MaixPy 4.x, модель YOLOv8 (`/root/models/yolov8n.mud`)
- **Питание:** Блок питания 5V 2A (рекомендуется)
- **Инструменты:** MaixVision IDE для загрузки
### 📚 Документация
- 📖 [**Быстрый старт**](docs/QUICKSTART.md) - Начните за 5 минут
- 💡 [**Примеры**](docs/EXAMPLES.md) - 10+ реальных сценариев
- 🔧 [**Техническая документация**](docs/TECHNICAL.md) - Глубокое погружение
- 📝 [**История изменений**](CHANGELOG.md) - Версии и обновления
### 🤝 Участие в разработке
Приветствуются любые улучшения:
- Детекция лиц
- Сканирование QR кодов
- Поддержка нескольких серв
- Веб-интерфейс
- Мобильное приложение
- Облачная интеграция
### 📄 Лицензия
MIT License - См. файл [LICENSE](LICENSE)
### 🔗 Ссылки
- **Репозиторий:** https://github.com/bobberdolle1/maixcam-servo-control
- **Проблемы:** https://github.com/bobberdolle1/maixcam-servo-control/issues
- **Документация MaixPy:** https://wiki.sipeed.com/maixpy/
### 🏷️ Теги
`maixcam` `maix` `sipeed` `управление-сервой` `yolov8` `детекция-объектов` `детекция-цвета` `детекция-движения` `компьютерное-зрение` `искусственный-интеллект` `машинное-обучение` `робототехника` `автоматизация` `интернет-вещей` `встраиваемые-системы` `python` `opencv` `нейросеть` `реальное-время` `edge-ai` `tinyml` `мейкер` `diy`
---
### ⭐ Star this project if you find it useful!
**Made with ❤️ for the maker community**
[⬆ Back to top](#-maixcam-advanced-servo-control)