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 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.

  1. Scarica e installa Open Duck Mini Runtime da GitHub (github.com/apirrone/Open_Duck_Mini_Runtime).
  2. Collega ogni servo Feetech STS3215, uno alla volta, alla scheda driver dei servo tramite USB.
  3. 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.
  4. Configura i servo della gamba sinistra con gli ID: hip_yaw=20, hip_roll=21, hip_pitch=22, knee=23, ankle=24.
  5. Configura i servo della gamba destra con gli ID: hip_yaw=10, hip_roll=11, hip_pitch=12, knee=13, ankle=14.
  6. Configura i servo di testa e collo con gli ID: neck_pitch=30, head_pitch=31, head_yaw=32, head_roll=33.
  7. 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.

  1. Fissa la squadretta appropriata a ogni servo STS3215 con la minuteria inclusa.
  2. Assicurati che ogni servo sia nella posizione zero/centrale prima di fissare la squadretta. La posizione zero è fondamentale per il corretto allineamento dei giunti.
  3. 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.

  1. Scarica tutti i file STL dalla cartella di stampa di Open Duck Mini V2 su GitHub.
  2. Stampa tutte le parti in PLA con impostazioni standard e riempimento del 15%.
  3. 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.
  4. Stampa in quantità x2 le parti simmetriche: foot_top, foot_side, foot_bottom_pla, foot_bottom_tpu, roll_motor_bottom, roll_motor_top.
  5. Stampa in quantità x4: knee_to_ankle_left_sheet, knee_to_ankle_right_sheet, leg_spacer.
  6. Stampa in quantità x1 tutte le restanti parti di corpo, testa, tronco e accessori (circa 24 parti diverse).
  7. 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.

  1. Monta foot_bottom_tpu su foot_bottom_pla per ogni piede.
  2. Inserisci con un saldatore gli inserti filettati a caldo M3 nei fori previsti di foot_bottom_pla.
  3. Fissa foot_bottom_pla a foot_top con 2x viti M3x6 per piede.
  4. Inserisci altri inserti filettati a caldo M3 in foot_top per il montaggio del motore.
  5. Monta il servomotore della caviglia su foot_top con il lato del driver rivolto verso l'esterno.
  6. 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.
  7. Fai passare i fili degli interruttori del piede e il cavo del servo verso l'alto attraverso il canale della gamba.
  8. 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.

  1. Inserisci 4 inserti filettati a caldo M3 in ogni leg_spacer (su entrambi i lati).
  2. Fai passare il cavo del motore dal gruppo del piede attraverso la parte right_sheet.
  3. Inserisci il leg_spacer tra le parti laterali sinistra e destra (knee_to_ankle_left_sheet e knee_to_ankle_right_sheet).
  4. Fissa il gruppo dello stinco con viti M3x10 che attraversano le piastre ed entrano negli inserti del distanziale.
  5. Monta il servo del ginocchio in cima al gruppo dello stinco.
  6. 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.

  1. Monta la coscia con lo stesso procedimento del gruppo dello stinco, con piastre e distanziale.
  2. Monta il servomotore hip_pitch con l'orientamento corretto per la posizione zero. Fai molta attenzione: un posizionamento errato compromette l'andatura.
  3. Collega il sottogruppo della coscia alla parte superiore dello stinco tramite la squadretta del servo del ginocchio.
  4. 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.

  1. 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.
  2. Monta roll_motor_top sul servo hip_yaw, avvitando dal basso.
  3. Fissa la parte hip_roll per completare il gruppo del giunto dell'anca.
  4. Inserisci il sottogruppo della gamba completato nel meccanismo dell'anca.
  5. Fissalo con le viti per plastica incluse nel kit del servo.
  6. Ripeti l'intero montaggio dell'anca per la seconda gamba.
  7. 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.

  1. Inserisci a pressione i cuscinetti nei fori per cuscinetti di trunk_bottom.
  2. Inserisci gli inserti filettati a caldo M3 nei fori dei cuscinetti e nei 4 fori di montaggio sul fondo di trunk_bottom.
  3. Appoggia trunk_top su trunk_bottom e fissalo con 2x viti M3x10.
  4. Monta il motore centrale (rotazione del tronco) con le viti per plastica del kit del servo.
  5. 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.

  1. Fissa il gruppo dell'anca della gamba sinistra al lato sinistro del tronco.
  2. Fissa il servo hip_yaw nel tronco usando i punti di montaggio di roll_motor_bottom.
  3. Fai passare tutti i cavi dei servo della gamba sinistra nei canali per cavi del tronco.
  4. Ripeti per il gruppo della gamba destra sul lato destro del tronco.
  5. 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.

  1. Avvita body_middle_bottom sul telaio del tronco.
  2. Inserisci gli inserti filettati a caldo M3 sia in body_middle_bottom sia in body_middle_top.
  3. Monta body_middle_top sul gruppo. Inseriscilo prima di completare la testa, per non dover smontare dopo.
  4. Fissa il pannello body_front sulla parte anteriore del robot.
  5. 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.

  1. Fissa neck_left_sheet e neck_right_sheet al servo neck_pitch.
  2. Monta il gruppo del collo in cima al telaio del tronco.
  3. 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à.

  1. Monta head_pitch_to_yaw sull'uscita del gruppo del collo.
  2. Fissa il servo head_yaw e la parte head_yaw_to_roll.
  3. Monta head_roll_mount sul servo head_roll per completare il meccanismo della testa a 3 gradi di libertà.
  4. 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.

  1. Inserisci gli inserti filettati a caldo M3 in tutti i fori di montaggio del guscio della testa.
  2. Inserisci a pressione il cuscinetto per la rotazione della testa.
  3. Monta i due micro servo SG90 per il movimento delle orecchie-antenna.
  4. Fissa left_antenna_holder e right_antenna_holder ai servo SG90.
  5. Monta il Raspberry Pi Zero 2W all'interno della testa con viti M3.
  6. Installa i LED per l'illuminazione degli occhi nelle parti left_eye e right_eye.
  7. Monta l'amplificatore MAX98357A e il piccolo altoparlante con speaker_interface e speaker_stand.
  8. Fissa il guscio della testa completato al meccanismo della testa.
  9. 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.

  1. Inserisci due celle Li-Ion 18650 nel portacelle 2S. Assicurati che entrambe le celle siano caricate alla stessa tensione prima di inserirle.
  2. Collega il BMS 2S (sistema di gestione della batteria) al portacelle.
  3. Collega il modulo di ricarica USB-C al BMS per poter ricaricare.
  4. Installa l'interruttore di alimentazione in serie sul conduttore positivo della batteria.
  5. Metti il pacco batteria completato nell'involucro battery_pack_lid.
  6. 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.

  1. Monta la scheda di controllo dei servo Feetech all'interno del corpo.
  2. Collega tutti i cavi dei servo STS3215 alla scheda di controllo dei servo in configurazione daisy chain. I servo STS3215 usano un bus seriale.
  3. Collega la scheda di controllo dei servo al Raspberry Pi tramite USB.
  4. 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.

  1. 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.
  2. Collega il BNO055 al bus I2C del Raspberry Pi (pin SDA e SCL).
  3. Collega gli interruttori di contatto del piede ai pin GPIO del Raspberry Pi. Consulta lo schema di cablaggio per la corretta assegnazione dei pin.
  4. Collega i LED degli occhi ai pin GPIO previsti.
  5. 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.

  1. Collega il regolatore di tensione UBEC da 5V all'uscita della batteria.
  2. 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.
  3. Collega la linea di alimentazione dei servo direttamente alla batteria (7,4V): i servo non usano l'UBEC.
  4. Verifica tutti i collegamenti di alimentazione con un multimetro prima dell'accensione. Ricontrolla la polarità di tutti i collegamenti.
  5. 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.

  1. Scarica Raspberry Pi OS Lite (64-bit) dal sito ufficiale del Raspberry Pi.
  2. Scrivi l'immagine del sistema operativo su una scheda microSD (da 16GB o più) con Raspberry Pi Imager.
  3. Attiva SSH e configura le credenziali WiFi nelle impostazioni avanzate di Raspberry Pi Imager.
  4. Inserisci la scheda microSD nel Raspberry Pi Zero 2W e accendilo.
  5. 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.

  1. Clona il repository Open Duck Mini Runtime: git clone https://github.com/apirrone/Open_Duck_Mini_Runtime
  2. Installa le dipendenze Python necessarie seguendo le istruzioni del README.
  3. Esegui lo script di identificazione dei servo per verificare che tutti i motori rispondano con gli ID corretti.
  4. 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.

  1. 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
  2. Tieni il robot sollevato sopra una superficie ed esegui la policy di camminata per verificare il movimento dei motori. Prova prima in aria.
  3. Appoggia il robot su una superficie piana ed esegui la policy di camminata.
  4. Regola gli offset dei servo nella configurazione se l'andatura appare asimmetrica.
  5. Facoltativamente, addestra policy personalizzate con il simulatore Open Duck Playground (github.com/apirrone/Open_Duck_Playground).

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