en:provisioning

Remote Set-top box configuration from Operator's server (provisioning)

To configure STB a special XML-file is used. It is requested by STB from URL: http://[PROVISION_ADDR]/prov/tvip_provision.xml

Provisioning [PROVISION_ADDR] is located on the STB's rootfs /etc/default_provision_server (For the TVIP firmware it is tvipstb.net).

Different STBs could by provisioned by differen versions of XML file, using Web server's features: depending on IP-address or MAC-addres of STB (HTTP header: Mac-Address).

The following example displays providing different XML files depending on STB MAC address using NGINX web-server:

                if ($http_mac_address) {
                    set $tvipmac M;
                }
                if ( -d "/var/www/tvipstb.net/prov.mac/$http_mac_address/" ) {
                    set $tvipres  F$tvipmac;
                }
                if ( $tvipres = FM ) {
                    rewrite ^/prov/(.*)$ /prov.mac/$http_mac_address/$1 break;
                }

In this example, requests from devices with different MAC addresses are forwarded to different directories on web server: /var/www/tvipstb.net/prov.mac/DEVICE_MAC_ADDRESS/

Provision server address priority

Provision xml is loaded from http://tvipstb.net by default. This domain can be overridden over provisioning itself, over TR-069 protocol, over DHCP options.

Provisioning address is deducted using priorities:

In firmwares up to 4.1.x:

  1. Address from TR-069 configuration.
  2. Locked device address. This address can be factory configured and overridden over provision_server tag in XML file. Factory reset of STB will not reset this address to defaults.
  3. Address from DHCP-option.
  4. Address from firmware (Official firmware has tvipstb.net address).

In firmwares from 4.2.x:

  1. Locked device address. This address can be factory configured and overridden over provision_server tag in XML file. Factory reset of STB will not reset this address to defaults.
  2. Address from TR-069 configuration.
  3. Address from DHCP-option.
  4. Address from firmware (Official firmware has tvipstb.net address).

Configure DNS for provisioning

:!: You should configure local domain tvipstb.net to use local provisioning

example configuration for bind DNS server:

$TTL 1200
tvipstb.net        IN SOA  ***HOSTNAME_OF_YOUR_DNS***. dnsmaster.tvipstb.net. (
                                201380101 ; serial
                                10800      ; refresh (3 hours)
                                3600       ; retry (1 hour)
                                604800     ; expire (1 week)
                                3600       ; minimum (1 hour)
                                )
                        NS      ***HOSTNAME_OF_YOUR_DNS***.
                        A       *******YOUR_SERVER_ADDRESS****

File tvip_provision.xml structure

Basic structure is the follows:

<?xml version="1.0"?>
<provision reload="86400">
  <!-- Modules -->
</provision>

reload attribute defines tvip_provision.xml update checking interval in seconds. Default value is 86400. <!– Modules –> defines modules described in the following chapters.

Modules and filtering

The module is a direct inheritor of the tag provision.
Starting with firmware version 5.0.33, it became possible to provide different provisioning modules for different devices. For this an additional section is created.
Example:

<tv_protocols devices="s605,s530"  override="true" default="jsonapi"  autostart="true"   >
     <protocol type="jsonapi" server="http://example.com" />
</tv_protocols>
<tv_protocols devices=""  override="true"  default="jsonapi"  autostart="true" >
      <protocol type="jsonapi" server="https//example2.com" />
</tv_protocols>        

* device -model of TVIP box
In this example, the boxes s605 and s530 will get the address of the server middleware example.com, all others are example2.com.
:!: Set-top boxes with firmware version earlier than 5.0.33 will receive the last middleware server address.

Update server information

Update server tag is used if operator is using local update server.

<update_server name="update.tvip.tv" />

name attribute defines update server domain name.

  • priorities of update server addresses
  • Defined address will be written to /var/tvip/update_server.prov
  • All official updates are always avaliable on update.tvip.tv web server

TR-069 server (ACS) information

Supported from firmware: 3.8.6
Set up URL, username and password for ACS access over CWMP protocol.

<tr69_server url="http://myacs.net/TR-069" user="test" password="test" />

Syslog server information

Supported from firmware: 3.9.13
Set up ip-address syslog server to send copy of /var/log/syslog. Syslog uses UDP protocol with port 514.

<syslog_host name="1.1.1.1"/>

Statistics server information

Supported from firmware 4.0.13
Set up server URL, where statistics will be sent.

<statistics url="http://domain/stbstat/index.php" accum_period="45">
  <media />
  <network period="20" />
</statistics>

Statistics tag attributes:

  • url - statistics server address.
  • accum_period - period in second of statistic accumulation before sent to server.

Network tag attributes (statistics of network interfaces):

  • period - period in seconds of statistics reading from hardware.

Media tag attributes (player statistics):

  • period - period in seconds of statistics reading from hardware. If set, data is read both periodically and at the end of media playback. If not set, statistics is read only at the end of playback.

Provisioning server information

This allows to redirect STB to another provisioning server. Request to a new server will be executed immediately.

<provision_server name="http://tvipstb.net" />

name attribute defines new provisioning server domain.

from version 4.0.0 attribute must contain schema (http or https)

If you need to explicitly reset provisioning server to default domain, make name attribute empty:

<provision_server name="" />

Reboot STB on provisioning file change

<restart value="reboot" />

value attribute could be:
shell - reinit application.
reboot - STB reboot.

Update types information

Defines a list of update type that user could select in Settings menu. For example, customers can have access to Beta and Release firmwares. “release” update type is always present in the menu (called “Default”).

<update_types>
  <device id="s400a">
    <type name="Android/Beta" os="android" type="beta" />
    <type name="Linux-Qt/Release" os="linux-qt" />
  </device>
  <device id="s410" force_type="release" force_os="linux-qt">
  </device>
</update_types>

id attribute in device tag defines device type which is being configured (for ex. s410, s500). type tag attributes:

  • name defines update type user-readable name for display;
  • os defines OS type (for ex. “linux”, “linux-qt”, “android”);
  • type defines update type (for ex. “release”, “beta”). Ifos attribute is not set, current installed OS is being used. If type is not set, “release” will be used by default.

In the following example, S400 STBs (running Android OS) will have access to “android/release” firmwares (by default) and to Beta-firmwares for Android OS (“android/beta”). They also can change OS to Linux-QT (“linux-qt/release”).
S410 STBs can only access “release” version of “linux-qt” OS. They also forced to use “release” update type on each startup.

Software update control

<updates>
  <update_background force="true" value="true" />
  <update_force force="true" value="true" />
  <update_period force="true" value="60" />
</updates>

update_background defines if timer should be used to force confirm update when “New Software is available” window is displayed.
update_force defines if “Cancel” button should be hidden from “New Software is available” window
update_period defines software updated check period in seconds (from 60 to 86400)

force is used to override user defined settings.

Operator information

Defines basic operator information. name sets up operator's name.

<operator name="Operator_Name" />

:!: The following attributes work from firmware 3.8.11. tv_app_name - sets TV'apps name in Main Menu instead of “Watch TV”. tv_app_icon - sets icon id for TV app.

This defines URL of logo image to be displayed on the Main Menu of TVIP Mediacenter. Limits: image format is PNG, max size is 300×300 px. To force update logo, URL change is required.

<logo url="http://tvipstb.net/prov/logo.png" />

url attribute defines image URL.

Operator's banner

Supported from firmware 4.0.11

This defines URL of banner image to be displayed at the top of the Main Menu of TVIP Mediacenter.

Limits: PNG, size 1920x180px, see banner recommendations document.

To force update banner, URL change is required.

<banner url="http://tvipstb.net/prov/banner.png" uri="tvplayer/?channel=1"/>

url attribute defines image UR; uri attribute defines system URI that will be executed when user clicks on banner (from fw. 4.1.9).

Defines URL of a special image that is displayed during STB boot (instead of TVIP logo). Limits: BMP format, exact size is 1280×720 px. Color depth is 24bpp. To force update logo, URL change is required.

<bootlogo url="http://tvipstb.net/prov/tvip_splash.bmp" />

url attribute defines image URL.

Background picture

Supported from firmware: 4.2.33

Ability to set a color background image for the Home screen

<main_menu_background url="https://www.my_background.png" refresh="3600" />

main_menu_background tag attributes:

  • url - server address from which the background image will be taken
  • refresh - update time in sec

Time zone and NTP (time) server setup

These define STB time zone and NTP server address.

<time tz="Asia/Singapore" ntp="pool.ntp.org" time_format="12" />

tz defines time zone in zoneinfo format.
ntp attribute defines NTP server address.
time_format (from fw 4.2.3) defines format of displayed time “12” (12-hour AM/PM) or “24” (24-hour).

Allowed main menu apps

This can disable access to different Mediacenter apps (like DVR, CCTV, VOD, mediaplayer).

App codes: mediaplayer is MediaPlayer, dvr is DVR, cctv is CCTV, vod is Movies, tv is TV, navigator is Web browser, settings is Settings, apps is All apps (Android), search is search function.

By default, all apps are allowed.

<features>
  <mediaplayer enabled="true" />
  <dvr enabled="true" />
  <cctv enabled="false" />
  <vod enabled="false" />
  <timeshift enabled="false"/>
  <appstore enabled="false"/>
</features>

Tag name defines app code, enabled attribute defines access: enabled (true) or disabled (false).

Tag attribute timeshift enabled allow enable (true) or disable (false) local timeshift.

:!: The tag appstore - allowed for 7xx models only

Add/hide web applications

This allows to add custom Web applications and hide default installed applications

<webapps>
   <app name="lk" title="User Account" icon="account" uiwidth="1280" uiheight="720" url="http://private.provider.com" api="mag"/>
     <app name="plex"/>
   <app name="youtube" hidden="true" />
</webapps>

This code hides all default Web applications and adds YouTube and operator's User Account page.

If override attribute is true, all default apps will be hidden; if attribute is false, custom apps will be added to default apps.
:!: Since version 5.0.33, the override attribute has been deprecated and do not recommend to use. Instead, you need to use the attribute hidden for system applications.

If reordering attribute is true, it's allow move WEB applications with menu button, supported from firmware 5.0.48

Web app attributes:

  • name is an unique app name (a-z characters, no spaces), it should not be the same as a reserved name or as other web app's name;
  • title is user readable name for Main menu display;
  • hidden - to hide the system application (from fw 5.0.33)
  • icon icon codename;
  • uiwidth and uiheight define UI resolution;
  • bgr - URL of an PNG image, that will be used instead of the app default banner. Width: 320 px. Height: 180 px (from fw. 4.0.11)
  • url defines web application URL;
  • api defines STB API type (tvip/mag/html5/youtube/blink);
  • proxy defines HTTP/HTTPS proxy (if required).
  • dial_origin - use DIAL protocol to launch this application over second screen app with defined origin (from fw. 4.0.19).
  • dial_title - name of application when multicasted over DIAL.
  • search_script - address of a special JavaScript code containing implementation of system search logic for current app.(from fw. 4.1.4).

Required attributes are name, title, uiwidth, uiheight, url, api. If icon codename is not specified, name will be used as icon codename. If icon is not found, “vod” icon will be used.

:!: For system applications allowed attribute hidden only
Reserved application names for name attributes:

  • “tvplayer” (Watch TV),
  • “dvr” (DVR),
  • “mediaplayer” (Mediaplayer),
  • “vod” (Movies),
  • “cctv” (CCTV),
  • “preferences” (Settings),
  • “allapps” (Android's All apps).

Default app names:

  • “account” for Operator's User Account page,
  • “youtube” for YouTube app,
  • “Plex” for Plex
  • “kodi” for Kodi app.

For customer's app, you can use any available icon.

:!: Since version 5.0.33, you can't to change the configuration (URL, icon, etc.) of reserved applications. If you need to replace the system application, you need to hide it and create your own with a different name.
By default path to config file at firmware: /home/tvip/profiles/<profile>/tvip_webapps.xml

:!: Pay attention, that for “Youtube” app since 4.2.x firmware need use HTTPS and api=“youtube”
To return to the main menu, the application must go to the “about: back” page when exiting.

To disable ALL webapps, use the following code:

<webapps override="true">
</webapps>

Add/hide Android applications

:!: This module allowed only with Android OS (supported from firmware 5.0.30).
This allows you to change the order of applications, as well as hide installed applications.

<android_apps>
     <app name="MediaCenter" title="MyMediaCenter" package="com.droidlogic.mediacenter" hidden="false" bgr="http://tvip.com/myMediaCenter.png"  /> 
     <app name="VideoPlayer" title="MyVidoPlayer" package="com.droidlogic.videoplayer" hidden="true" icon="http://tvip.com/icon.png"/>
</android_apps>

Application attributes:
name - is an unique app name;
title - is user readable name for Main menu display;
package - is package name in system;
hidden - allow to hide the app when used attribute “true”
icon - allow to replace icon, use uri;
bgr - allow to replace background, use uri;

Required attributes are : package

Setup stream source type

This allows stream source type setup for IPTV streams: multicast or UDP-proxy.

<tv_stream type="multicast" tsbuffer="100" tsboost="false" hls_version="4"/>

type attribute defines stream type. Could be: “multicast” or “udpxy”.

tsbuffer defines size MPEG-TS buffer in msec (by default, 0ms).

tsboost attribute at value (false) allow to prohibit “cutting” excess audio at startup MPEGTS

hls_version attribute allow setup version of hls protocol

<tv_stream type="udpxy" server="http://user:pwd@host.tv:4022" />

In this example, UDP-proxy is used. UDPXY server address is specified as server_address:port or user:password@server_address:port using server attribute.

speedtest_url attribute defines URL to speed test configuration (supported from fw 4.2.20/4.3.4).

IPTV/OTT protocol setup

This defines various content sources for IPTV/OTT streams.

<tv_protocols default="tvip" force="tvip">
</tv_protocols>

dafault defines default Middleware type.
force defines force Middleware type.
autostart - launch (true) Watch TV app after reboot or sleep. Enabled, by default.

Supported Middleware types:

  • tvip for TVIP Middleware.
  • jsonapi for TVIP JSON API Middleware.
  • m3u for M3U playlist.
  • iptvportal for IPTVPORTAL Middleware.
  • stalker for Stalker Middleware (TVIP UI).
  • browser for web application (portal) middleware.
  • androidapp use Android application as content source (Supported only with Android OS)

TVIP JSON API Middleware setup

<tv_protocols default="jsonapi">
  <protocol type="jsonapi" server="http://api.domain.com" hidden="true" />
</tv_protocols>
  • server - The URL of the API server is defined by server attribute.
  • hidden - This option allow to hide address of middleware server. Supported from firmware 5.0.7.

M3U playlist and XMLTV/JTV EPG setup

This defines M3U playlist based non-middleware mode.

<tv_protocols default="m3u">
  <protocol type="m3u" m3u="http://operator.com/channels.m3u" epg="http://operator.com/epg.zip" />
</tv_protocols>

URL of an m3u playlist is defined by m3u attribute. URL of EPG file (XMLTV/JTV) is defined by epg attribute.

Stalker Middleware setup

This defines Stalker setup that work in TVIP user interface design.

<tv_protocols default="stalker">
 <protocol type="stalker" server="http://provider.net/stalker_portal" />
</tv_protocols>

Stalker portal URL is defined by server attribute.

Web-portal middleware setup

This content source replaces TVIP IPTV application with a web-portal application.

<tv_protocols default="browser">
 <protocol type="browser" server="http://provider.net/portal/" api="tvip" noui="false" />
</tv_protocols>

server attribute defines portal URL (middleware); api defines JavaScript API for the portal (“tvip”, “mag”, “html5”).
If noui attribute is true then all TVIP user interface is replaced by Web portal (“Whole system” mode), if false, then Web-portal only replaces Watch TV app (“TV only” mode). If combined attribute is true and noui is false, then “Combined” mode is used (from v.4.0.23).

:!: “Whole system mode” is now deprecated and will be removed in future updates. Use “Combined” mode instead. If you need to block long press of Home button, use home_uri tag with value tvplayer inside appearance tag.

Optional attributes:
proxy defines HTTP/HTTPS-proxy server;
uiwidth and uiheight defines web page resolution(default: 1280×720);
cas - CAS type;
multi_portal - enable (true) or disable (false) Portal Manager. (from v.3.8.19);
multi_portal_params - if Portal Manager is enabled, provides params containing forced (pre-defined) portals. (from v.3.8.19);
Multi portal params are provided in the following format: "server1=Server 1 Name|http://server1.domain/path&server2=Server 2 Name|http://server2.domain/path"
For selection portal use “dafault” parameter : “server1=Server 1 Name|http://server1.domain/path|default&server2=Server 2 Name|http://server2.domain/path”
force_retry - enable (true) force retries connect to portal at any network or others issues. (from v.5.0.16);
waiting_animation - for disable use false it's allow to disable “boot animation” at time when portal loading. (:!: the attribute allowed at AndroidOS from fw 5.1.10 )

Application as the content source

:!: This module allowed only with Android OS.
This allow use Application as the content source.

<protocol type="androidapp" package="xxxxx" autostart="false" />

Attribute:
package - the package name in system;
autostart - Allow to automatically start the application at value “true”, supported from firmware 5.0.25

Security

This allows to setup channel and app blocking.

Example:

<security>
        <enabled value="true" force="true" />
        <password value="0000" force="true" />
        <autolock_timeout value="600" force="true" />
        <channel_default_locked value="true" />
        <channel_adult_lock value="true" />
        <operator_forced_age value="18" />
        <disabled_apps force="true" value="vidimax,youtube" />
</security>

enabled activates security mode. Also, unlock code (password) is required in that case. To force enable security mode even if user disables it, use force attribute with value true.
autolock_timeout - set autolock timeout in seconds.
channel_default_locked - Block channels mode (true - only channels in black list are blocked, false - all channels except white list are blocked).
operator_forced_age - Block channels with age tag equal or greater then the value (firmwares 4.0.11+).
channel_adult_lock - Block adult channels (adult channels should be set by middleware (firmwares up to 3.8)).
disabled_apps - comma separates list of blocked apps.

Display setup

<display>
  <hd_format value="720p50" />
  <hdmi_autofr value="false" />
  <sd_format value="auto" />
  <aspect value="box" />
  <cec value="false" force="true" />
  <sync_standby value="true" />
  <cec_name value="anyName" />
</display>

hd_format - HDMI-out resolution (auto,2160p50,2160p60,1080p50,1080p60,1080i50,720p50,720p60,576i50).
sd_format - A/V-output (auto,pal,ntsc).
hdmi_autofr - HDMI-output
cec - enable HDMI-CEC.
aspect - Default aspect ratio (box,zoom,full), to set default, use empty value=“”.
sync_standby - STB goes to Sleep/Wake, when TV goes to sleep/wake. (do not supported by all mediacenters and TVs, from fw. 4.0.13).
cec_name - Allows you to set the device name via HDMI on compatible TVs. Format [Aa-Zz,-,,_,0-9] up to 14 characters (supported from firmware 5.1.26).

To force some settings to apply use attribute force with value=“true”

Auto standby mode setup

Supported from v.3.8.6

  <auto_standby timeout="3600" force="true" />

timeout - inactivity time in seconds, after which standby mode will be activated (possible values: from 60 to 2500000, or 0 - disable.).
force - true - override user's setting.

Appearance settings

<appearance>
  <uialpha value="50" />
  <animation value="true" force="true" />
  <listlooped value="true" />
  <uipadding value="large" />
  <tv_preview_mode value="true" force="true" />
  <display_channel_numbers value="true" />
  <channel_icons_aspect value="1.777"/>
  <display_channel_has_archive value="true" />
  <background_picture value="Custom" force="true">
  <picture name="Custom" url="http://domain/Custom.png"/>
  </background_picture>
  <media_freeze_animation value="false" />
  <back_as_recall value="true" />
  <menu_as_home value="true" /> 
</appearance>
  • uialpha - UI transparency (0-100%) - is not availbable from version 4.0
  • animation - Enable (true) or disable (false) UI animations.
  • listlooped - Enable/disable looped channel list.
  • uipadding - Overscan setup (“small”, “medium”, “large”).
  • tv_preview_mode - Enable/disable preview mode in channel list (false - no preview window, true - preview window displays current active stream, hybrid - preview window displays preview of channel, selected by cursor)..
  • tv_cursor_mode - Enable simple TV control mode. In this mode, cursor keys control volume and channel switch.
  • display_channel_numbers - Enable (true) or disable (false) display of channel numbers(supported from firmware 4.0.17).
  • channel_icons_aspect - Channel icon images aspect ration (aspect=width/height). Used for UI channel layout optimizations (supported from firmware 4.0.20).
  • home_uri - Defines System URI, that will be executed on Home key press instead of launching Home screen (supported from fw 4.2.12).
  • display_channel_has_archive - activates (if true) display of archive enabled icon in channel list. Supported from firmware 4.2.16.
  • background_picture - defines monochrome background image for the home screen (and some other apps). value - sets up identifier for the image. Identifier can be internal (like: waves, triangles) or one of the list of <picture> tags. <picture> tag attributes: name - background identifier, url - URL of 8-bit monochrome PNG image. Supported from firmware 4.2.16.
  • media_freeze_animation - Disabling animation «freeze» video (false) - enable (true) - disable (Supported from firmware: 4.2.33).
  • back_as_recall - allows you to assign to the back button the function to return to the previous channel (supported since firmware 5.0.67).
  • menu_as_home - allows you to use the menu button to call the home action, except when used for its intended purpose, this functionality only works in the TV application (supported since firmware 5.0.67).

To force some settings to apply use attribute force with value=“true”

Configuration of user interface color schemes

Supported from firmware 4.0.17

<appearance>
  <color_schemes value="true" override="true" default="Berries" force="Berries">
    <scheme name="TVIP brand color">
      <color name="CL_MAIN" value="#ff2A50A3" />
      <color name="CL_BACKGROUND" value="#ff14A2DC"/>
      <color name="CL_CONTRAST_MAIN" value="#ffCAE2F5"/>
      <color name="CL_CONTRAST_BACKGROUND" value="#ffCAE2F5"/>
      <color name="CL_SECOND" value="#ffF37121"/>
      <color name="CL_button_casual" >CL_BACKGROUND</color>
    </scheme>
    <scheme name="Berries">
    </scheme>
  </color_schemes>
</appearance>
  • color_scheme - root definition of UI color schemes. Attributes: override - if true, preinstalled schemes will be completely overridden by operator defined schemes; default - name of default color scheme; force - name of forced color scheme.
    • scheme - single operator scheme definition; name - defines scheme name.
      • color - defines a color variable; name - defines color id from the scheme. value defines ARGB color like: #AARRGGBB.

Base scheme colors:

  • CL_MAIN - the main color of a scheme. It is used with the most opaque elements. Usually, at the top and bottom of the screen (default: #ff37363c).
  • CL_BACKGROUND - background color for the elements at the center of the screen and for table's backgrounds(default: #73aaaaaa).
  • CL_CONTRAST_MAIN - color for the items (text, images), that are displayed on top of the the main color. This should be in contrast with CL_MAIN (default: #ff282832).
  • CL_CONTRAST_BACKGROUND - color for the items (information) at the center of the screen (like pop-up menus and transparent windows). This should be in contrast with CL_BACKGROUND (default: #ffffffff).
  • CL_SECOND - secondary scheme color. This is used for the active control elements (selectors, buttons) (default: #ffffffff).

Extended colors:

Definition of these colors is optional. They are calculated from the base colors if not defined.

Color Dependency Transparency Description
CL_on_main_casualCL_CONTRAST_MAIN1,00general color for the elements on top of the main color
CL_text_on_main_casualCL_on_main_casual 1,00base text color, that is displayed on top of the main color
CL_text_on_main_activeCL_on_main_casual 1,00active/selected text color, that is displayed on top of the main color
CL_text_on_main_dimmedCL_on_main_casual 0,55dimmed text color, that is displayed on top of the main color
CL_on_background_casualCL_CONTRAST_BACKGROUND1,00base text color, that is at the center or inside a table
CL_text_on_background_casualCL_on_background_casual1,00base text color inside a table
CL_text_on_background_activeCL_on_background_casual1,00active/selected text color inside a table
CL_text_on_background_dimmedCL_on_background_casual0,55dimmed text color for inactive elements in tables and some secondary text
CL_wallpaperCL_BACKGROUND0,90background color for most of UI widgets
CL_fadeCL_BACKGROUND0,90video overlay color for the fullscreen elemens
CL_additionalCL_BACKGROUND0,40additional color for active widgets and active table columns
CL_bgr_colorCL_MAIN1,00color of the background image in the Home screen (when no video) and for some other elements
CL_bumperCL_MAIN0,94color of top and bottom “panels”
CL_headerCL_bumperbackground color of the elements at the top of the screen
CL_footerCL_bumperbackground color of the elements at the bottom of the screen
CL_popupCL_MAIN1,00color of dialog windows, extended settings and system messages
CL_popup_contrastCL_CONTRAST_MAIN1,00content color inside dialog windows
CL_plateCL_MAIN1,00“Plates” (Home screen elements, VoD elements, etc.) color
CL_plate_contrastCL_CONTRAST_MAIN1,00context (text, buttons) color inside “plates”
CL_selectorCL_SECONDselector color for the active/selected control elements, cursor, active buttons, etc.
CL_emptyCL_SECOND1,00color of inactive part of a progress bar
CL_inactiveCL_SECOND0,35color for disabled UI elements (buttons)
CL_fullCL_CONTRAST_MAIN1,00color of active part of a progress bar
CL_button_selectedCL_selector1,00color of a selected button
CL_button_casualCL_selector0,35color of a disabled button
CL_on_buttonCL_on_background_casualtext and icon color for a button

Preinstalled scheme names are the following:

  • Default
  • Deep Purple
  • Indigo
  • Teal
  • Blue
  • Light Green
  • Berries
  • Chocolate
  • Medusa
  • TVIP classic

Media playback setup

Supported from firmware: 4.0.19

Allows setup of some media playback parameters.

  <media>
    <default_audio_language force="true" value="bul bg eng en" />
    <default_subtitle_language force="true" value="en eng" />
  </media>
  • default_audio_language - default audio language for media playback.
  • default_subtitle_language - default subtitle language for media playback.

value attribute is space-separeted list of ISO 639-1 and ISO 639-2 language codes. It is recommended to use both formats for each language (ex. “eng en”). If more the one language is set up, the one listed earlier has priority.
If audio value is empty, first supported audio track is used. If subtitle value is empty, subtitles will be disabled.
This provisioning value is not compatible with the samilar settings in user interface. It is recommened to hide user interface setting, if provisioning is used.

Force mount SMB and NFS shares

That forces mounting of remote storage.

<mountpoints>
  <mountpoint  type="smb" mountname="SMB Share">
    <address value="192.168.1.1" />
    <folder value="Movies" />
    <password value="pass" />
    <username value="login" />
  </mountpoint>
  <mountpoint type="nfs" mountname="NFS Share">
    <address value="nfs.operator.com" />
    <folder value="/home/sharing/Movies" />
  </mountpoint>
</mountpoints>

Protocol is set by type attribute (“smb” or “nfs”), mountname defines resource name.

In this example two shares are mounted:
- SMB directory with name “Movies” on the SMB server with IP 192.168.1.1 with username “login” and password “pass”.
- NFS directory “/home/sharing/Movies” on the NFS server with domain name nfs.operator.com.

Force add CCTV sources

This sets up sources for CCTV app. Sources could be: direct URLS in UDP, HTTP, RTSP formats or M3U-playlists over HTTP.

<cctv_sources>
  <source name="Cameras" url="http://cam.operator.com/cameras.m3u" />
  <source name="Our Office" url="rtsp://cam.operator.com/office" />
</cctv_sources>

name attribute sets name in the CCTV list. url defines URL of a stream or playlist.

"Cable TV" mode over provisioning

Supported from firmware: 4.2.33

This option allow playback of a single stream without UI

<system_locks>
        <ctv enabled="true" url="http://your_stream.com" volume="30" />
</system_locks>

Block debug window access (s.info->DEL)

<system_locks>
        <sysinfo_del locked="true" />
</system_locks>

Block reset to default settings

<system_locks>
        <reset locked="true" />
</system_locks>

Disable IGMPv1 protocol

Supported from fw version 4.0.13 for Linux-Qt OS. Does not supported for all mediacenters.
Prevents OS kernel to use IGMP protocol with version lower then 2.

<system_locks>
        <igmpv1_block enabled="true" />
</system_locks>

Restrict access to mediacenter settings

You can hide or disable almost any setting in Settings app. Note: this does not set setting values. It just control user's access to settings! You should use id of a setting to work with it. Possible values:

visible="false/true"
disabled="false/true"

Root setting tabs:

pref_system - System
pref_appearance - Appearance
pref_network - Network
pref_display - Display
pref_tv - TV
pref_security - Security

<preferences>
  <pref_network visible="false" />
</preferences>

In this example, “Network” tab is totally hidden from Settings.

Ids of System tab

pref_system_language - System language
pref_system_updatetype - Update type
pref_system_updateperiod - Update period
pref_system_updatebackground - Background install
pref_system_timezone - Timezone
pref_system_timeserver - NTP address
pref_system_timeformat - Time format
pref_system_auto_standby - Auto standby
pref_system_audiolanguage - Default audio language
pref_system_subtitlelanguage - Default subtitle language
pref_system_digitalsoundmode - Digital sound
pref_system_dial - Multiscreen
pref_system_button_bluetooth_remote - Bluetooth setup
pref_system_button_checkupdates - Check updates
pref_system_button_info - Info button

Ids of appearance tab

pref_appearance_alpha - UI transparency
pref_appearance_anim - Animated UI
pref_appearance_channel_numbers - Channel numbers
pref_appearance_channel_icons - Channel icons
pref_appearance_listlooped - Looped channel list
pref_appearance_padding - Overscan
pref_appearance_tv_preview_mode - TV preview mode
pref_appearance_tv_cursor_mode - TV cursor mode
pref_appearance_color_preset - UI color preset
pref_appearance_background - UI background

Ids of Network tab

pref_network_iface - Interface type (Eth/WiFi)
pref_network_iface_enabled - Network interface enable
pref_network_wlan_ssid - WiFi Access point
pref_network_config - Config (DHCP/Manual)
pref_network_ip - IP-address
pref_network_mask - Mask
pref_network_gateway - Gateway
pref_network_dns1 - DNS1
pref_network_dns2 - DNS2
pref_network_router_mode - Network sharing

Ids of Display tab

pref_display_hdformat - HD format
pref_display_hdhdmienable - HDMI enable
pref_display_hdcomponentenable - Component enable
pref_display_sdformat - SD format
pref_display_sdrcaenable - RCA enable
pref_display_sdsvideoenable - S-Video enable
pref_display_aspect - Aspect ratio
pref_display_cec - HDMI-CEC

Ids of TV tab

pref_tv_streamtype - Stream type
pref_tv_udpxyaddress - UDPXY address
pref_tv_mpegts_buffer - MPEG-TS buffer
pref_tv_dvr_deviceid - DVR storage
pref_tv_timeshift_deviceid - Timeshift storage
pref_tv_autotimeshift - Autotimeshift
pref_tv_middleware - Content source
pref_tv_button_midd_setup - Content source setup
pref_tv_inter_apps - Interactive apps

Ids of Security tab

pref_security_enable - Enable security
pref_security_timeout - Autoblock timeout
pref_security_tvfiltertype - Filtering type (black/white)
pref_security_operatorlock - Adult channels block
pref_security_allowtv - Enable/disable Watch TV
pref_security_allowmediaplayer - Enable/disable Mediaplayer
pref_security_allowdvr - Enable/disable DVR
pref_security_allowcctv - Enable/disable CCTV
pref_security_allowwebapps - Enable/disable web apps
pref_security_allowapps - Enable/disable Android apps

<preferences>
  <pref_network visible="false" />
 
  <pref_tv>
    <pref_tv_streamtype visible="false" />
    <pref_tv_udpxyaddress visible="false" />
    <pref_tv_middleware disabled="true" />
  </pref_tv>
 
</preferences>

In this example: Network tab is totally hidden; in TV tab Stream type and UDPXY address are hidden; in TV tab Middleware change is prohibited.

TVIP App Store server URL

:!: Supported only for OS Android, firmware 4.4.1+

This defines various server URL for Tvip App Store.

example:

<appstore_server url="https://operator.com/appstore/appstore.json" />

A description of the configuration of the TVIP App Store server is available at link

tvip_provision.xml example

<?xml version="1.0"?>
<provision reload="3600"><!--Update time in seconds -->
 
 <!-- Update server setup -->
 <update_server name="update.tvip.tv" />
 
 <!-- Logo setup -->
 <logo url="http://operator.com/prov/logo.png" />
 
 <!-- Hide dvr app -->
 <features>
   <dvr enabled="false" />
 </features>
 
 <!-- UDP-proxy setup -->
 <tv_stream type="udpxy" server="login:pass@udpxy.operator.com" />
 
 <!-- M3U and EPG setup -->
 <tv_protocols default="m3u">
   <protocol type="m3u" m3u="http://operator.com/channels.m3u" epg="http://operator.com/epg.zip" />
 </tv_protocols>
 
 <!-- Add video source -->
 <mountpoints>
  <mountpoint  type="smb" mountname="SMB Share">
    <address value="192.168.1.1" />
    <folder value="Movies" />
    <password value="pass" />
    <username value="login" />
  </mountpoint>
 </mountpoints>
 
 <!-- CCTV Setup -->
 <cctv_sources>
  <source name="Cameras" url="http://cam.operator.com/cameras.m3u" />
 </cctv_sources>
 
 <!-- Disable network user-preferences. Middleware change restriction. -->
 <preferences>
   <pref_network visible="false" />
   <pref_tv>
     <pref_tv_streamtype visible="false" />
     <pref_tv_udpxyaddress visible="false" />
     <pref_tv_middleware disabled="true" />
   </pref_tv>
 </preferences>
 
</provision>
en/provisioning.txt · Last modified: 2024/08/06 16:25 by Alexander