background image

 

 

 

 

User’s Guide 

Z3-DM8169-APP-L1-RPS 

Custom Software for Z3-DM8169-APP-L1 

 

 

 

 

 

DOC-USR-0052-01 

Manual Version 2.01.10 

Software Version 2.01.10 

April 10, 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. 

Summary of Contents for Z3-DM8169-APP-L1-RPS

Page 1: ...ttempting 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 ...

Page 2: ...___________________________________________________________________________________ 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 2 01 10 04 10 14 Original Document RC ...

Page 3: ...ation Options and Arguments 9 4 2 3 Application Source Code 10 4 3 RDK documentation 10 5 Running the Encoder 13 5 1 Set up the HD Source 13 5 2 Connect the Board 13 5 3 Set up the Terminal Window 14 5 4 Power on the board 14 5 5 Ensure your PC has a proper IP address 14 5 6 Run the Web Interface to Configure CH1 15 5 7 Run VLC to View Stream 17 5 8 Streaming RTP 18 5 9 Changing the Bitrate Dynami...

Page 4: ...1 Configuration Screen 16 Figure 6 VLC Open Network Screen 17 Figure 7 Example of Z3 Video Streaming to VLC UDP 17 Figure 8 Example of Z3 Video Streaming to VLC RTP 18 Figure 9 Viewing Bitrate in VLC 19 Figure 10 Drop in Bitrate after Dynamic Bitrate Change 19 Figure 11 Tuning for Various Use Cases 20 Figure 12 720p Encode Settings 21 Figure 13 VGA Encode Settings 22 Figure 14 The Status Tab for D...

Page 5: ...L1 Carrier Application board The Z3 DM816X MOD 3X is a compact OEM module which supports H 264 High Profile encode decode at up to two channels of 1080p at 60 fps frames per second It includes the interface used to connect the serial port The Z3 DM8168 MOD 3X features a unique expansion interface comprised of five high density connectors providing access to most of the interface signals available ...

Page 6: ..._____________________________________________ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 6 2 Features HD resolutions up to 1920x1080 H 264 support Input video resizer Outputs RTP or MPEG 2 Transport Stream Web based or serial based configuration software ...

Page 7: ...rn 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 3 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 DM8169 L1 RPS starting from the included sourc...

Page 8: ...dk 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 The z3apps rdk directory is described in more detail in the next section 4 1 1 The z3apps rdk directory There are three main subdirectories rdk_demo z3_mcfw_api and z3 Note Source ...

Page 9: ...n the serial terminal when the board is powered on The second is a command line interface that is more flexible and easier to use from a programming standpoint The web based interface uses the command line interface extensively The menu based demo binary can be found at opt dvr_rdk ti816x bin z3_dvr_rdk_demo_mcfw_api out The command line interface binary can be found at opt dvr_rdk ti816x bin mcfw...

Page 10: ...rdk rdk_demo The top level file for the menu driven demo is demo c The top level files for the command line interfaces are demo_mcsenc c and demo_mcsdec c 4 3 RDK documentation Documentation on the RDK can be found in dvr rdk dvr_rdk docs Below is a list of some of the major documentation available Docs DM81xx_DVR_RDK_Install_Guide pdf DM81xx_DVR_RDK_MainPage pdf DM81xx_DVR_RDK_Release_Notes pdf D...

Page 11: ...D_AlgorithmIntegration pdf DM81xx_DVR_RDK_Software_OSD_Notes pdf DM81xx_DVR_RDK_Software_OSD_Text_Render_Notes pdf software_manifest htm TestReports DM810X_DVRRDK_Test_Report_04 00 00 03 xls HDMITestReports Trainings DVR_RDK_McFW_Link_API_Training pdf Usecases DM810x_DVR_RDK_UseCaseGuide_4D1_8CIF_16CIF_DVR pdf DM810x_DVR_RDK_UseCaseGuide_Decode_Display pdf DM814x_DVR_RDK_UseCaseGuide_4D1_8CIF_16CI...

Page 12: ...____________________________________________________________________ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 12 DM81xx_DVR_RDK_SCD_DMVAL_FAQs pdf DMVAL_API_and_UsersGuide pdf DVR_RDK_ApiGuide CHM SCD_TI_API_UsersGuide_v00 50 pdf ...

