Overview
VISCA (Video System Control Architecture) is an industry-standard protocol for controlling PTZ cameras, originally developed by Sony and now supported by most professional broadcast and conferencing cameras. Iris uses VISCA to communicate with your cameras over the network, enabling real-time movement control, position tracking, image settings management, and advanced features like click-to-center, fast framing, and auto-tracking.
When you add a supported PTZ camera to Iris and select the correct brand and model, the system automatically establishes a VISCA connection and handles everything behind the scenes — you don't need to configure VISCA settings manually in most cases.
What You'll Need
A VISCA supported PTZ camera connected to the same network as your Iris agent.
Network connectivity between the Iris agent and the camera. The camera must be reachable at its IP address on the configured control port (typically port 52381 for VISCA over UDP).
The camera must be powered on and ready to accept commands.
Camera added to your room with the correct brand and model selected. This ensures Iris knows the camera's exact capabilities and movement ranges.
For detailed setup:
What VISCA Enables in Iris
Once connected, VISCA powers these capabilities:
Pan, tilt, and zoom — Real-time directional control of your camera
Position tracking — Iris continuously reads the camera's current pan, tilt, and zoom position, which is essential for advanced tools
Image settings — Adjust exposure, white balance, focus, and other parameters
Presets — Save and recall camera positions
Advanced movement tools — Click-to-center, fast frame, cine frame, and auto-tracking (require calibration)
Camera status — Power state detection, movement indicators, connection health
These are accessible from the Control Tray, Image Tray, and Advanced Settings panels.
How to Connect Your Camera
In Iris Studio, add a new video source to your room.
Select the camera's brand and model from the list. If your exact model isn't listed, choose "Other" under the brand — Iris will use a generic driver.
Enter the camera's IP address and video stream details.
Iris automatically establishes a VISCA control connection. You'll see the connection status update in the source badge.
You don't need to configure VISCA settings like port or protocol manually — Iris handles this based on your model selection. You only need to provide the camera's IP address.
Ways to Control Your Camera
Once connected, you have several options:
D-Pad — On-screen directional pad in the control panel. Supports 8 directions (including diagonals) plus zoom in/out buttons.
Virtual Joystick — Hold Space (default) while hovering over the video preview. Move your mouse to pan and tilt in real time.
Physical IP Joystick — Connect a hardware VISCA joystick controller. It's automatically detected when it sends its first message. Desktop app only.
Gamepad — USB or Bluetooth gamepad for pan, tilt, zoom, and quick shots.
Click to Center — After calibration, click any point on the video to center the camera there.
Fast Frame — After calibration, draw a rectangle on the video to frame that area — camera pans, tilts, and zooms to match.
Keyboard — Arrow keys for pan/tilt, = and - for zoom.
When you release any control input, Iris sends an explicit stop command to the camera.
Network Configuration
VISCA requires network access between Iris and the camera:
Camera and Iris Bridge must be on the same local network (or VPN)
Firewall must allow traffic on the camera's VISCA port (typically 52381)
UDP or TCP traffic to the camera's IP must be allowed
While Connected
Here's what you'll see and what's happening behind the scenes:
Connection status badge — Each source shows whether it's connected or disconnected. If the camera becomes unreachable, the badge updates.
Position tracking — Iris continuously reads the camera's pan, tilt, and zoom position. This powers the position indicator and is required for advanced features like click-to-center and auto-tracking.
Movement indicator — The interface shows whether the camera is currently in motion.
Disabled controls — If the camera doesn't support a particular axis (e.g., a box camera with zoom only), those D-Pad directions are grayed out.
Iris enforces a small delay between commands to avoid overwhelming the camera. Joystick commands are sent at roughly 10 updates per second.
Some camera models have built-in command delays for stability — for example, certain Sony models have a ~220ms delay. If your camera feels slightly slower to respond, this may be the reason.
Calibration
After adding a camera, Iris may prompt you to calibrate. Calibration maps the camera's internal position values to real-world angles and zoom levels.
During calibration, the camera moves on its own — takes a few minutes
On success: "Calibration complete" notification, all advanced tools unlocked
On failure: options to retry, use a generic driver (less precision), or skip
Without calibration, only basic directional movement and zoom are available. Click-to-center, fast frame, and auto-tracking all require a successful calibration.
Camera Power Control
Iris can detect your camera's power state. In Advanced Settings, you'll find:
Wake Up — Powers on the camera from standby
Sleep — Puts the camera into standby
While the camera is powering on or rebooting, movement controls are temporarily disabled.
Auto-Tracking Protection
If auto-tracking is running and you try to move the camera manually, Iris shows an alert rather than immediately moving — this prevents conflicts between manual and automated control. You can choose to override tracking or cancel.
Limits and Restrictions
Supported protocols: UDP (most common), TCP, and serial. Determined by camera model.
Default control port: 52381 for most VISCA cameras. Some models use different ports.
Movement ranges: Camera-dependent. Typical: pan ±170°, tilt -30° to +90°.
Speed limits: Pan/tilt speeds typically 1-24, zoom speed 0-7 (camera-dependent).
Command timing: Small delay between commands to prevent overwhelming the camera. Joystick at ~10 updates/sec.
One input at a time: Commands from different input methods (D-Pad, joystick, gamepad) are processed sequentially. Most recent input takes priority.
Calibration required for advanced tools: Center, fast frame, and auto-tracking need calibration. Without it, only basic movement is available.
Model-dependent features: Certified models are fully tested. Generic ("Other") models use a standard VISCA command set that may not support all features.
What Happens If…
…the camera loses network connectivity? Iris detects this continuously. The status badge changes to "Disconnected" and Iris attempts to reconnect automatically every 2 seconds. Once reachable again, control resumes.
…you try to use advanced tools without calibration? They'll be unavailable or hidden. You'll see a prompt to calibrate first.
…calibration fails? Three options: retry (skips already-completed steps), use a generic driver (less precision), or skip entirely. You can always recalibrate later.
…the camera is powered off or in standby? Use the "Wake Up" button in Advanced Settings. While powering on, movement controls are temporarily disabled.
…you select the wrong camera model? Incorrect movement ranges, missing features, or commands the camera doesn't understand. If behavior seems off, verify the brand and model in your source settings.
…auto-tracking is active and you try to move manually? An alert appears to prevent conflicts. You can choose to override or cancel.
…you close the Iris app? The camera stops at its current position. When you reopen and reconnect, control resumes from wherever the camera is.
Troubleshooting
What's happening | Likely cause | What to do |
Camera shows "Disconnected" | Camera is off, wrong network, or IP is wrong | Verify camera is on and reachable at the configured IP. Check same network. |
D-Pad directions are grayed out | Camera doesn't support pan/tilt, or capabilities haven't loaded | Confirm correct model selected. Wait a moment for capabilities to load. |
Camera moves erratically or wrong direction | Wrong model selected, or pan/tilt inversion needed | Verify model. Check "Invert Pan Direction" or "Tilt Flip" in Advanced Settings. |
Calibration fails repeatedly | Featureless scene, poor lighting, or obstruction | Point camera at a varied scene with good lighting. Avoid blank walls. |
Joystick/gamepad not working | Not detected or not assigned | Verify controller is connected and recognized. Check source is selected. |
Camera responds slowly | Network latency or camera-specific delays | Check network. Some models (e.g., Sony) have built-in ~220ms command delays. |
Center or Fast Frame tools missing | Camera not calibrated | Calibrate from the context menu or Advanced Settings. |
VISCA commands not reaching camera | Firewall blocking port 52381 | Allow UDP/TCP on the camera's VISCA port in your firewall. |
FAQs
What is VISCA? VISCA (Video System Control Architecture) is a protocol originally developed by Sony for controlling video cameras. It's now an industry standard supported by most PTZ cameras. Iris uses it to send movement commands and read camera status over your network.
Do I need to configure VISCA settings manually? Usually no. When you select your camera's brand and model, Iris automatically configures the correct settings (port, protocol, speed ranges, etc.). You only need to provide the camera's IP address.
Does Iris support VISCA over serial (RS-232/RS-422)? Yes. Iris supports VISCA over serial connections in addition to UDP and TCP. The connection type depends on your camera model and configuration.
Can I control multiple cameras at the same time? Yes. Each camera has independent VISCA control. Switch between cameras and control them individually. Each camera processes one movement command at a time.
What's the difference between Certified and "Other" camera models? Certified models are fully tested — all movement ranges, image settings, and advanced features are validated. "Other" (generic) models use a standard VISCA command set covering basic PTZ but may not include camera-specific features.
Can I use VISCA alongside NDI or ONVIF? Yes, if your camera supports it. VISCA handles camera control while NDI/ONVIF handle video transport — they can operate simultaneously.
Can I use presets with VISCA cameras? Yes. Iris's Position Presets let you save and recall camera positions. The number of available presets depends on your Iris configuration (up to 25 per group, 10 groups per device).
Can I adjust movement speed? Yes. D-Pad, joystick, and zoom controls all have configurable speed settings (Fixed/Variable mode with a rate slider). You can also adjust camera-level speed parameters in Advanced Settings.
Why does my camera need calibration? Calibration teaches Iris how your camera's internal position values map to real-world angles and zoom levels. This is essential for click-to-center, fast frame, and auto-tracking.
What if my camera doesn't respond to commands? Check network connectivity, verify the camera's IP address, confirm the VISCA port (usually 52381) is open in your firewall, and make sure the camera firmware is up to date.