Z3 Technology HE4K-DCK-RPS User manual

1
CONFIDENTIAL DOC-USR-0101-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 Encoding System
Rapid Production Starter Kit
Model Name: HE4K-DCK-RPS
DOC-USR-0101-01
Manual Version 1.0.0
July 21, 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-0101-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.0.0
07/21/2016
Original Document
TA/JW

3
CONFIDENTIAL DOC-USR-0101-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 ..................................................................................................... 92.0
2.1 If You Have Received a System from Z3 with the Software Preloaded........................................ 9
2.2 If You Already Have a System from Z3 and Need to Update the Firmware................................... 9
2.3 If You are Ready to Start Development............................................................................ 9
INCLUDED PARTS LIST................................................................................................103.0
FEATURES ................................................................................................................104.0
4.1 Supported Resolutions...............................................................................................11
UNTARRING AND BUILDING THE SAMPLE CODE .....................................................................125.0
5.1 Preparing the Linux Environment..................................................................................12
5.2 Making the Directories and Running the Make Script ...........................................................12
CODE OVERVIEW ........................................................................................................146.0
6.1 The z3apps/rdk Directory...........................................................................................14
6.2 Z3 Application Overview ............................................................................................14
RUNNING THE ENCODER ...............................................................................................167.0
7.1 Connect the Encoder ................................................................................................16
7.2 Set up the Terminal Window .......................................................................................17
7.3 Power on the Board..................................................................................................18
7.4 Verify your PC has the Proper IP Address.........................................................................18
7.5 Run the HTTP-based User Interface to Configure Channel 1 for Streaming UDP ...........................19
7.6 Run VLC to View the UDP Stream..................................................................................21
7.7 Configure Channel 1 for Streaming RTP ..........................................................................22
7.8 Run VLC to View the RTP Stream ..................................................................................23
7.9 Configure Channel 1 for Streaming RTSP .........................................................................24
7.10 Run VLC to View the RTSP Stream ...............................................................................25
7.11 Changing the Bitrate Dynamically................................................................................26
7.12 Tuning for Latency .................................................................................................28
PERFORMING OTHER OPERATIONS....................................................................................298.0
8.1 Saving Current Settings .............................................................................................29
8.2 Changing the IP Address via Serial ................................................................................30
8.3 Changing the IP Address via the HTTP-based User Interface ..................................................31
RUNNING THE CODE YOU BUILT ON THE BOARD ...................................................................339.0
SUMMARY OF OPTIONS................................................................................................3510.0
10.1 The System Setup Tab .............................................................................................35

4
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
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-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
LIST OF FIGURES
Figure 1 HE4K-DCK-10 Dimensions and Interfaces ................................................................... 6
Figure 2 HE4K-DCK-RPS Block Diagram................................................................................. 8
Figure 3 HE4K-DCK-RPS Physical Block Diagram (Chassis Not Included) ......................................... 8
Figure 4 HE4K-DCK-RPS ..................................................................................................10
Figure 5 Sample Content of Images Directory after Successful Build ...........................................13
Figure 6 Encode Connections ...........................................................................................17
Figure 7 Serial Menu ......................................................................................................18
Figure 8 CH1 Tab UDP Configuration ..................................................................................20
Figure 9 VLC Open Network Screen (UDP)............................................................................21
Figure 10 Example of Encoded Video Streaming to VLC (UDP) ...................................................21
Figure 11 CH1 Tab RTP Configuration .................................................................................22
Figure 12 Example of Encoded Video Streaming to VLC (RTP) ...................................................23
Figure 13 CH1 Tab RTSP Configuration................................................................................24
Figure 14 VLC Open Network Screen for RTSP ......................................................................25
Figure 15 Example of Encoded Video Streaming to VLC (RTSP) ..................................................25
Figure 16 Viewing Bitrate in VLC.......................................................................................26
Figure 17 Changing the Bitrate Dynamically .........................................................................26
Figure 18 Drop in Bitrate after Dynamic Bitrate Change ..........................................................27
Figure 19 Creating a New User Preset Configuration...............................................................29
Figure 20 Entering a User Preset Name ...............................................................................29
Figure 21 Saving a User Preset .........................................................................................29
Figure 22 Saving Updated Network Settings .........................................................................31
Figure 23 Save Complete Message .....................................................................................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-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
GENERAL DESCRIPTION1.0
The HE4K-DCK-RPS OEM rapid production starter kit is a compact encoder system geared to enhance Sony’s
FCB-ER8300 4K camera block. The hardware consists of the HE4K-DCK-10, a three board encoder unit
capable of encoding HEVC/H.265 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 HE4K-DCK-10 boards feature on-board interfaces including GigE, USB 2.0, RS-485, 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. Users are also able to purchase the HE4K-DCK-
10 as a complete package that includes the FCB-ER8300 camera and an enclosure for the entire solution.
Micro SD
RS-232 Serial
Sony FCB ER-8300
(Not Included)
KEL Ribbon Cable
Figure 1 HE4K-DCK-10 Dimensions and Interfaces
58 mm
Microphone In
USB
GigE
+12V Power
NTSC/PAL Output
58 mm

