Page 2
CONFIDENTIAL DOC-USR-0008-06p Revision History Version Date Change Note Author 02/02/11 Original DM8168 System 02/09/11 Minor updates on page 4 and 5 02/10/11 Fixed title. Major content update and re-arranging, formatting fixes and other general improvements. Added some “to-do” tags for CH. 02/17/11 Formatting fixes, revisions, added tables 02/20/11...
RDK Documentation ................... 16 RUNNING THE ENCODER ..................19 Set up the HD Source ..................19 Connect and Power Up the Z3-DM8168-RPS..............19 Set up the Terminal Window ................. 20 Power on the Board ................... 21 Ensure your PC has a Proper IP Address ..............22 Run the Web Interface to Configure CH1 ..............
Page 4
APPENDIX A: Example of a Successful Boot Log ..............63 APPENDIX B: Configuring the Wowza Server for RTMP .............. 73 APPENDIX C: Troubleshooting ................... 75 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 5
Figure 28 Address Change after DHCP Set ................34 Figure 29 ZFinder with Z3-DM8168-RPS DHCP Address .............. 35 Figure 30 Selecting Z3-DM8168-RPS w/ DHCP Address in ZFinder ..........35 Figure 31 Web GUI Using DHCP Address ................35 Figure 32 Using the Aux TS File Enable Option ............... 36 Figure 33 Allowed Input Combinations on the Z3-DM8168-RPS ............
Page 6
CONFIDENTIAL DOC-USR-0008-08 Figure 36 Getting to the Wowza Test Player ................40 Figure 37 Viewing Z3-DM8168-RPS Content on Wowza .............. 41 Figure 38 Connecting the Z3-DM8168-RPS for Decode .............. 42 Figure 39 Changing to Decoder Mode .................. 43 Figure 40 System Setup in Decoder Mode ................43 Figure 41 Decoder Configuration Settings for Decode Example ...........
DOC-USR-0008-08 GENERAL DESCRIPTION The Z3-DM8168-RPS is a set of hardware boards, software tools, and applications designed to enable the rapid development of media-centric applications. It contains one Z3-DM8168-MOD-2x System on Module card, one Z3-DM8168-APP-0x application board, as well as bundled software with all of the necessary components for the user to quickly develop their own advanced multimedia, graphics, and DSP applications.
186 mm Figure 2 Z3-DM8168-APP-0x The Z3-DM8168-RPS software is based on the Linux OS. The kit comes with all of the low-level resources such as the Linux kernel, u-boot, tool chain and starter file system pre-integrated and configured. There is no need to port or integrate OS functions, media functions etc.
# 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-DM8168-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-netra-rdk Copy the released tar archive to that directory (note: the name may slightly vary).
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 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Z3 demo application code and scripts The Z3 application code that comes with the Z3-DM8168-RPS-RDK is run from the run.sh script in dvr- rdk/dvr_rdk/bin/ti816x . This code calls the z3_dvr_rdk_demo_mcfw_api.out binary, which initializes and runs the encoder. This binary is built from the dvr-rdk directory. The code for the binary resides in z3apps/rdk/rdk_demo.
.ini out of /tmp and save it. The command line interface for the encoder is set up by running: # source /opt/mcsenc/mcsenc.sh ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
This section gives step-by-step instructions on taking the Z3-DM8168-RPS and using it to stream 1080p or 1080i video to VLC running on your PC. In addition to the Z3-DM8168-RPS, an HD source with HDMI output and a PC are required.
-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” ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(8) 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: Figure 7 Z3-DM8168-RPS Serial Menu ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(10) Click on “Open Device.” An Internet browser window is opened (default browser used is Firefox) and the Web GUI appears at the System Setup tab: Figure 8 Z3-DM8168-RPS Web GUI (System Setup Page) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8...
-The encoder automatically starts 20 seconds after booting up. If it has already started, it may be necessary to click “stop” before clicking “start.” ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(16) Press “Enter.” (17) You should now see video streaming to VLC: Figure 11 Example of Z3 Video Streaming to VLC (UDP) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(20) Click on “start” to start the RTP encoding session. At this point your settings should look like the following: Change to “RTP” Figure 12 Channel 1 Configuration Screen – RTP ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(22) In the “Open Media” box, type “rtsp://{IP Address}/z3-{ch #}{m}.mp4”, where {IP Address} is the IP address of the Z3-DM8168-RPS, {ch #} is 1 for CH1 and 2 for CH2, and {m} is added if a multicast address is being streamed. For example, if the IP address of the Z3-DM8168-RPS is the default value of 192.168.81.68, encode is being done from CH1, and unicast streaming is being done, the...
DOC-USR-0008-08 7.9 Changing the Bitrate Dynamically The Z3-DM8168-RPS includes an “Update” button which allows you to change the bitrate or frame rate without stopping and restarting the encoder. To use this feature, complete the following steps: (1) In VLC, click on “Tools” and select “Codec Information.” This brings up a window with four tabs.
The parameter “Frame Rate Divider” can also be updated dynamically using the “update” button. All other parameters require a stop and then start to change. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
DOC-USR-0008-08 7.10 Adjusting the UDP TS Rate The Z3-DM8168-RPS includes a parameter to adjust the TS rate independent of the video bitrate. This can be found just below “PMT PID” when “UDP” is selected as the output format. Normally, this value is set to 25% to 33% above the sum of the video and audio bitrate. For example, the default value out of the factory is a value of 10Mbps, corresponding to 8Mbps for the video.
(8) The value of TS Rate must be higher than (video bitrate + audio bitrate) * 1.25. If an attempt is made to input a value less than this, the error message “TS rate too small to carry elementary streams” will appear. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
By default, this is set to 1000ms. You can lower this to as low as 200ms. To do this, go to the following: VLC → Tools → Preferences → Show Settings (ALL) → Input / Codecs → Network caching (ms) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
DOC-USR-0008-08 7.12 Running DHCP DHCP is also supported. When enabled, the Z3-DM8168-RPS dynamically receives an IP address to use at startup. The IP address that is assigned can be seen through the ZFinder tool running on a PC. To view...
(13) Now that DHCP is set in z3_config1, save the configuration by clicking on the “Save” button: Click “Save” Figure 26 Saving a User Preset ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Figure 28 Address Change after DHCP Set (16) The second method is to use the Windows utility ZFinder. To do this, confirm the Windows PC with ZFinder is connected to the same network in which the Z3-DM8168-RPS is connected. ___________________________________________________________________________________________ Z3 Technology, LLC ♦...
(1) Select Z3-DM8168-RPS (2) Click “Open Device” Figure 30 Selecting Z3-DM8168-RPS w/ DHCP Address in ZFinder (19) A web browser will then open at the IP address of the Z3-DM8168-RPS and you will see the Web GUI: New IP address Figure 31 Web GUI Using DHCP Address (20) You can return to Static IP by unchecking “Use DHCP”...
“/media/sda1/enc_dm8168-rps.ts” would save to “enc_dm8168-rps.ts” on that drive. Sample values are shown below: (1) Set to “True” (2) Set file name Figure 32 Using the Aux TS File Enable Option ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
DOC-USR-0008-08 7.14 Encoding from Component or Composite In The Z3-DM8168-RPS also supports encode via 1 of 2 component inputs or 1 of 2 composite inputs. HDMI1, Component1, and Composite1 are all accessible from the “CH1” tab. HDMI2, Component2, and Composite2 are all accessible from the “CH2” tab.
DOC-USR-0008-08 8.0 STREAMING RTMP This section shows how to use the Z3-DM8168-RPS to take 1 video input and stream it over RTMP . The Wowza server is used as an example RTMP server to stream to. 8.1 Connect the Encoder (1) Follow steps (1) to (11) in Section 7.0 to connect the Z3-DM8168-RPS for encode and bring up the...
CONFIDENTIAL DOC-USR-0008-08 (6) After you’re finished, your settings should look something like the following: Figure 35 RTMP Encode – Channel 1 Settings ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(1) Use IP address of Wowza server + “:8088” (2) Select “Applications” (3) Select “live” (4) Select “Test Players” Figure 36 Getting to the Wowza Test Player ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(11) You should see the “Test Players” popup screen. Select the “Adobe RTMP” tab, change the Stream name to “1080” (should match the directory you are streaming to in the Z3-DM8168-RPS), and click “Start”. You should then see the content streamed from the Z3-DM8168-RPS: (1) Select “Adobe RTMP”...
DOC-USR-0008-08 9.0 RUNNING THE DECODER The Z3-DM8168-RPS also supports decoding of streams. To see an example of this follow the steps below. 9.1 Create a .ts File using the Encoder (1) Follow steps (1) through (13) in Section 7.0 to stream a TS stream.
Display” New Settings for Display Appear Figure 40 System Setup in Decoder Mode (7) Click on “Set Display” to configure the display. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Figure 41 Decoder Configuration Settings for Decode Example (9) After about 5-10 seconds, decode should start and you should see a picture. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(1) Run the Web Interface (Steps (1)-(10) in Section 7.0). (2) Select “update device firmware” from the main screen: Click here Figure 42 Updating the Device Firmware from the Web Interface ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(6) You will see screens stating that the image is being uploaded and that the flash is being updated. After about one minute, you should see the main menu again. (7) Your Z3-DM8168-RPS is now updated! ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8...
(6) To go back to booting from Flash rather than TFTP/NFS, you would type the following at the u-boot prompt: Z3-DM8168# setenv bootcmd run nand_boot_ubifs Z3-DM8168# saveenv ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Click “change” Figure 47 Changing the Password (3) Wait for the password options to disappear. This indicates that the password has changed. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
This can be used to start a streaming encode session or to encode to a file on a connected USB drive or SATA drive. A separate manual for MCSENC is included in the Z3-DM8168-RPS release package. A command line interface on the decode side, called MCSDEC, is also available. This can be invoked with the command: # source /opt/mcsdec/mcsdec.sh...
Options (default in bold) Notes Local IP Address 192.168.x.y (192.168.81.68) Sets the IP address of the Z3-DM8168-RPS. Note that a “save” of these settings and a reboot is needed for changes to this value to take effect. Local Netmask 255.255.z.w (255.255.0.0) Sets the netmask of the Z3-DM8168-RPS.
Set Device Name Sets the name for the Z3-DM8168-RPS. Set Password Sets the system password. See Section 11.2, “ Using the Password Feature” on page 50 for more details.
Refresh the current status values. Auto Refresh If checked, causes the values in the status tab to be refreshed automatically once every five seconds. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Used to define where the multiple channels will be routed to after being combined into 1 stream. The only option supported by the Z3-DM8168-RPS is “UDP.” ASI is not supported. If “UDP” is selected, an IP Address and IP Port box will appear.
Page 56
DSP AACHE V2 bitrate range for AACHE and AACHE V2 is 32Kbps – ARM AACLC 64Kbps ARM AACLC MPEG2 ARM AACHE ARM AACHE V2 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 57
If RTP format is selected, the port # associated with RTP Port 0 – 9999 (8892 – 8898) that audio channel. (RTP Only) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 58
UDP stream to be saved to a (UDP Only) False TS file. The name of the file is specified in “Aux TS File Location.” ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 59
Duplicate CH tab (can be used to quickly copy CH1 values to CH2, for example). delete Used to delete excess tabs created by Clone. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Set to “Off” for video only streams. Output Port AUTO Where to output audio. Only HDMI is supported in the DM8168-RPS. HDMI ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Save Click on this to save preset value to what was selected. Operating Mode Encoder This selects how the Z3-DM8168-RPS is being used. “Encoder” is used for encoding and Decoder “Decoder” for decoding. Stop All Stop encode/decode on all channels.
PCI mem!!!!!!!!!!!!!!!!!!!!! setting z3_edma_mem_size to 10485760 Memory policy: ECC disabled, Data cache writeback OMAP chip is TI8169 2.0 gpio regs: 3c:00000005 34:fffffff0 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 64
VDD specified does not exist! OMAP GPIO hardware version 0.1 OMAP GPIO hardware version 0.1 evm_init_begin omap_mux_init: Add partition: #1: core, flags: 0 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 65
NET: Registered protocol family 2 IP route cache hash table entries: 2048 (order: 1, 8192 bytes) TCP established hash table entries: 8192 (order: 4, 65536 bytes) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 66
0x0000006c0000-0x00000cee0000 : "File System" 0x00000cee0000-0x000010000000 : "Reserved" NAND: size is 256 UBI: attaching mtd5 to ubi0 UBI: physical eraseblock size: 131072 bytes (128 KiB) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 67
NET: Registered protocol family 17 VFP support v0.3: implementor 41 architecture 3 part 30 variant c rev 3 omap_voltage_late_init: Voltage driver support not added ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 68
BusyBox v1.15.0.svn (2015-06-30 15:51:43 CDT) multi-call binary Usage: mknod [OPTIONS] NAME TYPE MAJOR MINOR Create a special file (block, character, or pipe) Options: ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 69
Starting Z3 demo BusyBox v1.15.0.svn (2015-06-30 15:51:43 CDT) built-in shell (ash) Enter 'help' for a list of built-in commands. ==== run RDK init ==== ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 70
: values=15,15 | dBscale-min=0.00dB,step=0.50dB,mute=0 /sys/kernel/debug is not a mountpoint Setting DMM priority for [DUCATI ] to [1] ( 0x4e000624 = 0x09000000 ) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 71
Written 0x0; readback 0x0 /dev/mem opened. Memory mapped at address 0x4012d000. Value at address 0x48180F10 (0x4012df10): 0x0 ORG 0x46c00524: 0 NEW 0x46c00524: 2 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 72
| U - Update dynamic settings | T - Stop streaming | W - Write configuration to flash | X - eXit to prompt +==============================================================+ Enter option: ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
APPENDIX B: Configuring the Wowza Server for RTMP In this section, configuring Wowza® version 4.0.1 is described. To configure Wowza to work with the Z3-DM8168-RPS RTMP streaming, the following steps are needed: (1) Log in to the Wowza Streaming Engine Manager Home page by typing http://localhost:8088, where “localhost”...
“Open” and “Client Restrictions” is set to “No client restrictions.” Then click “Save”: Figure 50 Wowza Security Settings The Wowza server is now configured to work with the Z3-DM8168-RPS. All registered trademarks are property of their respective owners.
-Is the Ethernet cable plugged in to the Z3-DM8168-RPS solidly (do you see the link light)? -Do the Z3-DM8168-RPS IP address and the PC IP address have the same first two values (or, if netmask is set to 255.255.255.0, the same first three values)? -Do the Z3-DM8168-RPS and the PC have the same netmask? (Default value is 255.255.0.0)
Page 76
When contacting Z3 Support for additional support, please click the “download device logs” button in the GUI at the time the problem occurs and send the resulting .gz file to Z3 Technology. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8...