Configuration Guide 113

AminoSTBConfigurationGuide
January2011
CONTENTS
INDEX
AminoCommunicationsLtd.2011CONFIDENTIAL
Copyright STBConfigurationGuide January2011 Issue113 AminoCommunicationsLtd.2011 Thegenerallyavailablesoftwareversionsatthetimeofissueareasfollows: Platform 103 110 110H 500 125 x3xseriesSTBs A130/A130M 130H A132 A530 A532 x4xseriesSTBs A129 A140 H140 A540PVR 2.1 2.1 2.1 2.1 Softwareversion2.1isanupgrade thatrunsonallsettopboxesusing theST7105systemonchipprocessor. 0.17.6 0.17.6 0.17.6 0.17.6 0.17.6 Softwareversion0.17.6isanupgrade thatrunsonallsettopboxesusing theST7109systemonchipprocessor. Softwareversion 0.15.1 0.15.10 0.15.10 0.15.10 0.16.7 TIDM6443orDM6441(DaVinci) CPU IBMVulcan
Amino,AmiNET,AssetHouse,MoodandtheAminologoaretrademarksofAminoCommunicationsLtd.All othertrademarksarethepropertyoftheirrespectiveowners. Thisdocumentdescribescomponentsthatundergocontinualdevelopment.Theinformationinthisdocument issubjecttochangewithoutnoticeatanytime. Theremaybevisualdeviationsbetweengraphicsinthemanualsandthereleasedsoftware. Commentsaboutthedocumentationarewelcome. Pleasesubmitfeedbacktodocs@aminocom.com. ForfurtherinformationaboutAminoorAminoproducts,pleaseemailinfo@aminocom.com.
INDEX
CONTENTS
ii
iii
CONTENTS
INDEX
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Aboutthisdocument ............................................................. 1 Documentconventions........................................................... 1 Structure ....................................................................... 2 Documenthistory................................................................ 4 Chapter 1 Configuringsettopboxes................................................. 5 1.1 Configurationfiles ........................................................ 5 1.2 Configurationtechniques .................................................. 6 Chapter 2 Settopboxconfigurationfiles .............................................. 9 2.1 Generalsettopboxsettingsfile ............................................. 9 2.2 Networkconfigurationfile................................................. 10 2.3 netconffilecontents ..................................................... 11 2.4 NORFlashconfiguration .................................................. 11 2.5 Channelsfile............................................................ 12 2.6 Trusteddomainsfile...................................................... 13 2.7 Usersettingsfile ......................................................... 14 2.8 HOSTNAMEfile .......................................................... 15 2.9 Functionkeysfile........................................................ 16 2.10 Browserconfigurationfiles................................................ 17 2.11 DynamicDHCPsettingsfile................................................ 17 2.12 Fileaccesspolicy......................................................... 18 Chapter 3 UsingSTBremoteconf.................................................... 21 3.1 STBremoteconf .......................................................... 21 3.2 Installation ............................................................. 22 3.3 RemovingSTBremoteconf ................................................. 24 3.4 SendingcommandswithSTBremoteconf .................................... 25 3.5 UsingscriptstocontrolSTBremoteconf ...................................... 25 3.6 STBremoteconfparametersyntax .......................................... 26 3.7 Listofcommands........................................................ 29 Chapter 4 Usinglibconfig .......................................................... 45 4.1 Beforeyoustart ......................................................... 45 4.2 libconfigconfigurationareas ............................................... 45 4.3 Usinglibconfigtogetandsetvalues ........................................ 47 Chapter 5 Customisingasoftwareupgradeimage ..................................... 51
AminoCommunicationsLtd.2011CONFIDENTIAL INDEX CONTENTS iv
Configuringimagecomponents ............................................ 51 Editingtheflashcontentsfile............................................... 52 Creatinganupgradescript ................................................ 53 Enablingremotelogintools ............................................... 53 Customisinggraphics..................................................... 54 Chapter 6 SettopboxconfigurationpagesforFrescoandOpera8.5 ...................... 59 6.1 Aboutthesettopboxconfigurationpages. .................................. 59 6.2 Gettingstarted.......................................................... 61 6.3 Preferencespages ....................................................... 62 6.4 Preferencespagesconfigurationareas ..................................... 65 6.5 Managementpages...................................................... 71 6.6 Managementpagesconfigurationareas.................................... 74 6.7 ConfigurationpagesettingsforFrescoandOpera8.5.......................... 90 Chapter 7 SettopboxconfigurationpagesforOpera9................................. 97 7.1 Aboutthesettopboxconfigurationpages. .................................. 97 7.2 Gettingstarted.......................................................... 99 7.3 Preferencespages ...................................................... 100 7.4 UsingthePreferencespages .............................................. 100 7.5 Preferencespagesconfigurationareas .................................... 101 7.6 Managementpages..................................................... 112 7.7 ConfigurationpagesettingsforOpera9 .................................... 125 Appendix ANORFlashsettings .................................................... 131 A.1 A130VideoOutputs ..................................................... 144 Appendix BSettingsfilecontents .................................................. 145 B.1 Remotelayoutoptions................................................... 173 B.2 LEDConfigurationoperationvsSTBproduct ................................. 174 B.3 Volumecontrol ......................................................... 174 Appendix CNetconffilecontents .................................................. 177 Appendix Ddhcpcfilecontents.................................................... 181 Appendix EVideooutputformats.................................................. 185 E.1 AmiNET103............................................................ 185 E.2 AmiNET110,110H...................................................... 186 E.3 AmiNET125............................................................ 186 E.4 AmiNET130,130H...................................................... 187 E.5 AmiNET500............................................................ 187 E.6 AmiNET530............................................................ 188 Appendix FBoardrevisionnumbers ................................................ 189 AmiNET110 ................................................................... 189 AmiNET500 .................................................................. 189 AmiNET530 .................................................................. 190 AmiNET130 ................................................................... 190 AmiNET130H.................................................................. 190 AmiNET130M ................................................................. 190 AmiNET125 .................................................................. 190 AmiNET132 .................................................................. 190 AmiNET532 .................................................................. 191
5.1 5.2 5.3 5.4 5.5
CONTENTS
INDEX
MOOD400030................................................................ 191 MOOD400032................................................................ 191 Appendix GUsingtheconfigurationtechniques ...................................... 193 G.1 Configuringimagecomponents ........................................... 193 G.2 Configuringalargedeployment........................................... 195 Appendix HInvalidvideomoderecovery............................................ 197 H.1 Howitworks ........................................................... 197 Appendix IPairinganIRremotecontrolwithasettopbox ............................. 199 I.1 OnthegreyAminoIRremotecontrol ...................................... 199 I.2 OntheAminoAVC(black)IRremotecontrol ................................ 199 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
INDEX
CONTENTS
vi
vii
CONTENTS
INDEX
Introduction
Aboutthisdocument
Aminosettopboxmanagementoffersvariousmeansofediting/readingtheconfigurationandcontrolling basicsettopboxoperation(forexample,inordertoinitiateasoftwareupgradeorreboot).Thisdocument describestheconfigurablesettingsandconfigurationoptionsfortheAmiNETseriesofsettopboxes.It assumesyouhaveasettopboxandaccesstoasuitablesoftwarerelease.Italsoassumesabasic understandingofthetechnologiesinvolved,whichincludeLinuxcommandlineoperation. ForinformationoninstallingtheAminosoftwareandmulticastupgradeofthesettopbox,seetheAmino InstallationandUpgradeGuide. Manyofthecontrolandcustomisationoptionsdescribedinthisdocumentcanalsobeimplementedusing JavaScriptMediaAccessControlExtensions(JMACX).JMACXisnotcoveredinthisdocumentseetheAmino JMACX API specificationformoreinformation.
Documentconventions
Thefollowingdocumentconventionsareinuse: Formatting <...> [...] ...|...
code font bold text
Usage Indicatesavaluethatyouneedtoreplacewithasystemspecificvalue(except whereusedinHTMLorXMLexamples,whereitisusedintags,asnormal). Indicatesoptionalparametersforexampleincommandsorfunctions. Indicateschoicesforexamplewhereaninputcantakeoneofanumberof values. Indicatesinputandoutputvalues(forexample,atacommandline),aswellas function,configuration,parameterandfilenames. Usedforemphasisandtoindicatespecifickeypresses.Forexample:PresstheEsc key. Commandsorsettingswhicharenotingeneraluse(forexample,configuration settingsthatarereservedforAminointernaluse). Crossreference(thisisaclickablehyperlinkifyouareviewingthedocument electronically).
greytext bluetext
INDEX
CONTENTS
Structure
Thisdocumentconsistsofthefollowingchapters: Chapter Introduction Chapter1,Configuringsettopboxes Outline Generalintroduction. Thischapterintroducestheoptionsavailablefor configuringsettopboxes,anddetailshowtocon figurecertainconfigurationareas. Thischapterlistssomeofthemainsettopbox configurationsettings. ThischapterintroducesSTBremoteconfand explainshowtouseittoconfigureandcontrola settopbox Thischapterintroduceslibconfigandexplains howtoconstructcommandstoviewand/oredit settopboxconfiguration. Thischapterdescribeshowtocustomisethesoft wareupgradebeforeitissignedandloadedto thesettopbox. ThischapterintroducestheManagementand PreferencespagesforOpera8.5andFrescobuilds anddescribeshowtousethemtoconfigureand controlasettopbox. ThischapterintroducestheManagementand PreferencespagesforOpera9buildsand describeshowtousethemtoconfigureandcon trolasettopbox.
Chapter2,Settopboxconfigurationfiles Chapter3,UsingSTBremoteconf
Chapter4,Usinglibconfig
Chapter5,Customisingasoftwareupgrade image Chapter6,Settopboxconfigurationpages forFrescoandOpera8.5
Chapter7,Settopboxconfigurationpages forOpera9
CONTENTS
INDEX
Chapter Appendices
Outline AppendixA,NORFlashsettingsprovidescon figurationexamplesandothersupportinginfor mationforNORFlash. AppendixB,Settingsfilecontentsprovidescon figurationexamplesandothersupportinginfor mationforSettingsfileinstructions. AppendixC,Netconffilecontentsprovidescon figurationexamplesandothersupportinginfor mationfornetconfinstructions. AppendixD,dhcpcfilecontentsprovidescon figurationexamplesandothersupportinginfor mationfordhcpcinstructions. AppendixE,Videooutputformatsliststhe videooutputformatspersettopbox. AppendixF,Boardrevisionnumberslistsboard revisionnumberspersettopbox. AppendixG,Usingtheconfigurationtech niquesgivesmethodsofusingtheconfiguration techniques. AppendixH,Invalidvideomoderecovery describesamethodofrecoveringfromsettingan invalidvideomode. AppendixI,PairinganIRremotecontrolwitha settopboxdescribesthemethodofpairingan IRremotecontrolwithasettopbox.
INDEX
CONTENTS
Documenthistory
Issue 113 112 Dateissued January2011 Changes AddedRTSPserversourceaddressfilteringinformation (settingsfile)
December2010 Changesandupdatesforversion0.17.5and0.17.6(for Ax3xSTBs)andversion2.0.0and2.1.0(forAx4xSTBs) releases. November2010 Changesandupdatesforversion0.17.3(forAx3xSTBs) andversion1.0.0(forAx4xSTBs)releases. Notissuedincorporatedintoissue112. August2010 April2010 March2010 Changesandupdatesforversion0.17.2release. Newsettingsoptionsadded. Generalupdatesandcorrections.
111
110 109 108 107
November2009 NewappendixlistingDHCPCoptionsadded. Netconfappendixupdated. Galiosupportinformationremoved.Pleaseseeearlier versionofthisdocumentforinformationrelatingtothe Galiobrowser. November2009 Chapter7addeddescribingthenewmanagementand preferencepagesConfigurationpagesettingsarenow includedinChapters6and7. AppendixA,BandChavebeenupdated. DocumentupdatedforOpera9builds. AppendixGandHarebothnew. SupportinformationfortheAmiNET120and124 removed.Pleaseseeearlierversionofthisdocument forinformationrelatingtothoseplatforms. June2009 June2009 May2009 January2009 Removedconfidentialityrequirement.Password protectionwarningsadded. AppendixGupdated.Minorcorrections. GeneralUpdates.BoardRevisionNumbersupdated.
STBremoteconfREFORMATadded.
106
105 104 103 102
FileAccessPolicyinformationadded.OUTRESinfo updated.Summarytablesupdated.Scriptstocontrol STBRemoteconfadded.SAVEcommandinfo corrected.
CONTENTS
INDEX
Chapter1Configuringsettopboxes
ThischapterprovidesabriefoutlineoftheconfigurablesettingsandconfigurationoptionsfortheAmiNET seriesofsettopboxes.Moredetaileddescriptionsofthesettingsandoptionswillbeprovidedinlater chapters. Whetherasettopboxusesasettingdependsonthesoftwarebuildusedtocreatethesoftware imageinstalledonthesettopbox.

NOTE
Notallsettingsdescribedinthisdocumentareavailabletoallsettopboxes.
1.1
Configurationfiles
Configurationthatpersiststhroughsettopboxrebootsisgenerallystoredinconfigurationfilesthatcanbe readoreditedeitherdirectlyorviatheadministrationtools.TheexceptionistheNORFlash,whichcanonly beconfiguredviatheadministrationtools.Furtherinformationontheavailableconfigurationfilescanbe foundinChapter2,Settopboxconfigurationfiles.
1.1.1
Settings
Thesettingsfilecontainsvarioussettopboxsettings,suchaslanguages,volumerangesandkeyboard configuration.
1.1.2
Netconf
Thenetconffilecontainsnetworkconfigurationsettings.Insomecases,thesettopboxreadsthesesettings fromtheNORFlashinsteadoffromthisfile.
1.1.3 1.1.4
Hostname DHCP
TheHOSTNAMEfilecontainsjustasinglesetting,specifyingthenameofthesettopbox.
ThedynamicnetworkandmulticastupgradesettingsretrievedfromtheDHCPserverarestoredinafilecalled dhcpcd-eth0.info.Thesevaluesareonlysetifthesettopboxusesdynamicnetworkandmulticast upgradesettings,otherwise,thestaticvaluesaredefinedintheNORFlash,netconf ordhcpcfiles.The DHCPCvaluesarereadonly.
INDEX
CONTENTS
CONFIGURING SET-TOP BOXES
1.1.5
Trusteddomains
Thetrsdmns.txtfiledefinestrusteddomainsandspecifieswhetherJavaScriptandMacrovisionareenabled foreach.
1.1.6 1.1.7
Channels Functionkeys
Thechnls.txtfilecontainsalistofchannelnumbersandthemediastreamURLforthechannel.
Thefkeys.conffilesetsthedefaultactionsassociatedwiththebuttonsontheIRremotecontrol.Thisfile shouldnotnormallybeediteddirectly(useJMACXfunctionsinstead).
1.1.8
Browserconfiguration
Softwarereleaseswillnormallyincludetheconfigurationfileforthebrowser.ForFrescothisiscalled config.txt.ForOperaitisopera.ini.Insomebuilds,thesettopboxreadssomeofitssettingsfrom thesefiles.
1.1.9
Password
Softwarereleasesstoretheactualpasswordsinencryptedformin /mnt/nv/passwdand/mnt/nv/ shadow,atbootupthesearecopiedto/etc/passwdand/etc/shadow.. Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. Seebelowforinformationonchangingthesedefaultpasswords.
1.1.10 NORFlash
TheNORFlashcontains,amongotherthings,settingsrequiredbytheROM.Insomecases,thiscaninclude staticnetworksettings(thesewouldotherwisebesetinthenetconffile).
1.1.11 Usersettings
TheusersettingsfilecontainssettingsthatthesettopboxusercontrolsthroughthePreferencespages. Theseoverridethevaluesspecifiedforthesamesettingsinthesettingsfile.Thevaluespersistwhenanew softwareimageisloadedtothesettopbox.
1.2
Configurationtechniques
Aminosettopboxmanagementoffersvariousmeansofediting/readingconfigurationandcontrollingbasic settopboxoperation(forexample,toinitiateasoftwareupgradeorreboot).Thetechniqueswhichmakethis possiblearedescribedbelow:

STBremoteconfAremoteconfigurationtoolthatenablesyoutosendconfigurationandcontrol
commandsacrossthenetworktooneormoresettopboxes.
Configuration pagesThelocalconfigurationpagescanbeaccessedusinganAminoIR(Infrared)
keyboardandtelevisiondisplaytochangeconfigurationsettingsandcarryoutsimplecommandssuchas
CONTENTS
INDEX
rebootingandinitiatingsoftwareupgrades.ThetermConfigurationpagesencompassesboththe ManagementpagesandtheUserPreferencespages.
ImagecomponentsThesetoffilesthatasoftwareupgradeimageisbuiltfrom.Theseinclude
configurationfilesandgraphicsfiles(forexample,thoseusedinthedisplaytoshowthatthesettopbox isloadingnewsoftware).InTable 1.2below,changingimagecomponentsmeanseditingthecontents oftheimagecomponents directorybeforecreatingandsigninganewupgradeimage.Ifnewfilesare addedtheyshouldbeaddedtotheflashcontentsfile.

libconfig commands (via Telnet/SSH)IfasettopboxhaseithertheTelnetorSSHcomponent installedthiscanbeusedtologintoitremotelyandcarryoutconfigurationusinglibconfig
commands..
NOTE
Thesecomponentsareusuallynotinstalledforsecurityreasons,sotheywill needtobeaddedtothesoftwareimageinstalledonthesettopboxifyou wanttousethem
JMACX (JavaScript)TheJavaScriptMediaAccessControlExtensions(JMACX)APIoffersafullsetof
functionsforcontrollingarangeofsettopboxoperationalareasviaJavaScriptembeddedinwebpages.See theAmino JMACX API SpecificationformoreinformationonusingtheJavaScriptextensions. Table 1.1summariseswhichconfigurationfilesareusedwithwhichtechniques. Technique STBRemoteconfig libconfigcommands JMACXAPI Configurationpages Imagecomponents
Configurationfiles
SETTINGS NETCONF HOSTNAME DHCP TRUSTEDDOMAINS CHANNELS FUNCTIONKEYS BROWSERCONFIGURATION PASSWORD NORFLASH
Y Y
Y Y
Y Y Y Y Y Y Y
Y Y Y Y Y Y Y
Y Y Y Y Y Y Y Y Y
Table1.1:Configurationtechniques
NOTE
TheuseofDHCPisasanON/OFFconfiguration:configurationvaluessupplied bytheDHCPserverarereadonly.
Theconfigurationtechniquesdescribedinthetablesbelowareeachsuitedtoparticularcircumstancesand contexts.Forexample,theConfigurationpagesofferlocalconfiguration,whileSTBremoteconfenables remoteconfiguration.Editingimagecomponentfilesbeforethesoftwareisupgradedenablesthesame
INDEX
CONTENTS
configurationtobesetonmultiplesettopboxes,whereaschangesviaTelnetcanonlyapplytoasingleset topbox. STBremoteconf libconfigcommands JMACXAPI Configurationpages Imagecomponents
Contexts
Beforesoftwareisloaded Aftersoftwareisloaded Remote Local SingleSTB Largedeployment Testsettings Y Yb Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
Y Y Ya Y
Table1.2:Useofconfigurationtechniques.
a. Notgenerallyrecommended,unlessperformingoperations thatcannotbedoneinanotherway,forexample,addinga clientprogram. b. NotrecommendedsettingsareonlyreceivediftheSTBis powered.
InTable 1.3below,reflashreferstodeletingallthecontentsoftheNANDflashandcompletelyreplacingthe mainsoftwareimageusingthebootstrapprocess.Allconfigurationoptions,exceptthosestoredinNORFlash, willbereplacedwiththeconfigurationcontainedinthenewsoftwareimage,upgradereferstoreplacing justthemainsoftwareimage.Inthiscase,someoftheconfigurationfiles,forexample,theusersettings,may bepreserved.Thiscanbecontrolledwhenthesoftwareimageisbuilt. STBremoteconf libconfigcommands JMACXAPI Configurationpages Imagecomponents
Operations
readconfiguration writeconfiguration reboot upgradesoftware reflash
Y Y Y Y Y
Y Y Y Y Y
Y Y Y Y Y
Y Y
Table1.3:Useofconfigurationtechniques.
CONTENTS
INDEX
Chapter2Settopboxconfigurationfiles
ThischapterdescribestheconfigurablesettingsandoptionsforAmiNETsettopboxes,includingthesettings availablefromtheconfigurationpages.
NOTE
Inthefollowinginstructions, <release_name>indicatesthenameofthe softwarereleaseimagedirectorythatcontainsyourAminosoftwarerelease. Forexample, A110-0.14.0-frescoj27-ami_wm-subs-1 installsin 0.14.0-frescoj27-ami_wm-subs-1,hence<release_name>in thiscaseis0.14.0-frescoj27-ami_wm-subs-1.
2.1
Generalsettopboxsettingsfile
2.1.1
Howtovieworchangesettings
Aninitialsettingsfileissuppliedaspartofasoftwarerelease,inthefollowinglocation:
<release_name>/upgradeimage/imagecomponents/
Youcaneditthesettingsfiledirectlyorreplaceitbeforecreatingasoftwareupgradeimage.Alternatively, youcanusethevariousadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtotheset topbox.Managementpages,STBremoteconfandlibconfig(forexample,viaTelnet/SSH)canallchange valuesinthisfile. Onceloadedonthesettopbox,thesettingsfileisstoredinthefollowinglocation:

/mnt/nv/
NOTE
Thesettingsuseddependsonthesoftwareandhardwarebuild.
2.1.2
Examplesettingsfile
DOLBY_RF="" REMOTECONF="" IGMP_END_TIMEOUT="30" IGMP_START_TIMEOUT="30" RTSP_SCALE="6" BROWSER_ENABLECOOKIES="Y" BROWSER_HOMEPAGE="about:/start.htm" BROWSER_HELPPAGE=""

AminoCommunicationsLtd.2011CONFIDENTIAL INDEX CONTENTS 9
SET-TOP BOX CONFIGURATION FILES
HTTP_PROXY_IGNORE="" HTTPS_PROXY="" HTTP_PROXY="" USE_PROXY="Y" TOOLBAR_STATE="1" RTSP_END_TIMEOUT="6" RTSP_START_TIMEOUT="4" RTSP_SERVER="ncube" DELAY_FACTOR="4" REPEAT_RATE="8" MAXIMUM_VOLUME="100" MINIMUM_VOLUME="0" DEFAULT_VOLUME="100"
2.1.3
Settingsfilecontents
SeeAppendixB,Settingsfilecontents.
2.2
Networkconfigurationfile
2.2.1
Inmanycases,thesettingsavailableinthisfilearereadfromalternativelocations,forexample,NORFlash. FormoreinformationonwhichsettingsareusedbyFrescoandOpera,seeAppendixC,Netconffilecontents forthedefaultusageofthemainsettingsbyFrescoandOperabuilds. Aninitialnetconffileissuppliedaspartofasoftwarerelease,inthefollowinglocation:

Youcaneditthisfiledirectlyorreplaceitbeforecreatingasoftwareupgradeimage.Alternatively,youcanuse thevariousadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtothesettopbox. Managementpagesandlibconfig(viaTelnet/SSH)canchangevaluesinthisfile. Onceloadedonthesettopbox,thesettingsfileisstoredinthefollowinglocation:

/mnt/nv/
2.2.2
Examplenetconffile
Thefollowingexampleshowsasampleconfigurationfilesuppliedwithasoftwarerelease.Inthisexample,no staticnetworksettingsaresetbecauseDHCPissettoY,whichspecifiesthatthesettopboxwillretrievethe networksettingsfromtheDHCPsystem:

DHCP="Y" TIME_ZONE="" TIME_SERVER="" DNS="" DOMAIN="" GATEWAY="" NETMASK="" IPADDR=""
10
CONTENTS
INDEX
2.3
netconffilecontents
SeeAppendixC,Netconffilecontents.
2.4
NORFlashconfiguration
TheNORFlashcontainssettingsrequiredbytheROM.Insomecases,thiscanincludestaticnetworksettings (thesewouldotherwisebesetinthenetconffile).
2.4.1
NORFlashsettingsarenoteditedviaaseparateconfigurationfile,instead,theycanbeaccessedviathe administrationtools. Ifyouwanttodefinevaluesbeforeloadingthesoftwareimagetothesettopbox,youcandosobyadding

libconfigcallstotheupgrade.shfile.Thisisanupgradescriptthatthesettopboxexecuteswhenthe
newsoftwareimageisloaded.Ifthisfiledoesnotalreadyexist,createitinthefollowinglocation:
Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage.TheNORFlashsettingsexample belowgivesanexampleofhowtoaddlibconfigcallstotheupgradescript.SeeChapter4,Usinglibconfig forgeneralinformationonusinglibconfig. Alternatively,youcanusetheadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtothe settopbox.

NOTE
Thesettingsuseddependsonthesoftwareandhardwarebuild.
FormoreinformationonwhichsettingsareusedbyFrescoandOpera,seeAppendixA,NORFlashsettings.
2.4.2
ExamplescripttosetNORFlashsettings
NORFlashsettingscannotbeeditedviaaconfigurationfile,insteadtheyneedtobechangeddirectly.The followingexampleshowshowtoaddlibconfigcallsthatchangeNORFlashsettingstotheupgradescript (upgrade.sh).Thisisincludedinthesoftwareupgradeimage,andexecutedwhenthesoftwareisloadedon thesettopbox. Thesettingsinthisexampledefinestaticmulticastvalues:

#!/bin/sh libconfig-set libconfig-set libconfig-set libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_GROUP 239.255.1.1 NORFLASH.MULTICAST_BOOTSTRAP_PORT 11111 NORFLASH.MULTICAST_UPGRADE_GROUP 239.255.1.2 NORFLASH.MULTICAST_UPGRADE_PORT 11111
2.4.3
NORFlashlistofsettings
ForfurtherinformationseeAppendixA,NORFlashsettings.
INDEX
CONTENTS
11
2.5
NOTE
Channelsfile
ThisisnotavailableinOpera9.
Thechnls.txtfilecontainsalistofchannelnumbersandthemediastreamURLforthechannel.
IfyouneedabasicchannelchangeapplicationsomeexampleHTMLcodeisavailablefordownloadfromthe AminoSupportSiteatOnline Support > Downloads > JMACX and Application Development > channel_changer.tgz Theeasiestwaytousethisistoinstallitonawebservereditingtheinitfunction(below)toincludeyour streamaddresses:
function init() { /* Setup channel list */ add(0, "igmp://239.1.1.1:11111", "description1"); add(1, "igmp://239.1.1.2:11111", "description2"); add(2, "igmp://239.1.1.3:11111", "description3"); add(3, "igmp://239.1.1.4:11111", "description4"); add(4, "igmp://239.1.1.5:11111", "description5"); addChannelList(0,5); // the 5 should be replaced with the number of channels you are adding above //addChannelList(); /* Select initial stream */ start(0); }
Setthehomepageonyourbox(es)topointtothispagewhentheybootup.
2.5.1
Thechnls.txtfileisnotnormallysuppliedaspartofasoftwarerelease,instead,itiscreatedwhenyoufirst configurechannelsviatheManagementpagesorotheradministrationtool. Ifyouwanttodefinechannelsbeforeloadingthesoftwareimagetothesettopbox,youcandosobycreating thefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage.Alternatively,youcanusethe variousadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtothesettopbox. Oncecreatedorloadedonthesettopbox,thechnls.txtfileisstoredinthefollowinglocation:

/mnt/nv/
Youwillalsoneedtoaddchnls.txttotheendofflashcontentsintheform:
R chnls.txt
2.5.2
Examplechnls.txtfile
00: http://www.aminocom.com 01: igmp://239.255.250.1:11111 02: igmp://239.255.250.2:11111 03: igmp://239.255.250.3:11111 04: igmp://239.255.250.4:11111 05: igmp://239.255.250.5:11111 100: http://news.bbc.co.uk 101: http://msn.co.uk
12
CONTENTS
INDEX
200: http://google.co.uk
2.5.3
Channelsfilecontents
ThefilecontainsjustalistofchannelnumbersandtheURLforthem,inthefollowingformat:
<channel_number>:<url>
Forexample:
123 igmp://239.255.250.2:11111
Channelnumberscanbeintherange0999,andtheydonothavetorunconsecutivelyorstartatzero(for example,youcouldjustconfigurechannels100199).
2.6
Trusteddomainsfile
Thetrsdmns.txtfiledefinestrusteddomainsandspecifieswhetherJMACXandMacrovisionareenabledfor each.
2.6.1
Thetrsdmns.txtfileisnotnormallysuppliedaspartofasoftwarerelease,instead,itiscreatedwhenyou firstconfiguretrusteddomainsviatheManagementpagesorotheradministrationtool. SeeChapter6,SettopboxconfigurationpagesforFrescoandOpera8.5forfurtherdetails. Ifyouwanttodefinetrusteddomainsbeforeloadingthesoftwareimagetothesettopbox,youcandosoby creatingthefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage. Alternatively,youcanusethevariousadministrationtoolsavailabletochangesettingsoncesoftwareis loadedtothesettopbox. Oncecreatedorloadedonthesettopbox,the trsdmns.txtfileisstoredinthefollowinglocation:

/mnt/nv/
2.6.2
3 2 2 0
Exampletrsdmns.txtfile
macrovision.aminocom.com *.bbc.co.uk *.aminocom.com *.
2.6.3
Trusteddomainsfilecontents
Thefilecontainsalistoftrusteddomains,eachoneonaseparateline,withacodethatindicateswhatis enabled.Theformatforeachlineisasfollows:
<code> <url>
INDEX
CONTENTS
13
where:
<code>
Codethatindicateswhatisenabledforthespecifieddomain.Valuescanbeasfollows: 0neitherMacrovisionnorJMACXenabled 1Macrovisionenabled,JMACXdisabled(unlikelytoneedsetting) 2JMACXenabled,Macrovisiondisabled 3BothJMACXandMacrovisionenabled TheURLforthetrusteddomain.Thiscanuseasterisksaswildcards. Forexample:

3 *.aminocom.com
<url>
Important: Therulesspecifiedinthetrsdmns.txt fileareappliedintheordertheyarestated,soyouneed
totakecarewhenaddingdomainstoensurethattherulesareappliedasintended. Forexample,inthefollowingfile,3 specifiesthatMacrovisionandJMACXareenabledforthe macrovision.aminocom.comdomain,and2specifiesthatonlyJMACXisenabledforanyother aminocom.comdomain:

3 macrovision.aminocom.com 2 *.aminocom.com
InthefollowingalternativeexamplewiththesamesettingsreorderedonlyJMACXisenabledforany aminocom.comdomain,andsoMacrovisionisnotenabledformacrovision.aminocom.com,eventhough 3wouldnormallyenableMacrovisionsinceMacrovisionforthisdomainhasalreadybeenruledoutinthe previousline:

2 *.aminocom.com 3 macrovision.aminocom.com
2.7
NOTE
Usersettingsfile
TheseoverridethevaluesspecifiedforthesamesettingsintheSETTINGS file.
TheUSERSETTINGSfilecontainssettingsthatthesettopboxusercontrols(throughthePreferencespages).
2.7.1
Theusersettingsfileisnotnormallysuppliedaspartofasoftwarerelease,instead,itiscreatedwhenthe userfirstconfigurespreferencesviathePreferencespages. Ifyouwanttodefinelocalusersettingsbeforeloadingthesoftwareimagetothesettopbox,youcandoso bycreatingthefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage. Alternatively,youcanusethevariousadministrationtoolsavailabletochangesettingsoncesoftwareis loadedtothesettopbox.Preferencespagesandlibconfig(viaTelnet/SSH)canchangevaluesinthisfile.

NOTE
Valuessetviatheusersettingsfileoverridethevalueforthesame configurationsettingelsewhere,forexample,inthesettingsfile.
Oncecreatedorloadedonthesettopbox,theusersettingsfileisstoredinthefollowinglocation:
14
CONTENTS
INDEX
/mnt/nv/
NOTE
Thesettingsuseddependonthesoftwarebuild. FormoreinformationonwhichsettingsareusedbyFrescoandOpera8.5,see
Chapter6,SettopboxconfigurationpagesforFrescoandOpera8.5
FormoreinformationonwhichsettingsareusedbyOpera9,seeChapter7,
SettopboxconfigurationpagesforOpera9
2.7.2
Exampleusersettingsfile
DOLBY_RF="" DISPLAY_MODE="panscan" SUBTITLES_SECOND_LANG="ita/it" SUBTITLES_PREF_LANG="eng/en" SECONDARY_LANG="fra/fre/fr" PREFERRED_LANG="eng/en"
2.7.3
Usersettingsfilecontents
TheUSERSETTINGSfilecancontainanyofthesettingsnormallyspecifiedintheSETTINGSfile.Software buildsforsomebrowserswritecertainsettingstotheusersettingsfile.
2.8
2.8.1
HOSTNAMEfile
TheHOSTNAMEfilecontainsjustasinglevalue,specifyingthenameofthesettopbox.
TheHOSTNAMEfileisnotnormallysuppliedaspartofasoftwarerelease.Itiscreatedwhenyouspecifya hostnameviatheManagementpages. Ifyouwanttodefineahostnamebeforeloadingthesoftwareimagetothesettopbox(notrecommended), youcandosobycreatingthefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage.Alternatively,youcanusethe variousadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtothesettopbox. Managementpagesandlibconfig(viaTelnet/SSH)allowchangevaluesinthisfile. Oncecreatedorloadedonthesettopbox,theHOSTNAMEfileisstoredinthefollowinglocation:

/etc
2.8.2
ExampleHOSTNAMEfile
TheHOSTNAMEfilecontainsjustasingleline,suchasthefollowing:
AMINET
2.8.3
HOSTNAMEfilecontents
ThefollowingtabledescribesthesettingsavailableintheHOSTNAMEfile. Defaultvalueslistedhereareusedifnovalueissupplied.
INDEX
CONTENTS
15
Theexampleshowshowtoenterthesettingifyouareeditingthehostnamefiledirectly(notethatthevalues areallenclosedinquotationmarks).Seetheappropriatedocumentationforinformationonhowtoenter valuesusingothermeans(forexample,JMACXorlibconfigviaTelnet). Setting

HOSTNAME
Defaultvalue
Description Thesettopboxshostname.
Default: Example: HOSTNAME=AMINET
2.9
Functionkeysfile
The fkeys.conf filespecifieshowthesettopboxrespondstoremotecontrolkeys.Ifyouwanttochange theconfiguration,youarenotrecommendedtoeditthisfiledirectly.Instead,youshouldusetheJMACX SetKeyFunction andSaveKeyFunctioncommands.SeetheAminoJMACXAPISpecification fordetailsof howtousethesecommands.
2.9.1
NOTE
ThisoptiondoesnotapplyforOperav9.
Aninitialfkeys.conffileissuppliedaspartofasoftwarerelease,inthefollowinglocation:
Youshouldnotnormallyeditthisfiledirectly.Instead,youarerecommendedtouseJMACXfunctionstoread andeditit:
ASTB.SetKeyFunction ASTB.SaveKeyFunction
SeetheAminoJMACXAPISpecificationformoreinformation,andforalistofthefunctionalitythatcanbe mappedtokeys.
2.9.2
Examplefkeys.conffile
Thefollowingsectionshowsapartialexampleofafkeys.conffile,containingentriesforIRkeyboardand theAminoIRremotecontrol.(<...>showswhereseverallineshavebeenremovedtoreducethesizeofthis example).Foracompletelistofalltheremotecontrolkeycodes,seetheAminoJMACXAPISpecification.

# First, the keyboard mappings 0x40000072 1 # Browser Home 0x40000007 17 # Help 0xC0000001 1 # Browser Home 0x40000066 3 # Browser Back 0x40000067 4 # Browser Forwards 0x40000068 6 # Browser Reload 0x40000069 5 # Browser Stop 0x4000006A 2 # Browser Goto <...> # Now the amino remote mappings 0x40000003 0 # Last Ch
16
CONTENTS
INDEX
0x4000012C 0x4000012E 0x4000012F 0x40000130 0x40000131 0x40000132 0x40000144 <...>
18 19 41 42 40 43 16
# # # # # # #
Channel Up= Browser Ch Up Channel Down= Browser Ch Down Volume up Volume down Mute Power Menu= Browser Preferences
2.10
Browserconfigurationfiles
Softwarereleaseswillnormallyincludetheconfigurationfileforthebrowser.ForFresco,thisiscalled config.txt,forOperaitisopera.ini. Oncecreatedorloadedonthesettopbox,theOperaconfigurationfileopera.iniisstoredinthefollowing location:

/mnt/nv
ForafullexplanationoftheOperaSettingsFileseehttp://www.opera.com/support/usingopera/operaini/
2.10.1 Howtovieworchangesettings
Thebrowserconfigurationfileissuppliedaspartofasoftwarerelease,itisinthefollowinglocation:
Oncecreatedorloadedonthesettopbox,thebrowserconfigurationfileconfig.txtisstoredinthe followinglocation:
/mnt/nv
Seeyourbrowsersdocumentationfordetailsofthesettingsinthisfile.AlsoseeAppendixB,Settingsfile contentsforalistofbrowserconfigurationsettingsthattheconfigurationpagesreadfromandwriteto.
2.11
DynamicDHCPsettingsfile
ThedynamicnetworkandmulticastupgradesettingsretrievedfromtheDHCPserverarestoredinafilecalled dhcpcd-eth0.info.Thesevaluesareonlysetifthesettopboxusesdynamicnetworksettings,otherwise, thestaticvaluesaredefinedintheNORFlashorthenetconffile.TheDHCPCvaluesareshowninAppendix D,dhcpcfilecontentsandarereadonly.
2.11.1 Howtoviewsettings
TheDHCPCvaluesarestoredinthefollowinglocationonthesettopbox:
/var/dhcpc/dhcpcd-eth0.info
Thevaluescanbeaccessedvialibconfigcommands(usingTelnet/SSH)orJMACXcalls.
2.11.2 DHCPClistofsettings
ThefulllistofDHCPCsettingsavailabledependsontheDHCPserverinstalledandtheAminovendoroptions configured,thatis,itdependsonwhatvaluestheDHCPserversendstothesettopbox.Thefollowingtable describesthemainsettingsthataregenerallyavailable.TheDHCPCvaluesareshowninAppendixD,dhcpc filecontentsandarereadonly.
INDEX
CONTENTS
17
Allvaluesarereadonly. Setting
BROWSER_HOMEPAGE DI DIMIN DNS DOMAIN GATEWAY IPADDR LEASE MULTICAST_FS_ADDR MULTICAST_FS_PORT NETMASK REBIND RENEWAL
Description Theaddressofthepagesetasthehomepage. Thedeploymentindex. Theminimumdeploymentindex TheIPaddressoftheDNSthatthesettopbox shouldbeusing. Thenetworkdomain. Thegatewayforthesettopbox. TheIPaddressofthesettopbox. TheDHCPleasetime. ThemulticastfilesystemIPaddress. Themulticastfilesystemport. Thenetmaskforthesettopbox. TheDHCPrebindtime. TheDHCPrenewaltime.
2.12
Fileaccesspolicy
Thefileaccesspolicyisasecurityfeatureusedtocontrolwhichfilestheusercanaccessthroughtheweb browser.ThedefaultpoliciesshowninSection2.12.1arehardcodedinthesystem.Foradditionalpoliciesa fileiscreatedcalledpolicy.definwhichyouaddanyotherlocalfilesthatyoumightwanttoaccessifthey arenotinthe'default'list(suchastheManagementpages). Allaccesspoliciesareloadedfromthefile/mnt/nv/policy.deftoavoidconditionalcompilation. Thisapproachmeansthattheonlychangestodefaultpolicyareneededinpolicyfileandinsomecasespolicy filewillnotbeneededatall.
2.12.1 Thepolicyfile
Eachlineofthisfileistreatedasseparatepolicy<ACCESS_POLICY>:<ACCESS_URL>,unlessitbeginswith #inwhichcaseitwillbetreatedasacomment.
ACCESS_POLICYhastobeoneofthefollowing:
REJECT:AccesstoURLshouldberejected ACCEPT:AccesstoURLshouldbeaccepted PASSWORD:AccesstoURLshouldbeacceptedonlyifvalidpasswordwasentered FIRST_PAGE_ACCEPT:AccesstoURLshouldbeacceptedonlyifitisfirstpageaccessedbyabrowser FIRST_PAGE_PASSWORD:AccesstoURLshouldbeacceptedonlyifitisfirstpageaccessedbyabrowser
ANDvalidpasswordwasentered
IGNORE:AccesstoURLwillbegranted,butpolicywillnotinvalidatepasswordprotectiononentering
newURL. Allpoliciesarecheckedinthesameorderinwhichtheyarelocatedinthepolicyfile,thefirstACCESS_POLICY frommatchingpolicyisreturned.
18
CONTENTS
INDEX
Ifallpoliciesarecheckedandnomatchwasfound,thentheREJECTisreturned. ApolicyismatchingifitsACCESS_URListhesameasURLthatisbeingchecked,unlessACCESS_URLends with*inwhichcaseallURLsthatbeginswithACCESS_URL(without*)arealsofoundasmatched.
2.12.2 Defaultpolicies
#Anything not in this file will be automatically rejected ACCEPT:file:///etc/htdocs/preference.html ACCEPT:file:///etc/htdocs/keyboard.html ACCEPT:file:///etc/htdocs/subtitles.html ACCEPT:file:///etc/htdocs/video-pref.html ACCEPT:file:///etc/htdocs/audio-pref.html ACCEPT:file:///etc/htdocs/pvr.html ACCEPT:file:///opt/fresco/htdocs/dvbt* ACCEPT:file:///opt/fresco/htdocs/ozone* # #Password protect rest of the docs PASSWORD:file:///etc/htdocs/*
2.12.3 Examplepolicyfile
ACCEPT:file:///mnt/nv/startup.html ACCEPT:file:///mnt/nv/nonetaccess.html
INDEX
CONTENTS
19
20
CONTENTS
INDEX
Chapter3UsingSTBremoteconf
ThischapterdescribeshowtosetupandusetheSTBremoteconfLinuxclienttocontrolandmanage AmiNETsettopboxes.Itassumesabasicmulticastupgradesystemisinstalledandthattheuserisfamiliar withsimpleLinuxcommandlinefunctionality.Forgeneralinformationonhowtosetupandmanagethe multicastupgradesystem,seetheAminoInstallandUpgradeGuide.
3.1
STBremoteconf
STBremoteconfprovidesamechanismforremotelyconfiguringandcontrollingalocalnetworkofAmiNET
settopboxes.Itcanberunonthecommandlinebysendingcommandsindividuallytooneormoresettop boxes,orcommandscanbecollectedintoascripttosavetime.Commandsaresignedwhentheyarecreated, sothatthesettopboxcancheckthatthecommandhasbeensentbyanauthorisedsource. Examplefunctionsincluderebooting,modifyingoutputmodesorupdatingsoftware,aswellasviewing informationaboutthesettopbox.
3.1.1
Howitworks
STBremoteconfconsistsofaclientapplicationonalocalPCandaserverapplicationSTBrcdinstalledon thesettopbox.STBremoteconf isoperatedbyenteringcommandsatthecommandlineorbycollecting commandsintoascript.
Anormaloperationalsequenceisasfollows: 1.
Enter command:TheuserentersacommandatthecommandlineonthePC.Thisincludes
specifyingwhetherthecommandistobesenttoasinglesettopbox,senttoamulticastgroup,or savedforlateruse. 2.
Sign command: Theuserispromptedtoenterthepassphrasefortheconfigurationkey,andthen STBremoteconfsignsthecommand.Italsoaddsanexpirytimeafterwhichthecommandwillno
longerbevalid.Bydefaultthisis30secondsafterthetimeatwhichthecommandwassigned. 3.
Send command: Ifthecommandistobesenttoasinglesettopboxortoamulticastgroup,itis
sentimmediately.Ifthecommandissavedtobesentlater,aconfirmationconfirmsthatithasbeen saved,aseparateSTBremoteconfcommandallowssavedcommandstobesent. 4.
Verify command:Whenthesettopboxreceivesacommand,thesettopboxalsousesitsstored
publicconfigurationkeytocheckthatthecommandhasbeenauthorised,andrejectscommands thatarenotauthorised.Itthencheckstheexpirytimeforthecommandagainstitsinternalclock.If thecurrenttimeislaterthantheexpirytime,itrejectsit.Thisensuresthatevenifsignedcommands areusedinacaptureandreplayattack,replayingthemlaterwillhavenoeffectonthesettopboxes. Forthisreason,thesettopboxandthePCthattheSTBremoteconfclientisinstalledonmustuse correctdateandtimesettings.

21
INDEX
CONTENTS
USING STBREMOTECONF
5. 6.
Execute command:ThesettopboxexecutesthecommandusingSTBrc,andgeneratestheappro
priateresponse.
Command response: Forcommandssenttoasinglesettopbox,aresponsecontainingtheinfor
mationrequestedorconfirmationthatthecommandwasexecuted(oranerrorreport)isreturned tothesendingPCfordisplay.Thereisnomulticastresponsechannel,soforcommandssenttoamul ticastgroup,noresponseistransmittedbythesettopboxes.
3.2
Installation
STBremoteconfisnormallyinstalledaspartofanAminomulticastsystem.IfanAminomulticastsystemis
notinstalled,followtheinstallationinstructionsintheAminoInstallationandUpgradeGuide.
3.2.1
Beforeyoustart
TheinstructionsinthissectionassumethatSTBremoteconfandothercomponentsaretobeinstalledas partofamulticastsystem.Youwillneedthefollowing: Youwillneedtoknowthepassphrasefortheconfigurationkeythatyouwillbeusingtosigncommands. FortheAminoengineeringkeythisisstbrckey.Forfurtherinformationontheuseofpasskeys,seethe AminoInstallationandUpgradeGuide. TosendcommandsviaSTBremoteconf,youwillneedtoknowtheIPaddressofindividualsettop boxes,ortheaddressforamulticastgroup.Settopboxesmustbepoweredandconnectedtothe network. Forsomeofthecommands(forexample,multicastingcommands),theDHCPserverandmulticastserver mustberunning,andappropriateupgradeimagesmustbeavailable. YouwillneedtologinasrootorhavesudorightstosendcommandsviaSTBremoteconf.
3.2.2
InstallingSTBremoteconf
Youwillneedthefollowing: Operatingsystem.
STBremoteconfissuppliedforuseonLinux.TherecommendedplatformisDebianetchavailable
fromhttp://www.debian.org/releases/stable/andtheinstructionshereassumetheuseofthisplatform. Installationfiles YouwillneedthefollowingfilestoinstallanduseSTBremoteconf:

STBremoteconf imgcfg commands
Thesefilesarenormallysuppliedintheutils/subdirectoryofafullsoftwarerelease,andareinstalled aspartofthemulticastsystemsetup.Ifthishasalreadybeendone,thenthereisnothingelsetodoto completetheinstallation. InordertosigncommandsthatyousendwithSTBremoteconf,youwillalsoneed: AprivateconfigurationkeyfileifyouareusingtheAminoengineeringkeys,thisisSTBrcKEY.private(thismustmatchthepublickeyfileonthesettopbox) Perlmodules
22
CONTENTS
INDEX
USING STBREMOTECONF
TheSTBremoteconfclienthasdependenciesonvariousexternalPerlmodules.Iftherequired modulesarenotinstalledonyoursystem,youwillseeerrorssimilartothefollowingwhenyou trytouseSTBremoteconfforthefirsttime:

Can't locate IO/Socket/Multicast.pm in @INC (@INC contains: /usr/lib/perl5/5.8.1/i386-linux-thread-multi...
Ifthishappens,youcandownloadandinstalltherequiredfiles.
3.2.3
InstallingprerequisitePerlmodules
TheSTBremoteconfclienthasdependenciesonvariousexternalPerlmodules.Youcaneitherinstallthese beforeyoustartinstallingSTBremoteconf,ortryusingSTBremoteconfandtheninstallthePerlmodules requiredonlyiferrorsarereported.
3.2.4
ToinstallthePerlmodulesrequiredbySTBremoteconf
ThefollowingprocedureassumesthatyouhavethePerlCPANmoduleinstalledandhaveinternet connectivity.Youmustbeloggedinasrootorhavesudorights. 1. 2. 3. 4. Enterthefollowingcommand:

sudo perl -MCPAN -e shell
Ifthecpan>promptisnotdisplayed,thenyouareaskedtomanuallyconfigureit.Answernotoforce anautoconfigurationforCPAN. Ifyouarepromptedtoinstallanymodules,pressEnterortypeyes. Enterthefollowingcommand:

install Bundle::CPAN
Ifyouarepromptedtoinstalldependencies,enteryes. 5. Enterthefollowingcommand:
install Date::Manip
install MIME::Base64
install File::Copy
install IO::Socket::Multicast
quit
INDEX
CONTENTS
23
USING STBREMOTECONF
YounowhavealloftherequiredPerlmodulesinstalledandyourSTBremoteconfclientshouldnowwork.
NOTE
IfyouhavearecentDebianbasedplatforminstalledyoumaybeableto replacetheabovestageswiththefollowing: Enterthefollowingcommand: apt-get install libdate-manip-perl libmime-base64perl libio-socket-multicast-perl
3.2.5
UpgradingSTBremoteconfclient
STBremoteconfclientcanbeinstalledorupgradedseparatelyfromupgradestosettopboxsoftware,butif theclientandsettopboxapplicationsareatdifferentversions,onlythefunctionalityoftheolderversionwill beavailable.Forexample,ifthenewclientapplicationincludescommandsthatarenotyetimplementedin thesettopboxsoftware,thenthecommandswillnotbeavailableuntilthesettopboxsoftwareisalso upgraded.

NOTE
1.
Loginasroot,andcopythe imgcfgtoadirectoryinyourpath(theotherAminobinaries,including mcastbootdmustalsobeinthislocation). Forexample:

cp <release_name>/utils/imgcfg /usr/local/bin
2.
CopytheSTBremoteconfandcommandsfilestothelocationyouwanttorunthemfrom.Thiscan beinthesystempathorinanotherlocation,butthetwofilesmustbestoredinthesamedirectory aseachother. Forexample,tocopythefilestoadirectoryinthepath:

cp <release_name>/utils/STBremoteconf /usr/local/bin cp <release_name>/utils/commands /usr/local/bin
3.
Copythekeyfiletoanaccessiblelocation.Instructionsinthisdocumentationgenerallyassumeitis inthefollowingsubdirectoryofanAminorelease:/utils/keys/amino/.
Theupgradeiscomplete.
3.3

RemovingSTBremoteconf
STBremoteconf imgcfg commands
InordertoremoveSTBremoteconfyouwillneedtodeletethefollowingfiles:
Thesefilesarenormallysuppliedintheutilssubdirectoryofafullsoftwarerelease.
24
CONTENTS
INDEX
USING STBREMOTECONF
3.4
3.4.1
SendingcommandswithSTBremoteconf
Tosendacommandatthecommandline
ThefollowingstepsoutlineanexamplecommandlineinteractionwithSTBremoteconf.
ThefollowingstepsassumeyouhavenotcopiedtheSTBremoteconffilestoadirectoryinthesystempath (forexample,/usr/local/bin).Ifyouhavedonethis,youdonotneedtonavigatetothedirectorythatthe STBremoteconffileisstoredin,andyoudonotneedtoenter./ atthestartofeachcommand.

NOTE
1.
SettheSTBKEYenvironmentvariablebyenteringacommandinthefollowingformat:
export STBKEY=<release_name>/utils/keys/amino/STBrc-KEY.private
NOTE
InordertosetSTBKEYasapermanentenvironmentvariable,addtheabove exportcommandtoyour.bashrcfile.
2.
NavigatetothedirectorythattheSTBremoteconffileislocatedin. Forexample:
cd <release_name>/utils
3.
Enteracommandinthefollowingformat:
./STBremoteconf [<optional_arguments>] <host> <command_option [parameter]>
Forexample,enterthefollowingcommandtofindoutthesoftwareversiononthesettopboxwith theIPaddress123.4.5.67:
./STBremoteconf -p 110,120 225.10.10.10 GETVERSION
4.
Youarepromptedtoenterthepassphrasefortheconfigurationkey.FortheAminoengineeringcon figurationkeythisisstbrckey.
NOTE
ThepassphrasecanbesetastheenvironmentvariableSTBPASS,inthesame wayasfortheSTBKEYvariable
IfthecommandsyntaxandIPaddress(es)enteredarevalid,theclientcommandissent,andfornon multicastoperations(thatis,commandssenttoasinglesettopbox)aconfirmationmessageisdis playedwhichincludesastatuscodereturnedbythesettopbox.Formulticastoperationsthereisno returnchannelsoconfirmationisnotsent. Ifyouhaveyourownkeysthenyouwillhaveyourown,different,passphrase. Youcannowenterfurthercommandsasrequired.
3.5
UsingscriptstocontrolSTBremoteconf
STBremoteconftypicallyreadsthelocationoftheprivatekeyfilefromanenvironmentvariable,andthe
passphraseassociatedwithitfrominputfromtheuserwhenamessageissent.Insomecases,suchaswhere somedegreeofautonomymayberequired,itisdesirablenottobepromptedforapassphrase.Todoso,the valueofthepassphraserequiredcanbestoredintheSTBPASSvariable.Forexample,assumingthatthe Aminoengineeringkeysarebeingused,thecommandsrequiredtosetthisupwouldbe:
INDEX
CONTENTS
25
USING STBREMOTECONF
export STBKEY=/usr/local/amino/keys/amino/STBrc-KEY.private export STBPASS=stbrckey
Theseenvironmentsettingswouldonlyremainvalidinthecurrentshellsession.Forcompleteautonomy, theseexportstatementscouldbeaddedtotheuser's.bashrcfile,orothershellsettingsfile,dependenton theLinuxdistributionbeingused. Ifthetwoexportvariableswereset,norequestforapassphrasewouldbemadebySTBremoteconfwhen sendingamessage.Anyoneusingthisfeatureshouldbeawareofthepotentialsecurityimplicationsofstoring thepassphrasefortheprivatekeyinthisunprotectedform.
3.6
STBremoteconfparametersyntax
STBremoteconfisoperatedbyenteringcommandswiththefollowingsyntax: ./STBremoteconf [-p <product_list>] [-e <expiry>] [-t <multicast_ttl>] [-P <port>] <host> <command_options [<parameters>...]>
Argument
-p <product_list>
Usage Acommaseparatedlistofproductcodesthatyou wantthecommandtoapplyto.Forexample: p110,130,110h Timeatwhichthemessagewillexpire.Ifyoudonot includethisargument,itdefaultsto30secondsfrom thecurrenttime. Thetimespecifiedshouldbeacceptabletothe ParseDatePerlcommand.Forexample: "today" "1st Thursday in June 2008" "05/10/07"
"12:30 Dec 12th 1880" "8:00pm December tenth"
-e <expiry>
-t <multicast_ttl>
Networktimetolivevalueforthemessage. ThepurposeoftheTTLfieldistoavoidasituationin whichanundeliverabledatagramkeepscirculating onaninternetsystem,andsuchasystemeventually becomingswampedbysuchimmortaldatagrams.In theory,timetoliveismeasuredinseconds,although everyhostthatpassesthedatagrammustreducethe TTLbyatleastoneunit.Inpractice,theTTLfieldis reducedbyoneoneveryhop. Porttosendthecommandon. Forunicast,thedefaultportis54321. Formulticast,thedefaultportis22222. Thehostargumentthatspecifieswherethecom mandwillbesentorenablesyoutosavethecom mandforuselater.Seebelowformoreinformation.
-P <port>
<host>
-m
26
CONTENTS
INDEX
USING STBREMOTECONF
Argument
<command_options [<parameters>...]>
Usage Thecommandthatwillbeexecuted.
Alternatively,youcanenterthecommand./STBremoteconfwithoutanyargumentstodisplayhelpatthe commandline.
NOTE
IfyouhavecopiedtheSTBremoteconftoadirectoryinthesystempath(for example,/usr/bin),youcanenterthecommandswithoutthe./atthe start.
3.6.1
<host>argument
The<host>argumentmustbeincludedinallcommands.Itcanbesetwithoneofthefollowingtypesof value,dependingonwhereyouwantthecommandtobesent:
<multicast_group>
Tosendthecommandtoallsettopboxeslisteningonaparticularmulticastgroup,entertheIPaddressofthe group(forexample,asdefinedintheDHCPserverconfigurationorinthesettopboxsconfiguration).Ifno grouphasbeenconfiguredonthesettopbox,thedefaultaddress225.10.10.10isused.

NOTE
Thereisnoreturnchannelforstatusmessagestobereturnedwhen multicasting,sonoconfirmationcanbesent,andmanycommandsthat requestinformationsuchasversionorstatuscannotbesenttoamulticast group.
<unicast_IPaddress>
Tosendthecommandtoasinglesettopboxlisteningonthenetwork,entertheIPaddressforthebox. Alternatively,youcanenteravalidname(whichhasaDNSentry).Youshouldsendcommandstoasinglebox inthiswayifyouwanttoconfiguresettingsforasinglebox,orifthecommandreturnsinformationsuchas statusorversion. IftheIPaddressisinvalid,thenthefollowingerrorisreturned:

Couldnt convert to internet address: Resource temporarily unavailable.
IftheIPaddressisvalid,butthesettopboxdoesnotrespondtothecommand(forexample,thesettopbox isnotconnectedortheaddresshasnotbeenallocatedbytheDHCPserver),thenthefollowingerroris returned:

Couldnt connect: Connection refused
3.6.2
SAVE
Tosignacommandandsaveitformulticastingorunicastinglater,replace<host>withSAVE.Thisisuseful asitallowsyoutocollectmultiplesignedcommandstogethertobetransmittedaltogetherlater,ortogivea signedcommandtoathirdpartythatitisnotappropriatetogivekeysto.
INDEX
CONTENTS
27
USING STBREMOTECONF
STBremoteconfsavesthesignedcommandtoaSAVEFILE.msg fileinthecurrentdirectory,andyoucan senditlaterusingtheSIGNEDCMDcommandoption.

NOTE
AlthoughtheSAVEcommandcanbeused,forinstance,tocreateabatchof multicastorunicastcommands,theexpirytime(thedefaultis30seconds) fromthetimethecommandissignedstillapplies.Thismeansthateach commandmustbemulticast/unicastbeforeitsexpirytimeisreached.The-e parametercanbeusedtospecifyalongerexpirytime. Forexample: STBremoteconf -e "December 16th 2009" SAVE REBOOT
3.6.3
<command_options>argument
The<command_options>argumentmustbeincludedinallcommands,andspecifiestheoperationyouwant toexecute.Someoptionsalsorequireadditionalparameters.See"Overviewofcommandoptions"onpage 28foralistofavailableoptions.
3.6.4
Overviewofcommandoptions
YoucanaddoneofthefollowingtotheSTBremoteconfcommand.Alternatively,enterthecommand withoutaddinganyoptionstoviewSTBremoteconfversioninformationandafulllistofavailablecommands atthecommandline.(seethefullcommandlistfordetailsofwhentheyshouldbeused).Youshouldonlyuse theseifyouarefullyawareoftheimplicationsforyoursettopbox. Command CHANGEPAGE<url> CHANGEPWORD <username> CHANNEL <channel_number> EAS <message> ETHERNET <value> GETCONFIGseeSETCONFIG GETDI GETSERIALID GETVERSION HWINFO LOGREAD OUTFMT<format> OUTRES PING <remote_host> <count>
<backoff_secs>
Usage Displaysthepagespecifiedonthesettopbox browser. Changessettopboxuserpasswords. Changesthechannelofoneormoresettop boxes. SendsanEAS(EmergencyAlertSystem)message. SetstheEthernetspeed. Allowsakeydefinedbylibconfig(seeUsinglib configtogetandsetvalues)tobeobtained. Returnsthedeploymentindex. ReturnstheSTBserialnumber Returnsthecurrentsoftwareversionontheset topbox. Returnsinformationaboutthesettopbox hardware. Returnslastfewentriesfromsyslog. Setstheoutputformatofthesettopbox. Setstheoutputresolution.(HDcapableboxes only) InstructssettopboxtosendICMPecho(ping) requeststoaremotehost. Table3.4:
28
CONTENTS
INDEX
USING STBREMOTECONF
Command PROC <proc_entry> PS REBOOT REFLASH REFORMAT
Usage Sendsspecifiedprocentrytothesettopbox. Runsthepsprocessonthesettopbox. Rebootsthesettopbox. WipestheNANDflashonthesettopbox,then downloadnewsoftware. Erasetheharddriveofthesettopbox. STBsthatdonothaveaharddrivewillnotbe affected. Enables/disablesorresetstheRFmodulatoron thesettopbox(ifthereisone). Allowssettingofakeydefinedbylibconfig (exceptMACaddress,SerialIDorLockvalue.) Runsascripttoobtaindebugginginformation fromthesettopbox. Returnsstatusinformationaboutthesettopbox. Redirectsthesettopboxssyslogtothe specifiednewhost. SetstheTVstandardtobeused. Instructssettopboxtoupgradetosoftwareavail ableatmulticastgroupspecified. Instructssettopboxboxesrunningdifferent softwareversionstoupgradetothespecifiedver sion. ExecutesVideoonDemandoperations. Table3.4:
RFMODE <option> SETCONFIG SNAPSHOT STATS SYSLOG <new_host> TVSYSTEM <option> UPGRADEMCAST <IPaddress>
<port>
UPGRADEMCAST_VER <IPaddress>
<port> <software_version_string>
VOD <option>
3.7
Listofcommands
ThefollowingisalistoftheSTBRemoteconfcommandssupportedatpresent.
CHANGEPAGE
InstructsthewebbrowsertogotoaspecificURL.Whatevertheuserisviewingatthetimewillbeinterrupted, includingvideo.
Usage
./STBremoteconf <host> CHANGEPAGE <url>
Example
./STBremoteconf 225.10.10.10 CHANGEPAGE http://www.aminocom.com
INDEX
CONTENTS
29
USING STBREMOTECONF
CHANGEPWORD
Changesthespecifieduserpasswordonthesettopbox.Thisoptiononlyworkswithsettopboxsoftware versionsthathavebeensetuptoallowit,thisisnotenabledinstandardreleases. Youarepromptedtoenterthenewpasswordtwice(tocatchanytypingerror,asthepasswordyoutypeisnot echoedtothedisplay).Anerrorisreturnediftheusernamedoesnotexistorpasswordchangingisnot supportedinthesettopbox. Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. Seebelowforinformationonchangingthesedefaultpasswords. Thefollowingusersarerecognised: Username
root mngread mngwrite identity
Description UsedforTelnet/serialconsoleaccessondevelop mentbuilds. Usedforaccesstothesettopboxmanagement pages. Usedtowritebackchangesfromthesettopbox managementpages.
Default password
root2root leaves snake
tiger Usedforchangingthesettopboxidentity parameters(e.g.MACaddress)fromthesettopbox managementpages.Thisfunctionalityisonly availableinproductionsettopboxes,anddisabled duringmanufacture.
Usage
./STBremoteconf <host> CHANGE-PWORD <username>
Example
./STBremoteconf 10.172.227.145 CHANGE-PWORD mngread
Exampleresponseinteraction
Enter new password for user 'mngread: Retype new password for user 'mngread: Unicasting... Passphrase (for key <key setup in STBKEY env. variable>): Signed image written to '/tmp/TMPFILE.signed' Got back: OK
CHANNEL
Changesthecurrentchannelofasingleormultiplesettopboxes.
NOTE
ThiscommandwillnotworkonanAmiNET530withaMinervabuildinstalled.
30
CONTENTS
INDEX
USING STBREMOTECONF
Usage
./STBremoteconf <host> CHANNEL <channel_number>
Example
./STBremoteconf 225.10.10.10 CHANNEL 123
EAS
SendsanEAS(EmergencyAlertSystem)message.Itistheresponsibilityofthemiddlewarerunningontheset topboxtoactonthismessageandperformanyrequiredoperations. Usage:
./STBremoteconf <host> EAS <message>
Example:
./STBremoteconf 225.10.10.10 EAS <XML><Message> This is a message</Message><XML>
ToreceivethemessageontheSTByouneedtousetheAminoGenericclass.Theservicenumberforthe STBRemoteconfEASserviceis13.
UsageexampleFresco
// The event handler itself function eventhandler(xml_event_string) { alert (Message sent to eventhandler + xml_event_string) ; } // Register the event handler for unique service identifier ID of 13 (EAS) AminoGeneric.onEvent13=eventhandler ;
UsageexampleOpera
ThefunctiondefinitionisthesameasforFrescobrowsers,buttheregistrationis:
AminoGeneric.onEvent13=eventhandler;
ForfurtherinformationseeAminoTechnicalNote024UsingAminoGeneric.
ETHERNET
Restricted: Not for use with OTP set-top boxes.
SetstheEthernetspeedtooneofthefollowingvalues:
AUTO 10HD 10FD 100HD 100FD
INDEX
CONTENTS
31
USING STBREMOTECONF
NOTE
10BaseTEthernetisnotsupportedbyx4xseriesSTBs.
Usage
/STBremoteconf <host> ETHERNET <value>
Example
/STBremoteconf 225.10.10.10 ETHERNET 100FD
FETCHFILE
Copiesthespecifiedfilefromthesettopboxlocationandstoresitlocally.
Usage
./STBremoteconf <host> FETCHFILE <local_filepath> <remote_filepath>
Example
./STBremoteconf 225.10.10.10 FETCHFILE config.txt /mnt/nv/config.txt
GETCONFIGseeSETCONFIG
GETDI
Returnsthedeploymentindex.Thiscommandisonlyusefulviaunicast.
Usage
./STBremoteconf <host> GETDI
Example
./STBremoteconf 10.172.227.145 GETDI
GETSERIALID
Returnstheserailnumberofabox.
32
CONTENTS
INDEX
USING STBREMOTECONF
Usage
./STBremoteconf <host> GETSERIALID
Example
./STBremoteconf 10.172.227.145 GETSERIALID
Exampleresponse
Got back: 603107D020911
GETVERSION
Returnsthesoftwareversionofabox.Thiscommandisonlyavailableviaunicast.
Usage
./STBremoteconf <host> GETVERSION
Example
./STBremoteconf 10.172.227.145 GETVERSION
Exampleresponse
Got back: 0.16.3-opera9
HWINFO
Returnstheproduct,boardrevisionandROMtypeofthesettopboxes.Forunicastonly.
Usage
./STBremoteconf <host> HWINFO
Example
./STBremoteconf 10.172.227.145 HWINFO
Exampleresponse
aminet110 (revision 2) ROM type: 0xc222-SS-S4
LOGREAD
Returnsthelastfewentriesfromsyslog.Thiscommandisonlyusefulviaunicast.
Usage
./STBremoteconf <host> LOGREAD
INDEX
CONTENTS
33
USING STBREMOTECONF
Example
./STBremoteconf 10.172.227.145 LOGREAD
OUTFMT
Setstheoutputformat. Restricted:NotforusewithOTPsettopboxes.
Usage
./STBremoteconf <host> OUTFMT <new output format>
Example
./STBremoteconf 225.10.10.10 OUTFMT CVBS-LC
Theoptionsare: Value Meaning RGB(whereavailable)

CVBS-RGBON LC-RGBOFF LC-RGBON CVBS-LC CVBS-LBR
CVBS-RGBOFF Enablecompositeoutputwithout
EnablecompositeoutputwithRGB (whereavailable) EnableSvideooutputwithoutRGB (whereavailable) EnableSvideooutputwithRGB (whereavailable) EnablecompositewithSVideo (whereavailable) Enablecompositeandcomponent (YPbPr)(whereavailable) component(YPbPr)(whereavaila ble)
LBR-CVBS-LC Enablecomposite,SVideoand
RGB-CVBS-LC EnableRGBwithcompositewith
Svideooutputs(whereavailable)
OUTRES
Setstheoutputresolution.ThiscommandisonlysupportedbyHDcapablesettopboxes(forexample,A120, A130,A530). ThecorrectfrequenciesforthesesettingsaredetectedusingTVSYSTEM.Thisisdonetotryandlimit accidentalmisconfiguration. Theoutputresolutionwillbeoneofthefollowing:
SD
34
CONTENTS
INDEX
USING STBREMOTECONF
480p 576p 720p 108i
Usage
./STBremoteconf <host> OUTRES <new output resolution>
Example
./STBremoteconf 225.10.10.10 OUTRES 720p
PING
InstructsthesettopboxtosendanumberofICMPecho(ping)requeststoaremotehost.Inanetworkwith multiplesettopboxes,thiscommandcanbemulticastandthenthenetworkcanbemonitoredforreplies,to determinewhichsettopboxesreceivedthemessage.
Usage
./STBremoteconf <host> PING <remote_host> <count> <backoff_secs>
where
<count> <backoff_secs> Specifiesthenumberofechorequeststosend. Specifieshowlongtowaitbeforesendingthefirstrequest(inseconds).Ifyouspecifya backoff_secsparameterofzero,thesettopboxsendstheICMPechorequestsassoon asitreceivesthemessage.Ifbackoff_secs isgreaterthanzero,thesettopboxwaitsa randomtimeintervalbetweenzeroandbackoff_secssecondsbeforesendingthefirst ICMPecho,followedbyonesecondbetweeneachrequest.
Example
./STBremoteconf 225.10.10.10 PING 139.255.1.1 10 0
PROC
Queriesthesettopboxforthevalueofthespecifiedprocentry,forexample,toquerymemoryusage.
NOTE
TheLinuxcommandcat /proc/<proc_entry>willgivethesame informationasusingPROC <proc_entry>. Thiscommandisonlyuseful viaunicast.
Usage
./STBremoteconf <host> PROC <proc_entry>
Example
./STBremoteconf 10.172.227.145 PROC meminfo
INDEX
CONTENTS
35
USING STBREMOTECONF
PS
Performsalinuxpsonthesettopbox.Thiscommandisonlyusefulviaunicast.
psdisplaysinformationaboutaselectionoftheactiveprocesses.
Usage
./STBremoteconf <host> PS [option]
NOTE
Theonlyoptionpresentlyavailableisthe -wswitch,whichincreasesthe numberofcharactersdisplayedoneachlineofoutputfromthepscommand from79to255.
Example
./STBremoteconf 10.172.227.145 PS -w
REBOOT
Triggersarebootofthesettopbox,whichismostusefulwhenrestartingthedeviceaftermaking configurationchangesinunicastmode.Thecommandreturnsastatuscodeindicatingwhetherthecommand wasaccepted.Notpermittedinmulticastmode.
NOTE
Thesettopboxautomaticallyrebootsaftersomecommands,suchasa MCAST_UPGRADE.
Usage
./STBremoteconf <host> REBOOT
Example
./STBremoteconf 10.172.227.145 REBOOT
REFLASH
Requestsareflashofthesettopbox.ReflashingreferstodeletingallthecontentsoftheNANDflashand replacing,viathebootstrapmethod(bootstrap.signed),themainsoftwareimage(mcs.mfs).Theupdate isdonebyformattingtheflashmemoryandreloadingitfromtheappropriateserver.Beforeusingthis command,ensurethatvalidsoftwareexists,andthatnoattemptismadetointeractwiththedevice(suchas disconnectingmainspower)duringtheupdateprocess.Thiscommandwipesanypersistentsettingstoredin theNANDflash(/mnt/nv).
NOTE
IfanupgradeisrequiredratherthanareflashthenseetheUPGRADEMCAST command.Forfurtherinformationonthedifferencesbetweenupgradingand reflashingtheSTBseetheAminoInstallandUpgradeGuide.
Usage
./STBremoteconf <host> REFLASH
36
CONTENTS
INDEX
USING STBREMOTECONF
Example
./STBremoteconf 225.10.10.10 REFLASH
REFORMAT
Erasetheharddriveofthesettopbox. Settopboxesthatdonothaveaharddrivewillnotbeaffected. Thesettopboxwillreboottoperformthiscommand. Thecommandreturnsastatuscodeindicatingwhetherthecommandwasaccepted.. Warning: Allthecontentoftheharddrivewillbeerasedifyouissuethiscommand
NOTE
Thiscommandisnotpermittedinmulticast.
Usage
./STBremoteconf <host> REFORMAT
Example
./STBremoteconf 225.10.10.10 REFORMAT
RFMODE
EnablesordisablestheRFmodulator(ifpresent)and/orchangesthecurrentRFchannel. Thefollowingoptionsareavailable: Option
<channel> ENABLE <channel> DISABLE <channel> PRESERVE
Description SetstheRFchannelto<channel> andenablestheRFmodulator. SetstheRFchannelto<channel> anddisablestheRFmodulator. SetstheRFchannelto<channel> anddoesnotchangethecurrent settingoftheRFmodulator. SetstheRFchannelto<channel> anddoesnotchangethecurrent settingoftheRFmodulator. EnablestheRFmodulatorforthe currentRFchannel. DisablestheRFmodulatorforthe currentRFchannel
<channel>
ENABLE DISABLE
INDEX
CONTENTS
37
USING STBREMOTECONF
Usage
./STBremoteconf <host> RFMODE <option>
Example
ThissetstheRFchannelto38andenablestheRFmodulator.
./STBremoteconf 225.10.10.10 RFMODE 38 ENABLE
SAVEFILE
Uploadsalocalfiletothesettopboxfilestore.Thisisparticularlyusefulwhensettingauniqueconfiguration toadevicebyreplacingitsconfig.txtfile.Specifyingthelocalfilenamefollowedbythefullpathtostore thefileonthesettopbox. Thelocalfilenameisvalidatedtoensurethatitexists.Theremotenameisnotvalidated.Iftheremotename isspecifiedwithoutdirectoryinformation,thefileisstoredintherootfolder.Youcanspecifythecomplete pathfortheremotefilename,butonlyexistingfoldernamescanbeused(itisnotpossibletocreatesub folderswithinthesettopboxstoragewiththiscommand).
Usage
./STBremoteconf <host> SAVEFILE <local_filepath> <remote_filepath>
Example
./STBremoteconf 225.10.10.10 SAVEFILE config.txt abcde.txt
Thisstoresthefileconfig.txtas abcde.txtintherootfolderofthesettopbox.
SETCONFIG,GETCONFIG
Setsorgetsakeydefinedbylibconfig
Usage
./STBremoteconf <host> SETCONFIG <config option> <value> ./STBremoteconf <host> GETCONFIG <config option>
Example
/STBremoteconf 225.10.10.10 SETCONFIG OUTPUT_RESOLUTION HD720P50 /STBremoteconf 225.10.10.10 GETCONFIG OUTPUT_RESOLUTION => HD720P50
NOTE
YoucannotuseSETCONFIGtochangetheMACaddress,SerialIDorLockvalue.
38
CONTENTS
INDEX
USING STBREMOTECONF
SIGNEDCMD
Sendsaprepreparedsignedcommandout.ThisrequiresafilegeneratedbySTBremoteconfusingtheSAVE commandandallowstheusertosendoutacommandwithoutneedingapasswordoraprivatekey,soitcan beusefultoallowuntrustedpartiestosubmitcommands.
Usage
./STBremoteconf <host> SIGNEDCMD <file>
Example
./STBremoteconf 10.172.227.145 SIGNEDCMD SAVEFILE.msg
SNAPSHOT
RunsascripttoobtaindebugginginformationfromtheSTB
Usage
./STBremoteconf <host> SNAPSHOT <path/filename>
Example
./STBremoteconf 10.172.227.145 SNAPSHOT <path/tmp>
STATS
Returnsasetofstatusvaluesforthesettopbox.Thiscommandisonlyusefulviaunicast.
NOTE
Afulldescriptionofthemeaningsofthereturnedparametersisavailablein AminoTechnicalNote030The STBRemoteconf stats command.
Usage
./STBremoteconf <host> STATS
Example
./STBremoteconf 10.172.227.145 STATS
Exampleofthetypesofvaluesreturned
Got back: MACADDRESS: 00:02:02:03:bd:97
(last_skip_timestamp skips_in_this_movie total_skips) 0 0 0 (last_serror_timestamp serrors_in_this_movie total_serrors) 0 0 0 (timestamp_of_movie_start current_time) 0 76319
INDEX
CONTENTS
39
USING STBREMOTECONF
0 0 (last_overflow_timestamp overflows_in_this_movie total_overflows last_underflow_timestamp underflows_in_this_movie total_underflows fullness) 0 0 0 0 0 0 0 0 (last_overflow_timestamp overflows_in_this_movie total_overflows last_underflow_timestamp underflows_in_this_movie total_underflows fullness) 0 0 0 0 0 0 0 (top_bit:other_32) 0:0
Inter-|
Receive
Transmit pack0 135
face |bytes packets errs drop fifo frame compressed multicast|bytes ets errs drop fifo colls carrier compressed 0 0 lo: 0 eth0: 0 0 0 0 3116 0 438308 0 0 0 0 0 0 0 0 0 0 2925 0 0 0 0 0 0 0 0
total: Mem:
used:
free:
shared: buffers: 0
cached:
31207424 18276352 12931072 0 27258880 30476 kB 12628 kB 0 kB 172 kB 11004 kB 0 kB 2012 kB 12956 kB 0 kB 0 kB 30476 kB 12628 kB 26620 kB 26620 kB
176128 11268096
Swap: 27258880 MemTotal: MemFree: MemShared: Buffers: Cached: SwapCached: Active: Inactive: HighTotal: HighFree: LowTotal: LowFree: SwapTotal: SwapFree:
40
CONTENTS
INDEX
USING STBREMOTECONF
SYSLOG
Redirectsthesettopbox'ssyslogtothenewhostyouspecify.Sysloghandlesloggingofvariouseventand debugmessagesonthesettopbox.Youcanredirecttheoutputtoanalternativehost,suchasalocalPC.
NOTE
Dependingonyoursystemconfiguration,youmaywanttoredirectsyslogs individually.
Youwilneedtosetupyourservertoacceptremotesyslogmessages.ForfurtherinformationonSyslog,see http://www.syslog.org/wiki/Main/SyslogHome.
Usage
./STBremoteconf <host> SYSLOG <new_host>
Example
./STBremoteconf 10.172.227.145 SYSLOG 234.56.78.0
TVSYSTEM
ChangestheTVstandardtooneofapredefinedsetofvalues. Thefollowingoptionsareavailable:
PAL-I PAL-M PAL-N PAL-G PAL-B PAL-H NTSC-J NTSC-M
Value PALI PALM PALN PALG PALB PALH NTSCJ NTSCM
Exampleregion UK Brazil Argentina Europe Australia,Ghana Belgium Japan USA
AcompletelistoftheWorldwideTVStandardscanbefoundintheAminoTVStandardsGuide.
Usage
./STBremoteconf <host> TVSYSTEM <option>
INDEX
CONTENTS
41
USING STBREMOTECONF
Example
./STBremoteconf 225.10.10.10 TVSYSTEM PAL-I
UPGRADEMCAST
Instructsoneormoresettopboxestoupgradetothesoftwareofferedonaparticularmulticastgroup.This commandisonlyvalidforsoftwareversionssupportingmulticastupgrade(itisnotvalidforTFTPbooting softwareversions).Asoftwareversionmustbemulticastingonthespecifiedgroupwhenthecommandis sent.Oncetheupgradeiscomplete,thesettopboxwillautomaticallyrebootintothenewversion,youcan usetheGETVERSION commandtocheckthatthenewsoftwareversionisinuse. Thiscommandretainsvariouspersistentsettingsfilesheldintheflash,suchassettingsandnetconf.For moreinformationonthesettingsfilesseeAppendixB,Settingsfilecontents,formoreinformationon netconfseeAppendixC,Netconffilecontents.
Usage
UpgradingoneSTB
./STBremoteconf <host> UPGRADEMCAST <IPaddress> <port>
UpgradingmultipleSTBs.
./STBremoteconf -P <port> <Multicast Address of STBs Listen> UPGRADEMCAST <Multicast Upgrade address> <Upgrade port number>
Examples
UpgradingoneSTB.
./STBremoteconf 10.172.227.145 UPGRADEMCAST 239.255.1.1 12345
UpgradingmultipleSTBs.
STBremoteconf P 1111 239.39.39.1 UPGRADEMCAST 239.240.1.1 11111
UPGRADEMCAST_VER
Instructssettopboxestoupgradetoaspecifiedsoftwareversion.Itisonlyvalidforsoftwareversions supportingmulticastupgrade(itisnotvalidforTFTPbootingsoftwareversions).Thecommandtakesthree parameters:anumericmulticastaddress,aportnumberandthefullsoftwareversionstring.Asoftware versionmustbemulticastingonthisgroupwhenthecommandissent.Thesettopboxcomparesitscurrent softwareversionstringwiththeupgradeversionstringspecified,andonlyupgradesifthestringsaredifferent. Oncetheupgradeiscomplete,thesettopboxwillautomaticallyrebootintothenewversion.
Usage
./STBremoteconf <host> UPGRADEMCAST_VER <IPaddress> <port> <version_string>
Example
./STBremoteconf 225.10.10.10 UPGRADEMCAST_VER 2 255.50.50.51 11111 0.16.7-opera9
42
CONTENTS
INDEX
USING STBREMOTECONF
VOD
Allowsremotevideoondemandoperationstobeexecuted.Forexample,aPAUSEoperationmayberequired beforeyoucansendanothercommand. Thefollowingvideoondemandoperationsaresupported:
PLAY PAUSE STOP FF RW
NOTE
VOD PLAYshouldonlybeusedtoresumefromaPAUSEstate.Toinitiatea newvideoondemandsessionremotely,usetheCHANGEPAGEcommandto pointtotherequiredvideoondemandresource.
Usage
./STBremoteconf <host> VOD <option>
Example
./STBremoteconf 225.10.10.10 VOD PAUSE
INDEX
CONTENTS
43
USING STBREMOTECONF
44
CONTENTS
INDEX
Chapter4Usinglibconfig
Thelibconfigconfigurationtoolenablesyoutointeractwithsettopboxconfiguration.Inmostcases,you canretrieveorsetanyoftheavailableconfigurationsettings.
4.1

Beforeyoustart
Theinstructionsinthisdocumentationassumethatthesettopboxesyouwanttocommunicatewithare poweredandconnectedtothenetwork.Youwillneedthefollowing: Tosendcommandsvialibconfig,youwillneedtoknowtheIPaddressofindividualsettopboxesthat youwanttocommunicatewith. Tosendcommandsvialibconfigyouwillneedacommandlinedirectlyontothebox.Thiscaneither beviaatelnet/sshsessionorusingadebugcable. Youwillneedtoknowthepasswordfortherootuseronthesettopbox.Thisisroot2root ifyouhave notchangedthedefault. Ifyouwanttofollowtheinstructionshereonusingtelnettosendlibconfigcommandsyouwillneed tohavesoftwarewithtelnetenabled.SeeEnablingremotelogintoolsformoreinformationoninclud ingtelnet.BothTelnetandSSHarenormallydisabledforrollout,soyouwillneedtoenableitbyadding ittothesoftwareimageonthesettopbox.
4.2
libconfigconfigurationareas
libconfigcanbeusedtoaccessvariousareasofconfiguration,usingauniqueprefixforeacharea.Inmost cases,libconfigcanreadorwritesettings,butthereareafewexceptionsforwhichlibconfigaccessis readonly.
4.2.1
NORFlashconfiguration
TheNORFlashcontainssettingsrequiredbytheROM.Insomecases,thiscanincludestaticnetworksettings (thesewouldotherwisebesetinthenetconffile).
4.2.1.1 libconfig prefix

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithNORFLASH.Forexample,forthe DIsetting,thelibconfigkeyisNORFLASH.DI.
INDEX
CONTENTS
45
USING LIBCONFIG
4.2.2
Settingsconfiguration

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithSETTINGS.Forexample,to accesstheRTSPSERVERsetting,thelibconfigkeyisSETTINGS.RTSPSERVER. Forexample:
libconfig-set SETTINGS.RTSPSERVER bitband
4.2.3
Hostnameconfiguration
Thehostnamefilecontainsjustasinglesetting,thatspecifiesthenameofthesettopbox.

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithHOSTNAME.FortheHOSTNAME setting,thelibconfigkeyisHOSTNAME.HOSTNAME.
4.2.4
Netconfconfiguration

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithNETCONF.Forexample,to accesstheDHCPTIMEOUTsetting,thelibconfigkeyisNETCONF.DHCPTIMEOUT.
4.2.5
Usersettingsconfiguration
Theusersettingsfilecontainssettingsthatthesettopboxusercontrols(forexample,throughthe Preferencespages).Theseoverridethevaluesspecifiedforthesamesettingsinthesettingsfile.Thevalues persistwhenanewsoftwareimageisloadedtothesettopbox,butnotiftheboxisreflashed.

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithUSERSETTINGS.Forexample, forthePREFERRED_LANGsetting,thelibconfigkeyisUSERSETTINGS.PREFERRED_LANG.
4.2.6
DHCPCconfiguration
ThedynamicnetworkandmulticastupgradesettingsretrievedfromtheDHCPserverarestoredinafilecalled dhcpcd-eth0.info.Thesevaluesareonlysetifthesettopboxusesdynamicnetworkandmulticast upgradesettings,otherwise,thestaticvaluesaredefinedintheNORFlashorthenetconf file.TheDHCPC valuesarereadonly.
46
CONTENTS
INDEX
USING LIBCONFIG

Tocreatethekeyforuseinlibconfigcommands,prefixthesettingnamewithDHCPC.Forexample,fortheDNS setting,thelibconfigkeyisDHCPC.DNS.
4.3
Usinglibconfigtogetandsetvalues
Thefollowingsectiondescribeshowtosetnewconfigurationvalues.Weprovideacommandlineutility libconfig-settosetconfigurationvalues.libconfig-getcanbeusedtoquerythevalues.
4.3.1
libconfigsetcommandsyntax
Thelibconfigcommandsforsettingandqueryingsettopboxconfigurationhavesimilarsyntax:
libconfig-set <config_key> value
or
libconfig-get <config_key>
Argument
<config_key>
Usage Keyformedfromaprefixthatrelatestothecon figurationareaandthenameofthesetting.For example,fortheDEFAULT_VOLUMEsettinginthe settingsfile,thekeyis SETTINGS.DEFAULT_VOLUME. Specifiesthenewvaluefortheconfigurationset ting.Onlyrequiredforthelibconfig-setcom mand. Note:Ifthisvaluecontainsanyspaces,itmustbe enclosedinquotationmarks(forexample:file name.txt),otherwise,thequotationmarksare notrequired.
<value>
Forexample:
libconfig-set SETTINGS.DEFAULT_VOLUME 80
or
libconfig-get SETTINGS.DEFAULT_VOLUME
4.3.2
NOTE
TosetavalueviaTelnet
Thisisusuallydisabledforsecurityreasons.
ThefollowingstepsoutlinehowtosendlibconfigcommandsviaTelnet.
1.
Fromaconsolewindow,Telnettothesettopbox. Forexample,ifyoursettopboxsIPaddressis123.4.5.67,enterthefollowingcommand:
telnet 123.4.5.67
2.
Youarepromptedtoenterlogindetails.Theusernametologinasisroot,thepasswordis root2root(unlessyouhavechangedthepasswordfortherootuser).
INDEX
CONTENTS
47
USING LIBCONFIG
3.
Enterlibconfigcommands,asrequired. Forexample:
libconfig-get SETTINGS.DELAY_FACTOR
ThiscommandreturnstheDELAY_FACTORsettingfromtheSETTINGS fileonthesettopbox,and displaysitintheconsole,ifyourequestasettingforwhichnovalueisset,thennoreturnvalueis displayed. Forexample:

libconfig-set SETTINGS.DELAY_FACTOR 5
Thenewvalue(5)isconfirmedintheconsole,followedbyanoteofthevalueyoureplaced:
Setting 'SETTINGS.DELAY_FACTOR'='5' SETTINGS.DELAY_FACTOR currently '(null)'
4.
Whenyouhavefinished,exitTelnetbytypingthefollowingcommand:
quit
4.3.3
Tosetavalueusingcommandsinascript
Thisisparticularlyusefulifyouneedtousesetvaluesinmultiplesettopboxesforexample,tosetstatic networksettings. Foranexampleofthis,see"Creatinganupgradescript"onpage53.
4.3.4
TosetavalueusingtheJMACXAPI
TheASTB.SetConfig/ASTB.GetConfigfunctionsintheJMACXAPIcalllibconfigfunctions(seethe AminoJMACXAPISpecificationformoreinformation). ThesettopboxmanagementpagesalsousetheASTB.SETConfig/GetConfigfunctiontomodifysettings. Commandstaketheform:

ASTB.SetConfig (<password> , <config_item> , <value>) Example use ASTB.SetConfig (<password>), SETTINGS.DELAY_FACTOR, 5) ASTB.GetConfig (SETTINGS.DELAY_FACTOR)
Parameters
password
Allowedvalues
Description Thepasswordforthemngwrite user,asrequiredforchanging settingsontheManagementpages ofthesettopbox. Stringcontainingtheconfiguration itemtoset.
config_item
48
CONTENTS
INDEX
USING LIBCONFIG
Parameters
value
Allowedvalues
Description Stringcontainingthevaluetosetthe specifiedconfigurationitem. Suitablevaluesdependonthespeci fiedconfig_item.
INDEX
CONTENTS
49
USING LIBCONFIG
50
CONTENTS
INDEX
Chapter5Customisingasoftwareupgrade image
Youcancustomisesoftwarebeforeitisloadedontoasettopboxbyconfiguringtheimagecomponentsused tocreatethesoftwareupgradeimage.Thesectionsinthischapterdescribehowtoconfiguretheimage componentsandprovideadditionalinformationonsomeoftheimportantcomponentsthatyoumayneedto use.
5.1
Configuringimagecomponents
Configuringimagecomponentsenablesyoutocustomisethefilesusedtocreateasoftwareupgradeimage. Whenthesignupgradeimagescriptcreatesanewimage,itincludesthefilesthatarelistedinthe flashcontentsfileandstoredintheimagecomponents/ subdirectoryofthesoftwarerelease.Youcan editthesefilesoraddnewonesinordertocustomisethesoftwareupgradeimagetoyourrequirements. Forexample,youcan: editconfigurationfilesbeforetheyaremadeavailabletosettopboxes. addfilesneededtoenableTelnet,SSHorDropbear. add/editanupgrade.shscriptfilethatthesettopboxwillexecutewhenitinstallsthenewsoftware upgradeimage. replacegraphics(displayedduringthebootstages)withcustomisedversions.Forexample,the
splash.gifgraphic.
NOTE
Allfilesintheimagecomponents/ directorymustbelistedinthe flashcontentsfile,otherwise,thesignupgradeimagescriptwillfail.
5.1.1
Toconfigureimagecomponents
Thegeneralprocedureforeditingimagecomponentsisasfollows:
NOTE
1.
Openthefilethatyouwanttoedit.Theimagecomponentfilesareinthefollowinglocation:
<release_name>/upgradeimage/imagecomponents
INDEX
CONTENTS
51
CUSTOMISING A SOFTWARE UPGRADE IMAGE
Alternatively,youcanaddanewfiletothislocationsuchasachnls.txt fileyouhavecopiedfrom apreconfiguredsettopboxoranupgrade.shfilethatcontainslibconfigcommandstosetNOR Flashvalues. 2. 3. Editthefile,andsaveyourchanges. Openthe flashcontents file,andensurethatthefileyouhaveadded/editedislistedthere.This fileisinthefollowinglocation:

<release_name>/upgradeimage
Theflashcontentsfileliststhefilesthatwillbeincludedinasoftwareupgradeimage,anddefines permissionsforthefiles. 4. Usethesignupgradeimagescripttocreatethesoftwareimage,asusual. Thenewsoftwareupgradeimageincludesyourneworeditedfiles,andyoucanuseittoupgradeyourset topboxes.
5.2
Editingtheflashcontentsfile
Youareonlyrecommendedtoedittheflashcontentsfileifyouareaddingnewfilestotheimage componentsusedtocreateasoftwareimage,andthefilesarenotcurrentlylistedinit.Itissuppliedinthe followinglocationinasoftwarerelease:

<release_name>/upgradeimage
5.2.1
flashcontentsfile
Theflashcontentsfileliststhefilesthatcanbeincludedinasoftwareupgradeimage,anddefinesthe permissionsassociatedwiththesefileswhenthesoftwareimageisinstalledonthesettopbox.
5.2.2
flashcontentsfilecontents
Thefilecontainsalistoffilenamesandthepermissionassociatedwiththem,inthefollowingformat:
<permission> <file name>
Forexample:
R AMINET.img
5.2.2.1 Permissions
Thepermissionsareasfollows: Permission
R
Filecannotbealteredbythesettopbox(e.g.kernel module,application).IffileswithRpermissionare alteredordeleted,thesettopboxdetectsanerrorand reboots. Filecanbealteredbythesettopbox(e.g.a configurationfile).Ifthesefilesaredeletedfromtheset topbox,itwillnotcauseanerror. Fileisreadonlyandcanbedeletedafteritisexecuted withoutaffectingsettopboxoperation(e.g. upgrade.shscript).
52
CONTENTS
INDEX
ExecutableimagecomponentfilesmustbelistedaseitherRorE,otherwisethesignupgradeimage scriptwillfailtocreatethesoftwareupgradeimage. Allfilesintheimagecomponents/ directorymustbelistedintheflashcontentsfile,otherwise,the signupgradeimage scriptwillfail.Ifafileislistedinthe flashcontentsfilebutisnotpresentin theimagecomponents/directory,itwillnotaffectthesignupgradeimage script.
5.2.3
Filenaming
Filesnamesmustnotbelongerthan12characters.Forfurtherinformationontheflashcontentsfile,see theAminoInstallationandUpgradeGuide.
5.3
Creatinganupgradescript
Anupgradescriptupgrade.shcontainscommandsthatthesettopboxexecuteswhenanewsoftware upgradeimageisinstalled.Thescriptiscreatedandinstalledonthesettopboxaspartofasoftwareimage, andisonlyexecutedonce,thendeleted.
5.3.1
Touseanupgradescript
Theupgrade.sh scriptisnotnormallysuppliedaspartofasoftwarerelease,butyoucancreateyourown andaddthecommandsyouwantthesettopboxtoexecute.Forexampleyoucanaddlibconfigcommands tosetstaticmulticastvalues.Addthefiletotheimagecomponentsusedtocreateasoftwareupgradeimage andensurethatthescriptislistedintheflashcontentsfile,withitspermissionsettoE. Thescriptisexecutedautomaticallywhenthissoftwareimageisinstalledonthesettopboxandisthen deleted.
5.4
Enablingremotelogintools
TelnetorSSH(Dropbear)canbeincludedinthesoftwareinstalledonasettopbox(thetoolavailabledepends ontheplatform),inordertoenableremoteloginforexample,toaccessconfigurationvialibconfig commands.
5.4.1
Remotelogintoolavailability
Theremotelogintools(Telnet/SSH(Dropbear))arenotincludedaspartofastandardsoftwarebuildor softwareimageforsecurityreasons.Ifyouwanttoenabletheseonthesettopbox,youcandosobyadding themtotheimagecomponentsusedtocreateanewsoftwareupgradeimage. ForthefollowingplatformsTelnetandSSH(Dropbear)areavailable: AmiNET103 AmiNET110 AmiNET110H AmiNET500
Formorerecentbuildsforotherplatforms(AmiNET125/130/130H/530)telnetisincludedbydefaultbutisnot startedonbootupbydefault. Toenablestartupofthetelnetdaemonatbootup,includeascriptinimagecomponentstostartit,for example,rc.ca_apporrc.dmn_app.
INDEX
CONTENTS
53
Forexample:
#!/bin/sh # # modules start / stop. . /etc/rc.config case "$1" in start) echo "Loading telnetd" telnetd & ;; stop) echo "Killing telnetd" kill -9 `pidof telnetd` ;; reload|restart) $0 stop && $0 start ;; *) echo "Usage: $0 {start|stop|reload|restart}" exit 1 esac
5.5
Customisinggraphics
Youcanreplacethegraphicdisplayedduringsettopboxbooting.ForTFTPbootingsettopboxes,itisalso possibletoreplacethegraphicshownduringsoftwareupgrades.
5.5.1
Graphicsusedbythesettopbox
Thefollowingdefaultgraphicsaresuppliedwithasoftwarerelease:
54
CONTENTS
INDEX
5.5.1.1 splash.gif
Thisisthedefaultgraphicshownonscreenwhenthesettopboxisbooting.
AndforOpera9builds
INDEX
CONTENTS
55
5.5.1.2 loading image (multicast)

MulticastupgradesshowsagraphicwithjustthewordLoading...atthisstage,whichispartofIntActOS(the Aminooperatingsystemusedonx3xseriesSTBsonly)ratherthanpartoftheimagecomponentssupplied withasoftwarerelease.
NOTE
TheloadinggraphicshownduringmulticastupgradesispartofIntActOS,and cannotbecustomised.The'Loading'imageisdisplayedfromIntActOSwhen theboxinitiallymulticastbootswithoutfirmware.
56
CONTENTS
INDEX
5.5.1.3 loading.gif (TFTP)

ThisisthegraphicshownonscreenwhenthesettopboxisupgradingviaTFTP.
.
AndforOpera9builds
TheUpgrading, do not unplug.screenisshowninmulticastandTFTPupgrades,onceithasdownloadedan imagefromtheserver(TFTPormulticast).
5.5.2
Toreplacethedefaultgraphicswithyourown
YoucanreplacethedefaultgraphicswithyourownbyreplacingtheGIFfilesintheimagecomponentsused tobuildanewsoftwareupgradeimage,thenupgradingthesoftwareonasettopboxtousethisnewsoftware image.
INDEX
CONTENTS
57
EachgraphicmustbeaGIFwiththesamenameasthefileyouarereplacing.Otherrecommendationsare: AnimatedGIFsarenotsupported(usingananimatedGIFwillpreventthesettopboxfrombooting) GIFsmustbelessthan640x400pixels.IftheGIFislargerthanthescreendimensions,itwillnotbe displayed. TransparentGIFsarenotsupported,butifyousetthetransparentcolourto0,thebackgroundcolourwill beundefined. GIFimageswithprofiledataarenotsupported.ProfilescanbestrippedusingtoolssuchasGraphics Magick(http://www.graphicsmagick.org/)andthecommandgm convert +profile "*" in.gif
out.gif
NOTE
Thegraphicisalwayscentredonthescreenwhenitisdisplayed.
58
CONTENTS
INDEX
Chapter6Settopboxconfigurationpagesfor FrescoandOpera8.5
ThischapterdescribeshowtousetheAminosettopboxconfigurationpages,whichprovidecustomisation optionsforbothadministratorsandendusers.
6.1
Aboutthesettopboxconfigurationpages.
SettopboxeswithbrowsersalwaysincludeHTMLconfigurationpages,displayedonthetelevisionscreen, enablinglocalaccessandeditingofconfigurationareas. Thepagesaredividedintoauserarea(Preferencespages)
Figure 6.1 Typical Fresco/Opera 8.5 Preferences page
INDEX
CONTENTS
59
SET-TOP BOX CONFIGURATION PAGES FOR FRESCO AND OPERA 8.5
andanadministratorarea(Managementpages).
Figure 6.2 Typical Fresco/Opera 8.5 Management page
6.1.1
1.
Changingtheconfigurationsettings
Accesstheconfigurationpages TheuserpressesacombinationofkeysontheIRkeyboardtoaccesstherequiredpages(orviathe IRremotecontrol,forthePreferencespages).Theyarerequiredtoenterapasswordbeforetheycan accesstheManagementpages.
Anormalsequenceforchangingconfigurationviathesettopboxconfigurationpagesisasfollows:
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallation and Upgrade Guideforinformation onchangingthesedefaultpasswords. 2. 3. Displaythepage Theusernavigatestothepagethatcontainsthesettingstheywishtochange. Editthesetting Settingsaredisplayedaseithertextfieldsorcheckboxes,whichcanbeeditedviatheIRkeyboardor IRremotecontrol. 4. Saveandverifythechange Theuserclicksonasavebuttononthescreen.ForchangesviatheManagementpages,anotherpass wordisrequiredtoconfirmthechange. 5. Writethechanges Thesettopboxexecutesthecommand.Inmostcases,thisinvolvescallingthelibconfigcom mandthateditstherequiredsettingintherelevantconfigurationarea(forexample,NORFlashor settingsfile).
60
CONTENTS
INDEX
6.2
Gettingstarted
Theinstructionsinthissectionassumethatthesettopboxyouwanttocommunicatewithispoweredand connectedtothenetwork. TousethePreferencespages,youwillneedthefollowing: AnIRremotecontrolorIRkeyboard AnAminoIRkeyboard(optionallyalsoanIRremotecontrol) Youwillneedtoknowthepasswordforthemngreadandmngwriteusernamesonthesettopbox. Theseareleavesandsnakerespectivelyifyouhavenotchangedthedefaults. Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallation and Upgrade Guideforinformation onchangingthesedefaultpasswords. TousetheManagementpages,youwillneedthefollowing:
6.2.1
Keyboardandremoteoperationoftheconfigurationpages
Althoughtheactualfunctionalityenabledisslightlydifferent,thegeneralwaysofcommunicatingwiththe ManagementandPreferencespagesaresimilar,andthetablebelowshowssomeoftheremotecontrol buttonsandkeyboardkeysthatenableimportantfunctionality: Functionality Movearoundtheitemsonthe page. Remotecontrol Arrowbuttons Keyboard Arrowkeys. Enterkey. BackSpacekey.
Selectanoption/pressabuttonon OKbutton thepage. Deletetextyouhaveentered. LASTCHbutton (greyremote control)orP<P button(black remotecontrol) MENUbutton
DisplayPreferencespages DisplayManagementpages
AltPkeycombination, orSettingsbutton. AltMkeycombination.
Ingeneral,theManagementpagesrequiretheuseofakeyboard.ThePreferencespagesaredesignedforuse withtheremotecontrol.
INDEX
CONTENTS
61
6.3
Preferencespages
ThesettopboxPreferencespagesareasimpleinterfacethatenablesuserstochangebasicsettopbox configurationareassuchasvideo,subtitleandkeyboardsetup.ThepagesareaccessedlocallyviaanIR remotecontrol(orkeyboard).ThePreferencespagesaredesignedforusebyendusers.
Figure 6.3 Fresco/Opera 8.5 Preferences page for subtitles builds.
Figure 6.4 Fresco/Opera 8.5 Preferences page for closed caption builds
62
CONTENTS
INDEX
Figure 6.5 Fresco/Opera 8.5 preferences page for PVR set-top boxes
6.3.1
UsingthePreferencespages
ThePreferencespagesaredividedintoseveralareas.Whenyoufirstaccessthepages,amenuthatliststhe availableareasisdisplayed.Theactualsettingsavailabledependonthesoftwarebuild,butthemenucan includethefollowingitems: Area

Keyboard settings Audio Settings Video settings Subtitle settings Exit preferences
Allowsyouto: Viewandeditkeyboardconfiguration. Viewandeditaudiosetup. ViewandeditTVandvideosetup. Changesthewaysubtitlesaredisplayed. Closethepreferencespages
6.3.2
Navigationusingtheremotecontrol
OncethePreferencepagesareopen,youmayuseeitherthekeyboardorremotecontroltonavigatearound thepagesandchangesettings.ThePreferencespagesaredesignedtobeusedwiththeAminoandRuwido remotecontrols.Itisalsopossibletouseequivalentkeyboardoptions. Usethearrowbuttonstomoveupordownthemenupage,thenpresstheOKbuttontoselectthepage youwanttoview. Oncethepageyouwantisdisplayed,youcanusethearrowbuttonstomovearoundit,makechangesif requiredandthenmovetotheBack to Main MenubuttonandpressOKtoreturntothemenu.
6.3.3
Viewingandeditingthesettings
ThefollowingsectiongivesabriefsummaryofhowtousethePreferencespagestochangeconfiguration settings.
INDEX
CONTENTS
63
6.3.3.1 To view the configuration

1. 2. Openthepagefortheconfigurationareayouwanttoview.Thecurrentconfigurationsettingsare displayed. Toreturntothemenupage,movetothePreferencespageandpressOK.
6.3.3.2 To change the configuration settings

1. 2. 3. Openthepagefortheconfigurationareayouwanttoview. Usethearrowbuttonstomovetothesettingyouwanttochange.Asyoumovearoundthepage,the settingthatyouhavecurrentlyselectedishighlighted. Makethechangesyourequire: 4. Tochangeatextfield,usetheLAST CH/P<Pbuttontodeletethecurrentvalue,thentypethe newvalue. Tochangeacheckbox,presstheOKbuttontocheckoruncheckthebox. Toselectvaluesfromadropdownlist,presstheOKbuttontodisplaythechoices,usetheupand downarrowbuttonstomovetothevaluewant,thenpressOKagaintoselectthenewvalue.
Whenyouarehappywithyourchanges,movetotheSave Changesbutton,andpressOK.There willbeashortdelaywhilethechangesarewrittentothesettopboxsconfiguration(thesettop boxsLEDwillflashduringthistime).Alternatively,youcanusetheReset buttontoundoyour changestothepageandreturntothevaluessetwhenyoudisplayedthepage. Ifyousavedyourchanges,anewpageconfirmsthechanges.Ifyoudidnotmakeanychanges,the pagedoesnotchange.Frombothpages,youcanreturntothemainmenubymovingtotheBack to Main MenubuttonandpressingOK.
5.
6.3.3.3 Closing the Preferences pages

Whenyouhavefinished,navigatetothemainmenu,thenmovetotheExit preferences optionandpressOK.
64
CONTENTS
INDEX
6.4
Preferencespagesconfigurationareas
ThelistofconfigurationareasandsettingsthatyoucanreadandeditfromthePreferencespagesdependson thedetailsofthesoftwarebuild.Thesectionsthatfollowdetailthemainsettingsavailable.Eachsection relatestoapageaccessiblefromthemainmenu.Forgeneralinformationonchangingconfigurationviathe Managementpages,see"Viewingandeditingconfiguration"onpage73.
6.4.1
KeyboardSettings
Thispageenablesyoutoviewandeditkeyboardconfiguration.
Figure 6.6 Fresco/Opera 8.5 Keyboard Settings Preferences page
Thefollowingsettingsareavailable:
Keyboard Repeat delay (1-4) ThelengthoftimethatauserholdsakeydownonanIRinputdeviceforexample,theIR keyboard)inordertomakeitrepeat.SeealsoDELAY_FACTOR.:
Value 1 2 3 4
Description 16csdelayrate. 32csdelayrate. 64csdelayrate. 96csdelayrate.
Repeat rate (0,2-30 cs) ControlsthenumberofcharacterspersecondforIRinputdevices(forexample,theIRkey board).Setanevennumbervalueintherange230(rateincentiseconds),orset0forno repeat.SeealsoREPEAT_RATE. Remote control text entry Enablesordisablesremotetextentryviatheremotecontrol.Iftextentryisenabled,theuser enterstextbyholdingdowntheappropriatenumberkey.SeealsoTEXT_ENTRY.
INDEX
CONTENTS
65
TheRepeatratemustbesetto0(zero)andremotetextentrymustbeenabledforremote textentrytowork.
6.4.2
AudioSettings
Thispageenablesyoutoviewandeditaudiosetup.
Figure 6.7 Typical Fresco/Opera 8.5 Audio Preferences page
Minimum Volume (0-100) Setstheminimumsettopboxvolume.Thismustbelessthanthemaximumvolume,andin therange0100(percent).SeealsoMINIMUM_VOLUME. Maximum Volume (0-100) Setsthemaximumsettopboxvolume.Thismustbegreaterthantheminimumvolume,and intherange0100(percent).SeealsoMAXIMUM_VOLUME. Primary language Secondary language Setstheprimarylanguageforanaudiostream,forexample,English.Seealso
PREFERRED_LANG.
Setsthesecondarylanguageforanaudiostream.IftheSTBcanfindnoaudiostreaminthe Primarylanguage,itselectsanaudiostreaminthechosensecondarylanguage,forexample, Spanish.SeealsoSECONDARY_LANG.
HDMI-PCM audio only WhenDolbyDigitalaudioisbeingdecoded,thedecoded2channelPCMdataisembedded intheHDMIsignal,ratherthantheDolbyDigitaldata.SeealsoHDMI_AUDIO_FORMAT.
66
CONTENTS
INDEX
6.4.3
VideoSettings
ThispageenablesyoutoviewandeditTVandvideosetup.
Figure 6.8 Fresco/Opera 8.5 Video Settings Preferences page
Output Resolution Selectstheoutputresolution,whichshouldbeoneofthefollowingoptions: Standard Definition(notavailableontheA130M) 576p 720p 1080i SeealsoOUTPUT_RESOLUTION. Native Pass-Through Enable Ifthisisselectednativestandarddefinitionisdisplayedasnativestandarddefinitionona highdefinitiondisplay.SeeNATIVE_PASSTHRU_ENABLE. TV aspect ratio
NOTE
SetshowvideoisformattedfortheTV.SeeasloDISPLAY_MODE.
Theboxmustberebootedinorderforthechangestotakeeffect.
Thefollowingoptionsareavailable:
Value Standard4:3(centrecutout)
Description Fortelevisionswithnoautomaticaspectratioswitching, wherethevideoimageisrequiredtofillthefull4:3 screen.Inthismode,4:3contentfitsthescreencorrectly, andany16:9videocontentiscroppedontheleftand rightsides.
INDEX
CONTENTS
67
Value Standard4:3(letterbox)
Description Fortelevisionswithnoautomaticaspectratioswitching, wherethefull16:9screenisrequired.Inthismode,4:3 contentfitsthescreencorrectly,andany16:9contentis displayedinfull,withblackbarsaboveandbelow. Fortelevisionswithautomaticratioswitching.Inthis mode,thetelevisionswitchesbetween4:3and16:9 dependingonthevideocontent,andfullcontentisdis playedforboth.

Setstheoutputformatofthesettopbox.SeealsoTVSYSTEM. ThefollowingtableshowswhichvideooutputformatchoicestheManagementandPrefer encespagesofferforeachofthetypesofsettopbox(ontheVideo SetuppageoftheMan agementpages,andontheTVsystemandaudiosettingspageofthePreferencespages):
Widescreen16:9
Video output format
Settopboxtype AmiNET103 AmiNET110 AmiNET110H
Outpufformatchoicesoffered COMPOSITE COMPOSITE SVIDEO COMPOSITE+RGB COMPOSITE+SVIDEO COMPOSITE+YPbPr RF COMPOSITE COMPOSITE+RGB COMPOSITE+SVIDEO COMPOSITE+YPbPr RF HDMI(SD)+COMPOSITE+RGB HDMI(SD)+COMPOSITE+SVIDEO HDMI(SD)+COMPOSITE+YPbPr RF(130only) HDMI(SD) COMPOSITE+SVIDEO+YPbPr COMPOSITE+SVIDEO+RGB HDMI(SD)+COMPOSITE+RGB HDMI(SD)+COMPOSITE+SVIDEO RF HDMI(SD)+COMPOSITE+SVIDEO HDMI(SD)+COMPOSITE+YPbPr RF
AmiNET125
AmiNET130 AmiNET130H
AmiNET130M AmiNET500 AmiNET530(EU)
AmiNET530(US)
68
CONTENTS
INDEX
Frequency table
SetstheRFoutputfrequencytable(forplatformswithRFoutput).Theoptionsareasfollows:
Value BROADCAST CABLE
Description broadcast cable

SeealsoRFMOD_FREQTABLE.
RF Channel Use RF Output
SetstheRFchannel(forplatformswithRFoutput).SeealsoRFMOD_CHAN. EnablesordisablestheRFoutput(forplatformswithRFoutput).Seealso
RFMOD_ENABLE.
6.4.4
Subtitles
Thispageenablesyoutoviewandeditsubtitleconfiguration(onlyavailableonbuildswithDVBsubtitling support).
Figure 6.9 Fresco/Opera 8.5 Subtitle Settings Preferences page
Subtitles Thecheckboxenablesordisablessubtitledisplay.SeealsoSUBTITLES.
Primary subtitle language Setstheprimarylanguageforthedefaultsubtitledisplay.Forexample,English.Seealso SUBTITLES_PREF_LANG. Secondary subtitle language Setsthesecondarylanguageforthedefaultsubtitledisplay.Ifthesettopboxcanfindno subtitleinformationinthePrimarylanguageitusestheinformationintheSecondarysubtitle language,forexample,Spanish.SeealsoSUBTITLES_SECOND_LANG.
INDEX
CONTENTS
69
6.4.5
Closedcaptions
Thispageenablesyoutoviewandedittheclosedcaptionconfiguration.
Figure 6.10 Fresco/Opera 8.5 Subtitle Settings Preferences page
Closed Captions Method Thecheckboxenablesordisablesclosedcaptiondisplay.Seealso
CC_OUTPUT_SOFTCC.
SelectTVtoenableinsertionofcaptionsintheVBIofStandarddefinitionanalogueoutputs. SeealsoCC_OUTPUT_VBIandCC_OUTPUT_SOFTCC. SelectSTBtoenablesoftwarerenderingofcaptionsbythesettopbox.
70
CONTENTS
INDEX
6.4.6
.
PVRPreferencespage
ForAmiNETmodelswithaPVR,thispageenablesyoutoreinitialisetheharddrive
Figure 6.11 Fresco/Opera 8.5 PVR Settings Preferences page
Harddrive ThesingleReinitializeoptionwillcompletelyreformattheharddriveofthePVR.Alldatawill bedeleted.Thefollowingwarningwillbedisplayed: Thisoperationwillreinitializetheharddriveandallcontentwillbelost.Proceedingwiththis operationwillreboottheSTBandanycurrentoperationswillbeterminated. Areyousureyouwanttocontinue?
6.5
Managementpages
ThesettopboxManagementpagesareasimpleinterfacethatenablesadministratorstochangesettopbox configurationareassuchasnetworking,channellistandbrowsersetup,aswellasinitiatebasicoperations suchasrebootingandupdatingsoftware.Inaddition,readonlyaccessisavailabletoareassuchasversion andsettopboxidentitysettings.ThepagesarepasswordprotectedandaccessedlocallyviaanAminoIR keyboard(limitedfunctionalityisalsosupportedviatheremotecontrol).
INDEX
CONTENTS
71
UseAlt-M onthekeyboardtoaccesstheManagementpages.Youwillberequiredtoenterthemanagement password.Managementpagesallowaccesstoadvancedconfigurationfunctionsandaredesignedforuseby administratorsratherthanendusers.
Figure 6.12 Fresco/Opera 8.5 Management page
Whenyoufirstaccessthepages,amenuthatliststheavailableareasisdisplayed.Thesettingsavailable dependonthesoftwarebuild,butthemenucanincludethefollowingitems: Area BrowserSetup Channels ProxySetup TrustedDomains

Video Setup
Allowsyouto: Viewandeditbrowserconfigurationand changekeyboardlayout. ViewandeditthechannelURLs. ViewandeditHTTPandHTTPSproxies. Viewandeditsettingsfortrusteddomains. Viewandeditvideodisplayandtimeout settings. Viewandeditstaticaddressinformation. ViewandeditDHCPsettings. Viewsettopboxhardwaredetails. Viewsettopboxsoftwareversion. Initiateasoftwareupgrade(multicast)or reflash. Viewsettopboxidentityinformation. PairthesettopboxwithanIRremotecontrol. SeeAppendixI,PairinganIRremotecontrol withasettopboxforfurtherdetails.
NetworkConfiguration
DCHP Information
HardwareInformation SoftwareVersion UpdateSoftware

Identity
InfraRedConfiguration
72
CONTENTS
INDEX
Area TVIConfiguration
Allowsyouto: OnlypresentonHospitality(H)settopboxes. Setstheprotocoltouseforcontrollingthe television. Rebootthesettopbox.
Reboot
6.5.1
Navigationusingthekeyboard
OncetheManagementpagesaredisplayed,youcanuseeitherthekeyboardorremotecontroltonavigate aroundthepagesandchangesettings.However,theManagementpagesrequiretheuseofakeyboardto displaythemandentertext,sotheusageinstructionshereallspecifywhatkeystopressonthekeyboard.It isalsopossibletouseequivalentremotecontroloptionsinmanycases. Usethearrowkeystomoveupordownthemenupage,thenpresstheEnterkeytoselectthepageyou wanttoview. Oncethepageyouwantisdisplayed,youcanusethearrowkeystomovearoundit,makechangesif requiredandthenmovetotheBack to Main MenubuttonandpressEntertoreturntothemenu.
6.5.2
ClosingtheManagementpages
Whenyouhavefinished,selectExit ManagementtoclosetheManagementpagesandreturntothemain televisiondisplay.
6.5.3
Viewingandeditingconfiguration
ThefollowingsectiondescribeshowtovieworedittheconfigurationusingtheManagementpages.
6.5.3.1 Viewing
1. 2. Openthepagefortheconfigurationareayouwanttoview.Thecurrentconfigurationsettingsare displayed. Toreturntothemenupage,movetotheBack to Main Menubutton(usuallyatthebottomofthe page)andpressEnter.
6.5.3.2 Editing
Notallconfigurationsettingscanbechanged.IfapagedoesnothaveaSave Changesbutton,thenthe settingsareallreadonly. 1. 2. 3. Openthepagefortheconfigurationareayouwanttoview. Usethearrowkeystomovetothesettingyouwanttochange.Asyoumovearoundthepage,the currentsettingthatyouhavecurrentlyselectedishighlighted. Makethechangesyourequire: Tochangeatextfield,usetheBack Space keytodeletethecurrentvalue,thentypethenew value. Tochangeacheckbox,presstheEnterkeytocheckoruncheckthebox. Toselectvaluesfromadropdownlist,presstheEnterkeytodisplaythechoices,usetheupand downarrowkeystomovetothevaluewant,thenpressEnteragaintoselectthenewvalue.
INDEX
CONTENTS
73
4.
Whenyouarehappywithyourchanges,movetothePasswordfieldandtypethepassword.Ifyou havenotchangedthedefaultpassword,thisissnake.Next,movetotheSave Changesbutton,and pressEnter.Therewillbeashortdelaywhilethechangesarewrittentothesettopboxsconfigura tion(thesettopboxsLEDwillflashduringthistime).Alternatively,youcanusetheResetbuttonto undoyourchangestothepageandreturntothevaluessetwhenyoudisplayedthepage. Ifyousavedyourchanges,anewpageconfirmsthechanges.Ifyoudidnotmakeanychanges,the pagedoesnotchange.Frombothpages,youcanreturntothemainmenubynavigatingtotheBack to Main MenubuttonandpressingEnter.
5.
Formanyconfigurationsettings,youwillnowneedtorebootthesettopboxforthechangestotakeeffect.
6.5.4
1. 2.
Rebootingthesettopboxviathemanagementpages
Onthemainmenu,movetotheRebootoption,thenpresstheEnter button. Thesettopboxrebootsimmediately.
6.6
Managementpagesconfigurationareas
ThelistofconfigurationareasandsettingsthatyoucanreadandeditfromtheManagementpagesdepends onthedetailsofthesoftwarebuild.Thesectionsthatfollowdescribethemainsettingsavailable.Eachsection relatestoapageaccessiblefromthemainmenu.Forgeneralinformationonchangingconfigurationviathe Managementpages,see"Viewingandeditingthesettings"onpage63.Forinformationontheareasthatare notrelatedtoconfiguration,see"Rebootingthesettopboxviathemanagementpages"onpage74and "Updatesoftware"onpage87.

NOTE
Thepageviewwilldifferdependingonthestandardbrowserinuse,as below.
6.6.1
:
BrowserSetup
Thispageenablesyoutoviewandeditbrowserconfiguration.
Figure 6.13 Fresco/Opera 8.5 Browser Setup for the Opera Browser
74
CONTENTS
INDEX
Figure 6.14 Fresco/Opera 8.5 Browser Setup for the Fresco Browser
Home page Setsthehomepage.ThisistheURLforthepagethatthebrowsergoestowhentheHome keyispressedandwhenthesettopboxhasbootedsuccessfully.TheURLenteredmustbe intheformathttp://<address>.SeealsoBROWSER_HOMEPAGE. Setsthehelppage.ThisistheURLforthepagethatthebrowsergoestowhentheHelpkey ispressed.TheURLenteredmustbeintheformathttp://<address>.Seealso BROWSER_HELPPAGE. EnablesordisablestheuseofHTTP,HTTPSandFTPproxyservers.SeealsoUSE_PROXY. Enablesordisablescookies.Enablethistoallowcookiestobeaccepted(cookiescanonlybe acceptedwherethisissupportedbythebrowser).Seealso BROWSER_ENABLECOOKIES. Setstheamountofcachedwebcontentdatathatcanbeheldontheharddisk. Setstheamountofcachedwebcontentdatathatcanbeheldinmemory. SetsthelayoutfortheIRkeyboard.SeealsoKEYMAP.
Help page
Use Proxy Accept Cookies
Disk cache (Kbytes): RAM Cache (Kbytes): Keyboard Layout
INDEX
CONTENTS
75
6.6.2
Channel
Thispageenablesyoutoviewandeditthechannelslist.
Figure 6.15 Fresco/Opera 8.5 Channel setup Management page
Thefollowingsettingsareavailable
Channels 0-999 Youcansetupto1000channels,withthenumbers0999.Clickonarangetoview/editthe channelswiththosenumbers.Foreachchannel,youwillneedtoenteraURLintheformat appropriateforthevideoserver.
76
CONTENTS
INDEX
6.6.3
ProxySetup
TheProxy SetuppageenablesyoutoviewandeditconfigurationofHTTP,HTTPSandFTPproxies.
Figure 6.16 Fresco/Opera 8.5 Proxy setup Management page
HTTP Proxy TheIPaddressandportfortheproxyserverforHTTPtransactions.Entertheseintheformat <host>:<port>. Forexample:234.56.78.9:1234 SeealsoHTTP_PROXY. Secure Proxy TheIPaddressandportfortheproxyserverforHTTPStransactions.Entertheseinthefor mat<host>:<port>. Forexample:234.56.78.9:1234 SeealsoHTTPS_PROXY. FTP Proxy TheIPaddressandportfortheproxyFTPserver.Entertheseintheformat <host>:<port>. Forexample:234.56.78.9:1234 Dont use proxy for the following: ListofURLsforsitesthatproxyshouldnotbeusedfor.SeparateURLswithacomma.See alsoHTTP_PROXY_IGNORE.
INDEX
CONTENTS
77
6.6.4
TrustedDomains
TheTrusted Domainspageenablesyoutovieworeditsettingsfortrusteddomains.
Figure 6.17 Fresco/Opera 8.5 Trusted Domains Management page
Enable Trusted Domains Enableordisableuseoftrusteddomains.Iftheuseoftrusteddomainsisenabled,pagesthat useJMACXextensionsorMacrovisionarecheckedagainstthelistoftrustedhosts.Iftrusted domainsisdisabled,JMACXandMacrovisioncallscanbeexecutedfromanywebpage.You canspecifymultipletrusteddomains,foreachtrusteddomain,youwillneedtosetavalue forthedomainandindicatewhetherJMACXand/orMacrovisioncontrolisallowedforthat domain.SeealsoENABLE_TRUSTED_DOMAINS. Trusted Domains Macrovision JavaScript SettheURLforatrusteddomain.Thiscanuseanasteriskasawildcard. EnablesordisablesexecutionofMacrovisioncallsforthetrusteddomaindefinedbytheas sociatedURL. EnablesordisablesexecutionofJavaScriptcallsforthetrusteddomaindefinedbytheasso ciatedURL.
Important: Therulesspecifiedinthetrsdmns.txt fileareappliedintheordertheyarestated,soyouneed totakecarewhenaddingdomainstoensurethattherulesareappliedasintended.
Forexample,inthefollowingfile,3 specifiesthatMacrovisionandJMACXareenabledforthe macrovision.aminocom.comdomains,and2specifiesthatonlyJMACXisenabledforanyother aminocom.comdomain:

3 macrovision.aminocom.com 2 *.aminocom.com
78
CONTENTS
INDEX
InthefollowingalternativeexamplewiththesamesettingsreorderedonlyJMACXisenabledforany aminocom.comdomain,andsoMacrovisionisnotenabledformacrovision and aminocom.com,even though3wouldnormallyenableMacrovisionsinceMacrovisionforthisdomainhasalreadybeenruledout inthepreviousline:

2 *.aminocom.com 3 macrovision.aminocom.com
6.6.5
VideoSetup
TheVideo Setuppageenablesyoutoviewandeditvideodisplayandtimeoutsettings.
Figure 6.18 Fresco/Opera 8.5 Video Setup Management page
Default Video Server Setsthedefaultvideoservertype.Theavailableoptionsare: BitBand Concurrent EONA InfoValue Kasenna MediaBase nCube Oracle SeaChange SeealsoRTSP_SERVER.
INDEX
CONTENTS
79
TV Standard
SetstheTVstandard.SeealsoTVSYSTEM.Dependingonthesettopboxtype,theavaila bleoptionsareasfollows:
Value PALI PALM PALN PALG PALB PALH PALD NTSCJ NTSCM
Exampleregion UK Brazil Argentina Europe Australia,Ghana Belgium China(NotethatthisisnotsupportedontheAmiNET103or AmiNET109platforms.) Japan USA
AcompletelistoftheWorldwideTVStandardscanbefoundintheAmino TV Standards Guide. Video Trick-play Scale Thedefaultfastforwardandrewindmultiplier.SeealsoRTSP_SCALE. No RTSP event timeout NumberofsecondstowaitforRTSPdataaftersendinganRTSPplaycommand,beforeano videoeventisraised.Thismustbeintherange030,where0meansthattherewillnever beatimeoutraised.SeealsoRTSP_START_TIMEOUT. RTSP End of media event timeout NumberofsecondstowaitwhennomoreRTSPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoRTSP_END_TIMEOUT. No IGMP event timeout NumberofsecondstowaitforvideodatatoarriveafteranIGMPjoincommand,beforea novideoeventisraised.Thismustbeintherange030,where0meansthattherewillnever beatimeoutraised.SeealsoIGMP_START_TIMEOUT. IGMP End of media event timeout NumberofsecondstowaitwhennomoreIGMPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoIGMP_START_TIMEOUT. No UDP event timeout NumberofsecondstowaitaftertryingtoconnecttoaUDPmediastream,beforeanovideo eventisraised.Thismustbeintherange030,where0meansthattherewillneverbea timeoutraised.SeealsoUDP_START_TIMEOUT. UDP End of media event timeout NumberofsecondstowaitwhennomoreUDPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoUDP_END_TIMEOUT. Full screen mode Left Margin Enablesordisablesfullscreenmode.SeealsoFULLSCREEN. Setstheleftbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_LEFT.
80
CONTENTS
INDEX
Right Margin
Setstherightbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_RIGHT. Setsthetopbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_TOP. Setsthebottombrowsermargin,asapercentageofthegraphicsplanesize(thatis,inthe range0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_BOTTOM.
Top Margin
Bottom Margin
6.6.6
NetworkConfiguration
TheNetwork Configurationpageenablesyoutomodifythenetworkconfigurationsettings.
Figure 6.19 Fresco/Opera 8.5 Network Configuration Management page
INDEX
CONTENTS
81
Ethernet Link Setsthedefaultspeedforthemainethernetporttooneofthefollowingvalues: Auto detect(thisisthedefault) 10Mbit/s Half Duplex 10Mbit/s Full Duplex 100Mbit/s Half Duplex 100Mbit/s Full Duplex Note:10BaseTEthernetisnotsupportedbyx4xseriesSTBs. SeealsoETHERNET. DHCP Info AlinkexistsfromthisconfigurationsettingtotheDHCPInformationpagedisplayingdetails ofthecurrentDHCPinformationreceived.TheDCHPwindowdisplaysvaluesforthefollow ing: IP address Netmask Gateway Domain DNS Lease Time Renewal Time Rebind Time ThedropdownlistsetshowthesettopboxusesconfigurationinformationfromaDHCP server.Ifthesettopboxwillnotbegettingallitsnetworksettingsdynamicallyfromthe DHCPserver(Do not use DHCP),thenyouwillneedtoensurethattheappropriatestatic settingsarespecifiedonthispage(forexample,IPaddressandnetmask).SeealsoDHCP. Hostname IP Address Setsthehostnameforthesettopbox. SetsthestaticIPaddressforthesettopbox.Thisisonlyneededifthesettopboxdoesnot retrieveitsnetworksettingsfromaDHCPserver.Seealso IPADDR. Setsthenetmask.Thisisonlyneededifthesettopboxdoesnotretrieveitsnetworksettings fromaDHCPserver.SeealsoNETMASK. SetstheIPaddressforthegatewayforthesettopbox.Thisisonlyneededifthesettopbox doesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoGATEWAY. Setsthedomainforthesettopbox.Thisisonlyneededifthesettopboxdoesnotretrieve itsnetworksettingsfromaDHCPserver.SeealsoDOMAIN. SetstheIPaddressesforthedomainnameserversforthesettopbox.Thisisonlyneededif thesettopboxdoesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoDNS. TheDHCPleasetimeasreturnedbytheDHCPserver.SeealsoLEASETIME. TheDHCPrenewaltimeasreturnedbytheDHCPserver.SeealsoRENEWALTIME. TheDHCPrebindtimeasreturnedbytheDHCPserver.SeealsoREBINDTIME.
Netmask Gateway Domain DNS Lease time Renewal time Rebind time
82
CONTENTS
INDEX
Time Server
SetstheIPaddressfortheNTPserverthatthesettopboxconnectsto.Thisisonlyneeded ifthesettopboxdoesnotretrieveitstimesettingsfromaDHCPserver.Seealso TIME_SERVER. SetstheNTPclienttimeoutinseconds.SeealsoNTPCLIENT_TIMEOUT. Setsthetimezoneforthesettopbox(Posixtimezoneformats).Alistofthevaluesforthis canbefoundintheAminoInstallation and Upgrade Guide.Thisisonlyneedediftheset topboxdoesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoTIME_ZONE.
NTP Client Timeout Time Zone
Multicast Bootstrap Address SetsanIPaddressforconnectingtothemulticastserverinmboot(multicastbootstrap) state. Thisisusedinthefollowingsituations: AsafallbackbootstrapgroupwhenthegroupandportspecifiedbytheDHCPservercannot befound. FordeploymentswherebootinginformationisnotheldonaDHCPserver(thesettopbox willalwaystrytouseavalueservedfromaDHCPserverinpreferencetothisstaticallyde finedvalue). Youwillalsoneedtospecifyamulticastbootstrapport.SeealsoMULTICAST_ BOOTSTRAP_GROUP. Multicast Bootstrap Port Setsaportforconnectingtothemulticastserverinmboot(multicastbootstrap)state. Thisisusedinthefollowingsituations: AsafallbackbootstrapgroupwhenthegroupandportspecifiedbytheDHCPservercannot befound. FordeploymentswherebootinginformationisnotheldonaDHCPserver(thesettopbox willalwaystrytouseavalueservedfromaDHCPserverinpreferencetothisstaticallyde finedvalue). Youwillalsoneedtospecifyamulticastbootstrapaddress.SeealsoMULTICAST_ BOOTSTRAP_PORT. Multicast Filesystem Address SetsanIPaddressforconnectingtothemulticastserverinfisys(multicastfilesystem) state. Thisisusedinthefollowingsituation: FordeploymentswherebootinginformationisnotheldonaDHCPserver(thesettopbox willalwaystrytouseavalueservedfromaDHCPserverinpreferencetothisstaticallyde finedvalue). YouwillalsoneedtospecifyamulticastFilesystemport.SeealsoMULTICAST_ FILESYSTEM_GROUP. Multicast Filesystem Port SetsanIPaddressforconnectingtothemulticastserverinfisys(multicastfilesystem) state. Thisisusedinthefollowingsituation:
INDEX
CONTENTS
83
FordeploymentswherebootinginformationisnotheldonaDHCPserver(thesettopbox willalwaystrytouseavalueservedfromaDHCPserverinpreferencetothisstaticallyde finedvalue). YouwillalsoneedtospecifyamulticastFilesystemport.SeealsoMULTICAST_
FILESYSTEM_PORT.
TFTP Server SetsthestaticIPaddresstouseforTFTPsoftwareupgrades.Thisisnotneededforsettop boxesthatusethemulticastupgradesystemoruseaBOOTPrequestforTFTPsoftwareup grades.SeealsoTFTP_SERVER. SetsthestaticnameofthedownloadscripttouseinTFTPupgrades.Thisallowsforastatic downloadscripttoberequestfordownloadingimagesfromaTFTPserver.Thesettopbox willtrytousethisvaluefirst,beforemakingaDHCPrequesttotrytoobtainthisinformation fromaDHCPserver.Thescriptnamemusthavenomorethan14characters. Thisisnotneededforsettopboxesthatusethemulticastupgradesystem.Seealso
TFTP Load File
TFTP_LOADFILE.
Packet Ordering PPP Username Enablesordisablespacketordering.Ifpacketorderingisenabled,thesettopboxbuffersout oforderpackets.SeealsoPACKET_ORDERING. Setstheusernametouse(PPPoEbuildsonly).Thismustbeastringwithamaximumof64 characters.SeealsoPPP_USERNAME. ForbuildswithPPPenabledonly. PPP Password Setsthepasswordtouse(PPPoEbuildsonly).Thismustbeastringwithamaximumof32 characters(exceptona103board,wherethemaximumis10characters).Seealso PPP_PASSWORD. ForbuildswithPPPenabledonly.
84
CONTENTS
INDEX
6.6.7
DHCPInformation
YoucanalsoreachthispagefromtheDCHP ConfigurationoptionoftheNetworkConfigurationpage. Settingssimilartothefollowingaredisplayed.Thesevaluescannotbechanged.
Figure 6.20 Fresco/Opera 8.5 DHCP Configuration Management page
6.6.8
HardwareInformation
Thispageenablesyoutoviewdetailsofthesettopboxhardware.
Figure 6.21 Fresco/Opera 8.5 Hardware Information Management page
Product Processor SDRAM TheAmiNETsettopboxtype. Theprocessortype. ThesizeoftheSDRAM.
INDEX
CONTENTS
85
Flash Processor Speed ROM Type Board Revision
Thesizeoftheflash. Theprocessorspeed. ThetypeofReadOnlymemory. Theboardrevisionnumber.
6.6.9
Softwareversion
TheSoftwareversionJavaScript Alertwindowenablesyoutoviewtheversionstringforthesoftwarebuild.
Figure 6.22 Fresco/Opera 8.5 STB Management page
86
CONTENTS
INDEX
6.6.10 Updatesoftware
TheUpdate Softwarewindowenablesyoutoinitiateasoftwareupgrade.
Figure 6.23 Fresco/Opera8.5 Update Software Management page
6.6.10.1 To initiate a software upgrade via the management pages

Beforeyouinitiateasoftwareupgrade,youwillneedtoensurethatnewsoftwareisavailable.Inmostcases, thismeansthatthemulticastsystemmustbesetup,withthemulticastservertransmittingappropriatenew softwareimages. 1. 2. Onthemainmenu,movetotheUpdate Softwareoption,thenpresstheEnter button.TheUpdate Softwarepageisdisplayed. Youcaneitherupgradejustthemainsoftwareimageoryoucanreflashthesettopbox(thatis,de letethecontentsoftheNANDflashandreloadbothanewbootstrapandanewsoftwareupgrade image).Whenthesettopboxperformsasoftwareupgrade,itteststhenewsoftwareandcanrevert totheoldsoftwareifthereisaproblem.Whentheboxreflashes,itwipesitscurrentsoftwarebefore installingnewsoftwaresoitmaynotbeabletoreverttotheoldsoftwareifthereisaproblem.
6.6.10.2 To upgrade the main set-top box image

1. 2. 3. 4. IntheAddress field,entertheIPaddressforthemulticastimage(thisistheIPaddressspecifiedin themulticastserverconfiguration). InthePort field,entertheportforaccessingthemulticastimage(again,asspecifiedinthemulticast serverconfiguration). InthePassword field,enterthepassword.Ifyouhavenotchangedthedefault,thisissnake. MovetotheCLICK HEREbuttonandpressEntertostarttheupgrade.
6.6.10.3 To reflash the set-top box

1. LeavetheAddressandPortfieldsblank.
INDEX
CONTENTS
87
2.
InthePassword field,enterthepassword.Ifyouhavenotchangedthedefault,thisissnake.
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallation and Upgrade Guideforinformation onchangingthesedefaultpasswords. 3. MovetotheCLICK HEREbuttonandpressEntertostarttheupgradeorreflash.
6.6.11 Identity
TheIdentitywindowenablesyoutoviewsettopboxidentityinformation.
Figure 6.24 Fresco/Opera 8.5 Identity Management page
MAC Address ThesettopboxMACaddress.This value is locked during manufacture. IfyouhaveadevelopmentsettopboxonwhichtheMACaddressisstilleditable,youmust notchangeitunlessyouarefullyawareoftheeffects.SeealsoMAC_ADDRESS. Serial Number Thesettopboxserialnumber. This value is locked during manufacture. Ifyouhaveadevelopmentsettopboxonwhichtheserialnumberisstilleditable,youmust notchangeitunlessyouarefullyawareoftheeffects.SeealsoSERIAL_ID.
88
CONTENTS
INDEX
6.6.12 InfraRedConfiguration
The IR Configurationpageenablesyoutopairthesettopboxwitharemotecontrol.
Figure 6.25 Fresco/Opera8.5 IR Configuration Management page
Thefollowingsettingisavailable:
IR brand code to listen to SetsthebrandcodeusedtopairthesettopboxwithaparticularAminoremotecontrol.The valuemustbeintherange000015(and100115fortheAmiNET125and130),andmust matchthecodeontheremotecontrolthatyouwanttousetowiththissettopbox.Seealso IR_BRAND. SeealsoAppendixI,PairinganIRremotecontrolwithasettopboxforadditional informationontheInfraredremotecontrol.
INDEX
CONTENTS
89
6.6.13 TVIConfiguration
TheTVI Configurationpageenablesyoutosettheprotocolforthesettopboxtouseforcontrollingthe television.
NOTE
ThisoptionisonlyavailableonHospitalityplatforms.
Figure 6.26 Fresco/Opera 8.5 TVI Configuration Management page
TVI protocol Setstheprotocoltouseforcontrollingthetelevision.Thesupportedoptionsare: Uninitialised Philips Zenith LG Panasonic/Sony Panasonic/SonyandZenithoptionsareavailableforoldermodelsoftelevision.Seealso
TVI_TYPE.
6.7
ConfigurationpagesettingsforFrescoandOpera8.5
ThemainsettingsneededtoconfigurethesettopboxcanbeaccessedviatheConfigurationpages.Which configurationareathesesettingsarereadfrom(thatis,configurationfileorNORFlash)dependsonthe softwarebuild.ThefollowingtableshowswhichareatheConfigurationpagesreadandwritesettingstofor theFrescoandOperabrowsers(thesettingisspecifiedwiththefilename(orNORFlash)onthefirstline andthesettingnameonthenextline). YoumayneedthisinformationifyouwanttotrialsettingsviatheConfigurationpagesandthencopythenew configurationtotheimagecomponentsusedtocreateanewsoftwareimage.
90
CONTENTS
INDEX
6.7.1
Preferencespages
Area
Keyboard settings page
Fresco settings DELAY_FACTOR settings REPEAT_RATE settings TEXT_ENTRY
Opera settings DELAY_FACTOR settings REPEAT_RATE settings TEXT_ENTRY
Repeatdelay Repeatrate Enableremotetextentry
TV system and audio settings page Audio settings page
MinimumVolume MaximumVolume Primarylanguage
settings MINIMUM_VOLUME settings MAXIMUM_VOLUME settings PREFERRED_LANG(or usersettingsfileifthe fileexists) settings SECONDARY_LANG(or usersettingsfileifthe fileexists) settings DISPLAY_MODE NORFlash TVSYSTEM NORFlash RFMOD_FREQTABLE
settings MINIMUM_VOLUME settings MAXIMUM_VOLUME usersettings PREFERRED_LANG/(in settingsfileinsteadin somebuilds) usersettings

SECOND_LANG/(in settingsfileinsteadin
Secondarylanguage
somebuilds) settings DISPLAY_MODE NORFlash TVSYSTEM NORFlash RFMOD_FREQTABLE NORFlash RFMOD_CHAN
Video settings page
TVaspectratio Videooutputformat Frequencytable
RFChannel/UseRFoutput NORFlash RFMOD_CHAN

Subtitles page
IfsettoNTSCoutput,youwillseethecaptionspageinstead. Enable(checkbox) Subtitleselection Primarysubtitlelanguage NORFlash SUBTITLES settings SUBTITLES_OPTION NORFlash SUBTITLES settings SUBTITLES_OPTION
settings settings SUBTITLES_PREF_LANG SUBTITLES_PREF_LANG (orusersettingsfileif thefileexists)
INDEX
CONTENTS
91
Area Secondarysubtitlelan guage
Fresco
Opera
settings settings SUBTITLES_SECOND_LA SUBTITLES_SECOND_LA NG(orusersettingsfileif NG thefileexists) Settings CC_OUTPUT_SOFTCC Settings CC_OUTPUT_SOFTCC if TV ischecked. CC_OUTPUT_SOFTCC if STB ischecked. Settings CC_OUTPUT_SOFTCC Settings CC_OUTPUT_VBI ifTV is checked. CC_OUTPUT_SOFTCC if STB ischecked.
Closed captions page
Closedcaptions(check box) Method(checkbox)
92
CONTENTS
INDEX
6.7.2
Area
Managementpages
Fresco
config.txt larch.document.default
Opera settings BROWSER_HOMEPAGE settings BROWSER_HELPPAGE settings USE_PROXY settings BROWSER_ENABLECOOKIE S notused notused
Browser Setup page
Homepage Helppage Useproxy AcceptCookies
settings
BROWSER_HELPPAGE config.txt access.proxy.http.on config.txt access.cookie.enable config.txt access.cache.size config.txt access.ramcache.size chnls.txt
DiskCache RAMCache
Channels page
0999
Proxy Setup page
chnls.txt
HTTPproxyhost/port Secureproxyhost/port FTPproxyhost/port
config.txt access.proxy.http config.txt access.proxy.https config.txt access.proxy.ftp
settings HTTP_PROXY settings HTTPS_PROXY notused settings HTTP_PROXY_IGNORE settings ENABLE_TRUSTED_DOMAI NS

trsdmns.txt (URLonlinen) trsdmns.txt
Dontuseproxyforthefollow config.txt ing: access.proxy.http.ignore

Trusted Domains page
Enabletrusteddomains
config.txt amino.trusted.domains trsdmns.txt (URLonlinen) trsdmns.txt n is1or3)
Domain nURL Domain nMacrovision
(Macrovisionenabledifvalueonline (Macrovisionenabledifvalue onlinen is1or3)

trsdmns.txt
Domain nJavaScript
trsdmns.txt
(JavaScriptenabledifvalueonlinen is2or3)
Video Setup page
(JavaScriptenabledifvalue onlinen is2or3) settings RTSP_SERVER
DefaultVideoServer
settings RTSP_SERVER
INDEX
CONTENTS
93
Area TVStandard OutputFormat VideoTrickplayScale NoRTSPeventtimeout RTSPEndofmediaevent timeout NoIGMPeventtimeout IGMPEndofmediaevent timeout NoUDPeventtimeout UDPEndofmediaevent timeout Fullscreenmode LeftMargin
Fresco NORFlash TVSYSTEM NORFlash OUTFMT settings RTSP_SCALE settings RTSP_START_TIMEOUT settings RTSP_END_TIMEOUT settings IGMP_START_TIMEOUT settings IGMP_START_TIMEOUT settings UDP_START_TIMEOUT settings UDP_END_TIMEOUT settings FULLSCREEN
config.txt fe_generic.display.margin.left config.txt fe_generic.display.margin.right config.txt fe_generic.display.margin.top config.txt fe_generic.display.margin.bottom
Opera NORFlash TVSYSTEM NORFlash OUTFMT settings RTSP_SCALE settings RTSP_START_TIMEOUT settings RTSP_END_TIMEOUT settings IGMP_START_TIMEOUT settings IGMP_START_TIMEOUT settings UDP_START_TIMEOUT settings UDP_END_TIMEOUT settings FULLSCREEN settings BROWSER_MARGIN_LEFT settings BROWSER_MARGIN_RIGHT settings BROWSER_MARGIN_TOP settings BROWSER_MARGIN_BOTTO M NORFlash ETHERNET NORFlash DHCP hostname
HOSTNAME(orinnetconf
RightMargin
TopMargin
BottomMargin
Network Configuration page
EthernetLink DHCPInfo Hostname
NORFlash ETHERNET NORFlash DHCP hostname

HOSTNAME(orinnetconffile,
dependingonbuild)
file,dependingonbuild)
94
CONTENTS
INDEX
Area IPAddress
Fresco NORFlash IPADDR(orinnetconffile, dependingonbuild) NORFlash GATEWAY(orinnetconffile, dependingonbuild) NORFlash NETMASK

netconf
Opera NORFlash IPADDR(orinnetconffile, dependingonbuild) NORFlash GATEWAY(orinnetconf file,dependingonbuild) NORFlash NETMASK

netconf
Gateway
Netmask Domain DNS Leasetime Renewaltime Rebindtime TimeServer NTPClienttimeout TimeZone MulticastBootstrapAddress
DOMAIN NORFlash DNS DHCPC LEASETIME DHCPC RENEWALTIME DHCPC REBINDTIME NORFlash TIME_SERVER settings NTPCLIENT_TIMEOUT
netconf
DOMAIN NORFlash DNS DHCPC LEASETIME DHCPC RENEWALTIME DHCPC REBINDTIME NORFlash TIME_SERVER notused
netconf
TIME_ZONE NORFlash MULTICAST_ BOOTSTRAP_GROUP
TIME_ZONE NORFlash MULTICAST_ BOOTSTRAP_GROUP
MulticastBootstrapPort
NORFlash NORFlash MULTICAST_ BOOTSTRAP_PORT MULTICAST_ BOOTSTRAP_PORT NORFlash MULTICAST_ FILESYSTEM_GROUP NORFlash MULTICAST_ FILESYSTEM_PORT NORFlash TFTP_SERVER NORFlash TFTP_LOADFILE NORFlash MULTICAST_ FILESYSTEM_GROUP NORFlash MULTICAST_ FILESYSTEM_PORT NORFlash TFTP_SERVER NORFlash TFTP_LOADFILE
MulticastFilesystemAddress
MulticastFilesystemPort
TFTPServer TFTPLoadFile
INDEX
CONTENTS
95
Area PacketOrdering PPPUsername PPPPassword

Hardware Information page
Fresco
netconf PACKET_ORDERING
Opera
netconf PACKET_ORDERING
NORFlash PPP_USERNAME NORFlash PPP_PASSWORD hardcoded hardcoded hardcoded hardcoded hardcoded hardcoded
/etc/version
NORFlash PPP_USERNAME NORFlash PPP_PASSWORD hardcoded hardcoded hardcoded hardcoded hardcoded hardcoded
/etc/version
Product Processor SDRam Flash ProcessorSpeed BoardRevision

Software version page
Version
Update Software page
Address Port
Identity page
MACAddress SerialNumber
Infra-Red Configuration
NORFlash MAC_ADDRESS NORFlash SERIAL_ID settings IR_BRAND settings TVI_TYPE
NORFlash MAC_ADDRESS NORFlash SERIAL_ID settings IR_BRAND settings TVI_TYPE
IRbrandcode
TVI Configuration
TVIprotocol
96
CONTENTS
INDEX
Chapter7Settopboxconfigurationpagesfor Opera9
ThischapterdescribeshowtousetheAminosettopboxconfigurationpagesforOpera9builds,which providecustomisationoptionsforbothadministratorsandendusers.
7.1
Aboutthesettopboxconfigurationpages.
SettopboxeswithbrowsersalwaysincludeHTMLconfigurationpages,displayedonthetelevisionscreen, enablinglocalaccessandeditingofconfigurationareas. Thepagesaredividedintoauserarea(Preferencespages)
Figure 7.27 Typical Opera 9 Preferences page
INDEX
CONTENTS
97
SET-TOP BOX CONFIGURATION PAGES FOR OPERA 9
andanadministratorarea(Managementpages).
Figure 7.28 Typical Opera 9 Management page
7.1.1
1.
Changingtheconfigurationsettings
Accesstheconfigurationpages Theuserpressesacombinationofkeysonthekeyboardtoaccesstherequiredpages(orviathere motecontrol,forthePreferencespages).Theyarerequiredtoenterapasswordbeforetheycanac cesstheManagementpages.
Anormalsequenceforchangingconfigurationviathesettopboxconfigurationpagesisasfollows:
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallationandUpgradeGuideforinformation onchangingthesedefaultpasswords. 2. 3. Displaythepage Theusernavigatestothepagethatcontainsthesettingstheywishtochange. Editthesetting Settingsaredisplayedaseithertextfieldsorcheckboxes,whichcanbeeditedviathekeyboardor remotecontrol. 4. Saveandverifythechange Theuserclicksonasavebuttononthescreen.ForchangesviatheManagementpages,asecondpass wordisrequiredtoconfirmthechange. 5. Writethechanges Thesettopboxexecutesthecommand.Inmostcases,thisinvolvescallingthelibconfigcom mandthateditstherequiredsettingintherelevantconfigurationarea(forexample,NORFlashor settingsfile).
98
CONTENTS
INDEX
7.2
Gettingstarted
Theinstructionsinthissectionassumethatthesettopboxyouwanttocommunicatewithispoweredand connectedtothenetwork. TousethePreferencespages,youwillneedthefollowing: AnIRremotecontrolorIRkeyboard AnAminoIRkeyboard(optionallyalsoaremotecontrol) Youwillneedtoknowthepasswordforthemngreadandmngwriteusernamesonthesettop box.Theseareleavesandsnakerespectivelyifyouhavenotchangedthedefaults. TousetheManagementpages,youwillneedthefollowing:
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallationandUpgradeGuideforinformation onchangingthesedefaultpasswords.
7.2.1
Keyboardandremoteoperationoftheconfigurationpages
Althoughtheactualfunctionalityenabledisslightlydifferent,thegeneralwaysofcommunicatingwiththe ManagementandPreferencespagesaresimilar,andthetablebelowshowssomeoftheremotecontrol buttonsandkeyboardkeysthatenableimportantfunctionality: Functionality Movearoundtheitemsonthe page. Remotecontrol Arrowbuttons Keyboard Arrowkeys Enter key Back Space key.
Selectanoption/pressabuttonon OKbutton thepage. Deletetextyouhaveentered. LASTCHbutton (greyremote control)orP<P button(black remotecontrol) MENUbutton
DisplayPreferencespages DisplayManagementpages
Alt-Pkeycombination, orSettingsbutton. Alt-Mkeycombination.
Ingeneral,theManagementpagesrequiretheuseofakeyboard.ThePreferencespagesaredesignedforuse withtheremotecontrol.
INDEX
CONTENTS
99
7.3
Preferencespages
ThesettopboxPreferencespagesareasimpleinterfacethatenablesuserstochangebasicsettopbox configurationareassuchasvideo,subtitleandkeyboardsetup.ThepagesareaccessedlocallyviaanIR remotecontrol(orkeyboard).ThePreferencespagesaredesignedforusebyendusers.
Figure 7.29 Opera 9 Preferences page.
7.4
UsingthePreferencespages
ThePreferencespagesaredividedintoseveralareas.Whenyoufirstaccessthepages,amenuthatliststhe availableareasisdisplayed.Themenuincludesthefollowingitems: Area

IR Control A/V Setup Languages Reboot
Allowsyouto: Viewandeditkeyboardandremote configuration. Viewandeditaudio,TVandvideosetup. Viewandeditsetup. ReboottheSettopBox.
7.4.1
Navigationusingtheremotecontrol
OncethePreferencepagesareopen,youmayuseeitherthekeyboardorremotecontroltonavigatearound thepagesandchangesettings.ThePreferencespagesaredesignedtobeabletobeusedwiththeAminoor Ruwidoremotecontrols,sotheusageinstructionsallspecifywhatbuttonstopressonthisremotecontrol.It isalsopossibletouseequivalentkeyboardoptions. Usethearrowbuttonstomoveupordownthemenupage,thenpresstheOKbuttontoselect thepageyouwanttoview. Oncethepageyouwantisdisplayed,youcanusethearrowbuttonstomovearoundit,make changesifrequiredandthenusetheBLUEbuttonontheremoteortheEnter buttononthekey
100
CONTENTS
INDEX
board.Torejectthechanges,usetheREDbuttonontheremoteandtheEscapebuttononthe keyboard. PressOKorEntertoconfirmthis.
7.4.2
Viewingandeditingthesettings
ThefollowingsectiongivesabriefsummaryofhowtousethePreferencespagestochangeconfiguration settings.
7.4.2.1 To view the configuration

1. 2. Openthepagefortheconfigurationareayouwanttoview.Thecurrentconfigurationsettingsare displayed. Toreturntothemenupage,movetothePreferencespageandpressOK.
7.4.2.2 To change the configuration settings

1. 2. 3. 4. 5. Openthepagefortheconfigurationareayouwanttoview. Usethearrowbuttonstomovetothesettingyouwanttochange.Asyoumovearoundthepage,the currentsettingthatyouhavecurrentlyselectedishighlighted. ToselectanoptionwheretherearesettingsyouwishtochangepresstheOKbutton. Usethearrowbuttonstomovetothesettingyouwanttochange. Makethechangesyourequire: 6. Toselectvaluesfromalist,presstheOKbuttontodisplaythechoices,usetheleftandright arrowbuttonstochangetothevalueyouwant,thenpressOKagaintoselectthenewvalue.
Whenyouarehappywithyourchanges,presstheBLUEbuttonontheremote.Ifyouareusingthe infraredkeyboard,usetheEnter button.Torejectthechanges,usetheREDbuttonontheremote andtheEscapebuttononthekeyboard.Therewillbeashortdelaywhilethechangesarewrittento thesettopboxsconfiguration(thesettopboxsLEDwillflashduringthistime). PressOKorEntertoconfirmthis.
7.
7.4.2.3 Closing the Preferences pages

ToleavethePreferencespageswithoutmakingchanges,presstheREDbuttonandthenpressOK.
7.5
Preferencespagesconfigurationareas
Thesectionsthatfollowdetailthemainsettingsavailable.Eachsectionrelatestoapageaccessiblefromthe mainmenu.ForgeneralinformationonchangingconfigurationviatheManagementpages,see"Management pages"onpage112.
INDEX
CONTENTS
101
7.5.1
IRcontrol
ThesepagesenableyoutoviewandeditkeyboardandIRremoteconfiguration.
Figure 7.30 Opera 9 IR control (Basic)
Keyboard Repeat delay (1-4) SeealsoDELAY_FACTOR.ThelengthoftimethatauserholdsakeydownonanIRinput deviceforexample,theIRkeyboard)inordertomakeitrepeat.
Value 1 2 3 4
Description 16csdelayrate. 32csdelayrate. 64csdelayrate. 96csdelayrate.
Repeat rate (0,2-30 cs) ControlsthenumberofcharacterspersecondforIRinputdevices(forexample,theIRkey board).Setanevennumbervalueintherange230(rateincentiseconds),orset0forno repeat.SeealsoREPEAT_RATE. Text entry Enablesordisablesremotetextentryviatheremotecontrol.Iftextentryisenabled,theuser enterstextbyholdingdowntheappropriatenumberkey.SeealsoTEXT_ENTRY.
102
CONTENTS
INDEX
TheRepeatratemustbesetto0(zero)andremotetextentrymustbeenabledforremote textentrytowork.
Figure 7.31 Opera 9 IR control (Advanced) Keyboard layout IR brand SetsthelayoutfortheIRkeyboard. SetsthebrandcodeusedtopairthesettopboxwithaparticularAminoremotecontrol.The valuemustbeintherange000015(and100115fortheAmiNET125and130),andmust matchthecodeontheremotecontrolthatyouwanttousetowiththissettopbox.Seealso IR_BRAND. AdditionalinformationontheInfraredremotecontrolisgiveninAppendixI,Pairingan IRremotecontrolwithasettopbox.
INDEX
CONTENTS
103
7.5.2
A/Vsetup
ThesepagesenableyoutoviewandedittheA/VsetupfortheSTB.
Figure 7.32 Typical Opera 9 Audio Preferences page
Minimum Volume (0-100) Setstheminimumsettopboxvolume.Thismustbelessthanthemaximumvolume,andin therange0100(percent).SeealsoMINIMUM_VOLUME. Maximum Volume (0-100) Setsthemaximumsettopboxvolume.Thismustbegreaterthantheminimumvolume,and intherange0100(percent).SeealsoMAXIMUM_VOLUME.
104
CONTENTS
INDEX
Figure 7.33 Typical Opera 9 Video Preferences page TV type SetshowvideoisformattedfortheTV.SeealsoDISPLAY_MODE. Thefollowingoptionsareavailable:
Value 4:3 16:9

Display mode
NOTE
Description Setsa4:3screenratio. Setsa16:9screenratio.

SetshowvideoisformattedfortheTV.SeealsoDISPLAY_MODE.
TheoptionsavailablechangedependingontheTVtypesetting.
Value Pan&Scan (with4:3mode) Letterbox (with4:3mode) Stretch(4:3to16:9) (with16:9mode)
Description Fortelevisionswithnoautomaticaspectratioswitching, wherethevideoimageisrequiredtofillthefull4:3 screen.Inthismode,4:3contentfitsthescreencorrectly, andany16:9videocontentiscroppedontheleftand rightsides. Fortelevisionswithnoautomaticaspectratioswitching, wherethefull16:9screenisrequired.Inthismode,4:3 contentfitsthescreencorrectly,andany16:9contentis displayedinfull,withblackbarsaboveandbelow. Ignorestheaspectratioofthevideo,andassumethatit isthesameastheratiooftheoutput.Soon16:9display, a4:3imagewillappearhorizontallydistorted.Ona4:3 display,a16:9imagewillappearverticallydistorted.
INDEX
CONTENTS
105
Value Auto (with16:9mode)

Output Resolution
Description Fortelevisionswhichhaveautomaticratioswitching.In thismode,thetelevisionswitchesbetween4:3and16:9 dependingonthevideocontent,andfullcontentisdis playedforboth.

Selectstheoutputresolution,whichshouldbeoneofthefollowingoptions: Standard Definition(notavailableontheA130M) 576p/480p (dependingonwhetherthevalueofTVSYSTEMisPALorNTSC). 720p 1080i Theboxmustberebootedinorderforthechangestotakeeffect. SeealsoOUTPUT_RESOLUTION.
Video output
Setstheoutputformatofthesettopbox.SeealsoOUTFMT.
ThefollowingtableshowswhichvideooutputformatchoicestheManagementandPreferencespagesoffer foreachofthetypesofsettopboxontheVideopage. Settopboxtype AmiNET103 AmiNET110 AmiNET110H Outputformatchoicesoffered COMPOSITE COMPOSITE SVIDEO COMPOSITE+RGB COMPOSITE+SVIDEO COMPOSITE+YPbPr RF COMPOSITE COMPOSITE+RGB COMPOSITE+SVIDEO COMPOSITE+YPbPr RF HDMI(SD)+COMPOSITE+RGB HDMI(SD)+COMPOSITE+SVIDEO HDMI(SD)+COMPOSITE+YPbPr RF(130only) HDMI(SD) COMPOSITE+SVIDEO+YPbPr COMPOSITE+SVIDEO+RGB HDMI(SD)+COMPOSITE+RGB HDMI(SD)+COMPOSITE+SVIDEO RF
AmiNET125
AmiNET130 AmiNET130H
AmiNET130M AmiNET500 AmiNET530(EU)
106
CONTENTS
INDEX
Settopboxtype AmiNET530(US)
Outputformatchoicesoffered HDMI(SD)+COMPOSITE+SVIDEO HDMI(SD)+COMPOSITE+YPbPr RF
NOTE
Theboxmustberebootedinorderforthechangestotakeeffect.
7.5.2.1 Invalid video mode recovery

ForfurtherinformationonthispleaserefertoAppendixH,Invalidvideomoderecovery
.
Figure 7.34 Typical Opera 9 RF Preferences page RF enable Frequency table EnablesordisablestheRFoutput(forplatformswithRFoutput).Seealso
RFMOD_ENABLE.
SetstheRFoutputfrequencytable(forplatformswithRFoutput).Theoptionsareasfollows:
Value BROADCAST CABLE
Description broadcast cable
SeealsoRFMOD_FREQTABLE.
INDEX
CONTENTS
107
RF Channel
SetstheRFchannel(forplatformswithRFoutput).SeealsoRFMOD_CHAN.
Figure 7.35 Typical Opera 9 A/V setup (advanced) page TV System SetstheTVstandard.SeealsoTVSYSTEM.Dependingonthesettopboxtype,theavaila bleoptionsareasfollows:
Value PALI PALM PALN PALG PALB PALH PALD NTSCJ NTSCM
Exampleregion UK Brazil Argentina Europe Australia,Ghana Belgium China(NotethatthisisnotsupportedontheAmiNET103or AmiNET109platforms.) Japan USA
AcompletelistoftheWorldwideTVStandardscanbefoundintheAminoTVStandards Guide.
HDMI audio mode
WhenDolbyDigitalaudioisbeingdecoded,thedecoded2channelPCMdataisembedded intheHDMIsignal,ratherthantheDolbyDigitaldata.SeeHDMI_AUDIO_FORMAT.
Native Resolution Passthrough Ifthisisselectednativestandarddefinitionisdisplayedasnativestandarddefinitionona highdefinitiondisplay.SeeNATIVE_PASSTHRU_ENABLE. Native Framerate Passthrough IfnativeframeratepassthroughisturnedontheSTBwillautomaticallychangeitsoutput frameratetomatchthatofthevideobeingplayed.Forexample,iftheboxissettoPAL
108
CONTENTS
INDEX
(50Hz)andanNTSCclipisplayed(59Hz),theSTBwillswitchtooutputatanNTSCframerate. SeeNATIVE_FRAMERATE_PASSTHRU_ENABLE.
NOTE
ChanginganyvalueonthispagewillrequireanSTBreboot.
7.5.3
Languagessetup
Thesepagesenableyoutoviewandedittheaudioandsubtitlelanguageconfiguration.
Figure 7.36 Typical Opera 9 Audio Languages page
Primary language Setstheprimarylanguageforanaudiostream,forexample,English.Seealso
PREFERRED_LANG.
INDEX
CONTENTS
109
Secondary language
Setsthesecondarylanguageforanaudiostream.IftheSTBcanfindnoaudiostreaminthe Primarylanguage,itselectsanaudiostreaminthechosensecondarylanguage,forexample, Spanish.SeealsoSECONDARY_LANG.
Figure 7.37 Typical Opera 9 Subtitles Languages page Subtitle enable Thisallowsyoutoenableordisablesubtitledisplay.SeealsoSUBTITLES.
Primary subtitle language Setstheprimarylanguageforthedefaultsubtitledisplay.Forexample,English.Seealso SUBTITLES_PREF_LANG. Secondary subtitle language Setsthesecondarylanguageforthedefaultsubtitledisplay.Ifthesettopboxcanfindno subtitleinformationinthePrimarylanguageitusestheinformationintheSecondarysubtitle language,forexample,Spanish.SeealsoSUBTITLES_SECOND_LANG.
110
CONTENTS
INDEX
IfTVSystem(seeabove)issettoNTSCthenthefollowingscreenwillbedisplayed.
Figure 7.38 Typical Opera 9 Closed Captions Languages page CC enable Thisenablesyoutoenableordisableclosedcaptiondisplay. SeeSUBTITLES.
7.5.4
PVRpage
ForAmiNETmodelswithaPVR,thispageenablesyoutoreinitialisetheharddrive.
Figure 7.39 Opera 9 PVR Disk Format page
INDEX
CONTENTS
111
Disk Format ThesingleDisk FormatoptionwillcompletelyreformattheharddriveofthePVR.Alldata willbedeleted.Thefollowingwarningwillbedisplayed:
Warning:
All data and recordings will be deleted!
7.5.5
Reboot
ThispageallowsyoutotriggerarebootoftheSTB.
Figure 7.40 Typical Opera 9 Reboot page
7.5.6
1. 2.
RebootingthesettopboxviathePreferencepages
Onthemainmenu,movetotheRebootoption,thenpresstheOK/Enter button. Thesettopboxrebootsimmediately.
7.6
Managementpages
ThesettopboxManagementpagesareasimpleinterfacethatenablesadministratorstochangesettopbox configurationareassuchasnetworking,channellistandbrowsersetup,aswellasinitiatebasicoperations suchasrebootingandupdatingsoftware.Inaddition,readonlyaccessisavailabletoareassuchasversion andsettopboxidentitysettings.ThepagesarepasswordprotectedandaccessedlocallyviaanAminoIR keyboard(limitedfunctionalityisalsosupportedviatheremotecontrol).
112
CONTENTS
INDEX
UseAlt-M onthekeyboardtoaccesstheManagementpages.Youwillberequiredtoenterthemanagement password.Managementpagesallowaccesstoadvancedconfigurationfunctionsandaredesignedforuseby administratorsratherthanendusers.
Figure 7.41 Opera 9 Management page
Whenyoufirstaccessthepages,amenuthatliststheavailableareasisdisplayed.Themenushouldinclude thefollowingitems: Area Info Browser

Video
Allowsyouto: Viewandeditsettopboxhardwaredetails, softwareversionandidentityinformation. ViewandeditthechannelURLsandgraphics supportinformation. Viewandeditvideodisplayandtimeoutset tings. Viewandeditstaticaddressinformation. Initiateasoftwareupgrade(multicast)or reflash. Rebootthesettopbox.
Network Upgrade Reboot
7.6.1
Navigationusingthekeyboard
OncetheManagementpagesaredisplayed,youcanuseeitherthekeyboardorremotecontroltonavigate aroundthepagesandchangesettings.However,theManagementpagesrequiretheuseofakeyboardto displaythemandentertext,sotheusageinstructionshereallspecifywhatkeystopressonthekeyboard.It isalsopossibletouseequivalentremotecontroloptionsinmanycases. Usethearrowkeystomoveupordownthemenupage,thenpresstheEnterkeytoselectthe pageyouwanttoview.
INDEX
CONTENTS
113
Oncethepageyouwantisdisplayed,youcanusethearrowkeystomovearoundit,make changesifrequiredandthenmovetotheBack to Main MenubuttonandpressEntertoreturnto themenu.
7.6.2
ClosingtheManagementpages
Whenyouhavefinished,presstheBLUEbuttonontheremote.Ifyouareusingtheinfraredkeyboard,use theEnter button.Torejectthechanges,usetheREDbuttonontheremoteandtheEscapebuttononthe keyboard.Therewillbeashortdelaywhilethechangesarewrittentothesettopboxsconfiguration(theset topboxsLEDwillflashduringthistime). PressOKorEntertoconfirmthis.
7.6.3
Viewingandeditingconfiguration
ThefollowingsectiondescribeshowtovieworedittheconfigurationusingtheManagementpages.
7.6.3.1 Viewing
1. 2. Openthepagefortheconfigurationareayouwanttoview.Thecurrentconfigurationsettingsare displayed. Toreturntothemenupage,usetheREDbuttonontheremoteandtheEscapebuttononthekey board.PressOKorEntertoconfirmthis.
7.6.3.2 Editing
Notallconfigurationsettingscanbechanged.IfapagedoesnothaveaPasswordtextbox,thenthesettings areallreadonly. 1. 2. 3. Openthepagefortheconfigurationareayouwanttoview. Usethearrowkeystomovetothesettingyouwanttochange.Asyoumovearoundthepage,the currentsettingthatyouhavecurrentlyselectedishighlighted. Makethechangesyourequire: 4. Tochangeatextfield,usetheBack Space keytodeletethecurrentvalue,thentypethenew value. Toselectvaluesfromadropdownlist,presstheLeftorRightkeytoscrollthroughthechoices, thenpressBLUE/Enteragaintoselectthenewvalue.
Whenyouarehappywithyourchanges,movetothePasswordfieldandtypethepassword.Ifyou havenotchangedthedefaultpassword,thisissnake.Whenyouhavefinished,presstheBLUEbut tonontheremote.Ifyouareusingtheinfraredkeyboard,usetheEnter button.Torejectthechang es,usetheREDbuttonontheremoteandtheEscapebuttononthekeyboard. PressOKorEntertoconfirmthis
5.
Formanyconfigurationsettings,youwillnowneedtorebootthesettopboxforthechangestotakeeffect.
7.6.4
1. 2.
Rebootingthesettopboxviathemanagementpages
Onthemainmenu,movetotheRebootoption,thenpresstheEnter button. Thesettopboxrebootsimmediately.
114
CONTENTS
INDEX
7.6.5
Settopboxinformation(Infopage)
ThispageenablesyoutoViewandeditsettopboxhardwaredetails,softwareversionandidentity information
.
Figure 7.42 Typical Opera 9 hardware Information page.
Product CPU CPU Speed SDRAM FLASH TheAmiNETsettopboxtype. Theprocessortype. Theprocessorspeed. ThesizeoftheSDRAM. ThesizeoftheFlash.
INDEX
CONTENTS
115
Board revision
Theboardrevisionnumber.
Figure 7.43 Typical Opera 9 Software information page Software version CR version OEM version TheSoftwareversionenablesyoutoviewtheversionstringforthesoftwarebuild. TheCustomResource(CR)versionenablesyoutoviewthecustomresourceversion. TheOEMversionasdefinedbythesystemintegratorin/mnt/nv/oemversion.
Figure 7.44 Typical Opera 9 Identity information page MAC Address ThesettopboxMACaddress.This value is locked during manufacture. IfyouhaveadevelopmentsettopboxonwhichtheMACaddressisstilleditable,youmust notchangeitunlessyouarefullyawareoftheeffects.SeealsoMAC_ADDRESS.
116
CONTENTS
INDEX
Serial Number
Thesettopboxserialnumber.This value is locked during manufacture. Ifyouhaveadevelopmentsettopboxonwhichtheserialnumberisstilleditable,youmust notchangeitunlessyouarefullyawareoftheeffects.SeealsoSERIAL_ID.
7.6.6
Browsersetup
Thispageenablesyoutoviewandeditthebrowserhomepageandgraphicssetupinformation.
Figure 7.45 Typical Opera 9 Browser page
INDEX
CONTENTS
117
Home page
Setsthehomepage.ThisistheURLforthepagethatthebrowsergoestowhentheHome keyispressedandwhenthesettopboxhasbootedsuccessfully.TheURLenteredmustbe intheformathttp://<address>.SeealsoBROWSER_HOMEPAGE.
Figure 7.46 Typical Opera 9 Browser Graphics page Full screen mode GFX resolution Enablesordisablesfullscreenmode.SeealsoFULLSCREEN. Setsthegraphicsresolution.Oneofthefollowingoptions:SeealsoGFX_RESOLUTION. InthiscaseSDgraphicsistheequivalentoflibconfig-set SETTINGS.GFX_RESOLUTIONPAL/NTSC.EitheronewillprovideSDgraphics,butthevalue ofTVSYSTEM determinesthefinalscreenresolution. Setstheleftbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_LEFT. Setstherightbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.seealso BROWSER_MARGIN_RIGHT. Setsthetopbrowsermargin,asapercentageofthegraphicsplanesize(thatis,intherange 0100).Operaalsoallowmarginstobespecifiedinpixels.BROWSER_MARGIN_TOP. Setsthebottombrowsermargin,asapercentageofthegraphicsplanesize(thatis,inthe range0100).Operaalsoallowmarginstobespecifiedinpixels.Seealso BROWSER_MARGIN_BOTTOM.
Left Margin
Right Margin
Top Margin Bottom Margin
118
CONTENTS
INDEX
7.6.7
Videosetup
Thesepagesenableyoutoviewandeditthevideoconfiguration.
Figure 7.47 Typical Opera 9 basic Video information page
Default Video Server Setsthedefaultvideoservertype.Theavailableoptionsare: Concurrent EONA InfoValue Kasenna MediaBase nCube Oracle Sapphire SeaChange Tandberg OpenStream Telefonica Anevia BitBand See also RTSP_SERVER.
INDEX
CONTENTS
119
Trick-play
Thedefaultfastforwardandrewindmultiplier.SeealsoRTSP_SCALE.
Figure 7.48 Typical Opera 9 Video Events page RTSP start timeout NumberofsecondstowaitforRTSPdataaftersendinganRTSPplaycommand,beforeano videoeventisraised.Thismustbeintherange030,where0meansthattherewillnever beatimeoutraised.SeealsoRTSP_START_TIMEOUT. NumberofsecondstowaitwhennomoreRTSPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoRTSP_END_TIMEOUT. NumberofsecondstowaitforvideodatatoarriveafteranIGMPjoincommand,beforea novideoeventisraised.Thismustbeintherange030,where0meansthattherewillnever beatimeoutraised.SeealsoIGMP_START_TIMEOUT. NumberofsecondstowaitwhennomoreIGMPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoIGMP_START_TIMEOUT. NumberofsecondstowaitaftertryingtoconnecttoaUDPmediastream,beforeanovideo eventisraised.Thismustbeintherange030,where0meansthattherewillneverbea timeoutraised.SeealsoUDP_START_TIMEOUT. NumberofsecondstowaitwhennomoreUDPdataisseen,beforeanendofmediaevent israised.Thismustbeintherange030,where0meansthattherewillneverbeatimeout raised.SeealsoUDP_END_TIMEOUT.
RTSP end timeout
IGMP start timeout
IGMP end timeout
UDP start timeout
UDP end timeout
120
CONTENTS
INDEX
7.6.8
Networksetup
Thesepagesenableyoutoviewandeditthenetworkconfiguration.
Figure 7.49 Typical Opera 9 Network Information (DHCP enabled) page
DHCP SetswhethertheSTBwillbegettingitsnetworksettingsdynamicallyfromtheDHCPserver (DHCP enabled). IfthesettopboxwillnotbegettingallitsnetworksettingsdynamicallyfromtheDHCP server(DHCP disabled),thenyouwillneedtoensurethattheappropriatestaticsettings arespecifiedonthispage(forexample,IPaddressandnetmask).SeealsoDHCP
Figure 7.50 Typical Opera 9 Network Information (DHCP disabled) page
INDEX
CONTENTS
121
IP Address
SetsthestaticIPaddressforthesettopbox.Thisisonlyneededifthesettopboxdoesnot retrieveitsnetworksettingsfromaDHCPserver.Seealso IPADDR. Setsthenetmask.Thisisonlyneededifthesettopboxdoesnotretrieveitsnetworksettings fromaDHCPserver.SeealsoNETMASK. SetstheIPaddressforthegatewayforthesettopbox.Thisisonlyneededifthesettopbox doesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoGATEWAY. SetstheIPaddressesforthedomainnameserversforthesettopbox.Thisisonlyneededif thesettopboxdoesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoDNS.
Netmask Gateway DNS
Figure 7.51 Typical Opera 9 Network Information (Advanced) page: Hostname Domain Time server NTP client timeout Timezone Setsthehostnameforthesettopbox. Setsthedomainforthesettopbox.Thisisonlyneededifthesettopboxdoesnotretrieve itsnetworksettingsfromaDHCPserver.SeealsoDOMAIN. TheaddressoftheNTPclient(eitherstaticorasfromtheDHCPserver).See TIME_SERVER. Themaximumwaitingtimeforaserverresponse.SeeNTPCLIENT_TIMEOUT. ThetimezoneinwhichtheSTBisoperating.SeeTIME_ZONE. Seehttp://www.twinsun.com/tz/tzlink.htmor
http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
Ethernet Link Setsthedefaultspeedforthemainethernetporttooneofthefollowingvalues: Auto detect(thisisthedefault) 10Mbit/s Half Duplex 10Mbit/s Full Duplex 100Mbit/s Half Duplex
122
CONTENTS
INDEX
100Mbit/s Full Duplex Note:10BaseTEthernetisnotsupportedbyx4xseriesSTBs. SeealsoETHERNET. Packet Ordering Enablesordisablespacketordering.Ifpacketorderingisenabled,thesettopboxbuffersout oforderpackets.SeealsoPACKET_ORDERING.
Figure 7.52 Typical Opera 9 Network DHCP Information page IP Address SetsthestaticIPaddressforthesettopbox.Thisisonlyneededifthesettopboxdoesnot retrieveitsnetworksettingsfromaDHCPserver.Seealso IPADDR. Setsthenetmask.Thisisonlyneededifthesettopboxdoesnotretrieveitsnetworksettings fromaDHCPserver.SeealsoNETMASK. SetstheIPaddressforthegatewayforthesettopbox.Thisisonlyneededifthesettopbox doesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoGATEWAY. Setsthedomainforthesettopbox.Thisisonlyneededifthesettopboxdoesnotretrieve itsnetworksettingsfromaDHCPserver.SeealsoDOMAIN. SetstheIPaddressesforthedomainnameserversforthesettopbox.Thisisonlyneededif thesettopboxdoesnotretrieveitsnetworksettingsfromaDHCPserver.SeealsoDNS. TheDHCPleasetimeasreturnedbytheDHCPserver.SeealsoLEASETIME. TheDHCPrenewaltimeasreturnedbytheDHCPserver.Seealso RENEWALTIME. TheDHCPrebindtimeasreturnedbytheDHCPserver.Seealso
Netmask Gateway Domain DNS Lease time Renewal time Rebind time
REBINDTIME.
INDEX
CONTENTS
123
7.6.9
Upgrade
ThispagesenablesyoutotriggeramulticastupgradeoftheSTB.
Figure 7.53 Typical Opera 9 Upgrade page
7.6.9.1 To initiate a software upgrade via the management pages

Beforeyouinitiateasoftwareupgrade,youwillneedtoensurethatnewsoftwareisavailable.Inmostcases, thismeansthatthemulticastsystemmustbesetup,withthemulticastservertransmittingappropriatenew softwareimages. 1. 2. Onthemainmenu,movetotheUpgradeoption,thenpresstheEnter button.TheUpgradepageis displayed. Youcaneitherupgradejustthemainsoftwareimageoryoucanreflashthesettopbox(thatis,de letethecontentsoftheNANDflashandreloadbothanewbootstrapandanewsoftwareupgrade image).Whenthesettopboxperformsasoftwareupgrade,itteststhenewsoftwareandcanrevert totheoldsoftwareifthereisaproblem.Whentheboxreflashes,itwipesitscurrentsoftwarebefore installingnewsoftwaresoitmaynotbeabletoreverttotheoldsoftwareifthereisaproblem.
7.6.9.2 To upgrade the main set-top box image

1. 2. 3. 4. IntheMulticast address field,entertheIPaddressforthemulticastimage(thisistheIPaddress specifiedinthemulticastserverconfiguration). IntheMulticast Port field,entertheportforaccessingthemulticastimage(again,asspecifiedinthe multicastserverconfiguration). InthePassword field,enterthepassword.Ifyouhavenotchangedthedefault,thisissnake. PresstheBLUEbuttonontheremote.Ifyouareusingtheinfraredkeyboard,usetheEnter button tostarttheupgrade.
124
CONTENTS
INDEX
7.6.9.3 To reflash the set-top box

1. 2. LeavetheAddressandPortfieldsblank. InthePassword field,enterthepassword.Ifyouhavenotchangedthedefault,thisissnake.
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallationandUpgradeGuideforinformation onchangingthesedefaultpasswords. 3. PresstheBLUEbuttonontheremote.Ifyouareusingtheinfraredkeyboard,usetheEnter button tostarttheupgradeorreflash.
7.6.10 Reboot
ThispageenablesyoutotriggerarebootoftheSTB
.
Figure 7.54 Typical Opera 9 Reboot page
7.6.11 RebootingthesettopboxviatheManagementpages
1. 2. Onthemainmenu,movetotheRebootoption,thenpresstheOK/Enter button. Thesettopboxrebootsimmediately.
7.7
ConfigurationpagesettingsforOpera9
ThemainsettingsneededtoconfigurethesettopboxcanbeaccessedviatheConfigurationpages.Which configurationareathesesettingsarereadfrom(thatis,configurationfileorNORFlash)dependsonthe softwarebuild.ThefollowingtableshowswhichareatheConfigurationpagesreadandwritesettingstofor theOpera9browsers(thesettingisspecifiedwiththefilename(orNORFlash)onthefirstlineandthe settingnameonthenextline).
INDEX
CONTENTS
125
YoumayneedthisinformationifyouwanttotrialsettingsviatheConfigurationpagesandthencopythenew configurationtotheimagecomponentsusedtocreateanewsoftwareimage.
7.7.1
Preferencespages
Area
IR Control pages
Opera9 Settings DELAY_FACTOR Settings REPEAT_RATE Settings TEXT_ENTRY Settings IR_BRAND Settings MINIMUM_VOLUME Settings MAXIMUM_VOLUME Settings DISPLAY_MODE Settings DISPLAY_MODE NORFlash OUTPUT_RESOLUTION NORFlash OUTFMT NORFlash RFMOD_ENABLE NORFlash RFMOD_FREQTABLE NORFlash RFMOD_CHAN NORFlash TVSYSTEM NORFlash HDMI_AUDIO_FORMAT NORFlash NATIVE_PASSTHRU_ENABLE NORFlash NATIVE_FRAMERATE_PASSTHRU_ENABLE
Repeatdelay Repeatrate Textentry IRbrandcode

A/V setup pages
MinimumVolume MaximumVolume TVtype Displaymode Outputresolution Videooutput RFenable Frequencytable RFChannel TVSystem HDMIaudiomode NativeResolutionPass through NativeFrameratePass through
126
CONTENTS
INDEX
Area
Languages setup pages
Opera9 Settings PREFERRED_LANG Settings SECONDARY_LANG NORFlash SUBTITLES Settings SUBTITLES_PREF_LANG (orusersettingsfileifthefileexists) Settings SUBTITLES_SECOND_LANG (orusersettingsfileifthefileexists)
Primarylanguage Secondarylanguage Subtitleenable CCenable Primarysubtitle language Secondarysubtitle language
7.7.2
Managementpages
Area
STB Information pages
Opera9 hardcoded hardcoded hardcoded hardcoded hardcoded hardcoded hardcoded

/etc/version
Product CPU CPUspeed SDRAM FLASH ROMtype BoardRevision Softwareversion CRversion OEMversion MACAddress SerialNumber Browsersetuppages Homepage Fullscreenmode GFXresolution LeftMargin
/mnt/nv/cversion /mnt/nv/oemversion NORFlash MAC_ADDRESS NORFlash SERIAL_ID
Settings BROWSER_HOMEPAGE Settings FULLSCREEN Settings GFX_RESOLUTION Settings BROWSER_MARGIN_LEFT
INDEX
CONTENTS
127
Area RightMargin TopMargin BottomMargin

Video setup pages
Opera9 Settings BROWSER_MARGIN_RIGHT Settings BROWSER_MARGIN_TOP Settings BROWSER_MARGIN_BOTTOM Settings RTSP_SERVER Settings RTSP_SCALE Settings RTSP_START_TIMEOUT Settings RTSP_END_TIMEOUT Settings IGMP_START_TIMEOUT Settings IGMP_START_TIMEOUT Settings UDP_START_TIMEOUT Settings UDP_END_TIMEOUT NORFlash DHCP NORFlash IPADDR(orinnetconffile, dependingonbuild) NORFlash NETMASK NORFlash GATEWAY(orinnetconffile, dependingonbuild) NORFlash DNS hostname
HOSTNAME(orinnetconffile,
DefaultVideoServer Trickplay RTSPstarttimeout RTSPendtimeout IGMPstarttimeout IGMPendtimeout UDPstarttimeout UDPendtimeout

Network setup pages
DHCP IPAddress
Netmask Gateway
DNS Hostname
dependingonbuild) Domain
netconf
DOMAIN
128
CONTENTS
INDEX
Area TimeServer NTPClienttimeout Timezone EthernetLink PacketOrdering IPAddress
Opera9 NORFlash TIME_SERVER Settings NTPCLIENT_TIMEOUT

netconf
TIME_ZONE NORFlash ETHERNET

netconf
PACKET_ORDERING NORFlash IPADDR(orinnetconffile, dependingonbuild) NORFlash NETMASK NORFlash GATEWAY(orinnetconffile, dependingonbuild) NORFlash DNS DHCPC LEASETIME DHCPC RENEWALTIME DHCPC REBINDTIME
Netmask Gateway
DNS Leasetime Renewaltime Rebindtime
INDEX
CONTENTS
129
130
CONTENTS
INDEX
Appendix ANOR Flash settings
ThefollowingtabledescribesthesettingsavailableintheNORFlash.Forconveniencesake,thesearelistedin alphabeticalorder.Notethatwhetherthesevaluesareuseddependsonthesoftwareandhardwarebuild. Defaultvalueslistedhereareusedifnovalueissupplied.Inrealitytheactualdefaultisbuildspecific,somay notbeasspecified. Theexamplesshowhowtoenterthesettingifyouareeditingthesettingsfiledirectly.Seetheappropriate documentationforinformationonhowtoentervaluesusingothermeans(forexample,JMACXor libconfig). Setting

BOARDREV
Values 16bitinteger:
Description Specifiestheboardtype(relatestotheregionthatthe settopboxisdesignedtoworkinandindicatesboard features). ForfurtherinformationonBoardrevisionnumberssee AppendixF,Boardrevisionnumbers Readonly.

Default:
None.
Example: libconfig-get NORFLASH.BOARDREV > 16 CORE_LANG
3characterISO 3characterISO6393compliantstringtoindicatethe 6393compliant (major)languageusedbytheSTBforcorefunctionality string. suchaserrormessages,statusmessages,UImessages. Nottobeconfusedwiththeaudiolanguagesettings, thoughthismaybeusedtosuggestoneintheir absence. Seehttp://www.sil.org/ISO6393/codes.aspforcode details.
Default:
Example: libconfig-set NORFLASH.CORE_LANG eng

AminoCommunicationsLtd.2011CONFIDENTIAL INDEX CONTENTS 131
Setting
CUSTOMER_DATA
Values <12characters.
Description Astringcontainingnomorethan12characters,thiscan beanythingthecustomerwants,itsuseisnotpre scribed.

Default:
Example: libconfig-set NORFLASH.CUSTOMER_DATA PANIC BUTTON DHCP_USER_CLASS
<12characters.
Astringcontainingnomorethan12characters,thiscan beanythingthecustomerwants,itsuseisnotpre scribed.

Default: Example: libconfig-set NORFLASH.DHCP_USER_CLASS CLASS_1
DHCP
Y=Alwaysuse
DHCP N=Donotuse DHCP
Configureswhethernetworkconfigurationiscarriedout bycontactingaDHCPserver.Thisvalueisusedif USE_NORissettoYinthenetconffile.Notethatif DHCPissettoN,themulticastupgradevaluesand othersettingsarereadfromthesettingslistedinthis table(e.g.theMULTICAST_<name>settings).

Default: Example: libconfig-set NORFLASH.DHCP Y
DHCP_ AUTHENTICATION
None Tele2 Samsung
NonenoDHCPauthentication Tele2DHCPauthenticationusingtheTele2vendor string. Samsung_DHCPauthenticationusingtheSamsung vendorstring.

Default: None Example: libconfig-set NORFLASH.DHCP_ AUTHENTICATION Tele2
DHCPTIMEOUT
Timeinseconds Setshowlong(inseconds)theDHCPtimeoutvalue passedasastring shouldbebeforeanewrequestismade.

Default: Example: libconfig-set NORFLASH.DHCPTIMEOUT 3600
132
CONTENTS
INDEX
Setting
DI
Values
Description Thiscontainsastringrepresentationofanintegerthatis increasedonaperbuildbasistoensurethatduringa multicastupgradeanolderbuildisnotputontotheSTB. Readonly.

Default: 0 Example: libconfig-get NORFLASH.DI > 2
DNS
ValidIPaddress.
SpecifiestheIPaddressoftheDNSserverthattheset topboxshouldbeusing.ThisisthevalueusedifDHCP issettoN(orifthesettopboxcannotretrieveanIP addressfromtheDHCPserver.

Default: Example: libconfig-set NORFLASH.DNS 123.4.5.67
ETHERNET
AUTO= Setsthedefaultspeedforthemainethernetport. autodetect. Default: 10HD=10Mbit/s AUTO halfduplex. Example: 10FD=10Mbit/s libconfig-set NORFLASH.ETHERNET 10HD fullduplex. 100HD=
100Mbit/shalf duplex.
100FD=
Note:10BaseTEthernetisnotsupportedbyx4xseries STBs.
100Mbit/sfull duplex.
GATEWAY
ValidIPaddress.
Specifiesthegatewayforthesettopbox.Thisisthe valueusedifDHCPissettoN(orifthesettopboxcan notretrieveanIPaddressfromtheDHCPserver.

Default: Example: libconfig-set NORFLASH.GATEWAY 123.4.5.67
IDENT
ThemodelidentitystringoftheSTB. Readonly.
Default: None. Example: libconfig-get NORFLASH.IDENT >aminet110
INDEX
CONTENTS
133
Setting
IGMP_MAX_VER
Values
2or3
Description SpecifiesthemaximumversionofIGMPprotocoltouse. NULLor0ifnoversionhasbeenset

Default: None. Example: libconfig-set NORFLASH.IGMP_MAX_ VER 2
IPADDR
ValidIPaddress.
ConfiguresthestaticIPaddressofthesettopbox.This isthevalueusedifDHCPissettoN.
Default: Example: libconfig-set NORFLASH.IPADDR 123.45.6.7
LINKSTATE_FAIL_ THRESHOLD
Astring Configuresthetimeoutforthelinkstate. representationof Default: aninteger, 60 containinga Example: timeoutinsec onds. libconfig-set NORFLASH.LINKSTATE_
TIMEOUT 30
LINKSTATE_PERIOD
Astring representationof aninteger, containinga timeoutinsec onds.
Definesthetimeintervalbetweenchecksofthelinksta tus.
Default: 10 Example: libconfig-set NORFLASH.LINKSTATE_ PERIOD 30
LOCK
0=TheNOR
Flashisnot locked. 1=TheNOR Flashislocked.
SpecifiesthelockstateoftheNORFlash. Ifthisissetto1,valuessuchastheMACaddressofthe STB,theserialnumberoftheSTBandsomeCAsettings thatidentifyanindividualsettopboxcannotbe changed. Readonly.

Default: 0 Example: libconfig-get NORFLASH.LOCK >1
134
CONTENTS
INDEX
Setting
MAC_ADDRESS
Values
Description SetstheuniqueMACaddressofthesettopbox,using six8bitvaluesseparatedbycolons,e.g.

aa:bb:cc:dd:ee:ff.
IftheMACaddressischanged,thenthesettopbox needstoberebootedforthenewvaluetotakeeffect. Readonly,exceptinproductionbuilds.

Default: Example: libconfig-get NORFLASH.MAC_ADDRESS >00:02:02:ff:fc:64 MULTICAST_ BOOTSTRAP_GROUP
Avalidmulticast IPaddressinthe range: 224.0.0.0

239.255.255. 255
Configuresastaticmulticastbootstrapgroup.Entera validIPaddressforthegroup,andset MULTICAST_BOOTSTRAP_PORTwiththeporttouse. Thisvalueisused: Asafallbackbootstrapgroupwhenthegroupand portspecifiedbyDHCPcannotbefound Fordeploymentswherebootinginformationisnot heldonaDHCPserver
Thesettopboxalwaystriestouseavalueservedfroma DHCPinpreferencetothestaticallydefinedvalue, unlessDHCPissettoN

Default: 0.0.0.0 Example: libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_GROUP 234.56.78.9 MULTICAST_ BOOTSTRAP_PORT 0 65535
Configuresastaticmulticastbootstrapport.Youwill alsoneedtosetMULTICAST_BOOTSTRAP_GROUPwith theIPaddresstouse. Thisvalueisused: asafallbackportgroupwhenthegroupandportspeci fiedbyDHCPcannotbefound fordeploymentswherebootinginformationisnotheld onaDHCPserver Thesettopboxalwaystriestouseavalueservedfroma DHCPinpreferencetothestaticallydefinedvalue, unlessDHCPissettoN.
Default: 0 Example: libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_PORT 11111
INDEX
CONTENTS
135
Setting
MULTICAST_ FILESYSTEM_GROUP
Values
Description
ValidmulticastIP Configuresastaticmulticastfilesystemgroup. addressinrange EnteravalidIPaddressforthegroup,andset 224.0.0.0 MULTICAST_FILESYSTEM_PORTwiththeporttouse. 239.255.255.2 Thisvalueisused: 55 asafallbackfilesystemgroupwhenthegroupand portspecifiedbyDHCPcannotbefound fordeploymentswherebootinginformationisnot heldonaDHCPserver
Thesettopboxalwaystriestouseavalueservedfroma DHCPinpreferencetothestaticallydefinedvalue, unlessDHCPissettoN.

Default: 0.0.0.0 Example: libconfig-set NORFLASH.MULTICAST_FILESYSTEM_GROUP 239.4.5.67 MULTICAST_ FILESYSTEM_PORT 0 65535
Configuresastaticmulticastfilesystemport.Youwill alsoneedtosetMULTICAST_FILESYSTEM_GROUP withtheIPaddresstouse. Thisvalueisused: Asafallbackfilesystemportwhenthegroupand portspecifiedbyDHCPcannotbefound Fordeploymentswherebootinginformationisnot heldonaDHCPserver

Default: 0 Example: libconfig-set NORFLASH.MULTICAST_FILESYSTEM_PORT 11111
136
CONTENTS
INDEX
Setting
MULTICAST_ UPGRADE_GROUP
Values
Description
ValidmulticastIP Configuresastaticmulticastupgradegroup.Entera addressinrange validIPaddressforthegroup,andset 224.0.0.0 MULTICAST_UPGRADE_PORTwiththeporttouse. 239.255.255.2 Thisvalueisused:

55
Asafallbackbootstrapgroupwhenthegroupand portspecifiedbyDHCPcannotbefound. Fordeploymentswherebootinginformationisnot heldonaDHCPserver.

Default: 0.0.0.0 Example: libconfig-set NORFLASH.MULTICAST_UPGRADE_GROUP 239.4.5.67 MULTICAST_ UPGRADE_PORT 0 65535
Configuresastaticmulticastupgradeport.Youwillalso needtosetMULTICAST_UPGRADE_GROUPwiththeIP addresstouse. Thisvalueisused: Asafallbackupgradegroupwhenthegroupand portspecifiedbyDHCPcannotbefound. Fordeploymentswherebootinginformationisnot heldonaDHCPserver.

Default: 0 Example: libconfig-set NOFLASH.MULTICAST_ UPGRADE_PORT 11111 NET_OPERATOR
SetsthevalueoftheNetworkOperatorcodeusedto generatetheChineseStandardID.
Default: Example: libconfig-set NORFLASH.NET_OPERATOR
INDEX
CONTENTS
137
Setting
NETMASK
Values ValidIPaddress.
Description Specifiesthestaticnetmaskforthesettopbox.Thisis thevalueusedifDHCPissettoN(orifthesettopbox cannotretrieveanIPaddressfromtheDHCPserver.

Default: Example: libconfig-set NORFLASH.NETMASK 255.255.0.0
NTSC_SUBS
WheninNTSC,configurewhethertoshowDVBsubtitles subtitlesinNTSC whicharenotnormallysupportedinNTSCregions. mode. Default: N=Donotdis playDVBsubti Example: tlesinNTSC libconfig-set NORFLASH.NTSC_SUBS Y mode.
HDNONE=
Y=DisplayDVB
OUTPUT_RESOLUTION
Usedtosettheoutputvideoresolution. Outputresolu ForHDAUTOWhenanHDMIcableisconnected,the tionisdefinedby preferredHDresolution(SETTINGS.PREF_HD_ TVSYSTEM. RESOLUTION)willbeused.Ifthisisnotset,720Pwill HD480P59= beused. 480p@59.94Hz. HD576P50= Default: 576p@50Hz 720p HD720P50= Example: 720p@50Hz
HD720P59=
720p@59.94Hz
HD1080I50=
libconfig-set NORFLASH.OUTPUT_ RESOLUTION HD576P50
1080i@50Hz
HD1080I59= 1080i@59.94Hz HDAUTOAllows switching betweenSDand HDdependingon whetheran HDMIcableis connectedornot.
AnyanalogueSDoutputisalwaysdefinedbyTVSYSTEM, regardlessofthevalueofOUTPUT_RESOLUTION. HDNONEmeansthattheHDcapableoutputsaresetto theTVSYSTEMdefinedmode. Alsosee"A130VideoOutputs"onpage144forfurther information.
138
CONTENTS
INDEX
Setting
OUTFMT
Values
CVBS-RGBOFF
Description
Definestheoutputformatofanystandarddefinition outputfromthesettopbox CVBS-RGBON Theoutputformatsavailabledependonthesettopbox Composite+RGB andvideocableorcablesused. Default: LC-RGBOFF Svideo LC-RGBON Example: Svideo+RGB libconfig-set NORFLASH.OUTFMT CVBSCVBS-LC RGBOFF Composite+ SeeAppendixE,Videooutputformats and "Overview Svideo ofcommandoptions"onpage28forfurtherdetails. CVBS-LBR Composite+ Component LBR-CVBS-LC Component+ Composite+ Svideo RGB-CVBS-LC Composite+ Svideo+RGB Composite Amaximumof32 characters. Note:Ona103 boardthemaxi mumis10char acters. ConfiguresthepasswordtouseinPPPbuilds. PPPbuildsonly.
Default: Example: libconfig-set NORFLASH.PPP_PASSWORD MyPassword
PPP_PASSWORD
PPP_USERNAME
Amaximumof64 ConfigurestheusernametouseinPPPbuilds. characters. PPPbuildsonly.

Default: Example: libconfig-set NORFLASH.PPP_USERNAME MyUserName
RECOVERY_UPGRADE_ SERVER
Amaximumof48 Astringcontainingnomorethan48charactersusedto characters identifytherecoveryimageupgradeserver.

Default: Example: libconfig-set NORFLASH.RECOVERY_ UPGRADE_SERVER "upgrade.aminocom.com"
INDEX
CONTENTS
139
Setting
RFMOD_CHAN
Values
Description
Integerlessthan SetstheRFchannelforboardsthathaveanRFmodula 128. tor.

Default: Example: libconfig-set NORFLASH.RFMOD_CHAN 3 Y=EnabletheRF EnablesordisablestheRFmodulatorforboardsthat
RFMOD_ENABLE
tuner. haveone. N=DisabletheRF Default: tuner.

Example: libconfig-set NORFLASH.RFMOD_ENABLE Y RFMOD_FREQTABLE BROADCAST CABLE
ConfigureswhethertheRFmodulatorusescableor broadcastfrequencies.
Default: Example: libconfig-set NORFLASH.RFMOD_ FREQTABLE CABLE
SCART_PIN8_OFF
Y=Setpin8OFF. N=Setpin8ON.
(OnlyforA110and A125)
SettingthistotrueensuresthatSCARTpin8willremain offatstartup.
Default:
.
Example: libconfig-set NORFLASH.SCART_PIN8_OFF Y SERIAL_ID
ConfigurestheuniqueserialIDofthesettopbox. Readonly,exceptinproductionbuilds.
Default:
Theserialnumberoftheboxistheusualvalue.
Example: libconfig-get NORFLASH.SERIAL_ID >C01008F000276 STB_ATTESTATION
SetsthevalueoftheSTBAttestationnumberusedto generatetheChineseStandardID.
Default: Example: libconfig-set NORFLASH.STB_ ATTESTATION
140
CONTENTS
INDEX
Setting
STB_PROVIDER
Values
Description SetsthevalueoftheSTBProvidercodeusedtogenerate theChineseStandardID.

Default: Example: libconfig-set NORFLASH.STB_ PROVIDER
SUBTITLES
Y=Display
Enableordisablethesubtitle/closedcaptiondisplay subtitles/closed whenplayingvideothatcontainssubtitles/closedcap captions tions. N=Donotdisplay Default: subtitles/closed N captions

Example: libconfig-set NORFLASH.SUBTITLES Y
TFTP_LOADFILE
Downloadscript Specifiesastaticnameofthedownloadscripttousein name. TFTPupgrades.Thisallowsforastaticdownloadscript toberequestedfordownloadingimagesfromaTFTP server.Thisvaluewillbeusedfirst,beforemakinga DHCPrequesttotrytoobtainthisinformationfroma DHCPserver Thevaluemustbeastringwithnomorethan14charac ters.Setwithanemptystring("")todisablethestatic entryandenableDHCPconfigurationtobeused instead. OnlyusedforsystemsthatusetheTFTPupgrademech anisminsteadofmulticast.
Default: Example: libconfig-set TFTP_LOADFILE AMINET.txt
TFTP_SERVER
ValidIPaddress.
SpecifiesastaticTFTPserverIPaddress. OnlyusedforsystemsthatusetheTFTPupgrademech anisminsteadofDHCP.

Default: Example: libconfig-set NORFLASH.TFTP_SERVER 234.56.78.9
INDEX
CONTENTS
141
Setting
TIME_SERVER
Values ValidIPaddress
Description Specifiesthelocationofthetimeserverforthesettop boxtouse.ThisisthevalueusedifDHCPissettoN(orif thesettopboxcannotretrieveanIPaddressfromthe DHCPserver. Note: TIME_ZONEsupportinNORFlashisdeprecated andshouldnotbeused.
Default: Example: libconfig-set NORFLASH.TIME_SERVER 234.56.78.9 TIME_ZONE
astring,whichcontainsastringintheformatofsss+nor sssn. Note: Thisimplementationinvertsthesign.Soforatime zoneofGMTplus1hourthestringwouldbeGMT1.

Default: Example: libconfig-set NORFLASH.TIME_ZONE GMT+1
TimezoneisGMTminusonehour(GMT=12:00,TZ= 11:00) U_BOOT_OPTION

0Alwaysrunu SetsubootbehaviourontheA130platform.
bootifthereisa validuboot Default: imageavailable 1Ifthereisa Example: validuboot image,runitiffit libconfig-set NORFLASH.U_BOOT_OPTION isappropriately 1 signed 2+Fallbackto oldbehaviour: bootfromNAND, multicastortftp. Donotattempt torunuboot.
142
CONTENTS
INDEX
Setting
TVSYSTEM
Values
PAL-B=Aus
Description SetstheTVsystemthatthesettopboxwilloperatein. Note: Afterthevaluehasbeenalteredthesettopbox willneedtoberebootedforthechangetotakeeffect.

Default: Example: libconfig-set NORFLASH.TVSYSTEM PAL-B
tralia,Ghana. PAL-G=Europe. PAL-H=Belgium. PAL-I=UK. PAL-M=Brazil. PAL-N = South America.

PAL-CN =
Argentina.
NTSC-J =
Japan.
NTSC-M = US. USE_PPP Y=usePPP. N=donotuse PPP.
EnablesordisablesusingPointtoPointProtocol(PPP).
Default: Example: libconfig-set NORFLASH.USE_PPP=Y
VLAN
0=disables
EnablesordisablesVLAN. VLAN. IfVLANisenabled,youneedtoset 1=enableVLAN. VLAN_INTERNAL_IDandVLAN_EXTERNAL_IDwith thenetworkportstouse. AppliestotheA110HandA130Honly.

Default: 0 Example: libconfig-set NORFLASH.VLAN 1
VLAN_EXTERNAL_ID
>0
SpecifiestheVLANIDoftheexternalnetworkport. AmiNET110HandAmiNET130Honly.
Default: Example: libconfig-set NORFLASH.VLAN_ EXTERNAL_ID 123
VLAN_INTERNAL_ID
>0
SpecifiestheVLANIDoftheinternalnetworkport. AppliestotheAmiNET110HandAmiNET130Honly.
Default: Example: libconfig-set NORFLASH.VLAN_ INTERNAL_ID 123
INDEX
CONTENTS
143
A.1
A130VideoOutputs
TheA130hasaprimaryandasecondaryvideointerface.TheprimarycanrendertheVideoandtheGFX planes,whilstthesecondaryonlyrenderstheVideo(thatis,noGFX).
A.1.1
OUTPUT_RESOLUTION
OUTPUT_RESOLUTIONcontrolstheprimaryoutput.IfthisissettoaHDresolution(720P,1080iandsoon) thentheprimaryinterfacewillfeedtheHDMIand/orHDYUVoutputsonly.OnlyifitissettoHDNONE,orleft undefinedwilltheprimaryinterfacefeedtheHDMI,CVBS,SVDIO,YUV/RGBoutputsatSDresolution. ThesecondaryinterfaceisusediftheprimaryinterfaceisfeedingHDoutputswithHDcontent.Inthiscase, theCVBS,SVIDEOandpossibly(seebelow)RGB/YUVouputswillbefedfromthesecondaryinterface.Video willbeseenonthisoutput,butnoGFX.
A.1.2
VIDEODACS
1 CVBS 2/3 SVideo 4/5/6 RGB/YUV
TheAmiNET130contains6videoDigitalAnloagueConverters(DACS):
RegardlessoftheOUTPUT_RESOLUTIONsetting,CVBS/SVideowillbeavailable,andHDwillbeavailablevia HDMI.HoweverifHDissettobeoutputasanaloguecomponent,thiswillusetheYUVDACS,thereforeSD YUV/RGBoutputfromthesecondaryinterfacewillnotbeavailableastheDACsusedforthishavebeen reassigned.
144
CONTENTS
INDEX
Appendix BSettings file contents
Thefollowingtabledescribesthesettingsavailableinthesettingsfile.Settingsaredescribedin alphabeticalorder.Notethatwhetherthesevaluesareuseddependsonthesoftwareandhardwarebuild. Defaultvalueslistedhereareusedifnovalueissupplied.Defaultvaluesareoftenbuildspecificthough,so maynotbeaslistedhere. Theexamplesshowhowtoenterthesettingifyouareusingthecommandlinefacility.SeeChapter6,Set topboxconfigurationpagesforFrescoandOpera8.5,Chapter7,SettopboxconfigurationpagesforOpera 9andAppendixG,Usingtheconfigurationtechniquesforinformationonhowtoentervaluesusingother means. Setting Allowedvalues usedtobringthe STBoutof standby. N=Onlythe powerbuttoncan beusedtobring theSTBoutof standby. AUD_SYNC_LIMITS Timedifference (secs)=<value>/ 90KHz Forexample 12000/90KHz= 133ms Description topboxoutofstandby. UseeitherY,NorNULL.Ifthevaluehasnotbeen set,usethedefaultvalue,N. Default:
N
ANY_KEY_STANDBY_RECOVER Y=Anykeycanbe Setswhichremotecontrolkeyscanbringtheset
Example:
libconfig-set SETTINGS.ANY_KEY_ STANDBY_RECOVER Y
Setstheallowabledifferences(aheadandbehind) betweentheaudioPresentationTimeStampand theincomingProgramClockReference,therefore limitingthetimedifferencebetweentheaudio andvideostreams. Default:

4050, 5310
Example:
libconfig-set SETTINGS.AUD_SYNC_ LIMITS 12000, 12000
INDEX
CONTENTS
145
Setting
AVSYNC_WAIT
Allowedvalues
Y=Enablewait. N=Disablewait.
Description Configureswhetherthechannelchangeswaitfor AVsyncbeforedisplaying. ThevaluecanbeoverriddenbysettingsintheURL. Ifthevaluehasnotbeenset,usethedefaultvalue.

Default: N Example: libconfig-set SETTINGS.AVSYNC_ WAIT Y
BROWSER_CONCEAL_STARTUP Y=Concealthe
Frescostartup sequence. N=Donotconceal theFrescostart upsequence.
SetswhethertheFrescobrowsersstartup sequenceisconcealedordisplayedonthescreen. Thefirstwebpagemustturntheupdatesbackon againinordertodisplayanythingonscreen. Frescobrowseronly.

Default: N Example: libconfig-set SETTINGS.BROWSER_ CONCEAL_STARTUP Y
BROWSER_ENABLECOOKIES
Y=Enable
cookies N=Disable cookies.
Enablesordisablescookies. Thissettingcannotbeaccessedvialibconfig.
Default: Y Example: libconfig-set SETTINGS.BROWSER_ ENABLECOOKIES N
BROWSER_HELPPAGE
URL
Setsthehelppage.ThisistheURLforthepage thatthebrowsergoestowhentheHelpkeyis pressed.

Default: Example: libconfig-set SETTINGS.BROWSER_ HELPPAGE http://www.aminocom.com/ help
BROWSER_HOMEPAGE
URL
Setsthehomepage.ThisistheURLforthepage thatthebrowsergoestowhentheHomekeyis pressedandwhenthesettopboxhasbooted successfully.

Default: about:/start.htm Example: libconfig-set SETTINGS.BROWSER_ HOMEPAGE http://www.aminocom.com
146
CONTENTS
INDEX
Setting
BROWSER_MARGIN_COLOUR
Allowedvalues
Description Setsthebrowsermargincolour.Thevaluemustbe astringcontainingTCRoranumericalhexRGB value(0xRRGGBB).

Default: Example: libconfig-set SETTINGS.BROWSER_ MARGIN_COLOUR 0x00ff00
BROWSER_MARGIN_LEFT BROWSER_MARGIN_RIGHT BROWSER_MARGIN_TOP BROWSER_MARGIN_BOTTOM
1100
Setsthebrowsermarginsasapercentage(%)of thegraphicsplanesize.Canalsobeapixelvalue, suffixedbypxonOperaGogi. Shouldbedefinedaspx(pixels)or%(percentage). Willnotworkwithoutbeingdefined. Validvaluesare0to100(for%)ortothedisplay width/heightforpx. Note: Settingthesevaluesto100wouldsetthe marginstocovertheentiregraphicsplane.
Default: Example: libconfig-set SETTINGS.BROWSER_ MARGIN_LEFT 20
BROWSER_RETRY
Y=Automatically Setswhetherapageisautomaticallyreloaded
reloadpage. N=Displayerror
whenthebrowserfailstoload,orwhetheran errorisdisplayedinstead. Note: Frescobrowseronly. Thissettingcannotbeaccessedvialibconfig.

Default: Example: libconfig-set SETTINGS.BROWSER_ RETRY Y
INDEX
CONTENTS
147
Setting
BROWSER_TRANSPARENCY
Allowedvalues
N, OFF, 0
Description Thisconfigureswhetherthebrowsercontrolsthe transparencyofpixelsitdraws.Whendisabled (thedefaultsetting)allpixelsareopaque,except thosematchingthecurrentkeycolourwhichare transparent.Whenenabled,transparencyis controlledbythebrowserandcanbesetby HTML/CSS.Inthisstatethekeycolourisignored andhasnoeffect. Supportforthisoptionisdependentonthe browser. ThisisonlysupportedbyOperaGogiwhen configuredfora32bppframebuffer.
Default: N Example: libconfig-set SETTINGS.BROWSER_ TRANSPARENCY Y
or
Y, ON, 1
BROWSER_UNLOAD_VIDEO
Y=Alwaysstop
video. N=Neverstop video.
Setsthedefaultforwhethervideoisstopped whenthepagechanges.Thesettingcanbeover writtenonaperpagebasisbytheHTMLpage. Thissettingcannotbeaccessedvialibconfig.

Default: Y Example: libconfig-set SETTINGS.BROWSER_ UNLOAD_VIDEO N
CC_OUTPUT_SOFTCC
Y=EnableSoft warerendered closedcaptions. N=Disablesoft warerendered closedcaptions.
Setswhethersoftwarerenderedclosedcaptions areenabled.
Default: Y Example: libconfig-set NORFLASH.CC_OUTPUT_SOFTCC Y
CC_OUTPUT_VBI
Y=EnableVBI closedcaptions. N=DisableVBI closedcaptions.
SetswhetherVBIclosedcaptionsareenabled.
Default: Y Example: libconfig-set NORFLASH.CC_OUTPUT_VBI Y
148
CONTENTS
INDEX
Setting
CC_PREFERENCE
Allowedvalues captionswilluse ATSCencapsula tion. SCTE=Theclosed captionswilluse SCTEencapsula tion.
Description used. Ifleftblank,closedcaptionswillusetheATSC encapsulation Default:

ASTC Example: libconfig-set SETTINGS.CC_ PREFERENCE ASTC
ASTC=Theclosed Setswhichclosedcaptionsencasulationshouldbe
CLOSED_CAPTION_SWAPPED
Y=Enable
(A103,110,110Hand500 only)
Setswhethersupportforclosedcaptiontypewith supportforclosed reordereddataisenabledordisabled(ifdisabled, captiontypewith thedefaultclosedcaptiontypeisused). reordereddata. Default: N=Keepusingthe N defaultclosed Example: captiontype.
libconfig-set SETTINGS.CLOSED_ CAPTION_SWAPPED Y
DEFAULT_VOLUME
0100
Setsthedefaultvolumethatthesettopboxuses whenitboots.Thismustbebetween MINIMUM_VOLUME and MAXIMUM_VOLUME.That is,0100.Youarerecommendednottochange thevaluefromthedefault.

Default: 100 Example: libconfig-set SETTINGS.DEFAULT_ VOLUME 80
DELAY_FACTOR
1=16csdelay. 2=32csdelay. 3=64csdelay. 4=96csdelay.
Setsthelengthoftimethatnecessaryforauserto holdakeydownonanIRinputdevice(e.g.the keyboard)inordertomakeitrepeat.

Default: 2 Example: libconfig-set SETTINGS.DELAY_ FACTOR 1
DISABLE_CAPTIONING_IN_ PIG
Ydisablecap tioninginPIG Nenablecap tioninginPIG
DisablesorenablescaptioninginPIG Default:
Y Example: libconfig-set SETTINGS.DISABLE_CAPTIONING_IN_PIGY
INDEX
CONTENTS
149
Setting
DISABLE_ERR_BOX
Allowedvalues
Y=Donotdisplay anerrorboxwhen thepagefailsto load. N=Displayan errorboxwhen thepagefailsto load.
Description Setswhetheranerrorboxisdisplayedifapage failstoload. Frescobrowseronly. Thissettingcannotbeaccessedvialibconfig.

Default: N Example: libconfig-set SETTINGS.DISABLE_ ERR_BOX Y
Frescobrowseronly.
DISPLAY_MODE
ConfigureshowthevideoisformattedfortheTV. 4:3aspectratioin Selectpanscanfortelevisionswhichdonothave panandscan automaticaspectratioswitching,andwhereyou presentation wantthevideoimagetofillthefull4:3screen.In mode. thismode,4:3contentfitsthescreencorrectly, letterbox andany16:9videocontentiscroppedontheleft 4:3aspectratioin andrightsides. letterboxpresen Selectletterboxfortelevisionswhichdonot tationmode. haveautomaticaspectratioswitching,andwhere widescreen youwanttodisplaythefull16:9content.Inthis 16:9aspectratio. mode,4:3contentfitsthescreencorrectly,and ignore any16:9contentisdisplayedinfull,withblack 4:3aspectratio barsaboveandbelowit. stretchedto16:9 Selectwidescreenfortelevisionswhichhave automaticratioswitching.Inthismode,the televisionswitchesbetween4:3and16:9depend ingonthevideocontent,andfullcontentisdis playedforboth. Selectignoretostretcha4:3aspectratioimage totheequivalentof16:9ratio.Thismaybeused, forexample,whenstretchinga4:3ratioimageto fillthescreenofawidescreentelevision.The imagewillappearsomewhatdistorted. Selectignoretoignoretheaspectratioofthe video,andassumethatitisthesameastheratio oftheoutput.Soon16:9display,a4:3imagewill appearverticallydistorted.Ona4:3display,a16:9 imagewillappearverticallydistorted. RefertoAminoTechnicalNote018AspectRatio HandlingandtheAminoTVStandardsGuidefor moreinformationonaspectratios.
panscan Default: panscan Example: libconfig-set SETTINGS.DISPLAY_ MODE widescreen
150
CONTENTS
INDEX
Setting
DOLBY_RF
Allowedvalues
0=Linemode. 1=RFmode.
Description SetstheDolbydynamicrangecontrol.Linemodeis lightcompressionsandRFisheavycompression.

Default: 0 Example: libconfig-set SETTINGS.DOLBY_RF 1
ENABLE_CC_OR_SUBS
NONE=ifTVSYS TEMisNTSCthen SoftCCwillrun, Dvbttxtwillnot. IfTVSYSTEMis PALthenDvbttx willrun,SoftCC willnot. SOFTCC=only runSoftCCregard lessofTVSYSTEM setting. DVBTTX=only runDvbttxregard lessofTVSYSTEM setting. BOTH=runboth SoftCCandDvbttx regardlessof TVSYSTEMsetting.
Y=Registerthe algorithm. N=Donotregister thealgorithm.
Setswhetherclosedcaptionsorsubtitlesareset, dependingonthevalueselectedandthetelevision systemtype. Default: NONE Example:

libconfig-set SETTINGS.ENABLE_CC_ OR_SUBS BOTH
ENABLE_NDS_AUTH
SetswhethertheNDSauthenticationdigest algorithmshouldberegistered. NDSbuildsonly. Thissettingcannotbeaccessedvialibconfig.

Default: Example: libconfig-set SETTINGS.ENABLE_ NDS_AUTH Y
ENABLE_TRUSTED_DOMAINS
Y=Anypagethat usesJMACXand/ orMacrovision callsmustbe checkedagainst thelistofknown trustedhosts. N=Execute JMACXand/or Macrovisioncalls toanywebpage.
Enableordisabletheuseoftrusteddomains.Ifthe useoftrusteddomainsisenabled,pagesthatuse JavaScriptorMacrovisionarecheckedagainstthe listoftrustedhosts.Iftrusteddomainsaredisa bled,thenJavaScriptandMacrovisioncallsmaybe executedfromanywebpage.

Default: N Example: libconfig-set SETTINGS.ENABLE_ TRUSTED_DOMAINS Y
INDEX
CONTENTS
151
Setting
EOS_KILLS_VIDEO
Allowedvalues
Y=Killvideoon event(default operationifnot specified). N=Donotkill videoonevent.
Description Usedtosetwhethervideoisautomaticallykilled onreceiptoftheRTSPANNOUNCEendofstream (EOS)event.

Default: Y Example: libconfig-set SETTINGS.EOS_KILLS_ VIDEO N
FULLSCREEN
Enablesordisablesfullscreenmode. N=Notfullscreen. Infullscreenmode,thebrowserwindowissetto 100%ofthevideoplane. Innonfullscreenmode,thebrowserwindowis setto90%(safearea),sothattheentirewindow willbevisibleonalltelevisions. Note: Thissettingisobsolete.Itisrecommended tosetthisto'Y'andcontrolthesizeofthebrowser windowbyusingtheBROWSER_MARGIN_settings.
Default: N Example: libconfig-set SETTINGS.FULLSCREEN Y
Y=Fullscreen.
GFX_RESOLUTION
nnnnXmmmm= Definesthe resolutionasnnnn pixelswideby mmmmpixels high. PAL=equivalent to720x576.

NTSC=
GFX_RESOLUTIONdefinestheresolutionatwhich
theGFXplaneisrendered. Thiscancauseconfusion,asevenwhenitissetto anSDresolution,ifaHDoutputisbeingused,no graphicswillbeseenontheSDoutputs.Thisis becausethesecondaryinterfaceisfeedingtheSD outputs,whichdoesnotrendertheGFXplane. Therangeofsupportedvalueswillbeplatform dependentandthusmaybeaffectedbythecur rent NORFLASH.OUTPUT_RESOLUTIONsetting.
equivalentto 720x480.
HD720=
equivalentto 1280x720.
Default: Example: libconfig-set SETTINGS.GFX_ RESOLUTION PAL
152
CONTENTS
INDEX
Setting
H264_VIDEO_DELAY
Allowedvalues
1to16
Description Therearevariousfactorsthataffectthechannel changetimesforIGMPstreams. Followingachannelchange,ifthepicturefroma streamwithprogressiveIframesisdisplayedtoo soonitwilltileuponthedisplay,causingchannel changeartefacts.Tocounteractthis,avideo displaychanneljoindelayvalueisappliedwhich delaysthedisplayofthepicture,attheexpenseof perceivedchannelchangetime.Differentvalues areappliedtoMPEG2andH264streams. Thecurrentdefaultvaluesoftheseare2for MPEG2and8forH264,howevertheseare configurablesothatthechannelchange performanceoftheSTBcanbeoptimised. Reducingthevalueswillreducethechannel changetimebutmaycausechannelchange artefactswithcertainstreams.Settingthevalueto 0willcausetheSTBtousethehardcodeddefault value.
Default: 8 Example: libconfig-set SETTINGS.H264_VIDEO_ DELAY 2
H264_VIDEO_TP_DELAY
1to16
Therearevariousfactorsthataffectthechannel changetimesforIGMPstreams. Followingachannelchange,ifthepicturefroma streamwithprogressiveIframesisdisplayedtoo soonitwillmacrobloackingonthedisplay,causing channelchangeartefacts.Tocounteractthis,a videodisplaychanneljoindelayvalueisapplied whichdelaysthedisplayofthepicture,atthe expenseofperceivedchannelchangetime.Differ entvaluesareappliedtoMPEG2andH264 streams. Thecurrentdefaultvaluesoftheseare2for MPEG2and8forH264,howevertheseare configurablesothatthechannelchange performanceoftheSTBcanbeoptimised. Reducingthevalueswillreducethechannel changetimebutmaycausechannelchange artefactswithcertainstreams.Settingthevalueto 0willcausetheSTBtousethehardcodeddefault value.
Default: 8 Example: libconfig-set SETTINGS.H264_VIDEO_ TP_DELAY 2
INDEX
CONTENTS
153
Setting
HDMI_AUDIO_FORMAT
Allowedvalues 0=Auto 1=PCM 2=SPDIF(Mirror SPDIFoutputbit stream)
Description ThetagtousewhenreadingorwritingtheHDMI audiobitstreamformatoptiontothesettingsfile.

Default: Example: libconfig-set SETTINGS.HDMI_AUDIO_ FORMAT 1
HTTP_PROXY
SetstheproxyserverforHTTPtransactions. EntertheIPaddressandportintheformat host:port,forexample:123.4.5.67:1234,or theaddresscanbegivenintheform hostname.domain:1234
Operabrowseronly.
Default: Example: libconfig-set SETTINGS.HTTP_PROXY 123.4.5.67:1234 HTTP_PROXY_IGNORE 0=Donotignore ConfigureaflagtoignorethecurrentHTTPproxy setting. theHTTPproxy. 1=Ignorethe HTTPproxy.
Operabrowseronly.
Default: 0 Example: libconfig-set SETTINGS.HTTP_PROXY_ IGNORE 1
HTTPS_PROXY
ConfiguretheproxyserverforHTTPStransactions. EntertheIPaddressandportintheformat host:port,forexample:123.4.5.67:1234 Operabrowseronly.

Default: Example: libconfig-set SETTINGS.HTTPS_ PROXY 123.4.5.67:1234
154
CONTENTS
INDEX
Setting
IGMP_END_TIMEOUT
Allowedvalues
030
Description Setsthenumberofseconds(withintherange0to 30)towaitwhenthevideohasbeenplayingand novideodataisseen.Ifthewaitformoredata extendspastthetimeout,thevideoplaybackis killedbytheSTB. Setto0 = Donottimeout.

Default: 30 Example: libconfig-set SETTINGS.IGMP_END_ TIMEOUT 15
IGMP_START_TIMEOUT
030
Setsthenumberofseconds(withintherange0to 30)towaitforthevideotostartafteraplaycom mandhasbeensent.Ifnovideoisseenbeforethe timeout,thevideoplaybackiskilledbytheSTB. Setto0 = Donottimeout.

Default: 30 Example: libconfig-set SETTINGS.IGMP_START_ TIMEOUT 15
IGMP_RETUNE_AFTER_TIME
SetsthetimeoutbeforetheIGMPretuneevent occursonastream(incentiseconds). IfthesameIGMPchannelisviewedforthisperiod oftime,thevideodecoderwillbereset automatically.(Valueslessthan360000(Ihour)or morethan259200000(onemonth)wouldbecon sideredunrealistic.) UsedontheA125butnottheSTplatform.

Default: 3 Example: libconfig-set SETTINGS.IGMP_ RETUNE_AFTER_TIME 200000000
IME
en=English. en_US = AmericanEnglish. el=Greek. ge=German. ru=Russian. sl=Slovenian. resetto automatic.
SpecifieswhichbuiltinIME(inputmethodeditor) languagetouse,specifiedusingISO6392notifica tion. Note: Changesrequireabrowserrestartoraset topboxrebootinordertotakeeffect. BydefaultnoIMEisenabled.

Default: Example: libconfig-set SETTINGS.IME ru
INDEX
CONTENTS
155
Setting
INITIAL_LED
Allowedvalues
ON=LEDison
Description Setstheinitialstateofthemain/IRLED,whenthe settopboxisactive(i.e.poweredandnotin standby) ForadescriptionoftheLEDconfigurationfor differentSTBssee"LEDConfigurationoperationvs STBproduct"onpage174.

Default: Example: libconfig-set SETTINGS.INITIAL_ LED ON
whentheboxisin normalpowered upstate. OFF=LEDisoff whentheboxisin normalpowered upstate.
IR_BRAND
0 15
DefinestheprefixexpectedwithintheIRsignal sentbyaremotecontrolinordertopairthe remotewithaparticularsettopbox.Thiscanbe usefulinlab/demoenvironmentswhenmultiple settopboxesmayreceivethesignalfroma remotecontrol. SeeAppendixI,PairinganIRremotecontrolwith asettopboxfordetailsofhowtopairaremote controlwithasettopbox.

Default: Example: libconfig-set SETTINGS.IR_BRAND 10
KEYMAP
us=US uk=UK el=Greek ge=German ru=Russian sl=Slovenian
Setsthelayoutforthekeyboard.Languagespeci fiedinISO639notation.
Default: Example: libconfig-set SETTINGS.KEYMAP us
LEGACY_SUBS
Y=Useoldbehav Thenewbehaviourisdefinedashavingsubtitles
iour. N=Usenew behaviour.
displayedonasecondframebufferontopofthe browsergraphics.ThismeansthattheSTBcan displaysubtitlesandbrowsergraphicsatthesame time.Theoldbehaviourisdefinedasdisplaying eitherbrowsergraphicsorsubtitles.

Default: N Example: libconfig-set SETTINGS.LEGACY_ SUBS Y
156
CONTENTS
INDEX
Setting
LINKSTATE_FAIL_ THRESHOLD
Allowedvalues
Description Thenumberoffailedlinkstatechecksbeforean actionspecifiedbythelinkstatewatchdogtoolis executed(forexample,areboot). Settingthistozerodisablesthelinkstatewatch dog.

Default: 10 Example: libconfig-set SETTINGS.LINKSTATE_ FAIL_THRESHOLD 3
LINKSTATE_TIMEOUT
Thetimeinsecondsbetweenlinkstatechecks. Settingthistozerodisablesthelinkstatewatchdog tool.

Default: 60 Example: libconfig-set SETTINGS.LINKSTATE_ TIMEOUT 10
MANAGEMENT_PREFIX
SpecifieswhereSTBremoteconfshouldlookfor managementpages(rebooting.htmland upgrading.html). file://opt/ Certainbrowserbuildsrestrictaccesstothe/etc htdocs workson directory,somakingacalltoSTBremoteconfto Frescobuilds. reboottheSTB,whichwilltrytodisplaythe rebooting.html page,maynotwork.Thepre http://<webserver>/ fixallowsSTBremoteconftoknowifitshould <pages>willload readmanagementpagesdirectlyfrom/etcor rebootisomewhereelse. ing.html and Default:
upgrading.htmlfroma file://etc Example: libconfig-set SETTINGS.MANAGEMENT_ PREFIX file://opt/htdocs
file://etc worksonOpera builds.
remoteserver location.
MAXIMUM_VOLUME 0100
Setsthemaximumvolume.
Default: 100 Example: libconfig-set SETTINGS.MAXIMUM_ VOLUME 100
INDEX
CONTENTS
157
Setting
MAX_PCR_PTS_BUFFERING
Allowedvalues
0orbetween 60000540000
Description Thevalueofthevariablenisanintegerwhichcan be0orbetween60000and540000. nisthemaximumtimebufferingallowedinterms ofPCRPTS. Itisexpressedin90kHzunits,so90000=1s. Recommendedvaluestotestareintherange15s (90000to450000). Note: Afterthesettingtheboxhastoberebooted toallowthevaluetobeeffective.Thesettingisnot normallypreservedbyupgrade.
Default: n=0meansnomaximumbufferingtime
(A125only)
set(default).
Example: libconfig-set SETTINGS.MAX_PCR_ PTS_BUFFERING 90000
or
libconfig-set SETTINGS.MAX_PCR_ PTS_BUFFERING 0 MIDWARE_KEY_IDLE_ TIMEOUT 0 -32768
Thisisthelengthoftimeincentisecondsallowed betweenkeypressesbeforedecidingthattheinput sequencehascompleted.Forexample,Browser OSDforchannelchanging,orphonenumberentry, IMEuse,andsoon. Setto0 = Donottimeout.

Default: 2000 Example: libconfig-set SETTINGS.MIDWARE_ KEY_IDLE_TIMEOUT 250
MINIMUM_VOLUME
0100
Setstheminimumvolume.
Default: 0 Example: libconfig-set SETTINGS.MINIMUM_ VOLUME 20
158
CONTENTS
INDEX
Setting
MPEG2_VIDEO_DELAY
Allowedvalues
1to16
Description Therearevariousfactorsthataffectthechannel changetimesforIGMPstreams. Followingachannelchange,ifthepicturefroma streamwithprogressiveIframesisdisplayedtoo soonitwilltileuponthedisplay,causingchannel changeartefacts.Tocounteractthis,avideo displaychanneljoindelayvalueisappliedwhich delaysthedisplayofthepicture,attheexpenseof perceivedchannelchangetime.Differentvalues areappliedtoMPEG2andH264streams. Thecurrentdefaultvaluesoftheseare2for MPEG2and8forH264,howevertheseare configurablesothatthechannelchange performanceoftheSTBcanbeoptimised. Reducingthevalueswillreducethechannel changetimebutmaycausechannelchange artefactswithcertainstreams.Settingthevalueto 0willcausetheSTBtousethehardcodeddefault value.
Default: 2 Example: libconfig-set SETTINGS.MPEG2_ VIDEO_DELAY 2
(HDproductsony)
MPEG2_VIDEO_TP_DELAY
1to16
(HDproductsony)
Therearevariousfactorsthataffectthechannel changetimesforIGMPstreams. Followingachannelchange,ifthepicturefroma streamwithprogressiveIframesisdisplayedtoo soonitwilltileuponthedisplay,causingchannel changeartefacts.Tocounteractthis,avideo displaychanneljoindelayvalueisappliedwhich delaysthedisplayofthepicture,attheexpenseof perceivedchannelchangetime.Differentvalues areappliedtoMPEG2andH264streams. Thecurrentdefaultvaluesoftheseare2for MPEG2and8forH264,howevertheseare configurablesothatthechannelchange performanceoftheSTBcanbeoptimised. Reducingthevalueswillreducethechannel changetimebutmaycausechannelchange artefactswithcertainstreams.Settingthevalueto 0willcausetheSTBtousethehardcodeddefault value.
Default: 6 Example: libconfig-set SETTINGS.MPEG2_ VIDEO_TP_DELAY 2
INDEX
CONTENTS
159
Setting
Allowedvalues
Description
NATIVE_FRAMERATE_PASSTH Y=Enablenative RU_ENABLE frameratepass
Whenthisissettheframerateofthevideooutput willbesettomatchtheframerateofthevideo (A130,130H,130M,530only) through. beingplayed,temporarilyoverridingtheuserpref (HDproductsonly) N=Disablenative erencesetting,ifthisisdifferent. Default: frameratepass through.
Example: libconfig-set SETTINGS.NATIVE_ FRAMERATE_PASSTHRU_ENABLE N
Usedtoenabletemporaryswitchingofoutputres (A130,130H,130M,530only) passthrough. olutiontoSDwhenplayingSDvideo,whenthe (HDproductsonly) N =Disablenative outputresolutionissettoHD. Default: passthrough.

NATIVE_PASSTHRU_ENABLE Example: libconfig-set SETTINGS.NATIVE_ PASSTHRU_ENABLE N NTPCLIENT_TIMEOUT
Y=Enablenative
SetstheNTPclienttimeoutinseconds.
Default: Example: libconfig-set SETTINGS.NTPCLIENT_ TIMEOUT 10
ONSCREEN_KBD_RAISE
1 -80
Usedtosetwhichremotecontrolbuttonwillraise theonscreenkeyboard. Validvaluesareintherange1 - 80.

Default: Example: (tosetthebluebutton) libconfig-set SETTINGS.ONSCREEN_ KBD_RAISE 23
OPERA_HTTP_AUTHENTICATI ON_DOMAINS
AlistofdomainsthatallowNDSauthentication separatedbyspace,orNULLifnolisthasbeen defined. Operabrowseronly. Thissettingcannotbeaccessedvialibconfig.

Default: Example: libconfig-set SETTINGS.OPERA_HTTP_ AUTHENTICATION_DOMAINS aminocom.com nds.com
160
CONTENTS
INDEX
Setting
PLT_START_DELAY
Allowedvalues Anunsigned integerinrange from0to60.
Description UsedtosetthePLTstartdelay(inseconds).Sets thenumberofsecondsafterstreambeginbefore thePLTbufferisstarted. Note: IfthevalueofPLT_START_DELAYis0(zero) ornotset,PLTbufferingisdisabled.

Default: Not set (PLT disabled by default) Example: libconfig-set SETTINGS.PLT_START_ DELAY 5
(ValidforPVRcapable platformsonly)
PLT_SPOOLTIME (ValidforPVRcapable platformsonly)
Anunsigned ThemaximumlengthofthePLTbufferinminutes. integerinrange Default: from10to1440. 60

Example: libconfig-set SETTINGS.PLT_ SPOOLTIME 60 010
POD_SENSITIVITY
Theremotesendsasignalevery10centiseconds, thissettingconfigureshowmanysignalsare requiredbeforethemousemoves.Henceasetting of2willindicatethattwosignalsneedtobe receivedbeforethemousemoves.

Default: Example: libconfig-set SETTINGS.POD_ SENSITIVITY 5
PREFERRED_CAPTIONING_ SYSTEM
NONE=default select SOFTCC=select SoftCCoutputby defaultifbothsys temsarerunning. DVBTTX=select Dvbttxoutputby defaultifbothsys temsarerunning
Setsapreferredcaptioningsystem(eitherSoftCC orDvbttx)ifbothsystemsareavailable.
Default:
NONE Example:
libconfig-set SETTINGS.PREFERRED_ CAPTIONING_SYSTEM SOFTCC
INDEX
CONTENTS
161
Setting
PREF_HD_ RESOLUTION
Allowedvalues
576PPAL 480pNTSC 720P 1080I
Description Usedtostorethepreferredoutputresolutionto switchtowhenautomaticoutputresolutionis enabled.(whentheNORFLASH. OUTPUT_RESOLUTIONsettingisunsetorisset toHDAUTO)

Default:
720P Note:thissetting isclearedafter Example: videorecovery libconfig-set SETTINGS.PREF_HD_ andresetto RESOLUTION 576p HDAUTO PREFERRED_LANG
ISO6392 languagecode
Setsthepreferredaudiolanguagefromavideo stream. Settoforautomaticlanguageselection.

Default: None Example: libconfig-set SETTINGS.PREFERRED_ LANG fr
PREFILL_DECODER_BUFFERS Y=Prefillthe
(A103,110,110Hand500 only)
buffer. N=Donotprefill thebuffer.
Configureswhetherthevideobufferisprefilled beforevideoisplayed. Thissettingcannotbeaccessedvialibconfig.

Default: N Example: libconfig-set SETTINGS.PREFILL_ DECODER_BUFFERS Y
PVR_SPOOLTIME
(ValidforPVRcapable platformsonly)
Anunsigned ThemaximumlengthofthePVRbufferinminutes. integerinrange Themaximumlengthofrecordingallowed. from60to1440. Default:

1440 if not set Example: libconfig-set SETTINGS.PVR_ SPOOLTIME 180
RCIME_DEFLANG
DefaultlanguagefortheremotecontrolIME.
Default: None. Example: libconfig-set SETTINGS.RCIME_ DEFLANG fr
162
CONTENTS
INDEX
Setting
RCIME_DEFMODE
Allowedvalues
uppercase=
Description RemotecontrolIMEdefaultmode.
Default: lowercase Example: libconfig-set SETTINGS.RCIME_ DEFMODE numerics
treatremote numberkeysas uppercase characters.

lowercase=
treatremote numberkeysas lowercasecharac ters.

numerics=
treatremote numberkeysas numbers.

RCIME_TIMEOUT 1999
Usedtoconfigurethetimeoutforakeypresswhen usingRemoteControlIMEmode(FrescoIME buildsonly).

Default: 999 Example: libconfig-set SETTINGS.RCIME_ TIMEOUT 30
REMOTE_LAYOUT
Default Hospitality Myrio Think TotalVision VillaFontaine
Guide GuestTek GETC Sejinalt Myrio2think RAW IPaddress
SetsthedefaultIRremotecontrollayout.Different remotelayoutsspecifyhowcertainkeysonthe remotecontrolareinterpreted. Customerspecificlayoutvaluesalsoexist. See"Remotelayoutoptions"onpage173forfur therinformation. See"Volumecontrol"onpage174fordetailsof controllingthevolumeusingtheIRremote.

Default: NULL Example: libconfig-set SETTINGS.REMOTE_ LAYOUT Hospitality
REMOTECONF
SetsthemulticastIPaddressthatthesettopbox listensonforSTBremoteconfcommands.
Default: 225.10.10.10 Example: libconfig-set SETTINGS.REMOTECONF 234.56.78.9
INDEX
CONTENTS
163
Setting
REMOTECONFPORT
Allowedvalues
0 65535
Description Setsthemulticastportthatthesettopboxlistens onforSTBremoteconfcommands.

Default: 22222 Example: libconfig-set SETTINGS.REMOTECONF PORT 12345
REPEAT_RATE
0=Donotrepeat anykeys 130repeatrate (incs)
Setsthekeyrepeatrateincentiseconds,tocontrol thenumberofcharacterspersecondthatauser canenterviaanIRinputdevice(e.g.thekey board). 0indicatesnokeyrepeat.

Default: 8 Example: libconfig-set SETTINGS.REPEAT_ RATE 0
RFBOOST_DOLBY
Y=EnableDolby SetswhetherDolbyaudiolevelboostingisenabled ordisabled. boosting. N=DisableDolby Default: boosting. N Example: libconfig-set SETTINGS.RFBOOST_ DOLBY Y
RFBOOST_MPEG
SetswhetherRFaudiolevelboostingisenabledor audiolevelboost disabled. ing. Default: N=DisableRF N audiolevelboost Example: ing.

Y= EnableRF libconfig-set SETTINGS.RFBOOST_ MPEG Y
RTSP_BASE_PORT
1 65535
SetstheinitialRTSPUDPvideoportnumberthe settopboxistouse.Bydefault,thesettopbox startsat11111andincreasesinincrementsof10.

Default: 554 Example: libconfig-set SETTINGS.RTSP_ BASE_PORT 1234
164
CONTENTS
INDEX
Setting
RTSP_DESTINATION
Allowedvalues
Y=Includethe
Description Setswhethertoincludethedestinationoptionin RTSPTransportrequestheaders. IfY,theRTSPsetupwillcontainthedestina tion=<local IP address>. SetthevaluetoNtoworkwithaNATrouter. IfsettoNitwillremovethisdestination=option fromtheheaderandtheRTSPserverwillreplyto thesourceIPaddress. IftheSTBisbehindaNATrouterthenthesourceIP addresswillbetheNATserveranditwillbe routed.
Default: Y Example: libconfig-set SETTINGS.RTSP_ DESTINATION Y
destination option. N=Donotinclude thedestination option.
RTSP_END_TIMEOUT
030
Setsthenumberofsecondsbeforeanendof mediaeventisraisedforRTSPvideo. Set0 fornevertimeout.

Default: 6 Example: libconfig-set SETTINGS.RTSP_END_ TIMEOUT 15
RTSP_PING_TIMEOUT
030
SetsthedefaultRTSPserverpingtimeouttouse Whenundefinedordefinedas0,adefaultvalue willbeusedfortheRTSPpingtimeout.

Default: Example: libconfig-set SETTINGS.RTSP_PING_ TIMEOUT 15
RTSP_SCALE
1 6
Thedefaultfastforwardandrewindmultiplier. Ascaleof2.0willpresentthestreamsuchthatyou moveforwardthroughthestreamtwiceasfast. RTSPspeedgivesthewholedatastreamatthat speed.A4Mbit/sstreamatascaleof2.0givesthe wholestreamat8Mbit/s.

Default: 1 Example: libconfig-set SETTINGS.RTSP_ SCALE 2
INDEX
CONTENTS
165
Setting
RTSP_SERVER
Allowedvalues
ncube mediabase oracle concurrent bitband infovalue seachange eona smartvision 0 - 30
Description Setsthedefaultvideoservertype.
Default: ncube Example: libconfig-set SETTINGS.RTSP_ SERVER mediabase
RTSP_START_TIMEOUT
Setsthenumberofsecondsbeforeanovideo eventisraisedforRTSPvideo. Setto0 = Donottimeout. Default:

4 Example: libconfig-set SETTINGS.RTSP_START_ TIMEOUT 15
SECONDARY_LANG
Thesecondaryaudiolanguagefromavideo streamselection. Setforautomaticlanguageselection.

Default Example: libconfig-set SETTINGS.SECONDARY_ LANG fr
SELECT_RTSP_STREAM_BY_ PORT_ONLY
Y=selects streambyport only N=selects streambyIP address
IfVODserverssendvideodatawithasourceIP addressdifferenttothatfromtheircontrolIP address(ie.theIPaddressyouusetocontrolit overRTSP),andtheydonottelltheSTBthisin theirresponsetotheSETUPcommand,thenvideo willnotplay. SettingthiscommandturnsofftheIPaddress check.ReboottheSTBforittotakeeffect(theset tingwillbelostifyouupgradetheSTBagain.) Tohavethiscommandintheupgradeimage,edit thesettingsfilebyaddingthefollowingline:
SELECT_RTSP_STREAM_BY_PORT_ONLY="Y"
Createthemc2upgradeimageandupgradethe STBwiththatimage.
Default Example: libconfig-set SETTINGS.SELECT_RTSP_ STREAM_BY_PORT_ONLY Y
166
CONTENTS
INDEX
Setting
STANDBY_LED
Allowedvalues
ON=Onin standbystate. OFF= Offin standbystate.
Description SetsthestateofthestandbyLEDwhenthesettop boxisinstandby. ForadescriptionoftheLEDconfigurationfor differentSTBssee"LEDConfigurationoperationvs STBproduct"onpage174.

Default: Example: libconfig-set SETTINGS.STANDBY_ LED OFF
STBRCPORT
065535
SetstheunicastportthattheSTBremoteconf daemonlistensonforSTBremoteconf commands.

Default: 22222 Example: libconfig-set SETTINGS.STBRCPORT 12345
STC_OFFSET
(HDproductsonly)
10000to40000
TheSystemTimeClock(STC)offsetisthevaluein 90KHzticksbywhichtheSTCisoffsetfromthe ProgrammeClockReference(PCR).Theoffset determinesthesizeofthedatabufferwhichneeds tobesetsoastoavoiddataunderrunoroverrunas theresultofnetworkjitter.TheSTCoffsethasa consequentialeffectonthechannelchangetime; theshortertheoffsettheshorterthechannel changetime.Howeverthismustbebalanced againstthepossibilityofdataunderrunasthe resultofasmallerbuffer. ThecurrentSTCoffsetvalueis-10000andthisis nowconfigurable.Thechannelchangetimecanbe reducedbyapproximately100msforeverySTC offsetdecreaseof10000,howevertheoffset shouldnotbesmallerthan-10000.
Default: -10000 Example: libconfig-set SETTINGS.STC_OFFSET -10000
INDEX
CONTENTS
167
Setting
SUBTITLES_OPTION
Allowedvalues
Description
Y=Turnsubtitles Setsthemodeofthesubtitles. on. Default: 1=Turnsubtitles N
on.
N=Turnsubtitles
Example: libconfig-set SETTINGS.SUBTITLES_ OPTION H
off.
0=Turnsubtitles
off.
H=Turnonsubti
tlesforthehear ingimpaired (dependanton build).

SUBTITLES_PREF_LANG
ISO6392 languagecode.
Setstheprimarylanguagefordefaultsubtitle display. Setforautomaticlanguageselection.

Default: Example: libconfig-set SETTINGS.SUBTITLES_ PREF_LANG fr
SUBTITLES_SECOND_LANG
Setsthesecondarylanguagefordefaultsubtitle display. Setforautomaticlanguageselection.

Default: Example: libconfig-set SETTINGS.SUBTITLES_ SECONDARY_LANG fr
SYSLOG_REMOTE_ADDR
TheIPaddressofthenetworksyslogserver.An addressmustbespecifiedbeforeremotelogging canbeenabled. Afterchangingthissettings,therc.syslogd scriptmustbeexecutedwiththerestart commandforthechangestotakeeffect.

Default: Example: libconfig-set SETTINGS.SYSLOG_REMOTE_ADDR 123.45.67.89
168
CONTENTS
INDEX
Setting
SYSLOG_REMOTE_PORT
Allowedvalues
Description Theportnumberofthenetworksyslogserver.If notspecified,thedefault514portnumberwillbe used. Afterchangingthissettings,therc.syslogd scriptmustbeexecutedwiththerestart commandforthechangestotakeeffect.

Default: 514 Example: libconfig-set SETTINGS.SYSLOG_REMOTE_PORT 100
SYSLOG_REMOTE_LOG_TIME
UNTIL:XXX whereXXXisa numberofsec onds(sinceepoch 00:0001/01/ 1970).Thisallows anabsolutetime tobespecified.
Controlsifandwhenremoteloggingis automaticallydisabled.Ifnothingisspecified, remoteloggingwillbeenableduntilitismanually disabled. Thedisabletimecanbespecifiedintwoformats:

UNTIL:XXX FOR:XX whereXXXisanumberofseconds.
Thisallowsarelativetimefromremotelogging
FOR:XXXwhere beingenabledtobespecified.IftheSTBreboots XXXisanumber afterremoteloggingisstartedwitha300second
ofseconds.
delay,theloggingtimewillstartat300seconds whentheSTBbootsagain. Afterchangingthissettings,therc.syslogd scriptmustbeexecutedwiththerestart commandforthechangestotakeeffect.

Default: Example: libconfig-set SETTINGS.SYSLOG_REMOTE_LOG_TIME FOR:300
SYSLOG_REMOTE_LOG_ENABL Y=enable. ED N=disable.
Controlswhethertheremoteloggingisenabled(Y) ornot(N). Afterchangingthissettings,therc.syslogd scriptmustbeexecutedwiththerestart commandforthechangestotakeeffect.

Default: N Example: libconfig-set SETTINGS.SYSLOG_REMOTE_LOG_ENABLE Y
INDEX
CONTENTS
169
Setting
TELETEXT_FULLSCREEN
Allowedvalues
Y=enablefull
Description
Enablesordisablesteletextfullscreenoperation. screenoperation. (Operasubtitlebuildsonly.) N=disablefull screenoperation. Default:

Y Example: libconfig-set SETTINGS.TELETEXT_ FULLSCREEN N
TEXT_ENTRY
1=Enabletext
entry.
0=Disabletext
entry.
Enablesordisablesremotetextentryviathe remotecontrol.Iftextentryisenabled,theuser enterstextbyholdingdowntheappropriate numberkey.

Default: Example: libconfig-set SETTINGS.TEXT_ ENTRY 1
TOOLBAR_STATE
1=Toolbaris
Setsthedefaultforwhetherthebrowserstoolbar visible. isvisibleornotwhenthesettopboxboots.This 0=Toolbarisnot canbeoverriddenbysettingsforindividualpages. Default: visible.

1 Example: libconfig-set SETTINGS.TOOLBAR_ STATE 1
TVI_TYPE
0=Philips 1=Zenith 2=LG 3=Mate(Sony/ Panasonic) 4=TVLink 5=Generic 6=Samsung
ConfigureswhichTVtypetheTVIinterfaceneeds touseontheprogrammableinterfacecontroller (PIC). Hospitalityplatformsonly.

Default: Example: libconfig-set SETTINGS.TVI_TYPE 0
UDP_END_TIMEOUT
0 30
Thisconfigureshowlongtowaitforthevideoto startwhenvideohasbeenplayingandnovideo dataisseen.Ifnovideoisseenbeforethetimeout (inseconds)thenthevideoplaybackiskilledbythe STB. Setto0=Donottimeout.

Default: Example: libconfig-set SETTINGS.UDP_END_ TIMEOUT 15
170
CONTENTS
INDEX
Setting
UDP_START_TIMEOUT
Allowedvalues
0 30
Description Thisconfigureshowlongtowaitforthevideoto startafteraplaycommandhasbeensent.Ifno videoisseenbeforethetimeout(inseconds)then thevideoplaybackiskilledbytheSTB. Setto0 = Donottimeout.

Default: Example: libconfig-set SETTINGS.UDP_START_ TIMEOUT 15
UI_LANG
SetstheIMEUIlanguagetouse.
Default: Example: libconfig-set SETTINGS.UI_LANG fr
USB_SPEED
=Useautode
tection.
lowspeed=
ConfigureswhethertheUSBinterfaceshouldauto negotiateaspeedwithaclient(default)orwhether itshouldbelimitedtoaparticularspeed. FortheTiradongle,thismustbesettolowspeed. Ifyouaresettingthisvialibconfig,youwillneed torebootthesettopboxinorderforthesettingto takeeffect.

Default:
1.5Mbits/s (USB1).
fullspeed=
12Mbits/s (USB1).
highspeed=
480Mbits/s(USB 2only). Example: libconfig-set SETTINGS.USB_SPEED lowspeed USB_TIMEOUT
Configuresthenumberoftimeoutsneededto triggerasettopboxreboot.
Default: Example: libconfig-set SETTINGS.USB_ TIMEOUT 3
INDEX
CONTENTS
171
Setting
USE_PROXY
Allowedvalues
Y=EnableHTTP proxy. N=DisableHTTP proxy.
Description EnablesordisablestheuseofHTTP,HTTPsandFTP proxyservers. Operabrowseronly.ForFresco,thisissetinthe browserssettingsfile.

Default: N Example: libconfig-set SETTINGS.USE_PROXY Y
USER_AGENT_STRING
Astringofupto 60charactersin length.
Appendsa60characterASCIIstringtotheuser agentstring.Thisfeaturecanbeclearedbysetting anemptystring. Note: MakingthischangewillrequiretheSTBtobe rebootedforthechangetotakeeffect.

Default: Example: libconfig-set SETTINGS.USER_ AGENT_STRING Aminotech
172
CONTENTS
INDEX
B.1
Remotelayoutoptions
Layout
Default Hospitality
Thesearetheoptionsforlibconfig-set SETTINGS.REMOTE_LAYOUT. Description Thedefaultlayout. Asthedefaultlayoutbutwiththefollowingchanges:

Think Totalvision
CH_UP/CH_DOWNandnumberbuttonsbecome TVPOWER. TVPOWER/STBbecomeHOME. VID_PLAYbecomesVID_PLAYPAUSE.
ThisisthedefaultsettingontheH140,110HandA130H DefaultsettingforallAminoMinervabuilds. Asdefaultwiththefollowingchanges:

Myrio Guide GuestTek
CH_UP/CH_DOWNbecomeTVPOWER TVPOWER/STBbecomeHOME REDbecomesVID_REVERSE GREENbecomesVID_PLAYPAUSE YELLOWbecomesVID_STOP BLUEbecomesVID_FORWARD CH_UP/CH_DOWNbecomeTVPOWER TVPOWER/STBbecomeHOME
Villafontaine Asthedefaultlayoutwiththefollowingchanges:
TooperatetheSTBusingaMyrioremotecontrol. Asthedefaultlayoutbutmapsthe/tobeanEPGkey AffectsSejinkeyboardremoteonly inthefollowingways: RightmousebuttonwillsendaCIR_BTN_RIGHT_MOUSEkey pressregardlessofthemousebeinghiddenornot. BookmarksbecomesVol+. HelpbecomesVol-. ToolbarbecomesCH+. InsbecomesCH-. Delbecomespower.
CETC Sejinalt Myrio2think
DefaultsettingforallCETCbuilds. AlternativeSejinremotesprovidedbyKoolconnect. UsedforMyrioUEISejinremotestomapkeystoMinervathink codes. SendsunmappedkeycodesfromtheRCU,allowingcustomRCUsto beconfiguredasrequired.
RAW
INDEX
CONTENTS
173
B.2
LEDConfigurationoperationvsSTBproduct
SETTINGS.STANDBY_LEDvaluehasnoeffectonLEDswhentheSTBisin"active"mode.Itonlyhaseffect whenSTBisin"standby"mode.SETTINGS.INITIAL_LEDvaluehasnoeffectonLEDswhentheSTBisin
"standby"mode.ItonlyhaseffectwhenSTBisin"active"mode.
B.2.1
STB
STBinACTIVEmode
SETTINGS.INITIAL_LEDvalue unsetor"" ON MainLEDON MainLEDOFF StandbyLEDGREEN "on" ON MainLEDON MainLEDON StandbyLEDGREEN "off" OFF MainLEDOFF MainLEDOFF StandbyLEDGREEN
SingleLEDSTBs* A500 A530
*singleLEDSTBsare:A103,A110,A110H,A125,A130,A130HandA130M
B.2.2
STB
STBinSTANDBYmode
SETTINGS.STANDBY_LEDvalue unsetor"" OFF MainLEDOFF MainLEDOFF StandbyLEDRED "on" ON MainLEDON MainLEDOFF StandbyLEDRED "off" OFF MainLEDOFF MainLEDOFF StandbyLEDRED
SingleLEDSTBs* A500 A530
*singleLEDSTBsare:A103,A110,A110H,A125,A130,A130HandA130M
B.3
Volumecontrol
Underdefaultconditions,theAminoremotewillsendoutTVcommandsforthevolumecontrol+/functions. TheAVCremotecanbeconfiguredtoemitkeycodesforthevolumekeysusingtheAminoIRprotocol,which allowsthemworkcorrectlywiththeAmiNET130andnewerSTBs,andalsowithanyotherSTBthatsupports theAVCremote. ToconfiguretheAVCremotetoemitnativeAminocodesequencesforthevolumekeys,pressandholdthe STBbuttonuntiltheSTBbuttonflashes. If9,9,3,VolumeUpisnowpressed,theremotewillemitcodesfortheSTBinallmodes. If9,9,3,VolumeDownisnowpressed,theremotewillemitcodesfortheSTBinthecurrentmode(eg.TV iftheTVmodewasselectedpriortoenteringprogrammingmode) If9,9,3,Modeisentered,thiswillcausetheremotetoemitvolumecodesfortheselecteddeviceinthe currentlyselectedmode.
ThefactorydefaultistoemitcodesfortheTVcodesetwhilstinSTBmode. Operawillnowseethefollowingkeycodes: 8495(VolumeUP)
174
CONTENTS
INDEX
8496(VolumeDOWN)
TheAudioControl.SetVolume() /GetVolume()JMACXcallscouldthenbeusedtoimplementavolume control.Actioncodes41and42infkeys.confcouldalsobeused(seeFunctionkeysfile),butthiswouldnot allowforanyvisualfeedbackbyreturningthecurrentlysetvolume.
INDEX
CONTENTS
175
176
CONTENTS
INDEX
Appendix CNetconf file contents
Thefollowingtabledescribesthesettingsavailableinthenetconffile.Notethatwhetherthesevaluesare useddependsonthesoftwareandhardwarebuild.Forconveniencethevaluesarelistedinalphabetical order. Defaultvalueslistedhereareusedifnovalueissupplied.Inmanycases,thedefaultvalueisbuildspecific,so maynotbeasspecifiedhere. Theexamplesshowhowtoenterthesettingifyouareeditingthenetconffiledirectly(notethatthevalues areallenclosedinquotationmarks).Seetheappropriatedocumentationforinformationonhowtoenter valuesusingothermeans(forexample,JMACXorlibconfigviaTelnet)

NOTE
ThevaluesinthistableareusedifUSE_NORissettoYinthenetconffile.
Setting
DHCP
Allowedvalues
Y=Alwaysuse
Description Configureswhethernetworkconfigurationiscar riedoutbycontactingaDHCPserver.Thisvalueis usedifUSE_NORissettoYinthenetconffile.Note thatifDHCPissettoN,themulticastupgradeval uesandothersettingsarereadfromthesettings listedinthistable(e.g.theMULTICAST_<name> settings).

Default: Y Example: libconfig-set NETCONF.DHCP Y
DHCP N=Donotuse DHCP
DHCPTIMEOUT
Timeinseconds Setshowlong(inseconds)theDHCPtimeoutvalue passedasastring shouldbebeforeanewrequestismade.

Default: Example: libconfig-set NETCONF.DHCPTIMEOUT 3600
INDEX
CONTENTS
177
Setting
DNS
Allowedvalues validIPaddress
Description TheDomainNameSystem(DNS)associatesvarious informationwithdomainnames;mostimportantly, itservesasthe"phonebook"fortheInternetby translatinghumanreadablecomputerhostnames, e.g.www.example.com,intoIPaddresses,e.g. 208.77.188.166,whichnetworkingequipments needtodeliverinformation.

Default: Example: libconfig-set NETCONF.DNS 208.77.188.166
DOMAIN
Specifiesadomainforthesettopbox.
Default: Example: libconfig-set NETCONF.DOMAIN aminocom.com
GATEWAY
validIPaddress
Thetagtousewhenreadingthegatewayvalue fromtheDCHCPreply.
Default: Example: libconfig-set NETCONF.GATEWAY aminocom.com
IGMP_FAST_LEAVE
YuseIGMPfast EnablesordisablesIGMPfastleavesupport.With leave IGMP_FAST_LEAVEdisabled,whenahostisno Ndonotuse
IGMPfastleave
longerisinterestedintrafficfromagroup(for example,duetoachangeinchannel),thenitstops replyingtothegroupquerythatissentoutbythe router. However,thismaybemanysecondslater,sothe routerwillcontinuesendingunnecessarilytothe uninterestedhost.WithIGMP_FAST_LEAVEena bled,whenthehostleavesagroup,itsendsan IGMP_FAST_LEAVEmessagetotherouterwhich thenissuesagroupqueryimmediatelytoseeifany bodyelseisinterestedonthesubnet. FastleavesupportrequiresallotherIGMPdevices onthesamenetworktoimplementfastleave.
Default: Example: libconfig-set NETCONF.IGMP_FAST_ LEAVE Y
178
CONTENTS
INDEX
Setting
IGMP_MAX_VER
Allowedvalues
1=IGMPv1 2=IGMPv2 3=IGMPv3
Description GetsthemaximumversionofIGMPwhichissup portedbytheSTB.

Default: 2. Example: libconfig-set NETCONF.IGMP_MAX_VER 3
IPADDR
ValidIPaddress.
ConfiguresthestaticIPaddressofthesettopbox. ThisisthevalueusedifDHCPissettoN.
Default: Example: libconfig-set NETCONF.IPADDR 123.45.6.7
NETMASK
ValidIPaddress.
Specifiesthestaticnetmaskforthesettopbox.This isthevalueusedifDHCPissettoN(orifthesettop boxcannotretrieveanIPaddressfromtheDHCP server).

Default: Example: libconfig-set NETCONF.NETMASK 255.255.0.0
PACKET_ORDERING
Y=usepacket
Enablesordisablestheuseofpacketordering.
Default: Example: libconfig-set NETCONF.PACKET_ ORDERING Y
ordering. N=donotuse packetordering.
TIME_SERVER
validIPaddress
Atimeserverisaservercomputerthatreadsthe actualtimefromareferenceclockanddistributes thisinformationtoitsclientsusingacomputernet work.Thetimeservermaybealocalnetworktime serveroraninternettimeserver.

Default: Example: libconfig-set NETCONF.TIME_SERVER=123.4.5.67
INDEX
CONTENTS
179
Setting
TIME_ZONE
Allowedvalues
Description Setsthetimezoneintzformat. Note:Thisimplementationinvertsthesign,sofora timezoneofGMTplusonehourthestringwould beGMT-1.

Default: Example: libconfig-set NETCONF.TIME_ZONE GMT-1
USE_NOR
Y=usevalues
fromtheNOR Flash. N=donotuse valuesfromthe Default: NORFlash,use thevaluesfound Example: inthenetconf libconfig-set NETCONF.USE_NOR=Y file.
Enablesordisablesusingnetworksettingsfromthe NORFlash.Ifthisisenabled,thenthesettopbox readssettingssuchasDHCPandNETMASKfromthe NORFlash,insteadoffromthenetconf file.
180
CONTENTS
INDEX
Appendix Ddhcpc file contents
Thefollowingtabledescribesthesettingsavailableinthedhcpdfile.Notethatwhetherthesevaluesare availabledependsontheDHCPserverconfiguration.Forconveniencesakethevaluesarelistedin alphabeticalorder. TheexamplesshowhowtoobtainthevalueprovidedbytheDHCPserver.Defaultsareconfiguredusingother settings.AnyvaluesreceivedviaDHCPwillbeusedinpreferencetothesedefaultsettings.Seethe appropriatedocumentationforinformationonhowtosetdefaultsusingothermethods Ineachcasenullisreturnedif: TheDHCPserverfailedtoreply DHCPisnotenabled TherelevantsettingisnotconfiguredintheDHCPserver Setting
BROWSER_HOMEPAGE
Description AccesstothebrowserhomepagereturnedbytheDHCPserver ThebrowserhomepagereturnedbytheDHCPserverwhichover ridesboththedefaultpageandtheonesetby LIBCONFIG_HOMEPAGE.Valueisreadonlyandonlyavailableif DHCPisenabled. Example:

libconfig-get DHCPC.BROWSER_ HOMEPAGE > aminocom.com
DIMIN
AccesstotheupgradefilesystemminimumDIvaluereturnedby theDHCPserver. Thisallowsforthefilesystemtobeautomaticallyupgradedif thereisanewerbuildbeingmulticast. ThecurrentDIiscomparedtoMCAST_DIMINand DHCP_MCAST_DItomaketheupgradedecision. ThevalueisreadonlyandonlyavailableifDHCPisenabled. Example:

libconfig-get DHCPC.DIMIN > 0
INDEX
CONTENTS
181
Setting
DNS
Description TheDNSserverreturnedbytheDHCPserverifDHCPisenabled. Thisisreadonly. Example:

libconfig-set DHCPC.DNS >192.168.0.0
DOMAIN
ThedomainreturnedbytheDHCPserverifDHCPisenabled.This isreadonly. Example:

libconfig-get DHCPC.DOMAIN > aminocom.com
GATEWAY
ThegatewayreturnedbytheDHCPserverifDHCPisenabled. Thisisreadonly. Example:

libconfig-get DHCPC.GATEWAY >
IPADDR
TheIPaddressreturnedbytheDHCPserverifDHCPisenabled. Thisisreadonly. Example:

libconfig-get DHCPC.IPADDR > 192.168.0.0
LEASETIME
TheDHCPleasetimereturnedbytheDHCPserverifDHCPisena bled.Thisisreadonly. Example:

libconfig-get DHCPC.LEASETIME > 600
MULTICAST_FS_ADDR
Accesstotheupgradefilesystemmulticastaddressreturnedby theDHCPserver Thisallowsforthefilesystemtobeautomaticallyupgradedif thereisanewerbuildbeingmulticast.Thisisreadonly. Example:

libconfig-get DHCPC.MULTICAST_FS _ADDRESS >251.92.98.10
MULTICAST_FS_PORT
Accesstotheupgradefilesystemmulticastportreturnedbythe DHCPserver Thisallowsforthefilesystemtobeautomaticallyupgradedif thereisanewerbuildbeingmulticast.Thisisreadonly. Example:

libconfig-get DHCPC.MULTICAST_FS _PORT >11111
NETMASK
ThenetmaskreturnedbytheDHCPserverifDHCPisenabled. Thisisreadonly Example:

libconfig-get DHCPC.NETMASK > 255.255.0.0
182
CONTENTS
INDEX
Setting MCAST_DI
Description AccesstotheupgradefilesystemDIvaluereturnedbytheDHCP server Thisallowsforthefilesystemtobeautomaticallyupgradedif thereisanewerbuildbeingmulticast. ThecurrentDIiscomparedtoMCAST_DIMINand DHCP_MCAST_DItomaketheupgradedecision. ThevalueisreadonlyandonlyavailableifDHCPisenabled. Example:

libconfig-get DHCPC.MCAST_DI > 1
REBINDTIME
TheDHCPrebindtimereturnedbytheDHCPserverifDHCPis enabled.Thisisreadonly Example:

libconfig-get DHCPC.REBINDTIME > 2268000
RENEWALTIME
TheDHCPrenewaltimereturnedbytheDHCPserverifDHCPis enabled.Thisisreadonly Example:

libconfig-get DHCPC.RENEWALTIME > 1296000
INDEX
CONTENTS
183
184
CONTENTS
INDEX
Appendix EVideo output formats
Thefollowingsectionsshowtheoutputformatpossibilitiesforeachsettopboxplatform,dependingonthe cablesconnected.Theoutputformatisnormallysetaspartofconfiguration(forexample,viathe Managementpagesorlibconfig),butinsomecasesitisselectedautomaticallyasdetailedinthetables foreachplatform. Thenameofthesettingorcommandusedtochangetheoutputformatdependsonwhichconfigurationtool youareusing.

NOTE
InthefollowingtablesCompositeisthesameasCVBSandComponentisthe sameasYPbPr.
E.1
AmiNET103
Partno Cables RCAtoSCART RCAtoRCA Outputformat configurationoptions Composite Composite
INDEX
CONTENTS
185
E.2
AmiNET110,110H
Partno. 502418 Cables 10pinMiniDINtoSCART Outputformat configurationoptions Composite Composite+RGB Svideo Composite+Svideo Composite+Svideo Composite Composite+Component Composite Composite+RGB Composite+Component Composite+Svideo Svideo Svideo
502594 502523 002596 502419
10pinMiniDINtoSvideoandComposite 10pinMiniDINtoComposite(3RCA) 10pinMiniDINtoComponent(5RCA) (obsolete) 10pinMiniDINto6RCA ComponentvideoandComposite.Notethat SyncisonYellow (SynconGreenisnotsupported). 10pinMiniDINtoSvideo(obsolete)
E.3
AmiNET125
Partno. 502418 Cables 10pinMiniDINtoSCART Outputformat configurationoptions Composite Composite+RGB Composite+Svideo Composite+Component Composite+Svideo Composite Composite+Component Composite Composite+RGB Composite+Component Composite+Svideo
502594 502523 002596 obsolete 502419
10pinMiniDINtoSvideoandComposite 10pinMiniDINtoComposite(3RCA) 10pinMiniDINtoComponent(5RCA) (obsolete) 10pinMiniDINto6RCAComponentvideo andComposite
186
CONTENTS
INDEX
E.4
NOTE
AmiNET130,130H
WhentheHDMIcableisconnected,theHDtypeisselectedautomatically.
NotethatwhentheHDMIcableisconnected,theHDtypeisselectedautomatically.
Partno. 502418
Cables 10pinMiniDINtoSCART
Outputformat configurationoptions Composite Composite+RGB Composite+Svideo Composite+Component Composite+Svideo Composite Composite Composite+RGB Composite+Component Composite+Svideo Composite+Component
502594 502523 502419
10pinMiniDINtoSvideoandComposite 10pinMiniDINtoComposite(3RCA) 10pinMiniDINto6RCA ComponentvideoandComposite
510885
HDMI
E.5
AmiNET500
Partno. 002777 002776 002775 Cables Composite(RCA) Svideo Component (3RCA) Output Composite Svideo Component Configurationoptions(outputformat) Dependsoncablesused. E.g.ifSvideoandCompositecablesare connected,youcansetComposite+S videoorjustSvideoorjustComposite. Ifallthreecablesareconnected,you cansetComposite+Component+ Svideooranycombinationofthe formats.
Anycombinationofthefollowingcables:
INDEX
CONTENTS
187
E.6
AmiNET530
Partno. Cables Composite(RCA) Svideo Component (3RCA) Output Composite Svideo Component Configurationoptions(outputformat) Dependsoncablesused. E.g.ifSvideoandCompositecablesare connected,youcansetComposite+S videoorjustSvideoorjustComposite. Ifallthreecablesareconnected,you canset Composite+Component+Svideo oranycombinationoftheformats.
Anycombinationofthefollowingcables:
188
CONTENTS
INDEX
Appendix FBoard revision numbers
TheboardrevisionnumberstoredintheNORFlashiscreatedfromacombinationofanumberthatindicates regionandanumberthatindicatesboardtype.Themeaningofrevisionnumbersisplatformspecific,andthe informationcanbeusefulinunderstandingfunctionalitythatisspecifictocertainboardtypes.Thenameof thesettingorcommandusedtochangetheoutputformatdependsonwhichconfigurationtoolyouare using.SeealsotheentryforBOARDREVinAppendixA,NORFlashsettings
AmiNET110
Revision number
00 01 02 16 17 32-47
Meaning Originalboard. EU.Boardwithfcccardmodification,tosuppressextraharmonicsfromthe RFmodulator. EU.BGAvariant.AmiNET110H/500styleaudioDAC,+6dBswitchableRFout put,newNORFlash.UniversalRFmodulator. US.Boardwithfcccardmodification,tosuppressextraharmonicsfromthe RFmodulator US.BoardwithGPIORFmodulatorchannels3and4only. Japanese
AmiNET500
Revision number 16 Meaning US.Standardboard.GPIORFmodulator,AmiNET110H/500styleaudioDAC.
INDEX
CONTENTS
189
AmiNET530
Revision number
00 16
Meaning EU.StandardSTboard.UniversalRFmodulator. US.StandardSTboard.UniversalRFmodulator.
AmiNET130
Revision number
00
Meaning StandardSTboard,UniversalRFmodulator UniversalRFmodulator,HighpowerUSBport US.Incorrectlyusedonsomepreproductionboards,Valuewrittenoff.
01
16
AmiNET130H
Revision number
00
Meaning StandardSTboard,NoRFmodulator,2Ethernetports UniversalRFmodulator,HighpowerUSBport US.Incorrectlyusedonsomepreproductionboards,Valuewrittenoff.
01
16
AmiNET130M
Revision number
00
Meaning StandardSTboard,NoRFmodulator,Nosmartcard,NominiDINforA/V OUT Modifiedby2M.
01
AmiNET125
Revision number
00
Meaning Standardboard,UniversalRFmodulator
AmiNET132
Revision number 00 16 Meaning StandardEUboard,2LEDs,NoRFmodulator StandardUSboard,2LEDs,UniversalRFmodulator
190
CONTENTS
INDEX
AmiNET532
Revision number 00 16 Meaning StandardEUboard,HDD,4LEDs,NoRFmodulator StandardUSboard,HDD,4LEDs,UniversalRFmodulator
MOOD400030
Revision number) 00 Meaning StandardEUboard,1(red/blue)LED,Smartcard
MOOD400032
Revision number 00 Meaning StandardEUboard,HDD,2LEDs,Smartcard
INDEX
CONTENTS
191
192
CONTENTS
INDEX
Appendix GUsing the configuration techniques
Thefollowingappendixgivesexamplesofhowtousesomeoftheconfigurationtechniques.
G.1
Configuringimagecomponents
Configuringimagecomponentsenablesyoutocustomisethefilesusedtocreateasoftwareupgradeimage. Whenthesignupgradeimagescriptcreatesanewimage,itincludesthefilesthatarelistedinthe flashcontentsfileandstoredintheimagecomponentssubdirectoryofthesoftwarerelease.Youcanedit thesefilesoraddnewonesinordertocustomisethesoftwareupgradeimagetoyourrequirements. Forexample,youcan: editconfigurationfilesbeforetheyaremadeavailabletosettopboxes. addfilesneededtoenableTelnet,orSSH(Dropbear). add/editanupgrade.shscriptfilethatthesettopboxwillexecutewhenitinstallsthenewsoftware upgradeimage. replacegraphics(displayedduringthebootstrappingandupgradingstages)withcustomisedversions forexample,thesplash.gifgraphic.
NOTE
Allfilesintheimagecomponentsdirectorymustbelistedinthe flashcontentsfile,otherwise,thesignupgradeimagescriptwill fail.
G.1.1
NOTE
Toconfigureimagecomponents
Inthefollowinginstructions, <release_name>indicatesthenameofthe softwarereleaseimagedirectorythatcontainsyourAminosoftware release. Forexample, A110-0.14.0-frescoj27-ami_wm-subs-1 installsin 0.14.0-frescoj27-ami_wm-subs-1,hence <release_name>forthisis0.14.0-frescoj27-ami_wm-subs-1.
Thegeneralprocedureforeditingimagecomponentsisasfollows:
1.
Openthefilethatyouwanttoedit.Theimagecomponentfilesareinthefollowinglocation:
Alternatively,youcanaddanewfiletothislocationsuchasachnls.txtfileyouhavecopiedfrom apreconfiguredsettopboxoranupgrade.shfilethatcontainslibconfigcommandstosetNOR Flashvalues. 2. Editthefile,andsaveyourchanges.
INDEX
CONTENTS
193
3.
Opentheflashcontentsfile,andensurethatthefileyouhaveadded/editedislistedthere.This fileisinthefollowinglocation:
<release_name>/upgradeimage/flashcontents
Theflashcontentsfileliststhefilesthatwillbeincludedinasoftwareupgradeimage,anddefines permissionsforthefile.
Example flashcontents file
Thisshowsasmallpartofatypicalflashcontentsfile.
# R == file must exist # must be read-only # must match the checksum in listfile.sig # W == file may exist # must not be executable # we don't care about the checksum # E == file may exist # if it does exist: # it must be read-only # must match the checksum in listfile.sig R R R R R R R R R R R R R R W W W W AMINET.img libm223.so libc223.so xfresco xfresco.amem mkfs.ext2 fsck.ext2 tune2fs mkfs.xfs font_opt.bin texttvd ttsub bbsdk.cfg irb_keys.txt noformat !poweron cookies.txt history.txt
4.
Usethesignupgradeimagescripttocreatethesoftwareimage,asusual.
Thenewsoftwareupgradeimageincludesyourneworeditedfiles,andyoucanuseittoupgradeyourset topboxes.
G.1.1.1 Using Telnet or SSH to send libconfig commands

SeeChapter4,UsinglibconfigfordetailsofhowtoaccesssettopboxconfigurationviaTelnetorSSH.These remotelogintoolsarenotnormallyincludedinsoftwarebuilds,butyoucanenabletheappropriatetoolby addingthefiletotheimagecomponentsusedtocreatethesoftwareimageloadedontothesettopbox.
194
CONTENTS
INDEX
G.2
Configuringalargedeployment
Itispossibletoconfiguresoftwarebeforedeployingittoalargenumberofsettopboxes.Thefollowingsteps describerecommendationsonhowthiscanbedoneforboththeinitialsettopboxconfigurationandfor futureupgradeimages.
G.2.1
Prerequisites
Theconfigurationprocedureoutlinedhereassumesyoualreadyhaveasettopboxwithavalidsoftware imageinstalled.Thismustincludeoneoftheremotelogintools(Telnet/SSH/Dropbear). 1. 2. 3. Configurethesoftwareonthebox(forexample,viatheManagementpages),andtestthe configurationtoensurethesettopboxnowoperatesasintended. Whenyouarehappywiththeconfiguration,usetheremotelogintooltoconnecttothesettopbox. Copythecontentsofthefilesthathavebeenmodified. OntheSTBuse:

mkdir /nfs mount -o nolock <ip addr of host>:/path_to_nfs_export/ /nfs cd /nfs cp /mnt/nv/settings /nfs/
Theconfigurationfilesarein/mnt/nv,andyouwillneedtocopythemtothe<release_name>/ upgradeimage/imagecomponentsdirectoryonyourPC.Ifyouarenotsurewhichfileshavebeen modified,thencopyallthecontentsofthedirectory.Normallyonlythesettingsfilewillhavebeen modified. 4. 5. Ifyouhaveaddedanynewfilesthatneedtobeincludedintheupgradeimage,addthemtothe flashcontents fileinthe<release_name>/upgradeimage/directory. Createanewsignedupgradeimage(andaddittothedirectoryspecifiedinthemulticastservers configurationfile).Ensurethatthenewimagehasanincrementeddeploymentindex,ifyouareusing deploymentindexestocontrolsoftwareversionsinstalledonthesettopbox(thisisnot recommendedforatrialsystem). Upgradethesoftwareonasinglesettopboxwiththisnewupgradeimage(forexample,byusingSTBremoteconf). Checkthatthenewsoftwareloadsandworksasexpected.Ifchangesneedtobemade,repeatsteps 1.to6.untiltheconfigurationiscorrect. Instructallsettopboxesonyournetworktoupgradetothisnewimage.(forexample,usethe deploymentindexmechanismtoforceanautomaticupgrade).
6. 7. 8.
INDEX
CONTENTS
195
196
CONTENTS
INDEX
Appendix HInvalid video mode recovery
ThereareanumberofwaysinwhichanSTBcanbeconfiguredwiththeresultthattheuserseesnousable outputontheirTV.FortheAmiNETx3xseriesthemostcommonare: Usingthecomposite,Svideo,SCARTorRFoutputwhentheboxisconfiguredforHD.Inthiscasethe outputwillonlyshowablackscreenuntilvideostartsplaying.Downscaledvideowillbeshownonthese outputsbutthemiddlewaregraphicswillnot. UsingHDMIandhavingtheboxconfiguredforamodetheTVdoesnotsupport(someTVsdonot support480ior576ioverHDMI,forexample). UsinganSvideo,ComponentorRFcablebuthavingtheboxconfiguredwiththecorrespondingoutput turnedoff. ConnectingtoanNTSCTVwhentheboxisconfiguredforPAL,andtoalesserextentviceversa(manyPAL TVswillshowsomethingusablewhenreceivinganNTSCsignalevenifthereisnocolour,butmostNTSC TVswillnotdisplayaPALsignalatall). Powercyclethebox,andwhileitisbootingholddowntheOKbutton. InitiallytheLEDwillnotflashastheremotehasnotyetbeenread. TheLEDwillstartflashingassoonastheSTBstartstoreadtheremote. Theboxwillbereconfiguredandrebooted. TheLEDwillstopflashingastheboxreboots(ReleaseOK). TheSTBshouldnowbereconfiguredanddisplayingvideoagain.
Asimplemethodofvideomoderecoveryisasfollows:
TheLEDtransitionscanbeusedtodescribewhentoholdtheOKbuttonandwhentoletitgo.Ittransitions fromlittoflashingtolit.TheRestorebutton(OKinthiscase)canbechangedifneeded.
H.1
Howitworks
Thereisascripton/mnt/nvcalledrc.restore.Thiscanbereplacedorchangedbycustomersifneeded. Thisscriptisrunjustbeforethebrowser/middleware.Itchecksifapredefinedkeyhasbeenhelddownfor morethantwosecondswhilebooting.Ifso,itwillresettheresolutiontoHDAUTOasdefault. Howevertheresolutioncanstillbechangedbychangingtherc.scriptonflash.Thesetting

NORFLASH.OUTPUT_RESOLUTIONcanbe:
HDNONEifnoHDMIcableisconnected(anditisnotanAmiNET130M). HD480P59ifHDMIisconnected(ortheboxisanAmiNET130M)andNORFLASH.TVSYSTEMisNTSC-M, NTSC-JorPAL-M.
INDEX
CONTENTS
197
HD576P50ifHDMIisconnected(ortheboxisanAmiNET130M)andNORFLASH.TVSYSTEMisanything
else. AllboxesexcepttheAmiNET130M(towhichthisdoesnotapply)alwaysproduceacompositeoutputandall cabletypeshaveacompositesignalavailable,soyouwillbeabletogetapicturebyusingthis,thoughitmay meanswitchingconnectionstotheTV.

NOTE
ThismethodisonlyusefulonAmiNETx3xboxes,notontheAmiNET110or AmiNET125
198
CONTENTS
INDEX
Appendix IPairing an IR remote control with a set-top box
YoucanprogramanAminoIRremotecontrolsothatitcanonlycontrolasettopboxthatisconfiguredto respondtoit. TheAminoIRremotecontrolsprefixanumbertoeachsettopboxcommand.Thisnumberissetto000 by default,butyoucanprogramittobeanothernumberintherange001 to015.FortheAmiNET125,and130 thiscanalsobeanumberintherange100 to115. AllAmiNETsettopboxesrespondtocommandsprefixedwith0butyoucanconfigurethemtorespondto commandsprefixedwithanothernumberaswell. Forexample,aremotecontrolcanbesettoprefixcommandswith3,andasettopboxcanbeconfiguredto respondtocommandsprefixedwith3. Theremotecontrolcanonlycontrolsettopboxesthatexpect3asacommandprefix. Thesettopboxwillrespondtocommandsprefixedwith3andalsocontinuestorespondtocommands prefixedwith0(sothatallsettopboxesrespondtothedefaultAminoremotecontrol).
ThefollowingstepsusetheConfigurationpagestosettheIRbrandcode.Thiscanalsobesetwiththeother configurationtools.SeeChapter6,SettopboxconfigurationpagesforFrescoandOpera8.5andChapter 7,SettopboxconfigurationpagesforOpera9fordetails.
I.1
1. 2.
OnthegreyAminoIRremotecontrol
HolddowntheSTB andOK buttonsuntiltheSTB buttonlightsuppermanently. Enterthenumberthatyouwanttosetastheprefixcodeforthisremotecontrol.Thismustbea threedigitnumberintherange 000 - 015(also100 115 fortheAmiNET125and130). Forexample:
111
Theremotecontrolwillnowprefixallsettopboxcommandswiththiscode.
NOTE
Toreverttothedefaultcode(thatis,tounpairtheremotecontrolandsettop box),repeatthesestepsandsetthecodeto000.
I.2
1. 2.
OntheAminoAVC(black)IRremotecontrol
HolddowntheSTB buttonuntiltheLEDflashestwice Enter 9 8 2.TheSTBlightshouldflashfourtimes.Ifitflashestwice,repeatthispartoftheproce dure.The9 8 2 sequenceunlocks/locksremoteconfigurationprogramming.
INDEX CONTENTS 199
3. 4.
4flashes=unlocked 2flashes=locked
HolddowntheSTBkeyuntiltheLEDflashestwiceandcontinueholdingituntilitflashestwiceagain. Enterthenumberthatyouwanttosetastheprefixcodeforthisremotecontrol.Thismustbea threedigitnumberintherange 000 - 015(or100 115 fortheAmiNET125and130).
I.2.1
1.
Pairingthesettopboxtotheremotecontrol
FromtheAminoIRkeyboard,pressAlt-MandthenentertheManagementpassword(leavesby default),toaccesstheManagementpages.
Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. SeeSection4.4oftheAminoInstallationandUpgradeGuideforinformation onchangingthesedefaultpasswords. 2. 3. Openthe Infra-Red Configurationpage. Enterthetwodigitcodethatyouprogrammedtheremotecontrolwith,thisisthelasttwodigitsof the3digitcodeusedinStep4.above.(Thefirstdigitindicatesthefrequencyused).Forexample,if thisisanAmiNET125andyouhavesettheSTBbrandcodeto111thenthetwodigitcodetoenteris 11. Thiscanalsobesetwithlibconfig-setSETTINGS.IR_BRAND11.
NOTE
4.
Navigationonthispageissometimesdifficultusethearrowkeysonthe AminoIRkeyboardinsteadofthemouse.
5.
Savethechanges(thedefaultpasswordhereissnake). Theremotecontrolandthesettopboxarenowpaired.
200
CONTENTS
INDEX
Index
A
ANY_KEY_STANDBY_RECOVER(settingsfile) 145 AUD_SYNC_LIMITS 145 AVSYNC_WAIT(settingsfile) 146
B
BOARDREV(NORFlash) 131 Browserconfigurationfiles 6 BrowserSetup(Managementpages) 72, 93, 113, 127 BROWSER_CONCEAL_STARTUP(settingsfile) 146 BROWSER_ENABLECOOKIES(settingsfile) 146 BROWSER_HELPPAGE(settingsfile) 146 BROWSER_HOMEPAGE(dhcpcfile) 181 BROWSER_HOMEPAGE(settingsfile) 146 BROWSER_MARGIN_BOTTOM(settingsfile) 147 BROWSER_MARGIN_COLOUR(settingsfile) 147 BROWSER_MARGIN_LEFT(settingsfile) 147 BROWSER_MARGIN_RGHT(settingsfile) 147 BROWSER_MARGIN_RIGHT(settingsfile) 147 BROWSER_MARGIN_TOP(settingsfile) 147 BROWSER_RETRY(settingsfile) 147 BROWSER_TRANSPARENCY(settingsfile) 148 BROWSER_UNLOAD_VIDEO(settingsfile) 148
Settopbox 5 Browserconfigurationfile 6 chnls.txt 6 config.txt 6 Configurationpages 7 Dropbear 7 fkeys.conffile 6 hostnamefile 5 Imagecomponents 7 Managementpages 93, 127 Multiplesettopboxes 195 netconffile 5 NORFlashsettings 45 opera.ini 6 Options 6 Preferencespages 91, 126 settingsfile 5 SSH 7 STBremoteconf 6 Telnet 7 usersettingsfile 6 UsingManagementpages 73, 114 Settopboxes Prerequisites 195 CORE_LANG(NORFlash) 131 CUSTOMER_DATA(NORFlash) 132
D
Defaultaccesspolicies 19 Defaultpolicies 19 DEFAULT_VOLUME(settingsfile) 149 DELAY_FACTOR(settingsfile) 149 DHCP(netconffile) 177 DHCP(NORFlash) 132 DHCPsettings Dynamic 5, 46 DHCP_AUTHENTICATION(NORFlash) 132 dhcpcfile BROWSER_HOMEPAGE 181 DIMIN 181 DNS 182 DOMAIN 182 GATEWAY 182 IPADDR 182 LEASETIME 182 MCAST_DI 183 MULTICAST_FS_ADDR 182 MULTICAST_FS_PORT 182
C
CC_OUTPUT_SOFTcc(settingsfile) 148 CC_OUTPUT_VBI(settingsfile) 148 CC_PREFERENCE(settingsfile) 149 CHANGEPAGE(STBremoteconf) 29 CHANGEPWORD(STBremoteconf) 30 CHANNEL(STBremoteconf) 30 Channels(Managementpages) 72, 93, 113, 128 chnls.txt 6, 93 Contents 13 Closedcaptionbuilds 100 CLOSED_CAPTION_SWAPPED(settingsfile) 149 config.txt 6, 93 config.txtfile 94 Configurationpages Configuringsettopbox 7 Controllingwithkeyboard 99 Controllingwithremotecontrol 99 Configuring AminoCommunicationsLtd.2011CONFIDENTIAL
INDEX
CONTENTS
201
NETMASK 182 REBINDTIME 183 RENEWALTIME 183 DHCPCsettings 5, 46 DHCP_TIMEOUT(netconffile) 177 DHCP_TIMEOUT(NORFlash) 132 DI(NORFlash) 133 DIMIN(dhcpcfile) 181 DISABLE_ERR_BOX(settingsfile) 150 DISPLAY_MODE(settingsfile) 150 DNS(dhcpcfile) 182 DNS(netconffile) 178 DNS(NORFlash) 133 DOLBY_RF(settingsfile) 151 DOMAIN(dhcpcfile) 182 DOMAIN(netconffile) 178 Dropbear Configuringsettopbox 7 DynamicDHCPsettings 5, 46
HTTP_PROXY_IGNORE(settingsfile) 154 HTTPS_PROXY(settingsfile) 154 HWINFO(STBremoteconf) 33
I
IDENT(NORFlash) 133 Identity(Managementpages) 72, 96 IGMP_END_TIMEOUT(settingsfile) 155 IGMP_FAST_LEAVE(netconffile) 178 IGMP_MAX_VER(netconffile) 179 IGMP_MAX_VER(NORFlash) 134 IGMP_RETUNE_AFTER_TIME(settingsfile) 155 IGMP_START_TIMEOUT(settingsfile) 155 Imagecomponents Configuringsettopbox 7 IME(settingsfile) 155 InfraRedConfiguration(Managementpages) 72, 96 INITIAL_LED(settingsfile) 156 Installing PerlmodulesforSTBremoteconf 23 IPADDR(dhcpcfile) 182 IPADDR(netconf) 179 IPADDR(NORFlash) 95, 128, 129, 134 IR_BRAND(settingsfile) 156
E
EAS(STBremoteconf) 31 ENABLE_CC_OR_SUBS 151 ENABLE_NDS_AUTH(settingsfile) 151 ENABLE_TRUSTED_DOMAINS(settingsfile) 151 EOS_KILLS_VIDEO(settingsfile) 152 ETHERNET(NORFlash) 133 ETHERNET(STBremoteconf) 31
K
Keyboard UsingwithConfigurationpages 99 UsingwithManagementpages 73, 113 Keyboardsettings(Preferencespages) 91, 126 KEYMAP(settingsfile) 156
F
FETCHFILE(STBremoteconf) 32, 34, 36 Fileaccesspolicy 18 fkeys.conf 6 FULLSCREEN(settingsfile) 152
L
LEASETIME(dhcpcfile) 182 LEGACY_SUBS(settingsfile) 156 LINKSTATE_FAIL_THRESHOLD(NORFlash) 134 LINKSTATE_KEY_THRESHOLD(settingsfile) 157 LINKSTATE_TIMEOUT(NORFlash) 134 LINKSTATE_TIMEOUT(settingsfile) 157 LOCK(NORFlash) 134 LOGREAD(STBremoteconf) 33
G
GATEWAY(dhcpcfile) 182 GATEWAY(netconffile) 178 GATEWAY(NORFlash) 95, 128, 129, 133 GETCONFIG(STBremoteconf) 32 GETDI(STBremoteconf) 32 GETSERIALID(STBremoteconf) 32 GETVERSION(STBremoteconf) 33
M H
H264_VIDEO_DELAY(settingsfile) 153 H264_VIDEO_TP_DELAY(settingsfile) 153 HardwareInformation(Managementpages) 72 Hardwareinformation(Managementpages) 96 HDAUTO 197 HDMI_AUDIO_FORMAT(settingsfile) 154 HOSTNAME(hostnamefile) 16, 94, 128 hostnamefile 5 Contents 15 HOSTNAME 16, 94, 128 HTTP_PROXY(settingsfile) 154 MAC_ADDRESS(NORFlash) 135 Managementpages 71, 112 BrowserSetup 72, 113 Channels 72, 113 Configurationsettingsused 93, 127 BrowserSetup 93, 127 Channels 93, 128 Hardwareinformation 96 Identity 96 InfraRed 96 Network 94 ProxySetup 93, 128 Softwareversion 96
202
CONTENTS
INDEX
TrustedDomains 93 TVI 96 VideoSetup 93 Controllingwithkeyboard 73, 113 Editingconfiguration 73, 114 HardwareInformation 72 Identity 72 InfraRedConfiguration 72 Listofpages 72, 113 NetworkConfiguration 72 ProxySetup 72 Reboot 73, 113 Rebootingsettopbox 74, 112, 114, 125 seealsoConfigurationpages 71, 112 SoftwareVersion 72 TrustedDomains 72 TVIConfiguration 73 UpdateSoftware 72, 113 VideoSetup 72, 113 Viewingconfiguration 73, 114 MANAGEMENT_PREFIX(settingsfile) 157 MAXIMUM_VOLUME(settingsfile) 157 MAX_PCR_PTS_BUFFERING(settingsfile) 158 MCAST_DI(dhcpcfile) 183 MIDWAY_KEY_IDLE_TIMEOUT(settingsfile) 158 MINIMUM_VOLUME(settingsfile) 158 MPEG2_VIDEO_DELAY(settingsfile) 159 MPEG2_VIDEO_TP_DELAY(settingsfile) 159 MULTICAST_BOOTSTRAP_GROUP(NORFlash) 135 MULTICAST_BOOTSTRAP_PORT(NORFlash) 135 MULTICAST_FILESYSTEM_GROUP(NORFlash) 136 MULTICAST_FILESYSTEM_PORT(NORFlash) 136 MULTICAST_FS_ADDR(dhcpcfile) 182 MULTICAST_FS_PORT(dhcpcfile) 182 MULTICAST_UPGRADE_GROUP(NORFlash) 137 MULTICAST_UPGRADE_PORT(NORFlash) 137
N
NATIVE_FRAMERATE_PASSTHRU_ENABLE(settingsfile) 160 NATIVE_PASSTHROUGH_ENABLE(settingsfile) 160 netconf IPADDR 179 NETMASK 179 netconffile 5 DHCP 177 DHCP_TIMEOUT 177 DNS 178 DOMAIN 178 GATEWAY 178 IGMP_FAST_LEAVE 178 IGMP_MAX_VER 179 PACKET_ORDERING 96, 179 TIME_SERVER 179 TIME_ZONE 180 USE_NOR 180 USE_PPP 143 NETMASK(dhcpcfile) 182 NETMASK(netconf) 179 NETMASK(NORFlash) 138 NET_OPERATOR(NORFlash) 137 NetworkConfiguration(Managementpages) 72, 94 NORFlash BOARDREV 131 CORE_LANG 131 CUSTOMER_DATA 132
DHCP 132 DHCP_AUTHENTICATION 132 DHCP_TIMEOUT 132 DI 133 DNS 133 ETHERNET 133 GATEWAY 95, 128, 129, 133 IDENT 133 IGMP_MAX_VER 134 IPADDR 95, 128, 129, 134 LINKSTATE_FAIL_THRESHOLD 134 LINKSTATE_TIMEOUT 134 LOCK 134 MAC_ADDRESS 135 MULTICAST_BOOTSTRAP_GROUP 135 MULTICAST_BOOTSTRAP_PORT 135 MULTICAST_FILESYSTEM_GROUP 136 MULTICAST_FILESYSTEM_PORT 136 MULTICAST_UPGRADE_GROUP 137 MULTICAST_UPGRADE_PORT 137 NETMASK 138 NET_OPERATOR 137 NTSC_SUBS 138 OUTFMT 139 PPP_PASSWORD 139 PPP_USERNAME 139 RECOVERY_UPGRADE_SERVER 139 RFMOD_CHAN 140 RFMOD_ENABLE 140 RFMOD_FREQTABLE 140 SCART_PIN8_OFF 140 SERIAL_ID 140 STB_ATTESTATION 140 STB_PROVIDER 141 SUBTITLES 141 TFTP_LOADFILE 141 TFTP_SERVER 141 TIME_SERVER 142 TVSYSTEM 143 U_BOOT_OPTION 142 VLAN 143 VLAN_EXTERNAL_ID 143 VLAN_INTERNAL_ID 143 NORFlashsettings 45 NTPCLIENT_TIMEOUT(settingsfile) 160 NTSC_SUBS(NORFlash) 138
O
ONSCREEN_KBDRAISE(settingsfile) 160 opera.ini 6 OPERA_HTTP_AUTHENTICATION_DOMAINS(settingsfile) 160 OUTFMT(NORFlash) 139 OUTRES(STBremoteconf) 34
P
PACKET_ORDERING(netconffile) 96, 179 PING(STBremoteconf) 35 PLT_SPOOLTIME(settingsfile) 161 PLT_START_DELAY(settingsfile) 161 POD_SENSITIVITY(settingsfile) 161 PPP_PASSWORD(NORFlash) 139 PPP_USERNAME(NORFlash) 139
INDEX
CONTENTS
203
Preferencepages PVRsettings 63 Preferencespages 62, 100 Closedcaptionbuilds 100 Configurationsettingsused 91, 126 Keyboard 91, 126 Subtitles 91 TVandaudio 91, 126 Controllingwiththeremotecontrol 100 seealsoConfigurationpages 62, 100 PREFERRED_CAPTIONING_SYSTEM 161 PREFERRED_LANG(settingsfile) 162 PREFERRED_LANGUAGE(settingsfile) 91 PREF_HD_RESOLUTION(settingsfile) 162 PREFILL_DECODER_BUFFERS(settingsfile) 162 Prerequisites Configuringmultiplesettopboxes 195 STBremoteconf 22 InstallingPerlmodules 23 PROC(STBremoteconf) 35 Procedure Configuringmultiplesettopboxes 195 SendingSTBremoteconfcommands 25 ProxySetup(Managementpages) 72, 93, 128 PS(STBremoteconf) 36 PVRoptions preferencepages 63 PVR_SPOOLTIME(settingsfile) 162
S
SAVEFILE(STBremoteconf) 38 SCART_PIN8_OFF(NORFlash) 140 SECONDARY_LANG(settingsfile) 166 SECONDARY_LANGUAGE(settingsfile) 91 SERIAL_ID(NORFlash) 140 SETCONFIG(STBremoteconf) 38 settingsfile 5 ANY_KEY_STANDBY_RECOVER 145 AUD_SYNC_LIMITS 145 AVSYNC_WAIT 146 BROWSER_CONCEAL_STARTUP 146 BROWSER_ENABLECOOKIES 146 BROWSER_HELPPAGE 146 BROWSER_HOMEPAGE 146 BROWSER_MARGIN_BOTTOM 147 BROWSER_MARGIN_COLOUR 147 BROWSER_MARGIN_LEFT 147 BROWSER_MARGIN_RIGHT 147 BROWSER_MARGIN_TOP 147 BROWSER_RETRY 147 BROWSER_TRANSPARENCY 148 BROWSER_UNLOAD_VIDEO 148 CC_OUTPUT_SOFTCC 148 CC_OUTPUT_VBI 148 CC_PREFERENCE 149 CLOSED_CAPTION_SWAPPED 149 DEFAULT_VOLUME 149 DELAY_FACTOR 149 DISABLE_ERR_BOX 150 DISPLAY_MODE 150 DOLBY_RF 151 ENABLE_CC_OR_SUBS 151 ENABLE_NDS_AUTH 151 ENABLE_TRUSTED_DOMAINS 151 EOS_KILLS_VIDEO 152 FULLSCREEN 152 H264_VIDEO_DELAY 153 H264_VIDEO_TP_DELAY 153 HDMI_AUDIO_FORMAT 154 HTTP_PROXY 154 HTTP_PROXY_IGNORE 154 HTTPS_PROXY 154 IGMP_END_TIMEOUT 155 IGMP_RETUNE_AFTER_TIME 155 IGMP_START_TIMEOUT 155 IME 155 INITIAL_LED 156 IR_BRAND 156 KEYMAP 156 LEGACY_SUBS 156 LINKSTATE_FAIL_THRESHOLD 157 LINKSTATE_TIMEOUT 157 MANAGEMENT_PREFIX 157 MAXIMUM_VOLUME 157 MAX_PCR_PTS_BUFFERING 158 MIDWAY_KEY_IDLE_TIMEOUT 158 MINIMUM_VOLUME 158 MPEG2_VIDEO_DELAY 159 MPEG2_VIDEO_TP_DELAY 159 NATIVE_FRAMERATE_PASSTHRU_ENABLE 160 NATIVE_PASSTHROUGH_ENABLE 160 NTPCLIENT_TIMEOUT 160 ONSCREEN_KBD_RAISE 160 OPERA_HTTP_AUTHENTICATION_DOMAINS 160
R
RCIME_DEFLANG(settingsfile) 162 RCIME_DEFMODE(settingsfile) 163 RCIME_TIMEOUT(settingsfile) 163 REBINDTIME(dhcpcfile) 183 Reboot(Managementpages) 73, 113 REBOOT(STBremoteconf) 36, 37 Rebootingsettopbox UsingManagementpages 74, 112, 114, 125 RECOVERY_UPGRADE_SERVER(NORFlash) 139 REFLASH(STBremoteconf) 36 REFORMAT(STBremoteconf) 37 Remotecontrol UsingwithConfigurationpages 61, 99 UsingwiththePreferencespages 63, 100 REMOTECONF(settingsfile) 163 REMOTECONFPORT(settingsfile) 164 REMOTE_LAYOUT(settingsfile) 163 RENEWALTIME(dhcpcfile) 183 REPEAT_RATE(settingsfile) 164 RFBOOST_DOLBY(settingsfile) 164 RFBOOST_MPEG(settingsfile) 164 RFMOD_CHAN(NORFlash) 140 RFMODE(STBremoteconf) 37 RFMOD_ENABLE(NORFlash) 140 RFMOD_FREQTABLE(NORFlash) 140 RTSP_BASE_PORT(settingsfile) 164 RTSP_DESTINATION(settingsfile) 165 RTSP_END_TIMEOUT(settingsfile) 165 RTSP_PING_TIMEOUT(settingsfile) 165 RTSP_SCALE(settingsfile) 165 RTSP_SERVER(settingsfile) 166 RTSP_START_TIMEOUT(settingsfile) 166
204
CONTENTS
INDEX
PLT_SPOOLTIME 161 PLT_START_DELAY 161 POD_SENSITIVITY 161 PREFERRED_CAPTIONING_SYSTEM 161 PREFERRED_LANG 162 PREFERRED_LANGUAGE 91 PREF_HD_RESOLUTION 162 PREFILL_DECODER_BUFFERS 162 PVR_SPOOLTIME 162 RCIME_DEFLANG 162 RCIME_DEFMODE 163 RCIME_TIMEOUT 163 REMOTECONF 163 REMOTECONFPORT 164 REMOTE_LAYOUT 163 REPEAT_RATE 164 RFBOOST_DOLBY 164 RFBOOST_MPEG 164 RTSP_BASE_PORT 164 RTSP_DESTINATION 165 RTSP_END_TIMEOUT 165 RTSP_PING_TIMEOUT 165 RTSP_SCALE 165 RTSP_SERVER 166 RTSP_START_TIMEOUT 166 SECONDARY_LANG 166 SECONDARY_LANGUAGE 91 STANDBY_LED 167 STBRCPORT 167 STC_OFFSET 167 SUBTITLES_OPTION 168 SUBTITLES_PREF_LANG 168 SUBTITLES_SECOND_LANG 92, 127, 168 TELETEXT_FULLSCREEN TELETEXT_FULLSCREEN(settingsfile) 170 TEXT_ENTRY 170 TOOLBAR_STATE 170 TVI_TYPE 170 UDP_END_TIMEOUT 170 UDP_START_TIMEOUT 171 UI_LANG 171 USB_SPEED 171 USB_TIMEOUT 171 USE_PROXY 172 USER_AGENT_STRING 172 SIGNEDCMD(STBremoteconf) 39 SNAPSHOT(STBremoteconf) 39 SoftwareVersion(Managementpages) 72 Softwareversion(Managementpages) 96 SSH Configuringsettopbox 7 STANDBY_LED(settingsfile) 167 STATS(STBremoteconf) 39 STB_ATTESTATION(NORFlash) 140 STB_PROVIDER(NORFlash) 141 STBRCPORT(settingsfile) 167 STBremoteconf 21 39 CHANGEPAGE 29 CHANGEPWORD 30 CHANNEL 30 Commandsyntax 26 Commands List 29 Overview 28 Configuringsettopbox 6 EAS 31 ETHERNET 31
FETCHFILE 32, 34, 36 GETCONFIG 32 GETDI 32 GETSERIALID 32 GETVERSION 33 HWINFO 33 LOGREAD 33 OUTRES 34 PING 35 Prerequisites 22 InstallingPerlmodules 23 PROC 35 PS 36 REBOOT 36, 37 REFLASH 36 REFORMAT 37 RFMODE 37 SAVEFILE 38 Sendingcommands 25 Syntax 26 SETCONFIG 38 SIGNEDCMD 39 SNAPSHOT 39 STATS 39 SYSLOG 41 TVSYSTEM 41 UPGRADEMCAST 42 UPGRADEMCAST_VER 42 VOD 43 STC_OFFSET(settingsfile) 167 SUBTITLES(NORFlash) 141 Subtitlessettings(Preferencespages) 91 SUBTITLES_OPTION(settingsfile) 168 SUBTITLES_PREF_LANG(settingsfile) 168 SUBTITLES_SECOND_LANG(settingsfile) 92, 127, 168 Syntax STBremoteconfcommands 26 SYSLOG(STBremoteconf) 41
T
Telnet Configuringsettopbox 7 TEXT_ENTRY(settingsfile) 170 TFTP_LOADFILE(NORFlash) 141 TFTP_SERVER(NORFlash) 141 TIME_SERVER(netconffile) 179 TIME_SERVER(NORFlash) 142 TIME_ZONE(netconffile) 180 TOOLBAR_STATE(settingsfile) 170 trsdmns.txt 93 Contents 13 trsdmns.txtfile 93 TrustedDomains(Managementpages) 72, 93 TVandaudiosettings(Preferencespages) 91, 126 TVIConfiguration(Managementpages) 73, 96 TVI_TYPE(settingsfile) 170 TVSYSTEM(NORFlash) 143 TVSYSTEM(STBremoteconf) 41
U
U_BOOT_OPTION(NORFlash) 142 UDP_END_TIMEOUT(settingsfile) 170
INDEX
CONTENTS
205
UDP_START_TIMEOUT(settingsfile) 171 UI_LANG(settingsfile) 171 UpdateSoftware(Managementpages) 72, 113 UPGRADEMCAST(STBremoteconf) 42 UPGRADEMCAST_VER(STBremoteconf) 42 USB_SPEED(settingsfile) 171 USB_TIMEOUT(settingsfile) 171 USE_NOR(netconffile) 180 USE_PPP(netconffile) 143 USE_PROXY(settingsfile) 172 Userpreferencespages seePreferencespages 62, 100 USER_AGENT_STRING(settingsfile) 172 usersettingsfile 6 Contents 15
V
VideoSetup(Managementpages) 72, 93, 113 VLAN(NORFlash) 143 VLAN_EXTERNAL_ID(NORFlash) 143 VLAN_INTERNAL_ID(NORFlash) 143 VOD(STBremoteconf) 43
206
CONTENTS
INDEX

Configuration Guide 113

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Configuration Guide 113

Uploaded by

Copyright:

Available Formats

AminoSTBConfigurationGuide

5.1 5.2 5.3 5.4 5.5

Chapter5,Customisingasoftwareupgrade image Chapter6,Settopboxconfigurationpages forFrescoandOpera8.5

110 109 108 107

105 104 103 102

FileAccessPolicyinformationadded.OUTRESinfo updated.Summarytablesupdated.Scriptstocontrol STBRemoteconfadded.SAVEcommandinfo corrected.

ThischapterprovidesabriefoutlineoftheconfigurablesettingsandconfigurationoptionsfortheAmiNET seriesofsettopboxes.Moredetaileddescriptionsofthesettingsandoptionswillbeprovidedinlater chapters. Whetherasettopboxusesasettingdependsonthesoftwarebuildusedtocreatethesoftware imageinstalledonthesettopbox.

ThedynamicnetworkandmulticastupgradesettingsretrievedfromtheDHCPserverarestoredinafilecalled dhcpcd-eth0.info.Thesevaluesareonlysetifthesettopboxusesdynamicnetworkandmulticast upgradesettings,otherwise,thestaticvaluesaredefinedintheNORFlash,netconf ordhcpcfiles.The DHCPCvaluesarereadonly.

CONFIGURING SET-TOP BOXES

Softwarereleaseswillnormallyincludetheconfigurationfileforthebrowser.ForFrescothisiscalled config.txt.ForOperaitisopera.ini.Insomebuilds,thesettopboxreadssomeofitssettingsfrom thesefiles.

Softwarereleasesstoretheactualpasswordsinencryptedformin /mnt/nv/passwdand/mnt/nv/ shadow,atbootupthesearecopiedto/etc/passwdand/etc/shadow.. Warning: Aminostronglyrecommendsthatyouchangethedefaultpasswordswhen deployingoursettopboxes. Seebelowforinformationonchangingthesedefaultpasswords.

Aminosettopboxmanagementoffersvariousmeansofediting/readingconfigurationandcontrollingbasic settopboxoperation(forexample,toinitiateasoftwareupgradeorreboot).Thetechniqueswhichmakethis possiblearedescribedbelow:

CONFIGURING SET-TOP BOXES

Thesecomponentsareusuallynotinstalledforsecurityreasons,sotheywill needtobeaddedtothesoftwareimageinstalledonthesettopboxifyou wanttousethem

Theconfigurationtechniquesdescribedinthetablesbelowareeachsuitedtoparticularcircumstancesand contexts.Forexample,theConfigurationpagesofferlocalconfiguration,whileSTBremoteconfenables remoteconfiguration.Editingimagecomponentfilesbeforethesoftwareisupgradedenablesthesame

CONFIGURING SET-TOP BOXES

configurationtobesetonmultiplesettopboxes,whereaschangesviaTelnetcanonlyapplytoasingleset topbox. STBremoteconf libconfigcommands JMACXAPI Configurationpages Imagecomponents

Beforesoftwareisloaded Aftersoftwareisloaded Remote Local SingleSTB Largedeployment Testsettings Y Yb Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

readconfiguration writeconfiguration reboot upgradesoftware reflash

Inthefollowinginstructions, <release_name>indicatesthenameofthe softwarereleaseimagedirectorythatcontainsyourAminosoftwarerelease. Forexample, A110-0.14.0-frescoj27-ami_wm-subs-1 installsin 0.14.0-frescoj27-ami_wm-subs-1,hence<release_name>in thiscaseis0.14.0-frescoj27-ami_wm-subs-1.

DOLBY_RF="" REMOTECONF="" IGMP_END_TIMEOUT="30" IGMP_START_TIMEOUT="30" RTSP_SCALE="6" BROWSER_ENABLECOOKIES="Y" BROWSER_HOMEPAGE="about:/start.htm" BROWSER_HELPPAGE=""

SET-TOP BOX CONFIGURATION FILES

Thefollowingexampleshowsasampleconfigurationfilesuppliedwithasoftwarerelease.Inthisexample,no staticnetworksettingsaresetbecauseDHCPissettoY,whichspecifiesthatthesettopboxwillretrievethe networksettingsfromtheDHCPsystem:

SET-TOP BOX CONFIGURATION FILES

NORFlashsettingsarenoteditedviaaseparateconfigurationfile,instead,theycanbeaccessedviathe administrationtools. Ifyouwanttodefinevaluesbeforeloadingthesoftwareimagetothesettopbox,youcandosobyadding

SET-TOP BOX CONFIGURATION FILES

Thechnls.txtfileisnotnormallysuppliedaspartofasoftwarerelease,instead,itiscreatedwhenyoufirst configurechannelsviatheManagementpagesorotheradministrationtool. Ifyouwanttodefinechannelsbeforeloadingthesoftwareimagetothesettopbox,youcandosobycreating thefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage.Alternatively,youcanusethe variousadministrationtoolsavailabletochangesettingsoncesoftwareisloadedtothesettopbox. Oncecreatedorloadedonthesettopbox,thechnls.txtfileisstoredinthefollowinglocation:

SET-TOP BOX CONFIGURATION FILES

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage. Alternatively,youcanusethevariousadministrationtoolsavailabletochangesettingsoncesoftwareis loadedtothesettopbox. Oncecreatedorloadedonthesettopbox,the trsdmns.txtfileisstoredinthefollowinglocation:

macrovision.aminocom.com *.bbc.co.uk *.aminocom.com *.

SET-TOP BOX CONFIGURATION FILES

Important: Therulesspecifiedinthetrsdmns.txt fileareappliedintheordertheyarestated,soyouneed

totakecarewhenaddingdomainstoensurethattherulesareappliedasintended. Forexample,inthefollowingfile,3 specifiesthatMacrovisionandJMACXareenabledforthe macrovision.aminocom.comdomain,and2specifiesthatonlyJMACXisenabledforanyother aminocom.comdomain:

InthefollowingalternativeexamplewiththesamesettingsreorderedonlyJMACXisenabledforany aminocom.comdomain,andsoMacrovisionisnotenabledformacrovision.aminocom.com,eventhough 3wouldnormallyenableMacrovisionsinceMacrovisionforthisdomainhasalreadybeenruledoutinthe previousline:

Theusersettingsfileisnotnormallysuppliedaspartofasoftwarerelease,instead,itiscreatedwhenthe userfirstconfigurespreferencesviathePreferencespages. Ifyouwanttodefinelocalusersettingsbeforeloadingthesoftwareimagetothesettopbox,youcandoso bycreatingthefileinthefollowinglocation:

Thefilewillthenbeincludedwhenyoucreateasoftwareupgradeimage. Alternatively,youcanusethevariousadministrationtoolsavailabletochangesettingsoncesoftwareis loadedtothesettopbox.Preferencespagesandlibconfig(viaTelnet/SSH)canchangevaluesinthisfile.

SET-TOP BOX CONFIGURATION FILES

DOLBY_RF="" DISPLAY_MODE="panscan" SUBTITLES_SECOND_LANG="ita/it" SUBTITLES_PREF_LANG="eng/en" SECONDARY_LANG="fra/fre/fr" PREFERRED_LANG="eng/en"

TheHOSTNAMEfileisnotnormallysuppliedaspartofasoftwarerelease.Itiscreatedwhenyouspecifya hostnameviatheManagementpages. Ifyouwanttodefineahostnamebeforeloadingthesoftwareimagetothesettopbox(notrecommended), youcandosobycreatingthefileinthefollowinglocation:

SET-TOP BOX CONFIGURATION FILES

Theexampleshowshowtoenterthesettingifyouareeditingthehostnamefiledirectly(notethatthevalues areallenclosedinquotationmarks).Seetheappropriatedocumentationforinformationonhowtoenter valuesusingothermeans(forexample,JMACXorlibconfigviaTelnet). Setting

The fkeys.conf filespecifieshowthesettopboxrespondstoremotecontrolkeys.Ifyouwanttochange theconfiguration,youarenotrecommendedtoeditthisfiledirectly.Instead,youshouldusetheJMACX SetKeyFunction andSaveKeyFunctioncommands.SeetheAminoJMACXAPISpecification fordetailsof howtousethesecommands.

Thefollowingsectionshowsapartialexampleofafkeys.conffile,containingentriesforIRkeyboardand theAminoIRremotecontrol.(<...>showswhereseverallineshavebeenremovedtoreducethesizeofthis example).Foracompletelistofalltheremotecontrolkeycodes,seetheAminoJMACXAPISpecification.

SET-TOP BOX CONFIGURATION FILES

0x4000012C 0x4000012E 0x4000012F 0x40000130 0x40000131 0x40000132 0x40000144 <...>

Softwarereleaseswillnormallyincludetheconfigurationfileforthebrowser.ForFresco,thisiscalled config.txt,forOperaitisopera.ini. Oncecreatedorloadedonthesettopbox,theOperaconfigurationfileopera.iniisstoredinthefollowing location:

SET-TOP BOX CONFIGURATION FILES

newURL. Allpoliciesarecheckedinthesameorderinwhichtheyarelocatedinthepolicyfile,thefirstACCESS_POLICY frommatchingpolicyisreturned.

SET-TOP BOX CONFIGURATION FILES

Ifallpoliciesarecheckedandnomatchwasfound,thentheREJECTisreturned. ApolicyismatchingifitsACCESS_URListhesameasURLthatisbeingchecked,unlessACCESS_URLends with*inwhichcaseallURLsthatbeginswithACCESS_URL(without*)arealsofoundasmatched.

SET-TOP BOX CONFIGURATION FILES

STBremoteconfconsistsofaclientapplicationonalocalPCandaserverapplicationSTBrcdinstalledon thesettopbox.STBremoteconf isoperatedbyenteringcommandsatthecommandlineorbycollecting commandsintoascript.

mationrequestedorconfirmationthatthecommandwasexecuted(oranerrorreport)isreturned tothesendingPCfordisplay.Thereisnomulticastresponsechannel,soforcommandssenttoamul ticastgroup,noresponseistransmittedbythesettopboxes.

fromhttp://www.debian.org/releases/stable/andtheinstructionshereassumetheuseofthisplatform. Installationfiles YouwillneedthefollowingfilestoinstallanduseSTBremoteconf:

TheSTBremoteconfclienthasdependenciesonvariousexternalPerlmodules.Iftherequired modulesarenotinstalledonyoursystem,youwillseeerrorssimilartothefollowingwhenyou trytouseSTBremoteconfforthefirsttime:

TheSTBremoteconfclienthasdependenciesonvariousexternalPerlmodules.Youcaneitherinstallthese beforeyoustartinstallingSTBremoteconf,ortryusingSTBremoteconfandtheninstallthePerlmodules requiredonlyiferrorsarereported.

ThefollowingprocedureassumesthatyouhavethePerlCPANmoduleinstalledandhaveinternet connectivity.Youmustbeloggedinasrootorhavesudorights. 1. 2. 3. 4. Enterthefollowingcommand:

Ifthecpan>promptisnotdisplayed,thenyouareaskedtomanuallyconfigureit.Answernotoforce anautoconfigurationforCPAN. Ifyouarepromptedtoinstallanymodules,pressEnterortypeyes. Enterthefollowingcommand:

IfyouhavearecentDebianbasedplatforminstalledyoumaybeableto replacetheabovestageswiththefollowing: Enterthefollowingcommand: apt-get install libdate-manip-perl libmime-base64perl libio-socket-multicast-perl

Inthefollowinginstructions, <release_name>indicatesthenameofthe softwarereleaseimagedirectorythatcontainsyourAminosoftwarerelease. Forexample, A110-0.14.0-frescoj27-ami_wm-subs-1 installsin 0.14.0-frescoj27-ami_wm-subs-1,hence<release_name>in thiscaseis0.14.0-frescoj27-ami_wm-subs-1.

Loginasroot,andcopythe imgcfgtoadirectoryinyourpath(theotherAminobinaries,including mcastbootdmustalsobeinthislocation). Forexample:

CopytheSTBremoteconfandcommandsfilestothelocationyouwanttorunthemfrom.Thiscan beinthesystempathorinanotherlocation,butthetwofilesmustbestoredinthesamedirectory aseachother. Forexample,tocopythefilestoadirectoryinthepath:

macrovision.aminocom.com .bbc.co.uk .aminocom.com *.

Ifallpoliciesarecheckedandnomatchwasfound,thentheREJECTisreturned. ApolicyismatchingifitsACCESS_URListhesameasURLthatisbeingchecked,unlessACCESS_URLends withinwhichcaseallURLsthatbeginswithACCESS_URL(without)arealsofoundasmatched.