7
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
The HE4K-DCK-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].

8
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
The following block diagrams illustrate the I/O and physical layout of the HE4K-DCK-10 camera dock video
encoder system.
Figure 2 HE4K-DCK-RPS Block Diagram
Figure 3 HE4K-DCK-RPS Physical Block Diagram (Chassis Not Included)

9
CONFIDENTIAL DOC-USR-0101-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 16. 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 12. A brief overview of the code itself can be found in Section 6.0: “CODE
OVERVIEW,” on page 14.
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.

10
CONFIDENTIAL DOC-USR-0101-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 Set of HE4K-DCK-10 Encoder Boards Assembly
1 x KEL Ribbon Cable
1 x 12V 1A Power Supply
1 x Serial Cable
1 x Gender Changer
FEATURES4.0
Natively integrates with Sony’s 4K FCBER8300 Block Camera
HEVC/H.265 encode and stream up to 2160p at 30 fps
H.264 encode and stream up to 2160p at 30 fps
Simultaneous encode of HEVC/H.265 and H.264
Simultaneously output two different resolutions from a single video source
Pass VISCA camera control commands over IP
Low bandwidth, low latency video encoding
Inputs: Video from Sony FCB-ER8300 via KEL ribbon cable, microphone and optional Micro HDMI*
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*
Optional PoE*
Optional chassis for camera and encoder boards*
HTTP-based configuration software for user-friendly configuration, control and update
RS-232 serial port for technical configuration and control
* Contact Z3 Technology for more information.
Figure 4 HE4K-DCK-RPS

11
CONFIDENTIAL DOC-USR-0101-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

12
CONFIDENTIAL DOC-USR-0101-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 Z3-HE1080-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.

13
CONFIDENTIAL DOC-USR-0101-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 5 Sample Content of Images Directory after Successful Build
(1)

14
CONFIDENTIAL DOC-USR-0101-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 HE4K-DCK-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.

15
CONFIDENTIAL DOC-USR-0101-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.

16
CONFIDENTIAL DOC-USR-0101-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 HE4K-DCK-RPS and streaming
2160p30 video from the Sony FCB-ER8300 to a PC media player. In addition to the HE4K-DCK-10 encoder
boards and provided accessories, you will need the following:
Sony FCB-ER8300 4K Camera Block
Ethernet Cable
A PC with VLC media player
The SDP file 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
The Interface Front End PCB of the HE4K-DCK-10 assembly (see Figure 3) has a 30-pin KEL connector that
allows a flexible ribbon cable to be used to connect the encoder assembly to an identical connector on the
Sony FCB-ER8300 4K camera block.
WARNING: ONLY USE THE CORRECT KEL RIBBON CABLE.
Using an incorrect cable can permanently damage the camera body. See the HE4K-DCK-10 Hardware
Specification for more information.
Connect the Z3 approved KEL ribbon cable from the “Interface Front End PCB” of the HE4K-DCK-10(1)
assembly (see Figure 3) to the Sony FCB-ER8300.
Connect the supplied 2.5 mm serial cable and gender changer to the serial console of the “Main(2)
Encoder PCB”of the HE4K-DCK-10 assembly (see Figure 3) 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 “I/O Jack and PoE PCB”of the HE4K-DCK-10 assembly (see Figure(3)
3) and a switch or router on the same network as your PC or directly to your PC.

17
CONFIDENTIAL DOC-USR-0101-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(4)
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:(5)
# 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”
RS-232 Serial
Sony FCB ER-8300
(Not Included)
KEL Ribbon Cable
Figure 6 Encode Connections
+12V Power
Ethernet

18
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.3 Power on the Board
Connect the 12V 1A power supply. If all is configured properly, you will see the board booting up(6)
within 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.
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 board 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 (7)
of the board to conform to your network.
Figure 7 Serial Menu

19
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
*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(8)
streaming step.
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 interface run on
a web browser. For ease of use, the HTTP-based interface is described.
Open an Internet browser window on your PC (for best results, FireFox or Chrome are recommended)
(9)
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.
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.(10)
At the CH1 tab, verify the “Video Source” is set to “HDMI” using the dropdown menu. Always select(11)
HDMI to accept video from the Sony FCB-ER8300.
Change “Output Resolution” to “Follow Input”.(12)
Select the codec you would like to use for your encoding. Both H.265/HEVC and H.264/AVC are(13)
supported. In the pictured example, verify “Video Codec” is set to “H265(HEVC)”.
Set “Output Format” to “UDP”.(14)
You can set “Dest Address” to:(15)
(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).(16)
Click the green “Start” button.(17)

20
CONFIDENTIAL DOC-USR-0101-01
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
Figure 8 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