Z3 Technology Z3Cam-4K-RPS User manual

1
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
User Instructions
4K HEVC/H.265 & H.264 IP Camera
Model Name: Z3Cam-4K-RPS
DOC-USR-0102-01
Manual Version 1.05.02
Software Version 1.05.02
July 26, 2016
Before attempting to connect or operate this product, please read these instructions carefully and save this manual for future use.
© 2016 Z3 Technology, LLC. All rights reserved.
This document contains proprietary and confidential information of Z3 Technology, LLC ("Z3"). This document may not be used, reproduced,
disclosed, or disseminated to anyone without the prior written approval of an authorized representative of Z3.
Z3 Technology, LLC incorporates HDMI® technology. The terms of HDMI and HDMI High-Definition Multimedia Interface, and
the HDMI Logo are trademarks or registered trademarks of HDMI Licensing LLC in the United States and other countries.

2
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
Revision History
Version
Date
Change Note
Author
1.05.02
07/26/2016
Original Document
TA

3
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
TABLE OF CONTENTS
GENERAL DESCRIPTION.................................................................................................. 61.0
QUICK START GUIDE ..................................................................................................... 72.0
2.1 If You Have Received a System from Z3 with the Software Preloaded........................................ 7
2.2 If You Already Have a System from Z3 and Need to Update the Firmware................................... 7
2.3 If You are Ready to Start Development............................................................................ 7
INCLUDED PARTS LIST ................................................................................................... 83.0
FEATURES ................................................................................................................. 84.0
4.1 Supported Resolutions................................................................................................ 9
UNTARRING AND BUILDING THE SAMPLE CODE .....................................................................105.0
5.1 Preparing the Linux Environment..................................................................................10
5.2 Making the Directories and Running the Make Script ...........................................................10
CODE OVERVIEW ........................................................................................................126.0
6.1 The z3apps/rdk Directory...........................................................................................12
6.2 Z3 Application Overview ............................................................................................12
RUNNING THE ENCODER ...............................................................................................147.0
7.1 Connect the Encoder ................................................................................................14
7.2 Set up the Terminal Window .......................................................................................15
7.3 Power on the Z3Cam-4K ............................................................................................15
7.4 Verify your PC has the Proper IP Address.........................................................................16
7.5 Run the HTTP-based User Interface to Configure Channel 1 for Streaming UDP ...........................17
7.6 PC Configuration for 4K HEVC/H.265 Decode....................................................................18
7.7 Run VLC to View the UDP Stream..................................................................................20
7.8 Configure Channel 1 for Streaming RTP ..........................................................................21
7.9 Run VLC to View the RTP Stream ..................................................................................22
7.10 Configure Channel 1 for Streaming RTSP........................................................................23
7.11 Run VLC to View the RTSP Stream ...............................................................................24
7.12 Changing the Bitrate Dynamically................................................................................25
7.13 Tuning for Latency .................................................................................................27
PERFORMING OTHER OPERATIONS....................................................................................288.0
8.1 Saving Current Settings .............................................................................................28
8.2 Changing the IP Address via Serial ................................................................................29
8.3 Changing the IP Address via the HTTP-based User Interface ..................................................30
8.4 Using ZFinder to Access the User Interface ......................................................................32
RUNNING THE CODE YOU BUILT ON THE BOARD ...................................................................339.0

4
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
SUMMARY OF OPTIONS................................................................................................35
10.0
10.1 The System Setup Tab .............................................................................................35
10.2 The CH1 Tab.........................................................................................................36
10.3 Values Appearing at the Bottom of All Tabs....................................................................37
APPENDIX A: Troubleshooting.............................................................................................38

