MAG :LOGICIEL STB

LOGICIEL STB

Fichier imageupdate
Le logiciel STB est un ensemble de programmes destinés à contrôler le fonctionnement du STB . Le logiciel STB comprend le noyau Linux et le système de fichiers racine (Root FS) qui contient des composants logiciels fournis par les fabricants de CPU et de STB.

La procédure de combinaison de composants logiciels STB ( création de logiciels STB ) est effectuée dans l’usine de fabrication STB. À la suite de la procédure de construction, le fichier image système ( ci-après – image ) est créé qui est appliqué pour le chargement et l’exécution dans STB. Cette image-fichier nommée imageupdate est utilisée pour la mise à jour du logiciel STB .

Le fabricant du STB permet aux clients (opérateurs IPTV et utilisateurs individuels) de modifier certains composants du logiciel STB et de créer indépendamment l’ image du logiciel STB conformément aux instructions du fabricant . Ce processus est appelé personnalisation logicielle STB. Cela permet aux opérateurs IPTV de configurer les décodeurs en fonction de leurs propres environnements de travail et préférences, ainsi que d’intégrer le logiciel STB avec les applications d’ autres développeurs .

Il existe plusieurs types de mise à jour d’ images à produire par le fabricant et les opérateurs .
Plates-formes ouvertes et fermées de STB
Modèles STB avec plates-formes ouvertes et fermées
Les STB de la famille MAG peuvent être produits sur la base de plates-formes matérielles-logicielles ouvertes ou fermées, en fonction de l’objectif de son application. Produit des modèles STB sont l Isted dans les modèles de base de STB Linux et WebKit section , compte tenu de la division en plates – formes ouvertes et fermées .

Le contenu de cette documentation électronique se réfère principalement aux modèles STB de la plate-forme ouverte (sauf lorsque spécifiquement indiqué qu’une plate-forme fermée est décrite).

Distinctions entre les plates-formes STB ouvertes et fermées
L’idée de la plate-forme ouverte est de fournir aux utilisateurs ( utilisateurs individuels et opérateurs IPTV / OTT) la possibilité de modifier (effectuer eux-mêmes des personnalisations ) du logiciel STB et de l’ intégrer à des applications d’ autres développeurs.

À son tour, la plateforme perdue est destinée aux solutions d’opérateurs qui utilisent le système CAS / DRM assurant la protection du contenu . Le système CAS / DRM est un complexe matériel-logiciel intégré dans le réseau IPTV de l’opérateur particulier ainsi que dans les récepteurs d’abonnés (STB) dédiés au fonctionnement de ce réseau. Pour sécuriser le contenu multimédia, le cryptage de la transmission des flux audio-vidéo est utilisé, ce qui permet de lire le contenu multimédia uniquement sur les modèles enregistrés de lecteurs multimédias (STB) de l’opérateur IPTV particulier. En outre, la protection de contenu systèmerestreint diverses actions avec du contenu audio-vidéo sous copyright (copie, modification, lecture répétée, distribution, etc.). Il existe différents types de systèmes de protection de contenu qui diffèrent par les implémentations matérielles / logicielles, les niveaux de protection du contenu, les types de contenu en cours de traitement, etc. Un système CAS / DRM particulier à utiliser dans le projet IPTV est sélectionné par l’opérateur IPTV. Les STB utilisés sur le réseau particulier doivent prendre en charge ce type de CAS / DRM, être enregistrés dans le système CAS / DRM de l’opérateur et doivent contenir dans le micrologiciel les paramètres système CAS / DRM de l’opérateur .

Le logiciel STB pour la plate-forme fermée est produit dans l’usine de fabrication par accord individuel avec chaque opérateur concerné. Le logiciel STB avec la plate-forme fermée interdit la modification du logiciel STB par les utilisateurs, sans la participation de l’opérateur IPTV dont la signature (clé opérateur) est définie dans STB.
Images du logiciel STB plates-formes ouvertes et fermées
Pour répondre aux différentes exigences des clients, plusieurs options d’image logicielle STB de la plate-forme ouverte sont conçues et peuvent être divisées en deux groupes:

PublicImage et FactoryImage – créés et fournis par le fabricant. Ils sont destinés principalement aux utilisateurs individuels ainsi qu’aux utilisateurs des opérateurs OTT .
CustomImage et OperatorI mage – créés et fournis par l’opérateur. Ils sont destinés aux utilisateurs des opérateurs IPTV .

L’ image du logiciel STB est créée conformément aux instructions du fabricant sur la base des composants logiciels comprenant la version du logiciel STB . Il peut inclure des paramètres opérateur personnalisés .

Les STB à plate-forme fermée, qui se concentrent sur les solutions d’opérateur IPTV, utilisent OperatorImage qui est signée par la signature numérique d’un certain opérateur (clé d’opérateur).
Versions du logiciel STB
Paramètres de version du logiciel STB
La version du logiciel STB (également appelée version i mage ) comprend les paramètres suivants:

Modèle – numéro de modèle du STB auquel la version est destinée;
Version – un numéro attribué par le développeur lors de la création d’image. Pour les images du fabricant STB, un numéro à trois chiffres est utilisé;
Date – date de création d’image qui est attribuée automatiquement lors de la création d’ image;
Description – description détaillée de la version du logiciel. Il peut être attribué par un développeur lors de la création d’images. Le créateur d’image peut utiliser ce paramètre pour spécifier le type d’image, le nom de l’opérateur, les fonctionnalités du logiciel STB, etc. Par exemple, la description 0.2.18-r19-pub-254 signifie: version – 218 , release (dans la version) – 19 ; type d’image – image publique ; Modèle STB – MAG-254 .

Comment apprendre la version du logiciel STB
La version du logiciel STB peut être obtenue par l’utilisateur:

MAG250 / 254/270 – f rom Menu Bootloader ⇒ Informations sur l’ image section. Voir les éléments Version, Date, Description :

MAG256 / MAG3xx / MAG4xx et plus – f rom Menu système utilitaire de récupération ⇒ Informations sur l’appareil section. S ee numéro de version d’image , date d’image , Description de l’ image articles:

Depuis le portail intégré : Paramètres ⇒ Paramètres système ⇒ Informations sur l’appareil (voirVersion de l’image, Description de l’image,Éléments dedate de l’image):

Informations sur la version du logiciel encapsulées dans le fichier imageupdate
Le fichier imageupdate comprend une brève description de la version qui peut être visualisée, par exemple sur un ordinateur, avec une application d’éditeur de texte . Pour obtenir ces informations, ouvrez le fichier imageupdate en mode d’affichage de texte. Les informations sur la version du logiciel se trouvent en haut de la fenêtre. Par exemple:

Version du logiciel STB
Les versions logicielles STB sont des moyens de diffuser les logiciels du fabricant STB MAG via son référentiel Web à toutes les parties concernées (utilisateurs, opérateurs, développeurs, etc.).
Chaque version du logiciel STB (ci-après – version) représente une nouvelle version du logiciel d’un modèle STB spécifique. Une fois publiée pour un modèle STB spécifique, la version définit la version actuelle du logiciel de travail pour ce modèle STB.
Emplacement de la version du logiciel
Les versions de divers modèles STB sont publiées en libre accès par l’URL suivante:

http://soft.infomir.com/mag <model> / release /

où:

 <model>   – valeur numérique du modèle STB de base (par exemple, 254, 256, 322, etc.);

Exemple d’URL pour la version STB MAG322 : http://soft.infomir.com/mag322/release/

La libération d’un modèle STB de base particulier peut être appliquée à tous ses modèles dérivés. Par exemple, la version MAG254 est également appliquée aux modèles MAG254w1, MAG254w2.
Paramètres de libération
Étant donné que chaque version contient une version du logiciel STB particulière, certaines options de version peuvent coïncider avec les paramètres de version du logiciel STB . Liste des paramètres de version :

Modèle STB auquel la version / version est destinée;
Version de la version = version du logiciel, incluse dans la version;
Date de sortie.

L’exemple de la release pour STB MAG420 est donné ci-dessous: version 2.20.03-r2, date – 2020-04-02 .

Contenu de la publication
Release contient les fichiers principaux suivants:

imageupdate – image publique, créée par le fabricant, basée sur les composants logiciels inclus dans la version;
Bootstrap – fichier de démarrage contenant l’image du noyau du système d’exploitation. Il est utilisé pour la mise à jour depuis Bootloader dans le cas des modèles STB MAG250 / 254/270. Il est également utilisé pour la restauration du système dans le cas des modèles STB MAG-256 / 3xx / 4xx et supérieurs – à titre d’exemple, voir Démarrage d’urgence MAG4xx .
portal-dev- <date> .tgz – paquet archivé des codes sources du portail. Il peut être appliqué pour personnaliser l’interaction avec les portails à charger dans STB qui peuvent affecter la procédure de chargement du portail dans STB, la conception de diverses pages du portail et des applications embarqués, etc. Certaines fonctionnalités de personnalisation et la procédure de compilation du portail embarqué sont décrit dans le développeur section – voir Personnalisation , logiciel embarqué et localisation de logiciels embarqués sous – sections .
rootfs- <date> .tar.gz – paquet archivé du système de fichiers racine STB ( RootFS ). Toute la personnalisation du logiciel STB s’effectue en apportant des modifications dans RootFS et en construisant davantage l’ image contenant RootFS modernisé.
uImage_ <model> .clean ou vmlinux.bin.mag < model > – image du noyau d’origine du modèle STB approprié (spécifié comme < model > ). Il est utilisé dans la construction d’image .

Logiciel STB fourni par le fabricant – images publiques et d’usine
Le logiciel STB est émis et fourni par le fabricant en libre accès. Les deux variantes de base suivantes du logiciel STB sont appliquées:

L’image d’usine  est créée par l’usine et installée dans STB à l’usine dans le processus de fabrication . L’ image Factory est distribuée pour la mise à jour STB – la dernière version de l’ image Factory ( fichier imageupdate ) est fournie aux utilisateurs à partir du serveur Web du fabricant . L’ image d’  usine contient un mécanisme qui empêche la mise à jour vers d’autres images (non d’usine). Ce mécanisme permet d’utiliser uniquement un logiciel STB éprouvé (fabriqué en usine). Dans l’ image Factory , l’accès au système de fichiers racine STB sur le protocole SSH est interdit.
L’image publique est créée par le fabricant et est émise dans la version de chaque modèle STB. Dans le même temps, le fabricant fournit avec la version les composants logiciels nécessaires, sur la base desquels les utilisateurs peuvent créer votre propre modification d’image publique (afin de personnaliser le logiciel) selon les instructions du fabricant .
Les versions publiques du logiciel sont signées avec la clé publique (ID_KEY = STB_PUBLIC), incluse dans Operator Utilities .
L’ image publique peut être mise à jour manuellement dans STB par l’utilisateur lors de la phase de démarrage du STB (à partir du menu Bootloader  – pour STBMAG-250/254/270 ou menu de l’utilitaire de récupération système pour STB MAG-256 et MAG-322/324/349/351 ) .
En règle générale,
l’image publiqueest destinée au débogage, aux modifications opérationnelles des paramètres internes, à la surveillance et à d’autres fins auxiliaires. L’image publiqueest ouverte pour changer le logiciel STB en cours d’exécution. Pour accéder au système de fichiers racine STB, leprotocole SSH est utilisé.

Mettre à jour l’image d’usine

Description de la mise à jour logicielle pour différents modèles STB : mise à jour logicielle STB

La mise à jour de l’ image d’usine est effectuée à partir du portail  STB  Embedded – automatiquement ou manuellement (par des commandes utilisateur).
Si STB exécute l’ image d’usine , seules les versions d’ image d’usine sont acceptées pour la mise à jour . A ny différents types d’images (public, personnalisé) sont rejetés lors d’une tentative de mise à niveau du portail embarqué .
Mise à jour automatique
Mise à jour automatique de la f image actory est effectuée (protocole HTTP) sur le réseau, depuis l’ URL spécifiée dans STB logiciel . Les paramètres de mise à jour automatique sont accessibles par l’utilisateur à partir du portail STB Embedded ou exécutés par l’administrateur du serveur Middleware (si STB est connecté à un portail externe).

