Z3 Technology Z3-DM368-SDI-RPS User manual

User Instructions
Video Infrastructure 1080p30 System
High Definition Video Processor Module
DM368 Rapid Prototyping System
Model Name: Z3-DM368-SDI-RPS
DOC-USR-0064-02
Manual Version 1.06.19a
Software Version 1.06.19
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.

CONFIDENTIAL DOC-USR-0064-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
1.0
04/24/12
Original Z3-DM368-SDI-RPS System
CH
1.06.16
09/29/14
Modified format to be in line with other DM368 User’s Guides.
Made document more robust.
RC
1.06.17
10/02/14
Updated screenshots and filenames for 1.06.17, added section
on encoding MP1L2
RC
1.06.19
12/08/14
Added Psf note in Section 4.1. Modified table heading in Section
7.11. Added Section 7.12 on RTMP streaming. Added a note on
MAC addresses in Section 8.2. Updated screenshots and
filenames for 1.06.19.
RC
1.06.19a
12/16/14
Block diagram in Section 1.0, Latency note in 7.11, HW Warranty
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.”

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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 .................................................................................................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
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 .................................................................... 16
7.6 Run the Web Interface........................................................................................ 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 ............................................................... 22
7.11 Tuning for Latency............................................................................................. 23
7.12 Streaming RTMP................................................................................................ 24
7.13 Encoding Using MP1L2 Audio ................................................................................. 27
8.0 RUNNING THE DECODER.............................................................................................. 28
8.1 Connect the Decoder Board.................................................................................. 28
8.2 Set up the Decoder Board to work with the Encoder Board............................................. 28
8.3 Configure the Encoder ........................................................................................ 29
8.4 Configure the Decoder........................................................................................ 30
8.5 Start the Encoder and Decoder.............................................................................. 31
9.0 EXERCISING OTHER FEATURES....................................................................................... 32
10.0 RUNNING THE CODE YOU BUILT ON THE BOARD............................................................... 33
10.1 Method 1: Updating the Image File ........................................................................ 33
10.2 Method 2: Running Your Code through TFTP/NFS ........................................................ 35
10.3 Other Available u-boot Commands .......................................................................... 38
11.0 SUMMARY OF OPTIONS ............................................................................................ 39
11.1 Options in Both the Encoder and Decoder ................................................................. 39
11.2 Encoder Options ............................................................................................... 39
11.3 Decoder Options ............................................................................................... 42
APPENDIX A: Example of Successful Boot Log ........................................................................ 43
APPENDIX B: Configuring the Wowza Server for RTMP .............................................................. 46
APPENDIX C: Updating using an SD Card .............................................................................. 48
APPENDIX D: Troubleshooting ........................................................................................... 49

