Open Source Robotics

Una raccolta curata di progetti, strumenti e software di robotica open source di alta qualità per la comunità della robotica.

Guida al montaggio di LeKiwi

Manipolatore mobile olonomo a basso costo con SO-ARM101 e LeRobot

Licenza

Apache-2.0

Guida al montaggio

1. Scegli una versione e raccogli le parti

La fonte originale pubblica una distinta base in tre versioni (5V, 12V e cablata) e una nota su quale scegliere. Tutto qui proviene dal repository LeKiwi e dal repository SO-ARM100.

1.1 Scegli la versione di alimentazione

Scegli tra la versione a 5V (power bank), la versione a 12V (batteria 12v 5a) e la versione cablata prima di acquistare qualsiasi cosa.

  1. Il progetto originale offre tre opzioni per motori ed elettronica: 5V, 12V o cablata.
  2. Consiglio del progetto originale: se è la prima volta che costruisci robot, scegli la versione 5V, che è un po' più facile da montare. Se hai più esperienza e vuoi sollevare oggetti più pesanti, scegli la versione 12V. Se vuoi l'opzione più economica, scegli la versione cablata.
  3. La versione 12V usa servo Feetech ST3215 da 12v per le ruote e un convertitore da 12v a 5v per il Pi. La versione 5V usa servo STS3215 e un power bank. Per i servo del braccio a 12V, il README di SO-ARM100 dice: «se lo fai, dovrai anche comprare un alimentatore da 12V 5A+ invece di uno da 5V».
  4. Il progetto originale afferma che per l'SO-101 il braccio leader è sempre a 7,4V.

1.2 Raccogli le parti della distinta base

Raccogli le parti elencate nella distinta base di LeKiwi per la tua versione, comprese le 3 ruote omnidirezionali, il set di viti, il Raspberry Pi 5 e le schede di controllo dei motori Waveshare.

  1. Parti comuni alle versioni 5V e 12V: 4" Omni wheels (3); M2 M3 M4 Assorted Screw Set (1); Raspberry Pi 5 (4GB) (1); USB camera (2); microSD card (1); Table Clamp 4pcs (1); Screwdriver Set (1); USB-C to USB-A Cable 2 pcs (1).
  2. Versione 5V, elettronica della base mobile: 20000maH 85W Power Bank (1); STS3215 Servo (3); USB-C Cable 2pcs, 1 foot or 0,5 m (1); USB-C To DC Cable (1).
  3. Versione 12V, elettronica della base mobile: 12v 5a Battery (1); Lever Wire Connector (1); 12v 5a DC plug connector (1); 12v to 5v 5a USB-C converter (1); 12v ST3215 Feetech Servo (3).
  4. Versione cablata: 4" Omni wheels (3); M2 M3 M4 Assorted Screw Set (1); USB camera (2); USB-C to USB-A Cable 2 pcs (1); USB-C To DC Cable (1); STS3215 Servo (3); Motor Control Board (1); Power Supply (1); USB Hub (1); USB-C extension cable (1).
  5. Due bracci SO-101 (follower e leader), set 5V: STS3215 Servo (12); Motor Control Board (2); Power Supply (1). Set 12V: 12v ST3215 Servo (12); Motor Control Board (2); Power Supply (1). L'elenco di LeKiwi indica un solo tipo di servo per tutti i 12 motori dei bracci, ma i documenti dell'SO-101 danno al leader tre rapporti di riduzione, elencati nella riga successiva.
  6. Elenco dei servo dell'SO-101 dal README di SO-ARM100, parti per due bracci: STS3215 Servo 7,4V, 1/345 gear (C001) x 7; STS3215 Servo 7,4V, 1/191 gear (C044) x 2; STS3215 Servo 7,4V, 1/147 gear (C046) x 3; Motor Control Board x 2; Power Supply x 2. Il progetto originale nota che i sei servo del leader si possono comprare in un unico kit (3 x 1/147 gear (C046), 2 x 1/191 gear (C044), 1 x 1/345 gear (C001)).
  7. Nota a piè di pagina del progetto originale: un'altra opzione di telecamera supportata è la Arducam 5MP Wide Angle. I supporti stampati per la telecamera sono fatti per la telecamera scelta, quindi con altre telecamere potrebbero dover essere modificati.
  8. Totali del progetto originale (escluso il costo della stampa 3D): robot 12V $482, robot 5V $499, solo base (5V) $248, solo base (12V) $251,5, solo base cablata $184. I prezzi variano a seconda del luogo e del momento dell'acquisto.

2. Stampa 3D

La fonte originale indica un tempo di stampa stimato di circa 34 ore e file STL pronti da stampare per PLA generico su stampanti FDM consumer.

2.1 Prepara la stampante

Prepara una stampante FDM consumer per filamento PLA generico.

  1. Calibra la stampante e livella il piano seguendo le istruzioni della stampante.
  2. Pulisci il piano di stampa.
  3. Carica il filamento.
  4. Il progetto originale ha testato su una Bambu Lab P1S, caricando ogni parte nello slicer, con rotazione automatica, disposizione automatica, attivando gli eventuali supporti consigliati e stampando.

2.2 Stampa le parti della base LeKiwi

Stampa le piastre della base, 3 supporti per i motori di trazione, 3 mozzi delle ruote per i servo, il supporto del controller dei servo, un supporto per batteria o power bank, il case del Pi e i supporti della telecamera.

  1. Stampa: Base plate Top (1) e Base plate Bottom (1); Drive motor mount (3), file drive_motor_mount_v2.stl; Servo wheel hub (3), con supporti; Servo controller mount (1); RasPi case Top (1) e RasPi case Bottom (1).
  2. Stampa un supporto per la batteria: il 12v Battery mount, oppure il 12v EU Battery mount, oppure il 5v Battery mount (file 5v_specific/5v_power_bank_holder.stl).
  3. Stampa un set per la telecamera: o l'Arducam base mount e il wrist mount, oppure il webcam base mount, il gripper insert e il wrist mount.
  4. Stampa la Modified Follower Arm Base (1) con supporti ad albero. Il progetto originale la indica come facoltativa, ma consigliata se non hai già costruito un SO-100.
  5. Impostazioni testate dal progetto originale: densità di riempimento 15%, altezza del layer 0,2 mm, velocità di stampa 150 mm/s. Attiva i supporti dove indicato, poi rimuovili dalle parti stampate.
  6. Note a piè di pagina del progetto originale: il servo wheel hub è modificato dal modello VEX VersaHub, e il case del Pi è modificato da un modello di Micro Center.
  7. Per la versione cablata, la pagina di montaggio del progetto originale usa anche due parti stampate: wired_specific/cable_holder v0.stl e wired_specific/usb_connector_case v1.stl.

2.3 Stampa i due bracci SO-101

Stampa un braccio follower e un braccio leader dai file SO-ARM100.

  1. La tabella delle parti di LeKiwi elenca un Follower arm (1) e un Leader arm (1) e rimanda al repository SO-ARM100 per i file.
  2. Il README di SO-ARM100 dice che tutte le parti del leader o del follower sono contenute in un unico file per braccio, orientate correttamente con z verso l'alto per ridurre al minimo i supporti, con file separati per le stampanti Ender, Prusa e Bambu Lab.
  3. Il README di SO-ARM100 elenca anche parti singole come Handle_SO101.stl e Trigger_SO101.stl per il leader.

3. Installa il software

La documentazione LeRobot di Hugging Face per LeKiwi installa LeRobot sul Raspberry Pi e sul tuo portatile o PC prima dei passaggi di montaggio. Le versioni cablate eseguono tutto sul portatile.

3.1 Installa il sistema operativo sul Pi

Installa Raspberry Pi OS o Ubuntu sulla scheda microSD del Raspberry Pi 5.

  1. Versione cablata: salta l'installazione del Pi e la configurazione SSH ed esegui tutti i comandi sul tuo PC, sia per gli script di LeKiwi sia per quelli del braccio leader.
  2. Il progetto originale rimanda alla documentazione introduttiva del Raspberry Pi e al Raspberry Pi Imager per installare Raspberry Pi OS o Ubuntu.
  3. Il computer sul robot è normalmente un Raspberry Pi, ma il progetto originale dice che può essere qualsiasi PC che funzioni a 5V e abbia abbastanza porte USB (2 o più) per le telecamere e la scheda di controllo dei motori.

3.2 Configura SSH sul Pi

Abilita SSH sul Pi per poter accedere dal portatile senza schermo né tastiera sul Pi.

  1. Dopo aver configurato il Pi, abilita e configura SSH come descritto nella documentazione del Raspberry Pi sull'accesso remoto.
  2. Accedi da un prompt dei comandi, oppure da VSCode con l'estensione Remote - SSH.

3.3 Installa LeRobot sul Pi

Installa LeRobot sul Raspberry Pi con l'extra lekiwi, che aggiunge il supporto per i motori Feetech e ZeroMQ.

  1. Segui sul Pi la LeRobot Installation Guide.
  2. Inoltre, installa il supporto per i motori Feetech e ZeroMQ con: pip install -e ".[lekiwi]"
  3. Più avanti il progetto originale esegue i comandi dopo 'conda activate lerobot' sul Pi, quindi nei suoi esempi l'ambiente si chiama lerobot.

3.4 Installa LeRobot sul portatile o sul PC

Installa LeRobot con l'extra lekiwi sul portatile che eseguirà la teleoperazione e il braccio leader.

  1. Se LeRobot è già installato sul portatile, salta l'installazione di base; altrimenti segui la LeRobot Installation Guide.
  2. Inoltre, installa il supporto per i motori Feetech e ZeroMQ con: pip install -e ".[lekiwi]"
  3. Il progetto originale dice che ogni volta che usi LeRobot in seguito devi andare nella cartella ~/lerobot in cui è stato installato ed eseguire i comandi da lì.

4. Imposta gli ID dei motori

A ogni servo viene assegnato il proprio ID, un motore alla volta, prima che venga montato in un braccio o nella base. I motori delle ruote prendono gli ID 7, 8 e 9; i motori del braccio gli ID da 1 a 6.

4.1 Individua la porta USB di ogni scheda motori

Individua la porta seriale di ogni scheda di controllo dei motori Waveshare con lerobot-find-port.

  1. Collega la scheda di controllo dei motori al computer via USB e all'alimentazione, poi esegui: lerobot-find-port
  2. Quando richiesto, scollega il cavo USB della scheda e premi Invio. Lo script stampa la porta, per esempio /dev/tty.usbmodem575E0032081 su un Mac o /dev/ttyACM0 su Linux. Poi ricollega il cavo.
  3. Su Linux potresti dover dare accesso alle porte USB con: sudo chmod 666 /dev/ttyACM0 e sudo chmod 666 /dev/ttyACM1
  4. Fallo per la scheda che starà su LeKiwi e, separatamente, per la scheda del braccio leader.

4.2 Imposta gli ID dei motori del braccio follower e delle ruote

Esegui lerobot-setup-motors con --robot.type=lekiwi per assegnare ai 6 servo del braccio follower gli ID da 6 a 1 e ai 3 servo delle ruote gli ID 9, 8 e 7.

  1. Comando, con la porta trovata nel passaggio precedente: lerobot-setup-motors --robot.type=lekiwi --robot.port=/dev/tty.usbmodem58760431551
  2. Lo script imposta prima i motori del braccio (ID da 6 a 1) e poi i motori delle ruote (ID 9, 8, 7). Il progetto originale dice che gli ID devono essere in un ordine preciso per funzionare.
  3. ID delle ruote, come etichettati nella figura degli ID dei motori del progetto originale e definiti nel sorgente LeKiwi di LeRobot: l'ID 7 è la ruota sinistra (base_left_wheel), l'ID 8 è la ruota posteriore (base_back_wheel), l'ID 9 è la ruota destra (base_right_wheel). Su LeKiwi si usa una sola scheda di controllo dei motori, ed è per questo che gli ID delle ruote sono 7, 8 e 9.
  4. ID del braccio nel sorgente di LeRobot: 1 shoulder pan, 2 shoulder lift, 3 elbow flex, 4 wrist flex, 5 wrist roll, 6 gripper.
  5. Per ogni motore lo script ti chiede di collegare la scheda del controller solo a quel motore (la prima richiesta è per il motore 'gripper') e di premere Invio. Assicurati che sia l'unico motore collegato alla scheda e che il motore non sia in daisy chain con nessun altro motore. Premendo Invio si impostano l'ID e il baud rate di quel motore.
  6. Il progetto originale scrive questi valori nella EEPROM non volatile di ogni motore, quindi devi farlo una sola volta. Controlla il cablaggio a ogni passaggio prima di premere Invio: il cavo di alimentazione può staccarsi mentre maneggi la scheda.
  7. Se ricevi un errore, controlla l'alimentatore, il cavo USB tra il computer e la scheda del controller, e il cavo a 3 pin dalla scheda al motore. Su una scheda Waveshare, i due jumper devono essere sul canale B (USB).
  8. Tieni ogni motore con il suo ID: il motore della ruota con ID 7 va nella posizione sinistra, l'8 dietro, il 9 a destra, come nella figura del progetto originale.

