Guida al montaggio di MABEL
Robot mobile bimanuale open source a 56 gradi di libertà, teleoperato con tutto il corpo da un Vision Pro
Licenza
- software: Apache 2.0
- hardware design files (CAD, PCB): CERN-OHL-S 2.0 (strongly reciprocal)
- documentation and media: CC BY 4.0
Licenze separate. Il software è Apache-2.0, i file di progetto hardware (CAD, PCB) sono CERN-OHL-S-2.0, una licenza open hardware fortemente reciproca che richiede di condividere i progetti modificati alle stesse condizioni, e la documentazione e i media sono CC BY 4.0. I componenti dei progetti originali mantengono le proprie licenze, elencate in THIRD_PARTY_NOTICES.md: i bracci derivano da OpenArm e le mani dalla ORCA Hand. Verificato il 4 nov 2026.
Guida al montaggio
1. Prima di iniziare
Di cosa è fatto MABEL e quali parti si acquistano, si realizzano o si costruiscono a partire da altri progetti open source.
1.1 Sappi cosa stai costruendo
MABEL unisce moduli acquistati, due sottogruppi aperti e un piccolo insieme di parti personalizzate proprie.
- MABEL è un robot mobile bimanuale: una base swerve a tre moduli, un sollevamento verticale, un busto basculante, una testa a 3 gradi di libertà con telecamere stereo, due bracci a 7 gradi di libertà e due mani a 17 gradi di libertà.
- I bracci derivano da OpenArm e le mani dalla ORCA Hand; entrambi si costruiscono come li pubblicano i rispettivi progetti.
- I moduli swerve (REV MAXSwerve) e il sollevamento (una colonna da scrivania regolabile in altezza) sono componenti commerciali.
- I pezzi propri di MABEL sono sette piastre in lamiera, coperture e supporti stampati, profilati in alluminio e un PCB personalizzato, la scheda carrier della base.
1.2 Scegli il livello di costruzione
Tutto, tranne cinque scelte, è uguale in ogni costruzione.
- Ordina prima i pezzi principali: la Build Guide del progetto originale li elenca nelle sezioni da 1 a 8, identici nelle build Essential, Recommended e Maximum.
- Poi fai le cinque scelte della sezione 9: computer di bordo, le due telecamere da polso, la telecamera della testa, una telecamera di profondità opzionale per la base e il lidar 2D.
- Le scelte consigliate dal progetto originale sono Orin NX 16 GB, telecamere da polso MMlove 1200P, la telecamera stereo per la testa MMlove, nessuna telecamera di profondità per la base e un RPLIDAR C1.
- Le tre build di riferimento differiscono solo per queste cinque scelte; vedi l'elenco dei pezzi di questo progetto per i prezzi attuali.
2. Ordina le parti
L'elenco delle parti principali e la provenienza di ciascuna parte.
2.1 Ordina le parti principali
L'elenco con i costi del progetto originale è il riferimento; ogni riga ha un link al venditore.
- Usa l'elenco dei pezzi di questo progetto, ricavato dal core.csv del progetto originale, che il progetto originale indica come fonte di riferimento per la distinta base.
- La maggior parte degli attuatori, il set strutturale OpenArm, il cablaggio dei bracci e i servo delle mani si acquistano su Taobao; i moduli swerve vengono da REV, la colonna di sollevamento da FlexiSpot, i profilati da McMaster-Carr.
- Controlla le voci aperte nell'elenco dei pezzi: il progetto originale segnala i pezzi di cui non ha ancora calcolato il costo, come spedizione, filamento e i componenti della scheda carrier.
3. Realizza le parti personalizzate di MABEL
Le piastre in lamiera, le parti stampate e i tagli dei profilati.
3.1 Procurati il CAD
Tutte le parti personalizzate provengono da un unico assieme STEP del robot completo.
- Decomprimi hardware/cad/MABEL_full_assembly.step.zip e apri lo STEP con qualsiasi strumento CAD, come FreeCAD, Onshape, Fusion o SolidWorks.
- Le mesh per segmento dell'intero robot si trovano anche in simulation/mabel_mujoco/assets/meshes, ma realizza i pezzi dallo STEP.
3.2 Fai realizzare le piastre in lamiera
Sette piastre, con preventivo in alluminio 5052 H32 da 2,0 mm (0.080 in).
- Carica il DXF o lo STEP di ogni piastra su un servizio online di lavorazione lamiera, in alluminio 5052 H32 da 2,0 mm di spessore.
- Lamiera della base, inferiore: solo taglio laser.
- Lamiera della base, superiore: 4 pieghe, imbutiture, inserimento della minuteria e filettatura.
- Adattatore tra sollevamento e busto: 2 pieghe, imbutiture, inserimento della minuteria e filettatura.
- Piastra di uscita del busto: 1 piega, inserimento della minuteria e filettatura.
- Piastra inferiore del corpo: 2 pieghe, inserimento della minuteria e filettatura.
- Piastra di montaggio del collo: solo 2 pieghe.
- Piastre di montaggio dei bracci (due): inserimento della minuteria e filettatura.
- Inserimento della minuteria significa dadi o distanziali PEM inseriti a pressione dal fornitore, e filettatura significa fori filettati eseguiti lì e non sul tuo banco.
3.3 Stampa le parti stampate e taglia i profilati
Coperture, supporti dei sensori e finiture sono stampati; il telaio è in profilati da 2x2 in e 2x4 in.
- Stampa le coperture, i supporti dei sensori e le finiture dallo STEP con filamento da 1,75 mm (sezione 8 della Build Guide).
- Taglia i profilati in alluminio alle lunghezze della voce 6.01 della Build Guide, che il progetto originale elenca senza unità di misura: profilo 2x2 in a 15 (2), 17 (2), 4.75 (3) e 8 (2); profilo 2x4 in a 10 (1) e 12.5 (2).
- Unisci il telaio con le squadrette angolari e le piastre angolate della serie 1010 delle voci 6.02 e 6.03.
4. Costruisci i sottogruppi
Bracci, mani, moduli swerve e sollevamento, ciascuno costruito come lo pubblica il rispettivo autore.
4.1 Costruisci i due bracci
I bracci derivano da OpenArm e si costruiscono come li pubblica OpenArm.
- Costruisci entrambi i bracci a 7 gradi di libertà con la nostra guida OpenArm, che segue la documentazione hardware di OpenArm.
- Il firmware dei bracci di MABEL comanda ogni braccio sul proprio bus CAN con il set di motori OpenArm: DM8009 per i giunti 1 e 2, DM4340 per i giunti 3 e 4, DM4310 per i giunti da 5 a 7.
- Prima del primo utilizzo, controlla p_max, v_max e t_max di ogni motore DaMiao nello strumento del produttore; il progetto originale avverte che una discrepanza riscala silenziosamente ogni valore trasmesso.
4.2 Costruisci le due mani
Le mani derivano da ORCA e funzionano con servo Feetech.
- Costruisci entrambe le mani con la nostra guida ORCA Hand, usando la sua build Feetech: le mani di MABEL usano servo Feetech HL3915M e HL3930M, 17 per mano (16 per le dita più quello del polso).
- Ogni mano richiede una scheda driver per servo su bus e una scheda di distribuzione dell'alimentazione (voci 4.03 e 4.04 della Build Guide).
- Posiziona i tendini e calibra una mano appena assemblata prima di attivare la coppia: ogni comando viene limitato all'intervallo calibrato.
4.3 Costruisci i moduli swerve e monta il sollevamento
Sono entrambi parti commerciali.
- Assembla i tre moduli REV MAXSwerve (REV-21-3005) come documentato da REV.
- Monta la colonna di sollevamento FlexiSpot E7 Pro (CBR4830MD-E7WS); MABEL comanda il motore DC della colonna da un Raspberry Pi Pico tramite un ponte H BTS7960, leggendo il suo encoder in quadratura.
- Monta i tre moduli in posizione anteriore destra, anteriore sinistra e posteriore centrale: il firmware della base assegna i loro ID CAN in quest'ordine.
5. Realizza la scheda di supporto della base
L'unico PCB personalizzato: una scheda di supporto per Teensy 4.1 che gestisce la base swerve.
5.1 Ordina e assembla la scheda
Una scheda a 2 strati con tre bus CAN, Ethernet, uscite a 24 V e un'IMU.
- Comprimi in zip electrical/Motherboard/fab e caricalo su qualsiasi servizio PCB a 2 strati; lo stack-up è in fab/Motherboard-job.gbrjob.
- Procurati i componenti in base allo schema elettrico in electrical/exports/Motherboard_schematic.pdf.
- La scheda fornisce un bus CAN per ogni modulo swerve, Ethernet verso il computer del robot, 24 V su tre uscite XT30 e un'IMU BNO085.
- Il progetto originale riferisce di averla prodotta e validata al banco: flash, Ethernet e tutti e tre i bus CAN.
6. Carica il firmware e attiva i bus
Due schede Teensy 4.1, un Raspberry Pi Pico per il sollevamento e il bus dei servo delle mani.
6.1 Carica il firmware della base swerve
Il Teensy della base comanda i controller REV SPARK a 1 Mbit/s.
- In firmware/swerve_drive, esegui pio run -e teensy41 -t upload.
- Esegui ./setup_can.sh per attivare can0 a 1 Mbit/s.
- Esegui scripts/verify_can_motors.py e verifica che rispondano tutti e sei i controller SPARK: gli ID dispari sono di trazione, quelli pari di sterzo.
6.2 Carica il firmware di bracci, torso e collo
Un solo Teensy comanda entrambi i bracci, il torso e il collo da un file di configurazione sulla sua scheda SD.
- Copia config/robot.json sulla scheda SD del Teensy e imposta net.ip per la tua rete.
- In firmware/openarm_dual, esegui pio run -e teensy41 -t upload; se il primo caricamento non riesce, riprova una volta, mai dopo un caricamento riuscito.
- Apri il monitor seriale a 115200 baud: elenca ogni attuatore, attivo o no.
- Imposta gli ID dei motori da un host con un dongle USB-CAN DaMiao usando scripts/dm_configurator.py; gli ID devono essere univoci per bus.
- Il bus Dynamixel del collo usa logica a 5 V e i pin del Teensy non tollerano i 5 V, quindi usa un traslatore di livello.
6.3 Carica il firmware del controller di sollevamento
Il sollevamento funziona con MicroPython su un Raspberry Pi Pico.
- Esegui pip install mpremote, poi firmware/lift/tools/deploy.sh.
- Esegui calibrate una volta in modo che il sollevamento trovi il suo pavimento e il suo soffitto; esegui di nuovo home se la colonna è stata mossa a mano mentre era spenta.
6.4 Controlla le mani e i bus CAN
Le mani non richiedono il caricamento del firmware.
- Esegui firmware/orca_hand/feetech/scripts/scan.py e controlla gli ID dei servo da 1 a 17 su ogni mano.
- Esegui firmware/can_up.sh --ping per attivare SocketCAN e interrogare i motori DaMiao.
7. Prime prove e calibrazione
Prova ogni sottosistema in sicurezza, poi calibra.
7.1 Prova la base in sicurezza
Le regole del progetto originale per la prima guida della base swerve.
- Solleva le ruote da terra per i primi test.
- Esegui scripts/set_drive_limits.py una volta per scrivere nella flash un limite di uscita della trazione prima di guidare sul pavimento.
- Imposta STEER_OFFSET, DRIVE_SIGN, WHEEL_RADIUS e DRIVE_GEAR_RATIO all'inizio di swerve_teleop.py prima della prima guida reale.
- Un solo programma può comandare il bus: arresta il software del robot prima di usare questi strumenti sul robot.
7.2 Calibra i motori e le mani
Le finestre degli encoder, i versi dei giunti e la compensazione della gravità sono memorizzati in un unico file di calibrazione.
- Installa gli strumenti di calibrazione con pip install -r calibration/requirements.txt.
- Esegui calibration/motor_calibration/hardware/scan.sh per elencare i motori senza alimentarli.
- Identifica attrito e inerzia di ogni motore con run_hardware.sh, stando lontano dall'albero e con una mano sull'arresto di emergenza.
- Esegui la scansione dei finecorsa di ogni mano: python3 -m mabel_hw.drivers.orcahand.calibrate --model left, poi right.
7.3 Avvia l'intero robot
Compila una volta il workspace ROS 2, poi avvia tutto da un unico script.
- Sul computer del robot, esegui ros/dev_up.sh una volta per compilare il workspace ROS 2 Jazzy.
- Dalla radice del repository, esegui bash server/real_run.sh e apri il Control Center sulla porta 8094 o collega l'app per Vision Pro.
- I bracci si avviano senza coppia; l'operatore attiva la coppia esplicitamente. Sappi dov'è l'arresto di emergenza prima di attivare la coppia.
- Sostieni i bracci prima di arrestare l'host: senza pacchetti dall'host per 250 ms, tutti i motori dei bracci vengono disattivati.
- Ogni movimento della base passa un controllo antiribaltamento che limita la velocità in base all'altezza del sollevamento.