CONFIDENTIAL DOC-USR-0064-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-DM368-MOD ...................................................................................................5
Figure 2 Z3-DM368-APP-11 ................................................................................................6
Figure 3 Z3-DM368-SDI-RPS Block Diagram..............................................................................7
Figure 4 Sample Content of Images Directory After a Successful Build........................................... 12
Figure 5 Connections for Encoding from SDI.......................................................................... 14
Figure 6 Serial UI Main Menu............................................................................................ 16
Figure 7 Web Interface Main Screen ................................................................................... 17
Figure 8 Modifications for Encoding ................................................................................... 18
Figure 9 VLC Open Network Screen.................................................................................... 19
Figure 10 Example of Z3 Video Streaming to VLC (UDP)............................................................ 19
Figure 11 Example of Z3 Video Streaming to VLC (RTP) ............................................................ 20
Figure 12 Using DHCP .................................................................................................... 21
Figure 13 Saving “Use DHCP” ........................................................................................... 21
Figure 14 Finding DHCP-assigned IP Address in the Serial UI ....................................................... 22
Figure 15 Tuning for Latency............................................................................................ 23
Figure 16 Configuring for RTMP Encode ............................................................................... 24
Figure 17 Getting to the Wowza Test Player.......................................................................... 25
Figure 18 Viewing Content in Wowza .................................................................................. 26
Figure 19 Example of Encoding using MP1L2 ......................................................................... 27
Figure 20 Connections for Decoding to SDI ........................................................................... 28
Figure 21 Encoder Settings for Decoder Example.................................................................... 29
Figure 22 Changing to Decoder Mode.................................................................................. 30
Figure 23 Settings for Decode Example ............................................................................... 30
Figure 24 Updating the Device Firmware from the Web Interface ................................................ 33
Figure 25 Browsing for the Image File in the Updater .............................................................. 34
Figure 26 Editing uboot_envDM368.txt ............................................................................... 36
Figure 27 Minicom Terminal Settings .................................................................................. 37
Figure 28 Minicom Paste File Selection................................................................................ 37
Figure 29 Example of Successful u-boot Configuration ............................................................. 38
Figure 30 Wowza Performance Settings................................................................................ 46
Figure 31 Wowza Security Settings ..................................................................................... 47

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
5
1.0 GENERAL DESCRIPTION
The Z3-DM368-SDI-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-11, 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 44x68mm, 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-0064-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-DM368-APP-11, is included with the Z3-DM368-SDI-RPS.It measures 100mm x
190mm. 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-11 application board has HD-SDI,
and composite (CVBS) inputs, Ethernet and ASI outputs, and one L/R pair of analog stereo audio inputs.
Figure 2 below shows an image of a Z3-DM368-APP-11 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-11
100 mm
SD Card
Power
Switch
Ethernet
Status LEDs
190 mm
12V
Power
Serial
Port
ASI
Out
SDI
In
CVBS
In
Analog Audio
In

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

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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 have Received a System from Z3 with the Software Preloaded
To start working with the Z3-DM368-SDI-RPS, you can go straight to Section 7.0, “RUNNING THE
ENCODER,”on page 14, or Section 8.0, “RUNNING THE DECODER,” on page 28.
2.2 If you already have a System from Z3 and Need to Update the Firmware
You can update the firmware by following the instructions in Section 10.1, “Method 1: Updating the
Image File,” on page 33.
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 10.1,
“Method 1: Updating the Image File,” on page 33.

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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-11
1 x 12V Power Supply
1 x DB-9 Serial Cable
1 x BNC to BNC Cable
1 x RCA to RCA Cable
1 x Z3-368-SDI-RPS Documentation

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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
Note: 1080p60 is not supported. For 1080p60 support, please see Z3’s DM81xx line of products.
Composite and SDI 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
Ethernet, SD Card interfaces
RS232 serial console port
Low power consumption
4.1 Supported Input Resolutions- Encode
SDI: 1080p30, 1080i30, 1080i29.97, 1080i25, 1080720p60, 720p59.94, 720p50, 576i25,
480i30, and 480i29.97. Also supports 23.98Psf input for all resolutions.
Composite: 576i25, 480i30, and 480i29.97

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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-SDI-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-3D1-00314-01_DM368-SDI-RPS-20141028.tar.bz2 /home/z3/z3-dm368
Untar the archive (name of tar file may slightly vary):
# tar -xvf SW-3D1-00314-01_DM368-SDI-RPS-20141028.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-SDI-RPS-20141028
# ./makeall
*Note: Building can take around 30-40 minutes. You will also need to type in the sudo password a
few times during the build.

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
12
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. Actual filenames, dates, and times will differ.
Figure 4 Sample Content of Images Directory After a Successful Build

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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-0064-02
___________________________________________________________________________________________
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-SDI-RPS and using it to stream 1080p30
or 1080i video to VLC running on your PC.
7.1 Set up the HD Source
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 5.
Connect the supplied DB9 serial cable to a PC and to the serial port of the Z3-DM368-SDI-RPS.
Connect an SDI source to “SDI In” on the Z3-DM368-SDI-RPS with a BNC-BNC cable.
Connect the Ethernet of the Z3-DM368-SDI-RPS to either a PC or a hub the PC is connected to.
The next step is to set up a terminal to view the activity of the board.
Figure 5 Connections for Encoding from SDI
Ethernet
12V
SDI In
Serial

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
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
If you are running from a Windows PC, run TeraTerm. Select “Setup – Serial Port” and set the
following:
Port: Whichever serial port the port is connected to
Baud Rate: 115200
Data: 8-bit
Parity: None
Stop: 1-bit
Flow Control: None
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”

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
16
7.4 Power on the Board
Connect the 12V power supply and turn on the switch. 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.
7.5 Ensure your PC has a proper IP address
To be able to communicate with the Z3-DM368-SDI-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 whatever is on your current network, of course).
Ensure that this is the case. 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.
After you are done, make note of the address you set your PC to. This will be important in the
streaming step.
Figure 6 Serial UI Main Menu

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
17
Figure 7 Web Interface Main Screen
7.6 Run the Web Interface
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 (7) (for example, if the default value is
used, it would be http://192.168.0.65). After about 3 seconds, the main screen should come up:

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
18
Figure 8 Modifications for Encoding
Change “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:
Click “Start Encoder”(note: The encoder may have already started as it will automatically start in
30 seconds if a valid input is detected. If that occurs, just click “Stop Encoder” first). The status
should change to “Started.”
(b) Change Dest
IPAddress to
PC IPAddress
(a) Change Output Format to
“MPEG-2 TS”
(c) Change Dest
Port to 5004
(d) Click “Start Encoder”

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
19
7.7 Run VLC to View Stream
Run VLC on your PC (version used in testing at Z3: 2.1.3)
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.
Press “Enter.”
You should now see video streaming to VLC:
Figure 10 Example of Z3 Video Streaming to VLC (UDP)
Figure 9 VLC Open Network Screen

CONFIDENTIAL DOC-USR-0064-02
___________________________________________________________________________________________
Z3 Technology, LLC ♦100 N 8th ST, STE 250 ♦Lincoln, NE 68508-1369 USA ♦+1.402.323.0702
20
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:
Click on “Stop Encoder” to stop the current encoding session.
Change “Output Interface” to “Ethernet (VBR)” (this is necessary to allow RTP as an Output
Format) (see Figure 8).
Change “Output Format” from “MPEG-2 TS” to “RTP” (see Figure 8).
Confirm that “Dest Port” (see Figure 8) is 5004 (this will be important for the VLC configuration).
Click on “Start Encoder” to start the RTP encoding session.
Copy the file “z3-dm368_5004.sdp” received from Z3 to your PC.
Open VLC. Select “Media – Open File” and select the “z3-dm368_5004.sdp” file you just copied.
You should then see RTP video streaming on VLC:
Figure 11 Example of Z3 Video Streaming to VLC (RTP)