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:
- SD
- USB
- 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!
History:
- 20190912 (c7e55bf)
Introduce new ceemmc tool. - 20191113 (574211d)
Add Android device tree overlay namedto
- 20200127 (c3d23cf)
Add new option ‘copy from eMMC to external media’ - 20200227 (adde358)
Option ‘copy from eMMC to external media’:
when searching for ext media search exact string ‘mmcblk1’ - 20200707 (9c7ec947)
Added Minix and Beelink as official supported devices
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!
- Android is still bootable and can be entered by the CoreELEC shut down menu item:
-
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 options are different when CoreELEC got booted from SD card/USB flash drive or eMMC.
Current official supported devices by Team CoreELEC:
Khadas VIM3
Khadas VIM3L
Minix
Beelink
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!-
Booted from SD card or USB flash drive
1.) Use option 6 to create a backup of the internal CoreELEC dual mode installation.
2.) When the backup is finished use option 7 to remove the current CoreELEC dual mode installation on internal eMMC.
3.) Now the device is ready to be upgraded by an Android image or a Android OTA update.
4.) 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.
5.) 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. -
Booted from current CoreELEC installation on eMMC
1.) Use option 1 to make a copy of the internal CoreELEC installation to an insert SD card or USB flash drive.
2.) When the copy is finished reboot the device to boot CoreELEC from SD card or USB flash drive and continue with step 2.) on method Booted from SD card or USB flash drive.
-
-
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. -
Booted from SD card or USB flash drive
1.) Use option 3 to create a backup of the internal CoreELEC single mode installation.
2.) Now the device is ready to be recovered by an Android image.
3.) 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. -
Booted from current CoreELEC installation on eMMC
1.) Use option 1 to make a copy of the internal CoreELEC installation to an insert SD card or USB flash drive.
2.) When the copy is finished reboot the device to boot CoreELEC from SD card or USB flash drive and continue with step 2.) on method Booted from SD card or USB flash drive.
How to use the ceemmc tool:
Usage of the tool:
CoreELEC:~ # ceemmc -h
Starting CoreELEC eMMC installation tool...
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...
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
Hint: These options are available if device got booted with a CoreELEC installation on internal eMMC:
[Existing CoreELEC installation on eMMC]
[1] Make a copy of current CoreELEC installation on eMMC to current used SD or USB device
Make a copy 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 Copy:
This option can be used to create a bootable copy of the current CoreELEC installation on the internal eMMC to an insert SD card or USB flash drive. All user data on chosen partition to copy will be overwritten on target SD Card or USB flash drive. The current used CoreELEC partition layout will be created on target if not existing. This will require to format the SD card or USB flash drive before copy!
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!
For your own safety be sure you have a working ROM image for your device and you know how to recover the device by Burncardmaker and/or USB burning tool. It’s recomended to install CoreELEC in dual boot mode on not supported hardware as it’s easier to recover the device.
Be warned: the tool maybe brick your device!
CoreELEC:~ # ceemmc -x
Starting CoreELEC eMMC installation tool...
System is not supported: sm1_s905x3_2g!
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 в режиме двойной или одиночной загрузки.
Приоритет загрузочных устройств:
- SD
- USB
- 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:
-
Установка в режиме одиночной загрузки:
- Android удален и только CoreELEC может быть загружен из внутренней eMMC.
- Если CoreELEC установлен в режиме одиночной загрузки, то его нельзя удалить, как в режиме двойной загрузки! Устройство должно быть восстановлено с помощью образа Android от производителя с помощью Amlogic Burncardmaker или программы USB burning tool.
- Этот тип установки позволит использовать максимальный объем памяти внутренней eMMC. Только ~ 64MB потеряется из-за загрузчика.
Загрузчик производителя остается нетронутым для обоих режимов установки!
Что для этого нужно:
Запуск CoreELEC Amlogic-ng с SD-карты или USB-накопителя и устройства Amlogic под управлением Android в качестве основной системы. Параметры утилиты ceemmc разные когда CoreELEC загружен с SD-карты и USB-накопителя или с eMMC.
Текущие официальные устройства, поддерживаемые командой CoreELEC:
Khadas VIM3
Khadas VIM3L
Minix
Beelink
Восстановление/обновление Android:
При восстановлении Android с помощью Amlogic Burncardmaker или программы USB burning tool установленная на внутреннюю eMMC система CoreELEC полностью теряется! Поэтому, пожалуйста, подумайте о создании резервной копии прежде чем восстанавливать свое устройство!
-
Установка в режиме двойной загрузки:
Если необходимо обновить систему Android, например, с помощью обновления Over-the-Air (OTA), то необходимо удалить текущую установку CoreELEC с внутренней eMMC до начала обновления! В противном случае обновление OTA не удастся! Возможны 2 варианта:1.) Загрузившись с SD-карты или USB-накопителя
- Используйте параметр 6, чтобы создать резервную копию системы CoreELEC, установленной на внутреннюю eMMC в режиме двойной загрузки.
- После завершения резервного копирования используйте параметр 7, чтобы удалить установленную в режиме двойной загрузки систему CoreELEC с внутренней eMMC.
- Теперь устройство готово к обновлению с помощью образа Android или OTA-обновления Android.
- После восстановления/обновления Android среда загрузчика устройства будет сброшена до значения по умолчанию и CoreELEC больше не будет запускаться с внутренней eMMC, SD-карты или USB-накопителя. Загрузитесь один раз с SD-карты или флэш-накопителя USB с CoreELEC на нем обычным способом, таким как нажатие и удержание кнопки reset при включении питания устройства.
- После одной успешной загрузки CoreELEC с внешнего носителя, созданная ранее резервная копия может быть использована для повторной установки CoreELEC в режиме двойной загрузки на внутреннюю eMMC с помощью параметра 2 при наличии резервной копии или параметра 1 для установки системы CoreELEC с текущей SD-карты или USB-накопителя.
2.) Загрузившись в CoreELEC, установленный во внутреннюю eMMC
- Используйте параметр 1 чтобы сделать копию CoreELEC, установленный во внутреннюю eMMC на SD-карту или USB-накопитель.
- После завершения копирования перезагрузите систему, чтобы загрузится с накопителя, на который была произведена копия. Далее продолжаем по инструкции “Загрузившись с SD-карты или USB-накопителя”, пропуская первый пункт создания резервной копии(начиная с пункта удаления CoreELEC c внутренней eMMC).
-
Установка в режиме одиночной загрузки:
В режиме одиночной загрузки возможно только восстановление Android, так как ранее Android был удален с помощью ceemmc из внутренней eMMC.1.) Загрузившись с SD-карты или USB-накопителя
- Используйте параметр 3 чтобы создать резервную копию системы CoreELEC в режиме одиночной загрузки.
- Теперь устройство готово к восстановлению с помощью образа Android.
- После завершения восстановления Android, созданная ранее резервная копия может быть использована для повторной установки CoreELEC в режиме одиночной загрузки на внутреннюю eMMC с помощью параметра 4.
2.) Загрузившись в CoreELEC, установленный во внутреннюю eMMC
- Используйте параметр 1 чтобы сделать копию CoreELEC, установленный во внутреннюю eMMC на SD-карту или USB-накопитель.
- По завершению копирования устройство готово к восстановлению с помощью образа Android.
- После завершения восстановления Android, созданная ранее копия на SD-карту или USB-накопитель может быть использована для повторной установки CoreELEC в режиме одиночной загрузки на внутреннюю eMMC с помощью параметра 3.
Как использовать утилиту ceemmc:
Использование утилиты:
CoreELEC:~ # ceemmc -h
Starting CoreELEC eMMC installation tool...
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...
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 :
[Existing CoreELEC installation on eMMC]
[1] Make a copy of current CoreELEC installation on eMMC to current used SD or USB device
Make a copy 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 на SD-карту или USB-накопитель. Все пользовательские данные на выбранной для копирования SD-карте или USB-накопителе будут перезаписаны. Разделы CoreELEC будут созданы на SD-карте или USB-накопителе, если они там еще не существуют. Для этого потребуется отформатировать SD-карту или USB-накопитель перед копированием!
Опция резервного копирования:
Этот опция может быть использована для создания резервной копии текущей установки 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...
System is not supported: sm1_s905x3_2g!
There is NO official support by Team CoreELEC
if you continue to run this tool!
Continue? [y]: