Amlogic

Search…
Amlogic
Current LibreELEC 10.0+ images for Amlogic using modern Linux kernels use different boot processes and device-tree files that are not compatible with older LibreELEC images that use Amlogic Linux 3.14 or 4.9 kernels. The change to boot processes means you cannot update from older releases and must make a new/clean installation.
There are two images supporting Amlogic Gen10+ (64-bit) SoCs and older Gen8 (32-bit) SoCs used in a range of Linux SBC and Android STB devices:
AMLGX supports the following 64-bit SoCs:
GXBB (S905)
GXL (S805X/S905X/D/W/L)
GXM (S912)
G12A (S905X2/D2/Y2)
G12B (S922X/A311D)
SM1 (S905X3/D3)
AMLMX supports the following 32-bit SoCs:
Meson 8 (S805)
Meson 8b (S802)
Meson 8m2 (S812)
There is low support for Meson 6 (8726MX) hardware in the upstream kernel and not much chance of support evolving to a point where modern-kernel LibreELEC images are viable.
AMLGX and AMLMX provide a "box" image for use with devices that run Amlogic (aka Vendor or Legacy) boot firmware (U-Boot 2015.01 with Amlogic and manufacturer customisations) and "board" images using modern boot firmware (mainline U-Boot) specific to a single SBC board or STB device. The image type can be identified by the filename -suffix:
LibreELEC-AMLGX.arm-10.0.0-box.img.gz is the AMLGX "box" image
LibreELEC-AMLGX-arm-10.0.0-khadas-vim3.img.gz is a "board" image for Khadas VIM3
Box Images
Box images support SBC and STB devices with Android or "vendor" boot firmware running on the internal eMMC storage. LibreELEC is installed  by triggering "recovery" mode boot in the Amlogic U-Boot firmware. Recovery mode searches for some standard files on SD and USB media. LibreELEC provides files tweaked to boot and run LibreELEC instead of recovering the device. Once recovery mode is activated the device will seach (and find LibreELEC) on each boot; until Android recovery completes (it never does).
As box images can be used on many devices you must configure the device-tree file to use first. This is done by editing uEnv.ini in the root folder of the SD card. Change @@[email protected]@ to the name of the .dtb file to use. Current supported device-tree files are in the dtb folder.
For example, here is the default uEnv.ini file:
1
dtb_name=/dtb/@@[email protected]@
2
bootargs=boot=UUID=2306-0801 disk=UUID=8268da37-3a8d-4f6d-aba0-08918faded56 quiet systemd.debug_shell=ttyAML0 console=ttyAML0,115200n8 console=tty0
Copied!
To boot a Beelink GT-King box change @@DTB_NAME to meson-g12b-gtking.dtb
1
dtb_name=/dtb/meson-g12b-gtking.dtb
2
bootargs=boot=UUID=2306-0801 disk=UUID=8268da37-3a8d-4f6d-aba0-08918faded56 quiet systemd.debug_shell=ttyAML0 console=ttyAML0,115200n8 console=tty0
Copied!
Once the device-tree name is set you can insert the SD card in the box and power on. Some box devices will detect the presence of the SD card automatically. Others need you to trigger recovery mode using a reset button on the device. Common locations for the button are:
Visible button marked "reset" or "recovery" or "power" button
Visible pin-hole on the underside of the case
Hidden button visible through ventilation holes in the case
Hidden at the end of the 3.5mm audio jack
In most cases you will need a small pin, unfolded paper-clip, or wooden toothpick to press the reset button with - hence the install process is often referred to as the "toothpick method" in forum posts. Press and hold the button, then power-on the box. After 5-7 seconds release the button to interrupt boot and start the recovery process. Due to differences in box speeds and vendor u-boot customisations the exact timing for button release varies and you will need to experiment to find the timing that works for your board. It is possible to see U-Boot output and remove the guesswork by attaching a UART serial cable to the board, although most STB box devices will need connector pins soldering to the board as most manufacturers omit them to save some pennies.
Board Images
These images are built for Single Board Computer (SBC) devices which boot modern u-boot via an SD card or removable eMMC module. Installation is normally simple requiring you to write the image to the SD card or eMMC module then boot the device. If the board has eMMC storage soldered (not on a removable module) it may be necessary to boot from the "box" image first. Once booted to a box image on SD card (so eMMC is not in use) you can write the correct board image to eMMC (overwriting Android or other factory-installed images).
install2internal
Community images using the legacy Amlogic kernels often include the install2internal script to reconfigure the factory boot process and run LibreELEC from the internal eMMC storage. In the past when most box devices had 1GB RAM and SD cards were slow the performance difference between an SD card and "internal" storage was substantial, so the script evolved a cult following and many users belive they must install to internal eMMC or their box will be unusuable. This is wrong advice. On modern boxes with faster CPUs, 2GB+ RAM and better SD card support, the performance difference is often marginal.
The main reason we do not provide or support emmc installs on "box" devices is the high level of support issues. Software and hardware quality in Android STB hardware is not great, and this complicates the process of successfully installing to the internal eMMC storage so many installs have problems resulting in a "bricked" box. Amlogic builds factory-restore mechanisms into their software that mean it is always  possible to recover the box, but this usually depends on finding an Android image for the device, and the process is challenging for less technical users. Our forum staff are all volunteers who give time to the project for fun. Helping a never-ending stream of pissed-off inexperienced users recover bricked boxes is not fun, so we actively discourage the existence and use of this script.
If you want to run LibreELEC from eMMC storage please purchase a "board" device that supports it. If you find and run an install2internal script and something messes up; your problem is not our problem!
emmctool
In the AMLGX image there is an eMMC helper script called emmctool that supports a range of useful functions for backup/write/erase (and more) for eMMC storage. See:
1
LibreELEC:~ # emmctool 
2
​
3
info: boot device is /dev/mmcblk0, U-boot version is 2021.04
4
info: emmc device is /dev/mmcblk1
5
​
6
Model: MMC 8WPD3R (sd/mmc)
7
Disk /dev/mmcblk1: 7818MB
8
Sector size (logical/physical): 512B/512B
9
Partition Table: gpt
10
Disk Flags: 
11
​
12
Number  Start   End     Size    File system  Name          Flags
13
 1      17.4kB  7818MB  7818MB  ext4         EMMC_STORAGE
14
​
15
usage: emmctool (w)rite <filename>   : write <filename>.img/.img.gz to the eMMC module
16
                (b)backup <filename> : dump the emmc partition to an .img.gz file
17
                (d)etect             : detect an eMMC module attached after boot
18
                (i)nfo               : show info about the eMMC module
19
                (l)abels             : change eMMC disk labels to /
20
                (r)esize             : resize the storage partition to 100%
21
                (s)storage           : convert emmc for use as /storage (boot from sdcard)
22
                (u)boot <filename>   : write signed u-boot <filename> to the eMMC module
23
                (z)ero               : zero (erase/wipe) the eMMC module
24
                (h)elp               : displays this help message
Copied!
The emmctool helper supports a limited range of SBC boards with eMMC modules. On a generic Android device it will output the (i) info only.
Hardware - Previous
Allwinner
Next - Hardware
NXP - iMX6/iMX8
Last modified 1mo ago
Export as PDF
Copy link
Contents