4.3 Imposta gli ID dei motori del braccio leader

Ripeti la configurazione dei motori per i 6 servo del braccio leader sulla scheda del leader, abbinando ogni rapporto di riduzione al suo giunto.

  1. Comando: lerobot-setup-motors --teleop.type=so101_leader --teleop.port=/dev/tty.usbmodem575E0031751
  2. La pagina di LeKiwi scrive il tipo del leader come so100_leader e la pagina dell'SO-101 scrive so101_leader. Il sorgente di LeRobot registra entrambi i nomi per la stessa classe leader.
  3. Il leader usa tre motori con riduzioni diverse. Asse del leader, ID del motore, rapporto di riduzione: base / shoulder pan 1, 1/191; shoulder lift 2, 1/345; elbow flex 3, 1/191; wrist flex 4, 1/147; wrist roll 5, 1/147; gripper 6, 1/147.
  4. Il braccio follower usa 6 motori STS3215 con riduzione 1/345.
  5. La scheda del braccio leader è separata da quella su LeKiwi e si collega al tuo portatile via USB.

5. Monta i due bracci SO-101

La pagina di montaggio originale di LeKiwi presuppone che il braccio sia già costruito, e la pagina LeKiwi di Hugging Face rimanda alla sua pagina SO-101 per il montaggio del braccio. Questi passaggi seguono quella pagina SO-101; ripeti ogni giunto sia sul follower sia sul leader. La pagina di montaggio originale di LeKiwi dice che va bene un braccio SO-100 o SO-101.

5.1 Pulisci le parti stampate

Rimuovi il materiale di supporto dalle parti del braccio stampate in 3D e collega un cavo a 3 pin a ogni motore dopo averlo posizionato.

  1. Rimuovi tutto il materiale di supporto dalle parti stampate in 3D. Il modo più semplice è usare un piccolo cacciavite per infilarsi sotto il materiale di supporto.
  2. Conviene montare un cavo a 3 pin in ogni motore dopo averlo posizionato, prima di continuare il montaggio.

5.2 Giunto 1: base e spalla

Monta il motore 1 nella base con 4 viti M2x6mm e fissa la spalla con viti M3x6mm.

  1. Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
  2. Metti il primo motore nella base.
  3. Fissa il motore con 4 viti M2x6mm (le viti più piccole), due dall'alto e due dal basso.
  4. Fai scorrere sopra il primo supporto del motore e fissalo con due viti M2x6mm (una per lato).
  5. Fissa la parte della spalla.
  6. Stringi la parte della spalla con 4 viti M3x6mm sopra e 4 viti M3x6mm sotto.
  7. Aggiungi il supporto del motore della spalla.

5.3 Giunto 2: braccio superiore

Monta il motore 2 con 4 viti M2x6mm e fissa il braccio superiore con 4 viti M3x6mm per lato.

  1. Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
  2. Fai scorrere il secondo motore dall'alto.
  3. Fissa il secondo motore con 4 viti M2x6mm.
  4. Fissa il braccio superiore con 4 viti M3x6mm per lato.

5.4 Giunto 3: avambraccio

Monta il motore 3 con 4 viti M2x6mm e collega l'avambraccio con 4 viti M3x6mm per lato.

  1. Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
  2. Inserisci il motore 3 e fissalo con 4 viti M2x6mm.
  3. Collega l'avambraccio al motore 3 con 4 viti M3x6mm per lato.

5.5 Giunto 4: flessione del polso

Monta il motore 4 nel suo supporto con 4 viti M2x6mm.

  1. Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
  2. Fai scorrere sopra il supporto del motore 4.
  3. Fai scorrere dentro il motore 4.
  4. Fissa il motore 4 con 4 viti M2x6mm.

5.6 Giunto 5: rotazione del polso

Monta il motore 5 nel supporto del polso con 2 viti M2x6mm e fissa il polso al motore 4 con 4 viti M3x6mm su entrambi i lati.

  1. Inserisci il motore 5 nel supporto del polso e fissalo con 2 viti M2x6mm frontali.
  2. Monta una sola squadretta sul motore del polso e fissala con una vite M3x6mm per squadretta.
  3. Fissa il polso al motore 4 con 4 viti M3x6mm su entrambi i lati.

5.7 Pinza del braccio follower

Fissa la pinza al motore 5 con 4 viti M3x6mm, monta il motore della pinza con 2 viti M2x6mm per lato e monta la ganascia con 4 viti M3x6mm.

  1. Fissa la pinza al motore 5, collegandola alla squadretta del motore sul polso con 4 viti M3x6mm.
  2. Inserisci il motore della pinza e fissalo con 2 viti M2x6mm per lato.
  3. Monta entrambe le squadrette sul motore della pinza. Fissa la squadretta superiore con una vite M3x6mm; per la squadretta inferiore non servono viti.
  4. Monta la ganascia della pinza e fissala con 4 viti M3x6mm su entrambi i lati.
  5. Se più avanti usi l'opzione webcam, la pagina di montaggio di LeKiwi del progetto originale usa una pinza follower diversa con un inserto per dado M3; vedi il passaggio della telecamera.

5.8 Impugnatura del braccio leader

Monta il supporto del leader con 4 viti M3x6mm, l'impugnatura con 1 vite M2x6mm, il motore della pinza con 2 viti M2x6mm per lato e il grilletto (Trigger_SO101.stl) con 4 viti M3x6mm.

  1. Monta il supporto del leader sul polso e fissalo con 4 viti M3x6mm.
  2. Fissa l'impugnatura al supporto del leader con 1 vite M2x6mm.
  3. Inserisci il motore della pinza, fissalo con 2 viti M2x6mm per lato e monta una squadretta con una vite M3x6mm per squadretta.
  4. Fissa il grilletto (Trigger_SO101.stl) con 4 viti M3x6mm.

5.9 Braccio leader: lascia gli ingranaggi nei motori

Costruisci il leader con i motori dai tre rapporti di riduzione elencati per l'SO-101 e non rimuovere alcun ingranaggio.

  1. Costruisci il braccio di teleoperazione seguendo la guida SO-101 di Hugging Face. Su un leader SO-101, con i suoi tre rapporti di riduzione, non rimuovere alcun ingranaggio.
  2. La rimozione degli ingranaggi riguardava il precedente SO-100, il cui leader usava sei motori con un unico rapporto. Se stai costruendo un leader SO-100, la pagina dell'SO-100 ti dice di rimuovere gli ingranaggi dei 6 motori del leader; questo non fa parte della costruzione dell'SO-101.
  3. Il README di SO-ARM100 descrive l'SO-101 come più facile da montare (nessuna rimozione di ingranaggi), con motori aggiornati per il braccio leader.
  4. Posiziona ogni motore come nella tabella del leader: giunto 1 1/191, giunto 2 1/345, giunto 3 1/191, giunti 4, 5 e 6 1/147.

6. Monta la base mobile

L'Assembly.md originale indica un tempo stimato di 2 ore. È basato su foto, con le posizioni esatte mostrate in un modello Fusion 360 online, e i passaggi seguenti ne seguono il testo.

6.1 Modulo ruota: motore sul suo supporto

Fissa un motore di trazione a un supporto per motore di trazione con 4 viti autofilettanti m2x5.

  1. Prepara in tutto tre moduli ruota. Ogni modulo è composto da un motore di trazione, un supporto del motore di trazione, un mozzo della ruota e una ruota omnidirezionale.
  2. Fissa il motore di trazione al supporto del motore con 4 viti autofilettanti m2x5.
  3. Mantieni gli ID in ordine: il motore con ID 7 è la ruota sinistra, l'ID 8 la ruota posteriore e l'ID 9 la ruota destra.

6.2 Modulo ruota: supporto sulla piastra inferiore della base

Avvita il supporto del motore di trazione sulla piastra inferiore della base con 4 viti a ferro m3x12.

  1. Avvita il supporto del motore di trazione sulla piastra di base inferiore con 4 viti metriche m3x12.

6.3 Modulo ruota: mozzo sulla ruota omnidirezionale

Fissa il mozzo della ruota alla ruota omnidirezionale con 2 viti a ferro m4x12.

  1. Fissa il mozzo della ruota alla ruota omnidirezionale con 2 viti metriche m4x12.

6.4 Modulo ruota: squadretta del servo sul mozzo

Fissa la squadretta del servo al mozzo della ruota con 2 viti a ferro m3x16.

  1. Fissa la squadretta del servo al mozzo della ruota con 2 viti metriche m3x16.

6.5 Modulo ruota: squadretta sul motore di trazione

Fissa la squadretta del servo al motore di trazione con 1 vite a ferro m3x6, poi controlla che tutti e 3 i moduli siano sulla piastra inferiore della base.

  1. Fissa la squadretta del servo al motore di trazione con 1 vite metrica m3x6.
  2. Ripeti per tutti e tre i moduli e fissali tutti e 3 alla piastra di base inferiore, come nelle fotografie del progetto originale.

6.6 Piastra inferiore: supporti del controller e della batteria

Inserisci i dadi m3 nel supporto del controller dei servo e nel supporto della batteria, poi avvita entrambi sulla piastra inferiore della base con 4 viti a ferro m3x12.

  1. Inserisci dadi m3 nei supporti del controller dei servo e della batteria. Avvitali entrambi sulla piastra di base inferiore con 4 viti metriche m3x12.
  2. Per la versione 5V, il progetto originale dice che puoi usare il supporto del power bank (5v_power_bank_holder.stl) per tenerlo in posizione, montato sul retro della piastra inferiore.

6.7 Piastra inferiore: driver dei servo e fili dei servo di trazione

Aggiungi la scheda driver dei servo e collega i suoi fili ai 3 servo di trazione.

  1. Aggiungi il driver dei servo e collega i fili ai 3 servo di trazione.

6.8 Cabla la versione a 12V

Per la versione a 12V, unisci i cavi della batteria al convertitore da 12v a 5v e all'adattatore con spina DC a barilotto con morsetti a leva, e fissa il convertitore con 2 viti a ferro m3x16 e 2 dadi m3.

  1. Solo versione 12V: usa i connettori a leva wago per collegare i fili di massa e di alimentazione della batteria ai fili del convertitore 12v->5v e all'adattatore con spinotto DC.
  2. Avvita il convertitore da 12v a 5v sulla piastra di base inferiore con 2 viti metriche m3x16 e 2 dadi m3.
  3. Il progetto originale non dà nel testo dettagli sulla polarità; segui le sue fotografie del cablaggio.

6.9 Cabla la versione a 5V

Per la versione a 5V, collega power bank, Raspberry Pi e scheda dei servo come nello schema a 5V del progetto originale.

  1. Solo versione 5V: i cavi si collegano secondo lo schema 5V del progetto originale.
  2. Lo schema, secondo le sue etichette, mostra un power bank (SH-CP05A, 5V, DC 5525) che alimenta il Raspberry Pi 5 via USB-C e la presa DC della scheda dei servo (DC 5.52.1) tramite il cavo da USB-C a DC, la scheda dei servo collegata al Pi via USB, e un servo da 7,4V sulla scheda.
  3. Il testo del progetto originale per l'ultimo passaggio dice: alimenta l'elettronica inserendo l'adattatore con spinotto DC nel controller dei servomotori e il connettore USB-C da 5V nel Raspberry Pi 5.

6.10 Piastra superiore: Raspberry Pi e braccio follower

Metti il Raspberry Pi 5 nel suo case, fissalo alla piastra superiore della base con 2 viti a ferro m3x12 e monta il braccio follower con 4 viti a ferro m3x20.

  1. Metti il Raspberry Pi 5 nella parte inferiore del case del Pi e incastra a scatto la parte superiore del case.
  2. Fissa il Pi alla piastra di base superiore con 2 viti metriche m3x12 e monta il braccio SO-101 con 4 viti metriche m3x20.
  3. Va bene sia la base SO-101 modificata del progetto originale sia quella originale, perché la piastra ha i fori per entrambe.

6.11 Versione cablata: portacavo e cavo USB-C

Solo per la versione cablata, stampa e monta il portacavo e il case del connettore USB, e collega il cavo di prolunga USB-C nel verso giusto.

  1. Solo versione cablata: monta le parti stampate cable_holder v0.stl e usb_connector_case v1.stl come mostrato nelle fotografie del progetto originale.
  2. Il progetto originale dice che è molto importante inserire il cavo USB-C con l'orientamento mostrato. Il logo UGreen deve essere sullo stesso lato dell'etichetta 20GBS, 240W, con il lato 20GBS, 240W rivolto verso l'alto quando è collegato al tuo portatile.
  3. Se la prolunga USB-C non rileva le telecamere o la scheda di controllo dei motori, probabilmente l'orientamento del cavo è sbagliato e va ruotato di 180 gradi.
  4. Collega i cavi delle due telecamere, della scheda di controllo dei motori e della prolunga USB-C come mostrato nelle fotografie del progetto originale (indicate come importanti).

6.12 Montaggio finale: cavi attraverso la piastra superiore

Fai passare nel foro della piastra superiore della base il cavo da USB-C a USB-A del controller dei servo, il cavo di alimentazione USB-C a 5V e i fili dei servo del braccio.

  1. Fai passare il cavo da USB-C a USB-A del controller dei servo, il cavo di alimentazione USB-C da 5V e i fili dei servo dell'SO-101 attraverso il foro nella piastra di base superiore.

6.13 Montaggio finale: piastra superiore sui supporti dei motori

Monta la piastra superiore della base sui supporti dei motori con 4 viti a ferro m3x12.

  1. Monta la piastra di base superiore sui supporti dei motori con 4 viti metriche m3x12.

6.14 Telecamere: opzione Arducam

Monta il supporto della telecamera della base sulla piastra inferiore della base e il supporto della telecamera del polso sulla pinza fissa, ciascuno con una telecamera grandangolare Arducam da 5MP fissata con 2 viti a ferro M2.5x12.

  1. Stampa 1 x base_camera_mount.stl e 1 x wrist_camera_mount.stl.
  2. Avvita il supporto della telecamera della base sulla piastra di base inferiore, e fissa la telecamera grandangolare Arducam 5MP al supporto con 2 viti metriche M2.5x12. Il cavo della telecamera può passare attraverso l'apertura.
  3. Avvita il supporto della telecamera del polso sulla ganascia fissa della pinza con 4 viti autofilettanti M2x5, e fissa la telecamera grandangolare Arducam 5MP al supporto con 2 viti metriche M2.5x12.
  4. Il progetto originale nota che i supporti sono fatti per queste telecamere e potrebbero dover essere modificati per altre.

6.15 Telecamere: opzione webcam

Monta il supporto da polso della webcam sulla pinza con un bullone M3x12mm e un dado M3, fissa la telecamera con 2 bulloni M3x35mm e 2 dadi, e monta allo stesso modo il supporto della webcam della base.

  1. Stampa 1 x webcam_mount/webcam_mount.stl, 1 x webcam_mount/so100_gripper_cam_mount_insert.stl e 1 x webcam_mount/webcam_mount_wrist.stl.
  2. Stampa la nuova pinza con un alloggiamento per il dado M3, e inserisci il dado. Poi inserisci il motore e monta la pinza.
  3. Prendi webcam_mount_wrist.stl, aggiungi un bullone M3x12mm e avvitalo con decisione finché non si blocca nel dado M3 della pinza. Inserisci la telecamera nel supporto e aggiungi 2 bulloni M3x35mm nei fori posteriori per bloccare la telecamera in posizione, usando 2 dadi inseriti nelle fessure.
  4. Fai lo stesso per la telecamera della base con webcam_mount.stl e fissala sul davanti di LeKiwi.

6.16 Collega tutto

Alimenta il controller dei servo tramite l'adattatore con spina DC a barilotto e il Raspberry Pi 5 tramite il connettore USB-C a 5V, poi collega al Pi i cavi USB del controller dei servo e della telecamera.

  1. Alimenta l'elettronica inserendo l'adattatore con spinotto DC nel controller dei servomotori e il connettore USB-C da 5V nel Raspberry Pi 5.
  2. I cavi USB del controller dei servo e delle telecamere si possono collegare direttamente al Raspberry Pi.

7. Calibra e guida

Comandi di calibrazione e teleoperazione dalla pagina LeKiwi di Hugging Face. I motori delle ruote non richiedono calibrazione.

7.1 Calibra il braccio follower

Esegui lerobot-calibrate sul Pi via SSH per calibrare il braccio follower sulla base.

  1. Assicurati che il braccio sia collegato al Raspberry Pi. Versione cablata: esegui tutti i comandi sul tuo portatile.
  2. Esegui: lerobot-calibrate --robot.type=lekiwi --robot.id=my_awesome_kiwi (dai al robot un nome univoco con --robot.id).
  3. Prima porta il braccio nella posizione in cui ogni giunto è a metà della sua escursione e premi Invio. Poi muovi tutti i giunti per tutta la loro escursione.
  4. I motori delle ruote non vanno calibrati. Il progetto originale sottolinea che la calibrazione è molto importante perché permette a una rete neurale addestrata su un robot di funzionare su un altro.

7.2 Calibra il braccio leader

Esegui lerobot-calibrate sul portatile per calibrare il braccio leader.

  1. Esegui: lerobot-calibrate --teleop.type=so100_leader --teleop.port=/dev/tty.usbmodem58760431551 --teleop.id=my_awesome_leader_arm
  2. Usa la porta del tuo braccio leader e dai al braccio un nome univoco con --teleop.id. La pagina dell'SO-101 scrive lo stesso comando con --teleop.type=so101_leader.
  3. Il progetto originale fornisce anche un esempio Python che usa SO100LeaderConfig e SO100Leader da lerobot.teleoperators.so_leader.

7.3 Risolvi i problemi di connessione

Se LeKiwi non si connette, controlla l'indirizzo IP del Pi, fai un ping e prova con SSH.

  1. Sul Pi esegui: hostname -I, e assicurati di usare nei comandi o nel codice l'IP corretto del Pi.
  2. Dal tuo portatile esegui: ping <your_pi_ip_address>. Se il ping non riesce, assicurati che il Pi sia acceso, sulla stessa rete e con SSH abilitato.
  3. Prova: ssh <your_pi_user_name>@<your_pi_ip_address>. Se ricevi un errore di connessione, esegui sudo raspi-config sul Pi e in Interfacing Options scegli SSH e abilitalo.

7.4 Teleopera LeKiwi

Avvia l'host sul Pi, poi esegui l'esempio di teleoperazione sul portatile e guida con la tastiera e il braccio leader.

  1. Mac: potresti dover dare al Terminale il permesso di accedere alla tastiera. Vai in System Preferences, Security and Privacy, Input Monitoring, e spunta Terminal.
  2. Accedi al Pi via SSH, esegui conda activate lerobot e poi: python -m lerobot.robots.lekiwi.lekiwi_host --robot.id=my_awesome_kiwi
  3. L'host si ferma dopo --host.connection_time_s secondi (30 per impostazione predefinita). Per sessioni più lunghe, per esempio per registrare un dataset, aumentalo, per esempio --host.connection_time_s=600.
  4. Sul tuo portatile esegui conda activate lerobot, imposta remote_ip e la porta corretti in examples/lekiwi/teleoperate.py, poi esegui: python examples/lekiwi/teleoperate.py
  5. Tasti: W avanti, A sinistra, S indietro, D destra, Z ruota a sinistra, X ruota a destra, R aumenta la velocità, F riduce la velocità.
  6. Modalità di velocità (velocità lineare, velocità di rotazione): veloce 0,3 m/s, 90 deg/s; media 0,2 m/s, 60 deg/s; lenta 0,1 m/s, 30 deg/s.
  7. La teleoperazione della base da tastiera si basa su un backend globale per i tasti, quindi funziona solo in una sessione X11, su un desktop Windows o su macOS con Accessibility o Input Monitoring autorizzati, e non su Wayland o su macchine headless.
  8. Versione cablata: esegui tutti i comandi sul tuo portatile.

7.5 Registra, riproduci e valuta

Registra un primo dataset, riproduci un episodio e valuta una policy con gli esempi LeKiwi di LeRobot.

  1. Registrazione: accedi all'hub di Hugging Face con un token con permesso di scrittura (hf auth login --token ${HUGGINGFACE_TOKEN} --add-to-git-credential), adatta nello script remote_ip, HF_REPO_ID, la porta del braccio leader e TASK_DESCRIPTION, poi esegui: python examples/lekiwi/record.py
  2. Il progetto originale suggerisce almeno 50 episodi per un primo compito come afferrare un oggetto in posizioni diverse e metterlo in un contenitore, con 10 episodi per posizione, tenendo fisse le telecamere.
  3. Riproduzione: cambia remote_ip, la porta, l'id del dataset e l'indice dell'episodio, poi esegui: python examples/lekiwi/replay.py
  4. Valutare una policy: cambia remote_ip, la porta e il modello, poi esegui: python examples/lekiwi/evaluate.py
  5. L'addestramento è trattato nella pagina di Hugging Face Getting started with real-world robots, che questa guida non riproduce.

Questo sito richiede JavaScript. Attiva JavaScript per esplorare i nostri progetti di robotica open source.