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.
- Il progetto originale offre tre opzioni per motori ed elettronica: 5V, 12V o cablata.
- 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.
- 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».
- 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.
- 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).
- 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).
- 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).
- 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).
- 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.
- 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)).
- 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.
- 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.
- Calibra la stampante e livella il piano seguendo le istruzioni della stampante.
- Pulisci il piano di stampa.
- Carica il filamento.
- 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.
- 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).
- 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).
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Il progetto originale rimanda alla documentazione introduttiva del Raspberry Pi e al Raspberry Pi Imager per installare Raspberry Pi OS o Ubuntu.
- 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.
- Dopo aver configurato il Pi, abilita e configura SSH come descritto nella documentazione del Raspberry Pi sull'accesso remoto.
- 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.
- Segui sul Pi la LeRobot Installation Guide.
- Inoltre, installa il supporto per i motori Feetech e ZeroMQ con: pip install -e ".[lekiwi]"
- 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.
- Se LeRobot è già installato sul portatile, salta l'installazione di base; altrimenti segui la LeRobot Installation Guide.
- Inoltre, installa il supporto per i motori Feetech e ZeroMQ con: pip install -e ".[lekiwi]"
- 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.
- Collega la scheda di controllo dei motori al computer via USB e all'alimentazione, poi esegui: lerobot-find-port
- 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.
- Su Linux potresti dover dare accesso alle porte USB con: sudo chmod 666 /dev/ttyACM0 e sudo chmod 666 /dev/ttyACM1
- 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.
- Comando, con la porta trovata nel passaggio precedente: lerobot-setup-motors --robot.type=lekiwi --robot.port=/dev/tty.usbmodem58760431551
- 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.
- 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.
- ID del braccio nel sorgente di LeRobot: 1 shoulder pan, 2 shoulder lift, 3 elbow flex, 4 wrist flex, 5 wrist roll, 6 gripper.
- 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.
- 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.
- 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).
- 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.
- Comando: lerobot-setup-motors --teleop.type=so101_leader --teleop.port=/dev/tty.usbmodem575E0031751
- 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.
- 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.
- Il braccio follower usa 6 motori STS3215 con riduzione 1/345.
- 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.
- 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.
- 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.
- Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
- Metti il primo motore nella base.
- Fissa il motore con 4 viti M2x6mm (le viti più piccole), due dall'alto e due dal basso.
- Fai scorrere sopra il primo supporto del motore e fissalo con due viti M2x6mm (una per lato).
- Fissa la parte della spalla.
- Stringi la parte della spalla con 4 viti M3x6mm sopra e 4 viti M3x6mm sotto.
- 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.
- Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
- Fai scorrere il secondo motore dall'alto.
- Fissa il secondo motore con 4 viti M2x6mm.
- 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.
- Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
- Inserisci il motore 3 e fissalo con 4 viti M2x6mm.
- 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.
- Monta entrambe le squadrette del motore. Fissa la squadretta superiore con una vite M3x6mm. Per la squadretta inferiore non servono viti.
- Fai scorrere sopra il supporto del motore 4.
- Fai scorrere dentro il motore 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.
- Inserisci il motore 5 nel supporto del polso e fissalo con 2 viti M2x6mm frontali.
- Monta una sola squadretta sul motore del polso e fissala con una vite M3x6mm per squadretta.
- 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.
- Fissa la pinza al motore 5, collegandola alla squadretta del motore sul polso con 4 viti M3x6mm.
- Inserisci il motore della pinza e fissalo con 2 viti M2x6mm per lato.
- Monta entrambe le squadrette sul motore della pinza. Fissa la squadretta superiore con una vite M3x6mm; per la squadretta inferiore non servono viti.
- Monta la ganascia della pinza e fissala con 4 viti M3x6mm su entrambi i lati.
- 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.
- Monta il supporto del leader sul polso e fissalo con 4 viti M3x6mm.
- Fissa l'impugnatura al supporto del leader con 1 vite M2x6mm.
- Inserisci il motore della pinza, fissalo con 2 viti M2x6mm per lato e monta una squadretta con una vite M3x6mm per squadretta.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Fissa il motore di trazione al supporto del motore con 4 viti autofilettanti m2x5.
- 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.
- 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.
- 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.
- 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.
- Fissa la squadretta del servo al motore di trazione con 1 vite metrica m3x6.
- 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.
- Inserisci dadi m3 nei supporti del controller dei servo e della batteria. Avvitali entrambi sulla piastra di base inferiore con 4 viti metriche m3x12.
- 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.
- 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.
- 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.
- Avvita il convertitore da 12v a 5v sulla piastra di base inferiore con 2 viti metriche m3x16 e 2 dadi m3.
- 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.
- Solo versione 5V: i cavi si collegano secondo lo schema 5V del progetto originale.
- 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.
- 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.
- Metti il Raspberry Pi 5 nella parte inferiore del case del Pi e incastra a scatto la parte superiore del case.
- Fissa il Pi alla piastra di base superiore con 2 viti metriche m3x12 e monta il braccio SO-101 con 4 viti metriche m3x20.
- 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.
- Solo versione cablata: monta le parti stampate cable_holder v0.stl e usb_connector_case v1.stl come mostrato nelle fotografie del progetto originale.
- 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.
- 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.
- 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.
- 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.
- 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.
- Stampa 1 x base_camera_mount.stl e 1 x wrist_camera_mount.stl.
- 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.
- 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.
- 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.
- 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.
- Stampa la nuova pinza con un alloggiamento per il dado M3, e inserisci il dado. Poi inserisci il motore e monta la pinza.
- 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.
- 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.
- Alimenta l'elettronica inserendo l'adattatore con spinotto DC nel controller dei servomotori e il connettore USB-C da 5V nel Raspberry Pi 5.
- 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.
- Assicurati che il braccio sia collegato al Raspberry Pi. Versione cablata: esegui tutti i comandi sul tuo portatile.
- Esegui: lerobot-calibrate --robot.type=lekiwi --robot.id=my_awesome_kiwi (dai al robot un nome univoco con --robot.id).
- 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.
- 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.
- Esegui: lerobot-calibrate --teleop.type=so100_leader --teleop.port=/dev/tty.usbmodem58760431551 --teleop.id=my_awesome_leader_arm
- 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.
- 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.
- Sul Pi esegui: hostname -I, e assicurati di usare nei comandi o nel codice l'IP corretto del Pi.
- 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.
- 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.
- Mac: potresti dover dare al Terminale il permesso di accedere alla tastiera. Vai in System Preferences, Security and Privacy, Input Monitoring, e spunta Terminal.
- Accedi al Pi via SSH, esegui conda activate lerobot e poi: python -m lerobot.robots.lekiwi.lekiwi_host --robot.id=my_awesome_kiwi
- 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.
- 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
- 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à.
- 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.
- 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.
- 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.
- 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
- 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.
- Riproduzione: cambia remote_ip, la porta, l'id del dataset e l'indice dell'episodio, poi esegui: python examples/lekiwi/replay.py
- Valutare una policy: cambia remote_ip, la porta e il modello, poi esegui: python examples/lekiwi/evaluate.py
- L'addestramento è trattato nella pagina di Hugging Face Getting started with real-world robots, che questa guida non riproduce.