Z3 Technology Z3-DM8168-RPS User manual

User Instructions
Multi-Channel H.264 HD Multimedia System
DM8168 Rapid Prototyping System
Model Name: Z3-DM8168-RPS
DOC-USR-0008-06
Manual Version 2.0.11b
Software Version 1.05.01
June 17, 2015
Before attempting to connect or operate this product, please read these instructions carefully and save the manual for future use.
© Copyright Z3 Technology, LLC. 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.

Revision History
Version
Date
Change Note
Author
0.1
02/02/11
Original DM8168 System
CH
0.2
02/09/11
Minor updates on page 4 and 5
AC
0.3
02/10/11
Fixed title. Major content update and re-arranging, formatting fixes and
other general improvements. Added some “to-do” tags for CH.
BM
0.4
02/17/11
Formatting fixes, revisions, added tables
CH
0.5
02/20/11
Paragraph & TOC indentation, Figure references
CH
0.6
05/17/11
Updated Encode Demo Instructions
CH
0.7
07/07/11
Updated the Encode Demo
NC
1.0
07/26/11
Updated Section 5
CH
1.1
08/09/11
Updated Section 5
AC
1.2
09/30/11
Updated Image and Section 5
CH
1.3
10/20/11
Updated for EZSDK 5.02 release
JTW
1.4
10/20/11
Updated Pictures
NS
1.5
10/24/11
Updated Section 5 & 10
CH
1.6
10/28/11
Updated Section 5
NS
1.7
10/28/11
Updated Pictures
NS
1.8
12/08/11
Updated Section 1
CH
1.9
01/19/12
Updated Sections 1 & 8. Added Section 11
CH
2.0.1
07/16/12
Address Update
NS
2.0.2
09/06/12
Correction revision number and typo in Section 5
NC
2.0.3
09/17/12
Updated Section 5, added Section 6 - Decode Demo
PS
2.0.4
09/17/12
Updated Footer
NS
2.0.5
12/27/12
Updated Section 7 Build Procedure
NB
2.0.6
01/02/13
Minor updates to all sections
PS
2.0.7
01/29/13
Format, Table of Contents
MC
2.0.8
04/18/13
Software update
PS
2.0.9
06/03/13
Corrections made on pgs. 20, 21
MC
2.0.10
11/22/13
Updated images, Added confidential information disclaimer
MC
2.0.11
11/25/13
Made formatting changes to fit new format of User’s Guides, added more
information.
RC
2.0.11a
06/01/15
Added Quick Start Guide, Included Parts List, Updated Formatting
KA
2.0.11b
06/17/15
Added SATA note in Section 4.0
KA

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
3
TABLE OF CONTENTS
1.0 GENERAL DESCRIPTION.................................................................................................6
2.0 QUICK START GUIDE ....................................................................................................9
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
3.0 INCLUDED PARTS LIST ................................................................................................ 10
4.0 FEATURES .............................................................................................................. 10
4.1 Supported Input Resolutions ..................................................................................... 10
4.2 Supported Output Resolutions ................................................................................... 10
5.0 UNTARRING AND BUILDING THE SAMPLE CODE.................................................................... 11
5.1 Preparing the Linux Environment................................................................................ 11
5.2 Making the Directories and Running the Make Script ......................................................... 11
6.0 CODE OVERVIEW ...................................................................................................... 13
6.1 EZSDK Documentation............................................................................................. 13
7.0 RUNNING THE ENCODER ............................................................................................. 14
7.1 Set up the HD Source.............................................................................................. 14
7.2 Connect the Board................................................................................................. 14
7.3 Set up the Terminal Window ..................................................................................... 15
7.4 Power on the Board ............................................................................................... 16
7.5 Ensure your PC has a proper IP address ........................................................................ 17
7.6 Run the Web Interface to Configure Encode................................................................... 17
7.7 Run VLC to View Stream .......................................................................................... 20
7.8 Streaming RTP...................................................................................................... 21
7.9 Encoding From Other Inputs ..................................................................................... 22
7.10 Showing Encode Passthrough on a Screen (Optional) ....................................................... 23
7.11 Tuning for Latency ............................................................................................... 24
8.0 RUNNING THE DECODER ............................................................................................. 25
8.1 Connect the Decoder Board ...................................................................................... 25
8.2 Set up the Decoder Board to Work with the Encoder Board................................................. 26
8.3 Configure the Encoder ............................................................................................ 27

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4
8.4 Configure the Decoder ............................................................................................ 28
9.0 RUNNING THE CODE YOU BUILT ON THE BOARD .................................................................. 29
9.1 Method 1: Updating the Image File ............................................................................ 29
9.2 Method 2: Running your code through TFTP/NFS ............................................................ 31
9.3 Other Available u-boot Commands .............................................................................. 36
10.0 EXERCISING OTHER FEATURES ..................................................................................... 37
11.0 SUMMARY OF OPTIONS .............................................................................................. 38
11.1 The Encoder Settings Tab ....................................................................................... 38
11.2 The Decoder Settings Tab ....................................................................................... 41
11.3 The System Setup Tab ........................................................................................... 42
11.4 The User Presets Tab............................................................................................. 42
11.5 Values Appearing at the Bottom of All Tabs .................................................................. 43
12.0 KNOWN ISSUES ....................................................................................................... 44
APPENDIX A: Example of Successful Boot Log ........................................................................ 45
APPENDIX B: Troubleshooting ........................................................................................... 53

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
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 ..............................................................................................6
Figure 2 Z3-DM8168-APP-02...............................................................................................7
Figure 3 Z3-DM8168-PCI-RPS Block Diagram ............................................................................8
Figure 4 Sample Content of Images Directory after Successful Build ............................................. 12
Figure 5 Demo Connections for the Z3-DM8168-RPS................................................................. 14
Figure 6 Demo Connections for the Z3-DM8168-RPS (Audio / Video Detail).................................... 14
Figure 7 Z3-DM8168-RPS Main Menu ................................................................................... 16
Figure 8 Encoder Settings Screen (Top Half).......................................................................... 18
Figure 9 Setting Encode Parameters for TS Streaming .............................................................. 19
Figure 10 VLC Network Screen Setting to Receive Z3 TS Stream .................................................. 20
Figure 11 Example of Z3 Video Streaming on VLC (UDP) ........................................................... 20
Figure 12 Example of Z3 Video Streaming to VLC (RTP) ............................................................ 21
Figure 13 Component and Composite Inputs ......................................................................... 22
Figure 14 Mapping of A/V Cable to Component Jacks............................................................... 22
Figure 15 Mapping of A/V Cable to Composite 1/2 .................................................................. 23
Figure 16 HDMI Out to Show Encode Passthrough.................................................................... 23
Figure 17 Tuning for Various Use Cases................................................................................ 24
Figure 18 Connecting the Z3-DM8168-RPS for Decode .............................................................. 25
Figure 19 New IP Address on Decoder ................................................................................. 26
Figure 20 Encoder Settings for Sample Decode ...................................................................... 27
Figure 21 Decoder Settings.............................................................................................. 28
Figure 22 Updating the Device Firmware from the Web Interface ................................................ 29
Figure 23 Browsing for the Image File in the Updater .............................................................. 30
Figure 24 Editing u-boot-env-netra.txt............................................................................... 33
Figure 25 Minicom Terminal Settings .................................................................................. 33
Figure 26 Minicom Paste File Selection................................................................................ 34
Figure 27 Example of Successful u-boot Configuration ............................................................. 34

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
6
1.0 GENERAL DESCRIPTION
The Z3-DM8168-RPS is a development system that allows encode and decode of up to two channels of
1080p60 H.264. The Z3-DM8168-RPS consists of a hardware package and software bundle designed to
enable rapid development of multimedia applications. The hardware consists of one Z3-DM816x-MOD-2x
System on Module card and one Z3-DM8168-APP-02 application board. The software bundle consists of the
necessary components for developing advanced multimedia, graphics, and DSP applications.
The Z3-DM816x-MOD-2x is a compact OEM module that enables encode or decode of up to two channels of
1080p H.264. Encode can be to stream and decode can be from stream or storage. It is well suited for
applications such as broadcast video encoding and decoding, digital signage and video kiosks, medical and
industrial video, video conference terminals and MCUs, and high-definition embedded video subsystems.
The Z3-DM816x-MOD-2x features a unique expansion interface consisting of five high density connectors
which provide access to most of the interface signals available from the DM8168 processor. Figure 1 below
shows the Z3-DM816x-MOD-2x System on Module:
Figure 1 Z3-DM816x-MOD-2x
88 mm
108 mm
HDMI
Out
GigE
SATA2
USB (x2)
12V
Power
A/V
Out
Serial
Power
switch and
LED
YPbPr
Out

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7
An application board, the Z3-DM8168-APP-02, is included with the Z3-DM8168-RPS.This application board
uses the I/O expansion capability of the Z3-DM816x-MOD-2x 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 the Z3-DM8168-APP-02 application
board:
Software licensing, additional design services, and support are available from Z3 Technology. Please
contact Z3 at www.Z3technology.com or e-mail at [e-mail].
Audio
1 and 2 In
HDMI
1 and 2
In
In
Component
1 and 2 in
SD Card
LEDs
88 mm
186 mm
Figure 2 Z3-DM8168-APP-02
JTAG

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
8
A block diagram of the Z3-DM8168-RPS follows:
Figure 3 Z3-DM8168-RPS Block Diagram

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
9
2.0 QUICK START GUIDE
2.1 If You Have Received a System from Z3 with the Software Preloaded
To start working with the encoder, you can skip to Section 7.0, “RUNNING THE ENCODER,”
on page 14. This section describes how to quickly generate a UDP or RTP stream to VLC and how to tune
for latency. Section 8.0, “RUNNING THE DECODER,” on page 25, describes how to use the decoder. If
you have any questions about any GUI parameters you can refer to Section 11.0, “SUMMARY OF
OPTIONS,” on page 38.
2.2 If You Already Have a System from Z3 and Need to Update the Firmware
You can update the firmware via the web GUI interface by following the instructions in Section 9.1
“Method 1: Updating the Image File” on page 29.
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 11. A brief overview of the code itself can be found in Section 6.0, “CODE
OVERVIEW,”on page 13. Details on how to set up your system to access the code you have built can be
found in Section 9.2, “Method 2: Running your code through TFTP/NFS”, on page 31.

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
10
3.0 INCLUDED PARTS LIST
1x Z3-DM8169-MOD-2x + 1x Z3-DM8168-APP-02
1x 12V 2A Power Supply
1x Serial Cable
1x Gender Changer
1x HDMI Cable
1x Z3-DM8168-DEBUG-0x
1x Cable Strip
4.0 FEATURES
Dual channel H.264 video encode and decode up to 1080p60
HDMI, Component, and Composite Input
HDMI Output (Component also available in some versions)
Gigabit Ethernet, Dual USB 2.0, Dual SATA2 (supporting 3Gbps), MMC/SD
1024 MB DDR3 (512 MB 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
4.1 Supported Input Resolutions
HDMI: 1080p60, 1080p50, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Component: 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 576p50, 576i25, 480p60, 480i30, and
480i29.97
Composite: 576i25, 480i29.97
4.2 Supported Output Resolutions
HDMI: 1080p60, 1080p50, 1080i30, 1080i25, 720p60, 720p50, 576p50, 576i25, 480p60, 480i30
Component: 1080i30, 1080i25, 720p60, 720p50, 576p50, 576i25, 480p60, 480i30
*Note: SATA3 is not supported.

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
11
5.0 UNTARRING AND BUILDING THE SAMPLE CODE
5.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
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-DM8168-RPS
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
Copy the released tar archive to that directory:
# cp SW-6E1-00022-01_DM8168-RPS-20130702.tar.bz2 /home/z3/z3-netra
Untar the archive:
# tar -xvjf SW-6E1-00022-01_DM8168-RPS-20130702.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- RPS-20130702
# ./makeall.sh

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
12
*Note: Building can take around 30-40 minutes. You will also need to type in the sudo password a few
times throughout the build.
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 4 Sample Content of Images Directory after Successful Build

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
13
6.0 CODE OVERVIEW
Once you have untarred the code, you will see the following top-level directories:
build-tools Config files and scripts for building the codebase
ezsdk A modified version of the TI EZSDK code
factory Factory testing scripts (the user can disregard these)
filesys The base filesystem for release
kernels Kernel code for release
sysapps Various supporting applications
toolchain The ARM toolchain for building the codebase
u-boot u-boot code for release
z3apps Z3 demo application code and scripts
6.1 EZSDK Documentation
Documentation on the EZSDK can be found in ezsdk/docs. Below is a list of the documentation
available:
docs
├── Readme.Overlay.txt
├── DM816x_EZ_Software_Developers_Guide.pdf
├── software_bom.htm
└── software_manifest.htm
Additional documentation can be found in the “board-support”, “component-sources”, and
“example_applications” subdirectories in ezsdk.

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
14
7.0 RUNNING THE ENCODER
This section gives step-by-step instructions on using the Z3-DM8168-RPS to stream 1080p or 1080i video to
VLC running on your PC.
7.1 Set up the HD Source
(1) Select an HD source with HDMI non-HDCP output (in Z3’s testing, the Brite-View BV-5005HD is used).
-Power on the HD Source
-Connect HDMI to a monitor
-Set the HD Source to 1080p or 1080i output
-Select content you would like to stream
7.2 Connect the Board
For these steps, please refer to Figure 5 and Figure 6.
HDMI In 2
HDMI In 1
Stereo
1
Stereo
2
Component
2
Component 1, or Composite 1 (Yellow) + Composite 2 (Red)
Figure 6 Demo Connections for the Z3-DM8168-RPS (Audio / Video Detail)
Serial
Power
Switch
12V In
Ethernet
See Figure 6 Detail
Figure 5 Demo Connections for the Z3-DM8168-RPS
HDMI
Out

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
15
(2) Connect the supplied 2.5mm serial cable and NULL modem adapter to your PC.
(3) Take the HDMI cable connected to the monitor and connect it to HDMI In 1 of the board.
(4) Connect the Ethernet.
The next step is to set up a terminal to view the activity of the board.
7.3 Set up the Terminal Window
(5) If you are running from a Windows PC, run TeraTerm. Select “Setup – Serial Port” and set the
following:
Port: Whichever serial port the port is connected to
Baud Rate: 115200
Data: 8-bit
Parity: None
Stop: 1-bit
Flow Control: None
(6) If you are running from Linux, type:
# 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”

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
16
7.4 Power on the Board
(7) Connect the 12V power supply and turn on the switch. If all is configured properly, you should see
the board booting up within the terminal window. After about a minute, you will see the RPS Main
Menu:
Note the local IP address and netmask (in this example, it is 192.168.81.68 and 255.255.0.0). This is
the IP address of the board. You will need this later to access the web interface.
Figure 7 Z3-DM8168-RPS Main Menu

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
17
7.5 Ensure your PC has a proper IP address
(8) To be able to communicate with the board, the PC that you are communicating from needs to have
at least the same first 2 parts of the IP address. For example, if the board has an IP address of
192.168.81.68, your PC would need to have an address of 192.168.x.y, where x.y is anything but
81.68 (and not conflicting with whatever is on your current network). Ensure that this is the case.
If necessary, use the “H” and “I” options in the RPS menu to modify the address / network mask of
the board to conform to your network. Note that the first 2 parts being the same are based on a
netmask of 255.255.0.0. If netmask were 255.255.255.0, then the first three parts of the IP
address would have to be the same.
After you are done, make note of the address you set your PC to. This will be important in the
streaming step.
7.6 Run the Web Interface to Configure Encode
(9) In your PC, run a web browser (for best results, Z3 recommends FireFox or Chrome). In this browser,
type the IP address of the board noted in step (7) (for example, if the default value is used, it
would be http://192.168.81.68). After about 3 seconds, the Encoder Settings will appear:

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
18
(10) In this menu, confirm that Video Source is set to “HDMI1(Top)” and Audio Source is set to
“Automatic”.
(11) Set “Output Format” to “MPEG-2 TS”and “Dest IP Address” to the IP address of your PC (in this
example, 192.168.0.6) Also make note of the value of “Dest Port” (should be 8888 by default):
Figure 8 Encoder Settings Screen (Top Half)

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
19
(12) Click “Start”. After about 6 seconds, The status should change from “idle” to “Running.”
Figure 9 Setting Encode Parameters for TS Streaming
(d) Click “Start” or “Restart”
(e) After clicking “start”, the
status should change to “Running”
(a) Change format to MPEG-2 TS
(b) Change Dest IP Address to PC IP address
(c) Note Dest Port (will use in VLC)

CONFIDENTIAL DOC-USR-0008-06
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
20
7.7 Run VLC to View Stream
(13) Run VLC on your PC (version used in testing at Z3: 2.05).
(14) Select Media –Open Network Stream. In the box, type “udp://@192.168.0.6:8888”, where
“192.168.0.6” is the IP address of your PC, and 8888 is the value of “Dest Port” noted in step (11).
(15) Press “Enter.”
(16) You should now see video streaming to VLC:
Figure 10 VLC Network Screen Setting to Receive Z3 TS Stream
Figure 11 Example of Z3 Video Streaming on VLC (UDP)