Z3 Technology HE4K-DCK-10 User manual

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
VISCA™ Camera Control Instructions
Model ames:
HE4K-DCK-10
Z3Cam-4K
DOC-USR-0115-01 DRAFT
Before attempting to connect or operate this product, please read these instructions carefully and save this manual for future use.
Copyright © 2017 Z3 echnology, LLC. All rights reserved.
Z3 echnology and ZEUS are registered trademarks of Z3 echnology, LLC. Sony is a registered trademark of Sony Corporation.
his document contains proprietary information of Z3 echnology, LLC ("Z3"). his document may not be used, reproduced, disclosed, or
disseminated to anyone without the prior written approval of an authorized representative of Z3. Z3 reserves the right to change this product at
any time and without notice. All product names, trademarks, trade names, service marks, or service names mentioned in this document are the
property of their respective owners.

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
REVISIO HISTORY
Version
Date
Change ote
Author
01 01/ 7/ 017 Original Document TA

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
3
TABLE OF CO TE TS
1.0 GENERAL DESCRIPTION ................................................................................................. 4
.0 CAMERA CONTROL VIA VISCA .......................................................................................... 5
.1 Connect and Power Up the Unit ................................................................................... 5
. Access the User Interface Using ZFinder ......................................................................... 6
.3 Com TCP Setup ...................................................................................................... 7
.4 Camera Controller Software ....................................................................................... 8
.5 Example Controller Software ...................................................................................... 9
LIST OF FIGURES
Figure 1 Streaming and Power Connections ............................................................................ 5
Figure ZFinder with a Product Selected............................................................................... 6
Figure 3 Com TCP Configuration ......................................................................................... 7
Figure 4 Camera Controller Software Configuration .................................................................. 8
Figure 5 Running the Example Application .............................................................................. 9

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
4
1.0 GE ERAL DESCRIPTIO
Camera Solutions products by Z3 Technology, including the Z3Cam-4K
TM
and HE4K-DCK-10, support remote
control of compatible video cameras, including cameras that support Sony’s VISCA™ protocol. VISCA
commands can be sent from a remote PC using the same IP connection that carries the video. Control
actions include zoom, focus, aperture and more.
The Z3Cam-4K leverages Sony 4K camera technology which supports the VISCA protocol.
The HE4K-DCK-10 OEM system must be paired with a remote control protocol compatible camera as a video
source.
You will also need a Windows 7 PC with Com TCP and your camera controller software downloaded.
For more information on your hardware and use, please consult your general product User Instructions.

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
5
2.0 CAMERA CO TROL VIA VISCA
This section gives step-by-step instructions on using your PC to access the user interface of your Z3 Camera
Solutions product. Here you’ll be able to change the settings to fit your video streaming needs and control
the camera. In addition to the Z3Cam-4K, a Windows PC, a 1 V power supply and an Ethernet cable are
required.
2.1 Connect and Power-Up the Unit
(1) If you are using the HE4K-DCK-10 OEM system, connect your compatible camera via the KEL ribbon
cable or Micro-HDMI ports.
( ) Connect an Ethernet cable from Ethernet on the back of the unit to a switch, router or other DHCP
server on the same network as your Windows PC.
(3) Connect the 1 V power supply to +12V on the camera and plug into a power outlet.
If Power over Ethernet (PoE) is available, then no connection to the power supply is required.
It will take 15-30 seconds to boot.
(1) Connect to
Ethernet
(2) Connect to
12V Power
Figure 1 Streaming and Power Connections

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
6
2.2 Access the User Interface Using ZFinder
ZFinder is a PC utility that allows you to find any Z3 Technology product on your network. If you have
not yet downloaded this to your computer, you can find this program at Z3Cam-4K.Z3technology.com.
(4) Verify your PC is set to DHCP. If it is set to a static IP address, ZFinder may be unable to discover
your camera.
(5) Run the ZFinder PC utility on your PC. You may need to allow it past any firewalls or security
programs on your PC. The ZFinder window appears and completes a scan of the network. ZFinder
then lists all Z3 systems connected to the network. The Z3 unit appears.
(6) Click on the product entry in the window to select it. This will cause the Edit Device, Open Device
and Flash LEDs buttons to activate.
Figure 2 ZFinder with a Product Selected
*Note: Selecting Edit Device allows for manual changes to network settings. See your general
User Instructions for more information.
*Note: If the device appears in red, there is a network error, and network settings will need to be
modified in order to access the user interface.
(7) Click on Open Device. An internet browser window is opened in your default web browser (for best
results, Firefox or Chrome are recommended) and the user interface appears with the Channel 1
configuration (CH1) tab open.

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
7
2.3 Com2TCP Setup
(1) If you have not already done so, install the Com TCP application onto your PC. (Windows 7 is
supported. Windows 8 or 10 are not recommended.) Com TCP is an application supporting remote
access and is available online.
( ) Launch the Com TCP application.
(3) Set the Remote IP field to the IP address of your Z3 unit. This can be found using ZFinder or as
the URL of the web browser with the user interface open.
(4) Set the TCP Port to 1000.
(5) Assign a COM Port that is not currently in use on your system using the dropdown menu.
(6) Click the Connect button. The application will minimize. Do not close this application while your
camera control is in use.
The COM port selected will now redirect data to the Z3 unit.
Figure 3 Com2TCP Configuration
Set to “1000”
Set to the IP
Address of
Your Z3 Unit

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
8
2.4 Camera Controller Software
(7) Install your camera control software onto your PC.
(8) Launch the controller software application.
(9) Set the port name to match the COM Port selected previously.
(10) Set the Baud Rate to 9600.
(11) Save these settings.
(1 ) Reference your camera documentation for more information regarding the camera control
options. Remember, you may need to close and restart your camera controller application for
changes to take effect.
Figure 4 Camera Controller Software Configuration
Com2TCP Camera Control
Software
Match Values
Set to
“9600kbps”

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
9
2.5 Example Controller Software
If you do not have camera control software it is quite straight-forward to write your own. Below is a
simple example application on how to send VISCA commands from a Windows PC to the Z3 unit.
The following example code connects to the TCP socket of the Z3 unit and is capable of sending several
VISCA commands to the Z3 unit. The interface looks like the following:
The application code is as follows:
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include <fcntl.h>
#include <time.h>
#include <sys/types.h>
#include<winsock2.h>
#include <conio.h>
#define FAL E 0
#define TRUE 1
Figure 5 Running the Example Application

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
10
int status;
void usage()
{
printf("Usage: z3visca cameraip port\n");
}
void help()
{
printf("The Following key combinations are supported:\n");
printf("\tI:\t Zoom In\n\tO:\t Zoom Out\n\t pace:\t top Zoom\n\tV:\t Prints version inquiry\n\tF:\t ets
picture to fliped\n\tN:\t ets picture to normal.\n\tH:\t Prints this message\n\tX:\t Exits\n");
}
void hex_dump(void *hex, int size)
{
int i;
char *hex_c = (char *)hex;
for (i = 0; i<size; i++)
{
printf("%02x ", hex_c[i] & 0xff);
if ((i+1 % 16) == 0 )
printf("\n");
}
printf("\n");
}
int visca_send( OCKET soc, char *cmd)
{
send(soc, &cmd[1], (size_t)cmd[0],0);
}
int visca_receive( OCKET soc, char* receive, int size, int do_dump)
{
int ret = -1;

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
11
while (ret == -1)
{
again:
ret = recv(soc, (void *)receive, size,0);
leep(1);
}
if (ret > 0 && do_dump) {
hex_dump(receive, ret);
}
if (ret > 2 &&
(receive[1] >= 0x40 && receive[1] <= 0x4f))
{
if (ret <= 3) //need another response
{
ret = -1;
goto again;
}
}
}
int main(int argc, char *argv[])
{
int res, i;
int ch = 0, chant = 0;
OCKET s;
char buf[255];
unsigned char cmdVisca[6][10]=
{{0x06,0x81,0x01,0x04,0x07,0x02,0xFF,0x00,0x00,0x00}, //zoom in
{0x06,0x81,0x01,0x04,0x07,0x03,0xFF,0x00,0x00,0x00}, //zoom out
{0x06,0x81,0x01,0x04,0x07,0x00,0xFF,0x00,0x00,0x00}, //zoom stop
{0x05,0x81,0x09,0x00,0x02,0xFF,0x00,0x00,0x00,0x00}, //Version Inq
{0x06,0x81,0x01,0x04,0x66,0x02,0xFF,0x00,0x00,0x00}, //Pic flip on
{0x06,0x81,0x01,0x04,0x66,0x03,0xFF,0x00,0x00,0x00}, //Pic flip off
};

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
1
//open the device in non-blocking way (read will return immediately)
if (argc == 1)
{
usage();
exit(-1);
}
else
{
int portno = 1000, n;
struct sockaddr_in serv_addr;
W ADATA wsa;
printf("\nInitialising Winsock...");
if (W A tartup(MAKEWORD(2, 2), &wsa) != 0)
{
printf("Failed. Error Code : %d", W AGetLastError());
return -1;
}
//open tcp socket
s = socket(AF_INET, OCK_ TREAM, 0);
if (s == INVALID_ OCKET)
{
printf("error opening socket : %d\n", W AGetLastError());
return -2;
}
printf("connecting to %s:%s\n", argv[1], argv[2]);
if (argv[2] != NULL)
{
portno = strtoul(argv[2], NULL, 10);
}
memset((char *) &serv_addr, 0,sizeof(serv_addr));
serv_addr.sin_family = AF_INET;
serv_addr.sin_addr.s_addr = inet_addr(argv[1]);

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
13
serv_addr.sin_port = htons(portno);
if (connect(s,(struct sockaddr *) &serv_addr,sizeof(serv_addr)) < 0)
{
printf("ERROR connecting\n");
return -3;
}
printf("connected!\n");
}
if (s != INVALID_ OCKET) {
help();
while ( 1) {
ch = _getch();
if (ch == 'i' || ch == 'I')
{
printf("Zoom In\n");
visca_send(s, cmdVisca[0]);
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 'o' || ch == 'O')
{
printf("Zoom Out\n");
visca_send(s, cmdVisca[1]);
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 67) //Right
{
//printf("Right\n");
}
if (ch == 68) //Left
{
//printf("Left\n");
}
if (ch == 86 || ch == 118 )
{
printf("Version Inq\n");
visca_send(s, cmdVisca[3]);

VISCA Camera Control Instructions
DOC-USR-0115-01 DRAFT
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8
th
ST, STE 50 ♦ Lincoln, NE 68508-1369 USA ♦ +1.40 .3 3.070
14
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 'f' || ch == 'F')
{
printf("Flip On\n");
visca_send(s, cmdVisca[4]);
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 'n' || ch == 'N')
{
printf("Flip Off\n");
visca_send(s, cmdVisca[5]);
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 'h' || ch == 'H')
{
help();
}
if (ch == 32) //stop zoom
{
printf(" top Zoom\n");
visca_send(s, cmdVisca[2]);
visca_receive(s,buf,sizeof(buf), 1);
}
if (ch == 'x' || ch == 'X')
{
break;
}
leep(1);
}
}
closesocket(s);
}