Amlogic TV boxes

Revision as of 12:38, 22 June 2021 by Danboid (talk | contribs) (Add 'Reflashing with flash-tool.sh' section)


Amlogic TV boxes

General disclaimer and warning

It is possible to install and run Manjaro on several affordable Android TV boxes using Amlogic chipsets such as the S905, S922 and A311 series of processors. These TV boxes can be purchased for a fraction of the price of a similar spec single board computer whilst coming complete with a case, remote and cables but there are a few catches to be aware of.

The Android TV box market is awash with fakes and clones. It has been known for manufacturers to re-use the exact same model name yet use an entirely different chipset. For example, there are at least six versions of the X96 Air but they all have exactly the same case. The TV box manufacturers rarely if ever provide updates for their Android-based OS's and they provide zero support for users wanting to run alternate operating systems so achieving full support for every box is almost impossible.

Physical build quality is another frequent issue with TV boxes, in particular poor thermal designs are quite common. You may have to cut a hole or two in the case and place a USB powered fan over the SoC to perform CPU intensive tasks without throttling or overheating.


Identifying your box

Under Android, go to Settings -> System -> About phone

The device name given under About phone is often the best one to use to identify your box but you can also run:

user $ cat /proc/device-tree/amlogic-dt-id COPY TO CLIPBOARD


Under an Android terminal to show your boxes device tree ID.


Installation

Manjaro can be installed from and to micro SD card or USB disk. It is not currently possible to install Manjaro to eMMC on Amlogic TV boxes.

Configure extlinux.conf

After using a disk imaging tool such as dd to write one of the vim3 Manjaro ARM images to a disk, mount the disk and edit BOOT_MNJRO/extlinux/extlinux.conf. You must edit the line that begins with FDT /dtbs/amlogic/ to point to the dtb file that you wish to use to configure your device tree.

If there isn't a matching dtb file for your box within the dtbs folder and you can't find a suitable dtb on this wiki or in the Manjaro forums then you should try meson-sm1-sei610.dtb first:

FDT /dtbs/amlogic/meson-sm1-sei610.dtb

Booting from USB

If you are booting Manjaro from a USB disk or via a USB SATA adapter/enclosure, there is a good chance that you will be required to add a usb-storage.quirks kernel parameter to the APPEND statement in extlinux.conf like so:

APPEND root=PARTUUID=5418e4d8-02 rootflags=data=writeback rw console=ttyAML0,115200n8 console=tty0 no_console_suspend consoleblank=0 fsck.fix=yes fsck.repair=yes net.ifnames=0 quiet splash plymouth.ignore-serial-consoles usb-storage.quirks=152d:1561:u

You must replace 152d:1561 with the correct USB vendor and product IDs for your USB device. You can find these identifiers by running lsusb when you have your disk or adapter connected to a Linux box. It is recommended you boot from USB without setting the USB storage quirks parameter where possible.


Enable multiboot mode

If this is your first time attempting to boot from an SD card or USB disk, you must enable multiboot mode. Insert your Manjaro micro SD card or attach the Manjaro USB disk then hold down the button in the AV port by inserting a paper clip, a pin or something similar and keep it depressed while powering the device on. Keep the button pressed until you see the boot screen of your box. After a few seconds it should reboot off your SD card or USB disk. You are only required to do this once unless you reflash your eMMC.


Reflashing Android with flash-tool.sh

In emergency situations, like when Manjaro stops booting due to your bootloader having been modified or corrupted, you may need to reflash the Android OS on your TV box eMMC. If you have got a suitable installation image for your box, they are usually a couple of gigabytes in size, and you have a USB A to A cable then you can perform the following steps to reflash your TV box under Linux.

Installing aml-flash-tool

Clone the aml-flash-tool repo:

user $ git clone https://github.com/osmc/aml-flash-tool.git COPY TO CLIPBOARD


Copy aml_image_v2_packer and the amlogic update program into your path:

user $ cp ./aml-flash-tool/tools/linux-x86/* ~/.local/bin COPY TO CLIPBOARD


You are now prepared to run flash-tool.sh

Reflashing with flash-tool.sh

Disconnect the power from your TV box and plug a USB A to USB A cable into your TV box. It varies which port to use but usually only one port will work for reflashing. Now insert a pin or similar into the AV hole, depress the button and keep it pressed as you connect the USB A to A cable to your other machine. You will know when your TV box is ready to be flashed with flash-tool.sh because you will see an Amlogic device listed when you run lsusb.

When you can see your TV box is connected, you can flash it using a command such as:

user $ ./flash-tool.sh --img=X96AIR_Q1000_20210127-2121.img --parts=all --wipe --soc=g12a COPY TO CLIPBOARD


Replacing X96AIR_Q1000_20210127-2121.img with the path to the image you wish to flash. You do not need to run flash-tool.sh as root.