5-053-155-11 (1) Color Video Camera VISCA Command List CGI Command List Software Version 1.
Use of control software based upon this command list may cause malfunction or damage to hardware and software. We are not liable for any such damage. Table of Contents Overview ................................................... 3 About This Document ............................. 3 VISCA ........................................................ 3 Overview of VISCA ................................... 3 VISCA Communication Specifications ..... 4 VISCA Device Setting Command .............
Note Overview Each VISCA equipment has VISCA IN and VISCA OUT connectors. Set the DTR input (the S output of the controller) of VISCA IN to H when controlling VISCA equipment from the controller. About This Document This document describes the specifications of the VISCA command, CGI command, and RTSP streaming of Sony color video camera SRG-A40, SRG-A12. In this document, the product is referred to as “the cameras.” Fig.
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. Packet sent to the camera (address 2) is 82H. In the command list, as the header is 8X, input the address of the camera to X.
Timing Chart Responses for commands and inquiries As VISCA command processing can only be carried out a maximum of one time in a Vertical (V) cycle, it takes maximum 4V-cycle time for an ACK/Completion to be returned. If the Command and ACK/Completion communication time is shorter than 1V-cycle time, a command can be received at every 1V cycle.
VISCA interface command The ACK message is not returned for these commands and inquiries, and only the completion message of socket number 0 is returned. • IF_Clear Clears the command buffer in the camera. When cleared, the operation currently being executed is not guaranteed. Command execution cancel To cancel a command which has already been sent, send a Cancel command as the next command. To cancel one of two commands which have been sent, use the cancel message.
VISCA Command/ACK Protocol Command Command Message Reply Message Comments General Command 81 01 04 38 02 FF (Example) 90 4z FF (ACK) , 90 5z FF (Completion) (z: Socket No.) Returns ACK when a command has been accepted, then returns Completion when a command has been executed. 81 01 04 38 FF (Example) 90 60 02 FF (Syntax Error) Accepted a command which is not supported or a command lacking parameters.
VISCA Camera-Issued Messages ACK/Completion Messages Command Command Message Comments ACK y0 4z FF (z: Socket No.) Returned when the command is accepted. Completion y0 5z FF (z: Socket No.) Returned when the command has been executed. y = Device address + 8 (Locked to “y = 9” for VISCA over IP.) Error Messages Command Command Message Comments Syntax Error y0 60 02 FF Returned when the command format is different or when a command with illegal command parameters is received.
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.
• IF_Clear Sends the reply message to the controller after clearing, without using VISCA socket. • CAM_VersionInq Sends the reply message to the controller, without using VISCA socket. Due to the nature of the IP communication, the use of some VISCA functions are limited. For details, see “Limitation” on page 13. For how to set an IP address of the camera, see “Camera IP Setting Command” on page 29.
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 Stores the reply for the VISCA command and VISCA inquiry, or VISCA device setting command. 0x01 VISCA device setting command 0x20 Stores the VISCA device setting command.
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. You can confirm delivery of messages by managing the time-out waiting for a reply message sent.
of limitations of order to receive commands or execution interval of command. It may cause efficiency to be reduced substantially. Timing chart Controller without hindrance since the peripheral device recognizes that its address is set to 1. Peripheral device Locking the controller’s address of the VISCA message to 0 For the same reason as the peripheral device’s address, the controller’s address of VISCA command is locked to 0.
VISCA Command List Command List Number in ( ) is MENU display values. Command Set EXPOSURE Command Command Packet Comments 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.
Number in ( ) is MENU display values Command Set Command Command Packet Comments On/Off 8x 01 04 3D 0p FF p: 6=On, 3=Off - 8x 01 04 2D 00 0p 0q 0r 00 00 00 00 FF p: Effect Level 0 (Dark) - 6 (Bright) q: Brightness compensation selection (0=Very dark, 1=Dark, 2=Standard, 3=Bright) r: Compensation Level (0=Low, 1=Mid, 2=High) On/Off 8x 01 05 39 0p FF p: 2=On, 3=Off Level 8x 01 05 49 0p FF p: 4 - A WHITE BALANCE MODE 8x 01 04 35 0p FF p: 0=Auto1, 1=Indoor, 2=Outdoor, 3=One Push WB, 4=Auto2, 5
Number in ( ) is MENU display values.
Number in ( ) is MENU display values.
Number in ( ) is MENU display values.
Number in ( ) is MENU display values.
Inquiry Command List Number in ( ) is MENU display values.
Number in ( ) is MENU display values.
Number in ( ) is MENU display values.
Number in ( ) is MENU display values. Inquiry Command Reply Packet Comments VIDEO FORMAT SELECTABLE 8x 09 7E 04 31 FF y0 50 0p FF Whether the setting can be changed by the command of the Video output method (video format) or not.
Block Inquiry Command Lens control system inquiry commands…..
Camera control system inquiry commands…..
Other block inquiry commands…..
Other enlargement inquiry commands (1/2) ..........
Other enlargement inquiry commands (2/2) ..........
Camera IP Setting Command Name Description 1 Setting Protocol: Inquiry The controller inquires the network setting for the camera. 2 Setting Protocol: Inquiry reply The camera replies according to the inquiry from the controller. 3 Setting Protocol: Network setting The controller sets the network setting of the camera. 4 Setting Protocol: Network setting reply The camera replies according to the network setting of the controller.
Notes CGI • The camera name (NAME) is to be up to 8 characters of alphanumeric characters and spaces. • The camera’s IP address of the network setting and camera name cannot be changed when WRITE of Inquiry reply is set to off. • WRITE turns to off automatically when 20 minutes have passed after turning on the camera and does not accept the network setting. • Turning WRITE to off using the CGI command is also possible.
Changing the Setting of Referer Check Setting/Inquiring by CGI Commands As default, HTTP CGI command delivery checks the requests by checking Referer field in HTTP 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.
Syntax1 (standard format) http:///command/inquiry.cgi?inq= [&inq=...] When 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: \r\n \r\n =[&=&=...] Syntax2 (JS parameter format) http:///command/ inquiry.cgi?inqjs=[&inqjs=...
CGI Command List audio.cgi Setting (Set): command/audio.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=audio Parameter MicLineSelect Set Inq Set Inq Value mic, line Description Sets the level of the audio input signal. mic : MIC input line : LINE input AudioInVolume Set Inq 0 -10 to 10 Sets the audio volume of the audio input when MicLineSelect is set to mic.
Parameter ImageSize1 ImageSize2 ImageSize3 Set Inq Set Inq Set Inq Set Inq Value Description 3840,2160, 1920,1080, 1280,720, 640,360 Sets the image size of the video stream corresponding to Image 1. 3840,2160, 1920,1080, 1280,720, 640,360 Sets the image size of the video stream corresponding to Image 2. 1280,720, 640,360 Sets the image size of the video stream corresponding to Image 3. * The available setting values are limited by the video output format.
Parameter H265Profile1 Set Inq Set Inq Value main Description Sets the H.265 profile of Image 1. main H265Profile2 Set Inq main CBR1 Set Inq on, off : Fixing to main profile. Sets the H.265 profile of Image 2. main : Fixing to main profile. Sets the bit rate restriction mode of Image 1. on : Performs the bit rate restriction by CBR off : Performs the bit rate restriction by VBR * When StreamMode is set to srt-caller or srt-listener, the value returns to the initial one.
Parameter H265Quality2 Set Inq Value Description Set Inq 6 1 to 10 Sets the H.265 VBR (variable bit rate) picture 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. JpegQuality3 Set Inq 6 1 to 10 Sets the Motion Jpeg’s picture quality of Image 3. * The higher the value, the quality is improved. However, the amount of the generated data increases.
datetime.cgi Setting (Set): command/datetime.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=datetime Parameter GmTime Set Inq Set Inq Value YYMMDDhhmmssW Description 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) W : Week (Sunday=0, Monday=1, ......, Saturday=6) When you enter the wrong value on W, the value is corrected automatically.
project.cgi Setting (Set): command/project.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=project Parameter VideoFormatSelectable Set Inq Value Inq 0, 1 Description Returns whether the video output format can be changed by SelectVideoFormat or not. 0 : Cannot be changed. 1 : Can be changed. SelectVideoFormat Set Inq * Refer to the item “VIDEO Sets the video output format. OUTPUT FORMAT” of CGI Command Setting Values.
ptzautoframing.cgi Setting (Set): analytics/ptzautoframing.cgi?= Inquiry (Inq): analytics/inquiry.cgi?inq=ptzautoframing Parameter PtzAutoFraming Set Inq Set Inq Value on, off Description Starts or finishes tracking of PTZ Auto Framing. on : Starts tracking of PTZ Auto Framing. off : Finishes tracking of PTZ Auto Framing. PtzAutoFramingAutoStartEnable Set Inq on, off Starts PTZ Auto Framing automatically when the camera’s Power turns on.
Parameter PtzAutoFramingAdjustObjectSize Set Inq Set Inq Value size1, size2, size3, size4 Description 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.
Parameter PtzAutoFramingTrackingStatus Set Inq Inq Value idle, missing, preparing, searching, tracking, waiting Description Gets the operating status of PTZ Auto Framing. idle missing preparing searching tracking waiting PtzAutoFramingMinDetectionArea Inq : Under suspension : While tracking lost : While preparing the tracking : While searching : While tracking : Waiting for the tracking object to be selected [Value1] 2000 Returns the detection area’s minimum size of PTZ Auto Framing.
Parameter Set Inq Value Description Sets whether the RTSP authentication is set to on or off. AuthenRTSP Set Inq on, off RTSPUcVideoPort1 Set Inq 51000 1024 to 65534 Sets the port to use for RTSP/RTP(UDP) unicast streaming of image 1. *1 *2 RTSPUcVideoPort2 Set Inq 53000 1024 to 65534 Sets the port to use for RTSP/RTP(UDP) unicast streaming of image 2. *1 *2 RTSPUcAudioPort Set Inq 57000 1024 to 65534 Sets the port to use for RTSP/RTP(UDP) unicast streaming of Audio.
unsubscribe.cgi Setting (Set): command/unsubscribe.cgi?= Parameter SubscriptionId Set Inq Value Set - Description Displays for Web App. Do not set this. imaging.cgi Setting (Set): command/imaging.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=imaging Parameter AESpeed Set Inq Set Inq Value Description 1 to 48 Sets the response speed of exposure. Camera operates according to this setting when ExposureMode is set to auto, shutter, or iris. 1 : About 1 sec.
Set Inq Value Description DetailCrispening Set Inq 3 0 to 7 Sets the Crispening function of contour emphasis. Setting is applied when DetailMode is set to manual. DetailHighlightDetail Set Inq 0 to 4 Sets the level of contour added to brightlylit objects. Larger the number, larger the emphasis volume of the contour. Setting is applied when DetailMode is set to manual. DetailHVBalance Set Inq 7 5 to 9 Sets the ratio for horizontal and vertical contour correction signal elements.
Parameter ExposureExposureTime Set Inq Set Inq Value The available values depend on the video output format. Description Sets the shutter speed when ExposureMode is set to shutter or manual. * Refer to the item “SHUTTER” of CGI 18 Command Setting Values. 6 to 33 (59.94p, 59.94i, 50p, 50i, 23.98p) 16 6 to 33 (29.97p, 29.97i, 25p, 25i) ExposureGain Set Inq The available values Sets the gain value when ExposureMode is depend on the setting of set to manual. the high sensitivity mode.
Parameter ExposureMode Set Inq Set Inq Value Description 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. manual: Sets iris, gain, and shutter speed independently. FlickerReduction Set Inq on, off Sets the Flicker cancel function to on or off.
Parameter VisibilityEnhancerLevel Set Inq Set Inq Value [Value1] 3 0 to 6 [Value2] 2 0 to 3 Description Sets the parameter for Visibility Enhancer function. VisibilityEnhancerLevel=Value1,Value2, Value3 [Value1] Brightness level [Value3] 1 0 to 2 [Value2] Brightness correction [Value3] Strength correction WhiteBalanceCbGain Set Inq 128 0 to 255 Sets the B gain when WhiteBalanceMode is set to manual. WhiteBalanceCrGain Set Inq 128 0 to 255 Sets the R gain when WhiteBalanceMode is set to manual.
ptzf.cgi Setting (Set): command/ptzf.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=ptzf Parameter AbsolutePanTilt Set Inq Set Value [Value1] de00 to 2200 [Value2] The available values depend on the Eflip settings. fc00 to 1200 (Off) ee00 to 0400 (On) [Value3] 1 to 24 Description Executes the pan/tilt movement by specifying coordinate. AbsolutePanTilt=Value1,Value2,Value3 [Value1] Sets the pan position by coordinate de00 0000 2200 : Counterclockwise 170 deg.
Parameter AbsolutePTZF Set Inq Set Inq Value [Value1] de00 to 2200 [Value2] The available values depend on the Eflip settings. fc00 to 1200 (Off) ee00 to 0400 (On) [Value3] The available values depend on the Zoom Mode status and the video size of the output signal format.
Parameter AbsoluteZoom Set Inq Set Value The available values depend on the Zoom Mode status and the video size of the output signal format. 0000 to 4000 (optical) 0000 to 5556 (clearimage, 4K) 0000 to 6000 (clearimage, except 4K) 0000 to 7ac0 (full) Description Moves the zoom by specifying the absolute position.
Parameter Move Set Inq Set Value Description [Value1] Moves Pan-Tilt by specifying direction. left, right, up, down, upleft, up-right, down-left, Move=Value1,Value2 down-right [Value1] [Value2] Sets the direction 0 to 24 left : Left right : Right up : Up down : Down up-left : Up left up-right : Up right down-left : Down left down-right: Down right [Value2] Sets the speed for Pan-Tilt * Larger the number, faster. When set to 0, the speed changes depending on the zoom position.
Parameter PanLimitMode Set Inq Set Inq Value Description 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 Inq [Value1] de00 [Value2] 2200 Returns the possible movement range of pan. PanMovementRange=Value1,Value2 [Value1] de00 : (Left end) [Value2] 2200 : (Right end) * Refer to the item “PAN/TILT POSITION” of CGI Command Setting Values.
Parameter RelativeFocus Set Inq Set Value Description ffff1000 to 0000f000 Moves the focus position by specifying relative position from the current position. 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 0000f000 : The maximum amount to focus near direction * Refer to the item “FOCUS” of CGI Command Setting Values.
Parameter TiltMovementRange Set Inq Inq Value [Value1] Depends on the Eflip settings. fc00 (Off) ee00 (On) [Value2] Depends on the Eflip settings. 1200 (Off) 0400 (On) ZoomMaxVelocity Inq ZoomMovementRange Inq 8 Description Returns the coordinate of the possible movement range of tilt. TiltMovementRange=Value1,Value2 [Value1] Lower end [Value2] Upper end * Refer to the item “PAN/TILT POSITION” of CGI Command Setting Values. Returns the maximum speed of zoom movement.
Parameter ZoomMove Set Inq Set Value Description [Value1] tele, wide, stop The command for operating with the Zoom slider of the Web UI. [Value2] 0 to 32766 [Value1] Direction [Value2] Speed The speed range is 0 to 32766. However, the operation is divided into 8 steps.
Parameter HomePos Set Inq Value Set recall Description 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 Set [Value1] 1 to 256 Recalls a registered preset. PresetCall=Value1 [Value1] The preset number to recall * Refer to the item “PRESET RUN SPEED” of CGI Command Setting Values. * Larger the number, faster.
Parameter SeparateSpeed Set Inq Value Set Inq [Value1] 1 to 256 [Value2] 1 to 25 Description Sets the pan/tilt speed corresponding to each preset when SpeedSelect is set to separate. [Value1] Preset number to be set [Value2] Speed to be set * Refer to the item “PRESET RUN SPEED” of CGI Command Setting Values. SpeedSelect Set Inq separate, common Sets the pan/tilt speed during recalling the preset.
Parameter RTallyStatus Set Inq Value Inq 0, 1 Description Outputs Tally Control status. 0 1 TallyIndicationPtzAutoFraming Set Inq on, off : Turns off the light. : Turns on the light. Sets the Green Tally movement while tracking PTZ Auto Framing. on : Controls the Tally lamp depending on the Analytics status. off : Does not control the Tally lamp depending on the Analytics status. ircf.cgi Setting (Set): command/ircf.cgi?= Inquiry (Inq): command/inquiry.
sysinfo.cgi Setting (Set): command/sysinfo.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=sysinfo Set Inq Value Description AudioInFunc Inq 1 Returns whether the audio input function is supported or not. ContinuousPanTiltZoomFunc Inq 0 Returns whether ContinuousPanTiltZoom CGI command is supported or not. Parameter 1 : Supported 0 : Not supported ContinuousPanTiltZoomInterval Inq "" No value for this model, as it does not support ContinuousPanTiltZoom function.
Parameter Power Set Inq Value Inq on, standby Description Returns the status of the camera power. on : Starting status standby : Standby status PtzTraceFunc Inq 0 Returns whether the PTZ trace function is supported or not. QfhdFunc Inq 1 Returns whether to support 4K in video output format setting. 0: Not supported 1 : Supported S700pFunc Inq 0 Returns whether the S700PTP protocol is supported or not.
main.cgi Setting (Set): command/main.cgi?= Parameter FactoryDefault Set Inq Value Set hard, soft Description 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 Set on, reboot, standby Sets the camera power status. on : Sets to the starting status. reboot : Reboots the camera. standby: Sets to the standby status.
Set Inq Value DigestAuthNonceDuration Set Inq 300 1 to 3600 User Set - Use from Admin menu. Do not use directly. UserInfo Inq - Returns user name. UserNum Inq 9 Returns the maximum number of registrable users. Parameter Description Setting of the effective duration of the Nonce value in Digest Access Authentication. (Unit: second) viewermode.cgi Inquiry (Inq): command/inquiry.
Set Inq Value CurrentPrimaryDns Inq IPv4 or IPv6 address Returns the current IP address of the primary DNS server. CurrentSecondaryDns Inq IPv4 or IPv6 address Returns the current IP address of the secondary DNS server. CurrentSubnetmask Inq IPv4 address Returns the current IPv4 subnet mask. Dhcp Set Inq on, off On/Off setting of DHCP client function. DnsAuto Set Inq on, off Setting to enable/disable the function that the IP address of DNS server is acquired from the DHCP server.
Parameter Set Inq Value Description PrimaryDns Set Inq IPv4 or IPv6 address Setting of the static IP address of Primary DNS server. SecondaryDns Set Inq IPv4 or IPv6 address Setting of the static IP address of Secondary DNS server. Subnetmask Set Inq IPv4 address Hostname Inq Device specific Setting of the IPv4 subnet mask. Returns the camera Hostname. auth.cgi Setting (Set): command/auth.cgi?= Inquiry (Inq): command/inquiry.
filtering.cgi Setting (Set): command/filtering.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=filtering 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.
Parameter V4FilterRule Set Inq Value Set Inq [Value1] 0 to 9 [Value2] IPv4 address [Value3] 0 to 32 [Value4] tcp, udp, icmp, all [Value5] 0 to 65535 [Value6] allow, reject Description Setting of IPv4 Filter function rules. Up to 10 rules can be set.
Set Inq Value V6DosDefenseLimit Set Inq 5 1 to 100 V6DosDefensePort Set Inq 80 0 to 65535 V6FilterDefaultRule Set Inq allow, reject Parameter Description Setting of the number of times to defend against requests with IPv6 DoS Attack Protection function. Setting of the port number to defend against requests with IPv6 DoS Attack Protection function. Setting of the basic policy for IPv6 IP Filter.
Set Inq Value Description V6SynFloodExpire Set Inq 60 10 to 86400 Setting of the predetermined time to discard the results judged as an attack with IPv6 SYN Flood Attack Protection function. (unit: second) V6SynFloodLimit Set Inq 5 1 to 1000 Setting of the possible access times per minute after limiting with IPv6 SYN Flood Attack Protection function. V6SynFloodProtection Set Inq on, off On/Off setting of IPv6 SYN Flood Attack Protection function. Parameter iplimit.
ssl.cgi Setting (Set): command/ssl.cgi?= Inquiry (Inq): command/inquiry.cgi?inq=ssl Parameter Set Inq Value Description HttpsPort Set Inq 443, 1024 to 65534 Setting of the port number used in HTTPS protocol. SSLCertAvailability Inq 1, 0 SSLCertExtendedKeyUsage Inq 0 to 128 characters SSLCertInstalled Inq 1, 0 Returns the SSL server certificates status.
ssl-cert.cgi Setting (Set): command/ssl-cert.cgi?= Set Inq Value DeleteCert Set sslcert Deletes certificates stored in the cameras. sslcert : Deletes CA certificates for SSL GenerateCert Set selfsignedcert Generates a self-signed certificate for SSL. Parameter Description license.cgi Inquiry (Inq): command/inquiry.cgi?inq=license Parameter QfhdLicenseSupport Set Inq Value Inq 0 Description Returns whether it corresponds with the license function or not.
Parameter NdiTransferModeMulticastUdp Set Inq Set Inq Value on, off Description Sets enable/disable for the NDI Multicast streaming. on : Enable off : Disable NdiTransferMulticastPrefix Set Inq 239.255.0.0 IPv4 Address Sets the Prefix of Multicast Address during NDI Multicast streaming. NdiTransferMulticastNetmask Set Inq 255.255.0.0 IPv4 Address Sets the Netmask which decides the range of Multicast Address during NDI Multicast streaming.
Set Inq Value SrtListenPort Set Inq 4201 1024 to 65534 SrtEncryption Set Inq none, aes-128, aes-256 SrtPassphrase Set 0 10 to 79 characters SrtPassphraseUsed Inq 0, 1 Parameter Description Sets the standby port number when working with the SRT-Listener. Sets encryption settings. Sets the passphrase for encryption. 0 : Not set 1 : Already set srtexe.cgi Setting (Set): command/srtexe.
Supported Codecs The following codecs are supported with the RTSP streaming function of the cameras. Video Audio H.264 H.265 AAC LC RTSP Request URL RTSP request URLs of the cameras to achieve live streams are as follows. Request URL Description rtsp:///video1 Requests video* bitstreams from codecs corresponding to the CGI parameter “ImageCodec1”** and its related parameters. * Audio bitstream can be transmitted together with this video stream depending on the situation.
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.
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 GET_PARAMETER . . . RTSP/1.0 200 OK . . . PAUSE RTSP/1.0 200 OK PLAY RTSP/1.0 200 OK . . . TEARDOWN RTSP/1.
Stream Acquisition 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. The cameras support multiple codec simultaneously as mentioned in the previous “RTSP Request URL” (page 73). The number of media streams in an RTSP session of the camera is up to 5.
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:///video1 RTSP/1.0 RTSP/1.0 200 OK DESCRIBE rtsp:///video1 RTSP/1.0 RTSP/1.0 200 OK a=control:trackID=1 SETUP rtsp:///video1/trackID=1 RTSP/1.0 Transport: RTP/AVP/TCP;unicast;interleaved=0-1 RTSP/1.
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. As for the server port (port number at the cameras side), CGI parameters shown in the table below will be applied.
UDP Unicast Bitstream (Video) Diagram Camera Client OPTIONS rtsp:///video1 RTSP/1.0 RTSP/1.0 200 OK DESCRIBE rtsp:///video1 RTSP/1.0 RTSP/1.0 200 OK a=control:trackID=1 SETUP rtsp:///video1/trackID=1 RTSP/1.0 Transport: RTP/AVP;unicast; client_port=- RTSP/1.
UDP Unicast Bitstream (Video) Packet Capture 82
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. As you can see in the example, session descriptions in RTSP response to “DESCRIBE” request contains two media descriptions — the first one is for video, the second one is for audio.
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 85
RTP/RTCP RTP Header Fields The RTP header has the following format. Field Bit Length Description Version 2 This field identifies the version of RTP. The version defined by this specification is two (2). Padding 1 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. The last octet of the padding contains a count of how many padding octets should be ignored.
SR: Sender Report RTCP Packet The RTCP Sender report’s header has the following format. Field Bit Length Description Version 2 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). Padding 1 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. The last octet of the padding contains a count of how many padding octets should be ignored.
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.
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. Offset Description NAL Unit Header 2 0 This field is 0x4e01. Payload Type 1 2 This field is 0x05. Size 1 3 This field shows the total byte length of UUID and “user data.
VISCA/CGI Command Setting Values SHUTTER/MIN SHUTTER/SHUTTER Video output format VISCA Parameter* CGI Value SHUTTER MIN SHUTTER SHUTTER 2160/29.97p 1080/59.94p 1080/59.94i 720/59.94p 2160/25p 1080/50p 1080/50i 720/50p 2160/23.98p 1080/23.
MAX SHUTTER Video output format VISCA Parameter* SHUTTER MIN SHUTTER 2160/29.97p 1080/59.94p 1080/59.94i 720/59.94p 2160/25p 1080/50p 1080/50i 720/50p 2160/23.98p 1080/23.
IRIS/IRIS GAIN/GAIN VISCA Parameter* CGI Value IRIS IRIS 19 25 18 F value VISCA Parameter*1 CGI Value GAIN GAIN 11*2 17*2 48 dB *2 *2 45 dB *2 F2.0(OPEN) 24 10 F2.2 *2 16 Gain value 17 23 F2.4 0F 15 42 dB 16 22 F2.6 0E*2 14*2 39 dB 15 21 F2.8 0D 13 36 dB 14 20 F3.1 0C 12 33 dB 13 19 F3.4 0B 11 30 dB 12 18 F3.7 0A 10 27 dB 11 17 F4.0 09 9 24 dB 10 16 F4.4 08 8 21 dB 0F 15 F4.8 07 7 18 dB 0E 14 F5.2 06 6 15 dB 0D 13 F5.
EXPOSURE COMPENSATION VISCA Parameter* CGI Value Exposure Compensation Exposure Compensation Gain value 0E 14 + 10.5 dB 0D 13 + 9.0 dB 0C 12 + 7.5 dB 0B 11 + 6.0 dB 0A 10 + 4.5 dB 09 9 + 3.0 dB 08 8 + 1.5 dB 07 7 0.0 dB 06 6 - 1.5 dB 05 5 - 3.0 dB 04 4 - 4.5 dB 03 3 - 6.0 dB 02 2 - 7.5 dB 01 1 - 9.0 dB 00 0 - 10.5 dB * VISCA parameter uses hexadecimal digits.
PAN/TILT POSITION Pan Tilt (Image Flip: OFF) (Eflip: Off) Tilt (Image Flip: ON) (Eflip: On) VISCA Parameter* CGI Value* Position DE00 de00 - 170 degrees 0000 0000 0 degrees 2200 2200 + 170 degrees FC00 fc00 - 20 degrees 0000 0000 0 degrees 1200 1200 + 90 degrees EE00 ee00 - 90 degrees 0000 0000 0 degrees 0400 0400 + 20 degrees * Parameters and Values use hexadecimal digits. Image Flip: OFF / Eflip: Off * The values inside [ ] is described as [VISCA Parameter/CGI Value].
PAN/TILT SPEED VISCA Parameter* CGI Value Pan/Tilt Speed (PAN/TILT SLOW=OFF) Pan/Tilt Speed (SlowPanTiltMode : off) Pan (deg/sec) 18 24 101 - 17 23 91 91 16 22 84 84 15 21 80 80 14 20 72 72 13 19 69 69 12 18 64 64 11 17 62 62 Rotation speed (for reference) Tilt (deg/sec) 10 16 57 57 0F 15 54 54 0E 14 49 49 0D 13 47 47 0C 12 43 43 0B 11 41 41 0A 10 27 27 09 9 24 24 08 8 23 23 07 7 11 11 06 6 6.7 6.7 05 5 2.9 2.9 04 4 2.
VISCA Parameter*1*2 CGI Value*3 Pan/Tilt Speed (PAN/TILT SLOW=ON) Pan/Tilt Speed (SlowPanTiltMode : on) 18 24 60 - 17 23 26.4 91 16 22 13.2 84 15 21 10.8 80 14 20 9.6 72 13 19 8.9 69 12 18 8.1 64 11 17 7.3 62 Rotation speed (for reference) Pan (deg/sec) Tilt (deg/sec) 10 16 6.5 57 0F 15 5.9 54 0E 14 5.3 49 0D 13 4.7 47 0C 12 4.1 43 0B 11 3.5 41 0A 10 3.1 27 09 9 2.7 24 08 8 2.3 23 07 7 1.9 11 06 6 1.5 6.7 05 5 1.3 2.
PRESET RUN SPEED VISCA Parameter* CGI Value Preset run speed Preset run speed Pan (deg/sec) Tilt (deg/sec) 19 25 300 126 18 24 101 91 Rotation speed (for reference) 17 23 91 91 16 22 84 84 15 21 80 80 14 20 72 72 13 19 69 69 12 18 64 64 11 17 62 62 10 16 57 57 0F 15 54 54 0E 14 49 49 0D 13 47 47 0C 12 43 43 0B 11 41 41 0A 10 27 27 09 9 24 24 08 8 23 23 07 7 11 11 06 6 6.7 6.7 05 5 2.9 2.9 04 4 2.2 2.2 03 3 1.
FOCUS DISTANCE ZOOM MAGNIFICATION (SRG-A40) VISCA Parameter* CGI Value* Focus distance (for reference) VISCA Parameter* CGI Value* Focus distance (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 C000 C000 0.26 m 2015 2015 ×4 B000 B000 0.35 m 2594 2594 ×5 A000 A000 0.47 m 29B7 29B7 ×6 9000 9000 0.6 m 2CFB 2CFB ×7 8000 8000 0.8 m 2FB0 2FB0 ×8 7000 7000 1.0 m 320C 320C ×9 6000 6000 1.
ZOOM MAGNIFICATION (SRG-A12) VISCA Parameter* CGI Value* Focus distance (for reference) 0000 0000 ×1 0FB4 0FB4 ×2 1BF0 1BF0 ×3 24C5 24C5 ×4 2B1E 2B1E ×5 2FE4 2FE4 ×6 33A9 33A9 ×7 36C9 36C9 ×8 3983 3983 ×9 3BF7 3BF7 ×10 3E1C 3E1C ×11 4000 4000 ×12 LENS CONTROL Zoom Position*1 Focus Position Focus Near Limit 4000: 2 m 5000: 1.5 m 6000: 1.2 m 7000: 1.0 m 8000: 0.8 m 9000: 0.
PAN-TILT STATUS CODE – – p – – – – p – – – – p – – – – p – 1 Status Panning reaches the end of the left. – – – – – – – – – – – – – – – – – – – – – – – – – – – 1 1 – – – Panning reaches the end of the right. Tilting reaches the upper limit. – – – – – – – – – – – – – – – – – – – – – – 0 0 1 – – – – – – – Tilting reaches the lower limit. Pan functions normally.
TIME ZONE No. CGI Time Zone No.
