Zum Artikel

Werkzeuge installieren

Geprüft 2026-11-01

Ergebnis: Quelle und Abhängigkeiten sind installiert, der Port ist ausgewählt und die erwarteten Motoren reagieren. Führen Sie zuerst die Hardwareprüfungen durch.

1. Holen Sie sich die Quelle

Öffnen Sie ein Terminal in dem Verzeichnis, in dem Sie das Projekt behalten möchten:

macOS / Linux
git clone https://github.com/roboninecom/STS32XX-Firmware.git
cd STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb
Windows PowerShell
git clone https://github.com/roboninecom/STS32XX-Firmware.git
Set-Location STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb

Die ausgecheckte Revision entspricht dem Stand, mit dem diese Dokumentation geprüft wurde. Der Zustand „detached HEAD“ bei diesem Commit ist beabsichtigt. Wenn eine vorhandene Arbeitskopie lokale Änderungen enthält, bewahren Sie diese auf und verwenden Sie eine separate Kopie, statt deren Revision zu wechseln.

2. Abhängigkeiten installieren

Sie befinden sich jetzt im Stammverzeichnis STS32XX-Firmware. Überprüfen Sie die Interpreterversionen und installieren Sie die Tools:

macOS / Linux
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
Windows PowerShell
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

Verwenden Sie Node.js 20+ und Python 3.10+. Python-Abhängigkeiten verwenden eine separate Umgebung. Eine Aktivierung ist nicht erforderlich, da spätere Befehle den Interpreter direkt aufrufen. Windows-Anweisungen verwenden npm.cmd und erfordern keine Änderung der PowerShell-Ausführungsrichtlinie.

Überprüfen Sie: Die Installation wird ohne Fehler abgeschlossen. Wenn node, python oder py nicht verfügbar ist, installieren Sie den erforderlichen Interpreter oder korrigieren Sie den PATH. Programmieren Sie keine Firmware mit einer unvollständigen Installation.

3. Wählen Sie den Port aus

Schließen Sie den Adapter an und identifizieren Sie seinen Port mithilfe Ihres Betriebssystems. Gebräuchliche Namen sind /dev/cu.usbmodem… unter macOS, /dev/ttyUSB0 unter Linux und COM3 unter Windows. Ersetzen Sie das Beispiel:

macOS / Linux
export SERVO_PORT=/dev/ttyUSB0
Windows PowerShell
$env:SERVO_PORT = 'COM3'

Die Variable gehört zu diesem Terminal; Stellen Sie es in einem neuen Fenster erneut ein. Ersetzen Sie unter macOS das Linux-Beispiel durch den tatsächlichen Pfad /dev/cu.….

4. Entdecken Sie Motoren

Legen Sie die richtige Motorleistung an und schließen Sie andere Programme über den Port. Dieser Befehl liest Geräte; Es aktiviert weder Drehmoment noch Startbewegung:

macOS / Linux
npm run settings -- discover --port "$SERVO_PORT"
Windows PowerShell
npm.cmd run settings -- discover --port "$env:SERVO_PORT"

Die Standardbaudrate beträgt 1.000.000. Für eine andere Rate fügen Sie --baud mit dem tatsächlichen Wert hinzu und verwenden ihn in nachfolgenden Befehlen, die diese Option akzeptieren.

Überprüfen Sie: Die erkannten IDs stimmen mit den angeschlossenen Motoren überein und alle gemeldeten Alarme werden verstanden. Eine leere Liste bedeutet, dass bei der ausgewählten Baudrate keine Antworten erfolgen, kein Beweis für eine fehlerhafte Firmware. Discovery kann doppelte IDs nicht zuverlässig unterscheiden. Sehen Sie sich bei Bedarf die Verbindungsdiagnose an.

Als nächstes: Firmware sichern und programmieren. Installieren Sie den optionalen Telemetrie-Viewer, wenn Sie ihn benötigen.


Startseite der Dokumentation · Quellrevision: a995f77. Erweiterung 9.0.