Skip to content

A minimal Python script for initialising, testing, and streaming data from a single DIGIT tactile sensor.

Notifications You must be signed in to change notification settings

gemixin/digit-setup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 

Repository files navigation

DIGIT-Setup

Overview

DIGIT-Setup is a minimal Python script for initialising, testing, and streaming data from a single DIGIT tactile sensor using the digit-interface library.

This tool provides a quick way to:

  • Connect and configure a DIGIT sensor
  • View a live stream of tactile data
  • Save example frames as image files
  • Print basic sensor information

Requirements

  • Operating System: Linux only (DIGIT sensors are supported on Linux only)
  • Tested Environment: Ubuntu 22.04, Python 3.13.5
  • Python Environment: Regular Python or Anaconda environment
  • Packages: digit-interface

Installation

1. Clone the repository

git clone https://github.com/gemixin/digit-setup.git
cd digit-setup

2. Install dependencies

Option A: With pip

  1. (Optional) Set up a virtual environment:

    python3 -m venv venv
    source venv/bin/activate
  2. Install the required package:

    pip install digit-interface

Option B: With Anaconda

Create a new conda environment using the provided environment.yml:

conda env create -f environment.yml
conda activate digit-env

Running the Script

  1. Connect your DIGIT sensor via USB.
  2. Run the script:
python single_digit.py

The script will:

  • Automatically connect to the DIGIT sensor
  • Display configuration info
  • Stream a live tactile view
  • Save a few frames locally as .jpg images

Follow the terminal output for step-by-step feedback.

Known Issues

  • VGA Mode Bug:
    The digit-interface library has a known issue with VGA mode producing glitchy output.
    See issue #10.
    Recommendation: Stick to QVGA mode for reliable operation.

Citation

If you use DIGIT or this repo in your research, please cite:

DIGIT: A Novel Design for a Low-Cost Compact High-Resolution Tactile Sensor with Application to In-Hand Manipulation
Mike Lambeta, Po-Wei Chou, Stephen Tian, Brian Yang, Benjamin Maloon, Victoria Rose Most, Dave Stroud, Raymond Santos, Ahmad Byagowi, Gregg Kammerer, Dinesh Jayaraman, Roberto Calandra
IEEE Robotics and Automation Letters (RA-L), vol. 5, no. 3, pp. 3838–3845, 2020
https://doi.org/10.1109/LRA.2020.2977257

About

A minimal Python script for initialising, testing, and streaming data from a single DIGIT tactile sensor.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages