PortADeviceToLinux¶

Introduction¶

It's relatively simple to add very basic support for devices (like a tablets or smartphones) in Linux.

This article will give some tips on how to do that, as there are some knowledge specific to Android smartphones and tablets that are worth mentioning.

Keeping the device in a good state¶

First, you probably don't want to break your device while doing that kind of work, especially if you have only one.

• Make sure you have a working USB cable and that you know how to recover your device. If you are not able to recover your device for some reason(for instance if the data part of the cable doesn't work), it might still be possible to do it (someone managed to do that for a Galaxy Note 2) but it could be way more time consuming and risky.
• It might be a good idea to keep a working recovery in the recovery partition: if something goes wrong, you could more easily recover the device. Having the recovery in the recovery partition and not in the boot/kernel partition is also a good idea as if something goes wrong you can make it boot to the recovery, whereas you have no button combinations to force a boot on the boot/kernel partition: when something goes wrong, it might try to boot on the recovery partition even if you press only the power button.
• Make sure that the battery is charged before trying to boot the kernel you are working on: On some devices, you need to write or configure the charging driver to make the device charge. When the battery is discharged it will probably try to boot to charge it more, but if it boots on your kernel that doesn't enable charging, you could be stuck in some reboot loop.

Bootloader issues¶

Upstream Linux is incompatible with several bootloaders found on smartphones and tablets.

See BootloadersIncompatibleWithLinux and the table in BootloaderInterfaces for list of devices bootloaders that are known to be incompatible with Linux and for workarounds.

If you're unsure you could still do the workarounds to make sure your device is not stuck very early in the boot.

In addition, if you need to pass certain arguments to the kernel, you could hardcode them in the kenrel itself with configuration like CONFIG_CMDLINE and CONFIG_CMDLINE_FORCE to make sure that they are really passed to the kernel, as bootloaders often ignore this or that way to pass the kenrel command line to the kenrel. The BootloaderInterfaces also has some information on that.

Validating that your code runs¶

• UART: see UART for more details.
• Simple FB: You can probably get the address of the framebuffer from the kernel command line arguments (in /proc/cmdline). Note that within the same model (GT-P3100), the address might differ from device to device. TODO: ask mighty17 for how to do it.
• RAM console? (TODO: see if it's available upstream)