ValgACE - Драйвер для Anycubic Color Engine Pro

ValgACE - модуль для Klipper, обеспечивающий полное управление устройством автоматической смены филамента Anycubic Color Engine Pro (ACE Pro).

📋 Содержание

• Описание
• Возможности
• Системные требования
• Быстрый старт
• Подключение устройства
• Документация
• Поддержка
• Благодарности

Описание

ValgACE представляет собой полнофункциональный драйвер для управления устройством Anycubic Color Engine Pro через Klipper. Драйвер обеспечивает автоматическую смену филамента между 4 слотами, управление сушкой, подачу и откат филамента, а также поддержку RFID меток.

Статус проекта

Статус: Стабильная версия
Подтверждено на: Creality K1, Kingroon KLP1, Kingroon KP3S Pro V2, custom klipper 3d printers. Основан на: DuckACE и BunnyACE

Возможности

✅ Управление филаментом

• Автоматическая смена инструмента (4 слота)
• Подача и откат филамента с настраиваемой скоростью
• Автоматическая парковка филамента к соплу
• Режим бесконечной катушки (infinity spool) с настраиваемым порядком слотов

✅ Управление сушкой

• Программируемая сушка филамента
• Контроль температуры и времени
• Автоматическое управление вентиляторами

✅ Информационные функции

• Мониторинг состояния устройства
• Информация о филаменте (RFID)
• Отладочные команды

✅ Интеграция с Klipper

• Полная поддержка макросов G-code
• Асинхронная обработка команд
• Совместимость с существующими конфигурациями

✅ REST API через Moonraker

• Получение статуса ACE через HTTP API
• Выполнение команд через REST эндпоинты
• WebSocket подписка на обновления статуса

Системные требования

• Klipper - свежая установка (рекомендуется)
• Python 3 - для работы модуля
• pyserial - библиотека для работы с последовательным портом
• USB-соединение - для подключения к ACE Pro

Поддерживаемые принтеры

• ✅ Creality K1 / K1 Max
• ⚠️ Другие принтеры с Klipper (требует тестирования)

Быстрый старт

1. Установка

# Клонируем репозиторий
git clone https://github.com/agrloki/ValgACE.git
cd ValgACE

# Запускаем установку
./install.sh

2. Настройка

Добавьте в printer.cfg:

[include ace.cfg]

3. Проверка подключения

ACE_STATUS
ACE_DEBUG METHOD=get_info

Подключение устройства

Pinout разъема

Устройство ACE Pro подключается через разъем Molex к стандартному USB:

Распиновка разъема:

• 1 - None (VCC, не требуется для работы, ACE обеспечивает собственное питание)
• 2 - Ground (Земля)
• 3 - D- (USB Data-)
• 4 - D+ (USB Data+)

Подключение: Подключите разъем Molex к обычному USB кабелю - никаких дополнительных манипуляций не требуется.

Подробнее см. Руководство по установке.

Документация

Полная документация доступна в папке docs/:

Русская документация:

• Установка - подробное руководство по установке
• Руководство пользователя - как использовать ValgACE
• Справочник команд - все доступные команды G-code
• Конфигурация - настройка параметров
• Решение проблем - типичные проблемы и решения
• Протокол - техническая документация протокола (English)
• Протокол (русский) - техническая документация протокола
• Moonraker API - интеграция с Moonraker API и REST эндпоинты

English Documentation:

• Installation - detailed installation guide
• User Guide - how to use ValgACE
• Commands Reference - all available G-code commands
• Configuration - parameter configuration
• Troubleshooting - common issues and solutions
• Protocol - technical protocol documentation (English)
• Moonraker API - Moonraker API integration and REST endpoints (Russian)

Основные команды

# Получить статус устройства
ACE_STATUS

# Смена инструмента
ACE_CHANGE_TOOL TOOL=0    # Загрузить слот 0
ACE_CHANGE_TOOL TOOL=-1   # Выгрузить филамент

# Парковка филамента
ACE_PARK_TO_TOOLHEAD INDEX=0

# Управление подачей
ACE_FEED INDEX=0 LENGTH=50 SPEED=25
ACE_RETRACT INDEX=0 LENGTH=50 SPEED=25

# Сушка филамента
ACE_START_DRYING TEMP=50 DURATION=120
ACE_STOP_DRYING

# Режим бесконечной катушки
ACE_SET_INFINITY_SPOOL_ORDER ORDER="0,1,2,3"  # Установить порядок слотов
ACE_INFINITY_SPOOL  # Автоматическая смена при окончании филамента

Полный список команд см. в Справочнике команд.

REST API

После установки доступны REST API эндпоинты через Moonraker:

# Получить статус ACE
curl http://localhost:7125/server/ace/status

# Получить информацию о слотах
curl http://localhost:7125/server/ace/slots

# Выполнить команду ACE
curl -X POST http://localhost:7125/server/ace/command \
  -H "Content-Type: application/json" \
  -d '{"command":"ACE_PARK_TO_TOOLHEAD","params":{"INDEX":0}}'

Подробная документация по REST API: Moonraker API

Веб-интерфейс

Готовый веб-интерфейс для управления ACE доступен в web-interface/:

• ValgACE Dashboard - полнофункциональный веб-интерфейс с Vue.js
• Отображение статуса устройства в реальном времени
• Управление слотами филамента (загрузка, парковка, feed assist, подача, откат)
• Управление сушкой
• WebSocket подключение для обновлений в реальном времени

Быстрая установка Dashboard

# Скопируйте файлы
mkdir -p ~/ace-dashboard
cp ~/ValgACE/web-interface/ace-dashboard.* ~/ace-dashboard/

# Запустите HTTP сервер
cd ~/ace-dashboard
python3 -m http.server 8080

Откройте в браузере: http://<IP-принтера>:8080/ace-dashboard.html

Для постоянного использования рекомендуется установка через nginx — см. инструкции по установке и пример конфигурации nginx.

Файлы:

• ace-dashboard.html - основной интерфейс
• ace-dashboard.css - стили
• ace-dashboard.js - логика работы с API
• ace-dashboard-config.js - конфигурация адреса Moonraker

Поддержка

Обсуждения

• Основное обсуждение: Telegram - perdoling3d
• Общее обсуждение: Telegram - ERCFcrealityACEpro

Видео

• Демонстрация работы

GitHub

• Репозиторий: https://github.com/agrloki/ValgACE
• Issues: Используйте GitHub Issues для сообщений об ошибках

Благодарности

Отдельная благодарность @Nefelim4ag (Timofey Titovets) за помощь в разработке и направление в правильном направлении. 🙂

Проект основан на:

• DuckACE от utkabobr
• BunnyACE от BlackFrogKok

Лицензия

Проект распространяется под лицензией GNU GPL v3.