Обновление Omega

Чтобы улучшить работу Omega, мы будем выпускать обновленные прошивки на постоянной основе. Чтобы получить преимущества этих улучшений, пользователи должны своевременно обновлять свои Omega до последней версии прошивки. Для перехода с одной прошивки на другую создана утилита командной строки oupgrade (Onion Upgrade).

Команда oupgrade не будет работать должным образом, если вы запустите ее из приложения Terminal в консоли. Используйте oupgrade при подключении к Omega через SSH или Serial. При обновлении с помощью консоли используйте «Настройки» (Settings).

Как узнать, нужно ли обновлять Omega?

Предупреждение. Когда выполняется обновление, сохраняются только папки /root и /etc. Важно сделать резервную копию файлов на Omega до обновления, если вы не хотите потерять данные.

Чтобы проверить, нуждается ли Omega в обновлении, запустите oupgrade -check. В результате вы узнаете требуется ли обновление:

root@Omega-2757:/# oupgrade -c

> Device Firmware Version: 0.1.4 b210 (текущая версия прошивки)

> Checking latest version online...        (проверка последней версии прошивки) 

> Repo Firmware Version: 0.1.5 b132 (последняя версия прошивки)

> Comparing version numbers           (сравнение версий прошивки)

> New firmware version available, need to upgrade device firmware (Необходимо обновить прошивку)

Самый простой способ - запустить oupgrade. В результате проверяется, нуждается ли ваша прошивка в обновлении и, при необходимости, обновится.

Версия и номер сборки

У каждой прошивки есть версия и номер сборки.

• Небольшие обновления будут выпущены в новой сборке для данной версии прошивки.
  • Например: version 0.1.4 build 100, build 103, build 110 (версия 0.1.4, сборки 100, 103 и 110)
• Большое обновление будет выпущено как новая версия прошивки.
  • Например: version 0.1.3, version 0.1.5, version 0.1.6 (версии 0.1.3, 0.1.5, 0.1.6)

Выполнение обновления

Введите в командной строке: oupgrade

Начнется проверка доступных обновлений прошивки и их последующая установка.

По умолчанию oupgrade будет устанавливать только новые версии прошивки.

Получение версии прошивки

Чтобы узнать текущую прошивку на устройстве наберите: oupgrade -v

И вы увидите:

root@Omega-2757:/# oupgrade -v

> Device Firmware Version: 0.1.5 b132

В этом примере версия прошивки 0.1.5, номер сборки 132.

Проверка новой версии прошивки

Чтобы проверить версию прошивки и сравнить ее с последней доступной версией прошивки, введите:

oupgrade -c

root@Omega-2757:/# oupgrade -c

> Device Firmware Version: 0.1.5 b132 (текущая версия прошивки)

> Checking latest version online... (проверка последней версии прошивки)

> Repo Firmware Version: 0.1.5 b132 (последняя версия прошивки)

> Comparing version numbers (последняя версия прошивки)

> Device firmware is up to date!

В данном примере прошивка не нуждается в обновлении.

Если прошивка последняя, но существует более новая сборка, запуск oupgrade -c выдаст:

root@Omega-2757:/# oupgrade -c

> Device Firmware Version: 0.1.5 b131

> Checking latest version online...

> Repo Firmware Version: 0.1.5 b132

> Comparing version numbers

> New build of current firmware available, upgrade is optional, rerun with ’-force’ option to upgrade

(Новая сборка доступна, обновление опционально, перезапустите с ’-force’ для запуска обновления)

Если у вас не актуальная версия прошивки:

root@Omega-2757:/# oupgrade -c

> Device Firmware Version: 0.1.4 b210

> Checking latest version online...

> Repo Firmware Version: 0.1.5 b132

> Comparing version numbers

> New firmware version available, need to upgrade device firmware

(Доступна новая версия прошивки, необходимо обновить прошивку устройства)

Эта команда проверяет только версию прошивки и не будет изменять ваше устройство.

Обновление до последней версии

Onion постоянно развивается, добавляются новые функции и исправляются ошибки. Однако иногда новые функции могут привести к нестабильности прошивки. oupgrade обновляет прошивку до последней стабильной версии, пропуская нестабильные.

Если вам в любом случае нужно обновиться до последней версии (даже если она нестабильная), вы можете вызвать команду:

oupgrade -l

ПРЕДУПРЕЖДЕНИЕ! Не рекомендуется. Onion не несет ответственности за проблемы или повреждения вашего устройства, вызванные использованием нестабильной версии прошивки.

Omega не обновляется, если последняя версия прошивки уже установлена.

Принудительное обновление

Вы можете обновить Omega до последней версии прошивки принудительно, используя флаг -f. Примечание: это приведет к переустановке прошивки, даже если Omega уже имеет новейшую версию!

oupgrade -f

Omega перепрошьется. Как правило, эта команда используется, если вам необходимо безопасно выполнить сброс в рабочее состояние последней прошивки.

ВАЖНО: см. предупреждение ниже о том, какие файлы будут сохранены и стерты при обновлении прошивки.

Помощь с oupgrade

oupgrade имеет много функций в командной строке. Вызовите команду oupgrade -h, чтобы узнать о вариантах использования oupgrade.

root@Omega-2757:/# oupgrade -h

Functionality: (функциональные возможности)

  Check if new Onion firmware is available and perform upgrade (Проверка доступна ли новая прошивка Onion и выполнение обновления)

Usage: /usr/bin/oupgrade (Использование: )

Arguments: (Аргументы: )

 -h, --help        вывести все возможные варианты использования команды

 -v, --version   вывести текущую версию прошивки

 -l, --latest      использовать последнюю версию прошивки из репозитория (вместо последней стабильной)

 -f, --force       принудительно обновить, независимо от актуальности установленной версии

 -c, --check       сравнить версии без обновления

 -u, --ubus        скрипт выводит только json