Piecuu/pmaports
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs/generic-device-packages: new page

Browse source 
Start the documentation for generic device packages and document how to
handle device-specific services. This is a question that came up in the
review of PMCR-0009 (new main device category).

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8122>
This commit is contained in:
Oliver Smith 2026-03-04 17:59:29 +01:00 • committed by The Friendly Meow (merge) Bot
parent 31a4d7ae92
commit 12e42c192f
No known key found for this signature in database
2 changed files with 17 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/generic-device-packages.md Normal file
View file

@ -0,0 +1,16 @@
# Generic Device Packages
This article is about device packages starting with `device-generic-`. These
can boot on multiple devices of that architecture. `device-generic-x86_64`
could for example be booted on most PCs and laptops with that architecture.
## Device-specific services
Pre-installing device specific software is allowed if it is needed to enable
device functionality, but it must only start on relevant devices and not
break other devices.
One example is the
[hexagonrpcd](https://github.com/linux-msm/hexagonrpc) daemon for serving
HexagonFS files to the DSPs on Qualcomm devices, which we only run if e.g.
`/dev/fastrpc-adsp` is available.

1
docs/index.md
View file

@ -17,6 +17,7 @@ in pmaports and the processes around device categorization.
device-categorization
deviceinfo-reference
ci-tags
generic-device-packages
generic-kernels
kconfigcheck
kernel-cmdline