Z3 Technology Z3-DM368-RPS User manual

User’s Guide
Low-Power H.264 HD Multimedia System
High Definition Video Processor Module
DM368 Rapid Prototyping System
Model Name: Z3-DM368-RPS
DOC-USR-0049-03
Manual Version 1.06.13c
Software Version 1.06.13
December 16, 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.00.00
06/03/09
Original
AC
1.00.01
06/05/09
Many corrections, additions, formatting, suggestions
BM
1.01.00
06/06/09
Corrections
AC
1.02.00
10/21/09
Updating information
BM
1.03.00
02/05/10
Updated version from Z3-DM365 to Z3-DM368
AC
1.04.00
09/25/10
Updated Basic Setup and Software Menu System sections
AC
1.05.00
07/09/13
Updated format and technical info
RC
1.06.00
07/11/13
Formatting, Doc P/N
MC
1.06.03
11/11/13
Updated to same format as other Z3 User’s Guides, updated information to
reflect latest release.
RC
1.06.13
05/07/14
Updated screenshots, made correction on p.5 and various corrections in
Encode section, updated VLC version used. Added sections on DHCP,
dynamically changing bit rate and frame rate, tuning for latency, running
the decoder, writing to and reading from file, and encoding / decoding
JPEG.
RC
1.06.13a
05/09/14
Added two notes on updating firmware
RC
1.06.13b
5/14/14
Formatting, review & update images
TB
1.06.13c
12/16/14
Added Block diagram in Section 1.0 and Section 2.0 Quick Start Guide,
Modified Section 7.11, added Hardware Warranty in Appendix C, formatting
KA
“Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These
limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates uses and can
radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful
interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct
the interference by one or more of the following measures:—Reorient or relocate the receiving antenna.—Increase the separation between the
equipment and receiver.—Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.—Consult the
dealer or an experienced radio/TV technician for help.”

3
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
TABLE OF CONTENTS
1.0 GENERAL DESCRIPTION.................................................................................................. 5
2.0 QUICK START GUIDE ..................................................................................................... 8
2.1 If You Have 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 –Encode ............................................................................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..................................................................................................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 ............................................................................................19
7.8 Streaming RTP........................................................................................................20
7.9 Using DHCP............................................................................................................21
7.10 Dynamically Changing Bit Rate/ Frame Rate ...................................................................23
7.11 Adjusting for Latency and Quality ...............................................................................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 ...................................................25
8.3 Configure the Encoder ..............................................................................................26
8.4 Configure the Decoder ..............................................................................................27
8.5 Start the Encoder and Decoder ....................................................................................28
9.0 WRITING TO AN READING FROM A FILE ..............................................................................29
10.0 WRITING AND READING JPEG FILES .................................................................................31
11.0 EXERCISING OTHER FEATURES .......................................................................................33
12.0 RUNNING THE CODE YOU BUILT ON THE BOARD ..................................................................34
12.1 Method 1: Updating the Image File ..............................................................................34

4
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
12.2 Method 2: Running your Code through TFTP/NFS..............................................................36
12.3 Other Available u-boot Commands...............................................................................41
13.0 SUMMARY OF OPTIONS................................................................................................42
13.1 The Encoder Settings Tab .........................................................................................42
13.2 The Decoder Settings Tab .........................................................................................44
13.3 Both Encode and Decode ..........................................................................................45
APPENDIX A: Example of a Successful Boot Log.........................................................................46
APPENDIX B: Updating Using an SD Card .................................................................................49
APPENDIX C: Troubleshooting .............................................................................................50
LIST OF FIGURES
Figure 1 Z3-DM368-MOD .................................................................................................... 5
Figure 2 Z3-DM368-RPS App Board ........................................................................................ 6
Figure 3 Z3-DM368-RPS Block Diagram ................................................................................... 7
Figure 4 Sample content of Images Directory after Successful Build ...............................................12
Figure 5 Z3-DM368-RPS Encode Connections ...........................................................................14
Figure 5 Mapping of A/V Cable to Component Jacks ..................................................................15
Figure 7 Z3-DM368-RPS Serial UI Main Menu............................................................................16
Figure 8 Web Interface Main Menu (Top Part)..........................................................................17
Figure 9 Example Settings for Running the Encoder...................................................................18
Figure 10 VLC Network Screen Setting to Receive Z3 TS Stream ....................................................19
Figure 11 Example of Z3 Video Streaming on VLC (UDP) .............................................................19
Figure 12 Example of Z3 Video Streaming on VLC (RTP)..............................................................20
Figure 13 Using DHCP ......................................................................................................21
Figure 14 Saving “Use DHCP” .............................................................................................21
Figure 15 Finding DHCP-assigned IP Address in the Serial UI.........................................................22
Figure 16 Finding DHCP-assigned IP Address in ZFinder ..............................................................22
Figure 17 Web GUI using DHCP Address .................................................................................23
Figure 18 Tuning for Various Use Cases .................................................................................24
Figure 19 Z3-DM368-RPS Decode Connections..........................................................................25
Figure 20 Encoder Settings for Decoder Example......................................................................26
Figure 21 Changing to Decoder Mode....................................................................................27
Figure 21 Settings for Decode Example .................................................................................27
Figure 22 File Read/Write Main Menu ...................................................................................29
Figure 24 Running JPEG Encode ..........................................................................................31
Figure 25 Running JPEG Decode..........................................................................................32
Figure 26 Updating the Device Firmware from the Web Interface ..................................................34
Figure 27 Browsing for the Image File in the Updater ................................................................35
Figure 28 Editing u-boot_envDM368.txt ................................................................................38
Figure 29 Minicom Terminal Settings ....................................................................................39
Figure 30 Minicom Paste File Selection .................................................................................39
Figure 31 Example of Successful u-boot Configuration ...............................................................40

5
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
1.0 GENERAL DESCRIPTION
Measuring only 44x68mm, the Z3-DM368-MOD is the most compact production-ready DM368 based video
encoder / decoder system-on-module on the market. The module has on-board high definition analog
component output, standard definition NTSC/PAL composite video input and output, as well as stereo audio
input and output. It also includes 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:
68 mm
44 mm
Figure 1 Z3-DM368-MOD

6
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
An application board, the Z3-DM365-APP, is included with the Z3-DM368-RPS.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-DM365-APP application board has component in/out and A/V (composite + dual
analog) in /out. There is also an SD card, micro SD card, and USB jack. Figure 2 on the next page shows
the Z3-DM365-APP 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-RPS App Board
Component In
Component Out
A/V In
A/V Out
Headphone Out
Serial
5V Power
MicroSD
GPIOs
HDMI Out
Ethernet
SD Card
USB

7
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
The figure below shows a block diagram of the Z3-DM368-RPS system.
Figure 3 Z3-DM368-RPS Block Diagram

8
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
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 go straight to Section 7.0, “RUNNING THE ENCODER,” on
page 14. Using the decoder is described in Section 8.0, “RUNNING THE DECODER” on page 25. Finally, a
summary of each parameter that can be configured in the GUI is given in Section 13.0, “SUMMARY OF
OPTIONS,” on page 42.
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 12.1,
“Method 1: Updating the Image File,” on page 34.
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 12.0:
“RUNNING THE CODE YOU BUILT ON THE BOARD”, on page 34.

9
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
3.0 INCLUDED PARTS LIST
1 x Z3-DM368-MOD-01 + 1 Z3-DM365-APP-03
1 x 5V Power Supply
1 x Serial Cable
1 x Gender Changer (to connect to serial cable)
2 x Video Cables
1 Content SD Card
1 x Z3-368-RPS Documentation

10
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4.0 FEATURES
H.264 video encode and decode up to 1080p30
On-board standard definition video ADC with two composite inputs or one S-Video input
On-board standard definition composite and high definition component inputs
On-board stereo audio ADC/DAC with six line level inputs and four outputs
Low power consumption
Built-in Ethernet MAC, on-board PHY
USB 2.0 OTG support
Edge Connector Expansion:
oDigital Video input interface for use with CMOS sensors or other devices
oDigital Video output interface for use with LCD or other devices
oComposite Video input/output
oComponent Analog Video output
oStereo Audio input (three sets of stereo inputs)
oStereo Audio output, line level plus independent output for headphones
oFast Ethernet I/O
oTwo MMC/SD card ports (one with support for Memory Stick)
oTwo UARTs for serial interface
oGeneral Purpose I/O
oSPI and I2C ports
4.1 Supported Input Resolutions –Encode
Composite: 576i25, 480i30, and 480i29.97
Component: WQVGA , QVGA, SIF, CIF, 2SIF, 2-CIF, 640x360, VGA, 4CIF, PAL PAR 12:11, 576i25,
480i29.97, 16:9 PAL, 4/5 720p, 720p, 3/4 1080i, 1080p, and 1080i
4.2 Supported Output Resolutions
Composite: 576i25, 480i30, and 480i29.97
Component: 1080i30, 1080i29.97, 720p60, 720p59.94, 480p60, 480i30, and 480i29.97

