Bras ouvert 101

Tutoriels

Un parcours organisé à travers les meilleurs matériaux OpenArm, de la communication SocketCAN à la téléopération et à l'enregistrement des données. Commencez ici, puis approfondissez les articles de recherche.

Meilleurs premiers liens

Si vous êtes nouveau sur OpenArm, commencez par ces quatre sources avant d'explorer les articles de recherche SVRC. Ils vous donnent la vérité officielle sur le fonctionnement de la pile.

Commencez ici

Documentation officielle d'OpenArm et GitHub

  • 1
    Guide du logiciel OpenArm (officiel) Description du robot, SocketCAN, intégration ROS2 et commandes avancées. L’aperçu faisant autorité avant de plonger dans les détails. Lire le guide officiel →
  • 2
    Documents de contrôle ROS2 Fichiers de lancement, faux mode matériel, configuration du contrôleur et commandes de mouvement. Lisez ceci avant de toucher au vrai matériel. Ouvrir les documents de contrôle ROS2 →
  • 3
    Documents de la bibliothèque CAN Architecture SocketCAN, disposition des classes, mode de contrôle MIT, ID de moteur, modes de rappel et synchronisation. Indispensable avant d’écrire un code de contrôle. Ouvrir la documentation CAN →
  • 4
    Dépôt principal GitHub Point d'entrée du référentiel : matériel, logiciels, problèmes et liens vers l'écosystème. Ouvrez des problèmes pour trouver des réponses aux problèmes courants. Voir GitHub →

Communication : SocketCAN et bus CAN

Comprenez comment le bras communique avant d'écrire le code de contrôle. La plupart des problèmes d'affichage sont des problèmes CAN.

Guide de recherche

Guide de configuration de SocketCAN

Vérifications de communication, mappage d'identification du moteur, trames d'erreur CAN et affichage de l'interface. La référence canonique SVRC pour les problèmes de configuration CAN.

Lire le guide → Documents officiels

Bibliothèque CAN OpenArm

Documentation complète sur l'API pour openarm_can: classes de moteurs, format de paquet de contrôle MIT, modes de rappel et configuration du délai d'attente.

Ouvrir les documents → Centre logiciel

Configuration du pilote (ce hub)

Installation du pilote CAN étape par étape : chargement du module du noyau, affichage de l'interface, vérification du candump et configuration persistante.

Afficher les étapes →
Note pratique

Ce qui compte réellement dans la pratique

Les sources les plus courantes de problèmes CAN ne sont pas une mauvaise utilisation de l'API : il s'agit du changement de mode de rappel, du réglage du délai d'attente et du mappage incohérent des ID CAN entre les moteurs après les mises à jour du micrologiciel. Vérifiez-les avant toute autre chose.

Contrôle : Modes de contrôle ROS2 et MIT

Flux de mise en place du matériel et configuration du contrôleur. Exécutez toujours du faux matériel en premier, puis du vrai matériel.

Guide de recherche

Guide de contrôle ROS2

Faux mode matériel, mise en place du matériel réel, discipline du contrôleur, options de fichier de lancement et exemples de commandes de trajectoire.

Lire le guide → Guide de recherche

Guide des gains de contrôle du MIT

Notes de réglage Kp/Kd, valeurs de départ sûres pour chaque articulation, marges de sécurité et que faire lorsque les gains provoquent une oscillation.

Lire le guide → Guide de recherche

Guide d'étalonnage et de référencement

Procédure commune de mise à zéro, séquence de référencement, vérification de l'espace de travail et modes d'échec d'étalonnage courants.

Lire le guide →
Note pratique

Moqué d'abord, réel plus tard

OpenArm prend en charge le faux mode matériel dès le départ. Validez toujours votre code de contrôle avec use_fake_hardware:=true avant de vous connecter à de vrais moteurs. Cela permet à lui seul d’éviter la plupart des incidents de dommages matériels.

Note pratique

Gains et marges de sécurité

Commencez par Kp=20, Kd=0,5 pour tous les joints. Augmentez lentement. Le guide des gains du MIT documente les valeurs maximales de sécurité par joint – le respect de ces valeurs évite la surchauffe du moteur et les contraintes mécaniques.

Précédente ← Collecte de données
Suivante Sécurité →

Discutez de ce que vous construisez

Utilisez le forum OpenArm pour poser des questions sur la configuration CAN, l'affichage de ROS2, l'étalonnage, l'enregistrement des données et les décisions de débogage.

Forum OpenArm → Bibliothèque de robotique Centre communautaire