ZeeVee ZvCli User manual

ZeeVee
Brand
ZeeVee
Model
ZvCli
Type
User manual
 
ConfiguringZeeVeeProducts
ZvCliUserManual


Revision1.3
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. 

If you run into any problems, please refer to the Zv
Support page at www.zeevee.com
, where you will find
answers to frequently asked questions and helpful tips
fromZeeVeeexperts.Ifyoustillcannotfindtheanswers
you need, our technical support hotline at 877‐5ZEEVEE
(877‐593‐3833)isheretohelp.

Zv‐Cliv1_3www.zeevee.com  Page2of32
Contents
ConfiguringZeeVee’sProducts........................................................................................................................4
DownloadingandInstallingZvCli..................................................................................................................4
StartingZvCli................................................................................................................................................4
UsingZvCli‐TipsandTricks..........................................................................................................................4
Quick‐start.......................................................................................................................................................5
OptimizingPictureQuality...............................................................................................................................6
CompensatingforcroppedvideofromVGAsources.........................................................................................6
CLICommands.................................................................................................................................................7
StatusCommands........................................................................................................................................7
Show
SystemStatus..........................................................................................................................................7
ShowAudio/VideoStatus................................................................................................................................8
ShowConfiguration...........................................................................................................................................8
AnalyzeCurrentConfigurationandStatus........................................................................................................9
ShowZvCliInformation...................................................................................................................................10
RF,CableandBroadcastCommands...........................................................................................................10
CableScan.......................................................................................................................................................10
ShowLastCableScanResults..........................................................................................................................12
TurnRFOutput
On/Off....................................................................................................................................12
SetRFChannel.................................................................................................................................................12
SetCablePlan..................................................................................................................................................13
SetRFOutputPower.......................................................................................................................................13
AudioInputCommands.............................................................................................................................. 14
AssociateAudioInputforVGAandComponentInputs..................................................................................14
VideoInputCommands.............................................................................................................................. 14
SelectActiveVideoSource..............................................................................................................................14
SelectUnderscanResolutions
toPresentinVGAEDID...................................................................................15
CustomizeIdleScreenandVisualWatermark................................................................................................16
VideoCalibration.............................................................................................................................................17
VideoOutputCommands........................................................................................................................... 17
SetOutputFrameRatefor720p.....................................................................................................................17
SetOutputResolutionforVGAInput..............................................................................................................18
SettingProgram(HDTV/VirtualChannel)Information...............................................................................18
SetChannelName...........................................................................................................................................18
SetHDTVChannelNumber.............................................................................................................................18
SetEventInformationTable(EIT)Name(HDTVProgramGuideEntry)..........................................................19
SetEITRating...................................................................................................................................................20
MPEG2EncodingControl............................................................................................................................20
SetEncodingBitRate......................................................................................................................................20
VisualWatermark............................................................................................................................................21
AdvancedMPEG2andTransportCommands.............................................................................................. 21

SetAudioDelay...............................................................................................................................................21
SetDCcoefficientprecision.............................................................................................................................21

Zv‐Cliv1_3www.zeevee.com  Page3of32
SetProgramNumber.......................................................................................................................................22
SetPacketIdentifier(PID)...............................................................................................................................22
SystemMaintenanceCommands................................................................................................................22
SoftwareDownload.........................................................................................................................................23
ConfigurationScriptread/write....................................................................................................................23
SendingTroubleshootingReports...................................................................................................................24
AdvancedFirmwareDownloadandInstallationCommands.......................................................................25
DisplayingDownloadableFirmwareImagesonZeeVee’sDownloadServer..................................................25

DownloadingaFirmwareImagefromZeeVee’sDownloadServer................................................................26
DisplayDownloadedFirmware.......................................................................................................................27
InstallDownloadedFirmwaretoZvBox..........................................................................................................27
RemoveDownloadedFirmwarefromComputer............................................................................................27
MiscellaneousCommands..........................................................................................................................28
TransmitIRCodesforLearning.......................................................................................................................28
SetDate...........................................................................................................................................................28
SetZvBoxName...............................................................................................................................................29
SetLEDBrightness(ZvBox‐150only)...............................................................................................................29
Enable/DisableSelectButton(ZvPro‐250only)..............................................................................................29
ResettoFactoryDefaults................................................................................................................................29
RebootZvBox...................................................................................................................................................29
RestartVideoProcessing.................................................................................................................................30
IdentifyingPhysicalZvBox...............................................................................................................................30
ZvCliandSerialConsoleCommandSummary.............................................................................................31
















Thissoftwareusesseveralopen‐sourcelibraries:
β€’ FreeImage,usedundertheFIPL,version1.0.Seehttp://freeimage.sourceforge.net
fordetails.
β€’ Curl,usedunderaBSD‐stylelicense.Seehttp://curl.haxx.se
fordetails.

Zv‐Cliv1_3www.zeevee.com  Page4of32
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.

SomeZeeVeeproducts(primarilytheProline)haveanRS‐232serialportaswell.Thishelpswithremote
managementandinputswitching,andmakes
itpossibletointegrateZeeVeeproductswithtraditional
automationsystems.MostsettingsandcommandsyntaxthatareavailablethroughZvCliarealsoavailable
throughtheserialinterface.Mostnotablymissingaretheabilitytoupdatetheunit’sFirmware,andtheability
tosaveorloadsettingsfromafile.The
commandsummaryattheendofthisdocumentgivestheport
specifications.
DownloadingandInstallingZvCli
ZvCliisavailablefordownloadfromtheZeeVeewebsiteatwww.zeevee.com/commercial/zvcli.

