dVRK

• 1. Introduction
  • 1.1. What is the dVRK?
    • 1.1.1. The da Vinci
    • 1.1.2. The kit
    • 1.1.3. Credit/Citation
  • 1.2. Disclaimers
  • 1.3. How to get a dVRK?
  • 1.4. History and groups
  • 1.5. Examples
  • 1.6. Getting started
    • 1.6.1. Accounts
    • 1.6.2. Other readings
    • 1.6.3. Overview
  • 1.7. Acknowledgments
• 2. Components of the kit
  • 2.1. daVinci components
    • 2.1.1. Components from the da Vinci Classic
      • 2.1.1.1. Introduction
      • 2.1.1.2. Master Tele Manipulators
      • 2.1.1.3. Patient side manipulators
      • 2.1.1.4. Endoscopic Camera Manipulator
      • 2.1.1.5. Set Up Joints
    • 2.1.2. Components from the da Vinci Si
      • 2.1.2.1. Introduction
      • 2.1.2.2. Patient side manipulators
      • 2.1.2.3. Endoscopic Camera Manipulator
      • 2.1.2.4. Set Up Joints
    • 2.1.3. Instruments
      • 2.1.3.1. Introduction
      • 2.1.3.2. Part number
      • 2.1.3.3. Classic vs S/Si
      • 2.1.3.4. EndoWrist
      • 2.1.3.5. Energy
      • 2.1.3.6. Newer Si instruments
  • 2.2. dVRK controllers
    • 2.2.1. Logic board (FPGA)
      • 2.2.1.1. Introduction
      • 2.2.1.2. Versions
      • 2.2.1.3. Number of FPGAs
    • 2.2.2. Classic
      • 2.2.2.1. Introduction
      • 2.2.2.2. Exterior
      • 2.2.2.3. Internal layout
      • 2.2.2.4. Components
    • 2.2.3. Classic SUJ
      • 2.2.3.1. Introduction
      • 2.2.3.2. Exterior
      • 2.2.3.3. Internal layout
      • 2.2.3.4. Components
    • 2.2.4. Si
      • 2.2.4.1. Introduction
      • 2.2.4.2. Exterior
      • 2.2.4.3. Internal layout
      • 2.2.4.4. Components
    • 2.2.5. Controller versions
      • 2.2.5.1. dVRK Classic arm controllers
      • 2.2.5.2. dVRK-Si arm controllers
      • 2.2.5.3. dVRK Classic SUJ controllers
  • 2.3. User provided
    • 2.3.1. Computers
      • 2.3.1.1. Hardware
      • 2.3.1.2. OS
    • 2.3.2. Miscellaneous
      • 2.3.2.1. Stereo display
      • 2.3.2.2. FireWire cables
      • 2.3.2.3. USB Bluetooth dongle
      • 2.3.2.4. Foot pedal extension cable
• 3. Hardware setup
  • 3.1. Introduction
  • 3.2. E-Stop
    • 3.2.1. Summary
    • 3.2.2. Overview of safety chain
    • 3.2.3. Modular E-stop chain (recommended)
    • 3.2.4. Monolithic E-stop chain (not recommended)
    • 3.2.5. Issue with two 5-pin connectors
    • 3.2.6. A quick note about grounding
    • 3.2.7. Debugging
      • 3.2.7.1. Test single FPGA-QLA board set (bypassing relays on QLA boards)
      • 3.2.7.2. Test single controller box with QLA relays in the loop
      • 3.2.7.3. Hardware Debug
  • 3.3. Classic
    • 3.3.1. Unboxing
      • 3.3.1.1. Intuitive components
      • 3.3.1.2. dVRK controllers
    • 3.3.2. Mount
      • 3.3.2.1. MTMs
      • 3.3.2.2. SUJ
      • 3.3.2.3. PSMs
      • 3.3.2.4. ECM
    • 3.3.3. Connections
    • 3.3.4. Modifications
      • 3.3.4.1. Sterile adapter
      • 3.3.4.2. Foot pedals
      • 3.3.4.3. Head sensor
      • 3.3.4.4. Endoscope focus controller
      • 3.3.4.5. Instrument detection
      • 3.3.4.6. Console height adjustement
      • 3.3.4.7. QLA heat sink upgrade
      • 3.3.4.8. dMIB modification for setup joints switch ECM pre 2015
  • 3.4. Si
    • 3.4.1. Mount
    • 3.4.2. Connections
    • 3.4.3. ESPM
      • 3.4.3.1. Introduction
      • 3.4.3.2. Installation
      • 3.4.3.3. Usage
      • 3.4.3.4. Troubleshooting
    • 3.4.4. SUJ
      • 3.4.4.1. Preparation
      • 3.4.4.2. dESSJ
      • 3.4.4.3. dSIB-Si
      • 3.4.4.4. JHU setup
  • 3.5. Instruments
• 4. Software
  • 4.1. Compilation
    • 4.1.1. Repositories
    • 4.1.2. ROS 1
      • 4.1.2.1. Ubuntu packages
      • 4.1.2.2. Catkin workspace, clone and build
      • 4.1.2.3. Testing
    • 4.1.3. ROS 2
      • 4.1.3.1. Ubuntu packages
      • 4.1.3.2. Colcon workspace, clone and build
      • 4.1.3.3. Testing
    • 4.1.4. CMake
      • 4.1.4.1. Introduction
      • 4.1.4.2. Dependencies
      • 4.1.4.3. Getting the code
      • 4.1.4.4. Compilation
      • 4.1.4.5. Environment variables
      • 4.1.4.6. Screenshots
  • 4.2. Architecture
    • 4.2.1. Amp1394
    • 4.2.2. Components
      • 4.2.2.1. Introduction
      • 4.2.2.2. Threads
      • 4.2.2.3. Widgets
      • 4.2.2.4. Low level IOs
      • 4.2.2.5. PID
      • 4.2.2.6. Arms
      • 4.2.2.7. SUJ
      • 4.2.2.8. PSM teleoperation
      • 4.2.2.9. ECM teleoperation
      • 4.2.2.10. Console
    • 4.2.3. Bridges
      • 4.2.3.1. ROS
      • 4.2.3.2. OpenIGTLink
      • 4.2.3.3. Socket streamer
  • 4.3. Applications
    • 4.3.1. Console
      • 4.3.1.1. Overview
      • 4.3.1.2. Command line options
      • 4.3.1.3. Configuration file
      • 4.3.1.4. Dynamic components
    • 4.3.2. Debugging
      • 4.3.2.1. qladisp
      • 4.3.2.2. sawRobotIOQtConsole
      • 4.3.2.3. sawIntuitiveResearchKitQtPID
    • 4.3.3. Calibration
      • 4.3.3.1. sawRobotIO1394CurrentCalibration
      • 4.3.3.2. dvrk_calibrate_potentiometers.py
      • 4.3.3.3. dvrk_calibrate_potentiometer_psm.py
      • 4.3.3.4. sawIntuitiveResearchKitGripperCalibration
      • 4.3.3.5. sawIntuitiveResearchKitSiPotentiometersCalibration
      • 4.3.3.6. dvrk_calibrate_suj.py
      • 4.3.3.7. dvrk_camera_registration.py
    • 4.3.4. Utilities
      • 4.3.4.1. qlacommand
      • 4.3.4.2. dvrk-config-generator.py
      • 4.3.4.3. dvrk-remove-logs.py
      • 4.3.4.4. dvrk_reset_teleoperation.py
      • 4.3.4.5. hrsv_widget
      • 4.3.4.6. dvrk-sd-card-updater.py
      • 4.3.4.7. dvrk_teleoperation.py
• 5. Connectivity
  • 5.1. Introduction
    • 5.1.1. FireWire only
    • 5.1.2. FireWire with Ethernet bridge
    • 5.1.3. Ethernet only
    • 5.1.4. Bluetooth
  • 5.2. FireWire
    • 5.2.1. Important notes
    • 5.2.2. Setup
      • 5.2.2.1. FireWire adapter
      • 5.2.2.2. Drivers
      • 5.2.2.3. Set permissions for FireWire devices
    • 5.2.3. Testing connectivity
      • 5.2.3.1. qladisp
      • 5.2.3.2. ls -l /dev/fw*
      • 5.2.3.3. dmesg -w
      • 5.2.3.4. udevadm
  • 5.3. Ethernet
    • 5.3.1. Important Notes
    • 5.3.2. Setup
      • 5.3.2.1. Ethernet adapter
      • 5.3.2.2. Configuration
    • 5.3.3. Testing connectivity
      • 5.3.3.1. qladisp
      • 5.3.3.2. ping
  • 5.4. Bluetooth (SUJ Si)
    • 5.4.1. hciconfig
    • 5.4.2. bluetoothctl
      • 5.4.2.1. Command line examples
      • 5.4.2.2. Interactive shell
• 6. Configuration files
  • 6.1. Overview
    • 6.1.1. Types of files
    • 6.1.2. Where are the configuration files
      • 6.1.2.1. Shared files
      • 6.1.2.2. Site specific files
    • 6.1.3. How to create the configuration files
  • 6.2. Physical identifiers
    • 6.2.1. Board Id
      • 6.2.1.1. Overview
      • 6.2.1.2. Default board Ids
      • 6.2.1.3. Setting the board Id
    • 6.2.2. Arm serial number
  • 6.3. Configuration generators
    • 6.3.1. Arm IO, arm and arm console
    • 6.3.2. Console generator
  • 6.4. Console
    • 6.4.1. IOs
      • 6.4.1.1. Port
      • 6.4.1.2. Foot pedals
      • 6.4.1.3. FireWire protocol
      • 6.4.1.4. Period
      • 6.4.1.5. Watchdog time-out
    • 6.4.2. Head sensor
      • 6.4.2.1. da Vinci head sensor
      • 6.4.2.2. Goovis head sensor
      • 6.4.2.3. dVRK head sensor
    • 6.4.3. Focus controller
    • 6.4.4. Arms
    • 6.4.5. Teleoperation
    • 6.4.6. Custom components
      • 6.4.6.1. USB “joystick” foot pedals
  • 6.5. Arm
    • 6.5.1. Instrument detection
  • 6.6. Custom instruments
    • 6.6.1. Introduction
    • 6.6.2. Main files
    • 6.6.3. Examples
      • 6.6.3.1. Change the control point
      • 6.6.3.2. Change jaw’s angles (grasping torque)
      • 6.6.3.3. Disable the engage procedure
      • 6.6.3.4. New mechanical design
  • 6.7. dMIB IOs reference
    • 6.7.1. Controllers
    • 6.7.2. External devices
      • 6.7.2.1. Foot pedals
      • 6.7.2.2. da Vinci head sensor
      • 6.7.2.3. dVRK head sensor
      • 6.7.2.4. Endoscope focus controller
• 7. Calibration
  • 7.1. Classic
    • 7.1.1. Introduction
    • 7.1.2. Motor current
      • 7.1.2.1. Introduction
      • 7.1.2.2. Procedure
    • 7.1.3. ECM brakes
      • 7.1.3.1. Introduction
      • 7.1.3.2. Procedure
    • 7.1.4. Potentiometers
      • 7.1.4.1. Introduction
      • 7.1.4.2. Requirements
      • 7.1.4.3. Calibrating scales
      • 7.1.4.4. Calibrating offsets
    • 7.1.5. PSM third joint potentiometer offset
      • 7.1.5.1. Introduction
      • 7.1.5.2. Manual method
      • 7.1.5.3. Automatic method
      • 7.1.5.4. Effects on positioning accuracy
    • 7.1.6. MTM gripper
      • 7.1.6.1. Introduction
      • 7.1.6.2. Procedure
      • 7.1.6.3. Validation
    • 7.1.7. MTM gravity compensation
    • 7.1.8. SUJ potentiometers
  • 7.2. Si
    • 7.2.1. PSMs and ECM potentiometers
      • 7.2.1.1. Introduction
      • 7.2.1.2. Procedure
    • 7.2.2. SUJ potentiometers
• 8. Usage
  • 8.1. Real robot
  • 8.2. Simulation
    • 8.2.1. Compilation
    • 8.2.2. Run the simulation
    • 8.2.3. Configuration and launch files
    • 8.2.4. Usage
• 9. Development
  • 9.1. Options
    • 9.1.1. Introduction
    • 9.1.2. Middleware
      • 9.1.2.1. ROS
      • 9.1.2.2. Sockets (JSON), OpenIGTLink
    • 9.1.3. cisst/SAW components
      • 9.1.3.1. Derived components
      • 9.1.3.2. Generic components
  • 9.2. Coordinate systems
    • 9.2.1. Introduction
    • 9.2.2. Single arm
      • 9.2.2.1. Surgeon’s side
      • 9.2.2.2. Patient’s side
    • 9.2.3. SUJ
      • 9.2.3.1. Overview
      • 9.2.3.2. Intuitive SUJ
      • 9.2.3.3. SUJ Fixed
  • 9.3. API
    • 9.3.1. Introduction
    • 9.3.2. Arms
      • 9.3.2.1. All
      • 9.3.2.2. ECM
      • 9.3.2.3. MTM
      • 9.3.2.4. PSM
    • 9.3.3. Teleoperation
      • 9.3.3.1. PSM
      • 9.3.3.2. ECM
    • 9.3.4. Console
      • 9.3.4.1. General
      • 9.3.4.2. Tele-operation
      • 9.3.4.3. Foot pedals
    • 9.3.5. Miscellaneous
      • 9.3.5.1. Focus controller
      • 9.3.5.2. Audio
  • 9.4. ROS client libraries
    • 9.4.1. Introduction
    • 9.4.2. Python
      • 9.4.2.1. Introduction
      • 9.4.2.2. Usage
      • 9.4.2.3. Performance
• 10. Video
  • 10.1. Overview
  • 10.2. Sources
    • 10.2.1. Classic SD
      • 10.2.1.1. Cameras
      • 10.2.1.2. CCUs
    • 10.2.2. S HD
      • 10.2.2.1. Ikegami
      • 10.2.2.2. Panasonic
    • 10.2.3. Si HD
      • 10.2.3.1. Camera
      • 10.2.3.2. CCUs
  • 10.3. Displays
    • 10.3.1. Introduction
    • 10.3.2. HRSV with orginal CRTs
      • 10.3.2.1. SD HRSV
      • 10.3.2.2. ISI HD HRSV
    • 10.3.3. HRSV with flat panels
    • 10.3.4. Goovis HMD
      • 10.3.4.1. Introduction
      • 10.3.4.2. Description
      • 10.3.4.3. Using the internal head sensor
      • 10.3.4.4. Low-tech solution to stream the endoscope video
      • 10.3.4.5. Mount
  • 10.4. Hardware based pipeline
  • 10.5. Software based pipeline
    • 10.5.1. Introduction
    • 10.5.2. Frame grabbers
      • 10.5.2.1. Frame grabbers and ROS
      • 10.5.2.2. PCIe Blackmagic DeckLink Duo SDI frame grabber
      • 10.5.2.3. USB SD S-Video frame grabbers
    • 10.5.3. ROS
      • 10.5.3.1. gscam
      • 10.5.3.2. (rqt_)image_view
      • 10.5.3.3. dVRK launch files
    • 10.5.4. Calibration
      • 10.5.4.1. Create a catkin package
      • 10.5.4.2. Start the video
      • 10.5.4.3. Calibrate the camera
      • 10.5.4.4. Restart the video using the calibration
      • 10.5.4.5. RViz
• 11. Troubleshooting
  • 11.1. Potentiometers
    • 11.1.1. Introduction
    • 11.1.2. Connections
    • 11.1.3. Visual checks
    • 11.1.4. Configuration files
    • 11.1.5. Summary
• 12. References
  • 12.1. Acronyms
    • 12.1.1. Intuitive Surgical
    • 12.1.2. dVRK
      • 12.1.2.1. General
      • 12.1.2.2. dVRK specific
  • 12.2. Generations of da Vinci systems
    • 12.2.1. Models
    • 12.2.2. dVRK support
  • 12.3. Publications
    • 12.3.1. Credit/Citation
    • 12.3.2. dVRK
    • 12.3.3. dVRK community
  • 12.4. Videos
    • 12.4.1. dVRK
    • 12.4.2. Applications
  • 12.5. Links
    • 12.5.1. Intuitive Surgical
      • 12.5.1.1. Sites
      • 12.5.1.2. Documents
    • 12.5.2. Open source
      • 12.5.2.1. General
      • 12.5.2.2. Mechatronics
      • 12.5.2.3. Software
      • 12.5.2.4. CAD
  • 12.6. Related systems
    • 12.6.1. Commercial
      • 12.6.1.1. RAMIS
      • 12.6.1.2. Simulation
      • 12.6.1.3. Haptic systems
      • 12.6.1.4. Orthopedic
      • 12.6.1.5. Other
    • 12.6.2. Research systems