11
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
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-DM368-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 that directory:
# cp SW-3D1-00219-01_DM368-RPS-20140507.tar.bz2 /home/z3/z3-dm368
Untar the archive:
# tar -xvjf SW-3D1-00219-01_DM368-RPS-20140507.tar.bz2
Note: Untarring could take 5 to 10 minutes.
Then go into the directory just created and run the build script:
# cd z3-dm368-RPS-20140507
# ./makeall
Note: Building can take around 30-40 minutes. You will also need to type in the sudo password a few
times throughout the build.

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

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

14
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.0 RUNNING THE ENCODER
This section gives step-by-step instructions on taking the Z3-DM368-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 component output (such as a Blu-Ray player).
-Power on the HD Source
-Connect component 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.
(2) Connect the supplied 2.5mm serial cable and NULL modem adapter to your PC.
Figure 5 Z3-DM368-RPS Encode Connections
Component In
Serial
5V Power
Ethernet
A/V In

15
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
(3) Take the component cable and connect it to Component In of the board. The red/white/yellow maps
to the red/blue/green of Component as follows:
(4) If there is audio, connect it to the red and white audio connectors on the source. Use the red and
white connectors on the video cable (leave the yellow connector unconnected). Connect the
2.5mm end to “A/V In.”
(5) 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
(6) If you are running from a Windows PC, run TeraTerm. Select “Setup – Serial Port” and set the
following:
Port: The serial port the port is connected to
Baud Rate: 115200
Data: 8-bit
Parity: None
Stop: 1-bit
Flow Control: None
(7) 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”
Figure 6 Mapping of A/V Cable to Component Jacks

16
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.4 Power on the Board
(8) Connect the 5V 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.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.
Figure 7 Z3-DM368-RPS Serial UI Main Menu

17
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.5 Ensure your PC has a Proper IP Address
(9) To be able to communicate with the board, the PC that you are communicating from needs to have
at least the same first two parts of the IP address. For example, if the board 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 whatever is on your current network, of course). Ensure that this is the
case. If necessary, use the “P” and “Q” options in the RPS menu to modify the address / network
mask of the board to conform to your network. Note that the first two 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 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
(10) 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) (for example, if the default value is used, it
would be http://192.168.0.65). After 3 seconds, the Encoder Settings menu should come up:
Figure 8 Web Interface Main Menu (Top Part)

18
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
(11) Change “Video Source” to Component, “Video Resolution” to “Follow Input,” and “Output Format”
to “MPEG-2 TS”.
(12) Change “Dest Address” to the IP address of your PC (in this example, 192.168.0.6). Also change
“Dest Port” to “5004”:
(13) Click “Start.” The status should change to “Started.”
Figure 9 Example Settings for Running the Encoder
(1) Change input to Component
(2) Change Video
Resolution to
“Follow Input”
(3) Change Output Format to
MPEG-2 TS
(4) Change Dest
IP Address to
PC IP Address
(5) Change Dest
Port to 5004
(6) Click “Start
Encoder”
(7) Status changes to “Started”

19
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.7 Run VLC to View Stream
(14) Run VLC on your PC (version used in testing at Z3: 2.1.0).
(15) 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, and 5004 is the value of “Dest Port” noted in step (12).
(16) Press “Enter.”
(17) 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)

20
CONFIDENTIAL DOC-USR-0049-03
____________________________________________________________________________________
Z3 Technology, LLC ♦100 N. 8th St. STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7.8 Streaming RTP
Once you have UDP streaming, 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, do the following steps:
(18) In the Encoder settings tab, click on “Stop” to stop the current encoding session.
(19) Change “Output Format” from “MPEG-2 TS” to “RTP.”
(20) Confirm that “Dest Port” (see Figure 9) is 5004 (this will be important for the VLC configuration).
(21) Click on “Start Encoder” to start the RTP stream.
(22) Copy the “z3-dm368_5004.sdp” file received from Z3 to your PC.
(23) Open VLC. Select “Media – Open File” and select the “z3-dm368_5004.sdp” file you just copied.
(24) You should then see RTP video streaming on VLC:
Figure 12 Example of Z3 Video Streaming on VLC (RTP)