Page 13: ...ns on taking the Z3 DM8169 L1 RPS and using it to stream 720p or simultaneous 720p and cropped VGA 5 1 Set up the HD Source 1 Select an HD source with an SDI output and configure for 720p 5 2 Connect the Board For these steps please refer to Figure 3 2 Connect the supplied 2 5mm serial cable and NULL modem adapter to your PC 3 Connect the Z3 DM8169 APP L1 RPS to SDI Ethernet Power via the PCI inte...

Page 14: ... 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 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 5 5 Ensure your PC has a proper IP address 7 To be able to communicate with the RPS the PC that you are c...

Page 15: ...the Web Interface to Configure CH1 8 In your PC run a web browser for best results Z3 recommends FireFox 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 81 68 After about three seconds the System Setup menu should come up 9 Click on the CH1 tab 10 You should see the Channel 1 configuration tab see Figure 5 Figure 4 ...

Page 16: ...te of the value of Dest Port should be 5004 by default 12 Click start note The demo may have already started as it will automatically start in 30 seconds if a valid input is detected If that occurs just click stop first The status should change from IDLE or STOPPED to RUNNING see Figure 5 If status is POLLING that means a valid SDI input was not detected Figure 5 Channel 1 Configuration Screen 5 C...

Page 17: ...23 0702 17 5 7 Run VLC to View Stream 13 Run VLC on your PC version used in testing at Z3 2 05 14 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 and 5004 is the value of Dest Port noted in step 11 15 Press Enter 16 You should now see video streaming to VLC Figure 6 VLC Open Network Screen Figure 7 Example of Z3 Video Streaming t...

Page 18: ... with the software release from Z3 To stream using RTP do the following steps 17 In the CH1 configuration tab click on stop to stop the current encoding session 18 Change Output Format from UDP to RTP see Figure 5 19 Confirm that Dest Port see Figure 5 is 5004 this will be important for the VLC configuration 20 Click on start to start the RTP encoding session 21 Copy the z3 netra sdp file received...

Page 19: ...it do the following steps 24 In VLC click on Tools and select Codec Information This brings up a window with four tabs Select the Statistics tab In this tab you can see the current video audio bitrate 8Mbps shown in this example 25 In the CH1 screen change the bitrate in this example the bitrate is changed from 8000K to 2000K and click the update button 26 You should see the quality of the picture...

Page 20: ... the more time it has to smooth things out for challenging content However a higher value also causes latency to increase accordingly To minimize latency this value should be set to the lowest possible value The lowest value Z3 recommends is 50 B frames improve the quality of the picture but they also increase the latency by one frame time To minimize latency B frames should be disabled done by se...

Page 21: ...taneous 720p and Crop to VGA Encode Mode The Z3 DM8169 APP L1 RPS also supports encoding a video stream in 720p and also taking that same stream and encoding it as VGA An example of this is shown below 1 Configure CH1 to the following settings 2 Click on the next to the CH1 to create a CH2 3 For CH2 set it to the VGA settings bitrate can be as low as 1Mbps if desired Note the different Dest Port F...

Page 22: ...______________________________________________________ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 22 3 Click on Start All to start Encode 4 If you click on the Status tab you should see something like the following Figure 13 VGA Encode Settings ...

Page 23: ..._____________ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 23 5 Note that in this example the lower fps and bitrates are due to everything starting with an initial value of 0 After about a minute these values should normalize to the target values Figure 14 The Status Tab for Dual Encode ...

Page 24: ...tore the configuration and store in the default or other files Besides using the web based GUI you can also use the serial menus More detailed system information can also be gained from the options in the serial interface A command line interface called MCSENC is also available for running encode commands This can be invoked with the command source opt mcsenc mcsenc sh This can be used to start a ...

Page 25: ... the board 1 Updating the image file and 2 Setting up NFS TFTP to link to your development PC 7 1 Method 1 Updating the Image File 1 Run the Web Interface Steps 1 9 in Section 0 2 Select update device firmware from the main screen 3 This brings you to the Software Updater screen Click Browse and browse to the directory z3 netra rdk z3 netra RDK date images and select the image file z3 netra upd im...

Page 26: ...__ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 26 4 Click Open 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 Figure 16 Browsing for the Image File in the Updater ...

Page 27: ...p b Create the file etc xinetd d tftp Set server_args to the home directory containing z3 netra rdk home in this example An example of a tftp file would be service tftp disable no socket_type dgram protocol udp wait yes user nobody server usr sbin in tftpd server_args home c Make a tftpboot directory sudo mkdir tftpboot sudo chmod R 777 tftpboot sudo chown R nobody tftpboot d Start TFTP sudo etc i...

