background image

Multi-Format STB Quick Start

17

Chapter 3

Creating a Channel Guide

Topics in this chapter

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Configuring channels.xml. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Updating channels.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Hosting channels.xml on a PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using Multiple channel.xml Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Overview

A local channel guide like the one in Figure 9 is created by configuring an .xml file with the 
desired channels and FTPing it to the set top box. You can also host the required STB files 
on a PC. To host the files on a PC you will need to configure Windows for IIS and then use 
your PC to host the STB files with a URL similar to this: 

http://local_pc_ipaddr/home.htm

 

Figure 9.  

Local Mode Channel Guide

Configuring channels.xml

The following code shows the 

channels.xml

 file that is used to create the channel guide. 

There is a file header and separate section for each stream. Modify this file so that the IP 
addresses, port numbers, and messages reflect the actual streams you have available at your 
site. Cut and paste as necessary to add new streams and be sure to delete any unused streams. 
Note that no extra spaces are allowed and there is only one blank line between channel 
definitions. 

This file has a limit of 99 defined channels.

 As a best practice, it is always a 

good idea to make a backup copy of this file. 

Summary of Contents for 8000-0188

Page 1: ...VBrick Multi Format Set Top Box Multi Format Set Top Box v2 2 5 Quick Start Guide January 2016 ...

Page 2: ...posted at http www vbrick com opensource About VBrick Systems Founded in 1998 VBrick Systems is a privately held company that has enjoyed rapid growth by helping our customers successfully introduce mission critical video applications across their enterprise networks Since our founding VBrick has been setting the standard for quality performance and innovation in the delivery of live and stored vi...

Page 3: ...aying the Setup Page 9 Changing the IP Address 9 STB Configuration 10 Adjusting the Display Area of Output Devices VEMS 5 x 14 Adjusting the Display Area of Output Devices VEMS 6 x 15 Upgrade Reset Change Password 16 3 Creating a Channel Guide Overview 17 Configuring channels xml 17 Sample Channels File 18 Sample URLs 21 Updating channels xml 22 Using wget 22 Using vi 22 Hosting channels xml on a ...

Page 4: ... 2 Configure the Global Setting 37 3 Configure the Upgrade Server URL in VEMS 37 4 Configure the STB with the VEMS Upgrade Server URL 38 Cancelling the Upgrade 39 6 Using the Remote Control Overview 41 Using the Remote Control VEMS 5 x 42 Portal Server Mode 42 Local Mode 43 Using the Remote Control VEMS 6 x 44 Portal Server Mode 44 Local Mode 46 Using the Remote Control to Change the Channel 46 7 ...

Page 5: ...vbrick com The information in this document is arranged as follows Important Note The Multi Format Set Top Box can be used with VEMS 5 x systems and with VEMS 6 x systems These systems are architected differently and as a result the interaction with the set top box is slightly different When using this guide be sure to note whether the text applies to VEMS 5 x or to VEMS 6 x If not specifically st...

Page 6: ...lics are used in text to emphasize specific words or phrases When used in file names or other strings a percent20 20 indicates a space Environmental Considerations At VBrick we believe that running our company with a green conscience is good for the environment and good for business and that environmental awareness is an important part of the value we deliver to our customers We recognize our resp...

Page 7: ...ms can be sourced from VBrick encoding appliances or from VBrick VOD W MPEG VOD WM Windows Media VOD D Darwin and DME Distributed Media Engine VOD servers Figure 1 Multi Format Set Top Box front Creating STB Users In a VEMS Mystro environment each STB must be associated with a VEMS user and each VEMS STB user must be unique In large scale deployments with hundreds of boxes creating these users is ...

Page 8: ... Transport Protocols Windows Media in ASF over HTTP H 264 in RTP and MPEG 2 Transport Stream MPEG 4 part 2 over RTP MPEG 2 over Transport Stream Network Connectivity 10 100 Base T Video Outputs NTSC 720x480 30fps PAL 720x576 25fps HD Outputs 720p and 1080i HDMI Component Video S Video and Composite Video Resolutions up to 1920x1080 Audio Outputs Stereo audio Embedded audio on the HDMI interface Fr...

Page 9: ...nel Connectors Table 4 Front Panel LEDs left to right Connector Description USB port Use to connect a USB keyboard IR Supports an IR extender for the remote control A V Output Y Pb Pr component connectors SPDIF used with 5 in 1 audio cable VIDEO composite connector R AUDIO L left right audio out S VIDEO S Video connector Optical Not used HDMI HDMI output Connect to an HDMI compatible TV LAN1 LAN2 ...

Page 10: ... Fullscreen Mode is configured in the channels xml file See Configuring channels xml on page 17 for details Figure 3 Local Mode Local Fullscreen Mode In Local Fullscreen Mode the set top box plays one channel that fills the entire screen A set top box configured for Full Screen Mode is shown in Figure 4 Local Fullscreen Mode is configured in the channels xml file Start Mode Description Local Host ...

Page 11: ...Server Mode VEMS 5 x In Portal Server Mode all live and stored content is hosted from the Portal Server and the MENU button provides a subset of Portal Server functionality To display menu options Note As noted in the Preface there are important differences in behavior depending on whether you are using the set top box with a VEMS 5 x system or with a VEMS 6 x system Whenever there is a difference...

Page 12: ...he PIN see Access Control Users in the Portal Server Admin Guide Live Media Goes to the top level of the Live Media pages Scheduled Displays any scheduled programs currently available for viewing Media Library Goes to the top root level of the Media Library Click on any folder to display the contents of the folder Click Up to return to previous display Search Lets you search for media by Title Tag...

Page 13: ...he search results are displayed When paging through live or stored video press the Live or VOD button to return to page one of the respective live or stored pages Table 6 Remote Control Navigation VEMS 6 x Button Description Search Search for live or stored content Live Video Go to the Live Video page Stored Video Go to the Stored Video page Info Displays information about the currently selected s...

Page 14: ...8 2016 VBrick Systems Inc Figure 7 Search Live or Stored Content VEMS 6 x ...

Page 15: ... set top box is configured for DHCP Dynamic Host Configuration Protocol and will automatically retrieve an IP address from a DHCP server if present If a DHCP server is not present or unavailable you can configure the set top box with a static IP address and other network options If you have the VBDirectory management program installed you easily find any networked VBrick devices See VBDirectory on...

Page 16: ...your system administrator 3 When done navigate to Finish and click OK on the remote control STB Configuration This topic explains how to configure various STB parameters such as start mode and SD or HD Output resolution To configure the set top box using the remote control 1 Power up the box and wait for screen that looks like this 2 When the animated Starting circle is displayed start pressing th...

Page 17: ...ote 4 When the page shown above is displayed move the cursor to Next and press the OK button on the remote control to continue Note that DHCP is enabled by default 5 Portal Page Use this field to select the Start Mode Local Server Other See Table 5 on page 4 for more about these options Use https in the URL to configure the STB for SSL SSL applies when the STB is in Portal Server Mode only When co...

Page 18: ...out this Upgrade URL 6 x only Use this field to take advantage of the upgrade server Each time the unit starts it checks this location for software updates If you do not have an upgrade server and do not plan to have one leave this field blank If this field is populated by an offline server the unit will make 5 attempts to connect and then bypass the upgrade step 6 Set UTC to your local time zone ...

Page 19: ...tput Setting page set HD Output and SD Output to match the display device s you have connected to the set top box You can have multiple devices for example composite and HDMI but the HD and SD outputs must match that is they must both be NTSC or must both be PAL Refer to the table below do not mix and match modes If necessary you can also fine tune the display area for set top boxes see Adjusting ...

Page 20: ...he video it only affects the channel listing and VEMS page display Portal Server Mode You can adjust the display area of output devices by modifying the adjust xml file in VEMS This file is located in the following folder on the VEMS Portal Server C Program Files VBrick MCS VEMSPisces adjust xml NTSC PAL HD Output 1080P30 x 1080P24 x 1080i x 1080i50 x 720P x 720P50 x 576P x SD Output 480i x 576i x...

Page 21: ...r lets you scale the channel listing graphic to match the size of your TV On certain TV sets the image can be chopped of by the bezel causing a loss of graphic imagery You can adjust the value in terms of screen percentage The default is 10 meaning that the graphic image will be reduced by 10 Be aware that all TV s are not alike Values that work on some TV s may not work well on others even the sa...

Page 22: ...emote control 2 When the animated Starting circle is displayed start pressing the Help button on the remote and continue until the Password page is displayed 3 Enter the default password 5678 move the cursor to the OK button using the arrow keys on the remote control and press the OK button on the remote Image URL Upgrade the set top box Enter the path to upgrade image file using FTP or HTTP and p...

Page 23: ...host the STB files with a URL similar to this http local_pc_ipaddr home htm Figure 9 Local Mode Channel Guide Configuring channels xml The following code shows the channels xml file that is used to create the channel guide There is a file header and separate section for each stream Modify this file so that the IP addresses port numbers and messages reflect the actual streams you have available at ...

Page 24: ...e Stream ProgramName RSTP MPEG4 Interleave server session based ProgramName Message rtsp 172 22 123 116 unit116s2 tcp 1 Message URL rtsp 172 22 123 116 unit116s2 tcp 1 URL Stream RTPS MPEG4 Live Stream ProgramName RSTP MPEG4 Live server session based ProgramName Parameter Description Title Company title on upper right screen See Figure 9 GlobalMsg Message displayed under preview window Fullscreen ...

Page 25: ...mName Message rtsp 172 22 128 1 vbStream1S1 Message URL rtsp 172 22 128 1 vbStream1S1 URL Stream H 264 TS Multicast Stream ProgramName H 264 TS Multicast ProgramName Message tv 239 22 128 1 4444 Message URL tv 239 22 128 1 4444 URL Stream H 264 TS Unicast Stream ProgramName H 264 TS Unicast ProgramName Message tv local_ip_address 4444 Message URL tv local_ip_address 4444 URL Stream H 264 TS RTSP S...

Page 26: ...mName Message rtsp 172 22 2 119 CD H264 mp4 Message URL rtsp 172 22 2 119 CD H264 mp4 URL Stream H 264 VODW RTP RTSP Stream ProgramName H 264 VODW RTP RTSP ProgramName Message rtsp 172 22 2 119 Bob H264 RTP mp4 Message URL rtsp 172 22 2 119 Bob H264 RTP mp4 URL Stream MPEG4 VODW RTSP Stream ProgramName MPEG4 VODW RTSP ProgramName Message rtsp 172 22 2 119 CD MPEG4 mp4 Message URL rtsp 172 22 2 119...

Page 27: ...sport stream file from my PC 172 16 2 204 ProgramName Message Playing content via httptv 172 16 2 204 mpeg2test mpg Message URL httptv 172 16 2 204 mpeg2test mpg URL Stream Stream STBLocalUI Sample URLs The following table shows sample URLs for different encoding formats and transport types Table 9 Sample URLs MPEG2 Multicast Live tv 239 16 2 180 4444 MPEG2 VOD W RTSP rtsp 172 22 2 119 AndyM MP2 m...

Page 28: ...r_ip_address My_channels xml mv My_channels xml channels xml sync sleep 2 reboot Using vi This method explains how to edit the channels xml file directly on the set top box using vi a screen based Unix editor For a list of vi commands go to http www cs colostate edu helpdocs vi html To edit the file in place with vi 1 Telnet or SSH into the STB When logging in the user name is iptv the password is...

Page 29: ...file changes for example if you add or change streams you simply update the file in c inetpub wwwroot as explained below and reboot the set top box es The set top boxes will then read the channels file from the PC Configuring a PC as a Web Server In order to host the set top box files on a PC it must be configured as a web server Use the following steps to configure a PC as a web server or to veri...

Page 30: ...es in titanium demo_page kumat vbrick 4 During transfer the file will be automatically copied to c inetpub ftproot 5 After transfer manually copy all of the files from ftproot to c inetpub wwwroot 6 After you have configured the set top boxes to point to the PC as explained in the next section reboot the set top box es and you are done 7 If you subsequently need to change the channels file you sim...

Page 31: ...n you will create three additional channel files for example channel1 xml channel2 xml and channel3 xml Your default channel file could look like the one in the users manual or any other setup of your choice Default Channel This channel file starts up in channel listing mode and sets up a power on default channel to play xml version 1 0 encoding utf 8 STBLocalUI this is general information Title V...

Page 32: ...e an Mpeg2 encoder which is sending multicast xml version 1 0 encoding utf 8 STBLocalUI this is general information Title Video presentation from Company Title GlobalMsg regular telecast GlobalMsg FullScreen 1 FullScreen Mpeg2 multicast stream from VBrick encoder Transport Stream mode IP 239 33 14 77 UDP port 4444 Stream ProgramName Morning announcements Company name ProgramName Message Morning an...

Page 33: ...Telnet 2 At the prompt type the following gotourl file root titanium demo_page kumat vbrick home htm CXML channel3 xml This will load the new channel file So in the above example channel3 xml will go to the third channel file training recorded video as shown above Repeat this step to test channel1 xml and channel2 xml 3 To go back to the default channel file which loads at power up type gotourl fi...

Page 34: ... Telnet SSH or a similar tool Telnet is particularly important if you are unable to access the device through other means For example the box can lock up freeze or hang if you enter erroneous or incompatible setup parameters If this happens Telnet may be the only way to recover To change the Telnet password see Web Interface on page 31 Tool Use to User Name Password Telnet Upgrade STB firmware ipt...

Page 35: ...ces at your site Multi Format STBs are identified in the Model column as STB HWM You can install VBDirectory from the VBrick Support Downloads site Setup The Setup program is the recommended method for configuring the set top box See STB Configuration on page 10 for complete details ...

Page 36: ...o disable access to the Web Interface so that external browsers cannot connect to the internal web server Normally the page associated with this web server allows you to view certain STB information and also allows you to set the Telnet password For internet security reasons you may not want this page to appear or the port to be opened This can be accomplished by editing the config txt file Open t...

Page 37: ...will respond with the following Changing password for iptv Enter the new password minimum of 5 maximum of 8 characters Please use a combination of upper and lower case letters and numbers Enter new password 3 Enter a new password of your choice obeying the min max character rules as explained Press Enter and retype to confirm 4 Once you logoff Telnet you will subsequently need to enter the new pas...

Page 38: ...s you are entitled to receive Multi Format STB v2 0 1 firmware free of charge If you do not qualify with either of these options you can update renew your support contract to become eligible to use this firmware Contact VBrick Support Services to obtain the upgrade image password Using the Setup Program To upgrade using the Setup program press the Help key during a reboot and login with the defaul...

Page 39: ...t any configuration changes will be lost with this option upgrade ftp ipadd8ress Filename img 3 This will keep the old config txt file Reset Factory Default Use this option after a software upgrade is complete to return a unit to its original factory condition If you do this be sure to note all existing settings Also backup any information in the root data folder especially config txt and channels...

Page 40: ... to point to the web server used in Step 1 stb url fwupg http web_server_ip_address upg upgrade upgrade html 3 Repeat Step 2 for each STB 4 Go to the FTP server set up an anonymous FTP account and subfolder and copy the upgrade img file to the subfolder in ftproot Optionally you can use the same IIS server and serve the file using HTTP see Step 5 5 Go to the web server and edit the following line ...

Page 41: ... to upgrade multiple STBs you can find the password protected upgrade image on the VEMS server after the VEMS 6 2 1 or higher software is installed Before unzipping the file you will need to contact VBrick Support Services for the password To unlock the image 1 Navigate to folder containing the upgrade image The folder path see below is slightly different depending on whether the VEMS server is ru...

Page 42: ...configure a DNS entry for myMFSTBUpgradeServer that points to your VEMS server you can go to Step 2a below and set the file name Configure the Upgrade Server URL and Path If you don t have a DNS server or don t make a DNS entry for myMFSTBUpgradeServer you will have to modify the STB configuration in two different places 1 You will need to modify the Upgrade Server Page URL parameter shown in bold...

Page 43: ...l automatically configure the STB s Upgrade URL using the Upgrade Server Page URL entry you entered in the previous step STB in Local Mode If you have a new STB or one which has not been configured for VEMS mode you can use the following steps to set the STB to VEMS mode and configure the Upgrade URL using the VEMS Scheduler feature As explained below the easiest way to accomplish this is to creat...

Page 44: ... choose to run the upgrade or not run the upgrade If you run the upgrade the STB will reboot load new firmware and you are done If you do nothing the upgrade will automatically begin after five minutes If a STB needs to upgrade but the firmware image file is not on the server the failure page below is displayed This page will display every time the STB logs into VEMS including after a schedule run...

Page 45: ...rver Page URL on MFSTB is checked in Global Settings 2 Delete the string in Upgrade Server Page URL and leave the field blank 3 Reboot the STB This can only be done by power cycling the unit or using Telnet 4 When the STB reboots it will no longer attempt to contact the upgrade server ...

Page 46: ...x You can select and play streams by pointing the unit at the infrared sensor on the front in the lower right corner Only those buttons described on the following pages are active Do not press any other buttons on the remote Note that the Remote Control buttons behave differently depending on whether you are in Local Mode or Portal Server Mode If your screen has a Menu option as shown in Figure 10...

Page 47: ...en Vol Adjust the audio up or down CH Advance channel up or down OK Select and play the highlighted channel Initiate an action or select an option depending on cursor focus Arrows Change focus to next item select previous stream Prev Go to previous page Next Go to next page RW VOD content only Rewind the current stream Play Pause Play Pause the selected stream FF VOD content only fast forward the ...

Page 48: ...eturn to previous screen Vol Adjust the audio up or down CH Advance channel up or down OK Select and play the highlighted channel Initiate an action or select an option depending on cursor focus Arrows Change focus to next item select previous stream Prev Go to previous page Next Go to next page RW VOD content only Rewind the current stream Play Pause Play Pause the selected stream FF VOD content ...

Page 49: ...ear Deletes the previous digit or character when entering search parameters or a PIN Page Move to top bottom next or previous page Menu Toggle the Menu on or off Back Not active Vol Adjust the audio up or down CH Advance channel up or down Works only on Full Screen Live Video page OK Select and play the highlighted channel Initiate an action or select an option depending on cursor focus Arrows Cha...

Page 50: ...Using the Remote Control Multi Format STB Quick Start 45 VOD Go to Stored Video page Sched Not active Mark Not active Button Function ...

Page 51: ...IN Page Move to top bottom next or previous page Menu Portal Server mode only Back Return to previous screen Vol Adjust the audio up or down CH Advance channel up or down OK Select and play the highlighted channel Initiate an action or select an option depending on cursor focus Arrows Change focus to next item select previous stream Prev Go to previous page Next Go to next page RW VOD content only...

Page 52: ...de by channel number and then in alphabetical order the channel number will be displayed instead of the fixed live content icon This is seen in the image below When a channel on the remote control is pressed the following may occur 1 The STB will wait two seconds and then switch to the channel entered The channel number is displayed in the lower left portion of the screen or in the center of the s...

Page 53: ...number key is pressed the STB assumes the channel switch is canceled 4 If the channel is not found a Channel Not Found message is displayed in the lower right portion of the screen or the center of the screen if in full screen mode and the STB does nothing further Note When in Search mode the channel number entered must match the search criteria or a Channel Not Found message will display ...

Page 54: ... config txt config txt 2 The config file will typically be copied to C Inetpub ftproot config txt Alternately you can login and edit the file in place using vi 3 Modify the specific parameters as necessary and save the file 4 When done open a Telnet session login to the STB and get the file from your local machine login iptv Password settopbox cd data ftpget local_pc_ip_address u anonymous p passw...

Page 55: ...fig txt version here and retrieve it by a JavaScript API This can help you to identify different STB configuration files stb config version v2 5 1 vbk Page Setting Portal page URL browser document default file root titanium demo_page kumat vbrick home htm Set VBrick server portal page url Note It is the reference value of portal type in booting setup page If setup this value manually please modify...

Page 56: ...age tags are explained in RFC 1766 en English ja Japanese zh tw Chinese Traditional ru Russian document language default en Secondary encoding the number corresponding to the character encoding to use 4 ISO Lartin 1 17 Shift JIS 18 EUC JP 39 ISO 2022 JP 2026 Big5 8 ISO Cyrillic 2084 KOI8 R 2251 Windows 1251 document encoding user 4 Video Audio Output Setting HD SD output format 1080p30 720p 720p50...

Page 57: ...t S PDIF output mode auto pcm pass through stb spdif output auto Setup the default behavior of the decoder health monitor The monitor will check the health of decoder audio video status periodically This setting will determine which source audio and video should be monitored auto decide by audio and video PID If video PID is existed monitor video stauts If audio PID is existed monitor audio status...

Page 58: ...lour back dddddd00 The opacity 0 255 of the highlight shown when an element has focus The highlight colour is determined by the ant highlight color CSS property browser highlight opacity 255 The thickness of the highlight outline If set to 0 the highlight is not drawn as an outline but instead fills the highlighted element s box browser highlight thickness 3 The minimum space pixels between a dial...

Page 59: ...nable second power key on remote controller unit stb remote power2 enable 0 Set to 1 to enable key repeat stb remote repeat enable 1 Set the threshold for repeat clicking from 400 2000 Unit ms stb remote repeat threshold 600 Set the interval for repeat clicking from 400 2000 Unit ms stb remote repeat interval 400 Set the response time for tv channel switch from 500 2100 Unit ms stb switch channel ...

Page 60: ...re on decoding stream Unit ms stb stm pmttimeout 600 Schedule Upgrade Setting Schedule upgrade quick check URL It s a hidden and simple page that for quick check if upgrade is necessary or not STB connect to this URL when current time is stb schedule upgrade time This page MUST as simple as it can for reduce STB loading and speed check time stb schedule upgrade quickcheck url Schedule upgrade chec...

Page 61: ...ntroller multicast remote control need 4 ports If set 9091 as a fisrt port 9092 9093 9094 will be used for multicast remote control stb ezcontroller multicast port 9091 Set the ezcontroller unicast remote control enable stb ezcontroller unicast enable 1 Set the port of ezcontroller unicast remote control stb ezcontroller unicast port 9095 Set the upgrading progress page URL of ezController stb ezc...

Page 62: ...t 80 The max session number that are allowed to login to stb web service Valid value is 1 32 stb webservice login maxsessionnumber 1 The auto logout time of stb web service Valid value is 10 86400 in seconds stb webservice login autologouttime 20 Set 0 to disable stb web server stb webserver enable 1 Serial pass through Setting Set to 1 to enable serial pass through transmit stb serpassthru enable...

Page 63: ...eplaced with the program name v with the program version and o with the operating system name browser header useragent Mozilla 5 0 compatible ANT p v o Pisces 00 Set true or false to turn on When set to true the browser will not allow a self redirection object loop detection enabled false Error Page Setting The ident of the file path in which to store error page transports err path about Set to 1 ...

Page 64: ...under or equal to this value will be shown Current 8 levels and their meaning are provided 0 LOG_EMERG system is unusable 1 LOG_ALERT action must be taken immediately 2 LOG_CRIT critical conditions 3 LOG_ERR error conditions 4 LOG_WARNING warning conditions 5 LOG_NOTICE normal but significant condition 6 LOG_INFO informational 7 LOG_DEBUG debug level messages stb log syslog level 5 Certificate Set...

Page 65: ...c transports cookie uptodate 1 transports files cookie root data cookies txt webimage animation buffer size 1500000 window overflow ignore negative 1 window caret block 0 window caret colour 00000000 object cache ram size 4196 ...

Page 66: ......

Page 67: ...VBrick Systems Inc 2121 Cooperative Way Suite 100 Herndon VA 20171 ...

Reviews: