Configuring ZeeVee Products ZvCli User Manual Revision 1.1 Advanced configuration for Commercial and Prosumer products Configuring ZvBox can be as simple as changing the RF channel used for broadcast, or as powerful as associating audio ports with video ports and controlling how video gets processed and broadcast. ZvCli also offers the ability to upgrade firmware in ZvBox, perform cable scans, and easily configure ZvBoxes in large deployments through batch processing.
Contents Configuring ZeeVee’s Products ........................................................................................................................ 4 Downloading and Installing ZvCli........................................................................................................................... 4 Starting ZvCli ..........................................................................................................................................................
Advanced Firmware Download and Installation Commands ....................................................................... 19 Displaying Downloadable Firmware Images on ZeeVee’s Download Server .................................................. 20 Downloading a Firmware Image from ZeeVee’s Download Server ................................................................ 20 Display Downloaded Firmware ...........................................................................................................
Configuring ZeeVee’s Products ZeeVee products can be configured through a USB connection to a computer running ZvCli – a PC‐based software application that can be downloaded from the ZeeVee website. Configuration is very simple, and usually just involves setting the RF channel on which the ZvBox will broadcast. On some products more advanced settings are available, such as associating audio and video inputs. Any settings that are made are stored in ZvBox and not lost on power‐down.
‐ o Add a space after a complete command o List command options that a user must select from If you are connected and communicating with a ZvBox, all text is show in white o If the connection is ever lost, a message is printed and the text turns red o During a reset or reboot, the text will turn red at first, then turn back to white when the connection is restored. Quick‐start This document describes many settings that can be made to the ZvBox.
Hardware revision Uboot revision Firmware revision Firmware install date Temperature Boot count EDID underscan resolutions USB device type Serial console baud rate Date/time on device Uptime (since OS boot) ZvCli$ : 1(17) : U‐Boot 1.1.17 (Sep 24 2008 ‐ 10:52:12) : 2.0.0.
Example: ZvCli$ show config set management‐mode standalone set audio‐for‐component analog set audio‐for‐vga analog set cable‐plan standard set mpeg2 dc‐coefficient‐size 10‐bit set mpeg2 audio‐delay 5 set mpeg2 output‐data‐rate normal set mpeg2 starting‐pid‐number 256 set mpeg2 program video1 eit‐name "Video Over COAX" set mpeg2 program video1 eit‐tv‐rating TV‐G set mpeg2 program video1 long‐channel‐name "Welcome To ZeeVee ZvCast" set mpeg2 program video1 hdtv‐channel 200.
Transmit status : *Transmitting, conflict detected Energy was detected on this rf‐channel, so there may be another source transmitting on this rf‐channel. If you experience problems tuning this channel, you may wish to scan for free rf‐channels and change the configuration to transmit on a free rf‐channel. Input video resolution : unrecognized Unable to determine the input video resolution. Ensure that the video source is transmitting a standard resolution.
RF‐channel occupancy using cable‐plan: standard RF‐channel 2 is occupied (digital) RF‐channel 3 is occupied (digital) RF‐channel 4 is free RF‐channel 5 is free RF‐channel 6 is free RF‐channel 95 is free RF‐channel 96 is free RF‐channel 97 is occupied (digital) … … RF‐channel 135 is free Scan complete Analog signals detected on the following 1 RF‐channels (cable‐plan standard): 14 Digital signals detected on the following 15 RF‐channels (cable‐plan standard): 2 3 7 8 9 17 18 19 20 21 22 49 97 9
Turn RF Output On/Off Syntax set rf‐output {off | on} factory default: on In normal operation, ZvBox is usually broadcasting something – either live video data from some source, or an internally generated idle screen. However, there are times when it is important to stop broadcasting while certain settings such as programming HDTV channel numbers or the RF channel are changed. Example: set rf‐output off Set RF Channel Sets the RF channel used for broadcast Syntax set rf‐channel <2..
If you are not sure of the cable plan in use in your deployment, run ‘system cable‐scan cable‐plan auto‐detect’. It will tell you what cable plan is in use. Example: ZvCli$ set cable‐plan standard Success Set RF Output Power Sets the power level that ZvBox will use when broadcasting.
If None is selected, no audio will be passed with the video stream Example: ZvCli$ set audio‐for‐component spdif‐optical Success ZvCli$ set audio‐for‐vga analog Success Video Input Commands These commands are used to select what video source to broadcast, and set some parameters for how to process that video. Select Active Video Source Selects the video input that will be encoded and broadcast. Audio will be processed based on the audio port associated with the selected video input.
set output‐frame‐rate‐for‐720p {30fps | 60fps} factory default: 30fps Set Output Resolution for VGA Input This advanced command is only intended for one specific case, and in almost all cases the default setting of ‘auto’ should be used. When the video‐source is VGA, ZvBox outputs either a resolution of 720p or 1080p. In almost all situations, it is best to let ZvBox automatically determine which to output, based on the ZvBox model and the resolution of the input source.
their analog equivalents, but still found by the user on familiar channel numbers. The HDTV Channel is sometimes referred to as a Logical or Virtual Channel. Syntax set mpeg2 program {video1} hdtv‐channel <0..1023>. <0..1023> factory default: 2.1 Example: ZvCli$ set mpeg2 program video1 hdtv‐channel 53.1 Success Sets the virtual channel to 53.1, which can be tuned in at the HDTV by entering 53.1. Note – Some HDTVs use a dash instead of a dot. Some TVs will also find your new channel if you just enter 53.
The values sent follow MPEG2 and CEA‐766 specification, region 1 (USA), dimension 0 (TV‐Rating). Note that TV‐MA‐LSV is the most extreme content, with LSV short for “Language, Sex, Violence”. Syntax set mpeg2 program {video1} eit‐tv‐rating { TV‐Y | TV‐G | TV‐PG |TV‐14 |TV‐MA |TV‐MA‐LSV} factory default: TV‐G Example: ZvCli$ set mpeg2 program video1 eit‐tv‐rating TV‐MA Success MPEG2 Encoding Control This group of commands can be used to fine‐tune the characteristics of the MPEG2 encoder.
Syntax set watermark‐visual { off | on } factory default: on Advanced MPEG2 and Transport Commands Commands in this section should only be used if you have a strong understanding of MPEG2 encoding management of program streams in a cable environment. Set Audio Delay Syntax set mpeg2 audio‐delay <2..10> factory default: 5 In some deployments, audio may not arrive to the ZvBox perfectly synchronized with the video. When this happens, the picture on the HDTV will have a “lip sync” issue.
Syntax set mpeg2 program {video1} program‐number <1..65535> factory default: 1 Example: ZvCli$ set mpeg2 program video1 program‐number 1 New value set but will not take effect until ZvBox is restarted. Use 'system restart' to restart the system. ZvCli$ system restart Success There is currently only one named program – video1. This command assigns a program number to that named program.
Downloading firmware (‘download firmware’) will attempt to set the ZvBox firmware to the correct revision as determined by the ZeeVee download servers and the ZvBox serial number. In most cases, if available, newer firmware is loaded. It is possible that an earlier revision is loaded instead – this can happen if some problem was detected in the current firmware, and a step back is preferred.
"set mpeg2 output‐data‐rate normal" Success "set mpeg2 starting‐pid‐number 256" Success "set mpeg2 program video1 eit‐name "eit name"" Success "set mpeg2 program video1 eit‐tv‐rating TV‐14" Success "set mpeg2 program video1 long‐channel‐name "long channel name"" Success "set mpeg2 program video1 program‐number 1" Success "set mpeg2 program video1 short‐channel‐name "shortpn"" Success "set mpeg2 program video1 hdtv‐channel 400.
The advanced download commands allow you to: • View available downloadable firmware images on ZeeVee’s download server. • Download specific firmware images from ZeeVee’s download server to your computer without needing a connection to a ZvBox. • Install a specific firmware image to ZvBox without an Internet connection. Displaying Downloadable Firmware Images on ZeeVee’s Download Server One can see what firmware images are available to be downloaded.
Downloading file 2_0_0_6665.gpg2 from server... 583639 / 19002258 bytes downloaded 4918539 / 19002258 bytes downloaded 7504039 / 19002258 bytes downloaded 14107619 / 19002258 bytes downloaded 19002258 / 19002258 bytes downloaded Download from server to local file system successful ZvCli$ Display Downloaded Firmware This command shows what versions of firmware have been download to the computer and are available to be installed to ZvBox.
Remove Downloaded Firmware from Computer This command allows you to remove the firmware images that you have stored on your computer. Syntax download advanced remove‐downloaded‐firmware Example: ZvCli$ download advanced remove‐downloaded‐firmware Removed file: 2_0_0_6665.gpg2 (ZvPro‐250) Removed file: 2_0_2_7076.
={0‐59} e.g. set date 2009 01 29 15 39 07 ZvCli$ set date year 2008 month 01 day 06 hour 09 minute 04 second 00 # Sets the date to January 6, 2008, 9:04 AM Set Management Mode This command controls how the ZvBox will be deployed. ‐ Standalone mode is used when ZvBox will be used in a mode where it is simply capturing video and broadcasting the information, and has no need for on‐the‐fly changes. This is the most common mode used in commercial deployments.
Restart Video Processing This command tells ZvBox to completely restart all video processing. The broadcast will temporarily stop, and will resume when the restart completes. This command is *required* after making changes to some of the MPEG2 settings (e.g. program number or starting pid number). Syntax system restart Zv‐Cli v1_1 www.zeevee.
ZvCli and Serial Console Command Summary Factory defaults are underlined where applicable. {} encase a choice. <> encase a value. [] encase optional parameters. Status Commands show system‐status show av‐status show config show analysis show zvcli‐info RF, Cable and Broadcast Commands system cable‐scan [cable‐plan {standard |HRC | IRC | auto‐detect}] system cable‐print‐last‐scan‐results set rf‐output {off | on} set rf‐channel <2..
Advanced MPEG2 and Transport Controls set mpeg2 audio‐delay <2..10> set mpeg2 dc‐coefficient‐size {8‐bit | 9‐bit | 10‐bit | 11‐bit} set mpeg2 program video1 program‐number <1..65535> set mpeg2 starting‐pid‐number <32..