Page 28: ...rver restart 3 Create symbolic links in your top level directory to allow access to your filesys and images directory note actual directory name may be different depending on your specific release cd home z3 z3 netra rdk ln s z3 netra RDK 20140409 images images ln s z3 netra RDK 20140409 filesys filesys 4 Configure u boot on your board to match your system configuration settings a Reboot the board...

Page 29: ...ges and then copy this file to your home directory this will make it easy to transfer from minicom later cp u boot env netra rdk txt home z3 f Now set up your terminal program to take input from a file If you are using minicom type ctl A then Z This should bring up the minicom Command Summary From here type T to bring up the Terminal Settings window From here set Newline tx delay ms option D to 10...

Page 30: ...ile Then use the left and right arrow keys to select Okay Press return j You should then see a series of commands being pasted within u boot The very last line should say Saving Environment to NAND k Type printenv to show the current environment variables in u boot l Check the value of serverip nfsserver and netmask to make sure it conforms to your network You can use setenv to change anything tha...

Page 31: ..._boot_nfs Get kernel from NAND root file system from NFS setenv bootcmd run nand_boot_jffs2 Get kernel from NAND root file system from NAND JFFS2 setenv bootcmd run nand_boot_ubifs Get kernel from NAND root file system from NAND UBIFS setenv bootcmd run nand_boot_ramdisk Get kernel from NAND root file system from ramdisk The following scripts are also available to update the u boot environment run...

Page 32: ...s 1 USB Device s found scanning bus for storage devices 1 Storage Device s found checking for Z3 software image Set powerlevel to 5 NAND read device 0 offset 0x280000 size 0x300000 3145728 bytes read OK Booting kernel from Legacy Image at 81800000 Image Name Linux 2 6 37 Image Type ARM Linux Kernel Image uncompressed Data Size 2452940 Bytes 2 3 MiB Load Address 80008000 Entry Point 80008000 Verify...

Page 33: ...arlyprintk z3dram 1024M notifyk vpssm3_sva 0xbee00000 omap_nand_ecc bch8 noinitrd ubi mtd 5 root ubi0 rootfs rootfstype ubifs ip 192 168 81 68 192 168 0 6 192 168 0 1 255 255 0 0 Z3 Netra off demo mcsenc_demo PID hash table entries 1024 order 0 4096 bytes Dentry cache hash table entries 32768 order 5 131072 bytes Inode cache hash table entries 16384 order 4 65536 bytes Memory 224MB 1MB 225MB total...

Page 34: ...all interrupt handler for IRQ371 Trying to install interrupt handler for IRQ372 Trying to install interrupt handler for IRQ373 Trying to install interrupt handler for IRQ374 Trying to install type control for IRQ375 Trying to set irq flags for IRQ375 OMAP clockevent source GPTIMER1 at 27000000 Hz Console colour dummy device 80x30 Calibrating delay loop 1346 76 BogoMIPS lpj 6733824 pid_max default ...

Page 35: ..._scl i2c2_scl _omap_mux_get_by_name Could not find signal i2c2_sda i2c2_sda z3_fpga_init returns 0 Cannot clk_get ck_32 pm_dbg_init only OMAP3 supported registered ti81xx_vpss device registered ti81xx_vidout device registered ti81xx on chip HDMI device registered ti81xx_fb device registered ti81xx_vin device bio create slab bio 0 at 0 SCSI subsystem initialized usbcore registered new interface dri...

Page 36: ...Manufacturer Linux 2 6 37 musb hcd usb usb1 SerialNumber musb hdrc 0 hub 1 0 1 0 USB hub found hub 1 0 1 0 1 port detected musb hdrc musb hdrc 0 USB Host mode controller at d0832000 using DMA IRQ 18 musb hdrc musb hdrc 1 dma type dma cppi41 MUSB controller 1 revision 4ea20800 musb hdrc musb hdrc 1 MUSB HDRC host driver musb hdrc musb hdrc 1 new USB bus registered assigned bus number 2 usb usb2 New...

