Guida al montaggio di Berkeley Humanoid Lite
Robot umanoide open source sotto i 5.000 $ con riduttori stampati in 3D e una pipeline sim-to-real completa
Licenza
MIT
Guida al montaggio
1. Materiali e parti (BOM)
Procurati tutti i componenti necessari, tra cui motori, cuscinetti, ESC, encoder, elettronica e filamento per la stampa 3D. Consulta il foglio di calcolo ufficiale della BOM per le quantità esatte e i link di acquisto.
1.1 Procurati i componenti degli attuatori
Ordina tutte le parti per entrambi i tipi di attuatore: M6C12 (coppia elevata, qtà 10) e 5010 (coppia media, qtà 12).
- Apri il foglio di calcolo ufficiale della BOM ed esamina le sue tre schede: M6C12 Actuator, 5010 Actuator e Humanoid. Le due schede degli attuatori elencano le parti per un attuatore. La scheda Humanoid indica quanti attuatori di ciascun tipo servono per l'intero robot.
- Ordinate 10 motori MAD Components M6C12 150KV, uno per ogni attuatore M6C12. La scheda M6C12 Actuator elenca un 'MAD Components M6C12 150KV' per attuatore. La scheda Humanoid elenca 8 attuatori M6C12 per le gambe e 2 per le braccia. L'articolo e le note di rilascio chiamano questo attuatore 6512.
- Ordina 12 motori MAD Components 5010 110KV, uno per ogni attuatore 5010. La scheda 5010 Actuator elenca "MAD Components 5010 110KV". La scheda Humanoid elenca 4 attuatori 5010 per le gambe e 8 per le braccia. Controlla il KV del motore che acquisti: il firmware contiene anche profili per altri motori 5010 (310KV e 370KV nella pagina Flashing, e un profilo da 200KV aggiunto al firmware il 2025-09-07), ma il motore della BOM è da 110KV.
- Ordina i controller motore B-G431B-ESC1 (22 in tutto) da Digikey o da un fornitore equivalente.
- Ordina encoder magnetici AS5600 (qtà 22) con magneti a magnetizzazione radiale.
- Ordina i cuscinetti elencati in ciascuna scheda degli attuatori. Attuatore M6C12, per attuatore: 13 MR106-2RS, 2 6701-2RS e 2 6811ZZ. Attuatore 5010, per attuatore: 13 MR106-2RS, 2 6701-2RS e 2 6809ZZ. La scheda Humanoid elenca anche 6 6803-2RS, descritti come «Cuscinetto tra il leveraggio sugli attuatori di beccheggio delle gambe». Il registro delle release dice che il cuscinetto 6803 e un inserto M2 mancavano dalla scheda Humanoid fino al 29 maggio 2025, e che le descrizioni di MR106-2RS e 6701-2RS erano invertite fino al 23 maggio 2025, quindi controlla il foglio attuale se hai acquistato da una copia precedente.
- Ordina viti M3, inserti filettati M2/M3 e distanziali esagonali M4 secondo le quantità della BOM.
1.2 Procurati l'elettronica e i componenti strutturali
Ordina l'elettronica principale (computer, IMU, adattatori CAN) e i materiali strutturali.
- Ordina un Mini PC Intel N95 (o equivalente) per l'elaborazione a bordo.
- Ordina una unità di misura inerziale (IMU) BNO085 a 9 assi oppure il modulo IMU IM10A di Hiwonder. La documentazione consiglia vivamente l'IM10A perché si collega direttamente via USB. La versione originale con BNO085 usava un Arduino Nano per collegare l'IMU al computer, e la BOM non elenca alcun Arduino Nano.
- Ordina 4 adattatori USB-CAN (1 Mbps) e 2 hub USB.
- Ordina una batteria LiPo 6S. La BOM elenca 'LiPo battery 6S', e l'articolo indica la batteria del robot come 6S 4000 mAh.
- La scheda Humanoid elenca anche queste parti per l'intero robot: regolatore da 24V a 12V (1), regolatore da 12V a 5V (1), monitor di tensione (1), monitor di corrente (1), interruttore automatico (1), profilato di alluminio da 250 mm (2), 200 mm (4), 150 mm (2) e 100 mm (3), staffa interna in alluminio (24), pinza per servomotore (2). Elenca anche una riga di filamento per stampa 3D, 1 ciascuno per le gambe e per le braccia.
- Sicurezza delle LiPo, dagli appunti di laboratorio dell'autore (non fanno parte della guida di costruzione): non lasciate mai incustodita una batteria in carica. Verificate che tipo di cella, numero di celle e corrente di carica massima impostati sul caricabatterie corrispondano all'etichetta della batteria. La corrente di carica massima è la capacità divisa per un'ora, ad esempio 2200 mAh danno 2,2 A. Non scaricate mai una LiPo sotto i 3 V sotto carico. Se la batteria si gonfia, fermatevi subito e smaltitela.
- Ordina filamento PLA: consigliati Bambu Lab PLA Basic o Hatchbox PLA.
- Ordina il materiale per il cablaggio: cavi di alimentazione 14 AWG, cavi di segnale 30 AWG, connettori XT60 e XT30, connettori WAGO.
2. Preparazione degli attrezzi
Prepara la tua area di lavoro con tutti gli attrezzi necessari prima di iniziare il montaggio.
2.1 Prepara la stampante 3D e l'area di lavoro
Assicurati che la tua stampante 3D soddisfi i requisiti e che l'area di lavoro sia pronta per il montaggio.
- Verifica che la tua stampante 3D abbia un volume di stampa di almeno 200 x 200 x 200 mm. È consigliata la Bambu Lab X1C Carbon. Anche la Creality Ender-3 V3 SE è stata provata con successo.
- Prepara una stazione di saldatura con un saldatore SUGON A9 210 o equivalente.
- Prepara un supporto per inserti a caldo per installare gli inserti filettati nelle parti stampate in 3D.
- Tieni pronta una pistola per colla a caldo per fissare i magneti agli alberi dei motori.
- Procurati un set di chiavi esagonali: misure M2, M2.5, M3, M4 e M6.
- Tieni a portata di mano un cacciavite a croce (+) e uno a taglio (-). Spesso sono inclusi con i componenti che acquisti.
3. Stampa 3D
Stampa tutti i componenti strutturali usando i file STL forniti e i profili di stampa consigliati nella pagina Releases.
3.1 Stampa i componenti degli attuatori
Stampa tutti gli alloggiamenti dei riduttori cicloidali, gli alberi e i gusci dei motori con i profili di stampa Actuator Housing e Actuator Shaft.
- Scarica i file di stampa 3D dalla pagina Releases (sono forniti i link a Bambu Lab MakerWorld).
- Usa l'Actuator Housing Profile per l'alloggiamento, l'albero di uscita e il guscio del motore. Le impostazioni del profilo sono mostrate come screenshot nella pagina 3D Printing Instructions (schede Quality, Strength, Speed, Support, Others).
- Registro delle release, 2025-05-21: il progetto originale ha corretto i file .3mf su MakerWorld dell'attuatore 6512. Registro delle release, 2025-08-23: il progetto originale ha corretto il file di stampa 3D su MakerWorld, "sostituendo la parte errata dell'alloggiamento 5010-5010 e aggiungendo la parte mancante del fermo di fine corsa", e ha aggiunto un'istruzione sul montaggio del magnete sull'albero motore. Se hai scaricato o stampato parti dell'attuatore prima di quelle date, confrontale con i file attuali.
- Usa l'Actuator Shaft Profile per dischi cicloidali, alberi di ingresso, alberi motore e distanziali: richiedono una precisione maggiore.
- I profili di stampa sono ottimizzati per la Bambu Lab X1C. Adatta le impostazioni se usi una stampante diversa.
- Stampa 10 set completi di parti per attuatore M6C12 e 12 set completi per attuatore 5010.
3.2 Stampa le parti strutturali del corpo
Stampa la parte superiore e inferiore del corpo e tutti i componenti strutturali del telaio.
- Stampa le parti della parte superiore del corpo: ogni pezzo va stampato DUE VOLTE, con la seconda copia specchiata lungo l'asse X.
- Stampa le parti della parte inferiore del corpo: stesso requisito di specchiatura della parte superiore.
- Le parti strutturali si possono stampare con impostazioni di velocità più alte, perché la precisione è meno critica.
- La BOM elenca la pinza come parte acquistata, 'Servo motor claw', quantità 2 nella scheda Humanoid. La pagina 3D Printing Instructions non descrive la stampa di una pinza.
- Pulisci le parti stampate prima del montaggio. Il video dell'attuatore M6C12 inizia con un capitolo intitolato 'Clean up parts'.
- Installa gli inserti filettati M2 e M3 in tutti i fori previsti, usando il supporto per inserti a caldo e il saldatore.
4. Costruzione degli attuatori
Monta tutti i 22 attuatori cicloidali (10x M6C12 ad alta coppia, 12x 5010 a coppia media) seguendo le video guide.
4.1 Prepara gli encoder magnetici
Modifica le schede encoder magnetiche AS5600 per integrarle nell'alloggiamento dell'attuatore.
- Segui la video guida AS5600 Encoder Modification (di -T.K.-).
- Usa il magnete a magnetizzazione radiale fornito con l'encoder AS5600: NON sostituirlo con magneti normali.
- Modifica tutte le 22 schede encoder con la stessa procedura.
- Per ulteriori dettagli consulta il tutorial esterno su notes.tk233.xyz/electrical/as5600-modification.
- La modifica si esegue cambiando dei resistori sulla scheda. La pagina AS5600 Modification elenca queste opzioni: per usare 5V sulla porta VCC, rimuovete R1. Per riportare PGO al funzionamento normale, rimuovete R4. Per la rotazione antioraria, collegate DIR a VDD; un ponticello 0R può collegare la piazzola DIR alla parte superiore di R1, che è collegata a VCC (vicino al lato con la scritta 'R1').
- Dopo aver spostato le resistenze, salda anche i fili VCC, GND, SDA e SCL sulle piazzole corrispondenti.
4.2 Prepara i motori
Monta i magneti sugli alberi dei motori e prepara i motori per l'integrazione negli attuatori.
- Usate un po' di colla a caldo per fissare il magnete all'albero del rotore del motore. La pagina mostra come esempio un motore 5010, che ha una clip sull'albero. Il motore M6C12 ha invece una vite all'estremità dell'albero, ma il magnete si monta allo stesso modo.
- Prepara tutti i 10 motori M6C12 e i 12 motori 5010.
4.3 Monta gli attuatori M6C12
Costruisci gli attuatori a coppia elevata con riduttori cicloidali, cuscinetti ed encoder.
- Segui la video guida "Assembling the M6C12 Actuator" di -T.K.-.
- Monta i cuscinetti come li descrive la BOM. MR106-2RS: tra l'albero di ingresso e il disco cicloidale, e tra l'albero di ingresso e l'albero di uscita. 6701-2RS: tra il disco cicloidale e l'albero di uscita. 6811ZZ: tra l'albero di uscita e l'alloggiamento.
- Monta il riduttore cicloidale 15:1 con il disco cicloidale stampato e l'albero di ingresso.
- Monta il motore M6C12 nel guscio del motore e collegalo al riduttore.
- Montate l'encoder AS5600 modificato sopra il magnete che avete incollato all'albero del rotore del motore (capitolo del video 'Attach encoder'). L'encoder legge l'albero motore. Il progetto originale nota che gli attuatori dei giunti hanno un solo encoder, sull'albero motore.
- Ripeti per tutti i 10 attuatori M6C12.
4.4 Monta gli attuatori 5010
Costruisci gli attuatori a coppia media seguendo lo stesso procedimento con le parti specifiche del 5010.
- Il progetto originale pubblica un video di montaggio solo per l'attuatore M6C12. Non pubblica alcun video o testo di montaggio separato per il 5010. L'attuatore 5010 è coperto dalla sua scheda nella BOM, dal suo CAD Onshape e dai suoi file di stampa su MakerWorld, tutti collegati dalla pagina Releases.
- Gli attuatori 5010 sono più piccoli ma usano lo stesso principio di riduttore cicloidale.
- Monta i cuscinetti elencati nella scheda 5010 Actuator: MR106-2RS, 6701-2RS e 6809ZZ.
- Ripeti per tutti i 12 attuatori 5010.
4.5 Salda i collegamenti degli ESC
Salda i cavi di alimentazione, del bus CAN e di segnale su tutti i controller motore B-G431B-ESC1.
- Usa filo 14 AWG per i cavi di alimentazione (positivo=bianco/rosso, massa=nero).
- Per i cavi CAN usate filo in silicone a trefoli da 30 AWG. Codice colori: giallo per CAN-H e SDA, verde per CAN-L e SCL.
- Attenzione: le piazzole di saldatura della porta CAN sull'ESC sono molto fragili e tendono facilmente a staccarsi dallo strato di base in FR4. Fai molta attenzione quando saldi e maneggi la scheda. Non applicare una forza eccessiva sui cavi e sulle piazzole.
- Salda tutte le 22 schede ESC con un codice colori coerente.
- Le piazzole di saldatura dell'encoder e del CAN sono difficili da lavorare. Il progetto originale suggerisce di aggiungere più flussante, così è più facile ottenere un giunto di saldatura solido.
- Collega l'encoder, il motore e il controller del motore secondo lo schema di cablaggio nella pagina Building the Actuator. Lo schema è un'immagine e non è riprodotto qui.
5. Programmazione dei controller dei motori
Carica il firmware su tutti i controller dei motori B-G431B-ESC1 e calibra ogni attuatore.
5.1 Carica il firmware con STM32CubeIDE
Installa e carica il firmware Recoil Motor Controller su ogni ESC.
- Installa STM32CubeIDE sul tuo computer.
- Scarica il firmware con: git clone https://github.com/T-K-233/Recoil-Motor-Controller-BESC.git
- Apri Core/Inc/motor_controller_conf.h e imposta il flag FIRST_TIME_BOOTUP a 1. Questo configura la protezione della Flash, perché la Flash interna dell'STM32 memorizza i parametri di configurazione del motore.
- Collegate il controller del motore al computer tramite la porta Micro USB della scheda del controller. STM32CubeIDE dovrebbe rilevare il nuovo dispositivo. Fate clic sul pulsante Run. Una scheda nuova chiede di aggiornare il firmware del debugger ST-LINK: accettate, seguite le istruzioni, poi fate di nuovo clic su Run.
- Spegni e riaccendi la scheda scollegando e ricollegando il cavo USB. Poi riporta il flag FIRST_TIME_BOOTUP a 0.
- Segui la video guida "Flashing the Motor Controller Firmware".
- Carica il firmware su tutte le 22 schede ESC.
5.2 Configura i parametri degli attuatori
Imposta il CAN ID e seleziona il profilo motore in motor_controller_conf.h per ogni attuatore, poi carica il firmware.
- Per un attuatore M6C12, togli il commento a #define MOTORPROFILE_MAD_M6C12_150KV. Usa il firmware attuale: il profilo M6C12 è stato rimisurato il 2025-09-07 (costante di coppia 0.08958, in precedenza 0.0919).
- Per un attuatore 5010, togliete il commento a #define MOTORPROFILE_MAD_5010_110KV, perché il motore della distinta base è il MAD Components 5010 110KV. Non usate MOTORPROFILE_MAD_5010_310KV né MOTORPROFILE_MAD_5010_370KV: nel firmware questi due profili hanno la riga MOTOR_TORQUE_CONSTANT commentata. La configurazione dei giunti salvata del robot per i giunti 5010 riporta una costante di coppia di 0.1176, che corrisponde al profilo 110KV.
- Imposta DEVICE_CAN_ID in motor_controller_conf.h secondo la pagina Joint ID Mapping. Gli ID sono univoci su ciascun bus CAN, non sull'intero robot. Braccio sinistro (CAN0): 1, 3, 5, 7, 9. Braccio destro (CAN1): 2, 4, 6, 8, 10. Gamba sinistra (CAN2): rollio dell'anca 1, imbardata dell'anca 3, beccheggio dell'anca 5, beccheggio del ginocchio 7, beccheggio della caviglia 11, rollio della caviglia 13. Gamba destra (CAN3): rollio dell'anca 2, imbardata dell'anca 4, beccheggio dell'anca 6, beccheggio del ginocchio 8, beccheggio della caviglia 12, rollio della caviglia 14. Il firmware accetta valori da 1 a 63.
- Scorrete verso il basso nello stesso file e impostate LOAD_ID_FROM_FLASH e LOAD_CONFIG_FROM_FLASH a 0, in modo che il programma sovrascriva i valori casuali predefiniti nella Flash. Fate clic su Run. Poi scollegate e ricollegate il cavo USB per assicurarvi che l'opzione flash sia stata caricata. Il LED dovrebbe lampeggiare a circa 1 Hz, a indicare che il programma è caricato e in esecuzione.
- Reimpostate LOAD_ID_FROM_FLASH e LOAD_CONFIG_FROM_FLASH a 1 e fate clic su Run per scrivere un'ultima volta. A questo punto il pulsante Run è stato premuto quattro volte, e sia il firmware sia i parametri di configurazione sono caricati.
5.3 Calibra tutti gli attuatori
Esegui la routine di calibrazione su ogni attuatore tramite bus CAN con gli script Python forniti.
- Collega il bus CAN dell'attuatore al computer tramite l'adattatore USB-CAN, poi accendi l'attuatore. Avvia il trasporto CAN con: sudo ip link set can0 up type can bitrate 1000000
- Verificate la connessione con: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1 (l'argomento -c è il trasporto CAN, l'argomento -i è il CAN ID). Lo script dovrebbe stampare 'Motor is online'. Se stampa 'Motor is offline', controllate il collegamento del cavo di segnale, l'alimentazione e le impostazioni del CAN ID.
- Assicurati che all'attuatore non sia collegato nulla e che possa girare liberamente. Esegui: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/calibrate_electrical_offset.py -c can0 -i 1. Avvertenza del progetto originale: il motore girerà e assorbirà una corrente notevole (circa 1 A dall'alimentatore). Assicurati che i cavi di alimentazione siano collegati correttamente e che l'attuatore possa girare liberamente. Il motore aumenta lentamente la coppia di mantenimento finché la corrente di fase non raggiunge il valore obiettivo, ruota in senso antiorario per un giro meccanico completo, poi torna indietro in senso orario per un giro.
- Se il verso di rotazione è invertito (prima orario, poi antiorario), scambiate due qualsiasi dei tre fili di fase del motore, oppure impostate MOTOR_PHASE_ORDER a -1 nel firmware. Il registro delle release ha aggiunto questa nota il 2025-07-07.
- Segui il video "Motor Calibration" per la procedura corretta.
- Per controllare l'attuatore, esegui: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/move_actuator.py -c can0 -i 1. Il comando muove l'attuatore lungo una curva di posizione sinusoidale. Avvertenza del progetto originale: il motore girerà. Parti da valori bassi di kP, kD e limite di coppia. Se succede qualcosa di imprevisto, premi Ctrl+C per fermare il programma e l'attuatore.
- Calibra tutti i 22 attuatori.
6. Costruzione del robot
Monta le braccia, le gambe e il corpo intero usando gli attuatori calibrati e le parti strutturali stampate in 3D.
6.1 Monta le braccia
Costruisci entrambi i gruppi delle braccia con i giunti della spalla (3 gradi di libertà) e del gomito (2 gradi di libertà: beccheggio e imbardata del gomito), poi fissa una pinza a ciascuno.
- Segui la video guida "Assembling the Arm" di -T.K.-.
- Installa gli attuatori 5010 per il rollio della spalla, l'imbardata della spalla, il beccheggio del gomito e l'imbardata del gomito: quattro attuatori 5010 per braccio. La scheda Humanoid elenca 8 attuatori 5010 per le due braccia.
- Montate un attuatore M6C12 per il giunto di beccheggio della spalla, uno per braccio. La scheda Humanoid elenca 2 attuatori M6C12 per le braccia. Il testo del progetto originale non indica l'attuatore di ciascun giunto del braccio; è mostrato nel video Assembling the Arm, che non è stato visionato. Questa assegnazione segue le quantità della distinta base e la configurazione dei giunti salvata del robot.
- Fissa i gruppi pinza a ciascun braccio.
- Costruisci sia il braccio sinistro sia il destro (gruppi speculari).
6.2 Monta le zampe
Costruisci entrambi i gruppi delle gambe con i giunti dell'anca (3 gradi di libertà), del ginocchio (1 grado di libertà) e della caviglia (2 gradi di libertà).
- Segui la video guida "Assembling the Leg" di -T.K.-.
- Installa gli attuatori M6C12 per rollio dell'anca, imbardata dell'anca, beccheggio dell'anca e beccheggio del ginocchio: quattro attuatori M6C12 per gamba. La scheda Humanoid elenca 8 attuatori M6C12 per le gambe.
- Installa gli attuatori 5010 per il beccheggio e il rollio della caviglia: due attuatori 5010 per gamba. La scheda Humanoid elenca 4 attuatori 5010 per le gambe. Il testo del progetto originale non indica l'attuatore di ciascun giunto; l'assegnazione segue i conteggi della BOM e i file citati sopra, e il video Assembling the Leg potrebbe mostrarla. Quel video non è stato visionato.
- Il video Assembling the Leg ha questi capitoli: base dell'anca, rollio dell'anca, imbardata dell'anca, beccheggio dell'anca, beccheggio del ginocchio, beccheggio e rollio della caviglia. Correzione nella descrizione del video: "nel video ho montato la struttura dell'anca in modo errato. Il beccheggio dell'anca va montato al contrario: ho confuso la gamba sinistra con la destra." Monta il beccheggio dell'anca al contrario rispetto al video.
- La scheda Humanoid elenca 6 cuscinetti 6803-2RS per le gambe, descritti come 'cuscinetto tra il leveraggio sugli attuatori di beccheggio delle gambe'.
- Costruisci sia la gamba sinistra sia la destra (gruppi speculari).
6.3 Monta il corpo completo
Unisci braccia, gambe e torso nel robot umanoide completo.
- Segui la video guida "Assembling the Body" di -T.K.-.
- Il video Assembling the Body ha questi capitoli: Attaching the battery holder, Preparing the hip, Base structure, Attaching the base, Attach the arm.
6.4 Cablaggio ed elettronica
Completa tutti i collegamenti elettrici, compresi il bus CAN, la distribuzione dell'alimentazione e il computer di bordo.
- Collega i cavi CAN direttamente alla morsettiera a vite della scheda adattatore USB-CAN. L'ordine è CAN-L, CAN-H, GND, e i nomi dei segnali sono riportati anche sul retro del PCB. Il robot usa quattro bus: CAN0 braccio sinistro, CAN1 braccio destro, CAN2 gamba sinistra, CAN3 gamba destra.
- Cavi di segnale: saldali direttamente tra loro e proteggi le giunzioni con guaina termorestringente. Cavi di alimentazione: al primo collegamento, i connettori WAGO (il robot usa i tipi a due, tre e cinque poli) permettono di collegare e scollegare ciascun attuatore dal bus di alimentazione principale senza saldare, il che semplifica il debug. Per una costruzione più definitiva, salda direttamente i cavi tra loro.
- Tra gli attuatori i cavi si possono collegare con connettori XT30 e XT60. Il progetto originale usa XT60 per unire il cavo principale, e ogni attuatore è collegato al bus di alimentazione principale con un connettore XT30.
- Monta il Mini PC Intel N95 e collega gli hub USB.
- Collega gli adattatori USB-CAN agli hub USB.
- Installa l'unità di misura inerziale (IMU), consigliata la IM10A, collegandola via USB direttamente al computer di bordo.
- Monta la batteria LiPo 6S nel torso.
- Avvertenza dalla home page del progetto originale: «Questo non è solo un progetto software. Include progetti di elettronica ad alta potenza. Finora non ha bruciato nessun laboratorio della UC Berkeley né la casa di nessuno, ma non ci sono garanzie : )» «Segui tutti i passaggi con estrema cautela.» Controlla la polarità prima di collegare l'alimentazione: nel codice colori del progetto originale il bianco o il rosso è il positivo e il nero è la massa.
7. Configurazione del software e prove
Configura l'ambiente software, distribuisci le policy e verifica che il robot funzioni correttamente.
7.1 Configura il computer di bordo
Installa il sistema operativo e il software necessario sull'Intel N95 Mini PC.
- Installa Ubuntu 22.04 sul computer di bordo. Il progetto originale dice che la 22.04 funziona bene con il suo stack software e hardware, e indica come computer il BeeLink N95 NUC. La pagina lascia il tasto del BIOS come 'XXXX'.
- Clona il repository Berkeley-Humanoid-Lite.
- Installa i pacchetti elencati nella pagina: sudo apt install build-essential cmake net-tools can-utils python3-pip. I comandi eseguono Python tramite uv; la pagina Training Environment riporta il comando che installa uv. Il pyproject.toml del workspace richiede Python 3.11 (requires-python >=3,11,<3.12).
- Il progetto originale dice che sul robot serve solo il contenuto di source/berkeley_humanoid_lite_lowlevel/.
- Avvia i trasporti CAN con: source ./scripts/start_can_transports.sh. Attiva da can0 a can3 con bitrate 1000000. Per fermarli: source ./scripts/stop_can_transports.sh
7.2 Prova la comunicazione degli attuatori
Verifica che tutti i 22 attuatori rispondano correttamente sul bus CAN dal computer di bordo.
- Prova un attuatore con lo script di ping. La pagina Flashing indica: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1. La pagina On-board Computer indica un percorso e delle opzioni più vecchi (python ./berkeley_humanoid_lite_lowlevel/motor/ping.py --port can0 --id 1) che non esistono più nel repository Lowlevel. Con due braccia e due gambe collegate, la porta CAN è una tra can0, can1, can2 o can3, e l'ID CAN è compreso tra 1 e 14.
- Controlla ogni giunto con lo script move_actuator.py del passaggio precedente, partendo da valori bassi di kP, kD e limite di coppia.
- Verifica che CAN ID e bus di ciascun attuatore corrispondano alla pagina Joint ID Mapping. L'elenco dei giunti usato dal software si trova in berkeley_humanoid_lite_lowlevel/robot/humanoid.py, che elenca le gambe e ha i giunti delle braccia commentati.
7.3 Distribuisci la policy di locomozione
Carica una policy di locomozione addestrata e prova la camminata di base.
- Il repository contiene policy ONNX in checkpoints/ (per esempio policy_humanoid.onnx e policy_humanoid_legs.onnx) con i relativi file YAML in configs/. Lo script di addestramento play.py esporta una policy addestrata in ONNX e aggiorna configs/policy_latest.yaml.
- Per eseguire tutto insieme, assicuratevi prima che i trasporti CAN siano avviati. Il codice di basso livello si può eseguire in due modi. Codebase C, consigliata per la locomozione per migliori garanzie real-time: in ./csrc/ eseguite make, poi ./build/real_humanoid. Se l'adattatore USB-CAN non riesce a mantenere la frequenza di comunicazione, la pagina suggerisce il kernel real-time xanmod. Codebase Python: eseguite uv run ./scripts/python/run_locomotion.py dalla directory lowlevel. Nell'attuale repository Lowlevel lo script è scripts/run_locomotion.py, quindi il percorso indicato nella pagina non è aggiornato. Il robot segue la stessa transizione di stato della simulazione sim2sim in MuJoCo.