Amino 4 Series Configuration Manual

page of 204

/ 204
Bookmarks

Quick Links

Download this manual

Set‐Top Box Configuration Guide

Amino x4x, x5x and x0xx set‐top boxes

August 2018

Document no. AM‐000500‐TC v121

Summary of Contents for Amino 4 Series

Page 1 Set‐Top Box Configuration Guide Amino x4x, x5x and x0xx set‐top boxes August 2018 Document no. AM‐000500‐TC v121...
Page 3 Copyright Set‐top box Configuration Guide August 2018 version 121 © Amino Communications Ltd. 2018 At the time of issue this guide applies to the set‐top boxes (STBs) and software versions listed below: Platform Software version Notes x4x STBs A129 A140 3.3.2 Software version 3.3.2 is an upgrade H140 that runs on all STBs listed under x4x A540PVR STBs M540 x5x STBs A150 5.7.4 x0xx STBs L1050 4.4.12 Amino, AmiNET, and the Amino logo are trademarks of Amino Communications Ltd. All other trademarks are the property of their respective owners. Important Note Modifying the product configuration or hardware may result in the product being in a state whereby local laws are violated. Amino Communications Ltd cannot be held responsible for user changes that result in the product violating local laws. This guide describes components that undergo continual development. The information in this guide is subject to change without notice at any time. There may be visual deviations between graphics in the guide and the released software. Comments about the documentation are welcome. Please submit feedback to docs@aminocom.com. For further information about Amino or Amino products, please e‐mail info@aminocom.com. This guide is to be used in conjunction with the STBs and software versions listed above. It does not refer to older STBs, unless required for clarification of ...
Page 5 Usersettings file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 2.5.1 How to view or change settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.5.2 Example usersettings file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.5.3 Usersettings file contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Hostname file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.6.1 How to view or change settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.6.2 Example Hostname file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 2.6.3 Hostname file contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Function keys file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 2.7.1 How to view or change settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 2.7.2 Example fkeys.conf file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 © Amino Communications Ltd. 2018 INDEX CONTENTS 5 ...
Page 6 4.2.3 Hostname configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 4.2.4 Usersettings configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 4.2.5 DHCPC configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Using libconfig to get and set values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 4.3.1 libconfig‐set command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 4.3.2 To set a value via Telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 4.3.3 To set a value using commands in a script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 4.3.4 To set a value using the JMACX API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Chapter 5— Customising a software upgrade image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Configuring image components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68  6  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 7 6.4.10 Restart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 6.4.11 TVI (H140) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 6.4.12 User Prefs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Configuration page settings for Opera 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 6.5.1 Preferences pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 6.5.2 Management pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Appendix A—NOR Flash settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 NOR Flash settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Primary and Secondary video outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 A.2.1 OUTPUT_RESOLUTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Appendix B—Settings file contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Available settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Remote layout options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 © Amino Communications Ltd. 2018 INDEX CONTENTS 7 ...
Page 8 Appendix F—Recovery from invalid video mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Invalid video modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Invalid video mode recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 F.2.1 How it works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Appendix G—Video output formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 A129, A140, H140, A540PVR, A150 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Appendix H—Pairing an IR remote control with an STB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 On the grey Amino IR remote control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 On the AVC ‘Boat’ IR remote control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 H.2.1 Pairing the STB to the remote control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 On the SRC ‘Willow’ IR remote control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Appendix I—STBremoteconf stats command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Terms explained . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 MAC address ...
Page 9 IR and remotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Using VLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Hard Disk Drives and recording . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 © Amino Communications Ltd. 2018 INDEX CONTENTS 9 ...
Page 11 Introduction About this document This guide applies to all current set‐top boxes (STBs) listed on the Copyright page. STB management offers various means of editing and reading the STB configuration, and controlling STB operation. This guide describes the configurable settings and options available. It assumes you have an STB and access to a suitable software release. It also assumes a basic understanding of the technologies involved, which include Linux command line operation. Important Note Modifying the product configuration or hardware may result in the product being in a state whereby local laws are violated. Amino Communications Ltd cannot be held responsible for user changes that result in the product violating local laws. For information on installing and upgrading Amino software, see the Software Installation and Upgrade Guide (AM‐000501‐TC). Many of the control and customisation options described in this guide can also be implemented using JavaScript Media Access Control Extensions (JMACX) or C API calls using the AmiNET SDK. For more information refer to the JMACX API specification (AM‐000502‐TC) and the SDK User Guide (AM‐001394‐TC). For information on functionality and STBs that are no longer supported, refer to earlier versions of this guide. © Amino Communications Ltd. 2018 INDEX CONTENTS 11 ...
Page 12 Provides configuration examples and other supporting information for NOR Flash. Appendix B, ”Settings file contents“ Provides configuration examples and other supporting information for Settings file instructions. Appendix C, ”DHCPC file contents“ Provides configuration examples and other supporting information for instructions. dhcpc Appendix D, ”Using the configuration Gives methods of using the configuration techniques“ techniques. Appendix E, ”Media source URLs and HLS“ Provides information on constructing media stream URLs, plus information about HTTP Live Streaming (HLS). Appendix F, ”Recovery from invalid video Describes a method of recovering from setting an mode“ invalid video mode. Appendix G, ”Video output formats“ Lists the video output formats for the STBs. Appendix H, ”Pairing an IR remote control with Describes the method of pairing an IR remote an STB“ control with an STB. Appendix I, ”STBremoteconf STATS command“ Describes the descriptors returned by the command. STBRemoteconf stats Appendix J, ”Frequently Asked Questions (FAQs)“  12  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 13 Audience This guide is intended for computer‐literate people, who have a working knowledge of computing and networking principles. It assumes you have an STB and can obtain a suitable software release from the Amino support site, and that you have already performed a basic installation of an Amino STB. It also assumes a basic understanding of the technologies involved, which include: • IP networking • DHCP servers • HTTP servers • Multicast and unicast and the following Linux usage and administration skills: • Performing a SSH login. • Contrasting full and relative pathnames. • Understanding the file system hierarchy. • Handling files with and . • Making and navigating directories. • Listing attributes with • Identifying multiple users and groups. • Interpreting file and directory modes. • Adjusting access permissions: . chmod • Raising privilege with , and ...
Page 14 Document conventions The following document conventions are used: Formatting Usage <...> Indicates a value that you need to replace with a system specific value (except where used in HTML or XML examples, where it is used in tags, as normal). [...] Indicates optional parameters ‐ for example in commands or functions.. | ... Indicates choices – for example where an input can take one of a number of values. Indicates input and output values (for example, at a command line), as well as code font function, configuration, parameter and file names. bold text Used for emphasis and to indicate specific key presses. For example: Press the Esc key. grey text Commands or settings which are not in general use (for example, configuration settings that are reserved for Amino internal use). blue text Cross‐reference (this is a “clickable” hyperlink if you are viewing the document electronically).  14  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 15 Changes and updates for x4x release 2.6.2. Changes and updates for x3x release 0.18.10. Chapter on using configuration pages for Opera 9 now removed (classed as legacy information). February 2012 Corrections: stbremoteconf SETCONFIG and GETCONFIG syntax corrected. NOR FLASH typo corrected to NORFLASH in code examples syntax. December 2011 Changes and updates for x4x releases 2.2.0 ‐ 2.2.6, 2.3.0 ‐ 2.3.5 and 2.4.2 ‐ 2.4.3. Changes and updates for x3x releases 0.18.3 ‐ 0.18.6. January 2011 Added RTSP server source address filtering information (settings file) December 2010 Changes and updates for version 0.17.5 and 0.17.6 (for x3x STBs) releases and version 2.0.0 and 2.1.0 releases (for x4x STBs). November 2010 Changes and updates for version 0.17.3 (for x3x ) and version 1.0.0 (for x4x) releases. Not issued ‐ incorporated into issue 112. August 2010 Changes and updates for version 0.17.2 release. April 2010 New settings options added. March 2010 General updates and corrections. November 2009 New appendix listing options added. DHCPC appendix updated. Netconf Galio support information removed. Please see earlier version of this guide for information relating to the Galio browser. © Amino Communications Ltd. 2018 INDEX CONTENTS 15 ...
Page 16 Issue Date issued Changes November 2009 Chapter 7 added describing the new management and preference pages Configuration page settings are now included in Chapters 6 and 7. Appendix A, B and C have been updated. Guide updated for Opera 9 builds. Appendix G and H are both new. Support information for the AmiNET 120 and 124 removed. Please see earlier version of this guide for information relating to those platforms. June 2009 Removed confidentiality requirement. Password protection warnings added. June 2009 Appendix G updated. Minor corrections. May 2009 General Updates. Board Revision Numbers updated. added. STBremoteconf REFORMAT January 2009 File Access Policy information added. info updated. OUTRES Summary tables updated. Scripts to control STBRemoteconf added. command info corrected. SAVE  16  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 17 Chapter 1—Configuration methods In this Chapter: 1.1 Configuration methods 17  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 18 CONFIGURATION METHODS This chapter provides an outline of the configuration techniques. More detailed descriptions will be provided in later chapters. Not all settings described in this document are available to all STBs. An STB may or may not use a particular configuration option depending on the software build used to create the software image. Configuration methods STB management offers various means of configuring and controlling basic STB operation, for example initiating a software upgrade or a reboot. The techniques that make this possible are described below: • STBremoteconf – A remote configuration tool that enables you to send configuration and control commands across the network to one or more STBs. • Configuration pages – The local configuration pages can be accessed using an Amino Infra‐red (IR) keyboard and television display to change configuration settings and carry out simple commands such as rebooting and initiating software upgrades. The term “Configuration pages” encompasses both the Management pages (for administrators) and the Preferences pages (for users). Some software releases with certain middlewares have their own configuration pages. • Imagecomponents – The imagecomponents are the set of files that a software upgrade image is built from. These include configuration files and graphics files (for example, those used in the display to show that the STB is loading new software). In Table 1.2 below, changing means editing imagecomponents the contents of the directory before creating and signing a new upgrade image. If imagecomponents new files are added they should be added to the file. flashcontents • libconfig commands (via Telnet/SSH) – If an STB has either the Telnet or SSH component installed this can be used to log in to it remotely and carry out configuration using libconfig commands These components are usually not installed for security reasons, so you will need to add them to the software image installed on the STB if you want to use them. • JMACX (JavaScript) – The JavaScript Media Access Control Extensions (JMACX) API offers a full set of functions for controlling STB operation via JavaScript embedded in web pages. See the JMACX API ...
Page 19 Remote Y Y Y Local Y Y Single STB Y Y Y Y Y Large deployment Y Y Y Test settings Y Y Y Table 1.2: a. Not generally recommended, unless performing operations that cannot be done another way, for example, adding a client pro‐ gram. b. Not recommended – settings are only received if the STB is powered. In Table 1.3 below: • Reflash refers to deleting all the contents of the NAND flash and completely replacing the main software image. All configuration options, except those stored in NOR Flash, will be replaced with the configuration contained in the new software image. © Amino Communications Ltd. 2018 INDEX CONTENTS 19 ...
Page 20 CONFIGURATION METHODS • Upgrade refers to replacing just the main software image. In this case, some of the configuration files, for example the user settings, can be preserved. This can be controlled when the software image is built. Operation read configuration Y Y Y Y write configuration Y Y Y Y reboot Y Y Y upgrade software Y Y Y reflash Y Y Y Table 1.3:  20  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 21 Chapter 2—STB configuration files In this Chapter: 2.1 The settings file 2.2 NOR Flash configuration 2.3 Channel changer application 2.4 Trusted domains file 2.5 Usersettings file 2.6 Hostname file 2.7 Function keys file 2.8 Browser configuration files 2.9 The no_analog file 2.10 HDCP policy file 2.11 Dynamic DHCP settings file 2.12 File access policy 2.13 Password 21  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 22 file takes precedence over the file contents, but not all usersettings settings items in the file can be over‐ridden. See details on and which configuration items settings usersettings it supports in the usersettings section of this document. The upgrade system can be configured to specify whether, on an upgrade, the settings file on the STB should be retained or replaced by one held in the new software upgrade image. See the Installation and Upgrade Guide (AM‐000501‐TC) for information on how to control this behaviour. 2.1.1 How to view or change settings An initial settings file is supplied as part of a software release, in the following location: <release_name>/upgradeimage/imagecomponents/ You can edit the file directly or replace it before creating a software upgrade image. Alternatively, settings you can use the various administration tools available to change settings once software is loaded to the STB. Management pages, and (for example, via Telnet/SSH) can all change values in STBremoteconf libconfig this file. Once loaded on the STB, the settings file is stored in the following location: /mnt/nv/ The settings used depends on the software and hardware build. 2.1.2 Example settings file DOLBY_RF="" REMOTECONF="" IGMP_END_TIMEOUT="30" IGMP_START_TIMEOUT="30"  22  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 23 DISPLAY_MODE="panscan" 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" FULLSCREEN="N" 2.1.3 Settings file contents See Appendix B, ”Settings file contents“. NOR Flash configuration The NOR Flash contains settings required by the ROM. In some cases, this can include static network settings. 2.2.1 How to view or change settings NOR Flash settings are not edited via a separate configuration file, instead, they can be accessed via the administration tools. If you want to define values before loading the software image to the STB, you can do so by adding calls to the file. This is an upgrade script that the STB executes when the new libconfig upgrade.sh software image is loaded. If this file does not already exist, create it in the following location: <release_name>/upgradeimage/imagecomponents/ The file will then be included when you create a software upgrade image. The NOR Flash settings example below gives an example of how to add calls to the upgrade script. See Chapter 4, ”Using libconfig“ libconfig for general information on using libconfig Alternatively, you can use the administration tools available to change settings once software is loaded onto the STB. The settings used depend on the software and hardware build. For more information on which settings are used by Opera, see Appendix A, ”NOR Flash settings“. © Amino Communications Ltd. 2018 INDEX CONTENTS 23 ...
Page 24 #!/bin/sh libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_GROUP 239.255.1.1 libconfig-set NORFLASH.MULTICAST_BOOTSTRAP_PORT 11111 libconfig-set NORFLASH.MULTICAST_UPGRADE_GROUP 239.255.1.2 libconfig-set NORFLASH.MULTICAST_UPGRADE_PORT 11111 2.2.3 NOR Flash ‐ list of settings For further information see Appendix A, ”NOR Flash settings“. Channel changer application If you need a basic channel changer application, some example HTML code is available for download from the Amino Support Site at Online Support > Downloads > JMACX and Application Development > channel_changer.tgz The easiest way to use this is to install it on a webserver editing the function (below) to include your init stream addresses: 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");...
Page 25 2 *.aminocom.com 0 *. 2.4.3 Trusted domains file contents The file contains a list of trusted domains, each one on a separate line, with a code that indicates what is enabled. The format for each line is as follows: <code> <url> where: Code that indicates what is enabled for the specified domain. Values can be as follows: <code> – neither Macrovision nor JMACX enabled – Macrovision enabled, JMACX disabled (unlikely to need setting) – JMACX enabled, Macrovision disabled – Both JMACX and Macrovision enabled The URL for the trusted domain. This can use asterisks as wildcards. <url> For example: 3 *.aminocom.com Important: The rules specified in the file are applied in the order they are stated, so when trsdmns.txt adding domains ensure that the rules are applied as you intend. For example, in the following file, specifies that Macrovision and JMACX are enabled for the domain, and specifies that only JMACX is enabled for any other macrovision.aminocom.com domain: aminocom.com 3 macrovision.aminocom.com 2 *.aminocom.com © Amino Communications Ltd. 2018 INDEX CONTENTS 25 ...
Page 26 Usersettings file The file contains settings that the STB user can control (through the Preferences pages). usersettings These override the values specified for the same settings in the settings file. 2.5.1 How to view or change settings The file is not normally supplied as part of a software release, instead, it is created when the usersettings user first configures preferences via the Preferences pages. If you want to define local user settings before loading the software image to the STB, you can do so by creating the file in the following location: <release_name>/upgradeimage/imagecomponents/ The file will then be included when you create a software upgrade image. Alternatively, you can use the various administration tools available to change settings once software is loaded to the STB. Preferences pages and libconfig (via Telnet/SSH) can be used to change values in this file. Values set via the usersettings file override the value for the same configuration setting elsewhere, for example, in the settings file. Once created or loaded on the STB, the file is stored in the following location: usersettings /mnt/nv/ The settings used depend on the software build. Chapter For more information about which settings are used by Opera 11, see 6, ”STB configuration pages for Opera 11 onwards“ 2.5.2 Example usersettings file DOLBY_RF="" DISPLAY_MODE="panscan" SUBTITLES_SECOND_LANG="ita/it" SUBTITLES_PREF_LANG="eng/en" SECONDARY_LANG="fra/fre/fr" PREFERRED_LANG="eng/en"  26  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 27 Once created or loaded on the STB, the file is stored in the following location: hostname /etc 2.6.2 Example Hostname file TThe file contains just a single word that specifies the name of the STB, for example or the hostname stb001 default AMINET Function keys file file specifies how the STB responds to remote control keys. If you want to change the fkeys.conf configuration, you are not recommended to edit this file directly. Instead, it is recommended that a JavaScript key handler is used to determine the functionality of the remote control keys. Although the JMACX and commands can be used (see How to view or change settings SetKeyFunction SaveKeyFunction below), these two commands are now deprecated. fkeys.conf was deprecated in software version 2.5.7, but has been reinstated from version 2.6.1. If you are using version 2.5.7 you should use the standard JavaScript key handling mechanisms to provide equivalent functionality in your portals. Alternatively, the Opera user.js file can be used to provide system‐wide key handling. 2.7.1 How to view or change settings An initial file is supplied as part of a software release, in the following location: fkeys.conf <release_name>/upgradeimage/imagecomponents/ Use the JMACX functions to set the key functions: © Amino Communications Ltd. 2018 INDEX CONTENTS 27 ...
Page 28 # Browser Reload 0x40000069 5 # Browser Stop 0x4000006A 2 # Browser Goto <...> # Now the amino remote mappings 0x40000003 0 # Last Ch 0x4000012C 18 # Channel Up= Browser Ch Up 0x4000012E 19 # Channel Down= Browser Ch Down...
Page 29 For first time users who are not familiar with modifying software images, there is a publicly available pre‐ signed Ekioh image with these changes made here: http://stbsupport.aminocom.com/upgrade/3.2.1.beenius.mcfs no_analog file If you add the file to your image components it will disable video from the analogue output of the no_analog STB after upgrading. Disabling the analogue output can be a requirement for some hospitality deployments, or for content providers who require that content can only be played via HDMI If you add a no_analog file to your image and upgrade, you can only remove the no analogue feature by removing the file from your image, re‐signing the image and upgrading again without the file present. 2.10 HDCP policy file The file allows you to override the default state of HDCP authentication. hdcp_policy For x4x STBs, the default state of HDCP authentication is off. For x5x and x0xx STBs the default state of HDCP authentication is on. © Amino Communications Ltd. 2018 INDEX CONTENTS 29 ...
Page 30 2.11.1 How to view settings The DHCPC values are stored in the following location on the STB: /var/dhcpc/dhcpcd-eth0.info The values can be accessed via commands (using Telnet/SSH) or JMACX calls. libconfig 2.11.2 DHCPC ‐ list of settings The full list of DHCPC settings available depends on the DHCP server installed and the vendor options configured, that is, it depends on what values the DHCP server sends to the STB. The following table describes the main settings that are generally available. All values are read‐only. Setting Description The address of the page set as the homepage. BROWSER_HOMEPAGE The deployment index. The minimum deployment index DIMIN The IP address of the DNS that the STB should be using. The network domain. DOMAIN The gateway for the STB. GATEWAY The IP address of the STB. IPADDR The DHCP lease time. LEASE The multicast file system IP address. MULTICAST_FS_ADDR The multicast file system port. MULTICAST_FS_PORT The netmask for the STB. NETMASK  30  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 31 : Access to URL will be granted, but policy will not invalidate password‐protection on entering IGNORE new URL. All policies are checked in the same order in which they are located in the policy file, the first ACCESS_POLICY from matching policy is returned. If all policies are checked and no match was found, then the is returned. REJECT A policy is matching if its is the same as the URL that is being checked, unless ACCESS_URL ACCESS_URL ends with in which case all URLs that begin with (without ) are also found as matched. ACCESS_URL 2.12.1.1 Default policies #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* © Amino Communications Ltd. 2018 INDEX CONTENTS 31 ...
Page 32 STB CONFIGURATION FILES #Password protect rest of the docs PASSWORD:file:///etc/htdocs/* 2.12.1.2 Example policy file ACCEPT:file://mnt/nv/startup.html ACCEPT:file://mnt/nv/nonetaccess.html 2.13 Password Software releases store the passwords in encrypted form in /mnt/nv/passwd and /mnt/nv/shadow. During STB boot these are copied to /etc/passwd and /etc/shadow. Warning: Amino strongly recommends that you change the default passwords when deploying our STBs. See the Installation and Upgrade Guide for information on changing these default passwords.  32  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 33 Chapter 3—Using STBremoteconf In this Chapter: 3.1 STBremoteconf 3.2 Installation 3.3 Sending commands with STBremoteconf 3.4 Using scripts to control STBremoteconf 3.5 STBremoteconf parameter syntax 3.6 List of commands 3.7 STBremoteconf key changing 33  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 34 STB. STBremoteconf is operated by entering commands at the command line or by collecting commands into a script. A normal operational sequence is as follows: 1. Enter command: The user enters a command at the command line on the PC. This includes specifying whether the command is to be sent to a single STB, sent to a multicast group, or saved for later use. 2. Sign command: The user is prompted to enter the passphrase for the configuration key, and then STBremoteconf signs the command. It also adds an expiry time after which the command will no longer be valid. By default this is 30 seconds after the time at which the command was signed. 3. Send command: If the command is to be sent to a single STB or to a multicast group, it is sent immediately. If the command is saved to be sent later, a confirmation confirms that it has been saved, and a separate STBremoteconf command allows saved commands to be sent. 4. Verify command: When the STB receives a command, the STB also uses its stored public configuration key to check that the command has been authorised, and rejects commands that are not authorised. It then checks the expiry time for the command against its internal clock. If the current time is later than the expiry time, it rejects it. This ensures that even if signed commands are used in a capture and replay attack, replaying them later will have no effect on the STBs. For this reason, the STB and the PC on which the STBremoteconf client is installed must use correct date and time settings. 5. Execute command: The STB executes the command using , and generates the appropriate STBrc response. 6. Command response: A response containing the information requested or confirmation that the command was executed (or an error report) is returned to the sending PC for display. Installation STBremoteconf is normally installed as part of an multicast system. If a multicast system is not installed, follow the multicast system installation instructions in the Installation and Upgrade Guide (AM‐000501‐TC).  34  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 35 2. Installation files You will need the following files to install and use STBremoteconf: • STBremoteconf • imgcfg • commands These files are normally supplied in the subdirectory of a full software release, and are installed utils/ as part of the multicast system set‐up. If this has already been done, then there is nothing else to do to complete the installation. 3. To sign commands that you send with STBremoteconf, you will also need: • A private configuration key file – if you are using the Amino engineering keys, this is STBrc- (this must match the public key file on the STB) KEY.private • Perl modules The STBremoteconf client has dependencies on various external Perl modules. If the required modules are not installed on your system, you will see errors similar to the following when you try to use STBremoteconf for the first time: Can't locate IO/Socket/Multicast.pm in @INC (@INC contains: /usr/lib/perl5/5.8.1/i386-linux-thread-multi... If this happens, you can download and install the required files. Important note The pc on which STBremoteconf is installed must use correct date and time settings. This is a fundamental requirement for proper operation of the STB and STBremoteconf. If no time is provided to the STB then the time will be ...
Page 36 5. Enter the following command: install Date::Manip If you are prompted to install dependencies, enter 6. Enter the following command: install MIME::Base64 If you are prompted to install dependencies, enter 7. Enter the following command: install File::Copy If you are prompted to install dependencies, enter 8. Enter the following command: install IO::Socket::Multicast If you are prompted to install dependencies, enter 9. Enter the following command: quit You now have all of the required Perl modules installed and your STBremoteconf client should now work. If you have a recent Debian‐based platform installed you may be able to replace the above stages with the following: Enter the following command: apt-get install libdate-manip-perl libmime-base64- perl libio-socket-multicast-perl 3.2.4 Upgrading STBremoteconf STBremoteconf client can be installed or upgraded separately from upgrades to STB software, but if the client and STB applications are at different versions, only the functionality of the older version will be available. For  36  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 37 STBremoteconf you will need to delete the following files: • STBremoteconf • imgcfg • commands These files are normally supplied in the subdirectory of a full software release. utils Sending commands with STBremoteconf The following steps outline an example command line interaction with STBremoteconf. 3.3.1 To send a command at the command line The following steps assume you have not copied the STBremoteconf files to a directory in the system path (for example, ). If you have copied the files, you do not need to navigate to the directory that /usr/local/bin the file is stored in, and you do not need to enter at the start of each command. STBremoteconf 1. Set the environment variable by entering a command in the following format: STBKEY export STBKEY=<release_name>/utils/keys/amino/STBrc-KEY.private In order to set STBKEY as a permanent environment variable, add the above export command to your .bashrc file. 2. Navigate to the directory that the file is located in. STBremoteconf For example: © Amino Communications Ltd. 2018 INDEX CONTENTS 37 ...
Page 38 USING STBREMOTECONF cd <release_name>/utils 3. Enter a command in the following format: ./STBremoteconf [<optional_arguments>] <host>  <command_option [parameter]> See Example commands for examples of this syntax in use. 4. You are prompted to enter the passphrase for the configuration key. For the Amino engineering configuration key this is . stbrckey The passphrase can be set as the environment variable STBPASS, in the same way as for the STBKEY variable If the command syntax and IP address(es) entered are valid, the client command is sent. For unicast operations (that is, commands sent to a single STB) a confirmation message is displayed which includes a status code returned by the STB. For multicast operations, only some commands will receive a confirmation message, for example GETVERSION. If you have your own keys then you will have your own, different, passphrase. You can now enter further commands as required. 3.3.1.1 Example commands For example, enter the following commands to find out the software version on an A540 STB: Unicast ./STBremoteconf -p 540 10.172.247.235 GETVERSION Multicast ./STBremoteconf -p 540 225.10.10.10 GETVERSION To find out the software version on an M540 STB:...
Page 39 "8:00pm December tenth" Port to send the command on. -P <port> For unicast, the default port is 54321 For multicast, the default port is 22222 The argument that specifies where the <host> host command will be sent or enables you to save the command for use later. See below for more information. optional mac address in format 00:02:02:xx:xx:xx (cannot be used in conjunction with ‐s or ‐p). A maximum of five STBs can be contacted using MAC addresses. The command that will be executed (see <command_options <command_options> argument) [<parameters>...]> optional TTL value for multicast (defaults to 10). optional serial number (cannot be used in conjunction with ‐m or ‐p). optional UDP response timeout (number 1‐999) (defaults to 10). Alternatively, you can enter the command without any arguments to display help at the ./STBremoteconf command line. If you have copied the STBremoteconf file to a directory in the system path (for example, /usr/bin), you can enter the commands without the ./ at the start. © Amino Communications Ltd. 2018 INDEX CONTENTS 39 ...
Page 40 Couldn’t connect: Connection refused 3.5.2 Save To sign a command and save it for multicasting or unicasting later, replace with . This is useful <host> SAVE as it allows you to collect multiple signed commands together to be transmitted altogether later, or to give a signed command to a third party that it is not appropriate to give keys to. STBremoteconf saves the signed command to a file in the current directory, and you can SAVEFILE.msg send it later using the command option. SIGNEDCMD Although the SAVE command can be used to create a batch of multicast or unicast commands, the expiry time from when the command is signed still applies (default is 30 seconds). This means that each command must be multicast/unicast before its expiry time is reached. The -e parameter can be used to specify a longer expiry time. For example: STBremoteconf -e "December 16th 2009" SAVE REBOOT 3.5.3 <command_options> argument The argument must be included in all commands, and specifies the operation you want <command_options> to execute. Some options also require additional parameters. See Overview of command options for a list of available options.  40  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 41 GETVERSION Returns the current software version on the STB. HWINFO Returns information about the STB hardware. LOGREAD Returns last few entries from syslog. OUTFMT Sets the output format of the STB. <format> OUTRES Sets the output resolution. (HD‐capable STBs only) PING Instructs the STB to send ICMP echo (ping) <remote_host> <count> requests to a remote host. <backoff_secs> PROC Sends specified proc entry to the STB. <proc_entry> Runs the ps process on the STB. REBOOT Reboots the STB. REFLASH Wipes the NAND flash on the STB, then downloads new software. REFORMAT (Minerva and Evo only) Sets a flag on the STB to reformat the hard drive after a reboot. The STB will reboot to perform this command. RFMODE Enables/disables or resets the RF modulator (if <option> present) on the STB. © Amino Communications Ltd. 2018 INDEX CONTENTS 41 ...
Page 42 The following is a list of the STBremoteconf commands supported at present. CEC_TVON Switches on the TV using CEC source and destination codes. Usage ./STBremoteconf <host> CEC_TVON [source] [destination] Example ./STBremoteconf 10.172.227.145 CEC_TVON CEC_TVOFF Switches off the TV using CEC source and destination codes. Usage ./STBremoteconf <host> CEC_TVOFF [source] [destination] Example ./STBremoteconf 10.172.227.145 CEC_TVOFF CEC_CMD Sends a CEC command. Usage ./STBremoteconf <host> CEC_CMD <cmd byte string> [source] [destination]  42  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 43 ./STBremoteconf 10.172.227.145 CEC_CMD 04 To send the TV to standby (an alternative to CEC_TVOFF) ./STBremoteconf 10.172.227.145 CEC_CMD 36 CHANGEPAGE Instructs the web browser to go to a specific URL. Whatever the user is viewing at the time will be interrupted. Usage ./STBremoteconf <host> CHANGEPAGE <url> This does not currently work for igmp urls when using Ekioh 3.4.0. Example ./STBremoteconf 225.10.10.10 CHANGEPAGE “http://www.aminocom.com” The CHANGEPAGE command was previously unable to use fragment identifiers (#) in URLs. The fragment identifier # has now been replaced by a space character. For example, instead of sending: “#|changepage|http://www.jsperf.com/faq#autorun|#1380642103#” the command sent is: “ |changepage|http://www.jsperf.com/faq autorun| 1380642103 ” CUSTOMCMD Sends a custom command Usage ./STBremoteconf <host> CUSTOMCMD.sh <url> © Amino Communications Ltd. 2018 INDEX CONTENTS 43 ...
Page 44 // 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”; For further information see TN024 ‐ Using AminoGeneric. Certain characters cannot be used in the EAS message: A message containing # or | will fail to get through. A message containing ' will fail to get through and will change the undefined AminoGeneric.onEvent13 registration to which causes all following EAS messages to fail to get through.  44  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 45 /STBremoteconf <host> ETHERNET <value> Example /STBremoteconf 225.10.10.10 ETHERNET 100FD GETCONFIG see SETCONFIG GETDI Returns the deployment index. This command is only useful via unicast. Usage ./STBremoteconf <host> GETDI Example ./STBremoteconf 10.172.227.145 GETDI GETSTAT Returns the following statistics: maximum, minimum and current temperature, system uptime and HDD self‐monitoring (SMART) Not currently supported on x0xx STBs Usage (Non x4x STBs) ./STBremoteconf <host> GETSTAT System.Uptime ./STBremoteconf <host> GETSTAT System.TotalUptime ./STBremoteconf <host> GETSTAT Fan.OffDuration © Amino Communications Ltd. 2018 INDEX CONTENTS 45 ...
Page 46 ./STBremoteconf 10.172.227.145 GETSTAT Temp.Current  G ETVERSION Returns the software version of an STB. This command is only available via unicast. Usage ./STBremoteconf <host> GETVERSION Example ./STBremoteconf 10.172.227.145 GETVERSION Example response Got back: 2.7.1-opera11 HWINFO Returns the product, board revision and ROM type of the STBs. For unicast only. Usage ./STBremoteconf <host> HWINFO Example ./STBremoteconf 10.172.227.145 HWINFO Example response aminet130 (revision 2) ROM type: 0xc222-SS-S4  46  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 47 ./STBremoteconf <host> OUTFMT <new output format> Example ./STBremoteconf 225.10.10.10 OUTFMT CVBS-LC The options are: Value Meaning Enable composite output without “CVBS-RGBOFF” RGB (where available) Enable composite output with RGB “CVBS-RGBON” (where available) Enable S‐video output without RGB “LC-RGBOFF” (where available) Enable S‐video output with RGB “LC-RGBON” (where available) Enable composite with S‐Video “CVBS-LC” (where available) Enable composite and component “CVBS-LBR” (YPbPr) (where available) Enable composite, S‐video and  “LBR-CVBS-LC” component (YPbPr) (where available) Enable RGB with composite with  “RGB-CVBS-LC” S‐video outputs (where available) © Amino Communications Ltd. 2018 INDEX CONTENTS 47 ...
Page 48 STBs, this command can be multicast and then the network can be monitored for replies, to determine which STBs received the message. Usage ./STBremoteconf <host> PING <remote_host> <count> <backoff_secs> where Specifies the number of echo requests to send. <count> Specifies how long to wait before sending the first request (in seconds). If you specify a <backoff_secs> backoff_secs parameter of zero, the STB sends the ICMP echo requests as soon as it receives the message. If backoff_secs is greater than zero, the STB waits a random time interval between zero and backoff_secs seconds before sending the first ICMP echo, followed by one second between each request. Example ./STBremoteconf 225.10.10.10 PING 139.255.1.1 10 0 PROC Queries the STB for the value of the specified entry, for example, to query memory usage. proc The Linux command cat /proc/<proc_entry> will give the same information as using PROC <proc_entry>. This command is only useful via unicast.  48  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 49 on the STB. This command is only useful via unicast. displays information about a selection of the active processes. Usage ./STBremoteconf <host> PS [option] The only option presently available is the -w switch, which increases the number of characters displayed on each line of output from the ps command from 79 to 255. Example ./STBremoteconf 10.172.227.145 PS -w REBOOT Triggers a reboot of the STB, which is most useful when restarting the device after making configuration changes in unicast mode. The command returns a status code indicating whether the command was accepted. Not permitted in multicast mode. The STB automatically reboots after some commands, such as a MCAST_UPGRADE. Usage ./STBremoteconf <host> REBOOT Example ./STBremoteconf 10.172.227.145 REBOOT REFLASH Requests a reflash of the STB. Reflashing refers to deleting all the contents of the NAND flash and replacing the main software image ( ). The update is done by using the Recovery Image (RI) stored in the NAND mcs.mfs flash. © Amino Communications Ltd. 2018 INDEX CONTENTS 49 ...
Page 50 ./STBremoteconf 225.10.10.10 REFLASH REFORMAT The REFORMAT command is for Minerva and Evo clients only. It sets a flag on the STB to reformat the hard drive after a reboot. STBs that do not have a hard drive will not be affected. The STB will reboot to perform this command. The command returns a status code indicating whether the command was accepted. Warning: All the content of the hard drive will be erased if you issue this command This command is not permitted in multicast. Usage ./STBremoteconf <host> REFORMAT Example ./STBremoteconf 10.172.247.235 REFORMAT RFMODE Enables or disables the RF modulator (if present) and/or changes the current RF channel. The following options are available: Option Description Sets the RF channel to <channel> ENABLE <channel> and enables the RF modulator. Sets the RF channel to <channel> DISABLE <channel> and disables the RF modulator.  50  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 51 Command Set $Revision: 1.25 $ Multicasting... This command will affect every box listening on this network Are you sure? [Y/N]: y Sending following command: #|setconfig|NORFLASH.OUTPUT_RESOLUTION|#1329299052# copying from '/tmp/STBremoteconf.24757/TMPFILE' to '/tmp/STBremoteconf.24757/ TMPFILE.signed' Signed image written to '/tmp/STBremoteconf.24757/TMPFILE.signed' © Amino Communications Ltd. 2018 INDEX CONTENTS 51 ...
Page 52 In this multicast example the command argument is used to get the output resolution -p <product_list> from a group of A140 STBs: ./STBremoteconf -p A140 225.10.10.10 GETCONFIG NORFLASH.OUTPUT_RESOLUTION Amino STBremoteconf $Revision: 1.29 $: Command Set $Revision: 1.25 $ Multicasting... This command will affect every box listening on this network Are you sure? [Y/N]: y Sending following command: #|getconfig|NORFLASH.OUTPUT_RESOLUTION|#1327318039#|A140|#...
Page 53 command on the STB. ifconfig Further information about the command and a description of the stats Appendix I, ”STBremoteconf STATS returned parameters is available in command“ Usage ./STBremoteconf <host> STATS Example ./STBremoteconf 10.172.227.145 STATS TVSYSTEM Changes the TV standard to one of a predefined set of values. The following options are available: Value Example region PAL-I Brazil PAL-M Argentina PAL-N Europe PAL-G Australia, Ghana PAL-B Belgium PAL-H Japan NTSC-J NTSC-M © Amino Communications Ltd. 2018 INDEX CONTENTS 53 ...
Page 54 Multicast upgrade ./STBremoteconf <host> UPGRADE igmp:// <Multicast Upgrade address>: <Upgrade port number> Examples Unicast upgrade ./STBremoteconf 10.172.227.145 UPGRADE http://10.172.227.145/mc2.mcfs Multicast upgrade ./STBremoteconf 10.172.227.145 UPGRADE igmp://239.255.230.100: 12345 Allows remote video on demand operations to be executed. For example, a operation may be required PAUSE before you can send another command. Not currently supported on x0xx STBs The following video on demand operations are supported: PLAY PAUSE STOP VOD PLAY should only be used to resume from a PAUSE state. To initiate a new video on demand session remotely, use the CHANGEPAGE command to point to the required video on demand resource.  54  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 55 • Amino keys on your system ( , which is delivered with each software build). KEY.private 3.7.2 Preparing a new STBrc‐KEY 1. Generate a new keyfile and passphrase using the RSA key generating utility :  rsakey . rsakey -g -f STBrc-KEY 2. Enter your own passphrase when prompted (twice). The result will be 2 files: STBrc-KEY.public STBrc-KEY.private Sign the new public key with your Customer key (this example uses the generic Amino customer key):  $ imgcfg sign -f STBrc-KEY.public -o STBrc-KEY.public.signed -k /usr/local/ keys/amino/KEY.private -w "markskey" © Amino Communications Ltd. 2018 INDEX CONTENTS 55 ...
Page 56 USING STBREMOTECONF 3. Copy the newly generated into your software image (in this example STBrc-KEY.public.signed is used):  Ax4x-2.7.1-opera11 $ cp STBrc-KEY.public.signed Ax4x-2.7.1-opera11/upgradeimage/ imagecomponents/bin 4. Copy the into on your PC. STBrc-KEY.private /usr/local/keys/MYKEYS/ 5. Run the signupgrade image as normal and copy the result to the usual place. 6. Flash the STB. View the serial debug log ‐ you will see the following message confirming your key is being installed:  56  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 57 Chapter 4—Using libconfig In this Chapter: 4.1 Before you start 4.2 libconfig configuration areas 4.3 Using libconfig to get and set values 57  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 58 4.2.1 NOR Flash configuration The NOR Flash contains settings required by the ROM. In some cases, this can include static network settings. 4.2.1.1 libconfig prefix To create the key for use in libconfig commands, prefix the setting name with . For example, for the NORFLASH setting, the libconfig key is NORFLASH.DI 4.2.2 Settings configuration The file contains various STB settings, such as languages, volume ranges and keyboard settings configuration. 4.2.2.1 libconfig prefix To create the key for use in commands, prefix the setting name with . For example, to libconfig SETTINGS access the setting, the libconfig key is RTSPSERVER SETTINGS.RTSPSERVER For example: libconfig-set SETTINGS.RTSPSERVER bitband  58  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 59 To create the key for use in libconfig commands, prefix the setting name with . For example, USERSETTINGS for the setting, the libconfig key is PREFERRED_LANG USERSETTINGS.PREFERRED_LANG 4.2.5 DHCPC configuration The dynamic network and multicast upgrade settings retrieved from the DHCP server are stored in a file called . These values are only set if the STB uses dynamic network and multicast upgrade dhcpcd-eth0.info settings, otherwise, the static values are defined in the NOR Flash. The DHCPC values are read‐only. 4.2.5.1 libconfig prefix To create the key for use in libconfig commands, prefix the setting name with . For example, for the DHCPC setting, the libconfig key is DHCPC.DNS Using libconfig to get and set values The following section describes how to set new configuration values. We provide a command line utility to set configuration values. can be used to query the values. libconfig-set libconfig-get 4.3.1 libconfig‐set command syntax The libconfig commands for setting and querying STB configuration have similar syntax. To set, use: libconfig-set <config_key> “value” To query, use: libconfig-get <config_key> © Amino Communications Ltd. 2018 INDEX CONTENTS 59 ...
Page 60 4.3.2 To set a value via Telnet The following steps outline how to send commands via Telnet. libconfig Telnet is usually disabled for security reasons. 1. From a console window, Telnet to the STB. For example, if your STB has an IP address 123.4.5.67, enter the following command: telnet 123.4.5.67 2. You are prompted to enter log‐in details. The user name to log in as is , the password is root (unless you have changed the password for the root user). root2root 3. Enter commands, as required. libconfig For example: libconfig-get SETTINGS.DELAY_FACTOR This command returns the setting from the file on the STB, and displays DELAY_FACTOR SETTINGS it in the console, if you request a setting for which no value is set, then no return value is displayed. For example: libconfig-set SETTINGS.DELAY_FACTOR 5 The new value ( ) is confirmed in the console, followed by a note of the value you replaced:  60  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 61 4. When you have finished, exit Telnet by typing the following command: quit 4.3.3 To set a value using commands in a script This is particularly useful if you need to use set values in multiple STBs – for example, to set static network settings. For an example of this, see Creating an upgrade script on page 65. 4.3.4 To set a value using the JMACX API The functions in the JMACX API call functions (see the ASTB.SetConfig ASTB.GetConfig libconfig Amino JMACX API specification AM‐000502‐TC for more information). The STB management pages also use the function to modify settings. ASTB.SETConfig GetConfig Commands take the form: ASTB.SetConfig (<password> , <config_item> , <value>) Example use ASTB.SetConfig (<password>, “SETTINGS.DELAY_FACTOR”, “5”) ASTB.GetConfig (“SETTINGS.DELAY_FACTOR”) Parameters Allowed values Description The password for the ...
Page 63 Chapter 5—Customising a software upgrade image In this Chapter: 5.1 Configuring image components 5.2 Editing the flashcontents file 5.3 Creating an upgrade script 5.4 Enabling remote log‐in tools 5.5 Customising graphics 5.6 Customising upgrade splashscreens 63  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 64 Ax5x-4.3.3-Opera12 installs in 4.3.3-Ax5x- opera12, hence <release_name> is 4.3.3-Ax5x-opera12. 1. Open the file that you want to edit. The image component files are in the following location: <release_name>/upgradeimage/imagecomponents Alternatively, you can add a new file to this location, such as a file you have copied from chnls.txt a pre‐configured STB or an file that contains commands to set NOR Flash upgrade.sh libconfig values. 2. Edit the file, and save your changes. 3. Open the file, and ensure that the file you have added/edited is listed there. This flashcontents file is in the following location: <release_name>/upgradeimage The file lists the files that will be included in a software upgrade image, and defines flashcontents permissions for the files. 4. Use the script to create the software image, as usual. signupgradeimage The new software upgrade image includes your new or edited files, and you can use it to upgrade your STBs.  64  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 65 upgrade.sh script). • Executable image component files must be listed as either or , otherwise the signupgradeimage script will fail to create the software upgrade image. • All files in the directory must be listed in the file, otherwise, the imagecomponents/ flashcontents script will fail. If a file is listed in the file but is not present in signupgradeimage flashcontents the directory, it will not affect the script. imagecomponents/ signupgradeimage 5.2.2 File naming Files names must not be longer than 12 characters. For further information on the file, see flashcontents the Amino Installation and Upgrade Guide. Creating an upgrade script An upgrade script contains commands that the STB executes when a new software upgrade upgrade.sh image is installed. The script is created and installed on the STB as part of a software image, and is only executed once, then deleted. © Amino Communications Ltd. 2018 INDEX CONTENTS 65 ...
Page 66 file, with its permission set to . flashcontents The script is executed automatically when this software image is installed on the STB and is then deleted. Enabling remote log‐in tools Telnet or SSH(Dropbear) can be included in the software installed on an STB (the tool available depends on the platform), in order to enable remote log‐in – for example, to access configuration via libconfig commands. Amino advise that you us SSH(dropbear) where possible as some content providers insist that STBs do not have Telnet support for security reasons. If you want to use Telnet please contact Amino Customer Support for assistance. 5.4.1 Remote log‐in tool availability On the x4x platform, the remote log‐in tools (Telnet/SSH(Dropbear)) are included as part of a standard software build or software image but are disabled by default for security. For example to enable startup of the Telnet daemon at bootup, include a script in , for example, or imagecomponents rc.ca_app rc.dmn_app For example: #!/bin/sh # modules start / stop. . /etc/rc.config case "$1" in start) echo "Loading telnetd"...
Page 67 CUSTOMISING A SOFTWARE UPGRADE IMAGE Customising graphics You can replace the graphic displayed during STB booting. For TFTP booting STBs, it is also possible to replace the graphic shown during software upgrades. 5.5.1 Changing the ‘bootloader splashscreen’ The bootloader splashscreen is the black and white television graphic: For x4x series STBs, the graphic is in a proprietary format and cannot be changed by the user. For x0xx and x5x series STBs, the graphic is in the <release_name>/upgradeimage/imagecomponents/ folder and is named . The graphic is a .bmp file for x0xx series STBs and a gif bootloader.branding file for x5x series STBs. You can replace it with your own bmp or gif file that must be renamed . bootloader.branding 5.5.2 Other graphics used by the STB The following graphics are examples of the default graphics supplied with a software release and are known as the ‘Amino splash screens’: 5.5.2.1 splash.gif The default graphic shown on screen when the STB is booting is as shown: 5.5.2.2 loading.gif © Amino Communications Ltd. 2018 INDEX CONTENTS 67 ...
Page 68 5.5.2.3 Replacing the default graphics with your own You can replace the default graphics with your own by replacing the gif files in the image components used to build a new software upgrade image, then upgrading the software on an STB to use this new software image. When using your own graphics, please note the following points: • Each graphic must be a gif with the same name as the file you are replacing. • Animated gifs are not supported (using an animated gif will prevent the STB from booting). • gifs must be less than 640 x 400 pixels. If the gif is larger than the screen dimensions, it will not be displayed. • Transparent gifs are not supported, but if you set the transparent colour to , the background colour will be undefined. • gifs with profile data are not supported. Profiles can be stripped using tools such as Graphics Magick (http://www.graphicsmagick.org/) and the command gm convert +profile "*" in.gif out.gif • The graphic is always centred on the screen when it is displayed. Customising upgrade splashscreens The upgrade splashscreens can be configured to display your corporate logo or choice of graphic, and the status of the upgrade can be displayed in your corporate font and re‐phrased if required. Furthermore the error codes that are represented by the flashing LED can be displayed numerically on the screen. Configuration of the splashscreen uses three "regions" on the screen. Region 1 is the top 2/3 and is used for displaying the logo. The remaining 1/3 is split into two regions where region 2 displays the stage of the upgrade (for example ‘fetching data’ or ‘Installing. Do not unplug’ ) and region 3 is used to display the two digits of the error code. Customising the upgrade display consists of simply replacing the graphics used for the display with your own graphics to create a display in your preferred format, font, colour etc.  68  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 69 CUSTOMISING A SOFTWARE UPGRADE IMAGE The supplied graphics are located in upgradeimage\imagecomponents\upgrade_branding.tgz Replace the graphics in the .tgz file with your own. When you use your own graphics, you must keep the same filenames as those given in the release because the upgrade script will look for those filenames. For example, your logo must be called l ogo.gif. The following diagram shows how you can assemble your customised upgrade display by substituting the graphics provided in the release image with your own: © Amino Communications Ltd. 2018 INDEX CONTENTS 69 ...
Page 71 Chapter 6—STB configuration pages for Opera 11 onwards In this Chapter: 6.1 About the STB configuration pages 6.2 Getting started 6.3 Preferences pages 6.4 Management pages 6.5 Configuration page settings for Opera 11 71  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 72 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS This chapter describes how to use the Amino STB configuration pages that provide customisation options for both administrators and end‐users. The screenshots for the Preferences and Management pages shown in this chapter are examples from an H140 STB, with a standard Amino/Opera homepage. Your installation will not show exactly the same screenshots if you are using a different model of STB. About the STB configuration pages STBs with browsers include HTML configuration pages that enable local access and editing of configuration areas. The configuration pages consist of a user area (Preferences pages) and an administrator area (Management pages). After booting, the STB will present the home page.  72  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 73 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS Preferences pages main menu (H140) Management pages main menu (H140) Getting started The instructions in this section assume that the STB you want to communicate with is powered and connected to the network. To use the Preferences pages, you will need the following: • An IR remote control or Amino IR keyboard To use the Management pages, you will need the following: • An Amino IR keyboard (optionally also an IR remote control) © Amino Communications Ltd. 2018 INDEX CONTENTS 73 ...
Page 74 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS • You will need to know the password for the and user names on the STB. mngread mngwrite These are and respectively if you have not changed the defaults. leaves snake Warning: Amino strongly recommends that you change the default passwords when deploying our STBs. See the Amino Installation and Upgrade Guide for information on changing these default passwords. 6.2.1 Using a keyboard or remote control with the configuration pages The table below shows which remote control buttons and keyboard keys enable important functionality. Functionality Remote control Keyboard Display Preferences page MENU button Alt+P key combination or main menu. Settings button Display Management ‐ Alt+M key combination, pages main menu. then password Move around the items on ...
Page 75 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 2. Use the arrow buttons to navigate to the setting you want to change. 3. Press OK or the right arrow button to display the secondary menu on the right hand side of the page. 4. Use the arrow buttons to navigate to the setting you want to change. 5. Press OK ‐ the setting will display arrows if there is a choice of values. Navigate through these values using the left or right arrow buttons. When you have found the setting you want press OK again. 6. Change any other settings you require, then exit the Preferences pages. © Amino Communications Ltd. 2018 INDEX CONTENTS 75 ...
Page 76 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.3.2 Using the Preferences pages The Preferences pages are divided into several areas. When you first access the pages, the main menu is displayed. This menu includes the following items: Page Function: Video View and edit video display and output configuration. Audio View and edit audio language settings. Subtitles Enable or disable subtitles and select primary and secondary subtitle language. RF (not available on all Configure the RF output settings. models) Info View the STB serial number, MAC address and software version numbers. There are no user‐ configurable settings on this page. Restart Restart the STB. Sys Prefs (H140) Move to the Management pages The sections that follow detail the main settings available. Each section relates to a page accessible from the main menu. 6.3.3 Video TV type Sets how video is formatted for the TV. See also DISPLAY_MODE The following options are available: 4:3 and 16:9  76  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 77 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS Picture format Technical Sets how video is formatted for the TV. See also and Amino DISPLAY_MODE Note 018 ‐ Aspect Ratio Handling. The options available change depending on the TV type setting. With TV type set to 16:9 Value Description Stretch (4:3 to 16:9) Ignores the aspect ratio of the video, and assume that it is the same as the ratio of the output. So on 16:9 display, a 4:3 picture will appear horizontally distorted. On a 4:3 display, a 16:9 picture will appear vertically distorted. Auto For televisions which have automatic ratio switching. In this mode, the television switches between 4:3 and 16:9 depending on the video content, and full content is displayed for both. Zoom (4:3 to 16:9) This mode zooms 4:3 video to fill a 16:9 screen, cropping the top and bottom of the picture. Output Resolution Selects the output resolution, which will be one of the following options for a PAL system and will also depend on whether HDMI hotplug is enabled: SD 1080p 1080i 720p 576p (or 480p depending on whether the value of is PAL or NTSC).
Page 78 M540 COMPOSITE COMPOSITE + RGB COMPOSITE + S‐VIDEO x5x STBs STB type Output format choices offered A150 HDMI + RGB + COMPOSITE HDMI + YPbPr + COMPOSITE HDMI + S‐Video + COMPOSITE H150, A550PVR COMPOSITE HDMI + COMPOSITE + RGB HDMI + COMPOSITE + YPbPr HDMI + COMPOSITE + S‐VIDEO HDMI format (Restart) Sets the video format from the HDMI output: RGB, YUV444 or YUV422. See also HDMI_VIDEO_FORMAT. Framerate conversion When framerate conversion is enabled, then native framerate passthrough is disabled, that not is the STB will automatically change its output framerate to match that of the incoming (native) video stream being played: instead the framerate will be converted. For example, if the STB is set to PAL (50Hz) and an NTSC clip is played (59Hz), the STB will attempt to play the clip at PAL (50Hz). See also NATIVE_FRAMERATE_ PASSTHRU_ENABLE Resolution conversion When resolution conversion is enabled, then native passthrough is disabled, that is the STB will change its output resolution (HD) to SD if the incoming (native) video stream is in SD. See also NATIVE_PASSTHRU_ENABLE.  78  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 79 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.3.4 Audio Primary language The primary language for the audio stream. See also PREFERRED_LANG Secondary language The secondary language for the audio stream. See also SECONDARY_LANG Assistive audio Visually impaired: selects the audio stream labelled visually impaired (the assistance is usually a voice describing the programme scene and sound effects, supplementary to the programme dialogue). Hearing impaired: selects the audio stream labelled hearing impaired. None: disables the assistive audio. HDMI capabilities The HDMI options are: 2 channel PCM, 5.1 Dolby Digital & 7.1 Dolby Digital Plus. This should be set to match the decoding capabilities of the HDMI device that the STB is connected to. See also HDMI_AUDIO_FORMAT © Amino Communications Ltd. 2018 INDEX CONTENTS 79 ...
Page 80 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.3.5 Subtitles Subtitles Enables or disables subtitles. Primary language Sets the primary language for the default subtitle display. See also SUBTITLES_PREF_LANG Secondary language Sets the secondary language for the default subtitle display. If the STB can find no subtitle information in the Primary language it uses the information in the Secondary language, See also SUBTITLES_SECOND_LANG 6.3.6 RF (not available on all models)  80  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 81 6.3.7 Info The Info page gives you the following information about the STB: • Serial number • MAC address • Software version • CR version • OEM version • PBL version • RI version 6.3.8 Restart The Restart page allows you to restart the STB. 6.3.9 Sys Prefs (H140) The Sys Prefs page allows you to return to the Management pages. Management pages The Management pages enable administrators to change STB configuration areas such as networking, channel list and browser set‐up, as well as initiate basic operations such as rebooting and updating software. In addition, read‐only access is available to areas such as version and STB identity settings. The pages are password‐protected and accessed locally via an Amino IR keyboard (limited functionality is also supported via a remote control). Use Alt‐M on the keyboard to access the Management pages. You will have to enter the management password, see Getting started (the password is if you have not changed the default). Management leaves pages allow access to advanced configuration functions and are designed for use by administrators rather than end‐users. © Amino Communications Ltd. 2018 INDEX CONTENTS 81 ...
Page 82 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.4.1 Using the Management pages The Management pages are divided into several sections. When you first access the pages, the main menu is displayed. This menu includes the following section headings: Page Function Hardware View the STB hardware details. There are no configurable settings on this page. Software View the STB software details. There are no configurable settings on this page. Browser View and edit the channel URLs and graphics support information. Video View and edit video display and timeout settings. View and edit the IR device settings. Network View and edit static address information. DHCP View and edit the DHCP server information. Upgrade Upgrade the STB Restart Reboot the STB. TVI (H140) Initiate a software upgrade (multicast) or reflash. User Prefs Enter the Preferences pages (H140 only)  82  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 83 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.4.2 Hardware Serial number The STB serial number. MAC address The STB MAC address. Product The STB type. The processor type. CPU speed The processor speed. SDRAM The size of the SDRAM. FLASH The size of the Flash. ROM type The type of ROM and manufacturer. Board revision The board revision number. © Amino Communications Ltd. 2018 INDEX CONTENTS 83 ...
Page 84 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.4.3 Software H140 software page: note TVI and User Prefs options Software version The version string for the software build. CR version The Custom Resource (CR) version for the software build. OEM version The OEM version as defined by the system integrator in /mnt/nv/oemversion. PBL version The Primary Boot Loader version. RI version The Recovery Image version  84  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 85 Home page Sets the home page. This is the URL of the page the browser goes to when the STB has booted successfully and the Home key is pressed. The URL entered must be in the format http://<address>. See also . (The STB can go directly to this page BROWSER_HOMEPAGE File access policy without pressing a key if you set the appropriate permissions in the Full screen mode Enables or disables full screen mode. (x4x STBs only). This has been removed from the Management pages on x5x and x0xx STBs but can still be set within the settings file. See for the settings file values required to set full screen. FULLSCREEN GFX resolution Sets the graphics resolution. See also . (When this setting is set to SD GFX_RESOLUTION Graphics, the value of determines the final screen resolution.) TVSYSTEM Left Margin Sets the left browser margin, as a percentage of the graphics plane size (that is, in the range 0 ‐ 100). Opera also allow margins to be specified in pixels. See also BROWSER_MARGIN_LEFT Right Margin Sets the right browser margin, as a percentage of the graphics plane size (that is, in the range 0 ‐ 100). Opera also allow margins to be specified in pixels. See also BROWSER_MARGIN_RIGHT Top Margin Sets the top browser margin, as a percentage of the graphics plane size (that is, in the range 0 ‐ 100). Opera also allow margins to be specified in pixels. BROWSER_MARGIN_TOP Bottom Margin Sets the bottom browser margin, as a percentage of the graphics plane size (that is, in the range 0 ‐ 100). Opera also allow margins to be specified in pixels. See also BROWSER_MARGIN_BOTTOM © Amino Communications Ltd. 2018 INDEX CONTENTS 85 ...
Page 86 SeaChange Tandberg Openstream Telefonica Anevia BitBand Concurrent EONA InfoValue Kasenna MediaBase See also RTSP_SERVER Trick play Sets the default fast forward and rewind multiplier (0‐6), for example a trick play value of 2 means the fast forward and rewind speeds will be multiplied by twice normal speed. A value of 0 will pause the stream. See also RTSP_SCALE No RTSP event timeout Sets the number of seconds to wait for video data after sending an RTSP play command, before a no‐video event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also RTSP_START_TIMEOUT RTSP end timeout Sets the number of seconds to wait after no more RTSP data is seen, before an end‐of‐media event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also RTSP_END_TIMEOUT No IGMP event timeout Sets the number of seconds to wait for video data after sending an IGMP join command, before a no‐video event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also IGMP_START_TIMEOUT IGMP end timeout Sets the number of seconds to wait after no more video data is seen, before an end‐of‐media event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also IGMP_END_TIMEOUT  86  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 87 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS No UDP event timeout Sets the number of seconds to wait for video data after trying to connect to a UDP media stream, before a no‐video event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also UDP_START_TIMEOUT UDP end timeout Sets the number of seconds to wait when no more UDP data is seen, before an end‐of‐media event is raised. This must be in the range 0 ‐ 30, where 0 means that there will never be a timeout raised. See also UDP_END_TIMEOUT 6.4.6 Repeat delay Sets the length of time that a user has to depress a key on an IR input device (for example the keyboard) to make it repeat. See also DELAY_FACTOR Value Description 16cs delay rate. 32cs delay rate. 64cs delay rate. 96cs delay rate. Repeat rate Sets the key repeat rate in centiseconds, to control the number of characters per second that a user can enter. Set an even‐number value in the range 2 ‐ 30 (rate in centi‐seconds), or set 0 for no repeat. See also REPEAT_RATE Text entry Enables or disables remote text entry via the remote control. If text entry is enabled, the user enters text by holding down the appropriate number key. See also TEXT_ENTRY The Repeat rate must be set to 0 (zero) and remote text entry must be enabled for remote text entry to work. Keyboard layout Sets the keyboard layout. © Amino Communications Ltd. 2018 INDEX CONTENTS 87 ...
Page 88 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS IR brand Sets the brand code used to pair the STB with a particular Amino remote control. The value must be in the range 000 ‐ 015 (or 100 –115 for the A130), and must match the code on the remote control that you want to use to with the STB. See also IR_BRAND Cursor acceleration CURSOR_ACCELERATION Sets the speed of the cursor. See also 6.4.7 Network Hostname Sets the hostname for the STB. Domain Sets the domain for the STB. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also DOMAIN Time server The IP address of the NTP client (either static or from the DHCP server). See TIME_SERVER Timezone The time zone in which the STB is operating. See TIME_ZONE Also see http://www.twinsun.com/tz/tz‐link.htm or  http://en.wikipedia.org/wiki/List_of_tz_zones_by_name Ethernet Link Sets the default speed for the main Ethernet port to one of the following values: Auto detect (default) 10Mbit/s Half Duplex 10Mbit/s Full Duplex 100Mbit/s Half Duplex ...
Page 89 6.4.8 DHCP DHCP Sets whether the STB will be getting its network settings dynamically from the DHCP server (DHCP enabled). If the STB will not be getting its network settings dynamically from the DHCP server (that is, you have selected Disabled), then you will need to ensure that the appropriate static settings are specified on this page (for example, IP address and netmask). See also DHCP IP Address Sets the static IP address for the STB. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also IPADDR. Netmask Sets the netmask. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also NETMASK. Gateway Sets the IP address for the gateway for the STB. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also GATEWAY Sets the IP addresses for the domain name servers for the STB. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also Domain Sets the domain for the STB. This is only needed if the STB does not retrieve its network settings from a DHCP server. See also DOMAIN Lease time The DHCP lease time as returned by the DHCP server. See also LEASETIME Renewal time The DHCP renewal time as returned by the DHCP server. See also RENEWALTIME Rebind time The DHCP rebind time as returned by the DHCP server. See also REBINDTIME © Amino Communications Ltd. 2018 INDEX CONTENTS 89 ...
Page 90 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.4.9 Upgrade x4x upgrade screen The Upgrade page allows you to upgrade the software via the Management pages. However, before you initiate an upgrade, you must ensure that new software is available. This means that you will need an HTTP server containing the upgrade image for a unicast upgrade, and a multicast server containing the upgrade image for a multicast upgrade. For information about setting up an HTTP server or multicast server, refer to the Software Installation and Upgrade Guide. When the STB does a software upgrade, it only replaces the main software image and some user configuration can be preserved. If there is a problem during the upgrade, the new software can revert to the old software. When the STB does a reflash, it wipes all its current software ‐ except configuration options stored in the NOR Flash ‐ before installing new software, so it may not be able to revert to the old software if there is a problem. For x4x upgrade For x4x reflash URI address ‐ enter the URI for the URI address ‐ leave blank upgrade image (either IGMP for multicast or HTTP for unicast). 6.4.10 Restart The restart page allows you to restart the STB.  90  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 91 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS 6.4.11 TVI (H140) The H140 has an additional TVI page that allows you to configure the TVI interface. For more information about TVI refer to the Amino TV Connectivity Guide. Generic The generic TVI setting ‐ the Amino generic protocol will be used. Samsung The Samsung TVI setting ‐ the Samsung Serial Protocol for TVI operation will be used. 6.4.12 User Prefs The User Prefs page allows you to move into the Preferences pages directly from the Management pages. If you have this page available, then in the Preferences pages there will be a Sys Prefs page that allows you to return directly to the Management pages. Configuration page settings for Opera 11 The main settings needed to configure the STB can be accessed via the configuration pages, as detailed in the previous sections of this chapter. These settings are read from the configuration file or NOR Flash depending on the software build. The tables in 6.5.1 Preferences pages and 6.5.2 Management pages show the areas to which the configuration pages read and write settings for Opera 11 browsers. The format for the table is as shown: Preferences or Settings file <setting> or NOR Flash Management page <setting> setting You may need this information if you want to try out settings via the configuration pages and then copy the new configuration to the image components used to create a new software image. © Amino Communications Ltd. 2018 INDEX CONTENTS 91 ...
Page 92 Settings DISPLAY_MODE Output resolution NOR Flash OUTPUT_RESOLUTION Video output NOR Flash OUTFMT RF enable NOR Flash RFMOD_ENABLE Frequency table NOR Flash RFMOD_FREQTABLE RF Channel NOR Flash RFMOD_CHAN TV System NOR Flash TVSYSTEM HDMI audio mode NOR Flash HDMI_AUDIO_FORMAT Native Resolution NOR Flash Passthrough NATIVE_PASSTHRU_ENABLE Native Framerate NOR Flash Passthrough NATIVE_FRAMERATE_ PASSTHRU_ENABLE Languages setup pages Primary language Settings PREFERRED_LANG  92  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 93 SDRAM hard coded FLASH hard coded ROM type hard coded Board Revision hard coded Software version /etc/version CR version /mnt/nv/cversion OEM version /mnt/nv/oemversion MAC Address NOR Flash MAC_ADDRESS Serial Number NOR Flash SERIAL_ID Browser setup pages Home page Settings BROWSER_HOMEPAGE Full screen mode Settings FULLSCREEN GFX resolution Settings GFX_RESOLUTION Left Margin Settings BROWSER_MARGIN_LEFT Right Margin Settings BROWSER_MARGIN_RIGHT © Amino Communications Ltd. 2018 INDEX CONTENTS 93 ...
Page 94 IGMP end timeout Settings IGMP_START_TIMEOUT UDP start timeout Settings UDP_START_TIMEOUT UDP end timeout Settings UDP_END_TIMEOUT Network setup pages DHCP NOR Flash DHCP IP Address NOR Flash IPADDR Netmask NOR Flash NETMASK Gateway NOR Flash GATEWAY NOR Flash Hostname hostname HOSTNAME Domain NOR Flash DOMAIN Time Server NOR Flash TIME_SERVER NTP Client timeout Settings NTPCLIENT_TIMEOUT  94  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 95 STB CONFIGURATION PAGES FOR OPERA 11 ONWARDS Hard coded location, Settings file setting or NOR Area Flash setting Time zone NOR Flash TIME_ZONE Ethernet Link NOR Flash ETHERNET IP Address NOR Flash IPADDR Netmask NOR Flash NETMASK Gateway NOR Flash GATEWAY NOR Flash Lease time DHCPC LEASETIME Renewal time DHCPC RENEWALTIME Rebind time DHCPC REBINDTIME © Amino Communications Ltd. 2018 INDEX CONTENTS 95 ...
Page 97 Appendix A—NOR Flash settings In this Chapter: A.1 NOR Flash settings A.2 Primary and Secondary video outputs 97  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 98 NORFLASH.CUSTOMER_DATA ”PANIC BUTTON” < 12 characters. A string containing no more than 12 characters, this can DHCP_USER_CLASS be anything the customer wants: its use is not restricted. Default: Example: libconfig-set  NORFLASH.DHCP_USER_CLASS “CLASS_1” Always use Configures whether network configuration is carried DHCP Y = DHCP out by contacting a DHCP server. Note that if is set DHCP to , the multicast upgrade values and other settings Do not use N = are read from the settings listed in this table (for DHCP example, the settings). MULTICAST_<name> Default: Example: libconfig-set NORFLASH.DHCP ”Y”  98  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 99 Time in seconds Sets how long (in seconds) the DHCP timeout value DHCPTIMEOUT passed as a string should be. Default: Example: libconfig-set NORFLASH.DHCPTIMEOUT ”3600” This contains a string representation of an integer that is increased on a per build basis to ensure that during a multicast upgrade an older build is not put onto the STB. Read‐only. Default: Example: libconfig-get NORFLASH.DI > 2 Valid IP address. Specifies the IP address of the DNS server that the STB should be using. This is the value used if is set to DHCP (or if the STB cannot retrieve an IP address from the DHCP server). Default: Example: libconfig-set  NORFLASH.DNS ”123.4.5.67” © Amino Communications Ltd. 2018 INDEX CONTENTS 99 ...
Page 100 100FD =  100Mbit/s full duplex. Valid IP address. Specifies the gateway for the STB. This is the value used GATEWAY if is set to (or if the STB cannot retrieve an IP DHCP address from the DHCP server). Default: Example: libconfig-set NORFLASH.GATEWAY ”123.4.5.67” IEEE 802.1x For details of the libconfig settings for IEEE 802.1x configuration and the values that can be entered, refer to Amino Technical Note 089: IEEE 802.1x support. or Specifies the maximum version of the IGMP protocol to IGMP_MAX_VER use. Default: Example: libconfig-set NORFLASH.IGMP_MAX_ VER “3” Valid IP address. Configures the static IP address of the STB. This is the IPADDR value used if is set to DHCP Default: Example: libconfig-set NORFLASH.IPADDR ”123.45.6.7”...
Page 101 , values such as the MAC address of the locked. STB, the serial number of the STB and some CA settings The NOR that identify an individual STB cannot be changed. 1 = Flash is locked. Read‐only. Default: Example: libconfig-get NORFLASH.LOCK >1 On x4x STBs, the is read‐only. MAC_ADDRESS MAC ADDRESS If the MAC address is changed, then the STB needs to be rebooted for the new value to take effect. Amino recommends that you do not change this configuration. Default: ““ Example: libconfig-get NORFLASH.MAC_ADDRESS >00:02:02:ff:fc:64 Valid IP address. Specifies the static netmask for the STB. This is the value NETMASK used if is set to N (or if the STB cannot retrieve an DHCP IP address from the DHCP server). Default: Example: libconfig-set NORFLASH.NETMASK ”255.255.0.0”...
Page 102 RESOLUTION ”HD576p50” HD720P59 =  720p@59.94Hz HD1080I50 =  1080i@50Hz HD1080I59 = 1080i@59.94Hz HD1080P50 = 1080p@50Hz HD1080P59 = 1080p@59.94Hz = for x4x HDAUTO series STBs this allows switching between SD and HD depending on whether an HDMI cable is connected or not. If the EDID data provides a resolution that is = for x5x HDAUTO not supported by the TV, then the closest and x0xx series supported resolution will be used instead. STBs this reads the EDID of the TV (via HDMI) and configures the STB to match the native resolution of the  102  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 103 Composite +  S‐video + RGB A maximum of 32 Configures the password to use in PPP builds. PPP_PASSWORD characters. PPP builds only. Default: ““ Example: libconfig-set  NORFLASH.PPP_PASSWORD ”MyPassword” A maximum of 64 Configures the user name to use in PPP builds. PPP_USERNAME characters. PPP builds only. Default: ““ Example: libconfig-set  NORFLASH.PPP_USERNAME ”MyUserName” Integer less than Sets the RF channel for boards that have an RF RFMOD_CHAN modulator. Default: ““ Example: libconfig-set NORFLASH.RFMOD_CHAN ”3” © Amino Communications Ltd. 2018 INDEX CONTENTS 103 ...
Page 104 Example: libconfig-set NORFLASH.RFMOD_ENABLE ”Y” Configures whether the RF modulator uses cable or BROADCAST RFMOD_FREQTABLE broadcast frequencies. CABLE Default: Example: libconfig-set NORFLASH.RFMOD_ FREQTABLE ”CABLE” The is read‐only on x4x STBs. SERIAL_ID SERIAL_ID Default: The serial number of the STB is the usual value. Example: libconfig-get NORFLASH.SERIAL_ID >C01008F000276 The URI for an image when recovering the STB if there is SOFTWARE_URI no DHCP response. Default: Example: libconfig-set NORFLASH.SOFTWARE_URI <http_URL> The NORFLASH.SOFTWARE_URI setting is overidden by the DHCP setting where shown in this table.  104  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 105 Example: libconfig-set NORFLASH.TIME_ZONE “GMT+1” Time zone is GMT minus one hour (that is, if GMT=12:00, then TZ = 11:00) TVSYSTEM Sets the TV system that the STB will operate in. PAL-B = Australia, Ghana. Note: After the value has been altered the STB will need Europe. to be rebooted for the change to take effect. PAL-G = Belgium. PAL-H = Default: PAL-I = Brazil. PAL-M = = South Example: PAL-N America. libconfig-set NORFLASH.TVSYSTEM   = PAL-CN ”PAL-B” Argentina. = Japan. NTSC-J = US. NTSC-M © Amino Communications Ltd. 2018 INDEX CONTENTS 105 ...
Page 106 WIRELESS_COUNTRY contains an ISO  is set, then WIRELESS_COUNTRY WIRELESS_REGION 3166‐1 alpha‐ must also be set. 2 code or “ “ to Default: disable country code setting and Example: fallback to region. libconfig-set NORFLASH.WIRELESS_ COUNTRY “GB” The WiFi region Specifies the WiFi region as listed in Amino Technical WIRELESS_REGION identification Note 052 WiFi Support. The WiFi region identification string. strings for particular geographical regions are listed in Technical Note 052. This setting will persist over a factory reset. Default: Example: libconfig-set NORFLASH.WIRELESS_ REGION “GR-A09” locks the Locks the wireless region so that it cannot be changed WIRELESS_REGION_ LOCKED wireless region. ...
Page 107 On x0xx STBs, the GFX plane is present on both outputs. A.2.1 OUTPUT_RESOLUTION .OUTPUT_RESOLUTION controls the primary output. If this is set to an HD resolution (720p, 1080i NORFLASH and so on) then the primary interface will feed the HDMI and/or HD‐YUV outputs only. Only if it is set to , or left undefined will the primary interface feed the HDMI, CVBS, S‐video, YUV/RGB outputs at SD HDNONE resolution. The secondary interface is used if the primary interface is feeding HD outputs. In this case, CVBS and S‐video will be fed from the secondary interface. In summary: Output Resolution Primary Interface Primary Interface Secondary Interface setting feeds: Resolution (SD only) HD ( and HDMI CVBS 720p, 1080i so on) HD‐YUV S‐video HDMI Only used when HDNONE primary interface is set CVBS to HD S‐video YUV/RGB © Amino Communications Ltd. 2018 INDEX CONTENTS 107 ...
Page 109 Appendix B—Settings file contents In this Chapter: B.1 Available settings B.2 PVR sessions B.3 Remote layout options B.4 LED Configuration operation by STB product B.5 Volume control 109  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 110 Sets which remote control keys can bring the STB ANY_KEY_STANDBY_RECOVER Y = used to bring the out of standby. STB out of Use either , or . If the value has not been NULL standby. set, use the default value, Only the power N = Default: button can be used to bring the Example: STB out of standby. libconfig-set SETTINGS.ANY_KEY_ STANDBY_RECOVER “Y” A comma separated string of values representing AUDIO_DESCRIPTION_ the audio descriptor PID of the allowed streams. STREAM_TYPES Default: Example: libconfig-set SETTINGS.AUDIO_ DESCRIPTION_STREAM_TYPES “0x0C0”  110  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 111 MiB) on top of the cache to use in a browser. Default: Example: libconfig-set SETTINGS. BROWSER_ALLOC_EXTRA “10” Controls the amount of RAM (in MiB) to be BROWSER_CACHE_DOCUMENT allocated for document caching in a browser. Default: Example: libconfig-set SETTINGS. BROWSER_CACHE_DOCUMENT “2” Controls the amount of RAM (in MiB) to be BROWSER_CACHE_IMAGES allocated as a cache for the graphics in a browser. Default: Example: libconfig-set SETTINGS.BROWSER_ CACHE_IMAGES “10” Controls the amount of RAM (in MiB) to be BROWSER_CACHE_RAM allocated for RAM caching in a browser. Default: Example: libconfig-set SETTINGS.BROWSER_ CACHE_RAM “1” © Amino Communications Ltd. 2018 INDEX CONTENTS 111 ...
Page 112 Default: error page. internal (Default) Example: =  libconfig-set SETTINGS.BROWSER_ popup FALLBACK_BEHAVIOUR “popup” Display the "Failed to load webpage" popup. =  none Return to the previous page. =  <url> Set to the URL of a custom page to load, for example: 'http:// www.google.com' or 'file://mnt/nv/ error.html'. Controls the amount of extra heap space (in MiB) BROWSER_HEAP_EXTRA on top of the allocation to use in a browser. Default: Example: libconfig-set SETTINGS.BROWSER_ HEAP_EXTRA “8”  112  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 113 BROWSER_MARGIN_RIGHT BROWSER_MARGIN_TOP Must be defined as percentage and will not work BROWSER_MARGIN_BOTTOM without being defined. Valid values are 0 to 100 Setting these values to 100% will set the margins to cover the entire graphics plane. Default: Example: libconfig-set SETTINGS.BROWSER_ MARGIN_LEFT “20” = Preserve Allows the browser to run the script BROWSER_PRESERVECOOKIES Y rc.cookies cookies over a so that cookies are persistent over a reboot of the reboot STB. = Do not Default: preserve cookies NULL over a reboot Example: = disabled NULL libconfig-set SETTINGS.BROWSER_ PRESERVECOOKIES “Y” © Amino Communications Ltd. 2018 INDEX CONTENTS 113 ...
Page 114 Default: Example: libconfig-set SETTINGS.BROWSER_ VSYNC “Y” CA_ARGS Allows you to set the default configurations for the Verimatrix CA client(s). Allows you to set a string to pass configuration parameters. To configure the IPTV client add to VCAS_BOOT=<ipaddress>:<port> SETTINGS.CA_ARGS To configure the webclient, add and VMWC_BOOT=<ipaddress>:<port> to VMWC_COMPANY=<company name> CA_ARGS (separate each parameter with a space) To ensure the Verimatrix client will not establish a connection to the VCAS server until the middleware writes a file to indicate that the entitlements have been set, include in the VCAS_ENTITLEMENT_FILE=<path> setting string, where is the location of the <path> VCAS entitlement file.  114  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 115 CAPTIONING_WINDOW_LEVEL top closed captions the window position can be middle specified in the z‐plane. bottom Default: bottom Example: libconfig-set  SETTINGS.CAPTIONING_WINDOW_LEVEL “top” = Disable 708 Sets whether EIA‐608B captions are used in CC_DIGITAL_SERVICE digital service. preference to EIA‐708 captions when both are present in a stream. This setting avoids disruption = Default value to a service if stream configuration issues result in (same as not set) invalid EIA‐708 closed caption data (that is, the value. 708 packets are available but do not contain to = Range of usable captions). valid custom Default: service numbers. Example: libconfig-set  SETTINGS.CC_DIGITAL_SERVICE “0” © Amino Communications Ltd. 2018 INDEX CONTENTS 115 ...
Page 116 SETTINGS.CC_ PREFERENCE “ASTC” Controls whether x5x series STBs respond to CEC CEC_AUTO_RESPONSE commands in the same way as x4x series STBs, that is, certain commands are handled outside the middleware. The CEC requests being handled are: Set Menu Language Routing Information Active Source Give Physical Address Abort Message Default: Example: libconfig-set SETTINGS. CEC_AUTO_RESPONSE “Y” to Increases the sensitivity of the mouse cursor (the CURSOR_ACCELERATION pointer speed). Making a change to this setting will require the STB to be rebooted before the change takes effect. This setting is used with Opera 11 only and has no effect with STBs using Opera 12 (x5x and x0xx STBs). Default: Example: libconfig-set SETTINGS. CURSOR_ACCELERATION “2”  116  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 117 = Disables DIAL server is running when this setting is changed, the changes will be reflected immediately. See also FRIENDLY_NAME. Default: Example: libconfig-set SETTINGS.DIAL_USER_ ENABLE “Y” = Disable Disables or enables captioning in video window. DISABLE_CAPTIONING_IN_ captioning when Selecting will automatically scale the SCALE video window is captions to the size of the PIG. not full screen. Default: = Enable SCALE captioning in video Example: window. = Enable libconfig-set SETTINGS.DISABLE_ SCALE CAPTIONING_IN_PIG “Y” scaled captioning and teletext in video window. © Amino Communications Ltd. 2018 INDEX CONTENTS 117 ...
Page 118  Select to ignore the aspect ratio of the ignore ignore 16:9 TV; all video and stretch all video to the equivalent of content stretched 16:9 ratio. A 4:3 ratio picture will appear distorted. to fill the screen. widezoom Select to zoom in on 4:3 content so that widezoom 16:9 TV; 4:3 it fills the width of a 16:9 screen. The top and content displayed bottom of the picture will be lost. This option is in zoom only available in software releases from 2.6.2 presentation onwards. mode. For more information on aspect ratios refer to Amino Technical Note 018 Aspect Ratio Handling and the Amino TV Standards Guide. Default: Example: libconfig-set SETTINGS.DISPLAY_ MODE “widescreen”  118  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 119 Example: behaviour). libconfig-set  SETTINGS.DO_PMT_CHECK “Y” to The DSCP value to use for general outgoing IP DSCP_GENERIC traffic. Default: Example: libconfig-set  SETTINGS.DSCP_GENERIC “26” to The DSCP value to use for outgoing traffic to the DSCP_MIDDLEWARE specific middleware addresses specified by SETTINGS.DSCP_MWAR_ADDRS Default: Example: libconfig-set  SETTINGS.DSCP_MIDDLEWARE “26” to The DSCP value to use for multicast IP traffic. DSCP_MULTICAST Default: Example: libconfig-set  SETTINGS.DSCP_MULTICAST “26” © Amino Communications Ltd. 2018 INDEX CONTENTS 119 ...
Page 120 24,192.168.0.2,192.168.1.5" to The DSCP value to use for RTSP related outgoing IP DSCP_VOD traffic. Default: Example: libconfig-set SETTINGS.DSCP_VOD “26” Dual network interfaces Defines which interfaces will execute STBRC_INTERFACES For details of the STBremoteconf commands. input values and Configures multiple concurrent network interfaces. ENABLED_NETWORK_ their definitions, INTERFACES refer to Amino Specifies the network interfaces used for DNS DNS_INTERFACES Technical Note support. 064: Dual network Specifies the network interfaces used for IGMP IGMP_ROUTING_ interfaces. routing support. INTERFACES Specifies the network interfaces used for default IP DEFAULT_ROUTE_ routing support. INTERFACES Specifies the network interfaces used for NTP NTP_INTERFACES support. = Enable Enables or disables an external infra‐red (IR) ...
Page 121 Enable or disable the use of trusted domains. If the ENABLE_TRUSTED_DOMAINS Y uses JMACX and / use of trusted domains is enabled, pages that use or Macrovision JavaScript or Macrovision are checked against the calls must be list of trusted hosts. If trusted domains are checked against disabled, then JavaScript and Macrovision calls the list of known may be executed from any web page. trusted hosts. Default: = Execute JMACX N and/or Example: Macrovision calls to any web page. libconfig-set SETTINGS.ENABLE_ TRUSTED_DOMAINS “Y” to disable or a Used to specify an amount of additional buffering EXTRA_STREAM_BUFFERING value in Mibs allocated for use with stream transfers when HTTP OTT streaming. The buffer size is specified in MiB. Default: Example: libconfig-SETTINGS.EXTRA_STREAM_ BUFFERING “10” © Amino Communications Ltd. 2018 INDEX CONTENTS 121 ...
Page 122 ', for example ' macaddress A150- ', but the friendly name is 00:02:02:AA:BB:CC the name an end user can set. This name can be a maximum of 64 characters in length. Default: <model>-<macaddress> Example: libconfig-set SETTINGS.FRIENDLY_ “ ” NAME MyAminoSTB = Full screen. Enables or disables full screen mode. FULLSCREEN Y Note: Amino recommends Not full screen. In full screen mode, the browser window is set to N = setting this to ' ' and 100% of the video plane. controlling the size of the In non full screen mode, the browser window is set browser window by using the to 90% (safe area), so that the entire window will settings. BROWSER_MARGIN be visible on all televisions. Default: Example: libconfig-set SETTINGS.FULLSCREEN “Y” = Enable HTML ...
Page 123 = HD1080 Note: on x4x STBs, even when set to SD resolution, Equivalent to 1920 if an HD output is being used no graphics will be x 1080 resolution. seen on the SD outputs. This is because the secondary interface is feeding the SD outputs, and = Standard NULL this interface does not render the GFX plane. definition On x0xx STBs, the GFX plane is present on both outputs. The range of supported values will be platform‐ dependent and thus may be affected by the current OUTPUT_RESOLUTION setting. NORFLASH. Note that at higher resolutions, you may find some performance reduction. Default: NULL Example: libconfig-set SETTINGS.GFX_ RESOLUTION “HD1080” The actual SD resolution will be either 720 x480 or 720 x576 based on the value of .TVSYSTEM. It is good NORFLASH practice to set GFX_RESOLUTION to to achieve a "NULL" standard definition graphics plane. © Amino Communications Ltd. 2018 INDEX CONTENTS 123 ...
Page 124 Note that the video plane is not rotated when rotating the graphics plane. Making a change to this setting will require the STB to be rebooted before the change takes effect. Default: Example: libconfig-set SETTINGS.GFX_ROTATION “90” x5x and x0xx, Opera12 <html> Use the HTML transform <head> property within the webpage. <style> Sample code is shown here: body { position: absolute; top: 720px; left: 0px; padding: 10px; width: 720; height: 1280; overflow: hidden; transform‐origin: 0px 0px; transform: rotate(‐90deg); } </style> </head> <body> <p>This is the page content rotated ‐90 (or 270) degrees</ p> </body> </html>  124  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 125 ‐ Consider the When the HDMI EDID cannot be read this HDMI_FALLBACK_MODE monitor as a DVI  option is used to determine whether the STB device when  defaults to HDMI or DVI functionality. reading the EDID Default: fails ‐ Consider HDMI the monitor as an  Example: HDMI device when libconfig-set SETTINGS.HDMI_ reading the EDID FALLBACK_MODE “HDMI” fails. Allows a choice of video format from the HDMI HDMI_VIDEO_FORMAT output. This setting determines the colour range YUV422 encoding, for example changing from RGB to YUV YUV444 can produce a deeper black. Default: Example: libconfig-set SETTINGS.HDMI_VIDEO_ FORMAT “RGB” © Amino Communications Ltd. 2018 INDEX CONTENTS 125 ...
Page 126 Example: variant in the playlist. libconfig-set SETTINGS.HLS_INITIAL _BITRATE_PREFERENCE ‐ Select Highest the highest bitrate variant in the playlist. ‐ Select Previous the bitrate that was used for the previous playback session. ‐ Use <integer> <integer> as an absolute bitrate value. Sets the minimum number of minutes you want to HLS_MIN_NETWORK_PLT_ have in a playlist before allowing PLT. To use SPOOLTIME trickplay, HLS_MIN_NETWORK_PLT_SPOOLTIME must be less than the size of the sliding window. Default: Example: libconfig-set SETTINGS.HLS_MIN_- NETWORK_PLT_SPOOLTIME “6”  126  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 127 Fastest Disables the best quality startup in preference to displaying something quickly. Better quality will be introduced as the content plays. For hospitality STBs, the user preferences are not HOSPITALITY Y = The user preferences menu accessible to normal users, the user preferences is not available for menu is only accessible through the management all users (that is, page menu. This is the standard hospitality the standard configuration. Setting the value to ‘N’ makes the hospitality user preferences menu available for all users. configuration is Also, setting this to ‘Y’ on a non‐hospitality STB retained). can make it operate in hospitality mode N = The user See User Prefs. preferences menu Default: is available for all users Example: libconfig-set SETTINGS.HOSPITALITY “Y” © Amino Communications Ltd. 2018 INDEX CONTENTS 127 ...
Page 128 Default: Example: libconfig-set SETTINGS.HTTP_PROXY_ IGNORE  “www.google.co.uk,www.bbc.co.uk” Configure the proxy server for HTTPS transactions. HTTPS_PROXY Enter the IP address and port in the format , for example: host:port 123.4.5.67:1234 Default: Example: libconfig-set SETTINGS.HTTPS_ PROXY “123.4.5.67:1234” ‐ Sets the number of seconds to wait after no more IGMP_END_TIMEOUT video data is seen, before an end‐of‐media event is raised. If the wait for more data extends past the timeout, the playback is stopped by the STB. Set to for no timeout. Default: Example: libconfig-set SETTINGS.IGMP_END_ TIMEOUT “15”  128  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 129 LED is on Sets the initial state of the main/IR LED, when the INITIAL_LED ON = when the STB is STB is active (that is, powered and not in standby). active. For a description of the LED configuration for LED is off different STBs see LED Configuration operation by OFF = when the STB is STB product. active. Default: Example: libconfig-set SETTINGS.INITIAL_ LED “ON” ‐ Defines the prefix expected within the IR signal IR_BRAND 0 sent by a remote control in order to pair the remote with a particular STB. This can be useful in lab/demo environments when multiple STBs may receive the signal from a remote control. See Appendix H, ”Pairing an IR remote control with an STB“ for details of how to pair a remote control with an STB. Default: Example: libconfig-set SETTINGS.IR_BRAND “10” © Amino Communications Ltd. 2018 INDEX CONTENTS 129 ...
Page 130 Sets the layout for the keyboard. Language KEYMAP us = specified in ISO‐639 notation. British uk = Default: Greek el = German ge = Russian ru = Example: Slovenian sl = libconfig-set SETTINGS.KEYMAP “us” uk-lrk = British ‐ New Amino keyboard ge-lrk = German ‐ New Amino keyboard fr-lrk = French ‐ New Amino keyboard Use old New behaviour is defined as having subtitles LEGACY_SUBS Y = behaviour. displayed on a second framebuffer on top of the browser graphics. This means that the STB can Use new N = display subtitles and browser graphics at the same ...
Page 131 Default: application. Y = TVI support Example: disabled for mediad and libconfig-set SETTINGS.MEDIAD_ therefore available TVI_SUPPORT_DISABLED “Y” for use by another application. This setting allows you to put in the settings file MIDDLEWARE_ARGS (from v4.2.0 for x5x STBs) the custom values that you would have entered into the DHCP configuration option AMINO.mw_args Default: Example: libconfig-set SETTINGS. MIDDLEWARE_ARGS “<your DHCP  options>” ‐ Sets the minimum volume. MINIMUM_VOLUME Default: Example: libconfig-set SETTINGS.MINIMUM_ VOLUME “20” Multiple Interface settings: see Dual network interfaces Enable native ...
Page 132 Setting Allowed values Description Enable native Used to enable temporary switching of output NATIVE_PASSTHRU_ENABLE Y = passthrough. resolution to SD when playing SD video, when the output resolution is set to HD. (HD products only) Disable native N = passthrough. Default: Example: libconfig-set SETTINGS.NATIVE_ PASSTHRU_ENABLE “N”  132  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 133 ConnectionLost = The network manager will perform automatic switching if the current device is no longer available and another device is ready. Middleware can still switch to another device which is ready using netman_set_ active_device(). WiredAvailable (Default) = The network manager will always switch to the wired interface if it is available. If the STB is currently connected via wireless and the wired interface is plugged in, it will switch to use it. Middleware should not use netman_set_ active_device(). © Amino Communications Ltd. 2018 INDEX CONTENTS 133 ...
Page 134 Example: libconfig-set SETTINGS.NTPCLIENT “Y” Sets the NTP client timeout in seconds. NTPCLIENT_TIMEOUT Default: Example: libconfig-set SETTINGS.NTPCLIENT_ TIMEOUT “10” Used to set the 'Operator Name' segment of the OTVS_UASTRING_OPERATOR_ User Agent string for the browser. Opera have NAME specific requirements that each customer can be identified so they can correctly divert customers to their specific stores. This setting also has a very specific format, and must be set to a valid string before the Amino TV App Store can be run. Default: Example: libconfig-set SETTINGS.OTVS_ UASTRING_OPERATOR_NAME  “OPERATOR” You obtain the value for OTVS_UASTRING_OPERATOR_NAME by agreement with Opera and Amino. Please contact info@aminocom.com for further details about obtaining this agreement. = Cookie data Used to indicate whether you want any persistent OTVS_CLEAR_COOKIE_DATA used by the Amino cookie data used by the Amino TV App Store be ...
Page 135 Setting Allowed values Description = Web storage Used to indicate whether you want any persistent OTVS_CLEAR_APP_DATA data used by the web storage data used by the Amino TV App Store Amino TV App to be erased. Store will be Data will be erased immediately if the Amino TV erased. App Store is running, or the next time the Amino = Web storage TV App Store starts. Once the data has been data used by the erased, this key will be set back to ' Amino TV App Default: Store will not be erased. Example: libconfig-set SETTINGS.OTVS_ CLEAR_APP_DATA “Y” = All data used Used to indicate that you want all data used by the OTVS_CLEAR_ALL_DATA by the Amino TV Amino TV App Store to be erased. App Store will be Data will be erased the next time the Amino TV erased. App Store starts. Once the data has been erased, = Data used by this key will be set back to ' the Amino TV App Default: ...
Page 136 ISO 639‐2  Sets the preferred audio language from a video PREFERRED_LANG language code stream. Set to for automatic language selection. “ ” Default: None Example: libconfig-set SETTINGS.PREFERRED_ LANG “fr” This is used to load a list of Minerva server IP PROVISIONING_INFO (Minerva 5.7 SP3 or later only) addressess or hostnames, (comma separated). You do not have to specify the port and you can use the FQDN of the servers. This must be used in conjunction with THINK_BOOTMODE. Default: “” Example: libconfig-set  SETTINGS.PROVISIONING_INFO  “<server1 ip>,<server2 ip>”  136  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 137 STBs = 5 that is 1 on x4x x5x and x0xx STBs = 8 STBs, 2 on x5x and x0xx STBs. Example: libconfig-set SETTINGS.PVR_MAX_ SESSIONS An unsigned The maximum length of the PVR buffer in minutes. PVR_SPOOLTIME (PVR capable platforms only) integer in range The maximum length of recording allowed. from to 1440. Default: 1440 if not set Example: libconfig-set SETTINGS.PVR_ SPOOLTIME “180” © Amino Communications Ltd. 2018 INDEX CONTENTS 137 ...
Page 138 Myrio2think volume using the IR remote. Default: AMINOTV NULL Example: libconfig-set SETTINGS.REMOTE_ LAYOUT “Hospitality” IP address. Sets the multicast IP address that the STB listens REMOTECONF on for commands. STBremoteconf Default: 225.10.10.10 Example: libconfig-set SETTINGS.REMOTECONF “234.56.78.9” ‐ Sets the multicast port that the STB listens on for REMOTECONFPORT 65535 commands. (See STBRCPORT STBremoteconf for information on how to set the unicast port). Default: 22222 Example: libconfig-set SETTINGS.REMOTECONF PORT “12345”  138  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 139 URI “igmp://239.255.250.1:11111? excl=10.172.2.1,10.172.2.2” = Do not repeat Sets the key repeat rate in centiseconds, to control REPEAT_RATE any keys. the number of characters per second that a user can enter via an IR input device (for example a ‐ = Repeat keyboard). rate (in cs). indicates no key repeat. “0” Default: Example: libconfig-set SETTINGS.REPEAT_ RATE “0” = Enable Dolby Sets whether audio level boosting over RF for RFBOOST_DOLBY audio level Dolby audio type is enabled or disabled. boosting over RF. Default: = Disable Dolby N audio level Example: boosting over RF. libconfig-set SETTINGS.RFBOOST_ DOLBY “Y” © Amino Communications Ltd. 2018 INDEX CONTENTS 139 ...
Page 140 RETRANSMISSION_ENABLE “Y” The default behaviour can be overridden on a per‐stream basis by adding "rtcpretrans=yes" or to the stream URI. "rtcpretrans=no" ‐ Sets the initial RTSP UDP video port number the RTSP_BASE_PORT 65535 STB is to use. By default, the STB starts at 11111 and increases in increments of 10. Default: Example: libconfig-set SETTINGS.RTSP_ BASE_PORT “1234” ‐ Sets the number of seconds (0‐30) to wait after no RTSP_END_TIMEOUT more RTSP data is seen, before an end‐of‐media event is raised. If the wait for more data extends past the timeout, the playback is stopped by the STB. Set to for no timeout. 0 Default: Example: libconfig-set SETTINGS.RTSP_END_ TIMEOUT “15”  140  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 141 = Offer This gives the option of forcing the use of RTSP_SIMPLE_TRANSPORT RAW/ transport RAW/RAW/UDP;unicast and prevents RAW/UDP transport only and adding destination details to the SETUP request. omit destination Default details. = Offer all Example: supported transports. libconfig-set SETTINGS.RTSP_ SIMPLE_TRANSPORT “Y” ‐ Sets the number of seconds (0‐30) to wait for RTSP_START_TIMEOUT video data after sending an RTSP play command, before a no‐video event is raised. If no video is seen before the time‐out, the playback is stopped by the STB. Set to for no timeout. 0 Default: Example: libconfig-set SETTINGS.RTSP_START_ TIMEOUT “15” © Amino Communications Ltd. 2018 INDEX CONTENTS 141 ...
Page 142 “” Default Example: libconfig-set SETTINGS.SECONDARY_ LANG “fr” = Selects stream If VOD servers send video data with a source IP SELECT_RTSP_STREAM_BY_ by port only. address different to that from their control IP PORT_ONLY address (that is, the IP address you use to control it = Selects stream over RTSP), and they do not tell the STB this in by IP address. their response to the SETUP command, then video will not play. Setting this command turns off the IP address check. Reboot the STB for it to take effect (the setting will be lost if you upgrade the STB again.) To have this command in the upgrade image, edit the file by adding the following line: settings SELECT_RTSP_STREAM_BY_PORT_ONLY="Y" Create the mc2 upgrade image and upgrade the STB with that image. Default on Minerva builds) Example: libconfig-set SETTINGS.SELECT_ RTSP_STREAM_BY_PORT_ONLY “Y”  142  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 143 STBRCPORT 65535 STBremoteconf daemon listens on for STBremoteconf commands. (See REMOTECONFPORT for information on how to set the multicast port). Default: 22222 Example: libconfig-set SETTINGS.STBRCPORT “12345” or unset – DHCP It is possible to disable STBremoteconf by setting STBRC_ALLOW_DHCP will override the unicast and multicast ports to 0 in the settings NORFLASH and file, but due to the default policy that DHCP SETTINGS values. overrides NORFLASH and SETTINGS values, a DHCP server can re‐enable STBremoteconf, which may be – DHCP will not undesired behaviour. This setting allows you to override control this behaviour. NORFLASH and SETTINGS values. Default: Example: libconfig-set SETTINGS.STBRC_ALLOW_DHCP “Y” © Amino Communications Ltd. 2018 INDEX CONTENTS 143 ...
Page 144 Setting Allowed values Description = default On x5x STBs, STBremoteconf supports STBRC_INTERFACES "" (from v4.4.3 for x5x STBs) operation. configuration settings for dual network interfaces. STBremoteconf This setting defines which interfaces will execute follows the STBremoteconf commands so more than one multicast route network interface has to be present (see used by Netman. ENABLED_NETWORK_INTERFACES in Amino Technical Note 064: Dual network interfaces). This setting requires a reboot of the STB. = eth0 Default: STBremoteconf commands are “” executed on the Example: eth0 interface. libconfig-set SETTINGS.STBRC_INTERFACES “eth0” = wifi0 STBremoteconf commands are executed on the wifi0 interface. = eth0|wifi0 STBremoteconf ...
Page 145 Programme Clock Reference (PCR). The offset determines the size of the data buffer (which needs to be set to avoid data underrun or overrun as the result of network jitter). The STC offset has an effect on the channel change time; the shorter the offset the shorter the channel change time. The channel change time can be reduced by approximately 100 ms for every STC offset decrease of , [(1/90 kHz) *10000 =111ms]. 10000 x0xx STBs Default -60000 x5x STBs Default -40000 Example: libconfig-set SETTINGS.STC_OFFSET “-10000” The values given for the are advisory and Amino STC_OFFSET suggests that you do not change this value from the defaults given above. If you need to change this setting then note • using a positive value can put the STC ahead of the PCR so you will be trying to play data from the buffer before it has arrived. You are also reducing the buffering that limits network jitter, so you must ensure your data delivery is regular to avoid underruns which can cause macroblocking • decreasing the value (that is, making it more negative) increases the buffering and therefore risks a buffer overflow. Again this can cause data loss and macroblocking. = 3D streams Sets the behaviour when 3D streams are present. STEREOSCOPIC_ will be output as Note that 3D is only output when a single full‐ PASSTHROUGH 3D even if the TV ...
Page 146 N = off. libconfig-set SETTINGS.SUBTITLES_ OPTION “N” Turn subtitles 0 = off. ISO 639‐2  Sets the primary language for default subtitle SUBTITLES_PREF_LANG language code. display. Set for automatic language selection. ““ Default: Example: libconfig-set SETTINGS.SUBTITLES_ PREF_LANG “fr” If both dvb subtitles and teletext subtitles are present in the stream and they have the same language descriptor and this matches the primary language (or secondary language if the primary language does not match) then dvb subtitles will always be selected. If neither primary nor secondary language match then the lowest‐numbered subtitle PID will be selected. There is no mechanism to select teletext subtitles over dvb subtitles as teletext subtitles is considered to be a more limited legacy technology and therefore inferior to dvb subtitles.  146  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 147 Default: Example: libconfig-set SETTINGS.SYSLOG_ BUFFER_SIZE “16” = Show kernel Allows syslog to show kernel debug. SYSLOG_KERNEL_REDIRECT debug. Default: = Do not show kernel debug. Example: libconfig-set SETTINGS.SYSLOG_ KERNEL_REDIRECT “Y” The IP address of the network syslog server. An SYSLOG_REMOTE_ADDR address must be specified before remote logging can be enabled. After changing this settings, the rc.syslogd script must be executed with the restart command for the changes to take effect. Default: Example: libconfig-set SETTINGS.SYSLOG_ REMOTE_ADDR “123.45.67.89” © Amino Communications Ltd. 2018 INDEX CONTENTS 147 ...
Page 148 Setting Allowed values Description SYSLOG_REMOTE_LEVEL to priority This setting currently works with Evo servers only. level Controls the remote syslog level. Only messages above the defined priority level are sent to the network syslog server. The SYSLOGD="‐r" option For no input or a must be set in the syslogd file and the property value not in the "evo.amino.logging.level” must be set in the range 1 to server. 8, the -r option The priority level set by Evo will update any level will not be set by set by libconfig. If remote syslog has started, the syslogd. Evo server will restart it. Default: Example: libconfig-set SETTINGS.SYSLOG_ REMOTE_LEVEL “4” SYSLOG_REMOTE_LOG_ = Enable. Controls whether the remote logging is enabled or ENABLED disabled. = Disable. N After changing this setting, the script rc.syslogd must be executed with the ...
Page 149 FOR:XXX after remote logging is started with a 300 second is a number of delay, the logging time will start at 300 seconds seconds. when the STB boots again. After changing this settings, the rc.syslogd script must be executed with the restart command for the changes to take effect. Default: Example: libconfig-set SETTINGS.SYSLOG_ REMOTE_LOG_TIME “FOR:300” The port number of the network syslog server. If SYSLOG_REMOTE_PORT not specified, the default 514 port number will be used. After changing this settings, the rc.syslogd script must be executed with the restart command for the changes to take effect. Default: Example: libconfig-set SETTINGS.SYSLOG_ REMOTE_PORT “100” © Amino Communications Ltd. 2018 INDEX CONTENTS 149 ...
Page 150 Default: ENGLISH Example: libconfig-set SETTINGS.SYSTEM_LANGUAGE “SPANISH” = Enable full Enables or disables teletext full screen operation. TELETEXT_FULLSCREEN Y screen operation. (Opera subtitle builds only.) = Disable full N Default: screen operation. Example: libconfig-set SETTINGS.TELETEXT_ FULLSCREEN “N” = Enable text Enables or disables text entry via the remote TEXT_ENTRY 1 entry. control. If text entry is enabled, the user enters text by holding down the appropriate number key. = Disable text entry. Default: Example: libconfig-set SETTINGS.TEXT_ ENTRY ”1”  150  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 151 Configures which TV type the TVI interface needs TVI_TYPE 0 to use on the programmable interface controller = Zenith 1 (PIC). Note: this setting is used on Hospitality = LG 2 platforms only. = Mate (Sony/ 3 Default: Panasonic) 4 = TVLink Example: 5 = Generic 6 = Samsung libconfig-set SETTINGS.TVI_TYPE “0” – Sets the number of seconds to wait when no more UDP_END_TIMEOUT UDP data is seen, before an end‐of‐media event is raised. If the wait for more data extends past the timeout, the playback is stopped by the STB. Set to for no timeout. Default: Example: libconfig-set SETTINGS.UDP_END_ TIMEOUT “15” © Amino Communications Ltd. 2018 INDEX CONTENTS 151 ...
Page 152 480 Mbits/s (USB 2 “” only). Example: libconfig-set SETTINGS.USB_SPEED “lowspeed” = Enable HTTP Enables or disables the use of HTTP, HTTPs and FTP USE_PROXY Y proxy. proxy servers. = Disable HTTP Default: N proxy. Example: libconfig-set SETTINGS.USE_PROXY “Y” A string of up to 60 Appends a 60 character ASCII string to the user USER_AGENT_STRING characters in agent string. This feature can be cleared by setting length. an empty string. Note: making this change will require the STB to be rebooted for the change to take effect. Default: Example: libconfig-set SETTINGS.USER_ AGENT_STRING “Aminotech”  152  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 153 Used to set the video error recovery mode used by VIDEO_ERROR_MODE error recovery the video decoder. Note: the behaviour on mode, this will different platforms (for example x4x and x5x) using result in the same setting (for example High) will not be macroblocks on absolutely identical. error. Default: = Partial error recovery mode. Example: = High error recovery mode. libconfig-set SETTINGS.VIDEO_ ERROR_MODE “2” = Full error recovery mode. No macroblocking is seen. = Disable VQE. Disables VQE VQE_DISABLE = Enable VQE. N Default: Example: libconfig-set SETTINGS.VQE DISABLE “Y” © Amino Communications Ltd. 2018 INDEX CONTENTS 153 ...
Page 154 must also WATCHDOG_HEARTBEAT be non‐zero. Default: Example: libconfig-set SETTINGS.WATCHDOG_ TIMEOUT “60” Used to set the 'Operator Name' segment of the YTLB_UASTRING_OPERATOR_ User Agent string for the browser. Google have NAME specific requirements that each customer can be identified so they can collect usage statistics. This setting also has a very specific format, and must be on TV set to a valid string before YouTube can be run. Default: Example: libconfig-set SETTINGS.YTLB_ UASTRING_OPERATOR_NAME “OPERATOR” You obtain the value for YTLB_UASTRING_OPERATOR_NAME by agreement with Opera and Amino. Please contact info@aminocom.com for further details about obtaining this agreement.  154  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 155 Example: libconfig-set SETTINGS.YTLB_ CLEAR_APP_DATA “Y” = All data used Used to indicate that you want all data used by YTLB_CLEAR_ALL_DATA TV to by YouTube on TV YouTube on be erased. will be erased. Data will be erased the next time YouTube on = Data used by starts. Once the data has been erased, this key will YouTube on TV will be set back to ' not be erased. Default: Example: libconfig-set SETTINGS.YTLB_CLEAR_ ALL_DATA “Y” PVR sessions The Streamerd stream configuration can now be configured using libconfig settings (see above). PVR_MAX_SESSIONS is the maximum number of concurrent recording and playback sessions allowed at one time (both local and remote). Within the sessions there is an order of priority: recordings highest  local playbacks lowest, where most recent connection is the lowest remote playbacks © Amino Communications Ltd. 2018 INDEX CONTENTS 155 ...
Page 156 PVR_MAX_SESSION has already been reached, then a lower priority session is terminated to free up resource. Remote layout options These are the options for REMOTE_LAYOUT. libconfig-set SETTINGS. Layout Description The default layout. Default As the default layout but with the following changes: Hospitality • CH_UP/CH_DOWN and number buttons become TVPOWER. • TVPOWER/STB become HOME. • VID_PLAY becomes VID_PLAYPAUSE. To operate the STB using a Myrio remote control. Myrio Default setting for all Amino Minerva builds. Think As the default layout but maps the ‐/‐‐ to be an EPG key Guide Alternative Sejin remotes provided by Koolconnect. Sejinalt Used for Myrio UEI Sejin remotes to map keys to Minerva think Myrio2think codes. Sends unmapped key codes from the RCU, allowing custom RCUs to be configured as required. Also used for debugging. When using the setting the keycodes will not match those of the Willow remote. AMINOTV causes the volume and mute buttons to be exposed to AMINOTV JMACX if the remote has been configured to send Amino IR codes for those buttons rather than TV‐specific IR codes. This allows middleware to capture the keypresses and decide what action it wants to take (for example, calling JMACX APIs for volume and mute, or sending TVI or CEC commands to the TV).
Page 157 A150 A540PVR Main LED OFF Main LED ON Main LED OFF Standby LED GREEN Standby LED GREEN Standby LED GREEN B.4.2 STB in STANDBY mode STB SETTINGS.STANDBY_LED value unset or "" "on" "off" Single LED STBs: OFF ON A129, A140, H140, A150 A540PVR Main LED OFF Main LED OFF Main LED OFF Standby LED RED Standby LED RED Standby LED RED Volume control In the default condition, the Amino remote will send out TV commands for the volume control +/‐ functions. The / JMACX calls can then be used to implement a volume AudioControl.SetVolume() GetVolume() control (see the Amino JavaScript Media Access Control Extensions API specification for further information). © Amino Communications Ltd. 2018 INDEX CONTENTS 157 ...
Page 158 If 9 9 3 Volume Up is now pressed, the When a TV brand code is not configured remote will emit codes for the STB in all the remote will not emit any code when modes. the volume +/‐ buttons are pressed, If 9 9 3 Volume Down is now pressed, the regardless of the mode of the remote. remote will emit codes for the STB in the current mode (for example, TV if the TV mode was selected prior to entering programming mode). If 9 9 3 Mode is entered, this will cause the remote to emit volume codes for the selected device in the currently selected mode. Willow remote When a TV brand code is configured the Configure the remote so that no TV brand remote will emit the appropriate TV codes. code is available. When a TV brand code is not configured An existing brand code can be deleted as the remote will emit the STB volume codes follows: (not the TV volume codes) when the • Press and hold the 1 and 6 buttons volume +/‐ buttons are pressed. simultaneously for approximately 3 seconds until the TV standby button is lit. • Enter the key sequence 9 9 6.  158  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 159 Appendix C—DHCPC file contents In this Chapter: C.1 DHCPC file settings 159  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 160 Example: libconfig-get DHCPC.BROWSER_ HOMEPAGE  > aminocom.com The DNS server returned by the DHCP server if DHCP is enabled. This is read only. Example: libconfig-set DHCPC.DNS >192.168.0.0 The domain returned by the DHCP server if DHCP is enabled. This DOMAIN is read only. Example: libconfig-get DHCPC.DOMAIN > aminocom.com The gateway returned by the DHCP server if DHCP is enabled. GATEWAY This is read only. Example: libconfig-get DHCPC.GATEWAY > The IP address returned by the DHCP server if DHCP is enabled. IPADDR This is read only. Example: libconfig-get DHCPC.IPADDR > 192.168.0.0  160  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 161 The netmask returned by the DHCP server if DHCP is enabled. NETMASK This is read only Example: libconfig-get DHCPC.NETMASK > 255.255.0.0 The DHCP rebind time returned by the DHCP server if DHCP is REBINDTIME enabled. This is read only. Example: libconfig-get DHCPC.REBINDTIME > 2268000 REMOTECONF_URI The URI returned by the DHCP server that STBremoteconfd will listen on for incoming commands. This overrides the REMOTECONF_URI setting. SETTINGS. Example: libconfig-get DHCP_REMOTECONF_URI <igmp URL> See REMOTECONF_URI for examples of source specific multicast URIs. The DHCP renewal time returned by the DHCP server if DHCP is RENEWALTIME enabled. This is read only. Example: libconfig-get DHCPC.RENEWALTIME > 1296000 © Amino Communications Ltd. 2018 INDEX CONTENTS 161 ...
Page 163 Appendix D—Using the configuration techniques In this Chapter: D.1 Configuring image components D.2 Configuring a large deployment 163  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 164 <release_name>/upgradeimage/flashcontents The file lists the files that will be included in a software upgrade image, and defines flashcontents permissions for the file. Example flashcontents file This shows a small part of a typical file. flashcontents # R == file must exist must be read-only must match the checksum in listfile.sig # W == file may exist must not be executable  164  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 165 R bbsdk.cfg R irb_keys.txt W noformat W !poweron W cookies.txt W history.txt 4. Use the script to create the software image, as usual. signupgradeimage The new software upgrade image includes your new or edited files, and you can use it to upgrade your STBs. D.1.1.1 Using Telnet or SSH to send libconfig commands See Chapter 4, ”Using libconfig“ for details of how to access STB configuration via Telnet or SSH. These remote log in tools are not normally included in software builds, but you can enable the appropriate tool by adding the file to the image components used to create the software image loaded onto the STB. Configuring a large deployment It is possible to configure software before deploying it to a large number of STBs. The following steps describe recommendations on how this can be done for both the initial STB configuration and for future upgrade images. D.2.1 Prerequisites The configuration procedure outlined here assumes you already have an STB with a valid software image installed. This must include one of the remote log‐in tools (Telnet/SSH/Dropbear). 1. Configure the software on the STB (for example, via the Management pages), and test the configuration to ensure the STB now operates as intended. 2. When you are happy with the configuration, use the remote log‐in tool to connect to the STB. 3. Copy the contents of the files that have been modified. © Amino Communications Ltd. 2018 INDEX CONTENTS 165 ...
Page 166 -o nolock <ip addr of host>:/path_to_nfs_export/ /nfs cd /nfs cp /mnt/nv/settings /nfs/ The configuration files are in , and you will need to copy them to the /mnt/nv <release_name>/ directory on your PC. If you are not sure which files have been upgradeimage/imagecomponents modified, then copy all the contents of the directory. Normally only the file will have been settings modified. 4. If you have added any new files that need to be included in the upgrade image, add them to the file in the directory. flashcontents <release_name>/upgradeimage/ 5. Create a new signed upgrade image (and add it to the directory specified in the multicast server’s configuration file). Ensure that the new image has an incremented deployment index, if you are using deployment indexes to control software versions installed on the STB (this is not recommended for a trial system). 6. Upgrade the software on a single STB with this new upgrade image (for example, by using STBremoteconf 7. Check that the new software loads and works as expected. If changes need to be made, repeat steps 1. to 6. until the configuration is correct. 8. Instruct all STBs on your network to upgrade to this new image (for example, use the deployment index mechanism to force an automatic upgrade).  166  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 167 Appendix E—Media source URLs and HLS In this Chapter: E.1 Media source types E.2 Media source attributes E.3 HTTP Live Streaming (HLS) 167  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 168 Streamed media will always have a valid, publicly accessible URL. These URLs, with optional attributes, are used to join media sessions. They can be used the Amino API functions and in the selected browser’s URL bar. A media server is a device that stores and shares media. It may be a simple attached storage, such as an external disk drive, or a commercial web server that hosts media for a large web site. It may also be used to run special applications that allow users to access the media from a remote location via the internet. The only requirements for a media server is a method of storing media and a network connection with enough speed to allow access to that media. If Macrovision is enabled then it is not possible to play a media URL from a toolbar as the Macrovision mode byte can only be set from inside an HTML page. However, JMACX calls could be used to play the content. (This also applies to tshttp URLs.) Media source types AmiNET products support various streaming protocols, including Real Time Streaming Protocol (RTSP), Internet Group Management Protocol (IGMP) and User Datagram Protocol (UDP). In some cases, the format of the URL for a media stream depends on the media server, but the following sections give general guidelines on URLs. The URL types supported are as follows: • ‐ Real Time Streaming Protocol, supporting servers from Kasenna, nCube and others. rtsp:// • ‐ Multicast UDP streaming with IGMP group membership igmp:// • ‐ Video downloaded or streamed over an HTTP connection. http:// • ‐ A transport stream downloaded over an HTTP connection. (Can only be used with JMACX tshttp:// calls.) • ‐ UDP streaming of video udp:// • ‐ Local file playback tsfile:// The AmiNET products support the video streaming protocols RTSP, IGMP and UDP, as defined below: RTP is not supported. x4x STBs will automatically detect RTP headers in UDP Media source attributes streams and strip them out. See rtpskip under . ...
Page 169 and assettype=nPLT offset_clock=yyyymmddThhmmss.00Z. The full URL in this instance would be: rtsp://10.172.4.26 BBC1;ServiceType=TSTV;assettype=nPLT;offset_clock=yyyymmddThhmmss.00Z E.1.2 IGMP URLs for an IGMP (UDP multicast) stream can be as follows: igmp://239.255.250.2:11111 indicates that this is an IGMP stream. igmp is the IP address associated with the stream. 239.255.250.2 is the port number for the multicast stream. 11111 In a stream that contains multiple programs, the URL can also include additional attributes if required (see Media source attributes), for example: igmp://239.255.250.2:11111;audiopid=17;pcrpid=16;videopid=17 E.1.2.1 Playing a multicast video stream Assuming your stream is being sent to a valid multicast address and nothing in your network infrastructure stops multicast traffic, then the URL to get the STB to play will be: igmp://:port For example igmp://239.192.128.1:11111 E.1.3 HTTP URLs for an HTTP stream can be as follows: http://exampledomain.com/videos/movie.ts indicates that this is an HTTP URL. http is the domain associated with the stream. exampledomain.com is the path to the video resource on the server. videos/movie.ts 169  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 170 URLs for a unicast UDP stream can be as follows: udp://192.168.0.1:11111 indicates that this is a UDP stream. is the unicast destination address associated with the stream (that is, the IP address 192.168.0.1 of the STB). is the port number for the unicast stream. 11111 The URL can also include additional attributes if required (see Media source attributes): udp://192.168.0.1:11111;<media source attribute> For example: udp://192.168.0.1:11111;audiopid=20 UDP streams will be setup on the server to be sent to a particular port on the IP address of the STB. The required parameters in the URL are the source IP address (to correctly title traffic from the source only) and the destination port the content is addressed to. E.1.5.1 Playing a unicast video stream Make sure your streamer is sending data to the IP address of the STB, then use the following URL: udp://<STB ipaddress>:<port> For example, you have an STB at 192.168.1.103 and a PC running VLC at 192.168.1.4 The PC would stream to: 192.168.1.103 port 1234 The URL to play the stream would be: udp://192.168.1.103:1234 You should also ensure that the setting SELECT_RTSP_STREAM_BY_PORT_ONLY is set to Y. Media source attributes Attributes can be included in media source URLs to provide additional settings relating to the stream. In the case of audio, video and PCR PIDs, the values are normally autodetected. If you manually specify any PIDs, then this auto‐detection system is disabled. Sets the audio PID value. Audio PIDs are normally auto‐selected based on the audio language audiopid preferences. By setting a manual PID the default auto PID detection mechanism is disabled. The audiotype attribute sets the audio codec to use for the media. Possible types are: audiotype  170  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 171 particular server type for Huawei RTSP. Use “servertype=hms”. Selects which audio channels are output according to the following values: monomix stereo both left and right channels (default). left left channel only. right right channel only. monomix mix left and right channels together. Number of seconds to offset into the stream when starting an RTSP asset. offset Password to log onto servers that require a password before they stream video. password Sets the PCR PID value. Sets the PCR PID value. PCR PIDs are normally auto‐detected. By manually setting a PCR PID pcrpid the auto detection mechanism is disabled. Selects the program map table (PMT) which in turn identifies the component streams such pmtpid as audio and video required to recreate a program. Selects the program to play in a multiple program transport stream (MPTS), for example progid igmp://239.255.250.2:11111;Progid=14 For IGMP, RTSP and UDP stream types, RTP headers can be skipped by adding the attribute rtpskip rtpskip=yes to the URL. The rtspping attribute sets the RTSP ping timeout value. The default value used is 30 rtspping seconds if no attribute is set. The RTSP ping is used as a 'heartbeat' by the client so that the server will continue to serve video. The STB checks that data is being received from an RTSP server every second and records the last time that video data was received. If the time since the last video data received reaches the rtspping threshold then a ping is sent to the server. It is possible to define additional attributes specific to certain video server types using the serverdata serverdata attribute. 171  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 172 Selects which teletext language to use, if present, in the media source. txtpid This is used to define other media sources instead of video. Currently only MP3 is defined type which allows for the incoming media to be decoded as MP3 instead of video. Username to log onto servers that require a username before they stream video. username Sets the video PID value, for example igmp://239.255.250.2:11111;videopid-17 videopid Video PIDs are normally auto‐detected. By setting a manual PID the default auto PID detection mechanism is disabled. Note that on IPTV single program transport streams are supported with one video PID. Sets the video codec. Options include: videotype h264 mp42 (MPEG‐4pt2/MPEG‐4‐ASP/H.263) mpeg2 Any other setting defaults to "mpeg2". This attribute is used when setting a video PID manually using videopid. Specifies the window with which the video stream should be associated (x5x and x0xx STBs vwid only). HTTP Live Streaming (HLS) E.3.1 Overview of HLS External information about HLS can be found by following the link below: https://developer.apple.com/resources/http‐streaming/ HLS allows client devices to fetch a variant or non‐variant playlist (an index file) of transport stream segments to play in order. It uses H.264 compression, AAC audio, mpeg audio etc. The fetched stream contains playback indexing files as well as the transport stream. The HLS server provides at least one non‐variant playlist file. The non‐variant playlist file is a list of URLs for the transport stream segments. The stream consists of segments of a specific time (the HLS specification defines the 'target' duration of the segments) and theoretically the STB could cope with unlimited size segments because the file is streamed rather than downloaded.  172  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 173 The variant playlist can, for example, consist of several streams at different bit rates (5, 2 and 1 Mbps) as shown below. The individual streams are known as non‐variant streams. The maximum bitrate set for an HLS stream is lowered internally to allow for network overheads. E.3.1.1 Switching between non‐variant streams Say for example that the current playback is segment 0 of the 5Mbps stream. If, during playback, the network slows for some reason, then the decoder will need to get the next segment of the HLS stream from a lower bitrate non variant stream, that is, segment 1 from the 2Mbps stream. To enable seamless switching without data loss, the timestamps across the streams must be identical. E.3.1.2 Clean start For a clean start to playback, the PAT and PMT are needed and should be at the front of the segment as shown in the 5Mbps stream. If they are positioned in a different part of the segment as shown in the 2Mbps stream, then on switching to this stream the decoder needs to find the PAT and PMT for correct playback. Any data before the PAT and PMT ‐ shown as time A ‐ is likely to be lost (at least the first 770k). E.3.1.3 Stream change On stream change, the STB notices that the PMT has changed, and playback will not be smooth until the STB finds the required PIDs for the new stream segment, after which it can continue playing the stream at the lower bitrate. E.3.1.4 Playback From the selection of streams offered in the variant playlist, convention is to start with the first stream (the stream the operator thinks is the best default bitrate will be placed first). The maximum bitrate to be used can be specified in the playback URL at present. 173  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 174 HLS streams are treated in the same way as any other stream type except that you add to servertype=hls the URL, for example: http://exampledomain.com/exampleplaylist.m3u8;servertype=hls Currently HLS Video‐on‐Demand and HLS live streams are supported, as are HLS variant playlists (a playlist of a stream encoded at different bitrates) and non‐variant playlists (the URLs of the streams to be played). The HLS plugin initially downloads the last bitrate variant used, but if a faster bit rate is detected the HLS will move to it when it starts the next segment. The following examples show the JMACX functions that can be used with HLS: 1. Playback of a variant or non‐variant playlist using AVMedia.Play: AVMedia.Play("src=http://devimages.apple.com/iphone/samples/bipbop/bip‐ bopall.m3u8;servertype=hls") 2. Set position in seconds using AVMedia.SetPos( ) Set position will have a resolution of the file segment size for the HLS stream being played. For example if file segments are 10 seconds long, the set position will be the beginning of the 10‐second segment that contains your chosen value. For example, if you set AVMedia.SetPos(127), the actual position set will be AVMedia.SetPos(120), that is, the start of the 120s to 130s segment. 3. Get position using AVMedia.GetPos( ) Returns value in seconds, for example: var pos = AVMedia.GetPos( ) 4. Get duration using AVMedia.GetDuration( ) Returns duration in seconds, for example: var duration = AVMedia.GetDuration( ) 5. Toggle between pause and play using AVMedia.Pause( ) and AVMedia.Continue( ) AVMedia.Pause( ) AVMedia.Continue( )  174  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 175 E.3.3 HLS Debug For debug purposes: • the client can automatically choose a variant playlist. • you can manually fetch the variant playlist then get the URLs of the non‐variant playlists and tell the HLS client to just play that non‐variant playlist URL you want to debug. • you can point the STB at the MPEG TS segment URLs, in turn, using tshttp. • you can fetch the segment files yourself on a PC, concatenate them together and use vlc/FFplay on the PC, or tsfile on the STB. 175  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 177 Appendix F—Recovery from invalid video mode In this Chapter: F.1 Invalid video modes F.2 Invalid video mode recovery (x3x and early x4x software builds only) 177  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 178 The STB should now be reconfigured and displaying video again. The LED transitions can be used to describe when to hold the OK button and when to let it go. It transitions from lit to flashing to lit. The Restore button (OK in this case) can be changed if needed. F.2.1 How it works There is a script on called . This can be replaced or changed by customers if needed. /mnt/nv rc.restore This script is run just before the browser/middleware. It checks if a predefined key has been held down for more than two seconds while booting. If so, it will reset the resolution to HDAUTO as default. However the resolution can still be changed by changing the rc script on flash. The setting can be: NORFLASH.OUTPUT RESOLUTION • if no HDMI cable is connected. HDNONE • if HDMI is connected and is , or HD480p NORFLASH.TVSYSTEM NTSC-M NTSC-J PAL-M • if HDMI is connected and is anything else. HD576p NORFLASH.TVSYSTEM All STBs always produce a composite output and all cable types have a composite signal available, so you will be able to get a picture by using this, though it may mean switching connections to the TV.  178  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 179 Appendix G—Video output formats In this Chapter: G.1 A129, A140, H140, A540PVR, A150 179  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 180 The following table shows the output format possibilities for the STBs listed, depending on the cables connected. The output format is normally set as part of the configuration (for example, via the Management pages or ), but in some cases it is selected automatically. libconfig The name of the setting or command used to change the output format depends on which configuration tool you are using. When the HDMI cable is connected, the HD format is selected automatically. In the following tables, Composite is the same as CVBS and Component is the same as YPbPr. A129, A140, H140, A540PVR, A150 Output format Part no. Cables configuration options 502‐418 10 pin Mini DIN to SCART Composite Composite, RGB Composite, S‐video Composite, Component 502‐594 10 pin Mini DIN to S‐video and Composite Composite, S‐video 1RCA 502‐419 10 pin Mini DIN to Component video and Component, RGB RGB 6 x RCA 502‐523 10 pin Mini DIN to Composite 3 x RCA Composite 510‐885 HDMI HDMI (not A129)  180  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 181 Appendix H—Pairing an IR remote control with an In this Chapter: H.1 On the grey Amino IR remote control H.2 On the AVC ‘Boat’ IR remote control H.3 On the SRC ‘Willow’ IR remote control 181  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 182 You can program an Amino IR remote control so that it can only control an STB that is configured to respond to it. The Amino IR remote controls prefix a number to each STB command. This number is set to by default, but you can program it to be another number in the range to . All Amino STBs respond to commands prefixed with but you can configure them to respond to commands prefixed with another number as well. For example, a remote control can be set to prefix commands with , and an STB can be configured to respond to commands prefixed with • The remote control can only control STBs that expect as a command prefix. • The STB will respond to commands prefixed with and also continues to respond to commands prefixed with (so that all STBs respond to the default Amino remote control). The following steps use the Configuration pages to set the IR brand code. This can also be set with the other configuration tools. See Chapter 6, ”STB configuration pages for Opera 11 onwards“ for details. On the grey Amino IR remote control 1. Hold down the STB and OK buttons on the remote control until the STB button lights up permanently. 2. Enter the number that you want to set as the prefix code for this remote control. This must be a three‐digit number in the range For example: The remote control will now prefix all STB commands with this code. To revert to the default code (that is, to unpair the remote control and STB), repeat these steps and set the code to 000.  182  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 183 2. Enter . The STB light should flash four times. If it flashes twice, repeat this part of the 9 8 2 procedure. The sequence unlocks/locks remote configuration programming. 9 8 2 • 4 flashes = unlocked • 2 flashes = locked 3. Hold down the STB key until the LED flashes twice and continue holding it until it flashes twice again. 4. Enter the number that you want to set as the prefix code for this remote control. This must be a three‐digit number in the range 100 - 015 H.2.1 Pairing the STB to the remote control 1. From the Amino IR keyboard, press Alt‐M and then enter the Management password (‘ ’ is leaves the default), to access the Management pages. Warning: Amino strongly recommends that you change the default passwords when deploying our STBs. See the Amino Installation and Upgrade Guide for information on changing these default passwords. 2. Open the IR configuration page. For navigation on this page, it is easier to use the arrow keys on the Amino IR keyboard. 3. Enter the two‐digit code that you programmed the remote control with, this is the last two digits of ...
Page 184 The remote can be paired to individual STBs by programming with one of 16 Pairing Codes. The default pairing code will be 0100. Pairing Code Address Field 0100 0x00 0101 0x01 0102 0x02 0103 0x03 0104 0x04 0105 0x05 0106 0x06 0107 0x07 0108 0x08 0109 0x09 0110 0x0A 0111 0x0B 0112 0x0C 0113 0x0D 0114 0x0E 0115 0x0F  184  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 185 Appendix I—STBremoteconf STATS command In this Chapter: I.1 Usage I.2 Example I.3 Terms explained I.4 MAC address I.5 AVCore I.6 Netstat I.7 Meminfo I.8 Example of a stats output 185  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 186 Terms explained The STBremoteconf stats command returns information which can be accessed by looking at specific directories on the STB. The MAC address is returned, and also selected information from /proc/avcore, / and from running an command on the STB. proc/meminfo ifconfig MAC address The command returns the MAC address of the STB stats Term Example value Description 00:02:02:03:BD:97 The MAC address of the STB. MACADDRESS AVCore The operating system collects and presents a range of useful statistical information whilst the STB is running. These are all presented in the pseudo‐filesystem where they can be inspected. All counts /proc/avcore/ and timestamps are unsigned 32‐bit integer values unless otherwise indicated. Timestamps are in 'jiffies', a Linux time unit (see the appropriate Linux documentation for a precise definition). Many of the statistics are presented in a standard (three value) form which is the time of the most recent occurrence (in jiffies), the number of occurrences that have occurred during the playing of the current asset, and the total number of occurrences that occurred prior to the playing of the current asset. Term Example value Description The video decoder will determine whether to decode a picture for display, or to skip a picture if synchronisation requires it. The last video skip timestamp. last_skip_timestamp  186  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 187 Linux time unit (see the appropriate Linux documentation for a precise definition). The timestamp of the start of the timestamp_of_movie_start current movie. The current timestamp. current_time 76319 Audio PTS The timestamp of the first audio buffer audio first pts overflow. The timestamp of the last audio buffer audio last pts (repeated below as overflow. last_overflow_timestamp AUDBUF returns information about how well audio buffering has been performing. The audio buffer statistics returned are specified as follows. The timestamp of the last audio buffer last_overflow_timestamp overflow. The number of overflows for the current overflows_in_this_movie asset. The total number of overflows since last total_overflows boot. The timestamp of the last underflow. last_underflow_timestamp The number of underflows for the underflows_in_this_movie current asset. © Amino Communications Ltd. 2018 INDEX CONTENTS 187 ...
Page 188 The total number of underflows since total_underflows last boot. The fullness of the audio buffer. fullness The video buffer statistics returned are specified as follows. The timestamp of the last video buffer last_overflow_timestamp overflow. The number of overflows for the current overflows_in_this_movie movie. The total number of overflows since last total_overflows boot. The timestamp of the last underflow. last_underflow_timestamp The number of underflows for the underflows_in_this_movie current movie. The total number of underflows since total_underflows last boot. The fullness of the video buffer. fullness Video PTS Retrieves the timestamp of the last topbit, lower 32bits video pts in a 33‐bit presentation  188  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 189 Transmit bytes is the number of packets transmitted per second. packets is the total number of errors occurring during received packets per second. errs is the number of packets that were dropped per second. drop is the total number of overrun errors in the transmit queue. fifo is the number of collisions that were detected per second. colls is the number of carrier errors that happened on transmitted packets per second. carrier is the number of compressed packets transmitted per second. compressed Meminfo Much of the information here is used by the , and Linux commands. The output of the free free command is similar in appearance to the contents and structure of , although looking /proc/meminfo directly at gives more details: proc/meminfo Description Total usable RAM, in kilobytes (that is, physical RAM minus a few reserved bits MemTotal and the kernel binary code). Is the sum of LowFree+HighFree (overall stat). MemFree © Amino Communications Ltd. 2018 INDEX CONTENTS 189 ...
Page 190 The total amount of non‐highmem memory. This is the memory the kernel LowTotal can address directly. All kernel data structures need to go into low memory. The amount of free memory of the low memory region. LowFree Total amount of physical swap memory. SwapTotal Total amount of swap memory free. SwapFree The total amount of memory, in kilobytes, waiting to be written back to the Dirty disk. The total amount of memory, in kilobytes, actively being written back to the Writeback disk. The total amount of memory, in kilobytes, which have been used to map Mapped devices, files, or libraries using the mmap command. The total amount of memory, in kilobytes, used by the kernel to cache data Slab structures for its own use. Total amount of memory currently available to be allocated on the system. CommitLimit The amount of memory presently allocated on the system. Committed_AS The total amount of memory, in kilobytes, dedicated to the lowest page table PageTables level. The total amount of memory, in kilobytes, of total allocated virtual address VmallocTotal space. The total amount of memory, in kilobytes, of used virtual address space. VmallocUsed The largest contiguous block of memory, in kilobytes, of available virtual VmallocChunk address space.  190  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 191 MemShared: 0 kB Buffers: 172 kB Cached: 11004 kB SwapCached: 0 kB Active: 2012 kB Inactive: 12956 kB HighTotal: 0 kB HighFree: 0 kB LowTotal: 30476 kB LowFree: 12628 kB SwapTotal: 26620 kB SwapFree: 26620 kB © Amino Communications Ltd. 2018 INDEX CONTENTS 191 ...
Page 193 Appendix J—Frequently Asked Questions (FAQs) In this Chapter: J.1 Leds J.2 STBremoteconf J.3 Recovery image J.4 IR and remotes J.5 Miscellaneous J.6 Using VLC J.7 Hard Disk Drives and recording J.8 Debug 193  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 194 The following sections contain the answers to FAQs raised in support tickets. The FAQs are listed under various topic headings, and may appear under more than one if the FAQ crosses two topics. Note that these FAQs only relate to topics that are covered in this STB Configuration Guide: for other FAQs and the Amino Support Knowledgebase, please visit the Amino website (www.aminocom.com) and click on Customer Support. Leds Q. On the A140 STB, is it possible to switch off the LED when the STB is in the Off state, and turn it on to indicate it is in the ON state? To change the default state for all STBs, modify the file in your to include imagecomponents.settings these 2 lines: SETTINGS.INITIAL_LED “ON” or as required “OFF" SETTINGS.STANDBY_LED “ON” or as required “OFF" You can also change individual STBs to other settings by using tools such as STBremoteconf. Refer to LED Configuration operation by STB product to see the effect of the and INITIAL_LED settings on LED operation. STANDBY_LED STBremoteconf Q. Where do I find the tools for STBremoteconf? They are located in the utils directory of the software release. Follow the instructions in this guide to install and run the utility. See Using STBremoteconf. Q. I am looking for information about how to monitor event logs from the Amino 140, by using Telnet etc. You can use our STBremoteconf utility and its protocol. There are several documents on the support site explaining the benefits and limitations. See Using STBremoteconf. There is also a lot of information outputted by the serial debug port and a lot of telemetry is available from the "/proc" filesystem under . There are several documents on the support site describing /proc/avcore each entry. See the Amino website (www.aminocom.com) and click on Customer Support. ...
Page 195 No, the ‘willow’ remote does not support macros. Miscellaneous Q. Do Amino STBs support IGMPv3? The x4x STBs can support either IGMPv2 or IGMPv3 (limited). ALL v3 devices will drop back to v2 if they see a v2 message (the entire network will fall back to the lowest common level) and we have seen compatibility issues when sending v3 messages on a v2 network. By default the STBs are configured to use v2 to get over the issues seen above. You can override the default and raise the version to v3 using the command libconfig-set IGMP_MAX_VER 3 Q. How do you set the current date and time in the system? The time can be set in several ways depending on your requirements: By default the STB will get the time information from the DHCP server it connects to. You can point the STB to a time server using the STB management pages. See Network on page 88. If you have telnet or console access to the STB you can set it manually at the command line (not normally required). See TIME_SERVER. Q. Is there a way to modify the graphics that appear when upgrading? You can replace these graphics with your own but you must follow certain guidelines. See Replacing the default graphics with your own on page 68. Q. The STB now shows a graphic while the kernel is loading. Is this graphic configurable? No, this graphic is the bootloader graphic and cannot be configured because it is in a proprietary format. However, we can create a bootloader graphic based on a graphic that you provide, but it must meet the following conditions: • a gif at the lowest resolution that will provide an acceptable graphic • a minimum amount of colours • no animations • a black background rather than transparency. When you design or provide the graphic, note that it will be displayed centred against a black background. Q. Can I rotate the video plane as well as the graphics plane? No, only the graphics plane can be rotated. Q. How do I enable or disable cookies? Cookies can be enabled or disabled by using the BROWSER_ENABLECOOKIES setting. Q. How do I enable subtitles? Subtitles or closed captions can be enabled by using the ENABLE_SUBS_OR_CC setting. Alternatively, if you are using the ‘Willow’ remote control unit, you can go into the management pages and enable SUBS/CC by ...
Page 196 Q. My IP camera outputs a stream as RTSP ‐ will the A140 support this? The A140 will support RTSP via UDP (but not RTP). Using VLC (http://www.videolan.org/vlc/) Q. I have errors or gliches on my stream when played through the STB, but they play without problems when using VLC . Video Lan Client (VLC) is a popular free player/streamer that can be used to give a quick confirmation that a stream is available and what the content is (provided it is not encrypted). It will show teletext and subtitles and can be used to quickly stream out a file to confirm it is the correct video content etc. However, because VLC uses the resources of the computer which it is running on, it is not a good comparison against an STB and you may think that because VLC plays the video then the STB should also play it. This is not the case and VLC can often buffer and play non‐conforming video that an STB cannot. It is simple to use and free, so it makes a useful addition to the test tools, but it should be used for quick checks rather than proper diagnosis. Hard Disk Drives and recording Q. I have a hard disk drive which I want to connect to my STB via the USB port to use for recording. Can I just plug it in? You will need to do some configuration before connecting a hard disk drive to an STB. The hard disk drive must be validated using our validation tools and entered into the file (formerly the file) to PVR.map PVR.usermap be recognised and formatted by our STB. For more information about using a HDD for recording, see the Amino JMACX API specification AM‐000502‐TC and the USB Hard Disk Performance Test Specification and Procedure, document number AM‐003378‐TE. Q. How many hours of video can I record on the PVR with a particular video bitrate? It is difficult to state a specified time because it depends on parameters such as compression, bitrates, network overheads etc. for which each ecosystem is different. It could be 20 hours to 65+ hours. MPEG‐4 (h.264) SD could perhaps be 80 hours depending on how low the bitrate is. As a rough guide for A540 recordings with a 250GB HDD: 8 Megabits (Mb) = 1 MegaByte (MB)  196  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 197 1 GigaByte (GB) = 1024 MB 230 GB = 235,520 MB So if an HD stream is playing @ 8 Mbps then 1 MB of space is written per second onto the HDD which is equivalent to 60 MB per minute. 235 GB/60 = 3,925.3 minutes. 3,925.3 minutes/60 = 65.4 hours. So the amount of video in hours that can be recorded is approximately 65 hours of HD or 130 hours of SD (SD streams are up to 4 Mbps, so for this example the HD hours have been doubled). Debug Q. Is there a way to obtain the debug logs from the STB without using the debug cable, for when the STB is in a remote location? There are three options for remote log retrieval: 1. use the LOGREAD option with STBremoteconf. This will retrieve the circular log buffer. 2. SSH in, and run the command logread. this will retrieve same as 1) 3. set up remote syslog, so the STB outputs its syslog over the network to a syslog daemon on another server. © Amino Communications Ltd. 2018 INDEX CONTENTS 197 ...
Page 199 BROWSER_UNLOAD_VIDEO (settings file) 114 CUSTOM_VERSION (settings file) 150 BROWSER_VSYNC (settings file) 114 DEFAULT_VOLUME (settings file) 117 CA_ARGS (settings file) 114 DELAY_FACTOR (settings file) 117 CA_DHCP_AUTH (settings file) 115 Deployment index (DI) 99 CAPTIONING_GFX_RESOLUTION (settings file) 115 DHCP (NOR Flash) 98 CAPTIONING_WINDOW_LEVEL (settings file) 115 DHCP_AUTHENTICATION (NOR Flash) 99 CC_DIGITAL_SERVICE (settings file) 115 dhcpc file CC_FORCE_SCROLL_ON_CR (settings file) 116 BROWSER_HOMEPAGE 160 CC_PREFERENCE (settings file) 116 DNS 160 CEC_AUTO_RESPONSE (settings file) 116 199  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 200 61 GATEWAY (dhcpc file) 160 setting using JMACX 61 GATEWAY (NOR Flash) 94 setting using Telnet 60 GETCONFIG (STBremoteconf) 45 LOCK (NOR Flash) 101 GETDI (STBremoteconf) 45 LOW_DISK_SPACE_LEVEL (settings file) 130 GETSTAT (STBremoteconf) 45 GETVERSION (STBremoteconf) 46 GFX_MEM_SIZE (settings file) 122 GFX_RESOLUTION (settings file) 123 GFX_ROTATION (settings file) 124 Graphics 67 MAC_ADDRESS (NOR Flash) 101 user defined 68 Management pages 81  200  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 201 PPP_PASSWORD 103 Proxy Setup (Management pages) 94 PPP_USERNAME 103 PS (STBremoteconf) 49 RFMOD_CHAN 103 PVR.map file 196 RFMOD_ENABLE 104 PVR_MAX_RECORD_SESSIONS (settings file) 137 RFMOD_FREQTABLE 104 PVR_MAX_REMOTE_PLAYBACK_SESSIONS (settings file) 137 SERIAL_ID 104 PVR_MAX_SESSIONS (settings file) 137 settings 58 PVR_SPOOLTIME (settings file) 137 SOFTWARE_URI 104 SUBTITLES 105 TIME_SERVER 105 TIME_ZONE 105 201  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 202 BROWSER_HELPPAGE 113 NETWORK_DEVICE_POLICY 133 BROWSER_HOMEPAGE 113 NTPCLIENT_TIMEOUT 134 BROWSER_MARGIN_BOTTOM 113 OEM_VERSION 150 BROWSER_MARGIN_LEFT 113 OS_VERSION 150 BROWSER_MARGIN_RIGHT 113 OTVS_CLEAR_ALL_DATA 135 BROWSER_MARGIN_TOP 113 OTVS_CLEAR_APP_DATA 135 BROWSER_PRESERVECOOKIES 113 OTVS_CLEAR_COOKIE_DATA 134 BROWSER_UNLOAD_VIDEO 114 OTVS_UASTRING_OPERATOR_ NAME 134 BROWSER_VSYNC 114 PLT_SPOOLTIME 135  202  CONTENTS INDEX © Amino Communications Ltd. 2018 ...
Page 203 THINK_BOOTMODE 151 overview of command options 41 TOOLBAR_STATE 151 parameter syntax 39 TOTAL_MEMORY 150 removing 37 TVI_TYPE 151 sending commands 37 UDP_END_TIMEOUT 151 upgrading 36 UDP_START_TIMEOUT 152 using scripts for control 38 USB_SPEED 152 STC_OFFSET (settings file) 145 USE_PROXY 152 STEREOSCOPIC_PASSTHROUGH (settings file) 145 USER_AGENT_STRING 152 STREAM_RATE_LIMIT (settings file) 146 203  © Amino Communications Ltd. 2018 INDEX CONTENTS...
Page 204 UPGRADE (STBremoteconf) 54 Upgrade image creating an upgrade script 65 customising 63 customising graphics 67 editing the flashcontents file 65 enabling remote log‐in 66 upgrade splashscreen customising 68 upgrade.sh file 23 upgrade_branding.tgz file 69 USB_SPEED (settings file) 152 USE_PROXY (settings file) 152 User preferences pages see Preferences pages 74 USER_AGENT_STRING (settings file) 152 Usersettings file changing settings 26 contents 27 UTILITY_LED (settings file) 153  204  CONTENTS INDEX © Amino Communications Ltd. 2018 ...

This manual is also suitable for:

5 series 0 series A129 A140 H140 A540pvr ... Show all

Amino 4 Series Configuration Manual

Quick Links

Related Manuals for Amino 4 Series

Summary of Contents for Amino 4 Series

This manual is also suitable for: