H200 Channel Zapper Guide

Introduction 

Summary 

This note is to outline steps to set up the Channel Zapper application for the Amino H200 STB

For guidance on how to install the firmware and channel lineup please see the H200 Quick Start Guide 

Background 

An Amino Channel Zapper application has either been embedded or available as “postbuild” component in almost all Amino and Entone produced Set Top Boxes. 

The capabilities of the Channel Zapper application have mostly been consistent but have evolved with the capabilities of the Set Top Box.

Assumptions 

The System Integrator setting up and configuring the Channel Zapper application and Set Top Boxes must have proficiency to either setup and configure the Amino Engage Service Assurance platform, DHCP and HTTP servers, or configure the required system via editing text-based files for USB provisioning.  As described in the H200 Quick Start Guide

Requirements 

• Engage Service Assurance usage: Login permissions to an Engage account; Ability to edit and host a JSON file on a HTTP under their control. 
• Server based configuration/Hosting: Ability to edit and setup local DHCP server; Ability to edit and host Firmware, Configuration and JSON files on a HTTP server under their control. 
• USB based provisioning: Physical access to the STB; Ability to edit configuration files and copy to a compatible USB stick in the correct format and structure. 
  

Channel Zapper Lineup File 

The zapper firmware is able to read the channel lineup from a Json file which can be pre-loaded on the STB or hosted on an accessible web server. 

Supported Network / Video-Transport formats 

The zapper supports streams provided in the following formats: 
DASH 
RTSP 
UDP 
HLS (streamed or locally loaded on STB) 
 
See table below for examples. 

Example JSON Lineup File 

 Engage Configuration and Setup 

For Engage configuration the INI file is replaced by the user-friendly “Add/Remove Parameters” feature in the Group Details area in Device Management and also dropdown menus for the “Target Application” (APP) and “Target Bootloader” (BBL) files. 

Channel Zapper Usage 

Features 

Remote Control Feature 

If you want to remotely control the channel zapper, then the “keycode injection” client which is resident in the STB can be used securely over SSH. 

For example to send a Channel Up button command “CH+” on the remote the command below will send and inject that keycode.  

NB: A pre-condition for this requires a SSH key-pair search for “Enable SSH” within the Amino Support Knowledgebase on how to request and install the REMOTE_ACCESS_ID into the INI (which you will need to provision using the previously described methods) 

For the STB with IP address: “192.168.1.125” and the SSH private key installed at “~/.ssh/XXXXXXX.private”, and the command to CH+ (Keycode code decimal 2)  

Audio Language Selection

Figure 11 Toggling Through Available Audio Languages in Zapper Application

Pressing the “Media” button on the remote control, brings up the list of available Secondary audio languages available in the video stream. Successive pressing will toggle through or you can use “Up”/”Down” and “Ok” to select.

4.4. Closed Captions or Subtitles Selection

Figure 12 Toggling Through Subtitle/Caption Languages in Zapper Application

Pressing the “Red” button on the remote control, brings up the list of available Closed-Captions/Subtitles available in the current stream. Successive pressing will toggle through or you can use “Up”/”Down” and “Ok” to select.

4.5. Watermark / On Screen Display of device info

For some Enterprise customers there may be a need to have some type of watermark able to be displayed which is unique per STB, to this end there are some relevant Amino Engage parameters which allow you to enable a watermark and select the data and colour of the data that will be displayed.

· browser.osd_info.argb requires an RGB colour code and this will determine the colour of the on screen text.

· browser.osd.info.enable is the main setting to turn on the watermark feature and has a drop down of on/off value

· browser.osd.info.mask determines which information will be displayed, the 1 or 0 in the 4 digits will determine if that data is displayed. The information for each digit equates to : Serial Number, Mac Address, ChipID, IP address. (ChipID not yet supported). In the example below 1101 will show SN, Mac and IP.

4.6. Zapper INI Options

4.6.1. Starting Channel

In the channel lineup file it is possible to specific that a particular channel should be the one which gets played first. This is done by setting a “starting” property to value “true” as shown below:

Example of starting channel

{ "type": "udp", "name": "12", "desc": "UDP stream", "starting": true, "addr": "233.22.133.12", "port": "8110" },

If more than one starting channel is specified, the 1st appearance will be selected.

You can also specify the channel to start at via Engage add adding “?channum=xxx” (xxx being the desired starting channel number) to the zapper lineup files entry for the group.

i.e

webapp.homepage="https://appassets.androidplatform.net/assets/zapper/zapper.html?channum=16"

Would get the STB to bootup with Ch16 as the first channel

4.6.2. Save last channel

If you prefer that the zapper starts on the channel which was last selected you can use the INI parameter “webapp.save_last_channel” and enable it by setting the value to “true”

i.e webapp.save_last_channel=true

(if save last channel is set then it will take priority over the starting channel in lineup.json)

4.6.3. Changing channels via ADB command 

You can have a local PC with the ADB key installed or can specify your own adb key for the STB to use for adb connections.

The parameter adb.key_url can be included in the INI (or Engage parameter) to point to your hosted adb key.

Then you can use adb to change the channel which the zapper is currently set to.

adb -s 10.0.35.143:5555 shell am start -d 'file:///android_asset/zapper/zapper.html?channum=18' com.aminocom.browser/.MainActivity