Porting a new device

The mobile interface supports devices running a mainline Linux kernel.

Many consumer mobile devices only support Android and don't work with the Linux kernel directly. Android provides a hardware abstraction layer on top of the kernel. Even if a device's kernel sources are open, the Android environment uses Bionic rather than glibc or musl and is specific to that layer, so its drivers can't be used directly in a general Linux environment.

Some projects support devices without mainline Linux, such as libhybris and Halium, which uses libhybris to provide a distribution-independent hardware abstraction. The upstream project dropped support for Halium in favor of mainline devices, and SonicDE doesn't support it either.

To port a device to mainline Linux, see Porting to a new device in the postmarketOS wiki.

Adding the device's settings

Once the device runs, it can have a preset with settings specific to its hardware, such as the sizes and padding of the panels. Presets are files in /usr/share/plasma-mobile-device-presets, installed from the devices/configs folder of sonic-mobile-interface. spec.conf in the devices folder describes the settings, and any setting left out keeps its default value.

The file is named after the device's ID. The environment manager, plasma-mobile-envmanager, works this out from the device tree, and you can see the values it looks at with:

tr '\0' '\n' < /sys/firmware/devicetree/base/compatible

For example, that prints oneplus,enchilada and qcom,sdm845 on a OnePlus 6.

If the ID isn't detected automatically, a distribution can set it in /etc/xdg/plasmamobilerc:

[Device]
device=oneplus,enchilada

To try a preset, install it and apply it to the running system:

plasma-mobile-envmanager --apply-settings
sonicshell -p org.kde.plasma.mobileshell --replace

Porting a new device

#Adding the device's settings

#See also

Adding the device's settings

See also