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

  1. 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à.
  2. I bracci derivano da OpenArm e le mani dalla ORCA Hand; entrambi si costruiscono come li pubblicano i rispettivi progetti.
  3. I moduli swerve (REV MAXSwerve) e il sollevamento (una colonna da scrivania regolabile in altezza) sono componenti commerciali.
  4. 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

  1. 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.
  2. 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.
  3. 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.

  1. Decomprimi hardware/cad/MABEL_full_assembly.step.zip e apri lo STEP con qualsiasi strumento CAD, come FreeCAD, Onshape, Fusion o SolidWorks.
  2. 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).

  1. 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.
  2. Lamiera della base, inferiore: solo taglio laser.
  3. Lamiera della base, superiore: 4 pieghe, imbutiture, inserimento della minuteria e filettatura.
  4. Adattatore tra sollevamento e busto: 2 pieghe, imbutiture, inserimento della minuteria e filettatura.
  5. Piastra di uscita del busto: 1 piega, inserimento della minuteria e filettatura.
  6. Piastra inferiore del corpo: 2 pieghe, inserimento della minuteria e filettatura.
  7. Piastra di montaggio del collo: solo 2 pieghe.
  8. Piastre di montaggio dei bracci (due): inserimento della minuteria e filettatura.
  9. 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.

  1. Stampa le coperture, i supporti dei sensori e le finiture dallo STEP con filamento da 1,75 mm (sezione 8 della Build Guide).
  2. 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).
  3. 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.

  1. Costruisci entrambi i bracci a 7 gradi di libertà con la nostra guida OpenArm, che segue la documentazione hardware di OpenArm.
  2. 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.
  3. 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.

  1. 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).
  2. 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).
  3. 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.

  1. Assembla i tre moduli REV MAXSwerve (REV-21-3005) come documentato da REV.
  2. 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.
  3. 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.

  1. Comprimi in zip electrical/Motherboard/fab e caricalo su qualsiasi servizio PCB a 2 strati; lo stack-up è in fab/Motherboard-job.gbrjob.
  2. Procurati i componenti in base allo schema elettrico in electrical/exports/Motherboard_schematic.pdf.
  3. 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.
  4. 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.

  1. In firmware/swerve_drive, esegui pio run -e teensy41 -t upload.
  2. Esegui ./setup_can.sh per attivare can0 a 1 Mbit/s.
  3. 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.

  1. Copia config/robot.json sulla scheda SD del Teensy e imposta net.ip per la tua rete.
  2. 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.
  3. Apri il monitor seriale a 115200 baud: elenca ogni attuatore, attivo o no.
  4. 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.
  5. 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.

  1. Esegui pip install mpremote, poi firmware/lift/tools/deploy.sh.
  2. 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.

  1. Esegui firmware/orca_hand/feetech/scripts/scan.py e controlla gli ID dei servo da 1 a 17 su ogni mano.
  2. 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.

  1. Solleva le ruote da terra per i primi test.
  2. Esegui scripts/set_drive_limits.py una volta per scrivere nella flash un limite di uscita della trazione prima di guidare sul pavimento.
  3. Imposta STEER_OFFSET, DRIVE_SIGN, WHEEL_RADIUS e DRIVE_GEAR_RATIO all'inizio di swerve_teleop.py prima della prima guida reale.
  4. 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.

  1. Installa gli strumenti di calibrazione con pip install -r calibration/requirements.txt.
  2. Esegui calibration/motor_calibration/hardware/scan.sh per elencare i motori senza alimentarli.
  3. Identifica attrito e inerzia di ogni motore con run_hardware.sh, stando lontano dall'albero e con una mano sull'arresto di emergenza.
  4. 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.

  1. Sul computer del robot, esegui ros/dev_up.sh una volta per compilare il workspace ROS 2 Jazzy.
  2. 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.
  3. I bracci si avviano senza coppia; l'operatore attiva la coppia esplicitamente. Sappi dov'è l'arresto di emergenza prima di attivare la coppia.
  4. Sostieni i bracci prima di arrestare l'host: senza pacchetti dall'host per 250 ms, tutti i motori dei bracci vengono disattivati.
  5. Ogni movimento della base passa un controllo antiribaltamento che limita la velocità in base all'altezza del sollevamento.

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