Guida al montaggio di OpenManipulator-X
Braccio robotico modulare di ROBOTIS con servo DYNAMIXEL e supporto completo per ROS 2 e MoveIt
Licenza
Apache-2.0
Guida al montaggio
1. Prima di iniziare
Cosa pubblica ROBOTIS per costruire OpenMANIPULATOR-X, e cosa questa guida può e non può darti.
1.1 Leggi cosa pubblica il progetto originale
OpenMANIPULATOR-X arriva come parti da montare, e ROBOTIS ne pubblica il montaggio come manuale PDF e video anziché come passaggi testuali.
- ROBOTIS fornisce OpenMANIPULATOR-X (RM-X52-TNM) come parti da montare nella confezione.
- Per l'assemblaggio meccanico, ROBOTIS pubblica un PDF intitolato Assembly Manual for OpenMANIPULATOR-X e un video di assemblaggio. Non pubblica l'assemblaggio giunto per giunto in forma di testo.
- Questa guida quindi non fornisce passi di assemblaggio giunto per giunto. Costruite il braccio seguendo il manuale PDF e il video, e usate l'elenco delle parti nella sezione successiva per controllare il contenuto della scatola.
- ROBOTIS pubblica anche i file CAD 3D delle parti, su Onshape e Thingiverse, per chi vuole modificarle o stamparle.
- Al momento della stesura di questa guida, il link per scaricare il manuale PDF restituiva una pagina di errore invece del file, quindi il manuale non ha potuto essere letto per questa guida. Il video di assemblaggio non ha commento parlato e non è stato possibile verificarlo passo per passo.
2. Parti e attrezzi
L'elenco delle parti come lo fornisce ROBOTIS, per controllare la confezione prima di iniziare.
2.1 Controlla le parti del telaio
Conta link frame, rail bracket, palm gripper, link rod, flange bush, crank arm, rail block e staffe FR12 rispetto all'elenco ROBOTIS.
- LINK FRAME(LONG): 1.
- LINK FRAME(SHORT): 1.
- RAIL BRACKET(LEFT): 1.
- RAIL BRACKET(RIGHT): 1.
- PALM GRIPPER: 2.
- LINK ROD: 2.
- FLANGE BUSH: 4.
- CRANK ARM: 1.
- RAIL BLOCK: 2.
- FR12-S101-K: 1. FR12-S102-K: 2. FR12-H101-K: 2. FR12-H104-K: 1.
2.2 Controlla attuatori e cavi
Conta cinque attuatori XM430-W350-T e i cavi CABLE-X3P rispetto all'elenco ROBOTIS.
- XM430-W350-T: 5.
- CABLE-X3P-100: 1.
- CABLE-X3P-180: 2.
- CABLE-X3P-240: 2.
2.3 Controlla viti, dadi, rinvii e cuscinetti
Conta gli elementi di fissaggio e le parti dei rinvii elencati sotto Miscellaneous.
- X-SP: 24.
- NUT-M2.5: 16. NUT-M3: 4.
- FHS-M2.5x14: 12.
- WB-M2x3: 38. WB-M2x4: 4.
- WB-M2.5x4: 4. WB-M2.5x6: 8. WB-M2.5x8: 16. WB-M2.5x12: 4. WB-M2.5x17: 4. WB-M2.5x20: 4.
- WB-M3x10: 4.
- DC12-IDLER: 3. DC12-IDLER-CAP: 3. DC12-P-BEARING: 3.
- RUBBER PAD: 2.
2.4 Raccogli gli attrezzi
ROBOTIS indica un cacciavite e tre chiavi come attrezzi per il montaggio.
- Cacciavite: 1.
- Wrench-1.5: 1. Wrench-2.0: 1. Wrench-2.5: 1.
2.5 Decidi sulle parti facoltative
ROBOTIS elenca come facoltativi, non come parte del braccio, un alimentatore, una scheda controller, un'interfaccia U2D2 con la sua power hub board e una piastra di base.
- Parti opzionali, una per tipo: SMPS 12V5A, OpenCR, U2D2, U2D2 Power Hub Board, Base Plate-02.
- La pagina di panoramica di ROBOTIS precisa che la piastra di base non è inclusa nella confezione.
- Per collegare il braccio serve un OpenCR oppure un U2D2 con la relativa power hub board, più un alimentatore da 12 V, per eseguire la guida rapida nelle sezioni successive.
3. Montaggio meccanico
Costruzione del braccio dal manuale e dal video di ROBOTIS.
3.1 Monta il braccio seguendo il manuale ROBOTIS
Segui il manuale PDF e il video di montaggio di ROBOTIS, perché non sono pubblicati passaggi testuali.
- Usate il PDF Assembly Manual for OpenMANIPULATOR-X e il video di assemblaggio collegati dalla pagina Assembly di ROBOTIS.
- Il progetto originale non indica misure delle viti, posizioni dei tenditori né ordine dei giunti in alcun documento di testo consultabile, quindi qui non ne vengono riportati.
- Usate l'elenco della minuteria nella sezione precedente per verificare di avere tutte le viti e i dadi richiesti dal manuale.
4. Impostazioni dei servo e alimentazione
Gli ID dei servo, il baud rate, la tensione di alimentazione e la posa iniziale che ROBOTIS indica per un braccio funzionante.
4.1 Controlla gli ID e il baud rate dei DYNAMIXEL
ROBOTIS indica come ID predefiniti da 11 a 15 per i giunti da 1 a 4 e la pinza, tutti a 1 Mbps.
- La configurazione DYNAMIXEL predefinita di ROBOTIS per la catena OpenMANIPULATOR-X è: giunto 1, ID 11. Giunto 2, ID 12. Giunto 3, ID 13. Giunto 4, ID 14. Pinza, ID 15. Baud rate 1 Mbps per tutti e cinque.
- ROBOTIS presenta questa tabella come avvertenza con queste parole: se avete un manipolatore personalizzato, fate riferimento alla configurazione DYNAMIXEL predefinita qui sotto per la catena OpenMANIPULATOR-X.
- Non rinumerate i servo da 1 a 5. La descrizione hardware ROS 2 di OpenMANIPULATOR-X elenca i cinque attuatori come ID 11, 12, 13, 14 e 15 con baud_rate 1000000, e la libreria Arduino di OpenCR imposta da joint1_id = 11 a gripper_id = 15 sotto il commento Use Default OpenMANIPULATOR-X ID setting.
- I documenti ROBOTIS consultati per questa guida non dicono come si impostano gli ID sui servo, né se i servo del kit arrivano con gli ID già impostati.
4.2 Usa un alimentatore da 12 V
Il braccio è specificato per un ingresso a 12 V, e ROBOTIS consiglia il suo SMPS 12V 5A PS-10.
- Le specifiche indicano per OpenMANIPULATOR-X una tensione di ingresso di 12 V.
- La guida rapida consiglia come alimentatore il ROBOTIS SMPS 12V 5A PS-10.
- La pagina del DYNAMIXEL XM430-W350-T indica una tensione di ingresso di 10.0 ~ 14.8 [V] (consigliata: 12.0 [V]).
4.3 Porta ogni giunto nella posa iniziale
ROBOTIS avverte che il braccio potrebbe non avviarsi se un giunto è fuori dal suo intervallo quando viene alimentato, quindi imposta prima la posa a mano.
- Prima di mettere in funzione il braccio, controllate la posizione di ogni giunto. ROBOTIS avverte che il braccio potrebbe fermarsi, o non avviarsi, se un giunto è fuori dal campo consentito.
- Con la coppia dei DYNAMIXEL non attivata, muovete a mano ogni giunto in modo che corrisponda all'immagine della posa ideale nella guida rapida di ROBOTIS.
4.4 Collega il controller, gli attuatori e l'alimentazione
Collega il braccio a un OpenCR o a un U2D2 con la sua power hub board, aggiungi l'alimentazione a 12 V, accendi e controlla i LED.
- Con un OpenCR: collegate l'OpenCR al PC con un cavo micro USB, collegate gli attuatori DYNAMIXEL di OpenMANIPULATOR-X all'OpenCR e alimentate l'OpenCR a 12 V.
- Con un U2D2: collegate al U2D2 e alla power hub board del U2D2 il micro USB verso il PC, gli attuatori DYNAMIXEL e l'alimentazione a 12 V. Per i collegamenti dettagliati ROBOTIS rimanda all'e-Manual del U2D2 e all'e-Manual della power hub board del U2D2.
- Accendete l'interruttore di alimentazione e verificate che tutti i LED dei DYNAMIXEL lampeggino una volta.
- ROBOTIS descrive gli attuatori come collegati in daisy chain su un bus multidrop a livello TTL. Nelle pagine consultate non indica l'ordine dei cavi uno per uno.
5. Controllo con Arduino e OpenCR (senza ROS)
Il percorso di ROBOTIS per far funzionare il braccio da un OpenCR 1.0 programmato nell'Arduino IDE, con una GUI in Processing.
5.1 Configura l'IDE Arduino per OpenCR
Installa l'IDE Arduino e il supporto per la scheda OpenCR, seguendo l'e-Manual ROBOTIS OpenCR 1.0.
- ROBOTIS precisa che questo percorso con Arduino non richiede ROS. L'OpenCR diventa il controller principale.
- Installate l'IDE Arduino e configurate l'ambiente di sviluppo OpenCR seguendo l'e-Manual di OpenCR 1.0 per Windows, Linux o Mac.
- ROBOTIS avverte che il board manager di OpenCR non supporta l'IDE Arduino su SBC basati su ARM come Raspberry Pi o NVidia Jetson.
5.2 Carica l'esempio open_manipulator_chain
Apri l'esempio Chain nell'IDE Arduino e caricalo sull'OpenCR via micro USB.
- Collegate l'OpenCR al PC con un cavo micro USB.
- Nell'IDE Arduino aprite Examples > OpenManipulator > example > Chain > open_manipulator_chain.
- Caricate l'esempio sull'OpenCR. Al termine del caricamento, nella finestra di output compare un messaggio.
- Se il caricamento non riesce, usate la modalità di ripristino: tenete premuto il pulsante PUSH SW2, premete il pulsante Reset, rilasciate il pulsante Reset, poi rilasciate il pulsante PUSH SW2. Il LED STATUS dell'OpenCR lampeggerà quindi periodicamente.
5.3 Installa la GUI Processing
Installa Processing 3.5.4 con la libreria ControlP5 e scarica il sorgente Processing di OpenMANIPULATOR.
- Scaricate e installate Processing. ROBOTIS ha testato il codice sorgente in Processing v3.5.4.
- In Processing scegliete Tools > Add Tool.., aprite la scheda Libraries, cercate ControlP5 e installatelo.
- Scaricate il sorgente open_manipulator_processing da ROBOTIS-GIT su GitHub, come zip oppure con git clone.
5.4 Esegui la GUI Processing
Collega il braccio, premi il pulsante Reset dell'OpenCR per attivare la coppia ed esegui Chain.pde.
- L'OpenCR 1.0 deve essere collegato a OpenMANIPULATOR-X prima di avviare Processing.
- Collegate l'OpenCR al PC con un cavo micro USB, collegate OpenMANIPULATOR-X all'OpenCR e alimentate l'OpenCR a 12 V. Accendete l'interruttore di alimentazione dell'OpenCR.
- Premete il pulsante Reset dell'OpenCR 1.0 e verificate che la coppia di OpenMANIPULATOR-X sia attivata, cosa che si riconosce dai giunti rigidi.
- In Processing aprite open_manipulator_processing > Chain > Chain.pde ed eseguitelo. Viene quindi visualizzata l'interfaccia grafica.
- Se la console di Processing mostra un errore e l'interfaccia grafica non si avvia, ROBOTIS consiglia di verificare che ControlP5, il driver grafico e la libreria Java siano installati correttamente.
6. Controllo con ROS 2 (Jazzy)
Il percorso di ROBOTIS per far funzionare il braccio da un PC con ROS 2 Jazzy, usando Docker o un'installazione sull'host.
6.1 Scegli la versione di ROS
ROBOTIS documenta ROS 2 Jazzy, ROS 2 Humble e ROS Noetic; questa sezione segue Jazzy.
- ROS 2 Jazzy è supportato su Ubuntu 24.04. Per Jazzy ROBOTIS consiglia Docker.
- ROS 2 Humble è supportato su Ubuntu 22.04 e ROS Noetic su Ubuntu 20.04. Docker è supportato per Jazzy e Humble, non per Noetic.
- Per Humble i nomi dei pacchetti ROBOTIS sono diversi. Ad esempio, la pagina di Humble esegue ros2 run open_manipulator_x_bringup create_udev_rules mentre quella di Jazzy esegue ros2 run open_manipulator_bringup om_create_udev_rules. Usate la scheda della guida rapida ROBOTIS per la vostra versione di ROS.
6.2 Configura l'ambiente Docker
Installa Docker Engine, clona il branch jazzy di open_manipulator e avvia il container.
- Seguite la guida ufficiale di installazione di Docker per Ubuntu e i relativi passi post-installazione: installate Docker Engine con il metodo del repository, aggiungete il vostro utente al gruppo docker, abilitate l'avvio di Docker all'accensione e verificate con docker run hello-world.
- Eseguite: git clone -b jazzy https://github.com/ROBOTIS-GIT/open_manipulator.git e poi cd open_manipulator.
- Avviate il container con ./docker/container.sh start ed entrateci con ./docker/container.sh enter. ./docker/container.sh help mostra i comandi.
- Avvertenza di ROBOTIS: ./docker/container.sh stop rimuove il container e tutti i dati al suo interno, tranne la directory mappata /workspace, quindi tenete il vostro lavoro in /workspace, che viene salvata in docker/workspace sull'host. docker restart conserva tutti i dati.
6.3 Oppure installa i pacchetti ROS 2 sull'host
Invece di Docker, aggiungi il tuo utente a dialout, clona quattro repository jazzy, compilali con colcon e crea le regole udev.
- ROS 2 Jazzy deve essere già installato. Il pacchetto è compatibile solo con ROS 2 Jazzy.
- Eseguite: sudo usermod -aG dialout $USER e poi disconnettetevi e accedete di nuovo.
- In ~/ros2_ws/src clonate il branch jazzy di ciascuno di questi repository ROBOTIS-GIT: DynamixelSDK, dynamixel_interfaces, dynamixel_hardware_interface e open_manipulator.
- In ~/ros2_ws eseguite: sudo rosdep init, rosdep update, poi rosdep install --from-paths src -y --ignore-src.
- Compilate con: colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release, poi source ~/ros2_ws/install/setup.bash.
- Create e applicate le regole udev con: ros2 run open_manipulator_bringup om_create_udev_rules
6.4 Configura l'interfaccia di comunicazione
Usa un U2D2 con la sua power hub board, oppure un OpenCR su cui è caricato l'esempio usb_to_dxl.
- Opzione 1, consigliata, U2D2: collegate come nel passo precedente, poi impostate il latency timer USB a 1 ms. Con l'ambiente Docker è già configurato. In un'installazione sull'host lo imposta ros2 run open_manipulator_bringup om_create_udev_rules, e cat /sys/bus/usb-serial/devices/ttyUSB0/latency_timer mostra il valore attuale.
- Opzione 2, OpenCR: configurate l'IDE Arduino per OpenCR, collegate l'OpenCR al PC, aprite File > Examples > OpenCR > 10.Etc > usb_to_dxl e caricatelo.
- Se il caricamento non riesce, usate la modalità di ripristino descritta nella sezione Arduino: accendete l'OpenCR, tenete premuto PUSH SW2, premete Reset, rilasciate Reset, rilasciate PUSH SW2. Il LED STATUS dovrebbe lampeggiare ogni 100ms.
6.5 Avvia il controller
Avvia open_manipulator_x.launch.py, che attiva la coppia e blocca i giunti.
- Prima impostate la posa di partenza, come nel passo precedente.
- Con un U2D2 eseguite: ros2 launch open_manipulator_bringup open_manipulator_x.launch.py
- Con un OpenCR eseguite: ros2 launch open_manipulator_bringup open_manipulator_x.launch.py port_name:=/dev/ttyACM0
- Nell'ambiente Docker eseguite questi comandi all'interno del container, dopo ./docker/container.sh enter.
- Il controller si avvia e ogni giunto di OpenMANIPULATOR-X viene bloccato (Torque On). L'output di avvio interroga gli ID da 011 a 015.