Les paramètres de mise à jour automatique dans le portail intégré sur un exemple de STB MAG254  sont décrits dans la section Mise à jour automatique du logiciel .
La configuration de l’URL de mise à jour automatique dans le logiciel STB et les étapes de la procédure de mise à jour sont décrites dans la section du développeur de description du module Autoupdate .

Mise à jour manuelle
M mise à jour anual à f l’ image actory est effectuée à partir du portail embarqué . En fonction de l’emplacement d’un fichier de mise à jour ( imageupdate ) qui peut être placé sur le serveur Web du fabricant ou localement sur une clé USB, les options de mise à jour suivantes sont disponibles:

Mise à jour logicielle depuis Portal par HTTP
Mise à jour du logiciel depuis Portal par USB

Les versions d’ image d’usine sont publiées sur le serveur Web du fabricant par adresse:

http://update.infomir.com/mag/<model>/imageupdate

où  <model>  est une valeur numérique du modèle STB de base (par exemple 250, 254, 256, 322, etc.).

Par exemple, pour STB MAG322, la dernière adresse de version de l’image f actory : http://update.infomir.com/mag/322/imageupdate

En règle générale, une seule dernière version stable du logiciel pour chaque modèle STB se trouve sur le serveur de mise à jour. Mais dans certains cas, le serveur de mise à jour comprend plusieurs versions logicielles du même modèle STB à sélectionner par l’utilisateur (elles sont accessibles depuis le portail Embedded).
Mettre à jour l’image publique
La mise à jour vers l’image publique est effectuée manuellement uniquement à la phase de démarrage du STB (à partir du  menu Bootloader  – pour STB MAG-250/254/270 ou du menu System Recovery Utility – pour STB MAG-256, MAG-3xx et MAG-4xx) . De cette façon, les utilisateurs peuvent mettre à jour STB vers la version requise de l’image publique ou effectuer la transition de tout autre type d’image ( usine , personnalisée ) vers l’ image publique .

Pour MAG- 250/254/270 : mise à jour du logiciel de Bootloader
Pour MAG- 256 / 3xx / 4xx: mise à jour du logiciel de l’ utilitaire système de récupération

Les versions d’image publique produites par le fabricant sont publiées dans les versions STB .
Images créées par les opérateurs
Comme décrit dans le logiciel STB fourni par la section fabricant , les opérateurs peuvent créer leurs propres modifications d’image publique (PublicImage). En outre,  deux types spéciaux d’image SW sont destinés à être utilisés dans les réseaux IPTV des opérateurs: Image personnalisée ( CustomImage ) et Image opérateur ( OperatorImage ) .

Chaque opérateur crée lui-même l’image et la gère avec sa propre clé cryptographique sécurisée ( voir la section Signature cryptographique de l’image ). Lorsque vous essayez de mettre à jour le logiciel STB, la signature numérique est vérifiée. Cela garantit que seul le logiciel créé par un opérateur particulier est utilisé dans STB.

La version d’image du logiciel STB créée par un opérateur est placée sur son serveur Web. Je n afin de fournir une mise à jour STB, STB image logicielle devrait comprendre une URL de mise à jour spécifique définie dans STB image logicielle (voir la personnalisation du logiciel STB – paramètre URL de mise à jour, URL mise à jour automatique) .
Déverrouillage du STB avec la clé opérateur installée

Si certaines clés d’opérateur ont été définies dans STB, alors tous les problèmes liés au «déverrouillage STB» (reprogrammation, passage à la version d’image de l’usine ou de différents opérateurs), les utilisateurs doivent s’adresser directement à l’opérateur. Ni les services de support technique du fabricant STB ni le centre de service ne peuvent déverrouiller STB si une clé opérateur a été définie dans STB.

Mettre à jour vers l’image personnalisée
La mise à jour du STB vers l’ image personnalisée est effectuée à partir d’un portail – externe ou intégré. La mise à jour signifie la transition vers une autre version de Сustomimage du même opérateur. Remarque. La description de la première installation spécifique en deux étapes de CustomImage est décrite dans l’ instruction de création de CustomImage . Les mises à jour ultérieures de l’ image personnalisée sont effectuées de la manière habituelle à partir du portail (en utilisant des méthodes HTTP ou USB).

CustomImage contient une clé d’opérateur installée (personnalisée), qui est vérifiée lors de la tentative de mise à jour de l’image. Ainsi, si STB exécute Customimage , seules les versions CustomImage du même opérateur (contenant la même clé personnalisée) sont autorisées à mettre à jour STB à partir de Portal. I mage v ersions d’autres types (images Factory, Public image) ou personnalisée d’ image avec une clé personnalisée différente sont rejetées lors d’une tentative de mise à jour.

La mise à jour vers l’ image personnalisée à partir du portail intégré est similaire à celle décrite pour la mise à jour vers l’image d’usine – en mode automatique ou manuel. Cependant, comme le fichier de mise à jour est hébergé sur le serveur Web de l’opérateur, une URL de mise à jour correspondante change.
Remarque. Les adresses pour les mises à jour manuelles et / ou automatiques sont spécifiées lors de la création d’images – voir Personnalisation du logiciel STB .
Exemple de configuration de la mise à jour à partir du portail externe
1. Mise à jour manuelle de la configuration à partir du portail MW Ministra (mise à jour depuis l’URL):

  Exemple de configuration

2. Configuration de la mise à jour STB dans le panneau d’administration MW Ministra:

Comment effectuer la mise à jour automatique du firmware STB?
Comment définir la condition de mise à jour du firmware?

Signature cryptographique de l’image
Afin d’empêcher l’exécution de logiciels non autorisés dans STB, chaque image logicielle STB est signée avec une signature numérique, à l’aide du programme GnuPG (GPG). L’ algorithme RSA est également appliqué pour fournir le cryptage des données et l’intégrité de la vérification d’image.

Programme GPG génère с ryptographic clé qui se compose d’une partie secrète ( clé privée ou clé secrète ) et une partie ouverte ( clé publique ) . Lors de la création de chaque с ryptographic clé, il est assigné une clé identificateur (ID_KEY) qui est le nom de clé unique dans la base de données GPG.
La clé privée est une propriété du créateur de l’image (c’est-à-dire de l’opérateur). Il est gardé secret et utilisé pour la signature de nouvelles images pendant le processus de création d’image.
Utilisation de la clé publiqueinstallé dans le STB, l’authenticité de l’ image SW en cours de chargement dans le STB est vérifiée. Lors d’un chargement d’image dans le STB, la disponibilité et l’exactitude de la signature sont vérifiées (si les clés publiques et privées correspondent l’une à l’autre ). En cas d’incompatibilité des touches, l’ erreur «Wrong Signature» s’affiche et l’image n’est pas chargée dans le STB.

Pour créer des images d’opérateur ( CustomImage , OperatorImage ), les opérateurs utilisent leurs propres clés. Si OperatorImage est utilisé par l’opérateur , la partie publique de la clé opérateur doit être signée avec la clé Fabricant avant l’installation dans les STB. La création d’images par les opérateurs et l’installation de la clé opérateur dans STB sont effectuées conformément aux instructions du fabricant de STB.

Les images publiques ( PublicImage ) sont signées avec la clé d’opérateur par défaut du fabricant (ID_KEY = STB_PUBLIC). La clé publique de la clé opérateur par défaut est installée dans le STB en usine. La partie privée de la clé d’opérateur par défaut est incluse dans les utilitaires de création d’ images (файл stb_secbin.key ). Il est utilisé dans la procédure de génération de PublicImage et CustomImage .
Instructions pour la construction de l’image
Image publique

PublicImage – Préparer, faire pour MAG254

Images de l’opérateur

CustomImage – Préparation, réalisation pour MAG254
OperatorImage – Les instructions pour la réalisation et la mise à jour de l’image sont fournies aux opérateurs après accord avec le  service commercial sur la procédure de signature de la clé de l’opérateur .
Rendre l’ opérateur ou la clé personnalisée :

Préparation de clé personnalisée
Remarques sur l’utilisation de GPG
Quelques détails sur l’image de l’opérateur sont décrits dans le Operator_Guide_MAG200.pdf (voir chapitre Fonctionnement avec les touches , p. 20)

Additionnel

SSH – changer le mot de passe, le port, désactiver / activer

Personnalisation du logiciel STB
La personnalisation du logiciel STB fait référence à la configuration de l’interface utilisateur du logiciel STB et des paramètres de fonctionnement du STB en fonction des demandes du client (opérateur), ainsi qu’à l’intégration des applications nécessaires, y compris la prise en charge du portail multimédia externe.

Pour personnaliser certains modèles STB , l’ opérateur IPTV modifie l’ image STB conformément aux instructions du fabricant STB . Les composants d’image STB sont fournis dans la  version du logiciel STB . Au cours du processus de personnalisation, les modifications nécessaires sont apportées au système de fichiers racine , avant de l’inclure dans la construction de l’image.

En règle générale, i mage c ustomization est utilisé pour créer  sur mesure  et  opérateur images. À des fins de test et de débogage, la personnalisation peut également êtreeffectuée dans l’ image publique .
La personnalisation peut traiter les points suivants:

Logo de Bootloader ;
Vérification des variables (définition des valeurs par défaut requises) lors du démarrage du STB / portail ;
Paramètres par défaut du STB définis avec des variables d’environnement, lors de la création de l’image (voir le contenu de env.txt ). Liste des paramètres possibles et des variables pertinentes :

Couleur de fond et de police du chargeur de démarrage – bg_color, fg_color ;
Paramètres de pays ou de région spécifiques tels que la langue du portail intégré, le fuseau horaire – langue, timezone_conf ;
URL du serveur de temps (NTP) – ntpurl ;
Paramètres d’affichage vidéo en mode Bootloader et media-portal (format PAL / NTSC, mode de sortie vidéo, résolution graphique de l’écran, réglage automatique de la fréquence d’images) – bootTVsystem, tvsystem, graphicres, auto_framerate ;
URL du portail externe à charger automatiquement dans STB – portal1 ;
Possibilité de masquer / afficher l’URL des portails externes – custom_URL_hider ;
URL de la mise à jour du STB dans le portail intégré ( Paramètres système ⇒  Mise à jour du logiciel ⇒  Option URL ) – update_url;
URL et conditions de la mise à jour automatique du STB (voir la section de description du module Autoupdate ) – autoupdateURL, autoupdate_cond ;
Remarque. Une liste plus détaillée des variables d’environnement ainsi que la méthode d’observation des valeurs de variables directement dans STB sont fournies dans la section Variables les plus utilisées .

Activation / désactivation de l’accès utilisateur aux paramètres, à l’aide de rules.js (pendant la préparation de la création d’image logicielle) :

Désactivation / activation des éléments des paramètres système , menus Paramètres ;
Configuration de Sélectionnez un portail pour la fenêtre de chargement (permet d’ouvrir la fenêtre avec la touche Menu de RC; permission d’entrer dans le portail intégré et les paramètres système );
Configuration de la  fenêtre d’ erreur de chargement de page (page 404);
Accès aux paramètres système avec un mot de passe.

Localisation (interprétation) de l’interface utilisateur du portail intégré dans une langue qui n’est pas prise en charge par défaut ;
Accès par protocole SSH au système de fichiers STB ;
Mise à jour automatique des listes de lecture à partir d’une URL donnée ;
Pour les applications, détermination de l’URL de transition à la sortie (Referrer) ;
etc.

Développement d’un nouveau portail
Pour effectuer la personnalisation des applications Web, le fabricant fournit aux utilisateurs (opérateurs) un ensemble d’API. Ainsi, les utilisateurs (opérateurs) peuvent créer leurs propres versions du portail multimédia pour contrôler le fonctionnement du décodeur. En outre, le fabricant offre la possibilité de mettre à niveau le portail intégré de STB (le code source du portail est fourni dans chaque version du logiciel) et de créer sa version du portail avec son inclusion supplémentaire dans l’image personnalisée du logiciel STB. Par exemple, vous pouvez modifier l’algorithme de chargement et d’exploitation du portail, modifier la conception du portail, etc.

La description de certains problèmes liés à la personnalisation du portail est donnée dans les sections suivantes: