Z3 Technology Z3-DM368-VI-RPS User manual

User Instructions
Video Infrastructure 1080p30 System
High Definition Video Processor Module
DM368 Rapid Prototyping System
Model Name: Z3-DM368-VI-RPS
DOC-USR-0011-04
Manual Version 1.06.15a
Software Version 1.06.15
November 7, 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.
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
1.0
03/05/12
Original Z3-DM368-VI-RPS System
CH
1.04.15
05/31/12
Updated SW version
NC
1.04.16
07/16/12
Address Update
NS
1.04.17
10/04/12
Removed Linux SDK sentence
NC
1.04.18
02/11/13
Minor updates.
PS
1.04.19
02/11/13
Format
MC
1.06.03
01/28/14
Format, updated photos, instructions
MS
1.06.03a
01/29/14
Added resolutions, sections on running NFS/TFTP
RC
1.06.15
09/12/14
Added note on SDI output support in Section 1. Corrected “UDP” ->
“MPEG-2 TS” in Sections 7.7 and 7.8. Updated VLC version Section 7.7.
Added Sections 7.8 –7.10 on Using DHCP, Dynamically Changing Bitrate
and Framerate, and Tuning for Latency. Added Section 8 on Running
the Decoder. Added Section 9 on Writing to and Reading from File.
Added Section 10 on Writing and Reading JPEG files. Corrected update
image file name, removed unnecessary TFTP/NFS setup steps, and
added “-s” option for TFTP file in Section 12. Added “D1 Sharpness”
and “Use DHCP” and added to a few descriptions in Section 13. Added
RTP troubleshooting tip in Appendix C. Updated screenshots and
filenames throughout document.
RC
1.06.15a
11/07/14
Minor updates
KA

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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 .................................................................................................8
2.1 If you’ve received a system from Z3 with the software preloaded ......................................8
2.2 If you already have a system from Z3 and need to update the firmware ...............................8
2.3 If you are ready to start development .......................................................................8
3.0 INCLUDED PARTS LIST ...............................................................................................9
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
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 ........................................................................................... 15
7.5 Ensure your PC has a proper IP address .................................................................... 16
7.6 Run the Web Interface ........................................................................................ 16
7.7 Run VLC to View Stream ...................................................................................... 18
7.8 Streaming RTP ................................................................................................. 19
7.9 Using DHCP ..................................................................................................... 20
7.10 Dynamically changing bit rate / frame rate ............................................................... 21
7.11 Tuning for Latency............................................................................................. 21
8.0 RUNNING THE DECODER .......................................................................................... 22
8.1 Connect the Decoder Board.................................................................................. 22
8.2 Set up the Decoder Board to work with the Encoder Board............................................. 22
8.3 Configure the Encoder ........................................................................................ 23
8.4 Configure the Decoder........................................................................................ 24
8.5 Start the Encoder and Decoder.............................................................................. 25
9.0 WRITING TO AND READING FROM A FILE........................................................................ 26
10.0 WRITING AND READING JPEG FILES ............................................................................. 29
11.0 EXERCISING OTHER FEATURES ................................................................................... 31
12.0 RUNNING THE CODE YOU BUILT ON THE BOARD............................................................... 32
12.1 Method 1: Updating the Image File ........................................................................ 32
12.2 Method 2: Running Your Code through TFTP/NFS ........................................................ 34

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4
12.3 Other available u-boot commands .......................................................................... 37
13.0 SUMMARY OF OPTIONS ............................................................................................ 38
13.1 Options in Both the Encoder and Decoder ................................................................. 38
13.2 Encoder Options ............................................................................................... 38
13.3 Decoder Options ............................................................................................... 41
14.0 APPENDIX A: Example of Successful Boot Log ................................................................ 42
15.0 APPENDIX B: Updating using an SD card....................................................................... 45
16.0 APPENDIX C: Troubleshooting ................................................................................... 46

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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-DM368-MOD ...................................................................................................6
Figure 2 Z3-DM368-APP-04 ................................................................................................7
Figure 3 Sample Content of Images Directory after Successful Build ............................................. 12
Figure 4 Connections for Encoding from HDMI ....................................................................... 14
Figure 5 Serial UI Main Menu............................................................................................ 15
Figure 6 Web Interface Main Screen ................................................................................... 16
Figure 7 Modifications for Encoding .................................................................................... 17
Figure 8 VLC Open Network Screen .................................................................................... 18
Figure 9 Example of Z3 Video Streaming to VLC (UDP) ............................................................. 18
Figure 10 Example of Z3 Video Streaming to VLC (RTP) ............................................................ 19
Figure 11 Using DHCP .................................................................................................... 20
Figure 12 Saving “Use DHCP” ........................................................................................... 20
Figure 13 Finding DHCP-assigned IP Address in the Serial UI ....................................................... 21
Figure 14 Tuning for Latency............................................................................................ 21
Figure 15 Connections for Decoding to SDI ........................................................................... 22
Figure 16 Encoder Settings for Decoder Example.................................................................... 23
Figure 17 Changing to Decoder Mode.................................................................................. 24
Figure 18 Settings for Decode Example ............................................................................... 24
Figure 19 Connections for Encoding from Component .............................................................. 26
Figure 20 File Read/Write Main Menu ................................................................................. 27
Figure 21 Running JPEG Encode ........................................................................................ 29
Figure 22 Running JPEG Decode ........................................................................................ 30
Figure 23 Updating the Device Firmware from the Web Interface ................................................ 32
Figure 24 Browsing for the Image File in the Updater .............................................................. 33
Figure 25 Editing uboot_envDM368.txt ............................................................................... 35
Figure 26 Minicom Terminal Settings .................................................................................. 36
Figure 27 Minicom Paste File Selection................................................................................ 36
Figure 28 Example of Successful u-boot Configuration ............................................................. 37

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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-DM368-VI-RPS development system consists of both hardware and software. The hardware provided
includes one Z3-DM368-MOD system on module card and a carrier or application board, the Z3-DM368-APP-
04, which provides advanced video input and output capabilities. The bundled software includes all
necessary components for the user to develop their own advanced multimedia, graphics and DSP
applications.
Measuring only 44 x 68mm, the Z3-DM368-MOD is the most compact production-ready DM368 based video
encoder / decoder system-on-module on the market. The module supports high definition video input and
analog audio input. It also supports a micro-SD card socket, USB 2.0, Ethernet, a real-time clock and an IR
sensor.
The Z3-DM368-MOD features a unique edge connector design which supplies all interfaces native to the
DM368 to an application board mate, including I2C, SPI, LCD, USB, Serial, SD/MMC/MS, digital video, digital
audio, analog composite and component video. Figure 1 Below shows the Z3-DM368-MOD:
Figure 1 Z3-DM368-MOD
68 mm
44 mm

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7
An application board, the Z3-DM368-APP-04 is included with the Z3-DM368-VI-RPS.It measures 114 x
203mm. This application board uses the I/O expansion capability of the Z3-DM368-MOD to implement
additional functions not present in the base module. The Z3-DM368-APP-04 application board has HD-SDI,
HDMI, DVI, Component, Composite and VGA inputs, Ethernet, ASI, and SDI outputs, and one L/R pair of
analog stereo audio inputs. It also includes an SDI output for displaying video. Figure 2 below shows an
image of a Z3-DM368-APP-04 application board.
A Linux-based SDK, additional design services, and support are available from Z3 Technology. Please
contact Z3 at http://www.z3technology.com or e-mail at [e-mail].
Figure 2 Z3-DM368-APP-04
Top: RS-232
Bottom: VGA In
Analog
Audio In
Top: Composite In
Bottom: Component Y In
Top: ASI/SDI Out
Bottom: Component Pb In
HDMI In
Ethernet
Top: SDI/ASI In
Bottom: Component Pr In
12V
Power
114mm
SD Card
Power
Switch
USB
Status LEDs
203 mm

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
8
2.0 QUICK START GUIDE
2.1 If you’ve received a system from Z3 with the software preloaded
To start working with the Z3-DM368-VI-RPS, you can go straight to Section 7.0, “RUNNING THE
ENCODER,” on page 14, or Section 8.0, “RUNNING THE DECODER,” on page 22.A description of
how to save to a file and play back that file can be found in Section 9.0, “WRITING TO AND
READING FROM A FILE”, on page 26.
2.2 If you already have a system from Z3 and need to update the firmware
You can update the firmware via SD Card by following the instructions in Section 12.0, “RUNNING
THE CODE YOU BUILT ON THE BOARD,” on page 32.
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.
Details on how to set up your system to access the code you have built can be found in Section
12.1, “Method 1: Updating the Image File,” on page 32.

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
9
3.0 INCLUDED PARTS LIST
1 x Z3-DM368-MOD-01 + 1 Z3-DM368-APP-04
1 x 12V Power Supply
1 x DB-9 Serial Cable
1 x RCA to RCA Cable
3 x BNC to BNC Cables
1 x Z3-368-VI-RPS Documentation

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
10
4.0 FEATURES
H.264 video encode and decode up to 1080p30
Composite, Component, SDI, HDMI, and VGA inputs
Support streaming to Ethernet or DVB-ASI
Support streaming in RTP or UDP formats
Integrated resizer scales captured video to many different resolutions to allow maximum flexibility
when streaming
SDI video output
Ethernet, USB 2.0, SD Card interfaces
RS232 serial console port
Low power consumption
4.1 Supported Encoder Resolutions
SDI: 1080p30, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576i25,
480i30, and 480i29.97
HDMI: 1080p30, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Component: 1080p30, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Composite: 576i25, 480i30, and 480i29.97
VGA: 1280x1024, 800x600
4.2 Supported Output Resolutions
SDI: 1080p30, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576i25,
480i30, and 480i29.97
*Note: 1080p60 is not supported. For 1080p60 support, please see Z3’s DM81xx line of products.

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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 gstreamer-tools libglib2.0-dev mono-gmcs gperf
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 gstreamer-tools
glib2-devel mono-core gperf
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-DM368-VI-
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-dm368
Copy the released tar archive to the directory
*Note: the name may vary slightly. Could also be RPS-SRC
# cp SW-3D1-00278-01_DM368-VI-RPS-20140911.tar.bz2 /home/z3/z3-dm368
Untar the archive (name of tar file may slightly vary):
# tar -xvf SW-3D1-00278-01_DM368-VI-RPS-20140911.tar.bz2
*Note: Untarring could take 5 to 10 minutes.
Open the directory just created and run the build script (directory name may slightly vary):
# cd z3-dm368-VI-RPS-20140911
# ./makeall

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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 during 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
Figure 3 shows a sample result. Actual filenames, dates, and times will differ.
Figure 3 Sample Content of Images Directory after Successful Build

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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
dvsdk The DM368 DVSDK from TI with changes for Z3 Technology hardware
filesys The root file system for the DM368 target
flash_utils The UBL and a tool to write it into the board’s NAND flash
kernels The kernel source tree, with added support for the Z3-DM368-MOD
sysapps Source code for the system applications placed in the basic root file system
toolchain ARM compilers, binutils and other build tools
u-boot The u-boot source tree, with support for the Z3-DM368-MOD
z3apps Z3 demo applications, drivers, and utilities

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
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 taking the Z3-DM368-VI-RPS and using it 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 output and set it to output either 1080i or 1080p30.
7.2 Connect the Board
For these steps, please refer to Figure 4.
(2) Connect the supplied DB9 serial cable to a PC and to the serial port of the Z3-DM368-VI-RPS.
(3) Connect the HDMI source to HDMI In on the Z3-DM368-VI-RPS with an HDMI cable.
(4) Connect the Ethernet of the board to either a PC or a hub the PC is connected to.
The next step will demonstrate how to set up a terminal to view the activity of the board
Ethernet
Figure 4 Connections for Encoding from HDMI
12V Power
HDMI
Serial
(top)

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
15
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: The serial port that is connected
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/ttyS0”)
-Set option E (“Bps/Par/Bits”) to 115200 8N1
-Press <return>
-Select “Exit”
7.4 Power on the board
(7) Connect the 12V power supply and turn the power switch on. You should see the board booting
up within the terminal window. The RPS Main Menu will appear:
Figure 5 Serial UI Main Menu

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
16
Figure 6 Web Interface Main Screen
*Note- the local IP address and netmask (in this example, it is 192.168.0.65 and 255.255.0.0). This
is the IP address of the board. You will need this later to access the web interface.
7.5 Ensure your PC has a proper IP address
(8) To be able to communicate with the Z3-DM368-VI-RPS, 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 RPS has an IP
address of 192.168.0.65, your PC would need to have an address of 192.168.x.y, where x.y is
anything but “0.65”(and not conflicting with your current network). Note that the first 2 parts
being the same are based on a value of netmask of 255.255.0.0. If netmask were
255.255.255.0, for example, then the first 3 parts of the IP address would have to be the same.
Make note of the address where your PC is set. This will be important when streaming.
7.6 Run the Web Interface
(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 (8) (If the default value is used, it
would be http://192.168.0.65). The main screen should come up:

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
17
Figure 7 Modifications for Encoding
(10) Change Video Source to “HDMI”, change Video Resolution to “1920x1080”, and set “Output
Format” to “MPEG-2 TS”. Change “Dest Address” to the IP address of your PC (typical value is
192.168.0.6) and change the value of “Dest Port” to 5004:
(11) Click “Start Encoder. ”The status should change to “Started.”
*Note: The encoder may have already started as it will automatically start in 30 seconds if a
valid input is detected. If that occurs, click “Stop Encoder” first.
(b) Change Video
Resolution to
“1080i”
(c) Change Output Format to
“MPEG-2 TS”
(d) Change Dest
IPAddress to
PC IPAddress
(e) Change Dest
Port to 5004
(f) Click “Start Encoder”
(a) Change input to HDMI

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
18
7.7 Run VLC to View Stream
(12) Run VLC on your PC (version used in testing at Z3: 2.1.3)
(13) Select Media –Open Network Stream. In the box, type “udp://@192.168.0.6:5004”, where
“192.168.0.6” is the IP address of your PC.
(14) Press “Enter.”
(15) You should now see video streaming to VLC:
Figure 9 Example of Z3 Video Streaming to VLC (UDP)
Figure 8 VLC Open Network Screen

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
19
7.8 Streaming RTP
Once you have UDP streaming running, it is relatively simple to change to RTP streaming. All that is
needed are a change of settings and an SDP file (an example file is provided with the software
release from Z3). To stream using RTP, complete the following steps:
(16) Click on “Stop Encoder” to stop the current encoding session.
(17) Change “Output Format” from “MPEG-2 TS” to “RTP” (see Figure 7).
(18) Confirm that “Dest Port” (see Figure 7) is 5004 (this will be important for the VLC
configuration).
(19) Click on “Start Encoder” to start the RTP encoding session.
(20) Copy the file “z3-dm368_5004.sdp” received from Z3 to your PC.
(21) Open VLC. Select “Media – Open File” and select the “z3-dm368_5004.sdp” file that was
copied.
(22) You should then see RTP video streaming on VLC:
Figure 10 Example of Z3 Video Streaming to VLC (RTP)

CONFIDENTIAL DOC-USR-0011-04
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
20
7.9 Using DHCP
The Z3-DM368-VI-RPS also supports using DHCP to acquire an IP address at boot-up. To use this
setting, complete the following steps:
(23) Click the “Use DHCP” check box in the Web GUI. Once it is checked, you will see that the
values of Local IP Address, Local Netmask, and Default Gateway will gray out:
(24) Click on “Save User”. Wait a couple seconds for the “Saved all to User” message to appear:
(25) Power off the Z3-DM368-VI-RPS.
(26) Power on the Z3-DM368-VI-RPS. Wait about one minute for the “ready” LED to turn on.
(1) Click “Save User”
(2) Wait for “Saved all to User” to appear in status
Figure 12 Saving “Use DHCP”
Figure 11 Using DHCP
(2) Values gray out
(1) Check “Use
DHCP”