From 12e42c192f76e6bbc0062c9530d66f8f2f7f2f5d Mon Sep 17 00:00:00 2001 From: Oliver Smith Date: Wed, 4 Mar 2026 17:59:29 +0100 Subject: [PATCH] docs/generic-device-packages: new page 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 Part-of: --- docs/generic-device-packages.md | 16 ++++++++++++++++ docs/index.md | 1 + 2 files changed, 17 insertions(+) create mode 100644 docs/generic-device-packages.md diff --git a/docs/generic-device-packages.md b/docs/generic-device-packages.md new file mode 100644 index 000000000..e9cc87883 --- /dev/null +++ b/docs/generic-device-packages.md @@ -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. diff --git a/docs/index.md b/docs/index.md index 48025475f..9204c7703 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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