Important:ZeeVeeregularlymakesimprovementstovideoandaudioquality,andoverallfunctionality.Always
checkforupdatedfirmwareforyourZvBoxbeforedeployingtheunit.Thisisdonebyusingtheξ€ƒβ€œdownload
check”commandinZvCli.
StartingZvCli
Onceinstalled,ZvClicanusuallybefoundunderξ€ƒβ€œStart/AllPrograms/Zv/ZvCli”.Oncelaunched,theprogram
willattempttocommunicatewithyourZeeVeeproduct viaaUSBconnection.However,itisimportantto
understandthatZvBoxorZvPromightnotbeξ€ƒβ€˜listening’totheUSBport.It
ispossibletoconfiguretheUSBport
oncertainmodelstoactasaUSBaudiodevice‐oncetheyareoperatinginthatmode,ZvClicannot
communicatewithZvBox.Toassureaconnection,performthefollowingsteps:
1. StartZvCli.Ifthesoftwarereportsthattheconnectionsucceeded,youare
allset,andcancontinueto
useZvClitoconfiguretheproduct.
2. Ifthesoftwaresaysthattheconnectionisdown(anddisplaystheoutputtextinred),unplugtheUSB
cablebetweentheZvBoxandthecomputer,andthenreconnectit.Waitafewmoments‐ifsuccessful,
ZvCliwill
automaticallyreportthataconnectionis nowavailable.
Note‐IfZvBoxwasusingtheUSBportasanaudiodevice,audiomaybedisableduntilyouhavecompleted
configurationchanges,exitedfromZvCli,thendisconnectedandreconnectedtheUSBcable.
UsingZvCli‐TipsandTricks
ZvCliisaverysimple,yetverypowerfulinterface.Hereareafewtipsthatmakeusingiteasy.Note‐mostare
identicalthroughtheserialconnectionaswell.
‐ Factorydefaultsareunderlinedinthisdocumentwhereapplicable.
‐ <>encaseavalue,{}encaseamandatorychoice.[]encase
optionalparameters.
‐ Precedinganylinewith#makestheremainingtextonthatlineacomment.
‐ Textstringsthatcontainspaces,likechannelnames,needξ€ƒβ€œquotes”aroundthem.

Zv‐Cliv1_3www.zeevee.com  Page5of32
‐ Reallypowerful–Ifyoustarttypinganycommandandhit<TAB>,itwillshowyouwhatyourchoicesare
andwillauto‐completeforyouifitcan.Giveitatry. Tabwillalwaysdooneofthefollowing;
o Addtexttocompleteacommand,orportionof
acommand
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shown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.Atfirstglance,theycanbeintimidating
andconfusing,especiallyifyouarenotfamiliarwithHDTVbroadcastingandassociatedjargon.Fearnot!In
mostcases,theonlysettingyouwillneedtomakeistellingZvBoxwhatchannel
tobroadcaston.

Note–makesureyourHDTVissetinCablemode,vs.AntennaorOver‐the‐airmode.ZvBoxbroadcastsusing
QAM–thesamestandardusedbycablecompanies.

1. ConnectZvBoxtoyourcomputerusingtheincludedUSBcable
2. StartZvCliasdescribedabove

3. Enterthefollowingcommands:
setrf‐outputoff
setrf‐channel53
setmpeg2programvideo1hdtv‐channel53.1
setrf‐outputon
setaudio‐for‐componentspdif‐coax

That’sallthereistoit!YourZvBoxshouldnowbebroadcastingonRFchannel53,andcanbetuned
inatyour
HDTVbyentering53.1.Note–sometimesachannelscanisrequiredattheHDTVbeforethenewchannelis
recognized.

Therestofthismanualwillhelpyouunderstandhowtogetsoftwareandfirmwareupdates,andhowtomake
othersettingsorgethelpfulinformation
thatmaybeusefulindifferentscenarios.



 

Zv‐Cliv1_3www.zeevee.com  Page6of32
OptimizingPictureQuality
Forthebestpicturequality,performthefollowingsteps:
1. SetVGAsourcestooutputa1280x720image.Thiswillresultinanoptimal qualitypicturethatfillsthe
screenproperly.IfpartoftheimageiscroppedoffbyyourTV,seethesectiontitledCompensatingfor
TV
overscanbelow.
2. SetComponentVideosourcestooutputa720presolutionwheneverpossible
3. Runtheξ€ƒβ€œdownloadcheck”commandinZvClito:
a. Makesureyou’reusingthelatestversionoftheZvClisoftware
b. MakesuretheZvBoxfirmwareisuptodate‐newerfirmwareoftendeliverspicture
quality
enhancements.
4. MakesuretheZvBox’sξ€ƒβ€œoutputdatarate”issettoξ€ƒβ€œhigh”toenhancepicturedetail(β€œsetmpeg2output‐
data‐ratehigh”).Note:someHDTVswon’tworkproperlywiththissetting,andpicturebreakupduring
fastactionsceneswilloccur.Simplyresettheoutputdataratetoξ€ƒβ€œnormal”if
thishappens.
5. Forthesmoothestmotionvideo,makesureξ€ƒξ€ƒβ€œoutputframeratefor720p”issettoξ€ƒβ€œ60fps”;(β€œsetoutput‐
frame‐rate‐for‐720p60fps”).Note:thissettingisavailableonlyontheZvProlineofproducts.

