Установка инструментов

Результат: исходники и зависимости установлены; порт выбран; обнаружены ожидаемые моторы. Предварительно выполните проверку оборудования.

1. Получить исходники

Откройте терминал в каталоге, где хотите хранить проект:

git clone https://github.com/roboninecom/STS32XX-Firmware.git
cd STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb

git clone https://github.com/roboninecom/STS32XX-Firmware.git
Set-Location STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb

Здесь зафиксирована версия, по которой проверена документация. git checkout оставляет репозиторий на конкретном коммите; это нормально для воспроизводимого запуска. Если проект уже скачан и содержит ваши изменения, сохраните их и создайте отдельную копию вместо переключения рабочей папки.

2. Установить зависимости

Теперь вы находитесь в корне STS32XX-Firmware. Проверьте версии и установите инструменты:

node --version
python3 --version
npm ci
python3 -m venv tools/flash/.venv
tools/flash/.venv/bin/python -m pip install -r tools/flash/requirements.txt

node --version
py -3 --version
npm.cmd ci
py -3 -m venv tools/flash/.venv
.\tools\flash\.venv\Scripts\python.exe -m pip install -r tools/flash/requirements.txt

Нужны Node.js 20+ и Python 3.10+. Для Python используется отдельное окружение; активировать его не нужно, команды далее вызывают его интерпретатор напрямую. На Windows команды используют npm.cmd, поэтому не требуют изменения политики запуска PowerShell-скриптов.

Проверка: команды установки завершились без ошибок. Ошибка node/python/py означает, что нужный интерпретатор не установлен или не доступен в PATH. Не переходите к прошивке с незавершённой установкой.

3. Выбрать порт

Подключите адаптер и определите его имя средствами системы. Обычно это /dev/cu.usbmodem… в macOS, /dev/ttyUSB0 в Linux или COM3 в Windows. Пример ниже нужно заменить своим значением:

export SERVO_PORT=/dev/ttyUSB0

$env:SERVO_PORT = 'COM3'

Переменная существует в текущем терминале. В новом окне задайте её заново. В macOS замените Linux-путь в первой вкладке на свой /dev/cu.….

4. Обнаружить моторы

Включите соответствующее питание моторов, закройте другие программы на порту. Команда только читает устройства, не включает удержание и не запускает движение:

npm run settings -- discover --port "$SERVO_PORT"

npm.cmd run settings -- discover --port "$env:SERVO_PORT"

По умолчанию проверяется 1 000 000 бод. Если скорость другая, добавьте --baud с фактическим значением; этот же параметр нужен в последующих командах, принимающих --baud.

Проверка: найденные ID соответствуют подключённым моторам; сообщения об авариях разобраны. Пустой список означает отсутствие ответов на выбранной скорости, а не доказательство неисправной прошивки. Discovery не отличает надёжно два устройства с одинаковым ID. При проблеме откройте диагностику связи.

Далее: резервная копия и прошивка. Инструмент 3D-просмотра устанавливается отдельно, когда понадобится телеметрия.

Главная раздела · Версия исходников: a995f77. Extension 9.0.