Summary of Contents for Z3 Technology Z3-DM816X-RPS RDK
Page 1
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...
Page 2
Corrected reference errors on pages 8 and 17, corrected figures on pages 17 and 34. 2.01.19 06/01/14 Changed name from DM816X-RPS RDK -> DM816X-RPS RDK. Updated screenshots. Added info on ZFinder. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Method 1: Updating the Image File ............... 41 Method 2: Running Your Code through TFTP/NFS ..........43 Other available u-boot commands ..............47 Summary of Options ..................48 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 4
Values Appearing at the Bottom of All Tabs ............54 Appendix A: Example of Successful Boot Log .............. 55 Appendix B: Troubleshooting ................. 66 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 5
Figure 13 Mapping of A/V Cable to Component Jacks ............ 24 Figure 14 Mapping of A/V Cable to Composite 1/2 ............25 Figure 15 Allowed Input Combinations on the Z3-DM816X-RPS RDK ........25 Figure 16 Viewing Bitrate in VLC ................26 Figure 17 Changing the Bitrate Dynamically ...............
Page 6
Figure 41 Minicom Terminal Settings ................ 45 Figure 42 Minicom Paste File Selection ..............46 Figure 43 Example of Successful u-boot Configuration ........... 46 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
DOC-USR-0026-02 General Description The Z3-DM816X-RPS RDK is a development system that allows encode/decode of 1080p60 video to/from a variety of different sources. It consists of both hardware and software. The hardware includes one Z3- DM816X-MOD-2X System on Module card, and one Z3-DM8168-APP-02 application board. The bundled software includes all necessary components for the user to develop their own advanced multimedia, graphics and DSP applications.
1 and 2 In 1 and 2 In 186mm Figure 2 Z3-DM8168-APP-02 Inputs and Outputs 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 sales@z3technology.com. ___________________________________________________________________________________________ Z3 Technology, LLC ♦...
# sudo yum install glibc.i686 Making the Directories and Running the Make Script The software provided will allow you to re-create the pre-installed software of the Z3-DM816X-RPS RDK starting from the included source code. On a PC running Linux, create a directory where the released materials are going to be located:...
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 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Z3 sample application code and scripts The Z3 sample application code that comes with the Z3-DM816X-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: ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 14
The top-level file for the menu-driven application is demo.c. The top-level files for the command line interfaces are demo_mcsenc.c and demo_mcsdec.c. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
CONFIDENTIAL DOC-USR-0026-02 Running the Encoder This section gives step-by-step instructions on taking the Z3-DM816X-RPS RDK and using it to stream 1080p or 1080i video to VLC running on your PC. Set up the HD Source (1) Select an HD source with HDMI non-HDCP output (in Z3’s testing, the Brite-View BV-5005HD is used).
(7) Connect the 12V power supply and 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: ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
CONFIDENTIAL DOC-USR-0026-02 Figure 6 Z3-DM816X-RPS RDK Serial Menu (Top Part) Note the local IP address and netmask (in this example, it is 192.168.81.68 and 255.255.0.0). This is the IP address of the board. You will need this later to access the web interface.
Address” to the IP address of your PC (in this example, 192.168.0.6) Also make note of the value of “Dest Port” (should be 5004 by default): ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(d) Click “start” Figure 8 Web Interface Channel 1 Configuration Tab (12) Click “start”. The status should change from “IDLE” or “STOPPED” to “RUNNING” ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Figure 9 VLC Network Screen Setting to Receive Z3 TS Stream (15) Press “Enter.” (16) You should now see video streaming to VLC: Figure 10 Example of Z3 Video Streaming on VLC ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(22) Open VLC. Select “Media – Open File” and select the “z3-netra.sdp” file you just copied. (23) You should then see RTP video streaming on VLC: Figure 11 Example of Z3 Video Streaming to VLC (RTP) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
CONFIDENTIAL DOC-USR-0026-02 Encoding from other inputs In addition to HDMI1, the Z3-DM816X-RPS RDK allows encode from a second HDMI channel, two component inputs, and two composite inputs. To select a source, simply select the desired source from “Video Source.” To use HDMI2, simply plug a video source to the HDMI port just below HDMI1.
5.10 Changing the bit rate dynamically This version of the Z3-DM816X-RPS RDK includes an “update” button which allows you to change the bit rate without stopping and restarting the encoder. To use it, do the following steps: (24) In VLC, click on “Tools” and select “Codec Information”. This brings up a window with four tabs.
Adjusting the UDP TS Rate This version of the Z3-DM816X-RPS RDK includes a parameter to adjust the TS rate independent of the video bit rate. This can be found just below “PCR PID” when “UDP” is selected as the output format.
(29) Click on “start” to start encoding. (30) Click on the Status tab. You should see the new bit rate and resolution reflected in the status: ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
The value of TS Rate must be higher than (video bit rate + audio bit rate) * 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...
The IP address that is assigned can be seen through the serial interface [Note: future releases of the Z3-DM816X-RPS RDK will include a tool that can be run on the PC to detect any Z3 systems on the network and what IP address they are assigned to].
Figure 25 Selecting “z3_test” within the System Setup Tab (35) After you select “z3_test”, check “Use DHCP”: Check “Use DHCP” again Figure 26 Setting DHCP within z3_test ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(37) Now that you’ve set DHCP and saved it to a configuration “z3_test” and specified that “z3_test” will be used when the system restarts, go ahead and reboot the Z3-DM816X-RPS RDK. (38) Now go to the serial interface you established in steps (5) and (6). When the Main Menu comes up,...
In this case, the Z3-DM816X-RPS RDK appears: Figure 29 Using ZFinder to find the DHCP Address (40) Click on the Z3-DM816X-RPS RDK entry in the window to select it. This will cause the “Edit Device”, “Open Device” and “Flash Leds” boxes to activate: Figure 30 ZFinder with Z3-DM816X-RPS RDK Selected (41) Click on “Open Device.”...
“Local IP Address” specifies the IP address that will be used with Static IP allocation. When “Use DHCP” is checked, this value should be ignored. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
The Z3-DM816X-RPS RDK can also be used to decode streams. This section describes how to quickly get decode up and running. A second Z3-DM816X-RPS RDK is required in these instructions. If the user has only one Z3-DM816X-RPS RDK, they can also try using an alternate source for the video stream. In that case, the decoder settings may have to be adjusted.
You will change this later to operate as a Decoder. But first, let’s go back to the Encoder and set up the stream … ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Here a multicast address is used. You can also try streaming unicast to 192.168.81.67 (multicast allows you to also open VLC and view the stream from there): Figure 34 Encoder Settings for Sample Decode ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
System Setup screen, which includes settings for Display Mode, Resolution, and Layout. Leave those settings as-is: Figure 36 Decoder System Setup Menu ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(17) You can also view the content using VLC. Open VLC as you did in the Encode instructions and use the address “udp://@225.1.2.3:5004” for the URL. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
This can be invoked with the command: source /opt/mcsenc/mcsenc.sh source /opt/mcsdec/mcsdec.sh Separate manuals for MCSENC and MCSDEC are also available with this release. ___________________________________________________________________________________________ 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)-(9) in Section 5). (2) Select “update device firmware” from the main screen: Click here Figure 38 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...
(5) Click “Upload and Update.” You should see a “FLASH Update now in progress” message. Once finished it will go back to the main menu. (6) You should be able to now run using the updated image. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(a) Get NFS if it is not already installed: # sudo apt-get install nfs-kernel-server (b) Create /export/users and set it up: # mkdir –p /export/users # mount –bind /export/users /home/users ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 44
(here emacs is used – any text editor can be used). # cd /home/z3/z3-netra-rdk # cd z3-netra-MC-RPS-SRC-20140508 # cd u-boot # emacs u-boot-env-netra-rdk.txt ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(l) Check the value of gatewayip and netmask to make sure it conforms to your network. You can use setenv to change anything that needs to be modified. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(6) From the u-boot prompt, type “boot” Z3-DM8168-MOD# boot You should see the Z3-DM816X-RPS RDK boot the kernel obtained via TFTP, mount a file system using NFS, and then go straight to the serial menu. Appendix A shows an example of a successful boot. If you are running into issues, see the “Troubleshooting”...
The System Setup Tab Parameter Options (default in bold) Notes Local IP Address 192.168.x.y (192.168.81.68) Sets the IP address of the Z3-DM816X-RPS RDK. Local Netmask 255.255.z.w (255.255.0.0) Sets the netmask of the Z3-DM816X-RPS RDK. Default Gateway 192.168.a.b (192.168.0.1) Can generally leave this as “192.168.0.1”.
For example, you can click “Refresh”, count to 10, click “Refresh” again, and you should see an increase of around 600 for 60 frames per second content). ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
P-frame that the next P-frame occurs. A value of “1” means 0 B-frames occur. A value of “2” means 1 B-frame, and so on. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 51
16000 The sample rate of the audio. 32000 44100 48000 Bit Rate 12Kbps – 320Kbps (128Kbps) The bit rate of the audio. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 52
(see Section 5.11, “Adjusting the UDP TS Rate,” on page 27). stop Stop current encode session. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Output Port Auto If audio is selected, use to select the audio output. Only HDMI is supported for the HDMI ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Stop All Stop encode on all channels. Start All Start encode on all channels. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Memory policy: ECC disabled, Data cache writeback OMAP chip is TI8169 2.0 gpio regs: 3c:00000005 34:fffffff0 Built 1 zonelists in Zone order, mobility grouping on. Total pages: 57088 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 56
Add partition: #1: core, flags: 0 _omap_mux_get_by_name: Could not find signal i2c2_scl.i2c2_scl _omap_mux_get_by_name: Could not find signal i2c2_sda.i2c2_sda *********** z3_fpga_init returns 0 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 63
Value at address 0x48180F00 (0x40289f00): 0x30000 Written 0x0; readback 0x0 /dev/mem opened. Memory mapped at address 0x402d5000. Value at address 0x48180F10 (0x402d5f10): 0x0 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 65
| W - Write configuration to flash | | X - eXit to prompt | +==============================================================+ Enter option: No input -> start automatically ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
-Is the Ethernet cable plugged in to the Z3-DM816X-MOD-2X board solidly (do you see the link light)? -Does the Z3-DM816X-RPS RDK 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-DM816X-RPS RDK and the PC running VLC have the same netmask? (Default value is 255.255.0.0)
Page 67
-If you modified the exports file, did you remember to restart the NFS server after that? When contacting Z3 Support for additional support, please capture and include a log file with the diagnostic level set to analysis. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Need help?
Do you have a question about the Z3-DM816X-RPS RDK and is the answer not in the manual?
Questions and answers