Switch controlling step driver to serial interface

This commit is contained in:
2026-07-07 05:31:54 +07:00
parent 2c4aae9523
commit 15645f7d25
8 changed files with 473 additions and 282 deletions

View File

@@ -1,66 +1,36 @@
# MQTT Топики для управления двигателем
# MQTT Топики для управления двигателем и обратной связи
## Общая информация
Система использует MQTT протокол для обмена данными между ESP32 и центральным сервером. Все топики разделены на два типа:
- **Управление** (`motor/control/...`) - для отправки команд
- **Обратная связь** (`motor/feedback/...`) - для получения статуса
## Подписка (от клиента к устройству)
## Управление
### Основное управление
- `motor/control/rpm` - Установка целевой скорости в об/мин (положительное значение - вперед, отрицательное - назад)
- `motor/control/totalsteps/reset` - Сброс счетчика шагов
### 1. Команды управления
- **`motor/control/command`**
- Возможные значения: `start`, `stop`
- Описание: Запуск или остановка двигателя
### Управление TMC (настройки двигателя)
- `motor/control/tmc/current_percent` - Установка текущего тока в процентах (0-100)
- `motor/control/tmc/microsteps` - Установка микрокроков (1, 2, 4, 8, 16, 32, 64, 128, 256)
- `motor/control/tmc/stallguard` - Включение/выключение StallGuard (0-255)
- `motor/control/tmc/enable` - Включение/выключение двигателя ("on"/"off")
- `motor/control/tmc/stealthchop` - Включение/выключение бесшумного режима. ("on"/"off")
- `motor/control/tmc/coolstep` - Включение/выключение режима динамического снижение тока при малой нагрузке("on"/"off")
### 2. RPM (обороты в минуту)
- **`motor/control/rpm`**
- Тип данных: Целое число
- Описание: Установка целевого значения оборотов в минуту
## Публикация (от устройства к клиенту)
### 3. Шаги в секунду
- **`motor/control/step_per_sec`**
- Тип данных: Целое число
- Описание: Установка целевого значения шагов в секунду
### Базовая телеметрия
- `motor/feedback/rpm` - Текущая скорость в об/мин
- `motor/feedback/totalsteps` - Общее количество шагов
- `motor/feedback/is_run` - Статус работы двигателя ("true"/"false")
### 4. Состояние драйвера
- **`motor/control/driver`**
- Возможные значения: `turnon`, `turnoff`
- Описание: Включение или выключение драйвера двигателя
### TMC Телеметрия
- `motor/feedback/tmc/current_percent` - Текущий ток в процентах
- `motor/feedback/tmc/microsteps` - Текущие микрокроки
- `motor/feedback/tmc/sg_result` - Результат StallGuard
- `motor/feedback/tmc/interstep_duration` - Длительность интервала шага (в наносекундах)
### 5. Сброс общего количества шагов
- **`motor/control/totalsteps/reset`**
- Тип данных: Нет полезной нагрузки
- Описание: Сброс общего счетчика шагов
## Обратная связь
### 1. RPM (обороты в минуту)
- **`motor/feedback/rpm`**
- Тип данных: Целое число
- Описание: Текущее значение оборотов в минуту
### 2. Шаги в секунду
- **`motor/feedback/step_per_seconds`**
- Тип данных: Целое число
- Описание: Текущее значение шагов в секунду
### 3. Общее количество шагов
- **`motor/feedback/totalsteps`**
- Тип данных: Целое число
- Описание: Общее количество выполненных шагов
### 4. Состояние драйвера
- **`motor/feedback/driver`**
- Возможные значения: `on`, `off`
- Описание: Состояние драйвера (включен/выключен)
### 5. Состояние работы двигателя
- **`motor/feedback/is_run`**
- Возможные значения: `run`, `stop`
- Описание: Состояние двигателя (работает/стоит)
## Примечания
- Все числовые значения передаются в строковом формате
- Для управления драйвером используется логический уровень: LOW = включен, HIGH = выключен
- Обратная связь отправляется с интервалом не менее 200 мс
- Система автоматически обрабатывает плавный разгон/торможение при изменении скорости
### Статусы TMC
- `motor/feedback/tmc/status/over_temp` - Предупреждение о перегреве
- `motor/feedback/tmc/status/short_to_ground` - Короткое замыкание на землю
- `motor/feedback/tmc/status/open_load` - Предупреждение о коротком замыкании
- `motor/feedback/tmc/status/stealth_chop_active` - Активен ли бесшумный режим.
- `motor/feedback/tmc/status/standstill` - Стоп-состояние
- `motor/feedback/tmc/status/current_scaling` - Масштабирование тока