Z3 Technology Z3-DM8107-RPS User manual

User Instructions
Multi-Channel H.264 HD Multimedia System
High Definition Video Processor Module
DM8107 Rapid Prototyping System
Model Name: Z3-DM8107-RPS
DOC-USR-0012-03
Manual Version 1.2.6
Software Version v06 2012-04-20
March 7, 2013
Before attempting to connect or operate this product, please read these
instructions carefully and save the manual for future use.

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
2
Revision History
Version
Date
Change Note
Author
1.0
11/26/12
Original Document
NC
1.1
12/14/12
Minor Update to Section 5 and 6
PS
1.2
12/14/12
Formatted a few areas, see comments
MC
1.2.1
12/14/12
Added minor changes
AC
1.2.2
12/14/12
Added Sections 6-10
PS
1.2.3
2/11/13
Minor Update
PS
1.2.4
2/11/13
Formatting
MC
1.2.5
2/12/13
Minor Update
PS
1.2.6
3/7/13
Added list of items included in shipping
MC
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
3
CONTENTS
1. General Description................................................................................................... 4
2. Included Parts List..................................................................................................... 6
3. Features ................................................................................................................ 7
4. Applications............................................................................................................ 8
5. Thermal Considerations .............................................................................................. 9
6. Encode and Decode Demos .........................................................................................10
7. Installing the Released Materials...................................................................................15
8. Configuring the Target for Your Own Development Environment..............................................16
9. Building the Code ....................................................................................................19
9. UBIFS...................................................................................................................21
10. Dependencies .........................................................................................................22
11. Troubleshooting......................................................................................................23
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
4
1. General Description
The Z3-DM8107-RPS development system is comprised of both hardware and software. The hardware
provided includes one Z3-DM8107-MOD (system on module card), one Z3-DM8107-APP (carrier application
board), and the Z3-DM8168-APP-02 (provides advanced video input capabilities with dual channel HDMI or
component input at up to 1080i each).1. The bundled software includes all necessary components for the
user to develop its own advanced multimedia, graphics and DSP applications.
Measuring 88mm x 108mm the Z3-DM8107-MOD is a compact OEM-ready module, supporting H.264 codec
offering a single channel 1080p60 fps1(frames per second) encode or decode (stream or storage). This
module is 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
(DVR), medical video and industrial video. The Z3-DM8107-MOD features a unique expansion interface
comprised of five high density connectors providing access to the greatest majority of interface signals
available from the DM8107 processor. Figure 1 below shows the Z3-DM8107-MOD + Z3-DM8107-APP system.
1Performance may be limited to IVA clock settings
Figure 1
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
5
An example application board, Z3-DM8168-APP-02,is available from Z3 Technology and is included with the
Z3-DM8107-RPS system.This application board uses the I/O expansion capability of the Z3-DM8107-MOD
and Z3-DM8107-APP to implement additional functions not present in the base module. The Z3-DM8107-
APP is the carrier board to attach to the Z3-DM8168-APP-02. It equips the Z3-DM8107-MOD with Ethernet,
SATA, USB, 12 V Power, and serial input/output. The Z3-DM8168-APP-02 application board has two HDMI
inputs, two YPbPr component inputs, two 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 the Z3-
DM8168-APP-02 application board.
A Linux-based media SDK license, additional design services and support are available from Z3 Technology.
Please contact Z3 at http://www.z3technology.com or e-mail at [e-mail].
186mm
88mm
Figure 2
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
6
2. Included Parts List
1x 12V Power Supply
1x Serial Cable
1x Gender Change
1x Video Cable
1x HDMI Cable
1x Z3-DM8168-DEB-01
1x Cable Strip
1x Z3-DM8107-RPS-Lite Documentation
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
7
3. Features
High Density connectors to interface to all signals
Supports H.264 video encoding and decoding at up to 1080p601
1GB DDR3, 256MB NAND Flash
H.264at HD resolutions
Multiple interfaces including gigabit Ethernet, PCI Express, SATA2, DDR3, USB 2.0, MMC/SD, HDMI
and DVI
ARM Cortex-A8 Memory Architecture
Dual SATA interface supporting 3Gbps drives
RS232 serial console port
JTAG debug port
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
8
4. Applications
The Z3-DM8107-MOD is designed to facilitate the implementation of video and audio functions on media-
embedded applications such as broadcast video encoding and decoding, video security and industrial DVR,
medical and industrial video and video conferencing terminal and MCU. Its versatile design allows the
system designer to focus on the end application, with confidence that the Z3-DM8107-MOD will handle all
audio and video media operations required with little or no additional engineering effort. Whether the end
application requires encode or decode media from storage or streaming, the readily available, production-
ready Z3-DM8107-MOD will simplify the overall system design, reducing time to market and costs.
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
9
5. Thermal Considerations
The main processor on the Z3-DM8107-MOD generates a large amount of heat, and is cooled by a heat sink
type cooler. The heat sink may reach temperatures in excess of 75°C during work. 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-DM8107-MOD system during normal operation
should be less than 6W, with up to 5W dissipated by the main processor. Please plan the cooling strategy
appropriately.
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
10
6. Encode and Decode Demos
5.1 Encode Demo
The encode demo can support inputs from HDMI1, HDMI2, Component1 and Component2. The connections
are labeled below.
The Z3-DM8168-APP-02 will support two simultaneous video inputs: Channel 1 (HDMI or component) and
Channel 2 (HDMI or component).
The video source (we use a Brite-View box) must be a NON-HDCP source for HDMI input.
Video input resolutions currently supported2:
HDMI1/HDMI21: 1080p60, 1080p50, 1080i60, 720p60, 720p50, 576p, and 480p.
Note: The maximum resolutions on each channel are 720p60 or 1080i60 for two-channel encode.1
The System can be controlled via serial port on Z3-DM8107-MOD.
1. Plug in the supplied serial cable and NULL modem adaptor from Z3-DM8107-MOD to PC’s COM port.
2. Setup teraterm on PC for 115k, 8, N, 1, 0ms/char, 100ms/line.
3. Connect the other end of the serial cable to the console port on Z3-DM8107-MOD-01 board.
The console port is the 2.5mm jack next to the power switch.
4. Connect power supply to Brite-View Box.
5. Connect USB stick with content to Brite-View Box.
6. Set Brite-View Box’s resolution to HDMI Auto
7. Connect HDMI out of Brite-View Box to the HDMI1 (top input) of Z3-DM8168-APP-02 Application Board.
8. Connect Ethernet from Z3-DM8107-MOD to a PC.
9. Set the PC IP address to 192.168.1.110 – This is the default address the Z3-DM8107-RPS streams to.
10. Connect 12V Power supply to the Z3-DM8107-MOD.
*Before powering up the Z3-DM8107-RPS system, make sure the Brite-View Box is running.
2Additional resolutions will become available at a later date
Stereo 2
HDMI 2
Stereo1
HDMI 1
Component 2
Component 1
Figure 3
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
11
11. Open up a console window
12. Power on the Z3-DM8107-RPS system
13. After booting up and running through the beginning of the sequence, a system menu will appear.
Below is a screenshot of a terminal console of the system menu.
14. Press “S” to start streaming
15. Open VLC
16. Under Media, choose
17. You should now see video playing on VLC
*It is possible that you may need to reboot if you do not see video in VLC
5.2 Decode Demo From USB Stick
Step 1: Plug-in supplied USB stick from Z3 or contact Z3 Technology for content. The USB stick is 2GB in
capacity. It is formatted as FAT. It includes six files:
hd_other_artbeats_hd_library_demo_reel_2008_480p_30.h264
hd_other_artbeats_hd_library_demo_reel_2008_720p_30.h264
hd_other_lg_world_cities_paris_1080p_30.h264
hd_other_philips_urban_acrobat_480p_30.h264
snow_white_and_the_huntsman_480p_30.h264
thor_trailer_1080p_30.h264
The USB stick, when connected to the Z3-DM8107-MOD, will mount to the following location: /media/sda
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
12
Step 2: Once you power on your Z3-DM8107-MOD 4-channel decoder, you should see the following via Tera
Terminal.
Step 3: Once powered up, the demo content will start automatically (approximately 1 minute and 30
seconds).
Step 4: Follow the steps in section 4 to change the display settings.
5.3 Change Display Settings
Step 1: Press “Enter” to display the Run-Time Menu. The console should display the following:
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
13
Step 2: Press “4” to change the display settings. The console should display the following:
Step 3: Press “3” to change the layout of the output. The console should display the following:
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
14
Step 4: Press “2” or “9”
*Option 2 will display a 2x2 output. *Option 9 will display a Picture-in-Picture
output
Figure 4
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
15
7. Installing the Released Materials
The software provided will allow you to re-create the pre-installed software of the DM8107-MOD starting
from the source code included.
1)
On a PC running Linux, create a directory where the released materials are going to be located,
such as /home/z3/z3-dm8107:
# mkdir /home/z3/z3-dm8107
2) Copy the released tar archive to that directory.
# cp z3-dm8107-RELEASE_NAME.tar.bz2 /home/z3/z3-dm8107
3) Untar the archive.
# tar -xjf z3-dm8107-RELEASE_NAME.tar.bz2
4) A directory with the release name and a set of sub-directories should have been created as follows:
z3-dm8107/
a) build-tools Contains some scripts that simplify the setup
b) filesys This contains the root file system for the DM8107 target
c) kernels The kernel source tree, with added support for the Z3-DM8107-MOD HW
d) images Binary images needed by the target are here
e) toolchain ARM compilers, binutils and other build tools
f) u-boot The u-boot source tree, with support for the Z3-DM8107-MOD HW
g) z3apps Optional software licensed by Z3 Technology
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
16
8. Configuring the Target for Your Own Development Environment
The best way to develop for the Z3-DM8107 system is to use the HDD of a Linux PC to serve as the root file
system for the target. It is also productive to allow the DM8107 system to fetch the Linux kernel from the PC
using the network, so all the software that is being run by the DM8107 is in effect coming from the PC.
To accomplish this, follow the steps below.
1.) Run a TFTP server on the Linux PC. The target system will need to access files from the "images"
directory via TFTP. Depending on your Linux distribution you will need to download and set up the
server.
2.) The DM8107 module is pre-setup so that it will TFTP from the path "z3/z3-dm8107/images". This
path is defined in the target by the u-boot environment variable "tftp_root".
3.) Enable NFS on the Linux PC. The target DM8107 will need to mount the root file system using NFS.
Usually it is sufficient to add the desired path in the /etc/exports file, and restart the NFS service
(as root) with
# service nfs restart
4.) Copy the file .../u-boot/u-boot-env-centaurus.txt to the Windows PC running Teraterm. Edit the
file and change the following variables to match your own system and network. Note: Use a
Windows editor; it is important to Teraterm to have CR-LF instead of just LF.
setenv ipaddr 192.168.0.56
IP address of the target system
setenv gatewayip 192.168.0.1
Usually the router in your network
setenv netmask 255.255.0.0
As per your network parameters
setenv serverip 192.168.0.6
The computer with the TFTP server
setenv tftp_root z3/z3-dm8107/images
Location of the images folder in TFTP space
setenv nfs_root /home/z3/z3-
dm8107/filesys/fs
Location of the root file system
5.) Reboot the DM8107-MOD system and press the space bar to make it stop in the u-boot prompt.
Make sure that your terminal is pausing for 120ms or more at the end of each line.
This is important because the serial port does not have hardware flow control.
6.) Open Teraterm. Select the "Setup" menu. Select "Serial port".
Set the "Baud rate" to 115200, "Data" to 8 bit, "Parity" to none, 1 stop bit and flow control to "none"
At "Transmit delay" part, enter 120 in the box next to "msec/line", then click OK.
7.) Now upload the new environment variables to the board:
In Teraterm, go to the "File" menu and click on "Send file...".
Select the file with the variables that was just edited.
8.) When you get the u-boot prompt again, enter the commands below. This will enable mounting the
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
17
rootfs using NFS and booting the kernel by TFTP.
Z3-DM8107-MOD# setenv bootcmd run boot-nfs
Z3-DM8107-MOD# saveenv
9.) Make sure that the DM8107 is connected to your network and power cycle. If all went well, the
DM8107 system will boot the kernel obtained via TFTP from the Linux PC, mount a root file system
using NFS and present a "#" prompt. If not, then troubleshoot the connections, IP addresses and
server settings. Look in the .../images directory and make sure that the code is there. The root file
system for the target will be at .../filesys/fs.
8.1 U-boot Startup Scripts
The following u-boot startup scripts are available. Each set up the u-boot variables for a specific behavior.
To make the settings permanent, run 'saveenv'.
setenv bootcmd run boot-nfs
Obtains root file system from NFS, kernel from TFTP
setenv bootcmd run nand_boot_nfs
Obtains root file system from NFS, kernel from NAND
setenv bootcmd run nand_boot_jffs2
Obtains root file system from NAND (JFFS2 format), kernel from NAND
setenv bootcmd run
nand_boot_ramdisk
Obtains root file system from ramdisk, kernel from NAND
setenv bootcmd run nand_boot_ubifs
Obtains root file system from NAND (UBIFS format), kernel from NAND
8.2 U-boot Update Scripts
The following u-boot update scripts are available. These scripts just update the images - you must also set
the bootcmd above to use the proper image.
run update-uboot
Update U-Boot bootloader in NAND
run update-stage1
Update 1st stage bootloader (DDR and clock
setup)
run update-kernel
Update Linux kernel image
run update-env
Update U-Boot environment settings
run update-ramdisk
Update root filesystem ramdisk
run update-jffs2
Update JFFS2 root filesystem image (requires
mtd-utils on host)
run update-ubifs
Update UBIFS root filesystem image (requires
ubi utils on host)
8.3 Second Stage U-Boot Recovery Procedure
The 1st-stage boot-loader can be interrupted by hitting the 's' key at the serial console.
You will need to hold down the 'S' key before turning on power to the board as the check happens very
soon after power-up.
SW ECC selected
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
18
256 MiB
Using default environment
Net: cpsw
Z3-MIN#
Now you can update the 2nd-stage boot-loader by hand. (This step is similar to the 'update-uboot' rule
in the 2nd-stage boot-loader environment.)
Z3-MIN# setenv serverip 192.168.0.6
Z3-MIN# setenv loadaddr 0x81800000
Z3-MIN# setenv tftp_root 'z3/z3-dm8107/images'
Z3-MIN# setenv ubootfile 'u-boot.bin'
Z3-MIN# tftp ${loadaddr} ${tftp_root}/${ubootfile}
link up on port 0, speed 100, full duplex
Using cpsw device
TFTP from server 192.168.0.6; our IP address is 192.168.0.111
Filename 'z3/z3-dm8107/images/u-boot.bin'.
Load address: 0x81800000
Loading: ###########################################
done
Bytes transferred = 217276 (350bc hex)
Z3-MIN# nand erase 0x80000 0xc0000
NAND erase: device 0 offset 0x80000, size 0xc0000
Erasing at 0x120000 -- 100% complete.
OK
Z3-MIN# nand write.i ${loadaddr} 0x80000 0x80000
NAND write: device 0 offset 0x80000, size 0x80000
524288 bytes written: OK
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
19
9. Building the Code
Instructions to setup and build the full code base for the Z3-DM8107-MOD.
You will need sudo privileges in order to build the code. Make sure that the user account you are working
from is in the /etc/sudoers file and that you have the password.
The various variables of the system are all set up by default as if you are using the user account "z3". If you
create a "z3" account and use it to build the code then you will be able to execute the results of your build
without changing paths in the target system or elsewhere. It is not necessary to do so, but starting at the
right place can shorten the startup time.
First create a work directory (if you have not already done so) and cd to it.
mkdir ~/z3-dm8107
cd ~/z3-dm8107
Place release tar file in new directory and untar archive.
cp /your_tar_file_location/z3-dm8107-RELEASE_NAME.tar.bz2
tar -xjf z3-dm810-RELEASE_NAME.tar.bz2
Un-tar'ring the release should have created an intermediate directory with the release name (such as "z3-
dm8107-RELEASE_NAME"), please cd into it. In order to build the code, the current directory must contain
the project subdirectories "build-tools", "dvsdk", "kernels", "u-boot", etc.
Then run the following commands to build the system executables.
./build-tools/setup.sh
source z3-env
make z3_centaurus_defconfig
make clean
makeall.sh
make demos
Now all the executables are built and ready to run. All binaries and executables are in the images/
directory.
The target board must be able to access the files placed in the “images” directory of the project. Since the
default u-boot variables point to /home/z3/z3-dm8107, it is just easier to make symbolic link from there to
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702

CONFIDENTIAL Z3-DM8107-RPS V1.2.6
20
the project you are currently working on. If un-tar'ring the release created an intermediate directory with
the release name (such as "z3-dm8107-RELEASE_NAME as shown above"), then create symbolic links as shown
below so that the target default settings can find the images:
cd /home/z3/z3-dm8107
ln -s z3-dm8107-RELEASE_NAME/images images
ln -s z3-dm8107-RELEASE_NAME/filesys filesys
Make sure that the u-boot environment variables set on the target board match the locations of the
executables on your work directory and run the target board. By default, using the factory settings, the
target expects that the kernel image is available at z3/z3-dm8107/images/ (assuming that the root path set
at the TFTP server is /home) and that a root file system is available for mounting with NFS at /home/z3/z3-
dm8107/filesys/fs/.
It is important that you have the shell environment variables of the Linux PC you are working on set
correctly as set by the included batch file "z3-env". Every time you start a new shell you should set the
environment by running “source z3-env”. Among other things, this will set the environment variables
$PRJROOT and $ROOTFS to the appropriate paths.
___________________________________________________________________________________________
Z3 Technology, LLC ♦ 100 N 8th ST, STE 250 ♦ Lincoln, NE 68508-1369 U.S.A. ♦ +1.402.323.0702