Все примеры используемые в данном руководстве приведены для Ubuntu Server 12.04 i386.

Например: Для Ubuntu Server 12.04 i386, достаточно установить пакет mtd-utils

Утилиты оператора позволяют собирать образ ПО в трех вариантах:

• PublicImage - образ подписанный стандартным публичным ключом STB_PUBLIC.
  Варианты обновления: Начиная с версии ПО 0.2.14-r8 обновляется по HTTP и (USB без Bootstrap из меню портала) только на «версии ПО завода изготовителя», («версии ПО завода изготовителя» - версии ПО собранные непосредственно производителем и предоставляемые для автоматического и ручного обновления по URL завода изготовителя). На другие версии обновляется только из меню Bootloader-a (multicast, USB&Bootstrap). Заводской вариант образа ПО (imageupdate), подписанный стандартным публичным ключом STB_PUBLIC, выкладывается в каталоге с каждым текущим релизом, соответственно модели STB, по адресу: soft.infomir.com.ua

• CustomImage - образ подписанный кастомным ключом для обновления ПО. Ключ создается оператором самостоятельно без обращения к производителю.
  Варианты обновления: Обновляется по HTTP и «USB без Bootstrap» только на образы ПО собранные на основе или после 0.2.14-r8 и подписанные этим же ключом. На другие версии ПО (не подписанные «кастомным ключом»), обновляется только из меню Bootloader-a (multicast, USB&Bootstrap). Рекомендуется для операторов которые хотят реализовать безопасное обновление ПО через HTTP, но оставить вариант обновления на другие версии ПО из меню Booloader-a.

• OperatorImage - образ подписанный ключом оператора. При этом ключ оператора в обязательном порядке подписан на заводе изготовителе.
  Варианты обновления: Обновляется только на версии ПО подписанные этим же ключом оператора.

MAG-250/254/270 используются файлы:

• vmlinux.bin.mag<model_number>

MAG-256/351/324 используются файлы:

• uImage_mag<model_number>.clean

где <model_number> - номер модели STB для которой собирается образ ПО.

vmlinux.bin.mag<model_number> или uImage_mag<model_number>.clean необходимо взять из релиза ПО в соответствии с моделью STB для которой собирается образ и поместить в каталог ./images. Каталог ./images находится в каталоге с утилитами.

Файлы:

• uImage_mag<model_number>
• uImzlib_null_mag<model_number>.img
• uImzlib_mag<model_number>.img

- будут созданы в каталоге с утилитами после окончания работы скриптов.

Пример для MAG-250 - используется скрипт ./kernel_sign_250.sh

Параметры сборки образа указываются в профайле:

* Пример для MAG-250 - используется профайл ''img_make.profile.mag250'' 

Пример профайла img_make.profile.mag250

#    Kernel's file system
export KERNEL_PATH=./uImzlib_mag250.img
#    File name for enviroment variable
export ENV_VARIABLE_PATH=./images/env_mag250.txt
#    Userfs
export USERFS_VERSION=1
export USERFS_PATH=./images/userfs.img
#    File name for SecondBoot
export SECONDBOOT_PATH=./images/SbootIm_mag250
#    File name for Logotype
#export LOGOTYPE_PATH=./images/logo.bmp.gz
export MAG200_OP_KEY=STB_PUBLIC

Описание переменных профайла

Для правильной работы утилит оператора, переменная KERNEL_PATH в профайлах, должна иметь значение ./uImzlib_mag250.img для MAG250 и ./uImzlib.img - для MAG200. Переменные ENV_VARIABLE_PATH, USERFS_VERSION, USERFS_PATH, SECONDBOOT_PATH, LOGOTYPE_PATH могут быть закоментированы, в этом случае соответствующей секции не будет в образе. В переменной MAG200_OP_KEY должен быть установлен соответствующий идентификатор - (ID) ключа, которым будет подписан образ,

Например: export MAG200_OP_KEY=ID_key, где ID_KEY должен быть:

• STB_PUBLIC - для сборки PublicImage. Публичный ключ входи в состав утилит;
• ID кастомного ключа - для сборки CastomImage;
• ID ключа оператора - для сборки OperatorImage.

Необходимые переменные Bootloader-a указываются в файле ./images/env.txt

Наиболее часто используемые переменные

Пример файла env.txt

bg_color=0x00006498
fg_color=0x00FFFFFF
portal1=http://10.1.0.1/stalker_portal/c/index.html
language=ru
update_url=http://10.1.0.1/imageupdate
ntpurl=10.1.0.1
timezone_conf=Europe/Kiev

Синтаксис:

./img_make.sh <version_number> "<description>" <path_to_rootfs> <modelname> <path_to_profile>

где:

Пример для MAG-250:

./img_make.sh 218 "Test_my_version" ../250/rootfs-0.2.18r14 MAG250 ./img_make.profile.mag250

Пример для MAG-256:

./img_make.sh 220 "Test_my_version" ../256/i256-splash-7.7 MAG256 ./img_make.profile.mag256

Для работы с ключами и создания цифровой подписи образов используется программа gpg - GnuPG.org GnuPG Wikipedia

Для переноса ключа, например, с одной машины на другую можно воспользоваться следующими командами:

• для сохранения информации о ключе в файле

gpg -o opsecbin.KEY --export-secret-keys ID-ключа

• для добавления этого ключа в gpg

gpg --import opsecbin.KEY

• для просмотра текущих доступных ключей.

gpg --list-keys

PublicImage - подготовка, сборка - пример для MAG-250

CustomImage - подготовка, сборка - пример для MAG-250

Инструкция по сборке и установке образа «OperatorImage» предоставляется после согласования процедуры подписи ключа оператора с коммерческим отделом