5
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
LIST OF FIGURES
Figure 1 Z3Cam-4K Interfaces ............................................................................................. 6
Figure 2 Sample Content of Images Directory after Successful Build ...............................................11
Figure 3 Z3Cam-4K Encode Connections ................................................................................14
Figure 4 Z3Cam-4K Serial Menu ..........................................................................................16
Figure 5 CH1 Tab UDP Configuration ....................................................................................17
Figure 6 LAV Filters Configuration .......................................................................................18
Figure 7 Disable Hardware Decoding in VLC............................................................................19
Figure 8 VLC Open Network Screen (UDP) ..............................................................................20
Figure 9 Example of Encoded Video Streaming to VLC (UDP) ........................................................20
Figure 10 CH1 Tab RTP Configuration ...................................................................................21
Figure 11 Example of Encoded Video Streaming to VLC (RTP).......................................................22
Figure 12 CH1 Tab RTSP Configuration ..................................................................................23
Figure 13 VLC Open Network Screen for RTSP .........................................................................24
Figure 14 Example of Encoded Video Streaming to VLC (RTSP) .....................................................24
Figure 15 Viewing Bitrate in VLC.........................................................................................25
Figure 16 Changing the Bitrate Dynamically............................................................................25
Figure 17 Drop in Bitrate after Dynamic Bitrate Change .............................................................26
Figure 18 Creating a New User Preset Configuration..................................................................28
Figure 19 Entering a User Preset Name .................................................................................28
Figure 20 Saving a User Preset ...........................................................................................28
Figure 21 Saving Updated Network Settings ............................................................................30
Figure 22 Save Complete Message .......................................................................................31
Figure 23 Example ZFinder Window with a Z3 Technology Product Selected .....................................32
Figure 24 Updating the Device Firmware from the User Interface..................................................33
Figure 25 Updater Screen .................................................................................................33
Figure 26 Example File Selection Screen................................................................................34

6
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
GENERAL DESCRIPTION
1.0
The Z3Cam-4K-RPS rapid production starter kit is a compact encoder system leveraging Sony’s FCB-ER8300
4K camera block. The unit is capable of encoding HEVC/H.265 and H.264 video in Ultra-HD and HD
resolutions. The software consists of Linux kernel and application packages to allow users to develop their
own advanced multimedia applications.
The Z3Cam-4K IP camera features on-board interfaces including GigE, USB 2.0, RS-232 Serial, Micro SD,
Microphone Input and Composite Out. These features combined with the existing capabilities of the FCB-
ER8300 4K camera block allow for a complete compact HEVC 4K IP streaming solution. The OEM electronics
are also available for purchase as the HE4K-DCK-10.
The Z3Cam-4K-RPS software is based on the Linux OS. The kit comes with all of the low-level resources such
as the Linux kernel, u-boot, tool chain and starter file system pre-integrated and configured. The software
bundle also contains tools to allow the development of high-level applications using hardware-accelerated
video processing. Those customers that license the optional source code package can also receive source
code for Z3’s demonstration applications, providing an ideal starting point for custom applications.
Z3 Technology can provide services to customize the software applications to a customer’s specification. For
design services or additional support, please contact Z3 at www.Z3technology.com or
[e-mail].
Micro SD
RS-232 Serial
Figure 1 Z3Cam-4K Interfaces
Microphone In
USB
GigE
+12V Power
NTSC/PAL Output

7
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
QUICK START GUIDE2.0
2.1 If You Have Received a System from Z3 with the Software Preloaded
To start working with the encoder, you can go straight to Section 7.0, “RUNNING THE ENCODER,” on
page 14. This section describes how to quickly stream UDP, RTP or RTSP from the RPS.
2.2 If You Already Have a System from Z3 and Need to Update the Firmware
There are several options for updating the firmware on your RPS by following the instructions in Section
9.0: “RUNNING THE CODE YOU BUILT ON THE BOARD”, on page 33.
2.3 If You are Ready to Start Development
Details on how to untar and build the code can be found in Section 5.0: “ UNTARRING AND BUILDING
THE SAMPLE CODE,” on page 10. A brief overview of the code itself can be found in Section 6.0: “CODE
OVERVIEW,” on page 12.
Details on how to set up your system to access the code you have built can be found in Section 9.0:
“RUNNING THE CODE YOU BUILT ON THE BOARD”, on page 33.

