mirror of
https://invent.kde.org/marcoa/shift-shell.git
synced 2026-04-26 14:23:09 +00:00
afa2f06b47
Attempt to use `/sys/firmware/devicetree/base/compatible` to autodetect the device id for device profiles. This approach is described here: https://phosh.mobi/posts/notch-support/#the-compatibles-string
44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
<!--
|
|
- SPDX-FileCopyrightText: None
|
|
- SPDX-License-Identifier: CC0-1.0
|
|
-->
|
|
|
|
This folder is where device-specific information is set.
|
|
|
|
### Usage as a distro
|
|
|
|
As a distribution, you can ship the device preset with the image by installing a file if the device id isn't autodetected.
|
|
|
|
In `/etc/xdg/plasmamobilerc`, write:
|
|
|
|
```toml
|
|
[Device]
|
|
device=oneplus,enchilada # replace with the device id
|
|
```
|
|
|
|
This should be a file name that exists in `/usr/share/plasma-mobile-device-presets` (which are the files in the `configs` folder).
|
|
|
|
### Auto-detecting device names
|
|
|
|
Envmanager reads `/sys/firmware/devicetree/base/compatible` to try to autodetect the device id.
|
|
|
|
Use this command to determine your device's id:
|
|
|
|
```
|
|
$ sed -z 's/$/\n/' /sys/firmware/devicetree/base/compatible
|
|
oneplus,enchilada
|
|
qcom,sdm845
|
|
```
|
|
|
|
### Adding a new device config
|
|
|
|
See [spec.conf](spec.conf) for more details on the specification. If a setting is omitted in the file, then the system will use the default value.
|
|
|
|
Add a new config in [configs](configs) with the device id.
|
|
|
|
In order to test your changes, install the file to `/usr/share/plasma-mobile-device-presets/your-device-id.conf`. Then run envmanager to apply the changes to the running system:
|
|
|
|
```
|
|
$ plasma-mobile-envmanager --apply-settings
|
|
$ plasmashell -p org.kde.plasma.mobileshell --replace
|
|
```
|