Z3 Technology Z3-DM368-ZDVR User manual

User’s Guide
Player and Recorder Application
High Definition Video Processor Module
DM368-ZDVR Rapid Prototyping System
Model Name: Z3-DM368-ZDVR
DOC-USR-0044-01
Manual Version 1.03.01
Software Version 1.03.01
December 13, 2013
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 Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
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
0.00.01
01/17/2010
Initial draft
BM
0.00.02
01/17/2010
Minor changes, JW feedback
BM
0.01.00
03/03/2011
Merge player and recorder along with helper commands. Simplify API.
Change product name to Z3-DVR to reflect rec/pb capability.
0.02.00
05/30/2011
Adjust per implementation
BM
0.03.00
06/03/2011
Continue to adjust as implemented
BM
0.04.00
10/31/2011
Edited document layout
CH
0.05.00
01/31/2013
Address update. Minor update.
PS
0.06.00
02/08/2013
Updated Section 7.2
PS
0.07.00
02/08/2013
Formatting, grammar review
MC
1.03.01
12/13/2013
Changed version number to reflect software version number, made some
formatting changes, added sections on untarring and building the code, added
more step-by-step instructions on doing a record and playback, added OSD
overlay details, added details on setting up TFTP/NFS, added example of boot
log, added to Troubleshooting.
RC

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
3
TABLE OF CONTENTS
1. General Description ......................................................................................... 5
2. Features ....................................................................................................... 7
2.1 Supported Input Resolutions ......................................................................... 7
2.2 Supported Output Resolutions ....................................................................... 7
3. Untarring and Building the Sample Code................................................................. 8
3.1 Preparing the Linux Environment ................................................................... 8
3.2 Making the Directories and Running the Make Script............................................. 8
4. Code Overview ..............................................................................................10
4.1 Software Overview....................................................................................10
4.2 Software Architecture................................................................................11
4.3 Software Interface....................................................................................11
5. Encoding and Playing Back a File.........................................................................12
5.1 Set up the Audio/Video Source .....................................................................12
5.2 Connect the Board....................................................................................12
5.3 Set up the Terminal Window........................................................................13
5.4 Power on the board...................................................................................13
5.5 Encode a stream ......................................................................................14
5.6 Play back a stream ...................................................................................14
5.7 Play stream on Windows Media Player ............................................................14
5.8 Option 1: Invoking the OSD overlay ...............................................................15
6. Running The Code You Built on the Board ..............................................................16
6.1 Method 1: Updating the Image File using an SD card...........................................16
6.2 Method 2: Running Your Code through TFTP/NFS...............................................18
6.3 Other available u-boot commands .................................................................22
7. ZDVR Command Summary .................................................................................23
7.1 Command Structure ..................................................................................23
7.2 prompt <string> .......................................................................................24
7.3 storage <block_device> | RELEASE.................................................................24
7.4 media ...................................................................................................25
7.5 space....................................................................................................25
7.6 record [file=<filename>] [time=<time_limit>] [vrate=<bit_rate>] ...........................26
7.7 play [file=]<filename>...............................................................................28
7.8 (File management commands)......................................................................29
Appendix A: Example of Successful Boot Log and Sample Run...........................................30
Appendix B: Troubleshooting..................................................................................33

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
4
LIST OF FIGURES
Figure 1 Z3-DM368-MOD......................................................................................... 5
Figure 2 Z3-DM368-ZDVR App Board .......................................................................... 6
Figure 3 Sample Content of Images Directory after Successful Build..................................... 9
Figure 4 ZDVR Software Architecture........................................................................11
Figure 5 Demo Connections for Z3-DM368-RPS .............................................................12
Figure 6 ZDVR Startup Message .............................................................................13
Figure 7 Graphics shown on screen as an overlay..........................................................15
Figure 8 Graphics with encoded video overlayed ..........................................................15
Figure 9 The ZWriter Main Menu.............................................................................16
Figure 10 Selecting the .img file .............................................................................17
Figure 11 Editing uboot_envDM368.txt .....................................................................20
Figure 12 Minicom Terminal Settings ........................................................................21
Figure 13 Minicom Paste File Selection......................................................................21
Figure 14 Example of Successful u-boot Configuration ...................................................22

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
5
1. 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:
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 2 HDMI inputs, 2 YPbPr component inputs, 2 analog
stereo audio inputs, an SD card jack and 2 bi-color LEDs. 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].
68 mm
44 mm
Figure 1Z3-DM368-MOD

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
6
Figure 2Z3-DM368-ZDVR App Board
Component In
Component Out
Composite In
Composite Out
Headphone Out
Serial
5V Power
MicroSD
GPIOs
HDMI Out
Ethernet
SD Card
USB

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7
2. Features
!H.264 video encode and decode up to 1080p30
!On-board standard definition video ADC with 2 composite inputs or 1 S-Video input
!On-board standard definition composite and high definition component inputs
!On-board stereo audio ADC/DAC with 6 line level inputs and 4 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 (3 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
2.1 Supported Input Resolutions
Composite: 480i29.97, 576i25
Component: 720p50, 720p60, 1280x768, 1280x800, 1080i50, 1080i60, 1080p25, 1080p30
2.2 Supported Output Resolutions
Composite: 480i29.97, 576i25
Component: 720p50, 720p60, 1280x768, 1280x800, 1080i50, 1080i60, 1080p25, 1080p30

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
8
3. Untarring 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 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
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-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 (note: could also be RPS-SRC, name may slightly vary).
# cp SW-3D2-00123-01_DM368-ZDVR-20131211.tar.bz2 /home/z3/z3-dm368
Untar the archive (name of tar file may slightly vary):
# tar -xvjf SW-3D2-00123-01_DM368-ZDVR-20131211.tar.bz2
Note: Untarring could take 5 to 10 minutes.
Then go into the directory just created and run the build script (directory name may slightly vary):
# cd z3-dm368-ZDVR-20131211
# ./makeall

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
9
Note: Building can take around 30-40 minutes. You will also need to type in the sudo password a few
times towards the end of 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 3 Sample Content of Images Directory after Successful Build

CONFIDENTIAL Z3-DM368-ZDVR V1.03.01
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
10
4. 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
4.1 Software Overview
The ZDVR consists of player and recorder applications. Both player and recorder accept simple, high level
commands in plain text from the serial port or console and provide relevant status information in return.
The command set allows for the quick configuration of elements such as capture resolution, encoding bit
rate, file names, etc., and should be sufficient for implementing most video playback and recording
applications. Both player and recorder are command-line driven applications designed so that they can be
executed via console commands or be set up to be automatically started when the system boots. The
simple nature of the command set makes it the ideal component to use in applications where the video
module is driven by another processor, typically the controller of the end application.
The player application provides a simple interface to playback previously recorded media files, allowing
the user to fast forward and reverse through the files at different speeds, move to the beginning of the
file, pause, resume and query playback information.
The recorder application effectively allows the use of advanced audio and video capture, compression and
storage without any knowledge of the many details of the media processing engine -- therefore enabling
quick time-to-market of media-enabled end systems.
Users of recorder are able to create files with compressed and synchronized audio and video into SD cards
or other external media with simple commands.