How to use the Team CoreELEC ceemmc tool

RU

Team CoreELEC ceemmc tool


This tool is written by Team CoreELEC and exclusive for Amlogic devices running CoreELEC!

This tool ceemmc can be used for a safe installation of CoreELEC to internal eMMC storage.
Users have the choice to install CoreELEC on their eMMC in dual or single boot mode.

The boot device priority is:

  1. SD
  2. USB
  3. eMMC

If the system fails on booting from the internal eMMC then the device can still be booted by inserting an SD card or USB flash drive with CoreELEC.

Please read this HowTo carefully and completely before using this tool!

It’s worth nothing that you can totally recover a bricked device by using Burncardmaker or USB burning tool in case the installation fails!

Installation modes:
ceemmc can install CoreELEC on internal eMMC in two different modes:

  • Dual boot mode installation:

    • Android is still bootable and can be entered by the CoreELEC shut down menu item:
      • Reboot from eMMC/NAND
    • If CoreELEC is installed in dual boot mode it can be removed from the internal eMMC. On removal the device will get restored like it was prior to the CoreELEC installation.
    • The disadvantage is that not all memory of the internal eMMC can be used. Around 5GB of the internal memory is lost in this mode because of the Android partition layout. The amount of lost memory depends on vendor/device.

    Note: Please read the section Android recovery/upgrade carefully before you do an Android upgrade/update!

  • Single boot mode installation:

    • Android is removed and only CoreELEC can be booted from internal eMMC.
    • If CoreELEC is installed in single boot mode it can not be removed like in dual boot mode! The device would need to be recovered by a vendor Android image using Amlogic Burncardmaker or the USB burning tool.
    • This type of installation will allow the maximum amount of the memory of the internal eMMC to be used. Just ~64MB is lost because of the bootloader.

The vendor bootloader remain untouched for both installation modes!

What is needed:
Running CoreELEC Amlogic-ng from SD card or USB flash drive and an Amlogic device running Android as basic system. The tool ceemmc can only be started if CoreELEC got booted from SD card or USB flash drive.

Current official supported devices by Team CoreELEC:

Khadas VIM3
Khadas VIM3L

Android recovery/upgrade:
By recovery Android using Amlogic Burncardmaker or the USB burning tool the complete CoreELEC installation on internal eMMC is lost! So please think about creating a backup before recover your device!

  • Dual boot mode installation:
    If the Android system should be upgraded, like by a Over-the-Air (OTA) update, it is necessary to remove the current CoreELEC installation on internal eMMC before the upgrade get started! Otherwise the OTA upgrade will fail!

    • Use option 6 to create a backup of the internal CoreELEC dual mode installation.
    • When the backup is finished use option 7 to remove the current CoreELEC dual mode installation on internal eMMC.
    • Now the device is ready to be upgraded by an Android image or a Android OTA update.
    • After the Android upgrade/update the device bootloader environment got reset to default and CoreELEC will not start anymore from internal eMMC, SD card or USB flash drive. Boot once from a SD card or USB flash drive with CoreELEC on it by the common used method like pushing and holding the reset button when power on the device.
    • After one successful boot of CoreELEC on the external media the backup created before can be used to install CoreELEC dual mode again on internal eMMC by using option 2.
  • Single boot mode installation:
    In single boot mode only a recovery of Android is possible as Android got removed before by ceemmc from the internal eMMC.

    • Use option 3 to create a backup of the internal CoreELEC single mode installation.
    • Now the device is ready to be recovered by an Android image.
    • After the Android recovery is finished the backup created before can be used to install CoreELEC single mode again on internal eMMC by using option 4.

How to use the ceemmc tool:

Usage of the tool:

CoreELEC:~ # ceemmc -h

Starting CoreELEC eMMC installation tool v0.1...
Usage: ceemmc [options]

 This tool is written by Team CoreELEC, vpeter, Portisch

[options]
 -v             verbose output
 -h, --help     print this help

The tool do have a short and long help description. Use -h for the short and --help for the long description:

CoreELEC:~ # ceemmc --help

Starting CoreELEC eMMC installation tool v0.1...
Usage: ceemmc [options]

 This tool is written by Team CoreELEC, vpeter, Portisch

[options]
 -v             verbose output
 -h, --help     print this help

 Available functions:

Hint: These options are available if no CoreELEC installation is found on internal eMMC:

  [No CoreELEC installation on eMMC]

   Install in dual boot mode, CoreELEC and Android on eMMC
     Use CoreELEC data from
       [1] current used SD or USB device
           Install CoreELEC on eMMC without removing Android from the device.
           Dual boot of Android and CoreELEC is possible.
           Not all memory of the eMMC can be used because of Android.

       [2] existing backup on current used SD or USB device
           Install CoreELEC on eMMC without removing Android from the device.
           Dual boot of Android and CoreELEC is possible.
           Not all memory of the eMMC can be used because of Android.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.


   Install in single boot mode, only CoreELEC on eMMC
     Use CoreELEC data from
       [3] current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.

       [4] existing backup on current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.

Hint: These options are available if an existing CoreELEC dual mode installation is found on internal eMMC:

  [Existing CoreELEC dual boot installation on eMMC]

   Migrate CoreELEC dual boot to single boot installation
     Use CoreELEC data from
       [1] current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [2] the existing data on eMMC
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           The existing CoreELEC data on eMMC will be used for installation.

       [3] existing backup on current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.


   Renew current CoreELEC dual boot installation on eMMC
     Use CoreELEC data from
       [4] current used SD or USB device
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [5] existing backup on current used SD or USB device
           All existing CoreELEC data on eMMC will be removed and
           the new data from an existing backup from current
           used SD or USB device will be copied to eMMC.


   [6] Make a backup of current CoreELEC dual boot installation on eMMC to current used SD or USB device
       Make a backup of all CoreELEC data on flash and/or storage
       partition on eMMC to the current used SD or USB device

   [7] Remove current CoreELEC dual boot installation on eMMC
       All existing CoreELEC data on eMMC and the existing
       CoreELEC dual boot installation on eMMC will be removed.

Hint: These options are available if an existing CoreELEC single mode installation is found on internal eMMC:

  [Existing CoreELEC single boot installation on eMMC]

   Renew current CoreELEC single boot installation on eMMC
     Use CoreELEC data from
       [1] current used SD or USB device
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [2] existing backup on current used SD or USB device
           All existing CoreELEC data on eMMC will be removed and
           the new data from an existing backup from current
           used SD or USB device will be copied to eMMC.


   [3] Make a backup of current CoreELEC single boot installation on eMMC to current used SD or USB device
       Make a backup of all CoreELEC data on flash and/or storage
       partition on eMMC to the current used SD or USB device

Option Migrate:
This option can be used to migrate the current CoreELEC dual mode installation to a CoreELEC single mode installation on internal eMMC. Use this option if Android should be removed to get maximum of memory of the internal eMMC. There is no option to migrate a CoreELEC single mode installation to a CoreELEC dual mode installation as Android got removed before.

Option Renew:
This option can be used to renew the current CoreELEC installation on internal eMMC.
The tool ceemmc will request user input if data on internal eMMC /flash and/or /storage should be renewed. Please aware that all existing data on the renewed chosen partition will be lost!
This option can be used like if CoreELEC isn’t booting anymore from internal eMMC.
Do not use this option to update CoreELEC on internal eMMC as maybe user data get lost!

Option Backup:
This option can be used to create a backup of the current CoreELEC installation on the internal eMMC. The backup data will be saved at

  • If flash partition is chosen:

    /storage/backup/eMMC_backup/coreelec_flash
    
  • If storage partition is chosen:

    /storage/backup/eMMC_backup/coreelec_storage
    

on the current used CoreELEC boot device.
Any existing backup on the CoreELEC boot device get be replaced by the current backup when using this option. On migrate or renew by using the option backup this data backup will be used.

Unsupported devices:
With the parameter x the ceemmc tool can be used for not by Team CoreELEC official supported devices. Any support request for not official supported devices will be ignored.
This is because Team CoreELEC does not own every device on the market available and so we can not confirm the tool function with the unsupported device!

Be warned: the tool maybe brick your device!

CoreELEC:~ # ceemmc -x

Starting CoreELEC eMMC installation tool v0.1...

System is not supported: g12b_s922x_beelink_gt_king!

There is NO official support by Team CoreELEC
if you continue to run this tool!
Continue? [y]:

RU

Team CoreELEC ceemmc tool


Эта утилита написана командой CoreELEC и исключительно для Amlogic устройств работающих под управлением CoreELEC!

Эта утилита ceemmc может быть использована для безопасной установки CoreELEC во внутреннюю eMMC память.
Пользователи могут установить CoreELEC на eMMC в режиме двойной или одиночной загрузки.

Приоритет загрузочных устройств:

  1. SD
  2. USB
  3. eMMC

Если при загрузке системы из внутренней eMMC происходит сбой, то устройство все равно можно загрузить, вставив SD-карту или USB-накопитель с CoreELEC.

Пожалуйста, прочитайте эту инструкцию внимательно и полностью перед использованием этой утилиты!!

Следует отметить, что вы можете полностью восстановить окирпиченое устройство с помощью Burncardmaker или программы USB burning tool в случае сбоя установки!

Режимы установки:
С помощью ceemmc CoreELEC может быть установлен на внутреннюю eMMC в двух разных режимах:

  • Установка в режиме двойной загрузки:

    • Android по-прежнему загружается и может быть запущен из меню выключения CoreELEC:
      • Reboot from eMMC/NAND
    • Если CoreELEC установлен в режиме двойной загрузки, то его можно удалить из внутренней eMMC. При удалении устройство будет восстановлено, как это было до установки CoreELEC.
    • Недостатком является то, что не вся память внутренней eMMC может быть использована. В этом режиме из-за разметки раздела Android теряется около 5 ГБ внутренней памяти. Количество потерянной памяти зависит от производителя/устройства.

    Note: Пожалуйста, внимательно прочитайте раздел Восстановление/обновление Android перед тем как вы выполните обновление Android!

  • Установка в режиме одиночной загрузки:

    • Android удален и только CoreELEC может быть загружен из внутренней eMMC.
    • Если CoreELEC установлен в режиме одиночной загрузки, то его нельзя удалить, как в режиме двойной загрузки! Устройство должно быть восстановлено с помощью образа Android от производителя с помощью Amlogic Burncardmaker или программы USB burning tool.
    • Этот тип установки позволит использовать максимальный объем памяти внутренней eMMC. Только ~ 64MB потеряется из-за загрузчика.

Загрузчик производителя остается нетронутым для обоих режимов установки!

Что для этого нужно:
Запуск CoreELEC Amlogic-ng с SD-карты или USB-накопителя и устройства Amlogic под управлением Android в качестве основной системы. Утилиту ceemmc можно запустить только если CoreELEC загружен с SD-карты или USB-накопителя.

Текущие официальные устройства, поддерживаемые командой CoreELEC:

Khadas VIM3
Khadas VIM3L

