Guida al montaggio di da Vinci Research Kit (dVRK)
Elettronica, firmware e software aperti per controllare i robot chirurgici da Vinci dismessi
Licenza
- software (sawIntuitiveResearchKit, dvrk-ros, cisst): JHU CISST Software License 1.0
- robot models (jhu-dvrk/dvrk_model): MIT
Licenza suddivisa. Il software (sawIntuitiveResearchKit, dvrk-ros e le librerie cisst) è soggetto alla JHU CISST Software License 1.0, non alla MIT: può essere usato, copiato, adattato, mostrato e distribuito, anche a fini commerciali, a condizione che i termini completi accompagnino ogni copia con la premessa della JHU, che i riconoscimenti siano mantenuti e le modifiche segnalate, e che il nome della JHU non sia usato per promuovere prodotti. I modelli dei robot in jhu-dvrk/dvrk_model sono MIT. La JHU afferma che il proprio software è stato progettato solo per la ricerca e ne sconsiglia l'uso clinico. Verificato il 3 nov 2026.
Guida al montaggio
1. Capire il kit e procurarsene uno
Cos'è il dVRK, le avvertenze della fonte originale, da dove provengono i bracci da Vinci e i controller dVRK, e il PC e le parti aggiuntive da acquistare per conto tuo.
1.1 Leggi le avvertenze del progetto originale
Le quattro avvertenze del progetto originale valgono per ogni dVRK prima di iniziare qualsiasi lavoro di configurazione.
- Non usare mai il dVRK sui pazienti: il progetto originale dichiara che non è approvato dalla FDA.
- Non aspettarti alcuna garanzia: software, firmware e hardware del dVRK sono forniti senza alcuna garanzia.
- Prevedi del tempo per il montaggio: il dVRK non è un sistema chiavi in mano e richiede tempo per la configurazione.
- Considera che per utilizzarlo serviranno alcune conoscenze di software, meccanica e robotica.
- Non confondere il dVRK con il da Vinci: condividono le parti meccaniche, ma l'elettronica e il software sono diversi.
1.2 Identifica le tre parti del kit
Il dVRK combina hardware da Vinci dismesso, controller e software JHU open source e PC che acquisti tu.
- Il dVRK è un insieme open source di elettronica, firmware e software che controllano sistemi di ricerca costruiti con sistemi da Vinci dismessi di Intuitive Surgical.
- La prima parte sono i manipolatori e l'altro hardware (endoscopio, visore stereo) dei sistemi da Vinci dismessi.
- La seconda parte sono i controller, il software e un certo supporto da parte del gruppo dVRK della Johns Hopkins University, tutto open source.
- La terza parte sono i PC Linux, che scegli e acquisti tu; non sono forniti con i controller dVRK.
- Il proprietario del dVRK esegue l'installazione, la configurazione e la calibrazione del PC e dell'hardware.
- Aspettati che il tuo kit sia diverso da quello degli altri, perché ogni gruppo dVRK può ricevere hardware diverso.
1.3 Procurati i bracci da Vinci e i controller dVRK
Il progetto originale indica dove i gruppi trovano parti da Vinci dismesse e come ottenere i controller.
- La maggior parte dei gruppi dVRK riceve i robot dismessi tramite la Intuitive Foundation (https://www.intuitive-foundation.org/dvrk/).
- Alcuni gruppi recuperano un da Vinci dismesso direttamente da un ospedale; conserva anche gli strumenti e le altre parti monouso.
- Sistemi da Vinci completi o loro parti si trovano anche a un prezzo ragionevole su siti d'aste come eBay.
- Se sei passato per la Intuitive Foundation, ti aiuterà a procurarti i controller; altrimenti contatta gli sviluppatori del dVRK.
- Puoi costruire da te i controller dal progetto open source, ma il progetto originale lo definisce di gran lunga l'approccio più difficile.
- Tutto il resto (computer, cavi, display, supporti) lo acquisti tu; tutti i progetti, il firmware, il software e la documentazione sono su GitHub.
1.4 Identifica le build dei tuoi controller
I numeri di serie delle schede indicano quale build del controller hai, da cui dipendono i passaggi successivi.
- Leggi l'etichetta bianca S/N su ogni scheda FPGA e QLA; i numeri di serie hanno la forma BBBB-xx o BBBB-xxx, dove BBBB è il numero di build.
- Cerca la build nelle tabelle del progetto originale per i controller dei bracci dVRK Classic (da CA0 a CA10), i controller dei bracci dVRK-Si (SA1, SA2) e i controller SUJ dVRK Classic (CS0, CS1).
- Tutti i controller sono forniti con adattatori FireWire.
- Gli adattatori Ethernet sono stati introdotti con FPGA 2+, nella build 5 (2016).
- Per il sistema Si, il supporto SUJ viene da schede aggiuntive (dSIB-Si e dSIB-Z-Si) che non sono tracciate separatamente.
- Controlla le note di rilascio di FPGA, QLA e dRAC collegate in questa pagina; alcune build richiedono modifiche all'hardware.
1.5 Scegli il PC Linux e i suoi adattatori
Le raccomandazioni del progetto originale per il PC che comanda i controller, i suoi adattatori FireWire ed Ethernet e il sistema operativo.
- Usa almeno un PC con Linux; il progetto originale ne consiglia vivamente due o più se configuri la pipeline video o esegui calcoli pesanti accanto al dVRK.
- Esegui la raccolta dati con ROS bag su un PC diverso, non sul PC del dVRK.
- Per il PC collegato ai controller, il progetto originale consiglia almeno 8 core (idealmente con hyper-threading), almeno 16 GB di RAM (32 GB consigliati) e un SSD.
- Monta un adattatore FireWire (obbligatorio), idealmente una scheda con un chipset FireWire PCIe nativo; evita un chipset PCI dietro un bridge da PCI a PCIe.
- Il progetto originale indica come buoni adattatori la SYBA Low Profile PCI-Express FireWire e la SIIG NN-E20012-S2, e la StarTech pex1394a2v2 come cattiva.
- Aggiungi un secondo adattatore Ethernet se prevedi di collegare i controller via Ethernet; preferisci PCIe e, se USB, almeno USB3.
- Se usi una scheda NVIDIA, installa correttamente i driver NVIDIA: i driver nouveau tendono a disturbare la comunicazione FireWire; verifica con nvidia-smi.
- Per dVRK 2.4 e main, il progetto originale consiglia ROS 2 Jazzy su Ubuntu 24.04; sono elencati anche Humble su Ubuntu 22.04 e Galactic su Ubuntu 20.04.
1.6 Raccogli le parti aggiuntive
Cavi, un lettore di schede SD e le opzioni di display che il progetto originale indica di acquistare.
- Usa i cavi FireWire forniti con i controller.
- Per cavi aggiuntivi o più lunghi, il progetto originale consiglia vivamente i cavi UniBrain FireWire-400 da A ad A (da 6 pin a 6 pin).
- Evita cavi FireWire qualsiasi; il progetto originale avverte che fanno perdere molto tempo a risolvere problemi di connessione.
- Per usare i pedali originali Classic o S, acquista una prolunga DB15.
- Per i controller usciti dopo il 2024 (basati su dRAC o DQLA), il firmware si carica da una scheda SD; tieni un lettore di schede SD sul PC Linux del dVRK.
- Per una visualizzazione stereo si può usare un visore HMD come il Goovis.
2. Cabla la catena di sicurezza (arresto di emergenza)
La fonte originale dice che la configurazione dell'hardware dipende dall'hardware di ciascun sito, con un'eccezione valida per ogni dVRK: la catena di sicurezza dell'arresto di emergenza che abilita l'alimentazione dei motori.
2.1 Comprendi cosa fa la catena di sicurezza
L'alimentazione dei motori in ogni controller collegato dipende da un'unica catena di sicurezza chiusa.
- La catena di sicurezza deve essere integra (elettricamente chiusa) perché gli alimentatori dei motori in tutti i box controller collegati vengano abilitati.
- Se un qualsiasi dispositivo della catena interrompe la continuità, tutti gli alimentatori dei motori in tutti i box collegati vengono disabilitati.
- I dispositivi della catena includono interruttori manuali, come il pulsante di arresto di emergenza, e relè controllati dal computer.
- Ogni box controller contiene un relè di sicurezza su ciascuna delle sue due schede QLA, più un relè di ingresso AC per l'alimentatore dei motori.
- Il progetto originale ha standardizzato un connettore di sicurezza a 4 pin e uno a 5 pin su tutti i box controller.
- Se i tuoi box non hanno questi connettori, aggiornali con il kit di retrofit disponibile su https://github.com/jhu-dvrk/dvrk-estop-retrofit.
2.2 Collega la catena modulare di arresto di emergenza
Il progetto originale consiglia la catena modulare composta da cavo di arresto di emergenza, cavi di prolunga e un tappo di terminazione.
- Usa la catena di arresto di emergenza modulare (riconfigurabile); il progetto originale la consiglia rispetto alla catena monolitica.
- Collega il cavo di arresto di emergenza dal pulsante di arresto di emergenza al connettore a 5 pin di un box controller.
- Collega ogni box successivo con un cavo di prolunga (daisy chain) dal connettore a 4 pin di un box al connettore a 5 pin di un altro box.
- Inserisci il tappo di terminazione in un connettore a 4 pin di uno dei box.
- Una configurazione completa di 4 box collegati in daisy chain usa 1 cavo di arresto di emergenza, 3 cavi di prolunga e 1 tappo di terminazione.
- Per costruire altri cavi, il progetto originale indica un qualsiasi cavo AWG 22 a 2 fili più massa, e i connettori Digikey 277-1013-ND (Phoenix 1757035, 4 pin) e 277-8670-ND (Phoenix 1752399, 5 pin).
2.3 Controlla i box Build #4 e la messa a terra
Due avvertenze del progetto originale: i cavi Build #4 possono escludere i relè se invertiti, e la GND dovrebbe essere comune a tutto il sistema.
- I box controller della build #4 hanno due connettori di sicurezza a 5 pin.
- Su questi box il cavo di prolunga non è diritto (non pin-to-pin), quindi il verso di collegamento è importante.
- Collegandolo al contrario alcuni relè di sicurezza vengono bypassati.
- Collega il GND di tutti i componenti di un sistema; sul connettore di sicurezza a 5 pin, il GND è sul pin 2.
- Su un box con il solo connettore a 4 pin, il GND può essere collegato tramite una vite sull'involucro; vedi le note di dvrk-estop-retrofit.
2.4 Esegui il debug dell'alimentazione dei motori con qladisp se non si accende
La sequenza di test del progetto originale per un box controller i cui motori non si accendono.
- Per prima cosa prova un box con i relè QLA bypassati ma con l'arresto di emergenza ancora nella catena, collegando +12V a EN attraverso l'arresto di emergenza.
- Collega il connettore modificato al box ed esegui qladisp 0 1 (esempio per il box MTML), poi premi p per accendere l'alimentazione.
- mv-good e tutti gli amplificatori dovrebbero accendersi; in caso contrario, controlla i collegamenti fisici del sistema di alimentazione.
- Poi prova il box con i relè QLA nel circuito: cavo di arresto di emergenza sul connettore a 5 pin e tappo di terminazione sul connettore a 4 pin, poi esegui qladisp 0 1 e premi di nuovo p.
- Se l'alimentazione non funziona ancora, usa un multimetro: i punti di test T1 e T2 su ciascun relè QLA devono essere aperti con il relè spento e in cortocircuito con il relè acceso (dovresti sentire un clic).
- Se T1 e T2 non si comportano così, contatta i manutentori del dVRK.
- Controlla anche che i due relè siano collegati in serie e che il collegamento del morsetto E-STOP sia corretto.
3. Configura bracci e controller Classic
Per l'hardware da Vinci Classic (e console del chirurgo Classic o S): disimballaggio, montaggio, cavo del braccio e aggiornamento del dissipatore della QLA. Salta i passaggi di montaggio già coperti dalla tua console completa o dal carrello paziente.
3.1 Disimballa i componenti Intuitive (Classic)
I controlli del progetto originale quando arriva un nuovo componente da Intuitive Surgical.
- Leggi la documentazione di Intuitive sul disimballaggio (pagina protetta da password su research.intusurg.com).
- Conserva le scatole di spedizione e chiedi a Intuitive se le vuole indietro.
- Su un PSM Classic, assicurati che il braccio sia libero di muoversi: rimuovi la staffa bianca di trasporto in Delrin sotto la copertura morbida, se presente.
- Controlla visivamente che non ci siano danni evidenti, come cavi rotti su un PSM o un MTM.
- Etichetta i connettori il prima possibile con il nome del braccio, l'ID della scheda e/o il numero di serie.
3.2 Controlla ed etichetta i controller Classic
Non mescolare i controller MTM, PSM ed ECM, e controlla l'interno di ogni box dopo la spedizione.
- Non confondere i tre tipi di controller: i controller MTM usano 24V per i primi 4 attuatori e 12V per gli ultimi 3, i controller PSM usano 24V per tutti e 7, e il controller ECM usa un'unica alimentazione a 36V per 4 motori e 3 freni.
- Verifica il tipo di ciascun controller aprendolo.
- Etichetta ogni controller sul fronte e sul retro con il nome del braccio e gli ID delle schede, per esempio MTMR (ID schede 2 - 3).
- Al primo disimballaggio, controlla i collegamenti interni e ricollega i cavi allentati o parzialmente scollegati.
- Se non ti senti sicuro a ricollegare i cavi, contatta i manutentori del dVRK.
- Collega tutti i controller a un'unica ciabatta con interruttore.
3.3 Monta gli MTM su un telaio se non hai la console del chirurgo (Classic)
Solo per i gruppi che non hanno una console del chirurgo originale o che la sostituiscono.
- Salta questo passaggio se hai una console del chirurgo completa.
- Posiziona i controller del dVRK molto vicino alla console: i cavi che escono dagli MTM sono piuttosto corti.
- Ogni MTM è fornito con una staffa in acciaio con 4 fori di montaggio; alla JHU è accoppiata a una piastra in alluminio su un telaio 8020.
- Se costruisci un carrello da zero, il progetto originale consiglia il progetto di Vanderbilt; la sua distinta materiali (PDF) e il file di progetto IdeaBuilder (JSON) sono in questa pagina.
- Per altri esempi di telai di montaggio, vedi la Intuitive Research Wiki (serve un account).
3.4 Monta i PSM Classic su un telaio personalizzato
Solo se non hai il carrello paziente completo; posiziona i PSM in modo da evitare i limiti dei giunti.
- Salta questo passaggio se hai un carrello paziente completo, perché i PSM sono montati sul SUJ.
- Usa i 4 fori alla base della barra nera del PSM, che formano un quadrato di 2 pollici; per un montaggio rigido, fora e filetta 4 fori in una piastra standard 80-20.
- Posiziona ogni PSM con attenzione: la sua area di lavoro è piuttosto limitata, quindi evita di raggiungere i limiti fisici dei giunti.
- Idealmente, nella posizione zero l'asta dello strumento dovrebbe essere allineata con la normale alla superficie del paziente.
- Idealmente, posiziona tutti i punti RCM (PSM ed ECM) sulla superficie del paziente; il punto RCM si trova vicino alla grande fascia nera sulla cannula.
- Un supporto a testa a sfera per ogni PSM consente tutti gli orientamenti della base; alcuni gruppi hanno usato una testa a sfera Really Right Stuff BH-55.
3.5 Monta l'ECM Classic su un telaio personalizzato
Solo se non hai il carrello paziente completo.
- Salta questo passaggio se hai un carrello paziente completo, perché l'ECM è montato sul SUJ.
- Monta l'ECM su una piastra inclinata in avanti di 45 gradi, come in un sistema clinico.
- Posiziona l'ECM seguendo le indicazioni sui punti RCM per il montaggio del PSM Classic.
3.6 Monta il controller SUJ Classic
Il controller SUJ del dVRK va sul retro della colonna verticale del carrello paziente.
- Monta il controller SUJ del dVRK sul retro della colonna verticale del carrello, usando i 4 fori dell'involucro che corrispondono ai fori filettati esistenti.
- Rimuovi la piastra esistente.
- Lascia intatti i 4 sottili cavi grigi: servono per i potenziometri che misurano le traslazioni su/giù del SUJ.
- Usa dei distanziali tra la colonna e il controller per non schiacciare i cavi.
- Collega i connettori del SUJ; fai passare i cavi SUJ-PSM1 e SUJ-ECM sotto il controller.
3.7 Collega ogni braccio Classic al suo controller
Ogni MTM, PSM ed ECM Classic ha un unico grande connettore ITT Cannon 156 che va bloccato.
- Collega il cavo grande con il connettore ITT Cannon 156 proveniente dal braccio; è l'unico cavo da collegare per MTM, PSM ed ECM Classic.
- Non forzare il connettore: è a forza di inserzione nulla (ZIF).
- Bloccalo con un grosso cacciavite a taglio sulla vite del guscio posteriore: al massimo un quarto di giro, in senso orario per bloccare e in senso antiorario per sbloccare.
- Attenzione: se il connettore del braccio non viene bloccato si hanno cattivi contatti e il braccio non funziona correttamente.
- Svita il connettore prima di rimuoverlo.
- Posiziona i controller MTM sopra o accanto alla console del chirurgo; se accanto, il progetto originale consiglia il lato sinistro, così i cavi non vengono piegati troppo.
- Collega i SUJ direttamente al controller SUJ del dVRK, non attraverso i lunghi cavi originali dal carrello alla console; tutti i connettori alla base del carrello dovrebbero quindi restare liberi.
3.8 Potenzia i dissipatori QLA dei controller Classic più vecchi
I primi controller Classic e Classic SUJ tendono a surriscaldarsi senza un dissipatore e una ventola aggiuntivi.
- Questo vale solo per i vecchi controller Classic (FPGA V1 o V2) o Classic SUJ, e solo se nessuno li ha già aggiornati.
- Per i controller ECM e SUJ il raffreddamento passivo non basta assolutamente: monta un dissipatore aggiuntivo e una ventola.
- I controller MTM e PSM possono funzionare per circa mezz'ora senza problemi; per un uso prolungato il progetto originale raccomanda vivamente dissipatore e ventola.
- Alimenta la ventola dai connettori a 2 pin da 12 V della QLA, che sono alimentati quando l'alimentazione dei motori è attiva.
- Usa viti metriche M3 da 8 mm per le QLA S/N 4265-xx e viti imperiali 4-40 da 3/8 di pollice per tutte le altre QLA.
- Il progetto originale ha verificato che un singolo dissipatore con ventola per Pentium Socket 370 funziona bene, per esempio lo StarTech FANP1003LD.
4. Configura bracci e controller Si
Per i bracci lato paziente da Vinci Si (PSM, ECM) con controller dVRK-Si, su un telaio personalizzato o sul carrello paziente Si originale (SUJ). Non esiste supporto dVRK per la console del chirurgo Si/Xi.
4.1 Monta i PSM e l'ECM Si su un telaio personalizzato
Solo se non hai un carrello paziente Si completo, o se stai rimuovendo o scambiando un braccio.
- Salta questo passaggio se hai un carrello paziente Si completo, a meno che tu non preveda di togliere o scambiare un braccio.
- Per togliere un braccio dal SUJ, togli i suoi 4 bulloni lunghi e sfilalo lungo le due scanalature delle sue pareti interne.
- Quando togli un braccio attivo, il braccio passivo del SUJ tende a sollevarsi nonostante i freni a causa dei contrappesi; fissalo con una cinghia alla parte inferiore del carrello.
- Se il braccio è ripiegato e non riesci a raggiungere i bulloni, puoi forzarlo a muoversi nonostante i freni, ma non farlo spesso.
- Chiedi a Intuitive Surgical le staffe di montaggio (per lo più in acciaio, provenienti da vecchi sistemi clinici) per costruire il tuo supporto.
- Per i progetti del telaio, vedi la pagina wiki di Intuitive Research e il CAD Onshape con la distinta base collegati in questa pagina.
4.2 Collega un braccio Si senza il SUJ
I bracci su un telaio personalizzato si collegano al controller dVRK-Si con due cavi D-sub personalizzati.
- Per un sistema senza SUJ, usa i due cavi personalizzati con connettori D-sub a entrambe le estremità: un'estremità si collega al braccio, l'altra al controller dVRK-Si.
- Fai passare i connettori attraverso lo spazio libero nella parte inferiore della staffa di montaggio.
- I connettori tengono senza viti, ma aggiungi un fermacavo perché i cavi sono pesanti.
- Con un carrello paziente originale (SUJ), i connettori del braccio non sono accessibili; i segnali passano invece attraverso il cablaggio interno del SUJ e una scheda dSIB-Si.
4.3 Prepara il carrello paziente Si per i controller dVRK
Rimuovi l'elettronica originale del carrello conservando i cavi che servono alle dSIB.
- Avvertenza: collega la dSIB-Si direttamente al controller basato su dRAC; non usare i cavi personalizzati del braccio tra la dSIB e il controller, perché non portano tutti i segnali per il SUJ e gli ESSJ.
- Nota: una volta configurato il carrello Si per i controller dVRK, tornare ai controller originali è possibile ma davvero difficile.
- Togli la copertura posteriore in 2 parti: 2 viti (chiave esagonale da 3/16), poi staccala facendo leva sulle sue robuste clip a pressione.
- Scollega il cavo Z-AXIS in alto (premi la linguetta) e tienilo da parte per la dSIB-Z-Si; è l'unico cavo necessario non collegato ai RAC.
- Dai 4 RAC sul lato anteriore, prendi i cavi etichettati SJA2, SJX, SJC e SJA1 rispettivamente per le dSIB di PSM2, PSM3, ECM e PSM1; raggruppa ed etichetta i cavi di ogni braccio (2 connettori bianchi a fascio, un cavo nero a 2 fili, un cavo FireWire B usato per LVDS e un capocorda ad anello di massa).
- Lascia su ogni RAC il cavo FireWire superiore (J10) e il cavo inferiore (J13); non servono.
- Attenzione: il cavo FireWire J11 sul retro del PCB ha poco spazio; stacca l'intero RAC dalla piastra in acciaio prima di scollegarlo, per non danneggiare il connettore.
- Togli l'elettronica rimanente, la staffa e la batteria in modo da avere una superficie piana sopra le spalle su cui impilare i 4 controller dVRK-Si.
4.4 Monta le schede dSIB-Si e dSIB-Z-Si
Le schede dSIB collegano il cablaggio SUJ interno del carrello ai controller dVRK-Si.
- Monta una scheda dSIB-Si per ogni controller dVRK-Si (4 per un sistema completo), direttamente sul retro del controller.
- Avvertenza: non usare prolunghe tra la dSIB e il controller.
- Collega alle dSIB i cavi originali provenienti dalla base della colonna del SUJ; le dSIB alimentano anche i freni del SUJ.
- Collega la dSIB-Z-Si al singolo connettore grande proveniente dalla colonna del SUJ; legge i potenziometri lineari di tutti e quattro gli stadi di traslazione.
- Collega le 4 porte seriali etichettate della dSIB-Z-Si alla dSIB/al controller corretti.
- Posiziona i controller in basso sul carrello in modo che i cavi corti della colonna arrivino alle dSIB.
- Etichetta cavi, controller e schede con il nome del braccio e, se necessario, il numero di serie del braccio.
5. Carica il firmware
Il firmware FPGA consigliato è il v10, retrocompatibile con tutti i controller dVRK. Le schede Classic V1/V2 vengono programmate in flash, le schede V3 si avviano da una scheda SD, e i bracci Si e il SUJ richiedono la riprogrammazione delle schede ESPM ed ESSJ con il programmatore ESXX.
5.1 Controlla quale firmware richiede ogni scheda
La panoramica del progetto originale sulle schede con firmware integrato e su come si avvia ciascuna.
- Usa il firmware FPGA v10, la versione consigliata dal progetto originale; è retrocompatibile con tutti i controller dVRK.
- FPGA1394V1 e FPGA1394V2 si avviano da EPROM; FPGA1394V3 si avvia da una scheda SD.
- La scheda Power Indicator (solo Classic) si avvia da EPROM.
- L'ESPM (in ogni PSM ed ECM Si) e l'ESSJ (nel SUJ Si) si riprogrammano con il programmatore ESXX e si avviano dalla memoria flash integrata.
- Le schede dSIB-Si e dSIB-Si-Z (Si con SUJ) si avviano da EPROM; vedi https://github.com/jhu-dvrk/dSIB-Si-firmware e https://github.com/jhu-dvrk/dSIB-Z-Si-firmware.
5.2 Aggiorna il firmware FPGA1394V1 e V2 (Classic)
I controller Classic più vecchi si aggiornano seguendo il wiki mechatronics-firmware.
- Per la maggior parte degli utenti, aggiorna tramite FireWire.
- Per un controller bloccato in modo irreparabile, usa OpenOCD con un adattatore JTAG.
- Gli utenti esperti e i programmatori FPGA possono usare Xilinx ISE.
- Segui le istruzioni del wiki mechatronics-firmware: https://github.com/jhu-cisst/mechatronics-firmware/wiki/FPGA-Program.
5.3 Aggiorna le schede SD FPGA1394V3 (DQLA Classic e Si)
Un unico Zip del firmware copre tutti i controller FPGA1394V3; il loader sceglie il file giusto in base al nome.
- FPGA1394V3 è usata nei controller dVRK-Si PSM ed ECM e nei controller MTM DQLA più recenti.
- Togli tutte le schede SD dal sistema: sui controller dVRK Classic V3 lo slot è sul retro, sui controller dVRK Si è sul lato anteriore.
- Esegui l'aggiornatore delle schede SD del dVRK, dvrk-sd-card-updater.py, un'utility del software dVRK (sawIntuitiveResearchKit core/applications/sd-card-updater).
- Lo script scarica e decomprime il firmware più recente, attende ogni scheda, sposta i file esistenti in una directory di backup, installa i nuovi file e smonta la scheda.
- Inserisci le schede SD una dopo l'altra senza riavviare lo script.
- In alternativa, scarica lo Zip più recente da https://github.com/jhu-cisst/mechatronics-embedded/releases/latest, decomprimilo e copia tutti i file sulla scheda SD.
- Se i controller sono collegati al PC via Ethernet, puoi aggiornare la scheda SD anche con scp.
5.4 Prepara la scheda SD del programmatore ESXX (Si)
Durante la configurazione il programmatore ESXX sostituisce il firmware di Intuitive sulle schede ESPM ed ESSJ.
- Il programmatore ESXX serve solo durante la configurazione; conservalo per i futuri aggiornamenti del firmware.
- Scarica sd_content.zip da https://github.com/jhu-dvrk/esxx-programmer-sd-content/releases.
- Decomprimilo; contiene una directory esxx_programmer/ con esxx_loader.rbf, espm.rpd e essj.rpd.
- Copia esxx_programmer/ direttamente nella radice di una scheda micro SD formattata FAT32.
- Inserisci la scheda micro SD nel programmatore ESXX.
- Questi file non sono gestiti dallo script dvrk-sd-card-updater, che serve solo per le schede SD dei controller FPGA1394V3.
5.5 Programma l'ESPM in ogni PSM ed ECM Si
Necessario per ogni PSM ed ECM Si usato con i controller dVRK, sul SUJ o meno.
- Assicurati che il braccio non sia alimentato prima di aprirlo.
- Togli la copertura in plastica del braccio: svita l'unico bullone con una chiave a brugola imperiale, poi sfila la copertura dalle clip muovendola o facendo leva.
- Avvertenza: non forzare i connettori; controlla prima il verso: il segno giallo sul cavo va dal lato del programmatore ESXX.
- Collega il programmatore ESXX alla porta JTAG J22 della scheda ESPM.
- Alimenta la scheda di destinazione accendendo l'interruttore di alimentazione del controller; l'ESPM è alimentata dal controller dVRK Si attraverso la dSIB-Si.
- Programma la scheda con espm.rpd.
- Togli il programmatore ESXX e rimonta la copertura.
5.6 Programma l'ESSJ nel SUJ Si
Solo per un dVRK-Si con il carrello paziente Si originale.
- La scheda ESSJ all'interno del carrello paziente gestisce i potenziometri del SUJ Si.
- Avvertenza: non forzare i connettori; il segno giallo sul cavo va dal lato del programmatore ESXX.
- Collega il programmatore ESXX alla porta JTAG sul lato sinistro della scheda ESSJ.
- Alimenta la scheda di destinazione accendendo l'interruttore di alimentazione del controller.
- Programma la scheda con essj.rpd, poi togli il programmatore ESXX.
5.7 Controlla che il controller Si avvii il nuovo firmware
I controlli dei LED del progetto originale dopo la programmazione di ESPM ed ESSJ.
- Scollega il programmatore ESXX e spegni e riaccendi il controller dVRK Si.
- I LED anteriori (PL, PS, ESPM, COM, 48V e AMP) lampeggiano in verde da sinistra a destra finché il firmware non viene trovato sulla scheda SD.
- Dopo l'avvio, il LED PL lampeggia in verde.
- Il LED ESPM deve essere verde fisso, a meno che non ci sia un problema tra il controller e l'ESPM.
- I due LED sul braccio vicino all'adattatore sterile lampeggiano avanti e indietro con una luce rosata quando il braccio si è avviato con il firmware dVRK.
6. Compila il software (ROS 2)
L'ultima versione del software dVRK è la 2.5.0. La fonte originale consiglia ROS 2 Jazzy su Ubuntu 24.04 e una build con colcon; ROS 1 è trattato solo nei termini in cui lo presenta la fonte originale.
6.1 Installa ROS 2 e i pacchetti di base
ROS 2 più gli strumenti di compilazione e le librerie che il progetto originale elenca per ogni distribuzione ROS.
- Installa ROS 2 seguendo le istruzioni di www.ros.org.
- Esegui: sudo apt install python-is-python3
- Esegui: sudo apt install python3-vcstool python3-colcon-common-extensions
- Esegui: sudo apt install python3-pykdl
- Esegui: sudo apt install git-lfs
- Installa Git LFS prima di importare il workspace: dvrk_model archivia le mesh degli strumenti in Git LFS.
6.2 Installa i pacchetti Ubuntu del dVRK (Ubuntu 24.04, ROS Jazzy)
Gli elenchi dei pacchetti del progetto originale per la configurazione consigliata Ubuntu 24.04 con ROS Jazzy.
- Esegui: sudo apt install libraw1394-dev libncurses5-dev qtcreator swig sox espeak cmake-curses-gui cmake-qt-gui git subversion libcppunit-dev qt6-base-dev qt6-5compat-dev qt6-tools-dev qt6-declarative-dev qt6-svg-dev libgl-dev libegl-dev libhidapi-dev python3-pyudev libgraphviz-dev
- Esegui: sudo apt install ros-jazzy-joint-state-publisher* ros-jazzy-xacro ros-jazzy-camera-info-manager ros-jazzy-image-transport ros-jazzy-image-transport-plugins
- Esegui: sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libcairo2-dev libjsoncpp-dev python3-opencv python3-numpy libgtk-3-dev libgtkmm-3.0-dev
- Ubuntu 24.04 usa Qt 6; questi pacchetti Qt 6 sostituiscono il pacchetto Qt 5 delle istruzioni dVRK precedenti.
- Per Ubuntu 22.04 con ROS Humble, o Ubuntu 26.04 con ROS Lyrical, usa gli elenchi di pacchetti corrispondenti in questa pagina.
6.3 Crea il workspace e clona i repository con vcs
vcs scarica ogni repository dello stack software del dVRK in un workspace ROS 2.
- Esegui: source /opt/ros/jazzy/setup.bash
- Esegui: mkdir -p ~/ros2_ws/src
- Esegui: cd ~/ros2_ws/src
- Esegui: vcs import --input https://raw.githubusercontent.com/jhu-saw/vcs/main/ros2-dvrk-main.vcs --recursive
- Esegui: vcs custom --git --nested --workers 1 --args lfs pull
- Per usare invece una release specifica, esegui: vcs import --input https://raw.githubusercontent.com/jhu-saw/vcs/main/ros2-dvrk-2.5.0.vcs --recursive
- Se ricevi errori di accesso negato da GitHub, prova: vcs import --input https://raw.githubusercontent.com/jhu-saw/vcs/main/ros2-dvrk-main.vcs --recursive --retry 10 --workers 1
- Se hai dimenticato --recursive, vai in ~/ros2_ws/src/cisst-saw/sawRobotIO1394 ed esegui: git submodule init; git submodule update
6.4 Compila il workspace con colcon
Compila in modalità Release dalla radice del workspace.
- Esegui: cd ~/ros2_ws
- Esegui: colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release --symlink-install
- Esegui: source ~/ros2_ws/install/setup.bash
- Compila sempre dalla directory principale del workspace; compilando in una sottodirectory colcon crea nuove directory build, install e log.
- Se vuoi, salva i flag in ~/.colcon/defaults.yaml o ~/ros2_ws/colcon_defaults.yaml, come mostrato in questa pagina.
6.5 Configura l'ambiente e prova in simulazione
Carica il workspace con source all'accesso e controlla la build con un carrello paziente Classic simulato.
- Aggiungi questo alla fine di ~/.bashrc (il progetto originale lo scrive su tre righe): if [ -f ~/ros2_ws/install/setup.bash ]; then . ~/ros2_ws/install/setup.bash; fi
- Con ROS 2 non è necessario eseguire source di cisstvars.sh.
- Esegui: ros2 launch dvrk_model patient_cart.launch.py generation:=Classic
- Nella GUI dVRK, apri la scheda Arm PSM1 e seleziona uno strumento.
- In un secondo terminale, esegui: ros2 run dvrk_python dvrk_arm_test.py -a PSM1
- ROS 2 trasmette sulla tua sottorete; usa ROS_AUTOMATIC_DISCOVERY_RANGE o ROS_DOMAIN_ID per evitarlo.
6.6 Usa ROS 1 solo nei limiti consentiti dal progetto originale
La pagina su ROS 1 del progetto originale riporta due avvertenze e mantiene le istruzioni catkin per le release più vecchie.
- Il progetto originale avverte che ROS 1 non è stato testato con il software dVRK 2.5.0 o successivo; usa ROS 2 dalla 2.5.0 in poi.
- ROS 1 non è più mantenuto, e il progetto originale raccomanda vivamente ROS 2.
- Per le configurazioni più vecchie, il progetto originale documenta una compilazione catkin con ROS Noetic su Ubuntu 20.04, incluso un file di release ros1-dvrk-2.4.0.vcs.
- Con ROS 1, ricordati di avviare un roscore quando usi rosrun, e di fermarlo quando hai finito.
7. Collega il PC ai controller
Collega i controller in daisy-chain e collega il PC via FireWire, via Ethernet a un controller ponte o solo via Ethernet, a seconda delle versioni dei controller.
7.1 Scegli come il PC comunica con i controller
Le tre configurazioni del progetto originale e l'impostazione della porta che usa ciascuna.
- Solo FireWire (porta fw): controller collegati in cascata via FireWire con il PC sulla catena; funziona con tutte le generazioni di controller ed è la soluzione più affidabile.
- FireWire con bridge Ethernet (porta udpfw): controller su FireWire, PC collegato via Ethernet a un controller.
- La configurazione con bridge richiede il software dVRK 2.0+, il firmware 7+ su tutti i controller e almeno una scheda FPGA V2 o V3.
- Se sono disponibili entrambe, usa come bridge un controller con FPGA V3: la FPGA V3 ha due adattatori da 1 Gb, la FPGA V2 un adattatore da 100 Mb.
- Solo Ethernet (porta udp): possibile quando tutti i controller usano FPGA V3; FireWire non necessario.
7.2 Configura FireWire in sicurezza
I connettori FireWire possono distruggere una scheda FPGA se inseriti a forza capovolti.
- Attenzione: i connettori FireWire A non sono reversibili; se inseriti a forza capovolti, i due pin di alimentazione toccano le linee dati e danneggiano in modo irreversibile la scheda FPGA del dVRK.
- Se devi forzare un connettore FireWire, controlla a vista che non sia capovolto.
- Usa un sistema operativo Linux nativo (il progetto originale raccomanda vivamente Ubuntu LTS): FireWire non è supportato nelle macchine virtuali e non esistono adattatori da FireWire a USB.
- Non collegare mai due PC alla stessa catena FireWire.
- Evita di mescolare controller dVRK e altri dispositivi FireWire sullo stesso bus.
- Preferisci un chipset Texas Instruments con supporto PCIe nativo; controlla il tuo chipset con lshw.
- Installa la libreria del driver una volta per computer: sudo apt-get install libraw1394-dev
7.3 Imposta i permessi dei dispositivi FireWire
Le regole udev permettono al software di controllo di girare senza root; il progetto originale consiglia la sua soluzione pratica.
- Scegli una delle due soluzioni del progetto originale; questa è quella pratica, da eseguire una volta per computer.
- Esegui: sudo mkdir -p /etc/udev/rules.d
- Esegui: cd
- Esegui: echo 'KERNEL=="fw*", GROUP="fpgaqla", MODE="0666"' > ~/80-firewire-all.rules
- Esegui: sudo mv ~/80-firewire-all.rules /etc/udev/rules.d/80-firewire-all.rules
- Esegui: sudo addgroup fpgaqla
- Esegui: sudo udevadm control --reload-rules
- Se il tuo istituto richiede un controllo degli accessi, usa la soluzione più sicura descritta in questa pagina (MODE 0660 e aggiunta di ogni utente a fpgaqla, poi disconnessione e nuovo accesso).
7.4 Prova la connessione FireWire
qladisp, /dev/fw* e dmesg mostrano se ogni scheda è sul bus.
- Compila prima il software dVRK: qladisp ne fa parte.
- Esegui qladisp senza opzioni; elenca le schede trovate con il loro ID scheda e la versione del firmware.
- Il numero di schede atteso dipende dalla tua configurazione; vedi la sezione Number of FPGAs del progetto originale.
- Se qladisp non funziona, esegui ls -l /dev/fw* e verifica che i dispositivi esistano con i permessi corretti; fw0 è l'adattatore del PC stesso.
- Avvertenza: i dispositivi fw devono essere numerati senza buchi; un buco indica che l'inizializzazione del bus probabilmente non è riuscita. Scollega il cavo FireWire dal PC, attendi 5 secondi e ricollegalo.
- Attendi qualche secondo tra lo scollegamento e il ricollegamento dei cavi FireWire.
- Osserva i messaggi del kernel con dmesg -w mentre colleghi i cavi; Ubuntu 24.04 e successive richiedono sudo, oppure esegui sudo sysctl kernel.dmesg_restrict=0.
7.5 Configura e prova un collegamento Ethernet
La porta Ethernet del dVRK è una connessione diretta, dedicata e link-local a un solo controller.
- Usa un adattatore di rete dedicato al dVRK, collegato direttamente a un controller della catena, senza hub né switch.
- Non collegare i controller dVRK a due computer diversi via Ethernet.
- Esegui sudo nm-connection-editor, seleziona l'adattatore del dVRK e imposta l'MTU a 3000 nella scheda Ethernet.
- In IPv4 Settings, imposta il metodo su Link-Local Only; in IPv6 Settings, imposta Disabled.
- Verifica con ifconfig che l'indirizzo dell'adattatore inizi con 169.254 e che la netmask sia 255.255.0.0.
- Esegui qladisp -pudp per elencare le schede via UDP; se segnala un nodo che non è una scheda QLA, scollega il PC dalla catena FireWire.
- Esegui ping 169.254.0.100; un tempo di ciclo di circa 0,3 ms è ragionevole.
8. Crea i file di configurazione
Identifica ogni braccio e controller, genera i file IO, di braccio e di sistema per ciascun braccio, scrivi a mano i file SUJ e combina tutto in un file di sistema.
8.1 Annota il numero di serie di ogni braccio
Il numero di serie del braccio associa ogni braccio ai suoi file di calibrazione.
- Trova il numero di serie (tracking ID, TRK ID) sull'etichetta di ogni braccio.
- Usalo in modo coerente in tutti i file di configurazione.
- Attenzione: non modificare i numeri di serie nei file di configurazione (contenuto o nome) a meno che tu non sappia davvero cosa stai facendo.
- Attenzione: non copiare né rinominare un file con un numero di serie nel nome per creare un file per un altro braccio; possono verificarsi danni gravi.
8.2 Controlla gli ID delle schede
Il selettore rotativo di ogni scheda FPGA imposta un ID che deve essere univoco nella catena.
- L'ID scheda si imposta con un selettore rotativo a 4 bit (da 0 a F) su ogni scheda FPGA1394 e deve essere univoco tra le schede collegate in cascata.
- Usa gli ID predefiniti del progetto originale: MTML 0 e 1, MTMR 2 e 3, ECM 4 e 5, PSM1 6 e 7, PSM2 8 e 9, PSM3 10 e 11, SUJ Classic 12.
- Riserva gli ID di ECM, PSM3 e SUJ anche se il tuo kit non li ha.
- I controller con FPGA1394 v3 (DQLA e dRAC) usano solo il primo ID; per esempio, un PSM1 Si usa l'ID 6.
- Verifica gli ID collegando il controller ed eseguendo qladisp o dmesg.
- Per cambiare un ID, apri l'involucro e ruota il selettore rotativo con un piccolo cacciavite a taglio.
- Su un da Vinci Standard, i PSM hanno adesivi colorati: giallo PSM1, verde PSM2, rosso PSM3.
8.3 Genera i file IO del braccio, del braccio e di sistema
dvrk-io-config-generator.py crea per ogni braccio un file IO vuoto, un file del braccio e un file di sistema a braccio singolo.
- Esegui source del tuo workspace (install/setup.bash per ROS 2) in modo che dvrk-io-config-generator.py sia nel tuo path.
- Per ogni braccio Classic, ottieni il file .cal da Intuitive Surgical e salvalo insieme ai tuoi file di configurazione.
- Braccio Classic con un controller basato su QLA1, esegui: dvrk-io-config-generator.py -a MTMR -g Classic -H QLA1 -c m23456.cal
- Braccio Classic con un controller basato su DQLA, esegui: dvrk-io-config-generator.py -a MTMR -g Classic -H DQLA -c m23456.cal
- Braccio Si, esegui: dvrk-io-config-generator.py -a PSM1 -g Si -H dRA1 -s 123456
- La porta predefinita è fw; aggiungi -p udpfw se usi Ethernet dal PC al primo controller e FireWire tra i controller.
- Se un MTM non ha ancora un file di compensazione della gravità (come gc-MTMx-12345.json), commenta (//) la riga gravity_compensation nel suo file del braccio.
- Dopo aver generato i file di un braccio, esegui tutti i passaggi di calibrazione per il tipo e la generazione di quel braccio.
8.4 Tieni i file in una directory di configurazione del sito
La struttura del progetto originale per i file specifici del sito e le regole per le modifiche a mano.
- Usa https://github.com/dvrk-config/dvrk_config_jhu come modello per CMakeLists.txt, package.xml e colcon.pkg.
- Usa una sottodirectory per sistema, il cui nome inizi con il nome del tuo istituto e contenga il nome del sistema (per esempio jhu-daVinci).
- Il progetto originale incoraggia ogni sede a mantenere un proprio repository sotto https://github.com/dvrk-config; contatta i manutentori del dVRK per averne uno.
- Archivia lì i tuoi file IO, dei bracci e di sistema, più i file .cal originali per i bracci Classic.
- Non copiare i file condivisi nella tua cartella: una copia lì viene usata al posto di quella predefinita.
- Prima di fare il check-in dei file, elimina i file temporanei e di log con dvrk-remove-logs.py.
- Attenzione: se modifichi un file a mano, usa le unità SI (metri, radianti, volt, ampere).
- Attenzione: per i PSM e gli ECM Si, il numero di serie identifica i file di calibrazione; mantienilo corretto in ogni modifica manuale.
8.5 Crea a mano i file di configurazione del SUJ
Non esiste un generatore per i file SUJ; parti dagli esempi di JHU per il tuo tipo di SUJ.
- Non esistono uno schema né un generatore per i file SUJ: copia i file esistenti e modificali a mano.
- Parti dal tipo di SUJ corretto: Classic, Si o Fixed.
- Classic: parti da dvrk/dvrk_config_jhu/jhu-daVinci; sawRobotIO1394-SUJ.json e suj-ECM-1-2-3.json sono specifici di ogni sistema, quindi conserva le tue versioni.
- Classic: se il tuo file di sistema include i SUJ e i bracci attivi, imposta il base-frame per ogni braccio attivo.
- Si: parti da dvrk/dvrk_config_jhu/jhu-daVinci-Si; il file di sistema ha una voce di braccio SUJ_Si con arm_file kinematic/suj-si.json.
- Si: i file per braccio sawRobotIO1394-SUJ-Si-<arm>-<serial>.json vengono creati dal generatore e aggiornati dalla calibrazione del SUJ Si.
- Fixed: non c'è un file IO; il file contiene solo la trasformazione 4x4 tra il mondo e la base di ogni braccio attivo.
8.6 Riunisci i bracci in un unico file di sistema
Quando ogni braccio ha i suoi file e la sua calibrazione, il wizard di sistema crea un file di sistema a più bracci.
- Una volta creati tutti i file IO e calibrati i bracci, combina bracci, pedali e sensori di testa in un unico file di configurazione del sistema.
- Vai nella directory con i tuoi file di configurazione dVRK ed esegui: dvrk-system-config-wizard
- La procedura guidata cerca i bracci nella directory e permette di configurare le sezioni IO, bracci e console.
- La sezione console include i componenti di teleoperazione che desideri.
- Puoi anche aprire e modificare un file di sistema esistente con la procedura guidata, oppure modificare il JSON in un editor di testo.
8.7 Imposta il rilevamento degli strumenti dei PSM
Ogni file di configurazione dei PSM sceglie il rilevamento degli strumenti automatico, manuale o fisso.
- Nel file di configurazione del tuo PSM (per esempio PSM1-12345.json), imposta tool_detection su AUTOMATIC, MANUAL o FIXED.
- AUTOMATIC usa l'interrogazione del chip Dallas; funziona con tutti i PSM Si e con i PSM Classic su controller recenti o modificati.
- MANUAL: quando viene inserito uno strumento, l'utente o l'applicazione lo seleziona (menu a tendina della GUI del braccio o un'interfaccia programmatica come un topic ROS).
- FIXED: un unico tipo di strumento impostato con tool, per esempio LARGE_NEEDLE_DRIVER:400006; per cambiarlo, arresta il programma, modifica il file e riavvia.
9. Calibra i bracci
I bracci Classic richiedono diverse calibrazioni analogiche per ogni coppia braccio-controller, nell'ordine indicato dalla fonte originale; PSM, ECM e SUJ Si richiedono la calibrazione dei potenziometri. La fonte originale fornisce la maggior parte dei comandi di calibrazione Classic in forma ROS 1.
9.1 Controlla quali calibrazioni richiede ogni braccio Classic
La tabella del progetto originale con i passaggi di calibrazione Classic per tipo di braccio.
- Questo vale solo per i bracci Classic; prima configura l'hardware, la connettività e i file di configurazione.
- I valori iniziali provengono dal file .cal di Intuitive ma non tengono conto dei controller dVRK, quindi calibra ogni combinazione di braccio e controller.
- Tutti i bracci Classic e il SUJ: offset di corrente dei motori.
- ECM: offset di corrente dei freni e corrente di sblocco dei freni.
- PSM, MTM ed ECM: scale dei potenziometri, poi offset; i PSM richiedono anche l'offset del terzo giunto.
- MTM: pinza e compensazione della gravità.
- SUJ: scale e offset dei potenziometri tramite la procedura SUJ.
9.2 Calibra gli offset di corrente dei motori (Classic)
sawRobotIO1394CurrentCalibration misura e salva gli offset della corrente comandata e di quella misurata.
- Un solo controller sulla catena di arresto di emergenza è più semplice; con tutti i controller sulla catena, tienili tutti su FireWire e abilita l'alimentazione con qlacommand -c close-relays.
- Esegui, con il file IO del tuo braccio: sawRobotIO1394CurrentCalibration -c sawRobotIO1394-MTML-12345.json
- La porta predefinita è fw; usa -p udp per solo Ethernet, oppure -p udpfw per Ethernet verso il primo controller e FireWire tra i controller.
- Per l'ECM, eseguilo due volte: una per i freni con -b e una per gli attuatori senza -b.
- Se i nuovi valori medi superano qualche decina di mA, non proseguire; contatta i manutentori del dVRK.
- Rispondi y per salvare; il vecchio file IO viene rinominato come backup.
- Esegui di nuovo il programma per verificare: gli offset in mA dovrebbero ora essere vicini a 0.
- Se mostra all'infinito WriteAllBoards: handle for port 0 is NULL, premi ctrl-c e verifica la connessione con qladisp.
9.3 Imposta le correnti dei freni dell'ECM (Classic)
I quattro valori dei freni nel file IO dell'ECM si regolano a mano.
- Avvertenza: questo passaggio va fatto assolutamente; non c'è un sensore di sblocco dei freni, quindi il PID può applicare contro i freni inseriti una corrente sufficiente a danneggiare i motori.
- Avvertenza: per il 3° freno (inserimento), il progetto originale interpreta la specifica del solenoide come non più di 13W per 7 secondi o 1,3W in continuo, cioè 1,48 A di release_current e 0,465 A di released_current.
- Calibra prima la retroazione di corrente dei freni (calibrazione della corrente con -b), su un controller ECM (singola alimentazione a 36V, ID scheda 4 e 5) con il cavo del braccio collegato direttamente.
- Modifica release_current, release_time, released_current e engaged_current (sempre 0) nel JSON IO dell'ECM; chiudi e riavvia la console sawRobotIO1394 (sawRobotIO1394QtConsole) dopo ogni modifica.
- Trova release_current: imposta released_current a 0 e release_time a 10 s, parti da un valore basso, fai clic su Enable All e poi su Release, e prova a muovere ogni giunto; aumenta il valore finché ogni freno si sblocca.
- Poi riduci release_time, idealmente fino a 2,0 secondi.
- Trova il released_current più basso che mantiene i freni sbloccati, partendo da un valore basso e aumentandolo.
- Se la retroazione di corrente si stabilizza mentre aumenti la richiesta, un controller più vecchio potrebbe richiedere il passaggio dell'alimentazione da 24V a 36V.
9.4 Calibra le scale dei potenziometri (Classic)
Ampi movimenti riferiti agli encoder su ogni attuatore correggono le scale dei potenziometri; fallo prima degli offset.
- Calibra le scale prima degli offset; per l'ECM, calibra prima i freni.
- Avvia il sistema con i topic IO e la modalità di calibrazione: rosrun dvrk_robot dvrk_system -j <my-config-dir>/system-PSM2.json -K -C
- In una shell separata, nella tua directory di configurazione, esegui: rosrun dvrk_python dvrk_calibrate_potentiometers.py -t scales -a PSM2 -c sawRobotIO1394-PSM2-00000.json -i IO1
- Usa lo stesso file JSON IO per lo script e per il sistema; -i deve corrispondere al nome IO nel file di sistema.
- Attenzione: il braccio si muove da un limite del giunto all'altro; assicurati che non ci siano ostacoli lungo il percorso.
- Per un PSM, togli qualsiasi strumento o piastra di calibrazione quando richiesto.
- Premi y per salvare, riavvia il sistema con il file aggiornato ed esegui di nuovo; di solito non serve salvare il secondo passaggio.
9.5 Calibra gli offset dei potenziometri (Classic)
Tieni il braccio nel suo zero meccanico e lascia che lo script calcoli gli offset.
- Il progetto originale conosce un solo modo semplice per tenere a zero gli ultimi 4 giunti del PSM: una dima in plexiglass o barre Lego che allineano i quattro ingranaggi (file su https://github.com/jhu-dvrk/dvrk-calibration-parts).
- Per un MTM o un ECM, devi trovare tu un modo per tenere il braccio al suo zero meccanico.
- Alimenta il braccio ed esegui l'homing, poi portalo vicino allo zero meccanico con i motori, il pulsante della frizione (ECM e PSM), obiettivi di movimento ROS o la GUI Qt.
- In una shell separata, esegui: rosrun dvrk_python dvrk_calibrate_potentiometers.py -t offsets -a PSM2 -c sawRobotIO1394-PSM2-00000.json -i IO1
- Posiziona la dima di calibrazione quando richiesto.
- Per i PSM che usano le barre Lego o la dima, non salvare tutti i giunti; salva solo gli ultimi 4.
- Riavvia il sistema con il file aggiornato e rieseguilo per verificare.
9.6 Calibra l'offset del potenziometro del terzo giunto del PSM (Classic)
Fai oscillare il PSM attorno al giunto 1 e regola l'offset di inserimento finché l'asse del giunto 5 dello strumento non smette di muoversi.
- Servono dVRK 2.0 con ROS, un file di sistema PSM funzionante, una telecamera fissa, uno strumento Classic da 8 mm (gli strumenti S/Si sono troppo lunghi) e un sostituto della cannula, come un elastico o un supporto stampato in 3D da https://github.com/jhu-dvrk/dvrk-cannulas.
- Avvia il sistema con -C: roscd dvrk_config, poi qlacommand -c close-relays, poi rosrun dvrk_robot dvrk_system -j <my-config-dir>/system-PSM1.json -C
- Esegui l'homing del PSM con uno strumento Classic da 8 mm supportato inserito, e mostra a schermo il punto RCM con la telecamera (ad esempio con tvtime).
- In un terzo terminale, da roscd dvrk_config/<my-config-dir>, esegui: rosrun dvrk_python dvrk_calibrate_potentiometer_psm.py -a PSM1 -c sawRobotIO1394-PSMx-xxxxx.json
- Trova l'escursione massima del PSM come chiede lo script, per evitare collisioni; dopo aver premuto d il PSM si muove rapidamente e oscilla attorno al giunto 1.
- Segna a schermo l'asse del giunto 5; premi + se si muove lungo un arco aperto verso il basso, - se aperto verso l'alto, e d quando il movimento è minimo.
- Salva, riavvia il sistema con -C e ripeti; idealmente non serve alcuna ulteriore regolazione.
- In questa pagina è documentato anche un metodo automatico, che consiste nel segnare il giunto 5 con smalto per unghie rosa acceso e usare dvrk_calibrate_potentiometer_psm_cv.py.
9.7 Calibra le pinze degli MTM (Classic)
Mappa il sensore a effetto Hall della pinza tra completamente aperta e chiusa ma non stretta.
- Esercitati prima a trovare la posizione chiusa ma non serrata, in cui interviene la molla interna più forte; il robot non deve essere acceso.
- Esegui, con il file della tua pinza: sawIntuitiveResearchKitGripperCalibration -c sawRobotIO1394-MTML-gripper-34863.json
- Aggiungi -p (per esempio -p udpfw) se non usi la porta predefinita fw.
- Il programma non richiede attuatori alimentati; l'arresto di emergenza può essere aperto.
- Apri completamente e chiudi fino alla seconda molla ripetutamente, finché il contatore e l'intervallo smettono di aumentare; non chiudere mai oltre quel punto, altrimenti riavvia senza salvare.
- Inserisci 60 gradi come nuovo massimo quando richiesto (consigliato), poi salva.
- Verifica nella scheda della pinza della GUI dvrk_system con Service, Plot position: circa 60 completamente aperta, circa 0 alla seconda molla, -40 o meno completamente chiusa.
9.8 Calibra la compensazione della gravità degli MTM (Classic)
Il progetto originale tiene questa procedura in un repository separato.
- Segui la documentazione su https://github.com/jhu-dvrk/dvrk-gravity-compensation.
- Questa pagina readthedocs non contiene una procedura propria; rimanda solo a quel repository.
9.9 Calibra i potenziometri del SUJ (Classic)
Etichetta ogni giunto del SUJ, inserisci nella GUI due posizioni note per giunto e copia i valori calcolati nel tuo file SUJ.
- Avvertenza: le posizioni del SUJ sono in genere precise solo entro un cubo di 50 mm; usa un sensore esterno per registrare i bracci se ti serve una precisione maggiore.
- Stampa le etichette SUJ del progetto originale (SVG o PDF) senza ridimensionarle (il riferimento stampato da 20 cm deve misurare 20 cm) e incollale sul segmento prima di ogni giunto.
- Avvertenza: sull'etichetta del giunto 3 dell'ECM, il 180 deve essere allineato con la tacca.
- Nella GUI del SUJ (Show more), sblocca i freni con Clutch, porta un giunto a un estremo, reinserisci i freni, attendi qualche secondo e inserisci la lettura dell'etichetta in Joint Start; ripeti all'altro estremo in Joint Finish.
- Per il giunto 0 (traslazione), misura l'altezza nel punto più basso e in quello più alto con uno strumento laser o un metro a nastro; calibra l'ECM solo dopo PSM1 o PSM2.
- Per il SUJ dell'ECM, compila gli ultimi due giunti con valori segnaposto distinti.
- Premi Manual Recalibration e copia gli offset e le scale stampati nella sezione corrispondente del tuo file SUJ (per esempio suj-ECM-1-2-3.json), poi riavvia.
- Verifica: sblocca i freni, avvicina tutti gli RCM e controlla che le posizioni SUJ riportate siano entro un cubo di 20 mm.
9.10 Calibra i potenziometri di PSM ed ECM Si (Si)
Porta ogni giunto da un limite all'altro così che il programma possa costruire la tabella di lookup del potenziometro digitale.
- Avvertenza: fai sempre corrispondere il numero di serie del braccio che stai usando.
- Esegui source del tuo workspace: source ~/ros2_ws/install/setup.bash
- Esegui, con il file del tuo braccio: sawIntuitiveResearchKitSPotentiometersCalibration -c sawRobotIO1394-ECM-123456.json
- Il programma alimenta il braccio e sblocca i freni; premi il pulsante bianco della frizione sopra il braccio per sbloccarli.
- Avvertenza: non c'è compensazione della gravità; tieni una mano sul supporto dell'endoscopio.
- Muovi ogni giunto da un limite all'altro, toccando ogni limite un paio di volte ma senza troppa violenza, finché tutti i contatori sono vicini a 3000, poi premi un tasto qualsiasi.
- Se l'intervallo misurato non corrisponde a quello atteso, ripeti e assicurati di raggiungere tutti i limiti dei giunti.
9.11 Calibra i potenziometri del SUJ Si (Si)
dvrk_calibrate_suj.py associa l'intervallo di tensione di ogni giunto di setup ai suoi limiti meccanici.
- Accendi il controller di ogni braccio attivo di cui calibri il SUJ; per farli tutti insieme, usa un file di sistema con tutti i bracci attivi e il SUJ Si.
- Dalla tua directory di configurazione, esegui: ros2 run dvrk_robot dvrk_system -j system-SUJ-ECM-PSM1-PSM2-PSM3.json -s
- Dalla directory che contiene i file sawRobotIO1394-SUJ-Si, esegui: ros2 run dvrk_python dvrk_calibrate_suj.py
- Calibra un braccio SUJ alla volta: sblocca i suoi freni, porta ogni giunto di regolazione da un limite meccanico all'altro, fermandoti circa un secondo a ogni limite.
- Verifica nella GUI che l'intervallo sia aumentato per ogni potenziometro primario e secondario di quel braccio, poi premi il pulsante Save corrispondente.
- Attenzione: il quinto giunto del SUJ del PSM3 ha una zona morta del potenziometro; evitala, muoviti tra il limite meccanico e il punto in cui le tacche incise sono allineate, e usa Reset PSM3 joint 5 se necessario.
- Dopo il salvataggio riavvia dvrk_system in modo che venga caricata la nuova calibrazione.
10. Fai funzionare il robot
La sessione tipica indicata dalla fonte originale su un dVRK completamente installato, configurato e calibrato: alimentazione, verifica dei collegamenti, avvio del sistema, alimentazione dei motori, homing, monitoraggio, posizionamento dei bracci, teleoperazione e video.
10.1 Accendi i controller
Accendi ogni controller e controlla che si sia avviato.
- Avvertenza: i primissimi gruppi dVRK (circa 2012) hanno schede FPGA che prendono alimentazione dal FireWire; per questi, scollega il cavo FireWire verso il PC prima di alimentare i controller.
- Accendi ogni controller con l'interruttore nero 0/1 accanto al cavo di alimentazione; una sola ciabatta permette di accenderli tutti insieme.
- Classic: dopo l'avvio, i LED A e B (e C e D) alternano tra verde e rosso.
- Si: dopo l'avvio, il LED PL lampeggia in verde; i controller basati su FPGA 3 impiegano un po' di più ad avviarsi.
- I controller raramente devono essere riavviati; alla JHU restano accesi 24/7.
10.2 Controlla la connessione ai controller
qladisp deve trovare ogni scheda prima che tu possa usare il dVRK.
- Se qladisp non viene trovato, esegui source del tuo workspace: source ~/ros2_ws/install/setup.bash
- Solo FireWire, esegui: qladisp -pfw
- Ethernet verso il primo controller e FireWire tra i controller, esegui: qladisp -pudpfw
- Controlla le schede trovate, i loro ID scheda, le versioni del firmware e il tipo di scheda di potenza (QLA1, DQLA, dRAC).
- Problema noto del FireWire: dopo aver alimentato i controller, potrebbe essere necessario scollegare il cavo tra il PC e il primo controller, attendere 5 secondi e ricollegarlo.
- Se le schede non vengono trovate, sistema prima il collegamento; fino ad allora non puoi usare il dVRK.
10.3 Avvia il sistema dVRK con la tua configurazione
dvrk_system carica il tuo file di sistema e crea tutti i componenti e la GUI.
- Avvertenza: usare file di configurazione errati porta a una precisione inferiore e può danneggiare il tuo dVRK.
- I bracci Classic non possono comunicare il proprio numero di serie, quindi nulla ti impedisce di usare i file di un altro sistema; i PSM e gli ECM Si lo memorizzano sull'ESPM e il software lo verifica.
- Esegui: source ~/ros2_ws/install/setup.bash
- Esegui: cd ~/ros2_ws/src/dvrk/dvrk_config_XXX (sostituisci XXX con la sigla della tua organizzazione)
- Esegui: ros2 run dvrk_robot dvrk_system -j system-XXX.json (sostituisci XXX con la tua configurazione)
10.4 Nell'uso normale lascia disattivate le opzioni che riducono la sicurezza
Alcune opzioni di dvrk_system disattivano i controlli o espongono comandi di basso livello.
- Usa -C (modalità di calibrazione) solo per calibrare i potenziometri; disattiva alcuni controlli di sicurezza e non va usato abitualmente.
- Considera pericoloso -J (tutti i topic PID): permette di inviare comandi direttamente ai componenti PID.
- Considera pericoloso -L (tutti i topic IO): permette di inviare comandi direttamente ai componenti IO.
- -K (topic IO in sola lettura) si usa per il debug e la calibrazione.
10.5 Attiva l'alimentazione dei motori
L'alimentazione dei motori si comanda dal PC una volta accesi i controller e chiusa la catena di arresto di emergenza.
- Attiva l'alimentazione dei motori con il pulsante Power On della GUI o con il topic ROS power_on.
- Le schede IO devono mostrare pulsanti verdi (tranne la pinza dell'MTM, che non è alimentata), e i LED anteriori del controller devono indicare l'alimentazione dei motori attiva.
- I controller devono essere già collegati alla rete AC e accesi; il PC comanda poi gli amplificatori dei motori sulle schede QLA o dRAC.
- Se non riesci ad attivare l'alimentazione dei motori, controlla l'arresto di emergenza.
10.6 Esegui l'homing dei bracci
L'homing avvia il controllo di posizione e ha un comportamento specifico per ogni braccio.
- Esegui l'homing del dVRK con la GUI o con il topic ROS home.
- Il controllo di posizione si avvia per tutti i bracci attivi.
- Gli MTM eseguono una routine di calibrazione del rollio e si portano nella loro posizione zero.
- I PSM e gli ECM non dovrebbero muoversi; è normale.
- Un PSM con adattatore sterile e senza strumento solleva il suo stadio di inserimento e aggancia l'adattatore; con uno strumento montato ma non inserito, aggancia lo strumento.
- Su ECM Classic, ECM Si e PSM Si, i freni vengono sbloccati e restano sbloccati finché i bracci sono abilitati; i bracci mantengono la posizione con i motori.
10.7 Monitora il sistema durante il funzionamento
Il progetto originale definisce il dVRK un sistema sperimentale su robot vecchi ed elenca cosa tenere d'occhio.
- Il robot deve essere silenzioso: se senti rumori o vedi vibrazioni, fermati e verifica (fanno eccezione piccole vibrazioni occasionali del polso dell'MTM).
- Controlla la frequenza IO con i widget di temporizzazione della GUI o con il topic ROS period_statistics di ogni componente.
- Mantieni basso il carico complessivo del computer; tienilo sotto controllo con htop.
- Controlla le temperature degli amplificatori nel widget IO.
- I controlli integrati usano soglie elevate; se il tuo sistema è instabile, controlla carico della CPU, temporizzazione e temperature.
10.8 Monta gli strumenti e posiziona i PSM e l'ECM
Video di configurazione degli strumenti e dell'endoscopio, poi posizionamento dei bracci attorno all'area di lavoro.
- Guarda i video di configurazione del progetto originale: PSM Classic https://youtu.be/yeQKU2_O6uo, PSM Si https://youtu.be/F7cOVPVq_TY, ECM https://youtu.be/jx0bB64NaPo, ECM Si https://youtu.be/7DCDEeAbb3k.
- Evita di essere vicino a un limite di un giunto quando la punta dello strumento è vicina al centro della tua area di lavoro.
- Disponi i bracci a ventaglio in modo che non si scontrino tra loro.
- Posiziona tutti i punti RCM lato paziente su una sfera centrata sull'area di lavoro, di circa 15-20 cm di diametro (video: https://youtu.be/nUsEUC4xOYc).
10.9 Teleopera un PSM da un MTM
Come si comporta, dal lato dell'operatore, il componente di teleoperazione dei PSM del progetto originale.
- Quando parte una teleoperazione, abilita ed esegue l'homing di MTM e PSM, poi muove l'MTM per farne coincidere l'orientamento con quello del PSM.
- Non applicare troppa coppia sul polso dell'MTM, altrimenti non può raggiungere l'orientamento obiettivo e la teleoperazione non parte.
- Appoggia le dita sulla pinza dell'MTM e muovile leggermente per segnalare che sei pronto; non c'è un sensore di presenza.
- In modalità follow, la traslazione dell'MTM comanda il PSM in modo relativo e scalato, e l'orientamento dell'MTM lo comanda in modo assoluto.
- Usa la frizione per riposizionare le mani; mentre la frizione è inserita, l'orientamento dell'MTM resta bloccato su quello del PSM.
10.10 Avvia la pipeline video stereo
Un unico file di launch avvia acquisizione, allineamento e visualizzazione stereo.
- Dalla directory con i tuoi file di configurazione video, esegui: ros2 launch dvrk_console stereo_video_pipeline.launch.py
- Per impostazione predefinita legge stereo_source.json, stereo_alignment.json e stereo_display.json dalla directory corrente.
- Avvia dvrk_data stereo_source, dvrk_data stereo_alignment e dvrk_console stereo_display, in quest'ordine.
- Se vuoi, in un terminale separato, avvia il pannello di controllo: ros2 run dvrk_console control_panel