Z3 Technology Z3-DM816X-RPS RDK User manual

User’s Guide
Multi-channel H.264 HD Multimedia System
High Definition Video Processor Module
DM816X Multichannel Rapid Prototyping System
Model Name: Z3-DM816X-RPS RDK
DOC-USR-0026-02
Manual Version 2.01.19
Software Version 2.01.19
June 1, 2014
Before attempting to connect or operate this product, please read these
instructions carefully and save the manual for future use.
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.

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
2
Revision History
Version
Date
Change Note
Author
1.00.00
07/18/13
Initial Version
RL/RC
1.01.00
07/30/13
Added more information
RC
1.01.01
08/02/13
Formatting
MC
2.00.23
02/09/14
Updated to reflect latest version, added sections on RTP encode,
dynamically changing bit rate, TS rate, tuning for low latency, DHCP,
and performing a decode. Added parameter lists.
RC
2.00.23a
02/12/14
Corrected reference errors on pages 8 and 17, corrected figures on
pages 17 and 34.
RC
2.01.19
06/01/14
Changed name from DM816X-RPS RDK -> DM816X-RPS RDK. Updated
screenshots. Added info on ZFinder.
RC

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
3
TABLE OF CONTENTS
1General Description ........................................................................................ 7
2Features ...................................................................................................... 9
2.1 Supported Input Resolutions - Encoder ............................................................ 9
2.2 Supported Output Resolutions –Decoder .......................................................... 9
3Untarring and Building the Sample Code ............................................................... 10
3.1 Preparing the Linux Environment .................................................................. 10
3.2 Making the Directories and Running the Make Script ...........................................10
4Code Overview ............................................................................................. 12
4.1 The z3apps/rdk directory ...........................................................................12
4.2 Z3 Application Overview ............................................................................ 13
4.3 RDK documentation..................................................................................15
5Running the Encoder....................................................................................... 17
5.1 Set up the HD Source ................................................................................17
5.2 Connect the Board ...................................................................................17
5.3 Set up the Terminal Window........................................................................ 18
5.4 Power on the board .................................................................................. 18
5.5 Ensure your PC has a proper IP address...........................................................20
5.6 Run the Web Interface to Configure CH1 ......................................................... 20
5.7 Run VLC to View Stream ............................................................................ 22
5.8 Streaming RTP ........................................................................................ 23
5.9 Encoding from other inputs......................................................................... 24
5.10 Changing the bitrate dynamically ................................................................. 26
5.11 Adjusting the UDP TS Rate.......................................................................... 27
5.12 Tuning for Latency ...................................................................................30
5.13 Running DHCP......................................................................................... 30
6Running the Decoder ...................................................................................... 35
6.1 Connect the Decoder board ........................................................................ 35
6.2 Set up the Decoder board to work with the Encoder board ...................................36
6.3 Configure the Encoder...............................................................................37
6.4 Configure the Decoder ..............................................................................38
7Exercising Other Features ................................................................................ 40
8Running The Code You Built on the Board .............................................................. 41
8.1 Method 1: Updating the Image File ............................................................... 41
8.2 Method 2: Running Your Code through TFTP/NFS............................................... 43
8.3 Other available u-boot commands................................................................. 47
9Summary of Options ....................................................................................... 48

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4
9.1 The System Setup Tab ...............................................................................48
9.2 The User Presets Tab................................................................................. 49
9.3 The Status Tab ........................................................................................ 49
9.4 The CH1 Tab -- Encode ..............................................................................50
9.5 The CH1 Tab -- Decode ..............................................................................53
9.6 The CH2 Tab........................................................................................... 54
9.7 Values Appearing at the Bottom of All Tabs ......................................................54
Appendix A: Example of Successful Boot Log ..............................................................55
Appendix B: Troubleshooting .................................................................................66

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
5
LIST OF FIGURES
Figure 1 Z3-DM816X-MOD-2X Inputs and Outputs........................................................... 7
Figure 2 Z3-DM8168-APP-02 Inputs and Outputs............................................................ 8
Figure 3 Sample Content of Images Directory after Successful Build ..................................11
Figure 4 Z3-DM816X-RPS RDK Encode Example Connections.............................................17
Figure 5 Z3-DM816X-RPS RDK Encode Example Connections (Detail)...................................17
Figure 6 Z3-DM816X-RPS RDK Serial Menu (Top Part) .....................................................19
Figure 7 Web Interface Initial Screen .......................................................................20
Figure 8 Web Interface Channel 1 Configuration Tab ..................................................... 21
Figure 9 VLC Network Screen Setting to Receive Z3 TS Stream .........................................22
Figure 10 Example of Z3 Video Streaming on VLC......................................................... 22
Figure 11 Example of Z3 Video Streaming to VLC (RTP)..................................................23
Figure 12 Component and Composite Inputs ............................................................... 24
Figure 13 Mapping of A/V Cable to Component Jacks .................................................... 24
Figure 14 Mapping of A/V Cable to Composite 1/2........................................................ 25
Figure 15 Allowed Input Combinations on the Z3-DM816X-RPS RDK .................................... 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 Testing TS Rate ..................................................................................... 28
Figure 20 Status Tab ...........................................................................................29
Figure 21 TS Rate and Lower Bitrate Reflected in VLC ...................................................29
Figure 22 Tuning for Various Use Cases ..................................................................... 30
Figure 23 The User Presets Tab............................................................................... 30
Figure 24 Entering a User Preset Name .....................................................................31
Figure 25 Selecting “z3_test” within the System Setup Tab .............................................31
Figure 26 Setting DHCP within z3_test......................................................................31
Figure 27 Saving a User Preset ............................................................................... 32
Figure 28 Address Change after DHCP Set ..................................................................32
Figure 29 Using ZFinder to find the DHCP Address ........................................................33
Figure 30 ZFinder with Z3-DM816X-RPS RDK Selected ....................................................33
Figure 31 Using the New DHCP Address .....................................................................34
Figure 32 Z3-DM816X-RPS RDK Decode Connections ......................................................35
Figure 33 IP Address Change in Decoder .................................................................... 36
Figure 34 Encoder Settings for Sample Decode............................................................ 37
Figure 35 Changing to Decoder Mode ....................................................................... 38

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
6
Figure 36 Decoder System Setup Menu .....................................................................38
Figure 37 Decoder Settings ................................................................................... 39
Figure 38 Updating the Device Firmware from the Web Interface...................................... 41
Figure 39 Browsing for the Image File in the Updater .................................................... 42
Figure 40 Editing u-boot-env-netra-rdk.txt ...............................................................45
Figure 41 Minicom Terminal Settings ........................................................................ 45
Figure 42 Minicom Paste File Selection .....................................................................46
Figure 43 Example of Successful u-boot Configuration ...................................................46

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7
1General Description
The Z3-DM816X-RPS RDK is a development system that allows encode/decode of 1080p60 video to/from a
variety of different sources. It consists of both hardware and software. The hardware includes one Z3-
DM816X-MOD-2X System on Module card, and one Z3-DM8168-APP-02 application board. The bundled
software includes all necessary components for the user to develop their own advanced multimedia,
graphics and DSP applications.
Measuring 88mm x 108mm, the Z3-DM816X-MOD-2X is a compact OEM module which supports H.264
encode/decode at up to two channels of 1080p at 60 fps (frames per second). It supports encode and
stream and decode from stream or file. It is targeted for applications such as real time transcoding,
broadcast video encoding and decoding, digital signage and video kiosks, medical and industrial video,
video conference terminals and MCUs, and high definition embedded video sub-systems. The Z3-DM816X-
MOD-2X features a unique expansion interface comprised of five high density connectors providing access
to most of the interface signals available from the DM816X processor. Figure 1 below shows the Z3-
DM816X-MOD-2X System on Module:
Figure 1 Z3-DM816X-MOD-2X Inputs and Outputs
88 mm
108 mm
HDMI
Out
GigE
SATA
USB (x2)
12V
Power
A/V
Out
Serial
Power switch
and LED
YPbPr
Out

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
8
An application board, the Z3-DM8168-APP-02, is included with the Z3-DM816X-RPS RDK system.This
application board uses the I/O expansion capability of the Z3-DM816X-MOD to implement additional
functions not present in the base module. The Z3-DM8168-APP-02 application board has two HDMI inputs,
two YPbPr component inputs, two analog stereo audio inputs, an SD card jack, two bi-color LEDs for status
and a JTAG header to access the module’s on-board MSP430 processor. Figure 2 below shows an image of a
Z3-DM8168-APP-02 application board:
A Linux-based media SDK license, additional design services and support are available from Z3 Technology.
Please contact Z3 at http://www.z3technology.com or e-mail at [e-mail].
88mm
Audio
1 and 2 In
HDMI
1 and 2 In
In
Component
1 and 2 in
SD Card
LEDs
186mm
Figure 2 Z3-DM8168-APP-02 Inputs and Outputs

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
9
2Features
Dual channel H.264 video encode and decode up to 1080p60
HDMI, Component, and Composite Input
HDMI Output
Gigabit Ethernet, Dual USB 2.0, Dual SATA2 (supporting 3Gbps), MMC/SD
1024MB DDR3 (512MB option also available)
256 MB NAND Flash
Control through RS-232 serial port or HTTP
JTAG debug port
High density connectors to interface to all signals
2.1 Supported Input Resolutions - Encoder
HDMI: 1080p60, 1080p50, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Component: 1080p60, 1080p50, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Composite: 576i25, 480i30, and 480i29.97
2.2 Supported Output Resolutions –Decoder
HDMI: 1080p60, 720p60

CONFIDENTIAL DOC-USR-0026-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
10
3Untarring and Building the Sample Code
3.1 Preparing the Linux Environment
Prior to building the Z3 sample code, certain modules are required. In Ubuntu 10.x or later, the following
command can be used to get the required modules:
sudo apt-get install bison flex mtd-utils liblzo2-dev uuid-dev zlib1g-dev
libpcre3-dev autoconf autoconf-archive automake automake1.9 automake1.9-doc
libtool libtool-doc
In Fedora, the command would be:
sudo yum install bison flex mtd-utils mtd-utils-ubi lzo-devel libuuid-devel
pcre-devel automake automake17 automake14 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 ia32-libs
For 64-bit Fedora, you can type:
# sudo yum install glibc.i686
3.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-DM816X-RPS RDK
starting from the included source code.
On a PC running Linux, create a directory where the released materials are going to be located:
# mkdir /home/z3/z3-netra-rdk
Copy the released tar archive to that directory:
# cp SW-6R2-00218-01_DM8168-MC-RPS-SRC-20140508.tar.bz2 /home/z3/z3-netra-rdk
Untar the archive:
# tar -xvjf SW-6R2-00218-01_DM8168-MC-RPS-SRC-20140508.tar.bz2
Note: Untarring could take 5 to 10 minutes.
Then go into the directory just created and run the build script:
# cd z3-netra-DM8168-MC-RPS-SRC-20140508
# ./makeall
Note: Building can take around 30-40 minutes. You will also need to type in the sudo password a few