Guida al montaggio di Open Duck Mini V2
Un mini robot papera open source da stampare in 3D e costruire, ispirato al droide BDX di Disney
Licenza
Apache-2.0
Guida al montaggio
1. Preparazione e configurazione dei motori
Configura tutti i servomotori Feetech STS3215 con gli ID corretti, installa le squadrette dei servo e stampa in 3D tutte le parti in PLA e TPU necessarie.
1.1 Configura tutti i servo
Con lo script configure_motor.py di Open Duck Mini Runtime, imposta ciascuno dei 14 servo STS3215 sul suo ID corretto (gamba sinistra: 20-24, gamba destra: 10-14, testa/collo: 30-33) e portali in posizione zero.
- Scarica e installa Open Duck Mini Runtime da GitHub (github.com/apirrone/Open_Duck_Mini_Runtime).
- Collega ogni servo Feetech STS3215, uno alla volta, alla scheda driver dei servo tramite USB.
- Esegui lo script di configurazione dei motori: python configure_motor.py --id <ID> per ogni servo. A ogni servo va assegnato un ID univoco prima del montaggio.
- Configura i servo della gamba sinistra con gli ID: hip_yaw=20, hip_roll=21, hip_pitch=22, knee=23, ankle=24.
- Configura i servo della gamba destra con gli ID: hip_yaw=10, hip_roll=11, hip_pitch=12, knee=13, ankle=14.
- Configura i servo di testa e collo con gli ID: neck_pitch=30, head_pitch=31, head_yaw=32, head_roll=33.
- Etichetta ogni servo configurato con il suo numero ID usando nastro o un pennarello, per evitare confusione durante il montaggio.
1.2 Installa le squadrette dei servo
Con ogni motore in posizione zero, allinea con cura e installa la squadretta (palonnier) sull'albero di uscita. Un allineamento corretto in posizione zero è fondamentale per avere angoli dei giunti corretti.
- Fissa la squadretta appropriata a ogni servo STS3215 con la minuteria inclusa.
- Assicurati che ogni servo sia nella posizione zero/centrale prima di fissare la squadretta. La posizione zero è fondamentale per il corretto allineamento dei giunti.
- Stringi bene la vite centrale della squadretta su ogni motore.
1.3 Stampa in 3D tutte le parti
Stampa tutte le oltre 35 parti in PLA (consigliato riempimento del 15%) e le suole dei piedi in TPU (riempimento del 40%). Inserisci gli inserti filettati a caldo M3 in tutti i fori previsti con un saldatore alla temperatura adatta.
- Scarica tutti i file STL dalla cartella di stampa di Open Duck Mini V2 su GitHub.
- Stampa tutte le parti in PLA con impostazioni standard e riempimento del 15%.
- Stampa le parti foot_bottom_tpu.stl (x2) in filamento TPU con riempimento del 40% per l'aderenza e la flessibilità della suola del piede.
- Stampa in quantità x2 le parti simmetriche: foot_top, foot_side, foot_bottom_pla, foot_bottom_tpu, roll_motor_bottom, roll_motor_top.
- Stampa in quantità x4: knee_to_ankle_left_sheet, knee_to_ankle_right_sheet, leg_spacer.
- Stampa in quantità x1 tutte le restanti parti di corpo, testa, tronco e accessori (circa 24 parti diverse).
- Rifinisci tutte le parti stampate rimuovendo i supporti e smussando i bordi.
2. Montaggio delle gambe
Costruisci entrambe le gambe partendo dal basso: piedi con interruttori di contatto, stinchi, cosce e gruppi dell'anca, con una corretta installazione dei cuscinetti.
2.1 Monta i piedi
Unisci foot_bottom_tpu a foot_bottom_pla, installa il servo della caviglia in foot_top, aggiungi gli interruttori di contatto del piede per il rilevamento del suolo e fissa con viti M3x6.
- Monta foot_bottom_tpu su foot_bottom_pla per ogni piede.
- Inserisci con un saldatore gli inserti filettati a caldo M3 nei fori previsti di foot_bottom_pla.
- Fissa foot_bottom_pla a foot_top con 2x viti M3x6 per piede.
- Inserisci altri inserti filettati a caldo M3 in foot_top per il montaggio del motore.
- Monta il servomotore della caviglia su foot_top con il lato del driver rivolto verso l'esterno.
- Inserisci a pressione gli interruttori di contatto del piede nelle loro sedi su ogni piede. Gli interruttori rilevano il contatto con il suolo per il feedback dell'equilibrio.
- Fai passare i fili degli interruttori del piede e il cavo del servo verso l'alto attraverso il canale della gamba.
- Ripeti l'intero procedimento per il secondo piede: i due piedi sono identici.
2.2 Monta gli stinchi
Installa leg_spacer con gli inserti M3, fai passare il cavo del motore della caviglia tra le lamiere laterali e avvita insieme il sottogruppo dello stinco con 4 pannelli.
- Inserisci 4 inserti filettati a caldo M3 in ogni leg_spacer (su entrambi i lati).
- Fai passare il cavo del motore dal gruppo del piede attraverso la parte right_sheet.
- Inserisci il leg_spacer tra le parti laterali sinistra e destra (knee_to_ankle_left_sheet e knee_to_ankle_right_sheet).
- Fissa il gruppo dello stinco con viti M3x10 che attraversano le piastre ed entrano negli inserti del distanziale.
- Monta il servo del ginocchio in cima al gruppo dello stinco.
- Ripeti per il secondo gruppo dello stinco.
2.3 Monta le cosce
Costruiscile come gli stinchi, ma monta il servo hip_pitch con l'orientamento corretto della posizione zero. Assicurati che il passaggio dei cavi non interferisca con il movimento dei giunti.
- Monta la coscia con lo stesso procedimento del gruppo dello stinco, con piastre e distanziale.
- Monta il servomotore hip_pitch con l'orientamento corretto per la posizione zero. Fai molta attenzione: un posizionamento errato compromette l'andatura.
- Collega il sottogruppo della coscia alla parte superiore dello stinco tramite la squadretta del servo del ginocchio.
- Ripeti per il secondo gruppo della coscia.
2.4 Monta le anche
Monta l'adattatore roll_to_pitch, installa il servo hip_yaw con roll_motor_top, fissa la staffa hip_roll e collega il sottogruppo completo della gamba. Ripeti per entrambe le gambe con configurazioni speculari.
- Monta left_roll_to_pitch (o right_roll_to_pitch) sul servo hip_roll. Queste parti sono speculari: usa il lato corretto per ogni gamba.
- Monta roll_motor_top sul servo hip_yaw, avvitando dal basso.
- Fissa la parte hip_roll per completare il gruppo del giunto dell'anca.
- Inserisci il sottogruppo della gamba completato nel meccanismo dell'anca.
- Fissalo con le viti per plastica incluse nel kit del servo.
- Ripeti l'intero montaggio dell'anca per la seconda gamba.
- Applica Loctite Threadlocker Blue 243 su tutti i collegamenti a vite metallo su metallo. Non usare frenafiletti sulle viti che entrano nella plastica.
3. Montaggio di tronco e busto
Monta la struttura centrale del tronco con cuscinetti e inserti filettati a caldo, fissa entrambi i gruppi gamba completati e installa i pannelli della carrozzeria.
3.1 Monta il tronco
Metti i cuscinetti in trunk_bottom, installa gli inserti M3, fissa trunk_top con viti M3x10 e monta il motore di rollio centrale con le viti in plastica per servo.
- Inserisci a pressione i cuscinetti nei fori per cuscinetti di trunk_bottom.
- Inserisci gli inserti filettati a caldo M3 nei fori dei cuscinetti e nei 4 fori di montaggio sul fondo di trunk_bottom.
- Appoggia trunk_top su trunk_bottom e fissalo con 2x viti M3x10.
- Monta il motore centrale (rotazione del tronco) con le viti per plastica del kit del servo.
- Inserisci la parte roll_motor_bottom nel gruppo del tronco.
3.2 Monta entrambi i gruppi delle gambe
Fissa i gruppi completi delle gambe sinistra e destra al tronco con i connettori roll_motor_bottom. Applica il frenafiletti Loctite sui collegamenti a vite metallo su metallo.
- Fissa il gruppo dell'anca della gamba sinistra al lato sinistro del tronco.
- Fissa il servo hip_yaw nel tronco usando i punti di montaggio di roll_motor_bottom.
- Fai passare tutti i cavi dei servo della gamba sinistra nei canali per cavi del tronco.
- Ripeti per il gruppo della gamba destra sul lato destro del tronco.
- Verifica che entrambe le gambe si muovano liberamente per tutta la loro escursione senza interferenze dei cavi.
3.3 Installa i pannelli del corpo
Monta i pannelli body_middle_bottom, body_middle_top e body_front. Installa il supporto del pacco batteria tra i pannelli del corpo.
- Avvita body_middle_bottom sul telaio del tronco.
- Inserisci gli inserti filettati a caldo M3 sia in body_middle_bottom sia in body_middle_top.
- Monta body_middle_top sul gruppo. Inseriscilo prima di completare la testa, per non dover smontare dopo.
- Fissa il pannello body_front sulla parte anteriore del robot.
- Fissa il pannello body_back per completare l'involucro del busto.
4. Montaggio di testa e collo
Costruisci il meccanismo del collo e il gruppo di beccheggio/imbardata/rollio della testa, e installa i componenti della testa, tra cui il Raspberry Pi Zero 2W e i motori delle antenne.
4.1 Monta il collo
Collega neck_left_sheet e neck_right_sheet con il servo di beccheggio del collo. Assicurati che i cavi passino correttamente per evitare interferenze.
- Fissa neck_left_sheet e neck_right_sheet al servo neck_pitch.
- Monta il gruppo del collo in cima al telaio del tronco.
- Assicurati che il cavo del servo del collo passi in modo ordinato attraverso il corpo.
4.2 Monta il meccanismo della testa
Monta l'adattatore head_pitch_to_yaw, poi head_yaw_to_roll e head_roll_mount per creare il meccanismo gimbal della testa a 3 gradi di libertà.
- Monta head_pitch_to_yaw sull'uscita del gruppo del collo.
- Fissa il servo head_yaw e la parte head_yaw_to_roll.
- Monta head_roll_mount sul servo head_roll per completare il meccanismo della testa a 3 gradi di libertà.
- Verifica che la testa possa beccheggiare, imbardare e rollare senza impuntamenti né interferenze dei cavi.
4.3 Installa i componenti della testa
Monta il Raspberry Pi Zero 2W, i servo delle orecchie-antenna (SG90), la telecamera, l'altoparlante e i LED dentro il guscio della testa. Fissa la testa montata al meccanismo gimbal.
- Inserisci gli inserti filettati a caldo M3 in tutti i fori di montaggio del guscio della testa.
- Inserisci a pressione il cuscinetto per la rotazione della testa.
- Monta i due micro servo SG90 per il movimento delle orecchie-antenna.
- Fissa left_antenna_holder e right_antenna_holder ai servo SG90.
- Monta il Raspberry Pi Zero 2W all'interno della testa con viti M3.
- Installa i LED per l'illuminazione degli occhi nelle parti left_eye e right_eye.
- Monta l'amplificatore MAX98357A e il piccolo altoparlante con speaker_interface e speaker_stand.
- Fissa il guscio della testa completato al meccanismo della testa.
- Collega la testa al gruppo del collo.
5. Elettronica e cablaggio
Installa il pacco batteria, la scheda driver dei servo e l'IMU BNO055, collega tutti i servo sul bus seriale e collega sensori e periferiche.
5.1 Costruisci il pacco batteria
Inserisci nel portabatterie due celle 18650 con tensione abbinata, collegale tramite il BMS 2S, cabla l'interruttore di alimentazione e il modulo caricatore USB-C.
- Inserisci due celle Li-Ion 18650 nel portacelle 2S. Assicurati che entrambe le celle siano caricate alla stessa tensione prima di inserirle.
- Collega il BMS 2S (sistema di gestione della batteria) al portacelle.
- Collega il modulo di ricarica USB-C al BMS per poter ricaricare.
- Installa l'interruttore di alimentazione in serie sul conduttore positivo della batteria.
- Metti il pacco batteria completato nell'involucro battery_pack_lid.
- Monta il pacco batteria nella cavità del corpo.
5.2 Cabla il bus dei servo
Collega in daisy chain tutti i 14 servo STS3215 alla scheda di controllo Feetech SCServo. Monta la scheda di controllo nel tronco.
- Monta la scheda di controllo dei servo Feetech all'interno del corpo.
- Collega tutti i cavi dei servo STS3215 alla scheda di controllo dei servo in configurazione daisy chain. I servo STS3215 usano un bus seriale.
- Collega la scheda di controllo dei servo al Raspberry Pi tramite USB.
- Collega i due servo SG90 delle antenne ai pin GPIO del Raspberry Pi.
5.3 Collega sensori e periferiche
Collega all'header GPIO del Raspberry Pi l'IMU BNO055 (I2C: SDA a GPIO2, SCL a GPIO3), gli interruttori dei piedi (GPIO22, GPIO27), i LED (GPIO23-25), i servo delle antenne (GPIO12-13 PWM) e l'amplificatore MAX98357A.
- Monta l'unità di misura inerziale (IMU) BNO055 all'interno del corpo. L'IMU si può montare con qualsiasi orientamento: il software può compensare, ma è preferibile l'orientamento naturale.
- Collega il BNO055 al bus I2C del Raspberry Pi (pin SDA e SCL).
- Collega gli interruttori di contatto del piede ai pin GPIO del Raspberry Pi. Consulta lo schema di cablaggio per la corretta assegnazione dei pin.
- Collega i LED degli occhi ai pin GPIO previsti.
- Collega l'amplificatore I2S MAX98357A ai pin I2S del Raspberry Pi.
5.4 Installa il regolatore di tensione
Collega l'UBEC dalla batteria all'ingresso 5V del Raspberry Pi. Verifica tutti i livelli di tensione con un multimetro prima della prima accensione.
- Collega il regolatore di tensione UBEC da 5V all'uscita della batteria.
- Collega l'uscita 5V dell'UBEC all'ingresso di alimentazione 5V del Raspberry Pi. L'UBEC abbassa la tensione della batteria da 7,4V a 5V.
- Collega la linea di alimentazione dei servo direttamente alla batteria (7,4V): i servo non usano l'UBEC.
- Verifica tutti i collegamenti di alimentazione con un multimetro prima dell'accensione. Ricontrolla la polarità di tutti i collegamenti.
- Riordina tutto il cablaggio e fissa i cavi con fascette o nastro per evitare interferenze con le parti in movimento.
6. Configurazione del software e calibrazione
Scrivi Raspberry Pi OS, installa il software Open Duck Mini Runtime, calibra i servo e carica una policy di camminata per le prove.
6.1 Scrivi Raspberry Pi OS
Installa Raspberry Pi OS Lite sulla scheda SD e abilita le interfacce I2C, SPI e I2S in raspi-config.
- Scarica Raspberry Pi OS Lite (64-bit) dal sito ufficiale del Raspberry Pi.
- Scrivi l'immagine del sistema operativo su una scheda microSD (da 16GB o più) con Raspberry Pi Imager.
- Attiva SSH e configura le credenziali WiFi nelle impostazioni avanzate di Raspberry Pi Imager.
- Inserisci la scheda microSD nel Raspberry Pi Zero 2W e accendilo.
- Accedi al Raspberry Pi via SSH per verificare la connettività.
6.2 Installa Open Duck Mini Runtime
Clona e installa il repository Open Duck Mini Runtime (ramo v2). Configura gli offset dei motori per compensare le imperfezioni di allineamento delle squadrette.
- Clona il repository Open Duck Mini Runtime: git clone https://github.com/apirrone/Open_Duck_Mini_Runtime
- Installa le dipendenze Python necessarie seguendo le istruzioni del README.
- Esegui lo script di identificazione dei servo per verificare che tutti i motori rispondano con gli ID corretti.
- Esegui la routine di calibrazione per impostare le posizioni zero dei servo. Durante la calibrazione assicurati che il robot sia in una posa nota (gambe dritte, testa centrata).
6.3 Carica e prova una policy di camminata
Scarica una policy di camminata ONNX preaddestrata, esegui lo script di camminata e verifica che il robot riesca a stare in equilibrio e a fare i primi passi. Regola gli offset dei motori come serve.
- Copia sul Raspberry Pi un file ONNX di una policy di camminata pre-addestrata. Sono fornite due policy: BEST_WALK_ONNX.onnx e BEST_WALK_ONNX_2.onnx
- Tieni il robot sollevato sopra una superficie ed esegui la policy di camminata per verificare il movimento dei motori. Prova prima in aria.
- Appoggia il robot su una superficie piana ed esegui la policy di camminata.
- Regola gli offset dei servo nella configurazione se l'andatura appare asimmetrica.
- Facoltativamente, addestra policy personalizzate con il simulatore Open Duck Playground (github.com/apirrone/Open_Duck_Playground).