Z3 Technology Z3-DM8148-MC-RPS Instruction Manual

Developer’s Guide
Multi-Channel H.264 HD Multimedia System
High Definition Video Processor Module
DM8148 Multichannel Rapid Prototyping System
Model Name: Z3-DM8148-MC-RPS
DOC-USR-0024-01
Manual Version 2.00.02
Software Version 2.00.02
August 23, 2013
Before attempting to connect or operate this product, please read these
instructions carefully and save the manual for future use.

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
2
Revision History
Version
Date
Change Note
Author
0.0.1
09/20/11
Original Document
CH
0.0.2
10/11/11
Formatting changes. Updated images.
CH
0.0.3
11/28/11
Added section 7.3
CH
0.0.4
02/13/12
Added Troubleshooting Section
CH
0.0.5
07/16/12
Updated address
NS
1.1.0
10/04/12
Removed Linux SDK sentence, modified version # for production
NC
1.2.0
07/15/13
Formatting changes, corrections on p.9 and p.13
RC
1.2.1
07/25/13
Formatting changes
MC
2.0.2
08/19/13
Updated to reflect GUI support, added more detail on demo setup.
Changed version to match software release
RC

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
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. Thermal Considerations.............................................................................................................................8
4. Untarring and Building the Sample Code................................................................................................ 9
4.1 Preparing the Linux Environment....................................................................................................9
4.2 Making the Directories and Running the Make Script .................................................................. 9
5. Code Overview .......................................................................................................................................... 11
5.1 The z3apps/rdk directory ............................................................................................................... 11
5.1.1 rdk_demo................................................................................................................................ 11
5.1.2 z3_mcfw_api ..........................................................................................................................12
5.1.3 z3.............................................................................................................................................. 12
5.2 RDK documentation .........................................................................................................................12
6. Running the Demos ...................................................................................................................................14
6.1 Set up the HD Source....................................................................................................................... 14
6.2 Connect the Board ...........................................................................................................................14
6.3 Set up the Terminal Window ..........................................................................................................15
6.4 Power on the board .........................................................................................................................16
6.5 Ensure your PC has a proper IP address .......................................................................................17
6.6 Run the Web Interface to Configure CH1..................................................................................... 17
6.7 Run VLC to View Stream .................................................................................................................19
7. Running the Decode Demo ...................................................................................................................... 20
8.1 Connect the Output .........................................................................................................................20
8.2 Set up the System ............................................................................................................................ 20
8.3 Set up input files..............................................................................................................................20
8.4 Run the demo....................................................................................................................................21
8. Exercising Other Features .......................................................................................................................25
9. Running The Code You Built on the Board ............................................................................................26
8.1 Method 1: Updating the Image File .............................................................................................26
8.2 Method 2: Running Your Code through TFTP/NFS .....................................................................28
8.3 Other available u-boot commands................................................................................................33
Appendix A: Example of Successful Boot Log ............................................................................................34
Appendix B: Troubleshooting ........................................................................................................................43

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
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-DM8148-MOD-2X................................................................................... 5
Figure 2 Z3-DM8168-APP-02 I/O Board ....................................................................... 6
Figure 3 Sample Content of Images Directory after Successful Build .................................. 10
Figure 4 Demo Connections for Z3-DM8148-MC-RPS ...................................................... 14
Figure 5 Demo Connections for Z3-DM8148-MC-RPS (Audio / Video Detail) ......................... 14
Figure 6 DM8148-MC-RPS Main Menu ........................................................................ 16
Figure 7 Web Interface Initial Screen ....................................................................... 17
Figure 8 Web Interface Channel 1 Configuration Tab ..................................................... 18
Figure 9 VLC Network Screen Setting to Receive Z3 TS Stream ......................................... 19
Figure 10 Example of Z3 Video Streaming on VLC......................................................... 19
Figure 11 HDMI Out and USB on the Z3-DM8148-MOD-2X ................................................. 20
Figure 12 Main Screen for Demo to Run Decoder.......................................................... 22
Figure 13 Example Decode from File to Screen (Default Layout) ....................................... 22
Figure 14 Decoder Run-Time Menu .......................................................................... 23
Figure 15 Example Decode from File to Screen (2x2 Layout)............................................ 23
Figure 16 Example Settings for 4 Channel Decode ........................................................ 24
Figure 17 Example Output for 4 Channel Decode ......................................................... 24
Figure 18 Updating the Device Firmware from the Web Interface...................................... 26
Figure 19 Browsing for the Image File in the Updater .................................................... 27
Figure 20 Editing u-boot-env-centaurus-rdk.txt .......................................................... 30
Figure 21 Minicom Terminal Settings ........................................................................ 31
Figure 22 Minicom Paste File Selection ..................................................................... 31
Figure 23 Example of Successful u-boot Configuration ................................................... 32

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
5
1. General Description
The Z3-DM8148-MC-RPS is a development system that allows multiple channel encode and decode of HD
video. It can encode up to 2 channels of 1080i30 (30 frames per second, 60 fields per second) video, or 1
channel of 1080p60 (60 frames per second). The Z3-DM8148-MC-RPS consists of a hardware package and
software bundle designed to enable rapid development of multimedia applications. The hardware consists
of one Z3-DM8148-MOD-2X System on Module card and one Z3-DM8168-APP-02 advanced I/O board. The
software bundle consists of the necessary components for developing advanced multimedia, graphics, and
DSP applications.
The Z3-DM8148-MOD-2X is a compact OEM module. It is especially suited for power-sensitive applications
requiring a single video stream. These applications include broadcast video encoding and decoding, video
surveillance and security, industrial digital video recorders (DVRs), and medical video. The Z3-DM8148-
MOD-2X features a unique expansion interface comprised of five high density connectors providing access
to most of the interface signals available from the DM8148 processor. Figure 1 below shows the Z3-
DM8148-MOD-2X System on Module:
Figure 1 Z3-DM8148-MOD-2X
88 mm
108 mm
HDMI Out
GigE
SATA
USB (x2)
12V
Power
A/V Out
Serial
Power switch
and LED

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
6
An application board, the Z3-DM8168-APP-02, is included with the Z3-DM8148-MC-RPS.This application
board uses the I/O expansion capability of the Z3-DM8148-MOD-2X to implement additional functions not
present in the base module. The Z3-DM8168-APP-02 application board has 2 HDMI inputs, 2 YPbPr
component inputs, 2 analog stereo audio inputs, an SD card jack, 2 bi-color LEDs for status and a JTAG
header to access the module’s on-board MSP430 processor. Figure 2 below shows an image of the Z3-
DM8168-APP-02 application board:
Software licensing, additional design services, and support are available from Z3 Technology. Please
contact Z3 at http://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 I/O Board
JTAG

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
7
2. Features
Single channel H264 video encode and decode up to 1080p60
Dual channel H264 video encode up to 1080i30
HDMI and Component I/O
Gigabit Ethernet, Dual USB2.0, Dual SATA2 (supporting 3Gbps), MMC/SD
512MB DDR3
256 MB NAND Flash
Control through RS-232 serial port or HTTP
JTAG debug port
High density connectors to interface to all signals
2.1 Supported Input Resolutions
HDMI: 1080p60, 1080p50, 1080i30, 1080i29.97, 1080i25, 720p60, 720p59.94, 720p50, 576p50,
576i25, 480p60, 480i30, and 480i29.97
Component: 1080i30, 1080i29.97, 720p60, 720p59.94, 480p60, 480i30, and 480i29.97
2.2 Supported Output Resolutions
HDMI: 1080p60, 720p60

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
8
3. Thermal Considerations
The main processor on the Z3-DM8148-MOD-2X generates a large amount of heat, and is cooled by a heat
sink. The heat sink may reach temperatures in excess of 75°C during operation. Please make sure that the
airflow for the heat sink is free and unimpeded at all times. Hot air must have a place to escape to allow
for room air to be used to cool the chip. Failure to do so may result in permanent damage to the processor.
The maximum continuous power consumption by the whole Z3-DM8148-MOD-2X system during normal
operation should be less than 18W, with up to 12W dissipated by the main processor. Please plan the
cooling strategy appropriately.

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
9
4. Untarring and Building the Sample Code
4.1 Preparing the Linux Environment
Prior to building the Z3 sample code, certain modules are required. In Ubuntu 10.x, 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
4.2 Making the Directories and Running the Make Script
The software provided will allow you to re-create the pre-installed software of the DM8148-MC-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-dm814x
Copy the released tar archive to that directory:
# cp SW-5R1-00055-01_DM8148-MC-RPS-20130820.tar.bz2 /home/z3/z3-dm814x
Untar the archive:
# tar -xvjf SW-5R1-00055-01_DM8148-MC-RPS-20130820.tar.bz2
Note: Untarring could take 5 to 10 minutes.
Then go into the directory just created and run the build script:
# cd z3-centaurus-dm814x_MC-RPS-20130819
# ./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.

CONFIDENTIAL Z3-DM8148-MC-RPS V2.00.02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
10
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