Sony SRG-A40 Command List
Sony SRG-A40 Command List

Sony SRG-A40 Command List

Color video camera
Hide thumbs Also See for SRG-A40:

Advertisement

Quick Links

5-053-155-11 (1)
Color Video Camera
VISCA Command List
CGI Command List
Software Version 1.0
SRG-A40/A12
© 2023 Sony Corporation

Advertisement

Table of Contents
loading

Summary of Contents for Sony SRG-A40

  • Page 1 5-053-155-11 (1) Color Video Camera VISCA Command List CGI Command List Software Version 1.0 SRG-A40/A12 © 2023 Sony Corporation...
  • Page 2: Table Of Contents

    Use of control software based upon this Table of Contents command list may cause malfunction or damage to hardware and software. We are not Overview ........... 3 liable for any such damage. About This Document ......3 VISCA ............3 Overview of VISCA ........
  • Page 3: Overview

    ........................................1) “VISCA” is a trademark of Sony Corporation. 2) The product name of this camera, “Color video camera SRG-A40/A12” is referred to as “the camera” in this document.
  • Page 4: Visca Communication Specifications

    VISCA Communication Specifications VISCA packet structure The basic unit of VISCA communication is called a packet (Fig. 2). The first byte of the packet is called the header and the packet comprises the sender’s and receiver’s addresses. For example, the header of the packet sent to the camera (address 1) from the controller (address 0) is 81H in hexadecimals.
  • Page 5 Timing Chart Responses for commands and inquiries As VISCA command processing can only be • ACK message carried out a maximum of one time in a Vertical Returned by the camera when it receives a (V) cycle, it takes maximum 4V-cycle time for an command.
  • Page 6: Visca Device Setting Command

    To cancel a command when VISCA PAN-TILT Drive GGGG = Vender ID (page 18) is being executed, wait at least 200 0001: Sony msec after executing. Then send a cancel HHHH = Model ID command to ensure that PAN-TILT Drive stops 0621:SRG-A40 effectively.
  • Page 7: Visca Command/Ack Protocol

    VISCA Command/ACK Protocol Command Command Reply Message Comments Message General 81 01 04 38 02 FF 90 4z FF (ACK) , 90 5z Returns ACK when a command has been accepted, Command (Example) FF (Completion) then returns Completion when a command has been (z: Socket No.) executed.
  • Page 8: Visca Camera-Issued Messages

    VISCA Camera-Issued Messages ACK/Completion Messages Command Command Message Comments y0 4z FF Returned when the command is accepted. (z: Socket No.) Completion y0 5z FF Returned when the command has been executed. (z: Socket No.) y = Device address + 8 (Locked to “y = 9” for VISCA over IP.) Error Messages Command Command Message...
  • Page 9: Visca Over Ip

    VISCA over IP Overview of VISCA over IP With VISCA over IP function, you can control the camera using VISCA on a controller equipped with IP communication capabilities via LAN. You can connect up to 5 controllers simultaneously on the network. The communication specifications of VISCA over IP are as follows: •...
  • Page 10: Communication Method Of Visca Over Ip

    Due to the nature of the IP communication, the • IF_Clear use of some VISCA functions are limited. For Sends the reply message to the controller after details, see “Limitation” on page 13. clearing, without using VISCA socket. • CAM_VersionInq For how to set an IP address of the camera, see Sends the reply message to the controller, “Camera IP Setting Command”...
  • Page 11 Payload type Stores the value (Byte 0 and Byte 1) of the following table on the payload division. Name Value (Byte 0) Value (Byte 1) Description VISCA command 0x01 0x00 Stores the VISCA command. VISCA inquiry 0x01 0x10 Stores the VISCA inquiry. VISCA reply 0x01 0x11...
  • Page 12 Delivery confirmation VISCA over IP uses UDP as a communications protocol of the transport layer. Delivery of messages is not guaranteed for the UDP communication. Delivery confirmation and retransmission should be performed on the application. Normally, when the controller sends a message to the peripheral device, the controller sends the new message after receiving the reply for the last message.
  • Page 13 of limitations of order to receive commands or execution interval of command. It may cause efficiency to be reduced substantially. Timing chart without hindrance since the peripheral device recognizes that its address is set to 1. Controller Peripheral device Locking the controller’s address of the VISCA message to 0 For the same reason as the peripheral device’s Time out...
  • Page 14: Visca Command List

    VISCA Command List Command List Number in ( ) is MENU display values. Command Set Command Command Packet Comments EXPOSURE MODE 8x 01 04 39 0p FF p: 0=Full Auto, 3=Manual, A=Shutter Priority, B=Iris Priority IRIS Reset 8x 01 04 0B 00 FF To return to 19 (F2.0) value 8x 01 04 0B 02 FF Open...
  • Page 15 Number in ( ) is MENU display values Command Set Command Command Packet Comments EXPOSURE VISIBILITY On/Off 8x 01 04 3D 0p FF p: 6=On, 3=Off ENHANCER 8x 01 04 2D 00 0p 0q 0r p: Effect Level 0 (Dark) - 6 (Bright) 00 00 00 00 FF q: Brightness compensation selection (0=Very dark, 1=Dark, 2=Standard, 3=Bright)
  • Page 16 Number in ( ) is MENU display values. Command Set Command Command Packet Comments DEFOG 8x 01 04 37 0p 0q FF p: 2=On, 3=Off q: Defog Level 0 (same as 2), 1 (Weak) - 3 (Strong) HIGH 8x 01 04 52 0p FF p: 2=On, 3=Off RESOLUTION NOISE...
  • Page 17 Number in ( ) is MENU display values. Command Set Command Command Packet Comments FOCUS MODE Auto/Manual 8x 01 04 38 pp FF pp: 02=Auto Focus, 03=Manual Focus, 10=Toggle STOP 8x 01 04 08 00 FF Standard 8x 01 04 08 02 FF speed NEAR Standard...
  • Page 18 Number in ( ) is MENU display values. Command Set Command Command Packet Comments PAN TILT PAN TILT DRIVE 8x 01 06 01 vv ww 03 01 vv: Pan speed 01 (Slow) - 18 (Fast) ww: Tilt speed 01 (Slow) - 17 (Fast) Down 8x 01 06 01 vv ww 03 02 vv: Pan speed 01 (Slow) - 18 (Fast)
  • Page 19 Number in ( ) is MENU display values. Command Set Command Command Packet Comments SYSTEM VIDEO FORMAT Select 8x 01 7E 04 32 0p 0p FF pp: Video Format For pp, refer to the section of the Video output method (video format) of VISCA Command Setting Values IR RECEIVE 8x 01 06 08 pp FF...
  • Page 20: Inquiry Command List

    Inquiry Command List Number in ( ) is MENU display values. Inquiry Command Inquiry Packet Reply Packet Comments EXPOSURE MODE 8x 09 04 39 FF y0 50 0p FF p: 0=Full Auto, 3=Manual, A=Shutter Priority, B=Iris Priority IRIS 8x 09 04 4B FF y0 50 00 00 0p 0p pp: Refer to the VISCA Command Setting Values (IRIS) section...
  • Page 21 Number in ( ) is MENU display values. Inquiry Command Inquiry Packet Reply Packet Comments DETAIL LEVEL 8x 09 04 42 FF y0 50 00 00 0p 0p pp: 00 - 0F MODE 8x 09 05 42 01 FF y0 50 0p FF p: 0=Auto, 1=Manual BANDWIDTH 8x 09 05 42 02 FF...
  • Page 22 Number in ( ) is MENU display values. Inquiry Command Inquiry Packet Reply Packet Comments PAN TILT POSITION 8x 09 06 12 FF y0 50 0p 0p 0p 0p Refer to the section of the Pan/ 0t 0t 0t 0t FF Tilt Position of VISCA Command Setting Values for pppp and tttt STATUS...
  • Page 23 Number in ( ) is MENU display values. Inquiry Command Inquiry Packet Reply Packet Comments SYSTEM VIDEO FORMAT 8x 09 7E 04 31 FF y0 50 0p FF Whether the setting can be SELECTABLE changed by the command of the Video output method (video format) or not.
  • Page 24: Block Inquiry Command

    Block Inquiry Command Lens control system inquiry commands…..Inquiry Packet 8x 09 7E 7E 00 FF Byte Comments Byte Comments Byte Comments Destination Address Focus Near Limit (H) Source Address Zoom Mode (H)* AF Mode AF Sensitivity Focus Near Limit (L) Zoom Mode (L)* Focus Mode Low Contrast...
  • Page 25 Camera control system inquiry commands…..Inquiry Packet 8x 09 7E 7E 01 FF Byte Comments Byte Comments Byte Comments Destination Address Gain Position White Balance Mode Source Address White Balance Speed Detail Level Exposure Mode Exp Comp Level R Gain (H) High Sensitivity Visibility Enhancer Backlight...
  • Page 26 Other block inquiry commands…..Inquiry Packet 8x 09 7E 7E 02 FF Byte Comments Byte Comments Byte Comments Destination Address Source Address White Balance Offset Spotlight Flicker Cancel Auto ICR Camera ID (HH) Power Image Stabilizer IR Cut Filter Camera ID (HL) Camera ID (LH) Camera ID (LL) Picture Effect...
  • Page 27 Other enlargement inquiry commands (1/2) ..Inquiry Packet 8x 09 7E 7E 03 FF Byte Comments Byte Comments Byte Comments Destination Address AE Speed AF staying time (H) Source Address High Sensitivity AF staying time (L) Noise Reduction Level Noise Reduction 2D Chroma Suppress NR Level Gain Limit...
  • Page 28 Other enlargement inquiry commands (2/2) ..Inquiry Packet 8x 09 7E 7E 04 FF Byte Comments Byte Comments Byte Comments Destination Address Detail Limit Source Address Detail BW Balance VE Compensation Level Detail Highlight Detail Detail Super Low Defog Detail Mode Detail Bandwidth Defog Level Visibility Enhancer...
  • Page 29: Camera Ip Setting Command

    Command Data Camera IP Setting Inquiry ENQ:network Command Broadcast address (255.255.255.255) The following commands are provided for Specified port number (52380) setting an IP address and a camera name for SRG series cameras. Inquiry reply MAC:**-**-**-**-**-** Name Description Broadcast address MODEL:IPCARD Setting Protocol: The controller inquires the...
  • Page 30: Cgi

    Notes • The camera name (NAME) is to be up to 8 characters of alphanumeric characters and spaces. Advance Preparation • The camera’s IP address of the network setting and camera name cannot be changed when This document provides information about how WRITE of Inquiry reply is set to off.
  • Page 31: Changing The Setting Of Referer Check

    Changing the Setting of Referer Check Setting/Inquiring by CGI As default, HTTP CGI command delivery checks the requests by checking Referer field in HTTP Commands header to make sure that they are available only via Web page built in the cameras. You can change the setting to prevent CGI requests from being denied by this Referer check function.
  • Page 32 Syntax1 (standard format) http://<camera_address>/command/inquiry.cgi?inq= <Inquiry>[&inq=<Inquiry>...] When <inquiry> is ptzautoframing, /commnand/ becomes /analytics/. The response is as follows in the case of standard format. HTTP/1.0 200 OK\r\n Content-Type: text/plain\r\n Content-Length: <len>\r\n \r\n <parameter>=<value>[&<parameter>=<value>&<para meter>=<value>...] Syntax2 (JS parameter format) http://<camera_address>/command/ inquiry.cgi?inqjs=<Inquiry>[&inqjs=<Inquiry>...] When <inquiry> is ptzautoframing, /commnand/ becomes /analytics/.
  • Page 33: Cgi Command List

    CGI Command List audio.cgi Setting (Set): command/audio.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=audio Parameter Value Description MicLineSelect mic, line Sets the level of the audio input signal. mic : MIC input line : LINE input AudioInVolume Sets the audio volume of the audio input -10 to 10 when MicLineSelect is set to mic.
  • Page 34 Parameter Value Description ImageSize1 3840,2160, Sets the image size of the video stream 1920,1080, corresponding to Image 1. 1280,720, 640,360 * The available setting values are limited by the video output format. * Refer to the item “IMAGE SIZE” of CGI Command Setting Values.
  • Page 35 Parameter Value Description H265Profile1 main Sets the H.265 profile of Image 1. main : Fixing to main profile. H265Profile2 main Sets the H.265 profile of Image 2. main : Fixing to main profile. CBR1 on, off Sets the bit rate restriction mode of Image on : Performs the bit rate restriction by off : Performs the bit rate restriction by * When StreamMode is set to srt-caller or...
  • Page 36 Parameter Value Description H265Quality2 Sets the H.265 VBR (variable bit rate) picture 1 to 10 quality of Image 2. When CBR2 is set to off, this parameter is valid. * The higher the value, the quality is improved. However, the amount of the generated data increases.
  • Page 37 datetime.cgi Setting (Set): command/datetime.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=datetime Parameter Value Description GmTime YYMMDDhhmmssW Sets or inquires the date and time by Coordinate Universal Time (UTC). YYMMDD : Year, Month, Day [000101 - 380119] (Defined by DateFormat.) hhmmss : Hour, minute, second (24 hours) : Week (Sunday=0, Monday=1, .., Saturday=6)
  • Page 38 project.cgi Setting (Set): command/project.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=project Parameter Value Description VideoFormatSelectable 0, 1 Returns whether the video output format can be changed by SelectVideoFormat or not. 0 : Cannot be changed. 1 : Can be changed. SelectVideoFormat * Refer to the item “VIDEO Sets the video output format.
  • Page 39 ptzautoframing.cgi Setting (Set): analytics/ptzautoframing.cgi?<Parameter>=<Value> Inquiry (Inq): analytics/inquiry.cgi?inq=ptzautoframing Parameter Value Description PtzAutoFraming on, off Starts or finishes tracking of PTZ Auto Framing. on : Starts tracking of PTZ Auto Framing. off : Finishes tracking of PTZ Auto Framing. PtzAutoFramingAutoStartEnable on, off Starts PTZ Auto Framing automatically when the camera’s Power turns on.
  • Page 40 Parameter Value Description PtzAutoFramingAdjustObjectSize size1, size2, size3, size4 Sets the object size of PTZ Auto Framing. The object size of “size1” is the smallest and “size4” is the biggest. The item differs depending on the PtzAutoFramingShotMode setting. The setting, the setting item, and the choice of PtzAutoFramingShotMode (closeup) size1, size2, size3...
  • Page 41 Parameter Value Description PtzAutoFramingTrackingStatus idle, missing, preparing, Gets the operating status of PTZ Auto searching, tracking, Framing. waiting idle : Under suspension missing : While tracking lost preparing : While preparing the tracking searching : While searching tracking : While tracking waiting : Waiting for the tracking object to be selected...
  • Page 42 Web UI. 1 : Temperature anomaly status 0 : Normal status system.cgi Inquiry (Inq): command/inquiry.cgi?inq=system Parameter Value Description ModelName “SRG-A40” (SRG-A40) Returns the camera name. “SRG-A12” (SRG-A12) Serial 00000000 to 99999999 Returns the camera serial number.
  • Page 43 unsubscribe.cgi Setting (Set): command/unsubscribe.cgi?<Parameter>=<Value> Parameter Value Description SubscriptionId Displays for Web App. Do not set this. imaging.cgi Setting (Set): command/imaging.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=imaging Parameter Value Description AESpeed 1 to 48 Sets the response speed of exposure. Camera operates according to this setting when ExposureMode is set to auto, shutter, or iris.
  • Page 44 Parameter Value Description DetailCrispening Sets the Crispening function of contour 0 to 7 emphasis. Setting is applied when DetailMode is set to manual. DetailHighlightDetail 0 to 4 Sets the level of contour added to brightly- lit objects. Larger the number, larger the emphasis volume of the contour.
  • Page 45 Parameter Value Description ExposureExposureTime The available values Sets the shutter speed when depend on the video ExposureMode is set to shutter or manual. output format. * Refer to the item “SHUTTER” of CGI Command Setting Values. 6 to 33 (59.94p, 59.94i, 50p, 50i, 23.98p) 6 to 33 (29.97p, 29.97i, 25p, 25i)
  • Page 46 Parameter Value Description ExposureMode auto, shutter, iris, manual Sets the exposure control mode. auto : Automatically adjust iris, gain, and shutter speed. shutter : Automatically adjust gain and iris according to set shutter speed. iris : Automatically adjust gain and shutter speed according to set iris.
  • Page 47 Parameter Value Description VisibilityEnhancerLevel [Value1] Sets the parameter for Visibility Enhancer function. 0 to 6 VisibilityEnhancerLevel=Value1,Value2, [Value2] Value3 0 to 3 [Value1] Brightness level [Value3] [Value2] Brightness correction 0 to 2 [Value3] Strength correction WhiteBalanceCbGain Sets the B gain when WhiteBalanceMode is 0 to 255 set to manual.
  • Page 48 ptzf.cgi Setting (Set): command/ptzf.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=ptzf Parameter Value Description AbsolutePanTilt [Value1] Executes the pan/tilt movement by de00 to 2200 specifying coordinate. AbsolutePanTilt=Value1,Value2,Value3 [Value2] The available values [Value1] depend on the Eflip Sets the pan position by coordinate settings. fc00 to 1200 (Off) de00 : Counterclockwise 170 deg.
  • Page 49 Parameter Value Description AbsolutePTZF [Value1] Executes the pan/tilt/zoom/focus de00 to 2200 movement by specifying coordinate, or returns the current coordinate. [Value2] AbsolutePTZF=Value1,Value2,Value3,Value4 The available values depend on the Eflip [Value1] settings. Sets the pan position by coordinate fc00 to 1200 (Off) ee00 to 0400 (On) de00 : Counterclockwise 170 deg.
  • Page 50 Parameter Value Description AbsoluteZoom The available values Moves the zoom by specifying the absolute depend on the Zoom position. Mode status and the video size of the output 0000 : Wide end signal format. 4000 : Optical tele end 5556 : Clear Image Zoom tele end *1 0000 to 4000 (optical) (4K)
  • Page 51 Focus. [Value2] [Value1] pantilt, motor, zoom, Stops focus [Value2] pantilt : Stops Pan-Tilt moving motor : Stops Pan-Tilt moving zoom : Stops Zoom moving focus : Stops Focus moving OpticalZoomMaxMagnification X20 (SRG-A40) Returns the maximum optical zoom ratio. X12 (SRG-A12)
  • Page 52 Parameter Value Description PanLimitMode unlimited, limited Sets the limit mode of the pan’s movement range. unlimited : A limit does not exist. limited : Limits in the range which is set on PanLimit. PanMovementRange [Value1] Returns the possible movement range of de00 pan.
  • Page 53 Parameter Value Description RelativeFocus ffff1000 Moves the focus position by specifying relative position from the current position. 0000f000 This command is only valid when FocusMode is set to manual. Actual movement range is also affected by the value of FocusNearLimit parameter. ffff1000 : The maximum amount to focus far direction...
  • Page 54 Upper end 1200 (Off) 0400 (On) * Refer to the item “PAN/TILT POSITION” of CGI Command Setting Values. ZoomMaxVelocity Returns the maximum speed of zoom movement. ZoomMovementRange SRG-A40 Returns the possible movement range of zoom. [Value1] 0000 ZoomMovementRange=Value1,Value2, Value3,Value4 [Value2] 4000...
  • Page 55 Parameter Value Description ZoomMove [Value1] The command for operating with the Zoom tele, wide, stop slider of the Web UI. [Value2] [Value1] Direction 0 to 32766 [Value2] Speed The speed range is 0 to 32766. However, the operation is divided into 8 steps. 0 to 4095 : 0 (slow) 4096 to 8191...
  • Page 56 Parameter Value Description HomePos recall Moves the Pan-Tilt of the camera to the Home Position. * Coordinate of the home position is Pan : 0000, Tilt : 0000. This coordinate cannot be changed. PresetCall [Value1] Recalls a registered preset. 1 to 256 PresetCall=Value1 [Value1] The preset number to recall...
  • Page 57 Parameter Value Description SeparateSpeed [Value1] Sets the pan/tilt speed corresponding to 1 to 256 each preset when SpeedSelect is set to separate. [Value2] 1 to 25 [Value1] Preset number to be set [Value2] Speed to be set * Refer to the item “PRESET RUN SPEED” of CGI Command Setting Values.
  • Page 58 Parameter Value Description RTallyStatus 0, 1 Outputs Tally Control status. : Turns off the light. : Turns on the light. TallyIndicationPtzAutoFraming on, off Sets the Green Tally movement while tracking PTZ Auto Framing. on : Controls the Tally lamp depending on the Analytics status.
  • Page 59 sysinfo.cgi Setting (Set): command/sysinfo.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=sysinfo Parameter Value Description AudioInFunc Returns whether the audio input function is supported or not. 1 : Supported ContinuousPanTiltZoomFunc Returns whether ContinuousPanTiltZoom CGI command is supported or not. 0 : Not supported ContinuousPanTiltZoomInterval " " No value for this model, as it does not support ContinuousPanTiltZoom function.
  • Page 60 No value for this model, as it does not support WideDynamicRangeLevel function. " " : no value NetworkCameraName [Fixed value] Returns the camera name. SRG-A40 : A40 SRG-A12 : A12 NetworkCameraName can only be inquired. Can be changed in CameraName of network.cgi. FreeDFunc Returns the presence/absence of the Free- D (Tracking data output) correspondence.
  • Page 61 main.cgi Setting (Set): command/main.cgi?<Parameter>=<Value> Parameter Value Description FactoryDefault hard, soft Resets the camera to the default settings. hard: Hard reset (returns all settings to the factory default) soft : Soft reset (retain the network and security settings) System on, reboot, standby Sets the camera power status.
  • Page 62 : Does not acquire automatically CameraName 0 to 8 characters Setting of the camera name. [Default] The 8 and less alphanumerical characters SRG-A40 : A40 can be set. SRG-A12 : A12 CurrentGateway IPv4 address Returns the current IPv4 address of the default gateway.
  • Page 63 Parameter Value Description CurrentPrimaryDns IPv4 or IPv6 address Returns the current IP address of the primary DNS server. CurrentSecondaryDns IPv4 or IPv6 address Returns the current IP address of the secondary DNS server. CurrentSubnetmask IPv4 address Returns the current IPv4 subnet mask. Dhcp on, off On/Off setting of DHCP client function.
  • Page 64 Parameter Value Description PrimaryDns IPv4 or IPv6 address Setting of the static IP address of Primary DNS server. SecondaryDns IPv4 or IPv6 address Setting of the static IP address of Secondary DNS server. Subnetmask IPv4 address Setting of the IPv4 subnet mask. Hostname Device specific Returns the camera Hostname.
  • Page 65 filtering.cgi Setting (Set): command/filtering.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=filtering <n> of the parameter tail is the number between 1 to3. Corresponds to the IPv4 filter 1 to 3 or IPv6 filter 1 to 3 which can be registered to the camera. Note If you set V4FilterDefaultRule or V6FilterDefaultRule to reject with setting IP address to grant access unregistered, even the Admin cannot access with CGI command.
  • Page 66 Parameter Value Description V4FilterRule [Value1] Setting of IPv4 Filter function rules. 0 to 9 Up to 10 rules can be set. [Value2] V4FilterRule=Value11,Value21,Value31,Value IPv4 address 41,Value51,Value61,Value12,Value22,Value3 2,Value42,Value52,Value62[,…,Value110, [Value3] Value210,Value310,Value410,Value510, 0 to 32 Value610] [Value4] [Value1] tcp, udp, icmp, all Setting of rule number Smaller value means higher priorities [Value5] 0 to 65535...
  • Page 67 Parameter Value Description V6DosDefenseLimit<n> Setting of the number of times to defend 1 to 100 against requests with IPv6 DoS Attack Protection function. V6DosDefensePort<n> Setting of the port number to defend 0 to 65535 against requests with IPv6 DoS Attack Protection function.
  • Page 68 Parameter Value Description V6SynFloodExpire Setting of the predetermined time to 10 to 86400 discard the results judged as an attack with IPv6 SYN Flood Attack Protection function. (unit: second) V6SynFloodLimit Setting of the possible access times per 1 to 1000 minute after limiting with IPv6 SYN Flood Attack Protection function.
  • Page 69 ssl.cgi Setting (Set): command/ssl.cgi?<Parameter>=<Value> Inquiry (Inq): command/inquiry.cgi?inq=ssl Parameter Value Description HttpsPort 443, 1024 to 65534 Setting of the port number used in HTTPS protocol. SSLCertAvailability 1, 0 Returns the SSL certificates status. 1 : Certificates are enabled 0 : Certificates are disabled SSLCertExtendedKeyUsage 0 to 128 characters Returns the extended key usage of the SSL...
  • Page 70 Inquiry (Inq): command/inquiry.cgi?inq=ndi Parameter Value Description NdiCameraName 0 to 8 characters Returns the camera name. [Default] SRG-A40 : A40 SRG-A12 : A12 NdiRegistKey 0 to 32 characters Used for NDI connection. Do not use directly. NdiLicenseKeyValid invalid, valid Confirms the presence/absence of the NDI license.
  • Page 71 Parameter Value Description NdiTransferModeMulticastUdp on, off Sets enable/disable for the NDI Multicast streaming. on : Enable off : Disable NdiTransferMulticastPrefix 239.255.0.0 Sets the Prefix of Multicast Address during IPv4 Address NDI Multicast streaming. NdiTransferMulticastNetmask 255.255.0.0 Sets the Netmask which decides the range IPv4 Address of Multicast Address during NDI Multicast streaming.
  • Page 72 Parameter Value Description SrtListenPort 4201 Sets the standby port number when 1024 to 65534 working with the SRT-Listener. SrtEncryption none, aes-128, aes-256 Sets encryption settings. SrtPassphrase Sets the passphrase for encryption. 10 to 79 characters SrtPassphraseUsed 0, 1 0 : Not set 1 : Already set srtexe.cgi Setting (Set): command/srtexe.cgi?<Parameter>=<Value>...
  • Page 73: Supported Codecs

    Supported Codecs The following codecs are supported with the RTSP streaming function of the cameras. Video Audio H.264 AAC LC H.265 RTSP Request URL RTSP request URLs of the cameras to achieve live streams are as follows. Request URL Description rtsp://<camera_address>/video1 Requests video* bitstreams from codecs corresponding to the CGI parameter “ImageCodec1”** and its related parameters.
  • Page 74: Rtsp Methods

    RTSP Methods Supported Methods The cameras support the following RTSP methods. Supported Method OPTIONS DESCRIBE SETUP PLAY TEARDOWN GET_PARAMETER SET_PARAMETER PAUSE For details about the RTSP methods listed above, refer to IETF RFC 2326.
  • Page 75: Typical Sequence Of Rtsp Communication

    Typical Sequence of RTSP Communication Overview of a typical RTSP communication sequence between the camera (RTSP server) and a client is as shown below. Camera Client OPTIONS RTSP/1.0 200 OK DESCRIBE RTSP/1.0 200 OK SETUP RTSP/1.0 200 OK PLAY RTSP/1.0 200 OK <Media Stream(s)>...
  • Page 76: Stream Acquisition

    Stream Acquisition <Transfer Protocols> The RTSP function of the cameras supports the following transfer protocols to stream video and/or audio from the camera to client(s). a) TCP bitstream b) UDP unicast bitstream Details of each case above are described in the following sections.
  • Page 77: Video Stream Acquisition

    Video Stream Acquisition TCP Bitstream (Video) The following diagram and captured packets show an example of a client acquiring a video bitstream via TCP in a situation where AudioIn is off. Camera Client OPTIONS rtsp://<camera_address>/video1 RTSP/1.0 RTSP/1.0 200 OK DESCRIBE rtsp://<camera_address>/video1 RTSP/1.0 RTSP/1.0 200 OK a=control:trackID=1 SETUP rtsp://<camera_address>/video1/trackID=1 RTSP/1.0...
  • Page 80 UDP Unicast Bitstream (Video) The following diagram (page 81) and captured packets (page 82 to 83) show an example of a client acquiring a video bitstream via UDP unicast in a situation where AudioIn is off. As for the UDP port numbers to be used for sending RTP/RTCP packets, “Client_port” parameter value which is added to RTSP SETUP request will be used for the client port.
  • Page 81 UDP Unicast Bitstream (Video) Diagram Camera Client OPTIONS rtsp://<camera_address>/video1 RTSP/1.0 RTSP/1.0 200 OK DESCRIBE rtsp://<camera_address>/video1 RTSP/1.0 RTSP/1.0 200 OK a=control:trackID=1 SETUP rtsp://<camera_address>/video1/trackID=1 RTSP/1.0 Transport: RTP/AVP;unicast; client_port=<CliUdpPort>-<CliUdpPort+1> RTSP/1.0 200 OK Session: <SessionId>;timeout=<SessionTimeout> Transport: RTP/AVP;unicast; client_port=<CliUdpPort>-<CliUdpPort+1>; server_port=<SrvUdpPort>-<SrvUdpPort+1> PLAY rtsp://<camera_address>/video1 RTSP/1.0 Session: <SessionId> RTSP/1.0 200 OK from <VideoStream in RTP payload over UDP>...
  • Page 82 UDP Unicast Bitstream (Video) Packet Capture...
  • Page 84 Acquiring Both Video and Audio Bitstreams In case AudioIn is on and a client requests a video stream, the camera simultaneously transmits the video stream and an audio stream in an RTSP session. The following captured packets show an example of simultaneous video bitstream and audio bitstream acquisition from the camera.
  • Page 85 rtpmap Attribute rtpmap attribute values in RTSP response to “DESCRIBE” request vary depending on the codec of media streams. Here are some examples. Codec rtpmap Attribute Value H.264 a=rtpmap:105 H264/90000\r\n H.265 a=rtpmap:96 H265/90000\r\n AAC (128 kbps) a=rtpmap:102 mpeg4-generic/48000/2\r\n AAC (256 kbps) a=rtpmap:103 mpeg4-generic/48000/2\r\n...
  • Page 86: Rtp/Rtcp

    RTP/RTCP RTP Header Fields The RTP header has the following format. Field Bit Length Description Version This field identifies the version of RTP. The version defined by this specification is two (2). Padding If the padding bit is set, the packet contains one or more additional padding octets at the end which are not part of the payload.
  • Page 87: Sr: Sender Report Rtcp Packet

    SR: Sender Report RTCP Packet The RTCP Sender report’s header has the following format. Field Bit Length Description Version Identifies the version of RTP, which is the same in RTCP packets as in RTP data packets. The version defined by this specification is two (2).
  • Page 88: Userdata Information In Video Bitstream

    Userdata Information in Video Bitstream Userdata field (supplemental information) is added to the video bitstream delivered by RTSP streaming function. This chapter describes the data structure of Userdata field this camera supports. Userdata Information Under H.264 Video Codec The data structure of Userdata field where the video codec is set to H.264 is described. The format of the data is like below, when H.264 Userdata is sent from the cameras as RTP Packet.
  • Page 89: Userdata Information Under H.265 Video Codec

    Userdata Information Under H.265 Video Codec The data structure of Userdata field where the video codec is set to H.265 is described. The format of the data is like below, when H.265 Userdata is sent from the cameras as RTP Packet. In the format above, the data details except RTP Header is described in the table below.
  • Page 90: Visca/Cgi Command Setting Values

    VISCA/CGI Command Setting Values SHUTTER/MIN SHUTTER/SHUTTER Video output format VISCA 2160/29.97p 2160/25p Parameter* Value 1080/59.94p 1080/50p 2160/23.98p 1080/59.94i 1080/50i 1080/23.98p SHUTTER SHUTTER 720/59.94p 720/50p MIN SHUTTER 1/10000 1/10000 1/10000 1/6000 1/6000 1/4800 1/4000 1/3500 1/2400 1/3000 1/2500 1/1200 1/2000 1/1750 1/576 1/1500 1/1250...
  • Page 91 MAX SHUTTER Video output format VISCA 2160/29.97p 2160/25p Parameter* 1080/59.94p 1080/50p 2160/23.98p 1080/59.94i 1080/50i 1080/23.98p SHUTTER 720/59.94p 720/50p MIN SHUTTER 1/10000 1/10000 1/10000 1/6000 1/6000 1/4800 1/4000 1/3500 1/2400 1/3000 1/2500 1/1200 1/2000 1/1750 1/576 1/1500 1/1250 1/400 1/1000 1/1000 1/288 1/725 1/600...
  • Page 92 IRIS/IRIS GAIN/GAIN VISCA VISCA Parameter* Value Parameter Value F value Gain value IRIS IRIS GAIN GAIN F2.0(OPEN) 48 dB F2.2 45 dB F2.4 42 dB F2.6 39 dB F2.8 36 dB F3.1 33 dB F3.4 30 dB 27 dB F3.7 F4.0 24 dB F4.4...
  • Page 93 EXPOSURE COMPENSATION VISCA Parameter* Value Gain value Exposure Exposure Compensation Compensation + 10.5 dB + 9.0 dB + 7.5 dB + 6.0 dB + 4.5 dB + 3.0 dB + 1.5 dB 0.0 dB - 1.5 dB - 3.0 dB - 4.5 dB - 6.0 dB - 7.5 dB...
  • Page 94 PAN/TILT POSITION VISCA Position Parameter* Value* DE00 de00 - 170 degrees 0000 0000 0 degrees 2200 2200 + 170 degrees Tilt FC00 fc00 - 20 degrees (Image Flip: OFF) 0000 0000 0 degrees (Eflip: Off) 1200 1200 + 90 degrees Tilt EE00 ee00...
  • Page 95 PAN/TILT SPEED VISCA Rotation speed (for reference) Parameter* Value Pan/Tilt Speed Pan/Tilt Speed Pan (deg/sec) Tilt (deg/sec) (PAN/TILT SLOW=OFF) (SlowPanTiltMode : off) * VISCA parameter uses hexadecimal digits.
  • Page 96 VISCA Rotation speed (for reference) *1*2 Parameter Value Pan/Tilt Speed Pan/Tilt Speed Pan (deg/sec) Tilt (deg/sec) (PAN/TILT SLOW=ON) (SlowPanTiltMode : on) 26.4 13.2 10.8 *1 VISCA parameter uses hexadecimal digits. *2 Up to 7F can be specified by VISCA, however 19 to 7F are for the maintenance. *3 Up to 128 can be specified by CGI, however 25 to 128 are for the maintenance.
  • Page 97 PRESET RUN SPEED VISCA Rotation speed (for reference) Parameter* Value Preset run speed Preset run speed Pan (deg/sec) Tilt (deg/sec) * VISCA parameter uses hexadecimal digits.
  • Page 98 FOCUS DISTANCE ZOOM MAGNIFICATION (SRG-A40) VISCA Focus distance VISCA Focus distance Parameter* Value* (for reference) Parameter* Value* (for reference) F000 F000 0.08 m 0000 0000 ×1 E000 E000 0.1 m 0DC1 0DC1 ×2 D000 D000 0.17 m 186C 186C ×3...
  • Page 99 ZOOM MAGNIFICATION (SRG-A12) LENS CONTROL Zoom Position* 0000 - 4000 - 7AC0 VISCA Focus distance Parameter* Value* (for reference) Wide end Optical Digital 0000 0000 ×1 Tele end Tele end Focus Position 1000 - F000 0FB4 0FB4 ×2 Far end Near end 1BF0 1BF0 ×3...
  • Page 100 PAN-TILT STATUS CODE Status – – – – – – – – – – – – – – – Panning reaches the end of the left. – – – – – – – – – – – – – – –...
  • Page 101 TIME ZONE Time Zone utc-0930 UTC -09:30 Time Zone utc-1000 UTC -10:00 Honolulu utc+1400 UTC +14:00 utc-1030 UTC -10:30 utc+1330 UTC +13:30 utc-1100 UTC -11:00 M-Island utc+1300 UTC +13:00 Nukualofa utc-1130 UTC -11:30 utc+1230 UTC +12:30 utc-1200 UTC -12:00 utc+1200 UTC +12:00 Wellington utc+1130 UTC +11:30...

This manual is also suitable for:

Srg-a12

Table of Contents