8
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
INCLUDED PARTS LIST3.0
1 x Z3Cam-4K IP Camera
1 x 12V 1A Power Supply
1 x Serial Cable
1 x Gender Changer
1 x Ethernet Cable
FEATURES4.0
Leverages Sony’s 4K video technology using the FCB-ER8300 camera
20x optical zoom using Sony’s patented Super Resolution Zoom
Noise reduction algorithm for high frequency and high detail areas
Visability enhancer ICR (Day and Night)
High sensitivity image processor
HEVC/H.265 encode and stream up to 2160p at 30 fps
H.264 encode and stream up to 2160p at 30 fps
Encode modes of operation: HEVC/H.265 and H.264
Low bandwidth, low latency video encoding
Simultaneously output two different resolutions from a single video source*
Pass VISCA camera control commands over IP*
Inputs: microphone
Outputs: Composite
Additional Interfaces include Gigabit Ethernet, USB 2.0, Micro SD Card and RS-232 Serial
Supports streaming in MPEG-2 TS (UDP), RTP, RTSP and TSRTP
Supports unicast and multicast streaming
Optional ONVIF Profile S*
Supports Power over Ethernet (PoE)*
Compatible with the ZEUSTM HE4K-01 H.264 decoder (also available from Z3 Technology)
HTTP-based configuration software for user-friendly configuration, control and update
RS-232 serial port for technical configuration and control
* Available in an upcoming release. Contact Z3 Technology for more information.

9
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4.1 Supported Resolutions
Follow_input (2160p29.97)
Resize to 1080p29.97, 720p29.97 and 480p29.97

10
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
UNTARRING AND BUILDING THE SAMPLE CODE5.0
5.1 Preparing the Linux Environment
Prior to building the Z3 code, certain modules are required. In Ubuntu 16.04 or later, the following
command can be used to get the required modules:
sudo apt-get install build-essential bison flex mtd-utils liblzo2-dev uuid-dev
zlib1g-dev libpcre3-dev autoconf autoconf-archive automake libtool libtool-
doc libc6-dev lynx xutils-dev libncurses5-dev yodl
In Fedora, the command would be:
sudo yum install bison flex mtd-utils mtd-utils-ubi lzo-devel libuuid-devel
pcre-devel automake autoconf libtool
If you are running a 64-bit OS, it may be necessary to install some 32-bit libraries for the cross-compiling
toolchain. You can determine whether your OS is 64-bit by using the “uname –p” command. A 64-bit OS
will return “x86_64,” while a 32-bit OS will return “i386”, “i586”, or “i686”.
For 64-bit Ubuntu, you can get the necessary libraries by typing:
# sudo apt-get install gcc-multilib
# sudo dpkg –-add-architecture i386
# sudo apt-get update
# sudo apt-get install libc6:i386 libncurses5-dev:i386 libstdc++6:i386 zlib1g:i386
For 64-bit Fedora, you can type:
# sudo yum install glibc.i686
For Ubuntu change shell from dash to bash:
# sudo dpkg-reconfigure dash
Then select “No” when it asks if “dash” should be the system shell (this will cause /bin/sh to be linked
to “bash” instead)
5.2 Making the Directories and Running the Make Script
The software provided will allow you to re-create the pre-installed software of the Z3Cam-4K-RPS
starting from the included code.
On a PC running Linux, create a directory where the released materials are going to be located:
# mkdir /home/z3/z3-he4k
Copy the released tar archive to that directory (note: the name may slightly vary).
# cp SW-CH1-00657-01_HE4K-DCK-10-20160721.tar.bz2 /home/z3/z3-he4k
Untar the archive (name of tar file may slightly vary):
# tar -xvjf SW-CH1-00657-01_HE4K-DCK-10-20160721.tar.bz2
*Note: Untarring takes 5 to 10 minutes.

11
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
Go into the directory just created and run the build script (directory name may slightly vary):
# cd SW-CH1-00657-01_HE4K-DCK-10-20160721
# ./makeall
*Note: Building can take around 15-20 minutes. You will also need to type in the sudo password a few
times.
The outcome of the build process should be newly created image files in the images directory. You can
confirm this by doing the following:
# cd images
# ls -alt
The result should be something like the following. Note that actual filenames, dates, and times will
differ.
Figure 2 Sample Content of Images Directory after Successful Build
(1)

12
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
CODE OVERVIEW6.0
Once you have untarred the code, you will see the following top-level directories:
build-tools Config files and scripts for building the codebase
hevc_sdk The encoder SDK code
factory Factory testing scripts (the user can disregard these)
sysapps Various supporting applications
z3apps Z3 demo application code and scripts
The Z3 application code that comes with the Z3Cam-4K-RPS is run from the serial_menu.lua script in
z3apps/hevc_app/scripts/. This code calls the /opt/mcsenc binary, which initializes and runs the encoder.
This binary is built from the z3apps/hevc_app/encode_app directory. The code for the binary resides in
z3apps/hi35xx_app/encode_app. The z3apps/hevc_app directory is described in more detail in the next
section.
6.1 The z3apps/rdk Directory
There are three main subdirectories: encode_app, hevc_audio, and scripts
6.1.1 encode_app
This directory contains the code for the encoder application
The file mcsenc.cpp is responsible for setting the output mode of the encoder. Output to file, rtp,
and MPEG2-TS are handled here.
6.1.2 hevc_audio
This directory contains the code for the audio encode API.
6.1.3 scripts
This directory contains the control scripts for the serial user interface and HTTP-based web user
interface.
6.2 Z3 Application Overview
6.2.1 Application Names and Locations
The application binary can be found at /opt/mcsenc.

13
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
6.2.2 Application Source Code
Application source code is available under a separate license agreement. For customers that have
licensed it, the application source code can be found mainly in:
$PRJROOT/z3apps/hevc_app/encode_app
The top-level file for the menu-driven application is mcsenc.cpp.

14
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
RUNNING THE ENCODER7.0
This section gives step-by-step instructions on HEVC/H.265 encoding with the Z3Cam-4K-RPS and streaming
2160p30 video to a PC media player. In addition to the Z3Cam-4K and provided accessories, you will need
the following:
A PC capable of 4K HEVC/H.265 decode. Please review the following requirements:
Nvidia GEForce GTX960M processor
VLC media player
1
version 2.2.4 or higher
LAV Filters
2
version 0.63 or higher
The SDP file(s) provided with your Z3 software release (see your customer support server account)
*Note: The Sony FCB-ER8300 does not support audio.
7.1 Connect the Encoder
Connect the supplied 2.5 mm serial cable and gender changer to the serial console of the Z3Cam-4K(1)
and to your PC.
(A USB to Serial converter may be needed. If so, the FTDI UC232R-10 (Digikey part #768-1014-ND) is
recommended.)
Connect an Ethernet cable to the Z3Cam-4K and a switch or router on the same network as your PC(2)
or directly to your PC.
1
VLC is an open source media player from the VideoLAN organization that can be downloaded for free online.
2
LAV Filters is an open source program that allows playback of video and audio on a PC without installation of
additional codecs and can be downloaded for free online.
RS-232 Serial
Figure 3 Z3Cam-4K Encode Connections
+12V Power
Ethernet

15
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.2 Set up the Terminal Window
If you are running from a Windows PC, we recommend running TeraTerm for serial configuration and(3)
monitoring. Select “Setup – Serial Port” and use the following settings:
Port: Whichever serial port the port is connected to
Baud Rate: 115200
Data: 8-bit
Parity: None
Stop: 1-bit
Flow Control: None
If you are running from Linux, type:(4)
# sudo minicom –s
And then configure by doing the following:
-Select “Serial Port Setup”
-Ensure the right Serial Device is specified (typically “/dev/ttyUSB0”)
-Set option E (“Bps/Par/Bits”) to 115200 8N1
-Press <return>
-Select “Exit”
7.3 Power on the Z3Cam-4K
Connect the 12V 1A power supply. If all is configured properly, you will see the unit booting up within(5)
the terminal window. After 20-30 seconds, you will see the RPS Main Menu.
Note the local IP address and netmask (192.168.0.120 and 255.255.0.0 by default). This is the IP address
of the board. You will need this later to access the HTTP-based user interface.

16
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.4 Verify your PC has the Proper IP Address
To be able to communicate with the encoder assembly, the PC that you are communicating from needs
to have the same first two parts of the IP address. For example, if the Z3Cam-4K has an IP address of
192.168.0.120, your PC would need to have an address of 192.168.x.y, where x.y is anything but 0.120
(and not conflicting with what is on your current network).
Ensure that this is the case. If necessary, use the “P” and “N” options to modify the address/network (6)
of the camera to conform to your network.
*Note: The first two parts need to be the same based on the netmask set to 255.255.0.0. If
netmask were 255.255.255.0, for example, then the first three parts of the IP address would have
to be the same.
After you are done, make note of the address your PC is set to. This will be important in the(7)
streaming step.
Figure 4 Z3Cam-4K Serial Menu

17
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.5 Run the HTTP-based User Interface to Configure Channel 1 for Streaming UDP
The following actions can be completed in either the serial interface or an HTTP-based user interface
run on a web browser. For ease of use, the HTTP-based interface is described.
Access the user interface by:(8)
(a) Opening an Internet browser window on your PC (for best results, FireFox or Chrome are
recommended) and enter the IP address of the RPS (192.168.0.120 by default) into the
URL text box. The HTTP-based graphical user interface (GUI) appears at the CH1 tab.
(b) Running the ZFinder PC utility. See section 8.4 for more information.
Note: Settings in the user interface cannot be changed if the unit is currently encoding.
Click the red “Stop” button at the bottom of any screen to stop any current encoding.(9)
At the CH1 tab, verify the “Video Source” is set to “HDMI” using the dropdown menu.(10)
Change “Output Resolution” to “Follow Input”.(11)
Select the codec you would like to use for your encoding. Both H.265/HEVC and H.264/AVC are(12)
supported. In the pictured example, verify “Video Codec” is set to “H265(HEVC)”.
Set “Output Format” to “UDP”.(13)
You can set “Dest Address” to:(14)
(a) the IP address of your PC that will be running VLC media player (in the pictured example,
192.168.0.6).
(b) or to a multicast address (An example multicast address would be “225.1.2.3”. If you are
on a shared network, check with your Network Administrator.)
Also make note of the value of “Dest Port” (8600 by default).(15)
Click the green “Start” button.(16)
Figure 5 CH1 Tab UDP Configuration
(5) Change
to “UDP”
(1) If necessary, click “Stop”
(8) Click “Start”
(2) Verify
Is “HDMI”
(3) Change to
“Follow input”
(4) Verify Is
“H265(HEVC)”
(6) Set to PC
IP Address or
Multicast Address
(7) Note value

18
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.6 PC Configuration for 4K HEVC/H.265 Decode
Due to the advanced processing needed to support HEVC/H.265 decoding at 4K resolutions, a PC must
meet the following requirements:
Nvidia GEForce GTX960M processor
VLC media player
3
version 2.2.4 or higher
LAV Filters
4
version 0.63 or higher
Install LAV Filters if necessary.(17)
Navigate to the Properties and select the “Video Settings” tab.(18)
Verify the HEVC video codec is enabled.(19)
Disable all Hardware Acceleration.(20)
3
VLC is an open source media player from the VideoLAN organization that can be downloaded for free online.
4
LAV Filters is an open source program that allows playback of video and audio on a PC without installation of
additional codecs and can be downloaded for free online.
Figure 6 LAV Filters Configuration

19
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
Install VLC if necessary.
(21)
Navigate to Tools > Preferences.(22)
In the Simple Preferences window, find the “Show settings” section in the bottom left corner of the (23)
window and select the check box next to “All”
In the Advanced Preferences window that appears, navigate to “Video codecs” on the left hand (24)
column and select “FFmpeg”.
Disable hardware decoding.(25)
Verify your PC has the Nvidia GEForce GTX960M processor, all Nvidia drivers are installed and it is(26)
set as the default graphics processor.
Verify is Set
to “Disable”
Figure 7 Disable Hardware Decoding in VLC

20
CONFIDENTIAL DOC-USR-0102-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.7 Run VLC to View the UDP Stream
Run the VLC media player on your PC.(27)
Select Media –Open Network Stream. In the box, type “udp://@192.168.0.6:8600”, where (28)
“192.168.0.6” matches the values of the computer IP address or multicast address entered for
“Dest Address” previously and “8600”is the value of “Dest Port” noted previously.
Press “Enter” or click “Play.”(29)
You will now see your source video streaming to VLC.(30)
Figure 9 Example of Encoded Video Streaming to VLC (UDP)
Figure 8 VLC Open Network Screen (UDP)