TC2 Controls

Linux Example of UVC Interface

This guide demonstrates how to control the TC2 camera using available UVC commands via v4l2-ctl, a utility for video4linux drivers. While this example uses video4linux, any UVC driver can be employed. The specific addresses and command types are outlined below.

Lighting Control Example

Lights On

v4l2-ctl -d /dev/video0 -c iris_absolute=100

Lights Off

v4l2-ctl -d /dev/video0 -c iris_absolute=0

UVC Controls

To list the available UVC controls on the TC2, use the following command:
v4l2-ctl -d /dev/video0 --list-ctrls

User Controls

                 brightness 0x00980900 (int)    : min=1 max=64 step=1 recommended_value=8
                   contrast 0x00980901 (int)    : min=1 max=64 step=1 recommended_value=32
                 saturation 0x00980902 (int)    : min=1 max=64 step=1 recommended_value=28
                        hue 0x00980903 (int)    : min=1 max=64 step=1 recommended_value=32
    white_balance_automatic 0x0098090c (bool)   : default=1 recommended_value=0
                      gamma 0x00980910 (int)    : min=0 max=64 step=1 recommended_value=32
                       gain 0x00980913 (int)    : min=0 max=15 step=1 recommended_value=0
       power_line_frequency 0x00980918 (menu)   : min=0 max=2 recommended_value=1 (50 Hz)
  white_balance_temperature 0x0098091a (int)    : min=1800 max=10000 step=1 recommended_value=4450
                  sharpness 0x0098091b (int)    : min=1 max=64 step=1 recommended_value=32
     backlight_compensation 0x0098091c (int)    : min=0 max=1 step=1 recommended_value=0

Camera Controls

              auto_exposure 0x009a0901 (menu)   : min=0 max=3 recommended_value=3
     exposure_time_absolute 0x009a0902 (int)    : min=1 max=5000 step=1 recommended_value=153
               pan_absolute 0x009a0908 (int)    : min=-576000 max=576000 step=3600 recommended_value=3600
              tilt_absolute 0x009a0909 (int)    : min=-576000 max=576000 step=3600 recommended_value=7200
             focus_absolute 0x009a090a (int)    : min=0 max=1023 step=1 recommended_value=700
 focus_automatic_continuous 0x009a090c (bool)   : default=1 recommended_value=0
              zoom_absolute 0x009a090d (int)    : min=0 max=100 step=1 recommended_value=0
            zoom_continuous 0x009a090f (int)    : min=0 max=0 step=0 recommended_value=0
              iris_absolute 0x009a0911 (int)    : min=0 max=100 step=1 recommended_value=100
                  pan_speed 0x009a0920 (int)    : min=0 max=0 step=0 recommended_value=0
                 tilt_speed 0x009a0921 (int)    : min=0 max=0 step=0 recommended_value=0