Skip to content

IDS ​

SUMMARY

The IDS class provides a Python interface for IDS cameras, supporting single-image capture, continuous image streaming, and remote control over BabyROS. It wraps the IDS Peak SDK to handle device connection, buffer allocation, parameter management, and safe teardown.

Requirements: IDS Peak Cockpit 2.9.0.0 and IDS Peak 2.20.0.0-484 must be installed, and a supported IDS camera must be connected via USB3.

Tested devices:

  • IDS U3-36PxXCP-C with IDS 8.5mm 1:2.8 C 1.1" lens (IDSU336P0XCPCHQ)
  • IDS U3-35L0XC (IDSU336L0CX)

Installation ​

Install Medulla first — see Installation.

Then install the IDS-specific dependencies:

  1. Install the IDS SDK (Windows) from the official website:
    https://de.ids-imaging.com/download-peak.html
    Follow the installation wizard and restart your PC.
  2. Install the IDS dependencies via the Telekinesis SDK:
    bash
    pip install telekinesis-ai[medulla-ids]

Getting Started ​

WARNING

Examples were tested on Windows 11 only.

After installing the IDS software, connect your IDS camera and open IDS Peak Cockpit to configure it:

  1. Open the camera manager and start the camera by selecting your camera in the left panel and clicking the camera button:
IDS Peak Cockpit open camera

Under U3V Producers you will see all cameras connected to your PC. The list shows the camera model (e.g. U3-36PxXCP-C) followed by its serial number (e.g. 4108909352).

  1. Adjust camera parameters as needed (e.g. analog gain, exposure):
IDS Peak Cockpit adjust settings

Cameras run in free-run mode by default — parameter changes are reflected immediately in the viewer.

  1. Close IDS Peak Cockpit before running any medulla script.

WARNING

Only one program can access the camera at a time. Close IDS Peak Cockpit before running medulla. Parameter changes persist as long as the camera remains connected and the PC is not restarted.

  1. Capture an image using medulla. IDS is a base class, so create the wrapper for your model (IDSU336L0CX or IDSU336P0XCPCHQ); the serial number is passed to connect():
python
from telekinesis.medulla.cameras import ids

camera = ids.IDSU336L0CX(name="my_ids_camera")
camera.connect(serial_number="4108909352")
image = camera.capture_image()
camera.disconnect()

Examples ​

SkillDescription
Capture Color ImageCapture one color frame and visualize with Rerun
Stream Live Color VideoStream continuous frames to a Rerun viewer
Get Parameter / Set ParameterRead or write camera parameters such as exposure and frame rate
Publish Video with BabyROSStream and remotely control the camera over BabyROS topics