Skip to content
Anton Deguet edited this page Nov 7, 2024 · 125 revisions

Introduction

We are slowly migrating the documentation to https://dvrk.readthedocs.io.

Full da Vinci system with dVRK controllers at the Johns Hopkins University (LCSR)

The sawIntuitiveResearchKit folder provides several example applications for controlling the Research Kit for the da Vinci System using the IEEE-1394 (FireWire) controller. The picture above shows a full da Vinci system at JHU that uses the dVRK controllers.

October 31, 2023: The picture below shows some Halloween fun!

Happy Halloween!!

Credit / Citation

Moved to https://dvrk.readthedocs.io

Links

Community

Core Software

The software applications use some or all of the following cisst/SAW components (and Qt widgets):

Github build status:

  • ROS 1: Ubuntu 20.04 ROS Galactic
  • ROS 2: Ubuntu 20.04 ROS Galactic Ubuntu 22.04 ROS Humble
  • Without ROS: Windows latest macOS 13

The core components are written in C++ and can be compiled on most OSs (Linux, Windows, MacOS). Before the release of the dVRK software 2.0 and firmware 7, FireWire (more specifically libraw1394) was required to communicate with the dVRK controllers so it made little or no sense to compile on dVRK on anything but Linux. We now support UDP over Ethernet Link Local so it is now possible to control the dVRK using Windows or MacOS. This being said, we rely heavily on ROS for most applications so it makes a lot more sense to keep using Linux and more specifically Ubuntu.

A ROS 1 interface is available via mtsROSBridge base class and dVRK ROS programs and files. ROS 2 is supported but not as extensively tested.

Software Ecosystem

Several groups have developed software modules that integrate with the dVRK and may be useful to others in the community. Many of these software modules use ROS to interface to the dVRK.

Simulators

  • Asynchronous Multi-Body Framework (AMBF) - dynamic simulator developed at Worcester Polytechnic Institute (WPI); includes models of the dVRK manipulators and interfaces to the dVRK hardware (e.g., to use MTMs as input devices).
  • V-Rep Simulator for the dVRK - V-Rep simulator developed at University of Naples.
  • ATAR - Bullet based dynamic simulator developed at Politecnico di Milano.

Machine Learning

  • dVRL - reinforcement learning environment, based on V-Rep, developed at University of California, San Diego.
  • AMBF-RL - reinforcement learning environment, based on AMBF, developed at Worcester Polytechnic Institute (WPI).
  • UnityFlexML - machine learning environment, based on Unity 3D, developed at University of Verona.
  • SurRoL - reinforcement learning environment, based on PyBullet, developed at The Chinese University of Hong Kong.

Mixed Reality

  • dVRK-XR - mixed reality visualization, based on Unity 3D, developed at Johns Hopkins University; interfaces to dVRK via UDP or ROS.

High Level Control

Data Recording/Playback

Autonomous Camera Control

  • autocamera - autonomous camera control developed at Wayne State University.

Computer Vision - TBD

  • Instrument tracking
  • Stereo reconstruction

Hardware Ecosystem

Several groups have developed hardware components that integrate with the dVRK and may be useful to others in the community.

Force Sensors

Updates

Firmware

Firmware version 6, 7 or 8 is now required (dVRK 2.0+), please upgrade your firmware to 7 or 8 unless you want to use the software versions 1.7.x and 2.x simultaneously. Version 7 adds support for Ethernet/UDP for FPGA 2+ and many other changes. Version 8 adds support for FPGA 3+ and for other controllers (DQLA and DRAC in addition to QLA). See https://github.com/jhu-cisst/mechatronics-firmware/wiki/FPGA-Program for step-by-step instructions to upgrade your firmware.

Software

  • August 2024: Version 2.3.0 released
  • December 2023: Version 2.2.1 released
  • November 2023: Version 2.2.0 released
  • August 2021: Version 2.1.0 released
  • April 2021: Version 2.0.0 released
  • July 2019: Version 1.7.1 released
  • April 2019: Version 1.7.0 released
  • May 2018: Version 1.6.0 released
  • November 2017: Version 1.5.0 released
  • August 2016: Version 1.4.0 released
  • January 2016: Version 1.3.0 released
  • October 2015: Version 1.2.0 released
  • April 2015: Version 1.1.0 released
  • April 2014: Moved to GitHub
  • May 2013: Initial Public Release

Acknowledgments

Moved to https://dvrk.readthedocs.io

Clone this wiki locally