Page 37: ...tcp NFSv4 1 backchannel transport module NetWinder Floating Point Emulator V0 97 double precision PMU registered new PMU device of type 0 omap iommu omap iommu 0 ducati registered omap iommu omap iommu 1 sys registered squashfs version 4 0 2009 01 31 Phillip Lougher JFFS2 version 2 2 NAND Â 2001 2006 Red Hat Inc msgmni has been set to 435 io scheduler noop registered io scheduler deadline register...

Page 38: ...d eraseblock 787 at 0x000006260000 Factory marked eraseblock 1071 at 0x0000085e0000 Creating 7 MTD partitions on omap2 nand 0 0x000000000000 0x000000120000 U Boot 0x000000120000 0x000000240000 U Boot Update 0x000000240000 0x000000260000 U Boot Env Update 0x000000260000 0x000000280000 U Boot Env 0x000000280000 0x0000006c0000 Kernel 0x0000006c0000 0x00000cee0000 File System 0x00000cee0000 0x00001000...

Page 39: ...egistered new interface driver usbhid usbhid USB HID core driver notify_init notify drivercreated for remote proc id 2 at physical Address 0xbee00000 Registered tvp5158 audio codec asoc tlv320aic3x hifi davinci mcasp 2 mapping ok asoc HDMI DAI CODEC hdmi dai mapping ok asoc gv7601 hifi davinci mcasp 0 mapping ok ALSA device list 0 TI81XX EVM 1 Z3 30 0028 TCP cubic registered NET Registered protoco...

Page 40: ...use proc 76 oom_score_adj instead udev starting version 141 Root filesystem already rw not remounting root mount mounting rootfs on failed No such file or directory Setting up IP spoofing protection rp_filter Configuring network interfaces done Wed Dec 2 18 59 00 UTC 2009 Starting syslogd klogd done hardware supports tppss load the tppss drivers insmod opt z3 tppss tppss_core ko create ti_dmx proc...

Page 41: ...b device gv7601 registered grp x3 5150 driver probe called tvp5150 1 005c chip found 0xb8 OMAP I2C adapter z3netra 000 v4l2 sub device tvp5150 registered grp x4 z3netra 000 V4L2 device registered as video0 Z3 Netra video decoders ver 0 6 0 successfully loaded 1 devs Starting mcs_server daemon Starting telnet daemon Starting web configurator NET Registered protocol family 10 server sh source line 4...

Page 42: ...or HDVICP2 to 2 0x4e000634 0x00a00000 run RDK loadmodule Attached to slave procId 2 Loaded file firmware dvr_rdk_fw_m3vpss_1024M_256M xem3 on slave procId 2 Started slave procId 2 After Ipc_loadcallback status 0x00000000 After Ipc_startcallback status 0x00000000 Attached to slave procId 1 Loaded file firmware dvr_rdk_fw_m3video_1024M_256M xem3 on slave procId 1 Started slave procId 1 After Ipc_loa...

Page 43: ... readback 0x0 dev mem opened Memory mapped at address 0x4033e000 Value at address 0x48180F10 0x4033ef10 0x0 ORG 0x46c00524 0 NEW 0x46c00524 2 run RDK application running demo mcsenc_demo query acodecs here are the audio codec options none fdk_aaclc fdk_aaclc_mp2 fdk_aache fdk_aache_v2 dsp_aaclc set demo mode to lowlat_crop OK Z3 Technology LLC DM8169 APP L1 v2 01 10 H 264 multichannel Current P Ch...

Page 44: ..._______________________________________ Z3 Technology LLC 100 N 8th ST STE 250 Lincoln NE 68508 1369 USA 1 402 323 0702 44 AUDIO off 2 Change channel 2 H 264 DISABLED Z Status S Start streaming U Update dynamic settings T Stop streaming W Write configuration to flash X eXit to prompt Enter option ...

Page 45: ...P address from the Linux PC Try pinging the Linux PC from the Z3 DM8169 APP L1 RPS Problem Do not see video in VLC UDP Does the IP address set in Dest Address equal the IP address of the PC running VLC Does the port number in Dest Port equal the value entered in the URL for VLC Does the video coming out of the source match the resolution in the encoder settings Is the PC fast enough for 1080p deco...

Page 46: ...not come up Is the link to filesys properly set up see step 3 on page 28 Does the IP address in the line added in etc exports match the IP address set in nfsserver in u boot Does the value of nfs_root in u boot point to z3 netra rdk filesys fs Did you start the NFS server If you modified the exports file did you remember to restart the NFS server after that When contacting Z3 Support for additiona...

Reviews: