background image

 

                             

CONFIDENTIAL

                                    DOC-USR-0064-02 

 

      ___________________________________________________________________________________________ 

Z3 Technology, LLC 

 100 N 8

th

 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. 

 

 

Содержание Z3-DM368-SDI-RPS

Страница 1: ...e 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 Z...

Страница 2: ...s 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 ...

Страница 3: ...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...

Страница 4: ...C 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 f...

Страница 5: ... 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...

Страница 6: ...mplement 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 Z3t...

Страница 7: ..._________________________________________________________________ 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 ...

Страница 8: ...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 BUILD...

Страница 9: ...______________________________ 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 ...

Страница 10: ... 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 1080720...

Страница 11: ... 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...

Страница 12: ...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 ...

Страница 13: ...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 bin...

Страница 14: ...C 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 P...

Страница 15: ...nning 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 B...

Страница 16: ...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 ...

Страница 17: ...ln 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 ...

Страница 18: ...G 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 ...

Страница 19: ...E 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 ...

Страница 20: ...g 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 sess...

Страница 21: ... steps below Click the Use DHCP check box in the Web GUI Once it is checked you will see that the values of Local IP Address Local Netmask and Default Gateway will gray out Click on Save User Wait a couple seconds for the Saved all to User message to appear Power off the Z3 DM368 SDI RPS Power back on the Z3 DM368 SDI RPS Wait about one minute for the ready LED to turn on 1 Click Save User 2 Wait ...

Страница 22: ...unchecking Use DHCP saving to the user settings and rebooting 7 10 Dynamically changing bit rate frame rate It is possible to change two parameters in the middle of an encoding session 1 Video Bit rate 2 Frame Decimation To change these simply enter the new desired value and then click the Start Encoder button The web page will respond with the following message Status Changed rate The video strea...

Страница 23: ...o increase accordingly To minimize latency this value should be set to the lowest possible value The lowest value Z3 recommends is 150 The figure below shows the suggested values for Video Burst Size for three common use cases Video Burst Size Case 1 Highest Quality Highest Latency 2000 Case 2 Good Quality Standard Latency 1000 Case 3 Normal Quality Lowest Latency 150 RTP offers lower latency than...

Страница 24: ...wza install the Wowza server on a PC on your network for details on configuring Wowza please see Appendix B In the Encoder Web GUI set Output Interface to Ethernet VBR Set Output Format to RTMP This will cause Dest IP Address and Dest Path to appear In Dest IP Address type the IP address of the PC with the Wowza server in this example it is 10 1 10 251 In Dest Path type live 1080 Set the resolutio...

Страница 25: ...erver and open a web browser in this example FireFox is used Type in the URL of the Wowza server with the port 8088 in this example 10 1 10 251 8088 This will bring up the Wowza home page Go ahead and log in with your user name and password At the top you will see 4 options Home Server Applications and Help Click on Applications and select live At the top right you will see Test Players Select thi...

Страница 26: ...702 26 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 DM368 SDI RPS and click Start You should then see the content streamed from the Z3 DM368 SDI RPS 1 Select Adobe RTMP tab 2 Type 1080 for Stream name 3 Click Start 4 Audio and Video start to appear Figure 18 Viewing Content in Wowza ...

Страница 27: ...5 except in step 10 specify MPEG 1 Layer 2 for Audio Codec as shown in the figure below VLC will pick up the MP1L2 automatically and start playing it To encode with MP1L2 with RTP a different SDP file is required Use the file z3 dm368_5004_mp1l2 for step 22 when you open the SDP file with VLC Note that the port needs to be set to 5004 for this SDP file to work To decode with MP1L2 with UDP or RTP ...

Страница 28: ...t the Ethernet to a hub router connected to the streaming source Connect the Serial and 12V power Connect SDI Out of the Z3 DM368 SDI RPS to an SDI monitor or to an SDI HDMI converter connected to an HDMI monitor 8 2 Set up the Decoder Board to work with the Encoder Board If you are using another Z3 DM368 SDI RPS as the encoding source you need to make sure that the encoding Z3 DM368 SDI RPS and d...

Страница 29: ...02 323 0702 29 8 3 Configure the Encoder Go to the Encoder Z3 DM368 SDI RPS Change the settings to match those in the figure below Here a multicast address is used You can also stream unicast to the Decoder by specifying the IP address of the decoding Z3 DM368 SDI RPS Using multicast allows you to also open VLC and view the stream from there Figure 21 Encoder Settings for Decoder Example ...

Страница 30: ...M368 SDI RPS Follow steps 5 to 9 in Section 7 0 to bring up the GUI for the Decoder Z3 DM368 SDI RPS You should be at the System Setup Tab From here click on Operating Mode in the lower right corner and change to Decoder The menu will change to a Decoder menu Modify your settings to match those shown below Figure 23 Settings for Decode Example 1 Change to MPEG 2 TS 2 Change port to 5004 3 Set MVE ...

Страница 31: ... 0702 31 8 5 Start the Encoder and Decoder If you haven t already go back to the Encoder board and click Start Encoder Go to the Decoder board and click Start Decoder After a brief pause of a few seconds you should start seeing audio and video on the monitor 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 ...

Страница 32: ... you can modify the options in the GUI to exercise other features These include Encode from Composite Adjust the Bit rate Adjust the Frame rate Adjust the GOP size Change the Video Profile used You can also store the configuration as the default or restore to factory settings Besides using the web based GUI you can also use the serial menus More detailed system information such as generating debug...

Страница 33: ...RUNNING THE CODE YOU BUILT ON THE BOARD There are 2 ways to take the image files you built in Section 5 0 and run them on the board 1 Updating the image file and 2 Setting up NFS TFTP to link to your development PC 10 1 Method 1 Updating the Image File Run the Web Interface Steps 1 9 in Section 7 0 Select UPDATE from the top of the GUI Click here Figure 24 Updating the Device Firmware from the Web...

Страница 34: ...wse to the directory z3 dm368 z3 dm368 SDI RPS date images and select the image file z3 mve01 upd img Click Open Click Upload and Update You should see a FLASH Update now in progress message Once finished it will go back to the main menu You should be able to now run using the updated image It is also possible to update the firmware using an SD card with the ZWriter tool Details can be found in Ap...

Страница 35: ...rt TFTP sudo etc init d xinetd start Enable NFS on the Linux PC The target system will mount the root file system using NFS This like TFTP will also vary depending on the Linux setup you have As an example here is a set of steps that would be run from Ubuntu 10 x or later these are in gray to denote they can vary from system to system a Get NFS if it is not already installed sudo apt get install n...

Страница 36: ...nvironment settings Go to the u boot directory in the release directory and edit the file uboot_envDM368 txt here emacs is used any text editor can be used cd home z3 z3 dm368 cd z3 dm368 SDI RPS date cd u boot emacs uboot_envDM368 txt d In the editor you want to modify the values for nfsserver serverip gatewayip netmask ipaddr tftp_root and nfs_root as shown in the figure below Figure 26 Editing ...

Страница 37: ...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 100 and Character tx delay ms option F to 10 g Press return to save your terminal settings h The next step is to read in the u boot environment file you just modified If you are using minicom type ctl A and Z to bring up the Command Summary Type Y for Paste file i Thi...

Страница 38: ...nnected to your network From the u boot prompt type boot DM365 EVM boot You should see the Z3 DM368 SDI 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 please see the Troubleshooting section in Appendix D 10 3 Other Available u boot Commands Besides booting fr...

Страница 39: ... leave as 192 168 0 1 Use DHCP Checkbox Yes No Yes Use DHCP to get IP address at boot up see Using DHCP on page 21 Load Factory Default Settings Button Load settings installed at the factory Load User Settings Load user settings previously saved Save User Settings Save current settings for later use 11 2 Encoder Options Parameter Options default in bold Notes Video Source SDI Composite The input s...

Страница 40: ... D1 Main for D1 and Baseline for D1 Gop Size 15 30 60 120 240 I frame frequency A GOP size of 60 for example would mean 1 I frame every 60 frames Video Burst Size 150 2000ms 300 of ms to buffer The higher the value the smoother the encode but also the higher the latency Video Codec H 264 MPEG 2 The codec to use for video encoding Frame Decimation None 1 2 1 3 1 4 Used to reduce the frame rate For ...