Finally,ifyou’rehavingpicturequalityissues,e.g.nopicture,image
breakup,imagecropping,etc.,pleasesee
ourFAQsatwww.zeevee.com/commercial/faqs.
CompensatingforcroppedvideofromVGAsources
DigitalTelevisionshaveunfortunatelyinheritedaverybadtraitfromtheiranalogTVpredecessors:something
calledoverscancompensation.Intheξ€ƒβ€˜olddays’,thepicturewasstretchedbeyondtheedgesofthescreenso
thatthebeamretracedidn’tdisrupttheimage.Whatthatreallymeansisthatportionsofthepicture
arelost–
andeachTVmodelchoppedoffdifferentamounts.Forsomecrazyreason,thisstillhappenstodayondigital
TVs!Eventhoughwesend*exactly*1920x1080pixels,TVswillstillthrowsomepartofthisawaybefore
displayingtheimage.Theamountlostcanbeasmuchas
15%ormoreonsomeTVs!SomeTVsallowyouto
controlthis(lookforsettinglikeUnscaledorNativeinPicturesettings).Mostdonotletyouoverrideit.

ComponentVideosourceshavealwaysbeendesignedtobedisplayedonTVswiththepossibilityoflosinga
portionofthe
picture.Contentisspeciallydesignedtokeepimportantinformationinsideofaξ€ƒβ€˜safearea’.
Thereisnoneed(andnoability)toadjustthesourcetofittheTVbetter–justknowthatyoumayseealittle
moreononeTVwhencomparedtoanother.

VGAsourcesare
quiteadifferentmatte r.Theseareusuallycomputerimagesthathaveimportantinformation
ontheedgesofthescreen.WindowshasaStartbuttonandthetaskbarrightontheedge.Applehasadock
ontheedge.Digitalsignageapplicationstypicallyputanewscrawlontheedge.
Anycroppingoftheimage
mayloseveryimportantinformation.

ZeeVeehasdevelopedapatent‐pendingmechanismtohelpyoucompensateforthisbehavior.Bychangingthe
informationpresentedtothecomputerovertheEDIDontheVGAconnected,wecangivethecomputeran

Zv‐Cliv1_3www.zeevee.com
Page
7of32
alternateresolutiontouseinstea dofthedefault–onethat’sali ttlesmaller.Althoughtheproductshipswitha
defaultunderscanresolution,wealsoallowyoutooptimizethesettingstomatchtheexactbehaviorofyourTV.

Herearethestepsinvolved:
1) BroadcastaVGAsourceto
yourHDTV(s).NotewhichTVcropsoffthemost.
2) AttheCLI,typeξ€ƒβ€œsetvideo‐sourcetest‐image‐1”
3) OntheTVthatcropsthemost,readoffthelargestresolutionthatisvisible.Itwilllooklikethis:

4) Usethesetvga‐edid‐underscan‐resolution‐720
commandandentertheresolutionthatyousaw.
a. Note:OnApplecomputers,theXhorizontalresolutionmustbedivisibleby16.
5) UnplugtheVGAcablefromyourcomputer,waitafewseconds,andreconnectit.Thereshouldnow
beanewresolutionavailableinyourξ€ƒβ€œdisplayproperties’that
matchesyoursetting.Selectit.Your
screenshouldnowperfectlyfitonyourHDTV.
6) Thereisnotestimageavailabletodayfor1080.However,thepercentagecroppedfor720isusuallythe
sameasfor1080.Computethecropped1080resolutionfromyour720resultsandenterthatintothe

underscanresolutionfor1080.
CLICommands
StatusCommands
ThesecommandshelpyouseehowtheZvBoxisconfigured,aswellassomeinternalstatus.
ShowSystemStatus
Showsalargevarietyofinformationaboutthesystem,includingrevisions,serialnumbers,etc.
Syntax
showsystem‐status

Example:
ZvCli$showsystem‐status
Model:ZvPro250
Productserialnumber :LXX8410004A

Hardwarerevision  :1(17)
Ubootrevision   :U‐Boot1.1.17(Sep242008‐10:52:12)
Firmwarerevision :2.0.0.5783

Zv‐Cliv1_3www.zeevee.com  Page8of32
Firmwareinstalldate :Tue2009‐Jun‐1617:45:28EasternDaylightTime
Temperature  :Okay(42C,41C,44C)
Bootcount  :58OSboots,91Encoderboots
CustomVGAEDIDresolutions :1280x720,1208x679,1920x1080,1808x1017
USBdevicetype  :serial/audiocomposite
Serialconsolebaudrate :9600(8‐N‐1)

Date/timeondevice :2008:01:01:00:11:19UTC(Tue2008‐Jan‐0100:11:19UTC)
Uptime(sinceOSboot) :1day,19hours,46minutes,13seconds
ZvCli$
ShowAudio/VideoStatus
ProvidesinformationaboutwhatZvBoxisseeingonitsvideoinputs,whatformatisbeingusedtobroadcast,
and
otherinformationthatcanbehelpfulduringinstallation.
Syntax
showav‐status

Example:
ZvCli$showav‐status
Transmitstatus  :Transmitting
Transmitrf‐channel :2
Transmithdtv‐channel :2.1
Transmitmodulation :QAM
Transmitcable‐plan :standard
Inputvideosource :VGA
Inputvideoformat :1280x720progressive

Outputvideoformat :720p
Inputaudiosource :spdif‐coax
Inputaudiostatus :supportedformat
Inputaudioformat :PCM
Inputaudiochannels :2/0,L,R
Inputaudiobit‐rate :unknown
Inputaudiosample‐rate :48000Hz
Outputaudiostatus :transmittingreceivedaudio
Outputaudio
format :AC3
Outputaudiochannels :2/0,L,R
Outputaudiobit‐rate :192kbps
Closedcaptiondevicestate :connecte d
Closedcaptionbytesreceived :20043
ZvCli$ 
ShowConfiguration
Showsthecurrentconfiguration.Itispresentedasaseriesofcommandsandtheircurrentvalues;the
commandsand
valuescanbecopiedandpastedintoa scriptfile,makingiteasytocopytheconfigurationofone
ZvBoxtoothers,ortorestoresettingsatalatertime.AlsoseetheScriptRead/Writecommands.Note:Ifyou
makeanychangestoascript,beforesavingmakesurethescript
beginswiththecommandξ€ƒβ€˜setrf‐outputoff’

Zv‐Cliv1_3www.zeevee.com  Page9of32
andendswithξ€ƒβ€˜setrf‐outputon”.TurningtheRFoutputoffisapre‐requisiteforseveralcommands(likeξ€ƒβ€˜setrf‐
channel’),andturningitbackonisrequiredfortheZvBoxtooutputachannel .

Syntax
showconfig

Example:
ZvCli$showconfig

#DisableRFoutputtobe
safewhileconfiguringotheritems
setrf‐outputoff

setaudio‐for‐componentanalog
setaudio‐for‐vgaanalog
setcable‐planstandard
setcustom‐idle‐screenξ€ƒβ€œβ€ξ€ƒ
setcustom‐watermarkξ€ƒβ€œβ€ξ€ƒ
setled‐brightnesshigh
setmpeg2audio‐delay4
setmpeg2dc‐coefficient‐size10‐bit
setmpeg2
output‐data‐ratenormal
setmpeg2programvideo1eit‐name"VideoOverCOAX"
setmpeg2programvideo1eit‐tv‐ratingTV‐G 
setmpeg2programvideo1hdtv‐channel2.1
setmpeg2programvideo1long‐channel‐name"WelcomeToZeeVeeZvCast"
setmpeg2programvideo1program‐number1
setmpeg2programvideo1
short‐channel‐name"ZvCast"
setmpeg2starting‐pid‐number256
setoutput‐frame‐rate‐for‐720p30fps
setrf‐channel2
setrf‐power5‐highest
setselect‐buttonenabled
setvga‐edid‐underscan‐resolution‐10801808x1017
setvga‐edid‐underscan‐resolution‐7201208x679
setvga‐output‐resolutionauto
set
video‐sourcecomponent
setwatermark‐visualon
setzvbox‐name"unnamed"

#Followingistheconfiguredrf‐outputvalue
setrf‐outputon

ZvCli$
AnalyzeCurrentConfigurationandStatus
ZvCliisabletolookatZvBox’scurrentconfigurationandstatus,andwillreportwarningswhenthingslookξ€ƒβ€˜odd’.
Thefollowing
itemsarechecked.

Zv‐Cliv1_3www.zeevee.com  Page10of32
‐ ZvCliandFirmwareVersion:WarningifthereisanewerZvCliorFirmwareavailable.
‐ Date:WarningifthedateonthecomputerdiffersgreatlyfromthedateinZvBox.
‐ VideoInput:Warningifthevideoformatontheactivevideoinputisunrecognized.
‐ AudioInput:Warningif
theaudioformatontheactiveaudioinputisnotrecognized.
‐ RFConflict:ZvBoxcheckstheselectedRFchannelforconflictbeforetransmitting.

Syntax
showanalysis

Example:
ZvCli$showanalysis
Host'scurrentdate/time:2009:02:02:15:00:21UTC(Mon2009‐Feb‐0210:00:21EasternStandardTime)
ZvBoxdate/time :2008:01:04:20:56:56UTC
(Fri2008‐Jan‐0415:56:56EasternStandardTime)
Thedate/timeonZvBoxissignificantlydifferentthanthetime
onthismachine(host).Youmaywishtosetthedate/timevia
'setdate'.
Transmitstatus :*Transmitting,conflictdetected
Energywasdetectedonthis rf‐chan nel,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.
ZvCli$
ShowZvCliInformation
ProvidesinformationabouttherunningZvCli.
Syntax
showzvcli‐info

Example:
ZvCli$showzvcli‐info
ZeeVeeCommandLineInterface(version2.1.0.5609)
Copyright2009,ZeeVeeInc.
ZvCli$ 
RF,CableandBroadcastCommands
Thesecommandsareusedforsettingsrelatedtothelocalcableplant,andhowZvBoxwillbroadcast.
CableScan
ZvBoxproductscontainaverypowerfulfeaturethathelpstheinstallergreatly–abuilt‐incablespectrum
analyzer.Whenasked,ZvBoxwillstoptransmitting,analyzeeveryRFchannelonthecable
andreportthe
result.Thereportshowsifachannelisopenoroccupied,andifoccupied,ifthechannelisAnalogorDigital.


Zv‐Cliv1_3www.zeevee.com  Page11of32
Syntax
systemcable‐scan[cable‐plan{standard|HRC|IRC|auto‐detect
}]
Youcanoptionallysupplythecableplan(standard,HRCorIRC).Ifomitted,auto‐detectisused.

Theauto‐detectoptionwilltrytodeterminetheplanthatisinuseandbehaveaccordingly.Thisisreliable
whenthereareareasonablenumberofotherchannelsonthecable
fortheZvBoxtoprobe.Arelativelyempty
cablemayyieldunreliableresults.Duringthescan,connectingZvBoxtothecableplantusingthesame
connectionthatyouwouldusetoconnectanHDTVwillyieldthebestresults.

ScanningisdonefromthelowestRFfrequencytothehighest,
thoughtheRFchannelnumbersbeingscanned
willappearon‐screeninanon‐linearorder(i.e.channel95willappearafterchannel6).Thisisnormal‐please
donotstopthescanprematurely.Manydifferentpartsofthesystemareinvolvedwiththescan,andmay
becomeconfusedifnot
allowedtocompletetheirtask.

Example:(someresultsomittedtosavespace)
ZvCli$systemcable‐scan
Initiatingscan,pleasebepatient,thiscantakeafewminutes...
Firstattemptingtodeterminecableplaninuseonthecable...
Detectedcable‐plantype:standard
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 98 99

Nosignalsdetectedonthefollowing118RF‐channels(cable‐planstandard)andareavailableforuse:
4 5 6 10 11 12 13 15 16 23 24 25 26 27 28 29 30 31 32 33
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 50 51 52 53 54
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
95 96 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135
ZvCli$

Zv‐Cliv1_3www.zeevee.com  Page12of32
ShowLastCableScanResults
ZvBoxrememberstheresultsofthelastcablescanperformed.Thiscommandshowstheresults.

Syntax
systemcable‐print‐last‐scan‐results

Example:
ZvCli$systemcable‐print‐last‐scan‐results

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 98 99

Nosignalsdetectedonthefollowing118RF‐channels(cable‐planstandard)andareavailableforuse:
4 5 6 10 11 12 13 15 16 23 24 25 26 27 28 29 30 31 32 33
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 50 51 52 53 54
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
95 96 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135

ZvCli$
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arechanged,suchasprogrammingtheHDTVchannelnumber
ortheRFchannel.

Example:
setrf‐outputoff
SetRFChannel
SetstheRFchannelusedforbroadcast

Syntax
setrf‐channel<2..135> factorydefault:2

SetstheRFchannelfrequencyusedtotransmit.Theexactfrequencyfollowsstandardchannelplacement,and
isalsoafunction
ofthecablechannelplan(Standard,HRC,IRC).ZvBoxcreatesawell‐formedcablechannel,
andmaybeplacednexttoexistingchannelswithoutconcern .

Zv‐Cliv1_3www.zeevee.com  Page13of32

Note–ChangingtheRFchannelnumberisusuallyaccompaniedbychangestotheHDTVchannelnumbers.
HDTVscanbecomeconfusedifthesechangesarenotdonesimultaneously.ZvClirequiresturningofftheRF
outputwhilemakingthesechanges.

Example:
ZvCli$setrf‐outputoff
Success
ZvCli$setrf‐channel
53
Success
ZvCli$setmpeg2programvideo1hdtv‐channel53.1
Success
ZvCli$setrf‐outputon
Success
SetCablePlan
EstablishesthecablechannelplantouseforRFchannellayout.

Syntax
setcable‐plan{standard
|hrc|irc}   factorydefault:standard
ZvBoxneedstoknowtheplanlayoutsothatitcanproperlyconvertthedesiredRFchannelnumberintothe
exactRFfrequencytotransmit.Severaldifferentlayoutsexist,althoughξ€ƒβ€˜standard’seemstobethemost
common.

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.

Syntax
set
rf‐power{1‐lowest|2‐low|3‐medium|4‐high|5‐highest}  factorydefault:5‐highest

TheZvBoxhasamaximumoutputpowerof+25dBmV,matchingthehighestpowerlevelstypicallyenteringa
homefromproviderssuchasFIOSandComcast.WhenusingaZvBoxtoaddachanneltoanexistinglineup,it is 
importanttomatch
thepowerofexistingchannels,otherwiseadjacentlower‐poweredchannelscanbedifficult
totunewithsometelevisions.

Therearefivechoicesavailable,eachdroppingtheoutputpowerapproximately5dBmV .
Example:
ZvCli$setrf‐power3‐medium

Zv‐Cliv1_3www.zeevee.com  Page14of32
Success
AudioInputCommands
CertainZeeVeeproductshaveseveraldifferenttypesofvideoportsandaudioports.Thesecanbegrouped
togetherinaveryflexiblemanner,supportingmanydifferentcombinationsofaudioandvideointhefield.

Thesecommandsareusedtoassociateanaudioinputtoacom ponentorVGAvideoinput.
Itisallowableto
usethesameaudioinputforboth,althoughthatmaynotmakethemostsense.
AssociateAudioInputforVGAandComponentInputs

Syntax
setaudio‐for‐component{analog
|spdif‐optical|spdif‐coax|usb|none} ZvPro250
setaudio‐for‐component{spdif‐optical|spdif‐coax
|usb|none}ZvBox150

setaudio‐for‐vga {analog
|spdif‐optical|spdif‐coax|usb|none}  ZvPro250
setaudio‐for‐vga {spdif‐optical|spdif‐coax| usb
|none} ZvBox150

Theanaloginputisastereoleft/rightpair.AudioisdigitizedandconvertedtoaDolbyDigital2.0stream.

TheS/PDIFopticalinputisaTOSLINKconnectionthatdeliversdigitalaudio.TheS/PDIFcoaxinputcarriesthe
sameinformationinadifferentphysicalform.
IfthereceivedaudioisPCM,itisencodedintoaDolbyDigital2.0
stream.AllotherDolbyencodings,including5.1,aredirectlypassedthroughas‐istothevideostream.Note
thatDTSencodingisnotsupported.

IfUSBisselected,theUSBportwillpresentitselfasa
standardUSBaudiodevicetowhateverdeviceitis
connected.Nospecialsoftwareisrequiredtousethisconn ection.

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.
Syntax

setvideo‐source{component
|vga|idle‐screen|test‐image‐1|test‐image‐2}factorydefault:component

Zv‐Cliv1_3www.zeevee.com  Page15of32

Ifthevideo‐sourceissettothecurrentlyactivesource,thiscommandisignored.Inveryrareoccasions,the
audioandvideoprocessingmayneedtoberestarted.Changethevideo‐sourcetoξ€ƒβ€˜idle‐screen’andthenbackto
theprevioussetting.

Ifidle‐screenisselected,theanimated
Zvlogoisplayed.Ifatestimageisselected,afixedtestimageis
displayed.ThesearedesignedtohelpyoucalibrateyourHDTVs.Note–testimagesarebroadcastin720p

Notethatvideo‐sourcecanalsobeselectedviatheIRinputwindowontheZv150and
Zv250.OntheZv 250,
youcanalsousetheIRinputport,andthefrontpanelbutton.Thebehaviorisidenticalnomatterhowyou
requesttheswitch.
SelectUnderscanResolutionstoPresentinVGAEDID
WhenZvBoxisconnectedtoacomputerviatheVGAconnector,ZvBoxpresentstothe
computer’sgraphicscard
asetofresolutionsthataresupportedbyZvBox,includingthe1280x720and1920x1080resolutionsusedby
HDTVs..TheseresolutionsarepresentedinastructurecalledEDID(ExtendedDisplayIdentificationData).If
ZvBoxisbroadcastingafull1280x720or1920x
1080resolutiontoanHDTVthatξ€ƒβ€œoverscans”(cropsoffthe
edgesofthepicture),importantinformationmaybelost,e.g.aPCtaskbarorascrollingtickeratthebottomof
thescreen.Inthatcaseit’spossibletochooseaZvBox‐supportedξ€ƒβ€œunderscan”resolutionatthePC,generatinga
slightly
smallerpicturethatwillremainwithintheviewableareaoftheHDTVscreen.

Thefollowingcommandsallowyoutosetoneunderscanresolutionfor1080,andoneunderscanresolutionfor
720,whichwillbecommunicatedtoyourPCviaEDID.Onceanunderscanresolutionhasbeenselected,you
maynow
setyourPC’soutputresolutiontothatresolution.

Note:eachTVwillperformadifferentamountofoverscan,sokeepthisinmindwhenselectinganunderscan
resolution.ItcanbeusefultohavetheZvBoxoutputtest‐image‐1(i.e.ξ€ƒβ€œsetvideo‐sourcetest‐image‐1”)when
determiningthe
correctunderscanresolution.

Note:OnApplecomputers,theXhorizontalresolutionmustbedivisibleby16.

Syntax
setvga‐edid‐underscan‐resolution‐1080{1912x1075|1904x1071|1896x1066|1888x1062|1880x1057|
 1872x1053|1864x1048|1856x1044|1848x1039|1840x1035|
 1832x1030|1824x1026|1816x1021
|1808x1017|1800x1012|
 1792x1008|1784x1003|1776x999 |1768x994 |1760x990 |
 1752x985 |1744x981 |1736x976 |1728x972 |1720x967 |
 1712x963 |1704x958}
setvga‐edid‐underscan‐resolution‐720{1272x715 |1264x711 |1256x706 |1248x702 |1240x697 |
 1232x693 |1224x688 |1216x684 |
1208x679 |1200x675 |
 1192x670 |1184x666 |1176x661 |1168x657 |1160x652 |
 1152x648 |1144x643 |1136x639 |1128x634 |1120x630 |
 1112x625}


Zv‐Cliv1_3www.zeevee.com  Page16of32
CustomizeIdleScreenandVisualWatermark
ZvBoxdisplaysanidle‐screenimagewhenvideo‐sourceissettoξ€ƒβ€˜idle‐screen’orthereisno(orunsupported)
videocomingintheconfiguredvideo‐source.Theidle‐screenisastaticimagedisplayedonablackbackground.
BydefaultthisisaZv
logothatξ€ƒβ€˜bounces’aroundthescreen.Itispossibletochangetheimagetobeoneofyour
choosing.

ZvBoxcanalsodisplayavisual‐watermarkimagethatslowlyfadesinandoutofthelowerrighthandcornerof
thetransmittedvideo(ifξ€ƒβ€˜setwatermark‐visualon’).Thewatermark
imageisasmallimagedynamicallyoverlaid
ontopofthevideostream.BydefaultaZvlogoisused,howeverthiscanalsobechanged.

Theimageusedforacustomwatermarkmusthavearesolutionof64x64orless.Theimageusedforacustom
idle‐screenmust
havearesolutionof1280x720orless.Ifitis700x500orless,theimagewillξ€ƒβ€˜bounce’around
theTVscreen;otherwisetheimagewillbefixedinthecenterofthescreen.Theimageisnotscaled.

Imageformatssupportedarelimitedto:
β€’ WindowsorOS/2Bitmap(bmp)

o Supportsfullalphatransparencyin32bppform,otherbitdepthssupportedbutdonotinclude
transparency
β€’ GraphicsInterchangeFormat(gif)
o 8bppindexedcolorwithbooleantransparency
β€’ JPEG‐2000codestream(j2k,j2c)
o Supportsfullalphatransparency
β€’ JPEGNetworkGraphics(jng)
o Supportsfullalphatransparency
β€’
JPEG‐2000FileFormat(jp2)
o Supportsfullalphatransparency
β€’ JPEG‐JFIFCompliant(jpg,jif,jpeg,jpe)
o Formatdoesnotsupporttransparency
β€’ PortableNetworkGraphics(png)
o 32bppand64bppformatssupportfullalphatransparency, 8/24/48bppformatswithout
transparencysupportedtoo
β€’ PortableBitmap/ASCII(pbm)
o Formatdoes
notsupporttransparency
β€’ PortableBitmap/RAW(pbm)
o Formatdoesnotsupporttransparency
β€’ TaggedImageFileFormat(tif,tiff)
o Supportsfullalphatransparencyin32bppform,otherbitdepthssupportedbutdonotinclude
transparency
β€’ TruevisionTarga(tga,targa)
o Supportsfullalphatransparencyin32bppform,
otherbitdepthssupportedbutdonotinclude
transparency

Zv‐Cliv1_3www.zeevee.com  Page17of32

Whensettingacustomidle‐screenorwatermark,ZvCliconvertstheimageintotheformatusedbyZvBox(32‐bit
PNG).Ifonesetstheidle‐screenorwatermarkfiletothesamevaluethatisalreadyset,thefileisNOTresentto
ZvBox,butinsteadZvClisimplyreturns
success.

Syntax
setcustom‐idle‐screenξ€ƒβ€œ{filename}”    factorydefault:ξ€ƒξ€ƒβ€œβ€ξ€ƒ
setcustom‐watermarkξ€ƒβ€œ{filename}”    factorydefault:ξ€ƒξ€ƒβ€œβ€ξ€ƒ

Example:
ZvCli$setcustom‐idle‐screenc:\images\MyLogo.jpg
ConvertingimagetoZeeVeeformat(32bitPNG)
Imagefiletype:JPEG‐JFIFCompliant(jpg,jif,jpeg,jpe)
Imageconverted
TransferringfiletoZvBox:
……
Success
Newvalue
setbutwillnottakeeffectuntilZvBoxisrestarted.
Use'systemrestart'torestartthesystem.
VideoCalibration
CalibrationisautomaticallydonewhenZvBoxswitchestoanewvideosource.However,thatfunctionrelieson
havingvideothatrepresentsareasonablecolorrangeandscreenfill(specificallytheimage
shouldnothave
blackattheedgesduringcalibration).UsethiscommandifyoufeelZvBoxneedstorecalibratetheincoming
VGAvideoinput(e.g.imagenotcenteredorcolorisoff).

Syntax
videocalibrate‐vga
VideoOutputCommands
Thesecommandsareusedtosetcharacteristicsoftheoutputvideo.
SetOutputFrameRatefor720p
SetstheoutputframeratewhenZvBoxistransmittinganoutputresolutionof720p.Higherframerateoutput
hassmoothermotionwithslightlydiminishedimagedetail.Lowerframerateoutputhashigherimagequality

withsomewhatlesssmoothmotion.Higherframerateisrecommendedforapplicationssuchasdigitalsignage
whenatextcrawlisused,orforvideowheresmoothpanningofscenesistypical.Formostapplications,the
lowerframeratedeliversthebestoverallexperience.Thiscommandisonlyavailablefor
theZvProlineof
products.
Syntax
setoutput‐frame‐rate‐for‐720p{30fps|60fps
}   factorydefault:60fps

Zv‐Cliv1_3www.zeevee.com  Page18of32
SetOutputResolutionforVGAInput
Thisadvancedcommandisonlyintendedforonespecificcase;inalmostallcasesthedefaultsettingofξ€ƒβ€˜auto’
shouldbeused.

Thiscommandisdesignedtobeusedinthefollowingscenario:WhenusingaVGAvideo‐sourcewitha
resolutionof1280x1024
whereyourequirethattheTVscreenbecompletelyfilledwithpicture,withouttheuse
ofblackborders.InthiscasesettheZvPro250toξ€ƒβ€˜720p’outputresolutionanditwillgenerateapicturethat’s
1280x720,completelyfillingtheTVscreenwithouttheuseofblackbars‐
butcroppingoffthetopportionof
theincomingpicture.Toavoidlosingpictureinformation,theincomingsourcemustbeformattedsothatthetop
~310linesofthepictureareblank.

Syntax
setvga‐output‐resolution{auto
|720p}factorydefault:auto
SettingProgram(HDTV/VirtualChannel)Information
WithinasingleRF‐Channel, therecanbemanyactualξ€ƒβ€œHDTVchannels”–that’swhatisactuallytunedbytheTV.
InMEPG2,eachoftheHDTVchannelsiscalledaProgram.Eachprogramisassignedanumberofparameters,
withthemostimportantonesbeingthemajorandminorHDTV
(virtual)channelnumber–theactualnumbers
thatareusedtotunethechannel ontheHDTV.
SetChannelName
Thechannelnameisdispla yed ontheHDTVwheneverthechannelischanged,orwheninformationis
requested.Thiscanbeveryuseful,especiallywhendeployingmultipleZvBoxchannels.

Syntax
setmpeg2program{video1}short‐channel‐nameξ€ƒβ€œname” name<=7characters
factorydefault:ZvCast

setmpeg2program{video1}long‐channel‐nameξ€ƒβ€œname” name<=64characters
factorydefault:WelcometoZeeVeeZvCast

Example:
ZvCli$setmpeg2programvideo1short‐channel‐name"new"
Success
ZvCli$setmpeg2programvideo1
long‐channel‐name"newchannel"
Success
SetHDTVChannelNumber
TuningtoananalogchannelisassimpleasenteringtheRFchannel numberassociatedwiththatchannel.Not
sosimplewithHDTVchannels.SinceitispossibletopackmultipledigitalchannelsintoasingleRFchannelslot,
anew
schemeforξ€ƒβ€˜tuning’tothosechannelswasdev eloped.EachprogramhasanHDTVchannelnumber
(majorandminor)associatedwithit.That’sthenumberenteredattheHDTVtofindthischannel.Itwasaway
tohelpwiththeanalogtodigitalconversion,wheredigitalchannelswereactuallyin
adifferentRFslotthan

Zv‐Cliv1_3www.zeevee.com  Page19of32
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HDTV susea
dashinsteadofadot.SomeTVswillalsofindyournewchannelif youjustenter 53.

Note‐Werecomme ndmatchingtheRFchannelandthenumber
leftofthedecimalpoint.Wealsorecommend
using1totherightofthedecimal.Doingsohelpsmo stHDTVsre ceiveyournewchannelwithoutrequiringa
fullchannelscanateachTV.Thismethodologyalsoseemstoreducethelikelihoodofconflict,asmostcable
operatorsseemtofollow
thismethodology(atleastfortheleftnumber)

Note‐sincetherearenorulesregardingtheusageofHDTVchann elnumbers,inrarecases,youmayhavea
conflict.Forexample,someotherchannelmaybebroadcastingonRFchannel53,butdeclareitsHDTVchannel
tobe5.1.There
willbeaconflictifyoutrytouse5.1aswell.Theonlywaytoknowforcertainifthereisa
conflictistoperformafullchannelscanattheHDTV,andchecktoseeifthereareotherHDTVchannelsthat
conflictwithanumberthat
youintendtouse.

Note–ChangingHDTVchannelnumberswhilestillbroadcastingcansometimesconfuseany connectedHDTVs.
Werequireturningoffthebroadcast(setrf‐output off)beforemakingthesechanges.Youmayalsowantto
performafullchannelscanateachHDTVafteryourchannelchangesare
complete,whichwillclearanymemory
ofoldchannellocations.
SetEventInformationTable(EIT)Name(HDTVProgramGuideEntry)
Theeventinformationtablename is use dbysomeHDTVsthatshowschedulesofupcomingprograms.ZvBoxis
alwayssendingthesameξ€ƒβ€œprogram”–thiscommandallowsyoutopopulate
anameintothatguide.Theguide
alwayscontains4entries,3hourslong.

Syntax
setmpeg2program{video1}eit‐nameξ€ƒβ€œname” name<=132chars
factorydefault:ξ€ƒξ€ƒβ€œVideoOverCOAX”

Example:
ZvCli$setmpeg2programvideo1eit‐nameξ€ƒβ€œNewGuideInfo”
Success

Zv‐Cliv1_3www.zeevee.com  Page20of32
SetEITRating
Thiscommandsetsara tingforallentriesintheprogramguide.Thiscanbeusefulifsomecontentshouldbe
excludedatsomeHDTVs.

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.Thefactory
defaultshavebeensettovaluesthatproducethebestpicture,whilealsomaximizingthechancethatallHDTVs
willcorrectlydisplaytheencodedvideo.WehavefoundthatsomeHDTVsaresensitive
tocertainthingslike
totalbit‐rateornumberofbitsofDCcoefficients.Thepicturemaysometimesbreakup,orinsomecasesnot
displayatall!

Experimentingwiththesesettingscanimprovethequalityoftheencodedvideo,butwestronglyadviseyouto
testanychangeson
*eachtypeofHDTV*thatmayreceivethesignal.
SetEncodingBitRate

Syntax
setmpeg2output‐data‐rate{low|normal|high
}   factorydefault:high

Adigitalcable(QAM)RFchannelallowsforadatarateupto38.78Mbps.Usually,thatstreamisdividedinto
multipledigitalchannels,eachhavingalowereffectivedatarate.SinceZvBoxisplacingasingledigitalchannel
inthestream,itcansend
moredataduringcomplexscenes,uptothe38.78Mbpslimit.Thiscanresultin
significantimprovementsinvideoqualityforcertainverycomplexscenes.However,someHDTVswill
experiencesomepicturebreakupifthedatarateeverexceeds19.4Mbpsforasingledigitalchannel.Wehave
observedthatthis
istrueofsomeSharpHDTVs,andmaybetrueofothers.

Normalwillkeeptheencoder’soutputdatarateto19.4Mbps.Highwillallowtheencodertooperateupto
38.78Mbps.Atthistime,LowandNormalhavethesameeffect.

Example:
ZvCli$setmpeg2output‐data
‐ratehigh
Success
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32

ZeeVee ZvCli User manual

ZeeVee
Brand
ZeeVee
Model
ZvCli
Type
User manual
Download PDF
report

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI

Related papers

Other documents