Nearus VISCA Protocol via Sony This Nearus Video Conference Camera may be controlled by using Sony VISCA protocol commands. Use the attached Sony VISCA protocol document as a reference for controlling Nearus cameras connected to your control system. Read and follow all instructions included in the document below. If you require additional assistance setting up these commands, please feel free to call Tech Support. Tech Support: [email protected]1 (800) 838-5052 www.snapav.com Notes: • All commands shown are HEX. • ‘8x’ is ‘81’ where 1 represents the default address of the camera. • No carriage return or line feed commands are needed; ‘FF’ completes the VISCA command. Rev: 140911-1400
25
Embed
Nearus VISCA Protocol via Sony - Snap AV · Nearus VISCA Protocol via Sony This Nearus Video Conference Camera may be controlled by using Sony VISCA protocol commands. Use the attached
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Nearus VISCA Protocol via SonyThis Nearus Video Conference Camera may be controlled by using Sony VISCA protocol commands. Use the
attached Sony VISCA protocol document as a reference for controlling Nearus cameras connected to your control system. Read and follow all instructions included in the document below.
If you require additional assistance setting up these commands, please feel free to call Tech Support.
• ‘8x’ is ‘81’ where 1 represents the default address of the camera.• No carriage return or line feed commands are needed; ‘FF’ completes the VISCA command.
BRC-300/P Commands ............................................. 9BRC-300/P Command List (1/4)................................. 9BRC-300/P Command List (2/4)............................... 10BRC-300/P Command List (3/4)............................... 11BRC-300/P Command List (4/4)............................... 12BRC-300/P Inquiry Command List (1/2) ................... 13BRC-300/P Inquiry Command List (2/2) ................... 14BRC-300/P Block Inquiry Command List ................. 15VISCA Command Setting Values ............................. 19
Revision History ...................................................... 24
3
VISCA1) RS-232C/RS-422 CommandsUse of RS-232C/RS-422 control software based uponthis command list may cause malfunction or damage tohardware and software. Sony Corporation is not liablefor any such damage.
Overview of VISCA
In VISCA, the side outputting commands, for example,a computer, is called the controller, while the sidereceiving the commands, such as a BRC-300/P, iscalled the peripheral device. The BRC-300/P serves asa peripheral device in VISCA. In VISCA, up to sevenperipheral devices like the BRC-300/P can beconnected to one controller using communicationconforming to the RS-232C/RS-422 standard. Theparameters of RS-232C/RS-422 are as follows.• Communication speed: 9600 bps/38400 bps• Data bits : 8• Start bit : 1• Stop bit : 1• Non parityFlow control using XON/XOFF and RTS/CTS, etc., isnot supported.
Peripheral devices are connected in a daisy chain. Asshown in Fig. 1, the actual internal connection is a one-direction ring, so that messages return to the controllervia the peripheral devices. The devices on the networkare assigned addresses.The address of the controller is fixed at 0.The addresses of peripheral devices are as follows.
When the address of the controller is fixed at 0The addresses of the peripheral devices are 1, 2, 3 ... inorder, starting from the one nearest the controller. Theaddress of the peripheral device is set by sendingaddress commands during the initialization of thenetwork.
When the address of the controller is fixed at1 through 7The addresses of the peripheral devices will be set on apreselected number. Within a single system, the samenumber can be used only once. If the address-switchnumber other than 0 is to be used, change the BRC-300/P address switch to a different number beforehand.
................................................................................................................................................................................................................................1)VISCA is a protocol which controls consumer camcorders developed by Sony. “VISCA” is a trademark of Sony Corporation.
VISCA Equipment
IN
OUT
IN
OUT
IN
OUT
VISCA Controller
Fig. 1 VISCA network configuration
Each VISCA device has a VISCA IN and VISCAOUT connector.Set the DTR input (the S output of the controller) ofVISCA IN to H when controlling VISCA equipmentfrom the controller.
4
VISCA CommunicationSpecifications
VISCA packet structure
The basic unit of VISCA communication is called apacket (Fig. 2). The first byte of the packet is calledthe header and comprises the sender’s and receiver’saddresses. For example, the header of the packet sentto the BRC-300/P assigned address 1 from thecontroller (address 0) is hexadecimal 81H. The packet
sent to the BRC-300/P assigned address 2 is 82H. Inthe command list, as the header is 8X, input theaddress of the BRC-300/P at X. The header of thereply packet from the BRC-300/P assigned address 1 is90H. The packet from the BRC-300/P assignedaddress 2 is A0H.Some of the commands for setting BRC-300/P unitscan be sent to all devices at one time (broadcast). Inthe case of broadcast, the header should behexadecimal 88H.When the terminator is FFH, it signifies the end of thepacket.
Timing Chart
As VISCA Command processing can only be carriedout one time in a Vertical cycle, it takes the maximum1V cycle time for an ACK/Completion to be returned.If the Command ACK/Completion communicationtime can be cut shorter than the 1V cycle time, thenevery 1V cycle can receive a Command.From this point, if 2 or more commands in a row are tobe sent, wait for the first command (for normalcommands, an ACK or an error message, for querycommands, an Inquiry Packet) to be carried out beforesending the next one.
Query Commands
Command
Within16.7msec(20msec*PAL)
RxD
TxD
ACK Completion
16.7msec(20msec*PAL)
RxD
TxD
Inquiry Pocket
Command
General Commands
16 Byte
Fig. 2 Packet structure
Bit 7(MSB)
Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0(LSB)
1 0
FF
Bit 7(MSB)
Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0(LSB)
1 1 1 1 1 1 1 1
Packet (3 to 16 bytes)
Message (1 to 14 bytes)Header Terminator
Byte 1 Byte 2 Byte 3
Sender’saddress Receiver’s address
Note
Fig. 2 shows the packet structure, while Fig. 3 showsthe actual waveform. Data flow will take place withthe LSB first.
Bit 0 Bit 1 Bit 2 Bit 3 Bit 4 Bit 5
(LSB) (MSB)
Bit 6 Bit 7
Fig. 3 Actual waveform for 1 byte.
Startbit
Stopbit.
1 byte
5
Command and inquiry
z CommandSends operational commands to the BRC-300/P.
z InquiryUsed for inquiring about the current state of theBRC-300/P.
zACK messageReturned by the BRC-300/P when it receives acommand. No ACK message is returned forinquiries.
zCompletion messageReturned by the BRC-300/P when execution ofcommands or inquiries is completed. In the case ofinquiry commands, it will contain reply data for theinquiry after the 3rd byte of the packet. If the ACKmessage is omitted, the socket number will contain a0.
Reply Packet NoteAck X0 4Y FF Y = socket numberCompletion (commands) X0 5Y FF Y = socket numberCompletion (Inquiries) X0 5Y ... FF Y = socket numberX = 9 to F: BRC-300/P address + 8
z Error messageWhen a command or inquiry command could not beexecuted or failed, an error message is returned.
Error Packet DescriptionX0 6Y 01 FF Message length errorX0 6Y 02 FF Syntax ErrorX0 6Y 03 FF Command buffer fullX0 6Y 04 FF Command cancelledX0 6Y 05 FF No socket (to be cancelled)X0 6Y 41 FF Command not executableX = 9 to F: BRC-300/P address + 8, Y = socket number
Socket number
When command messages are sent to the BRC-300/P,it is normal to send the next command message afterwaiting for the completion message or error messageto return. However to deal with advanced uses, theBRC-300/P has two buffers (memories) forcommands, so that up to two commands including thecommands currently being executed can be received.When the BRC-300/P receives commands, it notifiesthe sender which command buffer was used using thesocket number of the ACK message.As the completion message or error message also has asocket number, it indicates which command has ended.Even when two command buffers are being used atany one time, a BRC-300/P management commandand some inquiry messages can be executed.The ACK message is not returned for these commandsand inquiries, and only the completion message ofsocket number 0 is returned.
Command execution cancel
To cancel a command which has already been sent,send the Cancel command as the next command. Tocancel one of any two commands which have beensent, use the cancel message.
Cancel Packet NoteCancel 8X 2Y FF Y = socket numberX = 1 to 7: BRC-300/P address, Y = socket number
The Command canceled error message will be returnedfor this command, but this is not a fault. It indicatesthat the command has been canceled.
6
VISCA Device SettingCommand
Before starting control of the BRC-300/P, be sure tosend the Address command and the IF_Clearcommand using the broadcast function.
For VISCA network administration
z AddressSets an address of a peripheral device. Use wheninitializing the network, and receiving the followingnetwork change message.
z Network ChangeSent from the peripheral device to the controllerwhen a device is removed from or added to thenetwork. The address must be re-set when thismessage is received.
Accepted a command which is not supported or a command
lacking parameters.
There are two commands currently being executed, and the
command could not be accepted.
Could not execute the command in the current mode.
ACK is not returned for the inquiry command.
Accepted an incompatible command.
Returned the device address to +1.*
Returned the same command.
ACK is not returned for this command.
Returned when the command of the socket specified is canceled.
Completion for the command canceled is not returned.
Returned when the command of the specified socket has already
been completed or when the socket number specified is wrong.
VISCA Command/ACK Protocol
* When the address-switch is fixed at 0, the value x in 88 30 0x FF will be indeterminate.
Do not transmit the command (except Address Set,IF_Clear, Command Cancel, CAM_Power), whenmenu panel shows on the screen. In that case, clear themenu panel first using CAM_Menu Command, andthen proceed.
8
VISCA Camera-Issued Messages
ACK/Completion Messages
Command Command Message
ACK z0 4y FF
(y:Socket No.)
Completion z0 5y FF
(y:Socket No.)
Comments
Returned when the command is accepted.
Returned when the command has been executed.
z = Device address + 8
Command Command Message
Syntax Error z0 60 02 FF
Command Buffer Full z0 60 03 FF
Command Canceled z0 6y 04 FF
(y:Socket No.)
No Socket z0 6y 05 FF
(y:Socket No.)
Command Not Executable z0 6y 41 FF
(y:Socket No.)
Comments
Returned when the command format is different or when a command with illegal
command parameters is accepted.
Indicates that two sockets are already being used (executing two commands) and the
command could not be accepted when received.
Returned when a command which is being executed in a socket specified by the
cancel command is canceled. The completion message for the command is not
returned.
Returned when no command is executed in a socket specified by the cancel
command, or when an invalid socket number is specified.
Returned when a command cannot be executed due to current conditions. For
example, when commands controlling the focus manually are received during auto
focus.
Command Command Message
Network Change z0 38 FF
Comments
Issued when power is supplied to the camera.
Error Messages
Network Change Message
9
Command Set Command Command Packet Comments
AddressSet Broadcast 88 30 01 FF Address Set
IF_Clear Broadcast 88 01 00 01 FF I/F Clear
CommandCancel 8x 2p FF p: Socket No (=1 to 2)
CAM_Power On 8x 01 04 00 02 FF Power On/Off
Off 8x 01 04 00 03 FF
CAM_Zoom Stop 8x 01 04 07 00 FF
Tele(Standard) 8x 01 04 07 02 FF
Wide(Standard) 8x 01 04 07 03 FF
Tele(Variable) 8x 01 04 07 2p FF p (=0:Slow to 7:Fast)
Wide(Variable) 8x 01 04 07 3p FF p (=0:Slow to 7:Fast)