Skip to main content

How Iris AI Uses VISCA for PTZ Camera Control

Updated over 2 months ago

Overview

VISCA (Video System Control Architecture) is a protocol developed to enable precise control of PTZ (Pan-Tilt-Zoom) cameras. Iris AI uses VISCA-over-IP to provide real-time control, automation, and synchronization across supported camera models.

This article explains how VISCA is implemented in Iris, what features it enables, and how users can take advantage of it in their workflows.


What Iris AI Uses VISCA For

Iris AI uses VISCA-over-IP to:

  • Pan, tilt, and zoom supported cameras in real time

  • Set and recall camera presets from the dashboard or via automation

  • Adjust focus, exposure, white balance, and image settings

  • Sync the current state of the camera to the software interface

  • Trigger camera movements

These commands are issued via:

  • The Iris web dashboard

  • Custom automation workflows


Linking Cameras and Supported Models

To use VISCA features with a camera in Iris:

  1. Link the camera via the "Add Camera" workflow

  2. Assign a static IP address or use a DHCP reservation

  3. Confirm that the camera model supports VISCA-over-IP

  4. Ensure the camera firmware is up to date

Refer to these resources:


Network and Firewall Configuration

VISCA-over-IP requires network access between the Iris AI platform and the camera.

Minimum requirements:

  • Camera and Iris Bridge must be on the same local network or VPN

  • Firewall must allow inbound and outbound traffic on the camera’s VISCA port (typically 52381 for Sony-style commands)

  • UDP or TCP traffic to the camera's IP address must be allowed


VISCA-Based Camera Controls in Iris

Iris supports VISCA-based control of:

  • Pan and tilt direction and speed

  • Zoom control with adjustable speed

  • Resetting image parameters (white balance, exposure, etc.)

  • Saving and recalling camera presets

These functions are available from the Control Tray, Image Tray, & Advanced Settings panels in the Iris UI.

Key references:


Security and Logging

Iris uses secure communication protocols to control devices. VISCA commands are only sent to devices registered and approved by the user.

If a VISCA command fails (e.g., due to a camera being offline or misconfigured), Iris logs the attempt in the backend for future debugging.


Limitations

  • VISCA-over-IP only. Serial (RS-232/422) connections are not supported.

  • Some cameras may only support partial command sets

  • Preset performance and pan/tilt/zoom behavior may vary by camera model

  • Presets must be stored within the camera or cloud-synced using the Iris interface


Frequently Asked Questions

Q: Does Iris support VISCA over serial?

A: No. Iris only supports VISCA-over-IP for networked cameras.

Q: Can I use VISCA at the same time as NDI or ONVIF?

A: Yes, if your camera supports it. Hybrid operation is possible with some models.

Q: What if my camera does not respond to commands?

A: Double-check the network configuration, firmware version, and whether the VISCA port is open on your firewall.

Did this answer your question?