Восстановление/обновление Android:
При восстановлении Android с помощью Amlogic Burncardmaker или программы USB burning tool установленная на внутреннюю eMMC система CoreELEC полностью теряется! Поэтому, пожалуйста, подумайте о создании резервной копии прежде чем восстанавливать свое устройство!

  • Установка в режиме двойной загрузки:
    Если необходимо обновить систему Android, например, с помощью обновления Over-the-Air (OTA), то необходимо удалить текущую установку CoreELEC с внутренней eMMC до начала обновления! В противном случае обновление OTA не удастся!

    • Используйте параметр 6, чтобы создать резервную копию системы CoreELEC, установленной на внутреннюю eMMC в режиме двойной загрузки.
    • После завершения резервного копирования используйте параметр 7, чтобы удалить установленную в режиме двойной загрузки систему CoreELEC с внутренней eMMC.
    • Теперь устройство готово к обновлению с помощью образа Android или OTA-обновления Android.
    • После восстановления/обновления Android среда загрузчика устройства будет сброшена до значения по умолчанию и CoreELEC больше не будет запускаться с внутренней eMMC, SD-карты или USB-накопителя. Загрузитесь один раз с SD-карты или флэш-накопителя USB с CoreELEC на нем обычным способом, таким как нажатие и удержание кнопки reset при включении питания устройства.
    • После одной успешной загрузки CoreELEC с внешнего носителя, созданная ранее резервная копия может быть использована для повторной установки CoreELEC в режиме двойной загрузки на внутреннюю eMMC с помощью параметра 2.
  • Установка в режиме одиночной загрузки:
    В режиме одиночной загрузки возможно только восстановление Android, так как ранее Android был удален с помощью ceemmc из внутренней eMMC.

    • Используйте параметр 3 чтобы создать резервную копию системы CoreELEC в режиме одиночной загрузки.
    • Теперь устройство готово к восстановлению с помощью образа Android.
    • После завершения восстановления Android, созданная ранее резервная копия может быть использована для повторной установки CoreELEC в режиме одиночной загрузки на внутреннюю eMMC с помощью параметра 4.

Как использовать утилиту ceemmc:

Использование утилиты:

CoreELEC:~ # ceemmc -h

Starting CoreELEC eMMC installation tool v0.1...
Usage: ceemmc [options]

 This tool is written by Team CoreELEC, vpeter, Portisch

[options]
 -v             verbose output
 -h, --help     print this help

У утилиты есть краткое и подробное описание опции помощи. Используйте -h для краткого и --help для подробного описания:

CoreELEC:~ # ceemmc --help

Starting CoreELEC eMMC installation tool v0.1...
Usage: ceemmc [options]

 This tool is written by Team CoreELEC, vpeter, Portisch

[options]
 -v             verbose output
 -h, --help     print this help

 Available functions:

Подсказка: эти опции доступны, если на внутренней eMMC не найдена система CoreELEC

  [No CoreELEC installation on eMMC]

   Install in dual boot mode, CoreELEC and Android on eMMC
     Use CoreELEC data from
       [1] current used SD or USB device
           Install CoreELEC on eMMC without removing Android from the device.
           Dual boot of Android and CoreELEC is possible.
           Not all memory of the eMMC can be used because of Android.

       [2] existing backup on current used SD or USB device
           Install CoreELEC on eMMC without removing Android from the device.
           Dual boot of Android and CoreELEC is possible.
           Not all memory of the eMMC can be used because of Android.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.


   Install in single boot mode, only CoreELEC on eMMC
     Use CoreELEC data from
       [3] current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.

       [4] existing backup on current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.

Подсказка: эти опции доступны, если во внутренней eMMC обнаружена существующая установка CoreELEC в режиме двойной загрузки:

  [Existing CoreELEC dual boot installation on eMMC]

   Migrate CoreELEC dual boot to single boot installation
     Use CoreELEC data from
       [1] current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [2] the existing data on eMMC
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           The existing CoreELEC data on eMMC will be used for installation.

       [3] existing backup on current used SD or USB device
           Install CoreELEC on eMMC and remove Android from the device.
           Only boot of CoreELEC is possible.
           The maximum of memory of the eMMC is used.
           An existing backup of the CoreELEC data on on current
           used SD or USB device will be used for installation.


   Renew current CoreELEC dual boot installation on eMMC
     Use CoreELEC data from
       [4] current used SD or USB device
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [5] existing backup on current used SD or USB device
           All existing CoreELEC data on eMMC will be removed and
           the new data from an existing backup from current
           used SD or USB device will be copied to eMMC.


   [6] Make a backup of current CoreELEC dual boot installation on eMMC to current used SD or USB device
       Make a backup of all CoreELEC data on flash and/or storage
       partition on eMMC to the current used SD or USB device

   [7] Remove current CoreELEC dual boot installation on eMMC
       All existing CoreELEC data on eMMC and the existing
       CoreELEC dual boot installation on eMMC will be removed.

Подсказка: эти опции доступны, если во внутренней eMMC обнаружена существующая установка CoreELEC в режиме одиночной загрузки:

  [Existing CoreELEC single boot installation on eMMC]

   Renew current CoreELEC single boot installation on eMMC
     Use CoreELEC data from
       [1] current used SD or USB device
           All existing CoreELEC data on eMMC will be removed
           and the new data from current used SD or USB device
           will be copied to eMMC.

       [2] existing backup on current used SD or USB device
           All existing CoreELEC data on eMMC will be removed and
           the new data from an existing backup from current
           used SD or USB device will be copied to eMMC.


   [3] Make a backup of current CoreELEC single boot installation on eMMC to current used SD or USB device
       Make a backup of all CoreELEC data on flash and/or storage
       partition on eMMC to the current used SD or USB device

Опция Миграция:
Этот опция может быть использована для преобразования текущей системы CoreELEC, установленной в режиме двойной загрузки, в режим одиночной загрузки на внутреннюю eMMC. Используйте эту опцию, если Android должен быть удален, чтобы получить максимум памяти внутренней eMMC. Обратной возможности преобразования системы CoreELEC, установленной в режиме одиночной загрузки, в режим двойной загрузки не существует, поскольку Android был удален ранее.

Опция обновления/восстановления:
Эта опция может быть использована для обновления/восстановления текущей установки CoreELEC на внутренней eMMC.
Утилита ceemmc запросит подтверждения пользователя о необходимости обновить данные на внутренней eMMC /flash и/или /storage. Обратите внимание, что все существующие данные в обновленном восстанавливаемом разделе будут потеряны!
Эту опцию можно использовать, например, если CoreELEC больше не загружается из внутренней eMMC.
Не используйте эту опцию для обновления CoreELEC на внутренней eMMC, так как, возможно, пользовательские данные будут потеряны!
Подсказка: Если требуется восстановить только /flash раздел, то при запросе восстановления раздела /storage выбираем N

Опция резервного копирования:
Этот опция может быть использована для создания резервной копии текущей установки CoreELEC на внутренней eMMC. Данные резервной копии будут сохранены в

  • Если выбран раздел flash:

    /storage/backup/eMMC_backup/coreelec_flash
    
  • Если выбран раздел storage:

    /storage/backup/eMMC_backup/coreelec_storage
    

на текущем используемом загрузочном устройстве CoreELEC.
Любая существующая резервная копия на загрузочном устройстве CoreELEC будет заменена текущей резервной копией при использовании этой опции. При переносе или обновлении с помощью опции резервного копирования будет использоваться эта резервная копия данных.

Установка на устройства, не входящие в список официальных:
С параметром x утилита ceemmc может использоваться на устройствах, не входящих в список официально поддерживаемых Team CoreELEC. Любой запрос поддержки для не официально поддерживаемых устройств может быть проигнорирован.
Это связано с тем, что у Team CoreELEC нету каждого доступного на рынке устройства, и поэтому мы не можем подтвердить работу утилиты с устройствами, не входящих в список официальных!

Будьте осторожны: инструмент может окирпичить ваше устройство!

CoreELEC:~ # ceemmc -x

Starting CoreELEC eMMC installation tool v0.1...

System is not supported: g12b_s922x_beelink_gt_king!

There is NO official support by Team CoreELEC
if you continue to run this tool!
Continue? [y]:
3 Likes