Introduction
Starting from version 2023.2.0, Aximmetry can natively control PTZ cameras using the Visca protocol. This document discusses how to achieve this. It also lists the currently available commands and their respective settings.
Setting Up Visca for Controlling Cameras
Open the Manage Devices... menu.
NOTE: If you just started Aximmetry Composer and you are at the Aximmetry Startup Configuration Window, click on the Manage Devices... button. If you already running Aximmetry Composer, go to Edit\Manage Devices...
Scroll down to the bottom and select Visca under Camera Controllers, then click Add...:
Specify the target camera's Hostname (IP address) and the Port number. Click OK when you are ready to Add a new Visca Channel, then click OK again to save the changes in the Manage Devices menu:
Sending Commands From Aximmetry
To send commands to the camera from Aximmetry use the Camera Controller module.
Below is a list of the pins of this module and their description:
Device
Here you can select the Device you want to control. Only devices previously added in the Manage Devices menu are listed here.
Command
The Command allows you to choose the type of command you want to transmit.
Params
Param 1-4 are the values you want to set the camera for.
NOTE: The range of supported values depends on the type of command you choose. See the list at the bottom of this document.
NOTE: Depending on the type of command, you may not need these parameters at all, or you may need to provide values for Param 1, Param 1 and 2, Param 1-2-3, or Param 1-2-3, and 4 too. This is specified in the list at the bottom of this document in the column Number of parameters used.
Auto Send
Turning ON Auto Send means that the Camera Controller module automatically updates every change of value towards the camera.
NOTE: It is recommended to use this feature if you want to control the camera in real-time.
Send
Send allows for manually triggering the commands towards the camera.
NOTE: It is recommended to use this feature if you want to use the settings as presets or in cases where the Param 1-4 pins are not used (e.g. Zoom Tele, Zoom Wide, etc.)
List of Commands
The following table contains the supported Visca commands and how Aximmetry interprets parameters.
NOTE: In the Command cases, where the Number of parameters used is "-", use the Send pin on the Camera Controller module to Trigger the command.
Command | Number of parameters used | Param 1 values | Param 2 values | Param 3 values | Param 4 values |
Power On | - | ||||
Power Off | - | ||||
Zoom Stop | - | ||||
Zoom Tele | - | ||||
Zoom Wide | - | ||||
Zoom Tele Variable | 1 | 0.0-1.0 | |||
Zoom Wide Variable | 1 | 0.0-1.0 | |||
Zoom Direct | 1 | 0.0-1.0 | |||
Focus Stop | - | ||||
Focus Far Standard | - | ||||
Focus Near Standard | - | ||||
Focus Far Variable | 1 | 0.0-1.0 | |||
Focus Near Variable | 1 | 0.0-1.0 | |||
Focus Direct | 1 | 0.0-1.0 | |||
Auto Focus | - | ||||
Manual Focus | - | ||||
Switch Auto Or Manual Focus | - | ||||
Focus Lock | - | ||||
Focus Unlock | - | ||||
WB Auto | - | ||||
WB Indoor Mode | - | ||||
WB Outdoor Mode | - | ||||
WB One Push Mode | - | ||||
WB Manual Mode | - | ||||
WB Color Temperature | - | ||||
WB One Push Trigger | - | ||||
Red Gain Reset | - | ||||
Red Gain Up | - | ||||
Red Gain Down | - | ||||
Red Gain Direct | 1 | -128.0-127.0 | |||
Blue Gain Reset | - | ||||
Blue Gain Up | - | ||||
Blue Gain Down | - | ||||
Blue Gain Direct | 1 | -128.0-127.0 | |||
Color Temp Reset | - | ||||
Color Temp Up | - | ||||
Color Temp Down | - | ||||
Color Temp Direct | 1 | 2500-8000 | |||
AE Full Auto | - | ||||
AE Manual | - | ||||
AE Shutter Priority | - | ||||
AE Iris Priority | - | ||||
AE Bright | - | ||||
Iris Reset | - | ||||
Iris Up | - | ||||
Iris Down | - | ||||
Iris Direct | 1 | 0.0-1.0 | |||
Shutter Reset | - | ||||
Shutter Up | - | ||||
Shutter Down | - | ||||
Shutter Direct | 1 | 0.0-1.0 | |||
Gain Reset | - | ||||
Gain Up | - | ||||
Gain Down | - | ||||
Gain Direct | 1 | 0.0-1.0 | |||
Gain Limit | 1 | 0.0-1.0 | |||
Bright Reset | - | ||||
Bright Up | - | ||||
Bright Down | - | ||||
Bright Direct | 1 | 0.0-1.0 | |||
Exp Comp On | - | ||||
Exp Comp Off | - | ||||
Exp Comp Reset | - | ||||
Exp Comp Up | - | ||||
Exp Comp Down | - | ||||
Exp Comp Direct | 1 | 0.0-1.0 | |||
Black Light On | - | ||||
Black Light Off | - | ||||
Flicker | 1 | 0.0,1.0,2.0 | |||
Aperture Mode Auto | - | ||||
Aperture Mode Manual | - | ||||
Aperture Reset | - | ||||
Aperture Up | - | ||||
Aperture Down | - | ||||
Aperture Direct | 1 | 0.0-1.0 | |||
Picture Effect Off | - | ||||
Picture Effect BAndW | - | ||||
Memory Reset | 1 | 0.0-127,0 | |||
Memory Set | 1 | 0.0-127,0 | |||
Memory Recall | 1 | 0.0-127,0 | |||
Preset Recall Speed | - | ||||
Horizontal Flip On | - | ||||
Horizontal Flip Off | - | ||||
Vertical Flip On | - | ||||
Vertical Flip Off | - | ||||
Color Gain | 1 | 0.0-1.0 | |||
Tilt Up | 2 | 0.0-1.0 | 0.0-1.0 | ||
Tilt Down | 2 | 0.0-1.0 | 0.0-1.0 | ||
Pan Left | 2 | 0.0-1.0 | 0.0-1.0 | ||
Pan Right | 2 | 0.0-1.0 | 0.0-1.0 | ||
Pan Tilt Stop | 2 | 0.0-1.0 | 0.0-1.0 | ||
Pan Tilt Absolute | 4 | 0.0-1.0 | 0.0-1.0 | -170.0-170.0 | 0.0-90.0 |
Pan Tilt Relative | 4 | 0.0-1.0 | 0.0-1.0 | -170.0-170.0 | 0.0-90.0 |
Pan Tilt Home | - | ||||
Pan Tilt Reset | - | ||||
Tilt Limit Set | 3 | 0.0, 1.0 | -170.0-170.0 | 0.0-90.0 | |
Tilt Limit Clear | 1 | 0.0, 1.0 | |||
Brightness Direct | 1 | 0.0-1.0 | |||
Contrast Direct | 1 | 0.0-1.0 | |||
Video Flip Off | - | ||||
Video Flip Horizontal | - | ||||
Video Flip Vertical | - | ||||
Video Flip Horizontal Vertical | - | ||||
Save Current Setting | - | ||||
AWB Sensitivity High | - | ||||
AWB Sensitivity Normal | - | ||||
AWB Sensitivity Low | - | ||||
AF Zone Top | - | ||||
AF Zone Center | - | ||||
AF Zone Bottom | - | ||||
Color Hue Direct | 1 | 0.0-1.0 | |||
OSD Open/Close | - | ||||
OSD Navigate Up | - | ||||
OSD Navigate Down | - | ||||
OSD Navigate Left | - | ||||
OSD Navigate Right | - | ||||
OSD Enter | - | ||||
OSD Return | - | ||||
AF Calibration | - | ||||
Tally Light Control | 1 | 1.0, 2.0, 3.0 | |||
NDI Mode High | - | ||||
NDI Mode Medium | - | ||||
NDI Mode Low | - | ||||
NDI Mode Off | - | ||||
Multicast Mode | 1 | 1.0, 2.0 | |||
PTZ Motion Sync On | - | ||||
PTZ Motion Sync Off | - | ||||
PTZ MS Lower Speed Limit | 1 | 0.0-255.0 | |||
UAC Toggle USB Audio | 1 | 2.0, 3.0 |