Multi-channel h.264 hd multimedia system (44 pages)
Summary of Contents for Z3 Technology Z3-DM8168-PCI-RPS
Page 1
Z3. Z3 Technology, LLC incorporates HDMI® technology. The terms of HDMI and HDMI High-Definition Multimedia Interface, and the HDMI Logo are trademarks or registered trademarks of HDMI Licensing LLC in the United States and other countries.
Page 2
Revision History Version Date Change Note Author 0.00.05 08/24/15 Original Document Updated document for new release. Added Quick Start Guide, Running 2.04.00 03/24/15 the Encoder/Decoder, Summary of Options, PCI express information, updated formatting...
RDK Documentation ................... 16 RUNNING THE ENCODER ..................19 Set up the HD Source ..................19 Connect and Power Up the Z3-DM8168-PCI-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
Values Appearing at the Bottom of All Tabs ..............60 APPENDIX A: Example of Successful Boot Log ................ 61 APPENDIX B: Troubleshooting ................... 71 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 5
Figure 27 Address Change after DHCP Set ................34 Figure 28 ZFinder with Z3-DM8168-PCI-RPS DHCP Address ............35 Figure 29 Selecting Z3-DM8168-PCI-RPS w/ DHCP Address in ZFinder ..........35 Figure 30 Web GUI Using DHCP Address ................35 Figure 31 Using the Aux TS File Enable Option ............... 36 Figure 32 Connecting the Z3-DM8168-PCI-RPS for Decode ............
Page 6
Figure 41 Example of Successful u-boot Configuration ............. 45 Figure 42 Selecting “Set Password” ..................47 Figure 43 Changing the Password ..................47 Figure 44 Password Entry Screen ..................48 ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
DOC-USR-0057-02 GENERAL DESCRIPTION The Z3-DM8168-PCI-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-3x System on Module card, one Z3-DM8168-APP-2x application board with PCI Express interface, 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.
108 mm Figure 2 The Z3-DM8168-MOD-3x The Z3-DM8168-PCI-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. The software bundle also contains tools to allow the development of high-level applications using hardware-accelerated video processing, DSP , and graphics.
OVERVIEW, on page 14. Details on how to set up your system to access the code you have built can be found in Section 9.2, “Method 2: Running Your Code through TFTP/NFS”, on page 42. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
# cp SW-7R1-00390-01_DM8168-PCI-RPS-20150323.tar.bz2 /home/z3/z3-netra-rdk Untar the archive (name of tar file may slightly vary): # tar -xvjf SW-7R1-00390-01_DM8168-PCI-RPS-20150323.tar.bz2 *Note: Untarring takes 5 to 10 minutes. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
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...
MPEG2-TS are handled here. The file demo_mcsenc.c contains the implementation of the command line interface. This can be run using the following command: source /opt/mcsenc/mcsenc.sh ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
.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-PCI-RPS and using it to stream 1080p or 1080i video to VLC running on your PC. In addition to the Z3-DM8168-PCI-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 6 Z3-DM8168-PCI-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 7 Z3-DM8168-RPS Web GUI (System Setup Page) ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
-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 10 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...
Click on “start” to start the RTP encoding session. At this point your settings should look like the following: (1) Change to “RTP” Figure 11 Channel 1 Configuration Screen – RTP ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(23) Press “Enter.” (24) You should now see video streaming to VLC: Figure 13 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-0057-02 Changing the Bitrate Dynamically The Z3-DM8168-PCI-RPS includes an “Update” button which allows you to change the bitrate without stopping and restarting the encoder. This can be used if streaming RTP. To use this feature, complete the following steps: (25) In VLC, click on “Tools”...
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-0057-02 Adjusting the UDP TS Rate The Z3-DM8168-PCI-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 8Mbps, corresponding to 6Mbps for the video.
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...
This brings up a new text box to enter the preset name. Type “z3_config1” and click “ok”: (1) Type “z3_config1” (2) Click “ok” Figure 22 Entering a User Preset Name ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Now that DHCP is set in z3_config1, save the configuration by clicking on the “Save” button: Click “Save” Figure 25 Saving a User Preset ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(41) 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-PCI-RPS is connected. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8...
(2) Click “Open Device” Figure 29 Selecting Z3-DM8168-PCI-RPS w/ DHCP Address in ZFinder (44) A web browser will then open at the IP address of the Z3-DM8168-PCI-RPS and you will see the Web GUI: New IP address Figure 30 Web GUI Using DHCP Address (45) You can return to Static IP by unchecking “Use DHCP”...
“/media/sda1/encode_run1.ts” would save to “encode_run1.ts” on that drive. Sample values are shown below: Figure 31 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...
CONFIDENTIAL DOC-USR-0057-02 RUNNING THE DECODER The Z3-DM8168-PCI-RPS also supports decoding of streams. To see an example of this follow the steps below. Create a .ts File using the Encoder (1) Follow steps (1) through (13) in Section 7.0 to stream a TS stream.
“DM8168-PCI-RPS Decoder” and settings for Display Mode, Resolution, and Layout will appear: New Settings for Display Appear Figure 34 System Setup in Decoder Mode ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Figure 35 Decoder Configuration Settings for Decode Example (8) After about 5-10 seconds, decode should start and you should see a picture / hear audio. ___________________________________________________________________________________________ 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 36 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-PCI-RPS is now updated! ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8...
(here, 192.168.0.6 is the IP address of the PC, and 255.255.0.0 is the netmask): /home/z3/z3-dm810x/filesys/fs 192.168.0.6/255.255.0.0(no_root_squash,insecure,nohide,rw,async) (c) Start the NFS server # sudo service nfs-kernel-server restart ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Modify to match the IP address you want the target board to be Modify to match your tftp and configuration (see below) Figure 39 Editing u-boot-env-netra-rdk.txt ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
(k) You should then see a series of commands being pasted within u-boot. The very last line should say “Saving Environment to NAND…” ___________________________________________________________________________________________ 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-DM8168-PCI-RPS 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”...
Click “change” Figure 43 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-PCI-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...
4, 8, or 16 lanes. The Z3-DM8168-PCI-RPS board set can also operate as one 1-lane PCIe device. This means that if the mechanical restrictions of inserting a big board into a small slot did not exist, it would also work. Since this is a generic situation, some motherboard vendors have included PCIe slots that have their backs open to allow the insertion of board with more lanes than the connector.
PCIe setting, the module must have the proper configuration. By default, Z3 ships Z3-DM816x-MOD-2x modules configured as a root complex, and Z3-DM816x-MOD-3x modules configured as an endpoint. The Z3-DM8168-PCI-RPS kit contains a Z3-DM816x-MOD-3x module, and therefore is by default configured as an endpoint.
Options (default in bold) Notes Local IP Address 192.168.x.y (192.168.81.68) Sets the IP address of the Z3-DM8168-PCI-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-PCI-RPS.
(Decode Only) to the desired value and then click the “Set Display” button. Set Device Name Sets the name for the Z3-DM8168-PCI-RPS. Set Password Sets the system password. See Section 10.2, “Using the Password Feature” on page 47 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...
0 – 3000 (2000) smoother the encode, but also the higher the latency (see Section 7.11, “Tuning for Latency” on page 31). ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 55
If an issue is encountered with a specific decoder, please try setting this value to the same value as video delay. ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 56
UDP stream to be saved to a ts (UDP Only) False 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 57
VGA (640x480), 4-CIF (704x576), 16:9 PAL (1024x576), D1 PAL (720x576), D1 NTSC (720x480), 720p (1280x720), XGA (1280x1024), 1080p (1920x1080), Follow input “Follow input” = Generate encoder resolution based on capture resolution detected ___________________________________________________________________________________________ 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-PCI-RPS. HDMI ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
User Presets tab. Save Click on this to save preset value to what was selected. Operating Mode Encoder Interlaced/Progressive This selects how the Z3-DM8168-PCI-RPS is being used. Encoder Progressive Only Encoder No Scale Crop Only “Encoder Interlaced/Progressive” is the default Encoder ISDBT mode of operation –...
Built 1 zonelists in Zone order, mobility grouping on. Total pages: 57088 Kernel command line: console=ttyO2,115200 ddr_mem=1024M mem=256M vram=20M earlyp rintk z3dram=1024M notifyk.vpssm3_sva=0xbee00000 omap_nand_ecc=bch8 noinitrd ubi ___________________________________________________________________________________________ Z3 Technology, LLC ♦ 100 N 8 ST, STE 250 ♦ Lincoln, NE 68508-1369 USA ♦ +1.402.323.0702...
Page 62
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 70
| 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...
-Is the Ethernet cable plugged in to the Z3-DM8168-PCI-RPS solidly (do you see the link light)? -Do the Z3-DM8168-PCI-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-PCI-RPS and the PC have the same netmask? (Default value is 255.255.0.0)
Page 72
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...
Need help?
Do you have a question about the Z3-DM8168-PCI-RPS and is the answer not in the manual?
Questions and answers