Страница 41: ... streaming to TS Bitrate 0 20Mbps 12Mbps Only appears for MPEG 2 TS and MPEG 2 TS RTP output Formats The overall bitrate for the generated transport stream A margin of 30 50 over the video bitrate for high bitrates is recommended PID Audio Video PCR 0 999 120 220 520 Only appears for MPEG 2 TS and MPEG 2 TS RTP output formats The PIDs assigned to audio video and the PCR in the TS stream Values are...

Страница 42: ... Port x y z w pppp 225 1 2 3 8888 The IP address and port being streamed to Video Codec H 264 The video format being used in the incoming stream Only H 264 is supported in this release Audio Codec AAC PCM None The audio codec being used in the incoming stream If MP1L2 is licensed any MP1L2 audio will be autodetected and sent to the MP1L2 decoder MVE Flag Checkbox On Off Set this flag if the stream...

Страница 43: ... offset 0x400000 size 0x240000 2359296 bytes read OK Booting kernel from Legacy Image at 80700000 Image Name Linux 2 6 18 14_pro500 davinci_e Image Type ARM Linux Kernel Image uncompressed Data Size 2045880 Bytes 2 MB Load Address 80008000 Entry Point 80008000 Verifying Checksum OK Loading Kernel Image OK OK Starting kernel Uncompressing Linux no vid3 buffer allocated init started BusyBox v1 15 0 ...

Страница 44: ...check failed Use FPGA slave serial mode Design filename top ncd HW_TIMEOUT FALSE UserID 0xFFFFFFFF Part num len 12 Part number 3s200aft256 Date 2013 06 06 Time 12 31 49 Bitstream size 149516 Wrote 149516 bytes FPGA version 0x001A Write 0xf40d Write 0xf41d Write 0xf42d Write 0xf43d Board revision 00001010 Z3 Technology DM36x Linux 2 6 18 http www z3technology com login 644 root login on tts 0 BusyB...

Страница 45: ...annels Stereo 5 Audio Bitrate 128 kbits 6 Video Resolution Follow input 9 Rate Control CBR A Video Bitrate 8000k B Video Profile High C Gop Size 60 Frames D Video Burst Size 300ms E Video Codec H 264 F Frame Decimation None G Video Delay 0 H Audio Delay 0 I Output Interface Ethernet VBR J Output Format RTP K Dest IP Address 192 168 0 6 L Dest Port 5004 M ASI Bitrate 12000k N ASI PCR Interval O PID...

Страница 46: ...o work with the Z3 DM368 SDI 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 is the IP address of the server in this User s Guide 10 1 10 251 2 Click on Server in the top band of options On the left column click on Performance Tuning and then Java Settings Click Edit and then change Java Heap S...

Страница 47: ...402 323 0702 47 3 Click on Applications in the top band of options On the left column click on live and then Incoming Security Click Edit and then make sure RTMP Publishing and RTSP Publishing are both set to Open and Client Restrictions are set to No client restrictions Then click Save The Wowza server is now configured to work with the Z3 DM368 SDI RPS Figure 31 Wowza Security Settings ...

Страница 48: ...dows computer 2 Place an SD card into your computer 3 Open the ZWriter Windows program provided by Z3 4 Select the img file 5 Specify your SD card as the location to write to Note There is no recovery once you click Write Device This will cause the specified location to be overwritten 6 When ZWriter is finished eject the SD card from your computer 7 Place the SD card in the socket on the Z3 DM368 ...

Страница 49: ...lls on the network turned off Try connecting the PC directly to the board without any routers etc Can the Linux PC and target board see each other on the network Try pinging the Z3 DM368 SDI RPS IP address from the Linux PC Try pinging the Linux PC from the Z3 DM368 SDI 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 t...

Страница 50: ...s there another PC on the network conflicting with the IP address of the TFTP server Problem NFS does not work Please see the items in Web interface does not come up Is the link to filesys properly set up see step 2c on page 35 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 dm368 filesys fs Did y...

Отзывы: