Installer les outils

Résultat  : la source et les dépendances sont installées, le port est sélectionné et les moteurs attendus répondent. Complétez , le matériel vérifie d’abord .

1. Obtenez la source

Ouvrez un terminal dans le répertoire où vous souhaitez conserver le projet :

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

La copie du dépôt est fixée à la révision utilisée pour vérifier cette documentation. L’état « detached HEAD » sur ce commit est volontaire. Si une copie existante contient des modifications locales, conservez-la et utilisez une copie distincte au lieu de changer sa révision.

2. Installer les dépendances

Vous êtes maintenant à la racine STS32XX-Firmware. Vérifiez les versions de l’interpréteur et installez les outils :

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

Utilisez Node.js 20+ et Python 3.10+. Les dépendances Python utilisent un environnement distinct. L’activation n’est pas nécessaire car les commandes ultérieures appellent directement son interpréteur. Les instructions Windows utilisent npm.cmd et ne nécessitent pas de modification de la stratégie d’exécution PowerShell.

Contrôle  : L’installation de se termine sans erreur. Si node , python ou py n’est pas disponible, installez l’interpréteur requis ou corrigez PATH. Ne flashez pas avec une installation incomplète.

3. Sélectionnez le port

Connectez l’adaptateur et identifiez son port à l’aide de votre système d’exploitation. Les noms courants sont /dev/cu.usbmodem… sur macOS, /dev/ttyUSB0 sur Linux et COM3 sur Windows. Remplacez l’exemple :

export SERVO_PORT=/dev/ttyUSB0

$env:SERVO_PORT = 'COM3'

La variable appartient à ce terminal ; redéfinissez-le dans une nouvelle fenêtre. Sur macOS, remplacez l’exemple Linux par le chemin /dev/cu.… réel.

4. Découvrez les moteurs

Appliquez la puissance moteur correcte et fermez les autres programmes à l’aide du port. Cette commande lit les appareils ; il ne permet pas le couple ni le démarrage du mouvement :

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

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

Le débit en bauds par défaut est 1,000,000. Pour un taux différent, ajoutez --baud à la valeur réelle et utilisez-la dans les commandes suivantes acceptant cette option.

Contrôle  : les identifiants découverts du correspondent aux moteurs connectés et toutes les alarmes signalées sont comprises. Une liste vide signifie aucune réponse au débit en bauds sélectionné, et non une preuve d’un micrologiciel défectueux. Discovery ne peut pas distinguer de manière fiable les identifiants en double. Voir les diagnostics de connexion si nécessaire.

Suivant : sauvegarder et flasher . Installez la visionneuse de télémétrie en option lorsque vous en avez besoin.

Accueil de la documentation · Révision source : a995f77 . Extension 9.0 .