meta-qcom: add RTSS mailbox DLKM/UMD recipes (phase 1) by sargarram7 · Pull Request #3084 · qualcomm-linux/meta-qcom

sargarram7 · 2026-09-06T20:42:39Z

Target milestone: QLI-2.1

Background

Customer use cases driving this - CAN communication, RTSS-to-HLOS userspace communication, OTA updates, and on-device programming/flashing. all need working IPC path between the application processor and RTSS. That path doesn't exist upstream today. This is phase 1 of bringing the downstream, out-of-tree RTSS mailbox stack into the open-source tree to support these IPC use cases going forward.

Tracking issue:

#3085

This PR dependency

None

Related PRs

This is part of a set of PRs bringing the RTSS mailbox stack into the open-source tree:

Device-tree wiring for the mailbox node (qcom,rtss-mailbox):
- QCLINUX: arm64: dts: qcom: lemans and monaco: Rework RTSS Mailbox DT to use syscon and staging overlays kernel-topics#1768

RTSS interface enablement is handled using a staging DTBO overlay to carry the rtss mailbox node, both bootup and DTBO patching with it applied have been verified on target.

Testing

Default bootup verified on lemans and monaco targets with no regression.
After RTSS mailbox/staging DT overlay is applied, mailbox communication with RTSS and the CLI utilities were verified on both targets.

qcomlnxci · 2026-09-07T11:18:11Z

Test Coral run workflow

Test jobs for commit `723a98c`

qcomdistro: multimedia image-prop
Pass: 36 | Fail: 0 | Total: 36
qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9

Ricardo Salveti (ricardosalveti) · 2026-09-08T21:39:01Z

Check-layer is failing.

Ricardo Salveti (ricardosalveti) · 2026-09-09T16:15:13Z

Squash the changes, you don't need multiple patches fixing the same recipe here. And it is still failing.

qcomlnxci · 2026-09-09T19:30:41Z

Test Coral run workflow

Test jobs for commit `09b4afd`

qcomdistro: multimedia image
Pass: 7 | Fail: 0 | Total: 7
qcomdistro: multimedia image-prop
Pass: 32 | Fail: 0 | Total: 32

sargarram7 · 2026-09-10T12:45:23Z

Squash the changes, you don't need multiple patches fixing the same recipe here. And it is still failing.

Ricardo Salveti (@ricardosalveti) thank you for capturing this , check layer issue is fixed

Dmitry Baryshkov (lumag)

Also. PLEASE, STOP MOVING THE TAGS.
Once tagged, it should stay as is. You can't push a new tag just because. If you changed the code in the repo, it's a new tag.

github-actions · 2026-09-10T13:24:19Z

Test run workflow

Test jobs for commit `62a4c9b`

qcom-distro_linux-qcom-6.18
Pass: 218 | Fail: 18 | Total: 259

nodistro
Pass: 10 | Fail: 0 | Total: 10

qcom-distro
Pass: 11 | Fail: 0 | Total: 11

test-reporting-app · 2026-09-10T13:24:57Z

Test Results

68 files ± 0 319 suites ±0 2h 42m 51s ⏱️ - 1h 50m 7s
138 tests - 13 120 ✅ - 23 0 💤 - 3 18 ❌ +13
1 983 runs - 118 1 934 ✅ - 135 23 💤 - 4 26 ❌ +21

For more details on these failures, see this check.

Results for commit 62a4c9b. ± Comparison against base commit f497678.

This pull request removes 13 tests.

lava ‑ 10_Kubernetes_Kernel_Config
lava ‑ 11_Logging_Journalctl_Validation
lava ‑ 12_Partition_PostBoot_Validation
lava ‑ 13_Boot_Systemd_KPI_Loop
lava ‑ 3_OpenCV
lava ‑ 4_irq
lava ‑ 5_BT_ON_OFF
lava ‑ 6_AudioRecord
lava ‑ 7_Ethernet
lava ‑ 8_DSP_AudioPD
…

♻️ This comment has been updated with latest results.

Ricardo Salveti (ricardosalveti) · 2026-09-11T01:32:45Z

Moving to draft until the required kernel changes are in place.

Ricardo Salveti (ricardosalveti) · 2026-09-11T01:34:37Z

+LICENSE = "GPL-2.0-only"
+LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=12f884d2ae1ff87c09e5b7ccc2c4ca7e"
+
+SRC_URI = "git://github.com/qualcomm-linux/rtss-mailbox-kmd.git;branch=rtss-mailbox-kernel.le.0.0;protocol=https;tag=v${PV}"


Depends on qualcomm-linux/kernel-topics#1768.

qcomlnxci · 2026-09-16T05:36:29Z

Test Coral run workflow

Test jobs for commit `452a6f1`

qcomdistro: multimedia image-prop
Pass: 41 | Fail: 0 | Total: 41
qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9

Dmitry Baryshkov (lumag) · 2026-09-16T13:52:59Z

+
+RRECOMMENDS:${PN} += "kernel-module-rtss-mailbox"
+
+FILES:${PN} = "${libdir}/librtss_mailbox.so.* ${libdir}/librtss_safemlib.so.* ${libdir}/librtss_update.so.* ${libdir}/librtss_gpt.so.*"


Why do you need this list?

Dmitry Baryshkov (lumag) · 2026-09-16T13:53:41Z

+RRECOMMENDS:${PN} += "kernel-module-rtss-mailbox"
+
+FILES:${PN} = "${libdir}/librtss_mailbox.so.* ${libdir}/librtss_safemlib.so.* ${libdir}/librtss_update.so.* ${libdir}/librtss_gpt.so.*"
+FILES:${PN}-utils = "${bindir}/rtss_dbg ${bindir}/rtss_console ${bindir}/rtss_mbdemo ${bindir}/rtss_updater"


Just ${bindir}?

Dmitry Baryshkov (lumag) · 2026-09-16T13:54:13Z

+FILES:${PN} = "${libdir}/librtss_mailbox.so.* ${libdir}/librtss_safemlib.so.* ${libdir}/librtss_update.so.* ${libdir}/librtss_gpt.so.*"
+FILES:${PN}-utils = "${bindir}/rtss_dbg ${bindir}/rtss_console ${bindir}/rtss_mbdemo ${bindir}/rtss_updater"
+
+COMPATIBLE_MACHINE = "qcs8300|qcs9100"


No, userspace components can be built with any machine.

qcomlnxci · 2026-09-17T00:27:41Z

Test Coral run workflow

Test jobs for commit `f77a92b`

qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9
qcomdistro: multimedia image-prop
Pass: 41 | Fail: 0 | Total: 41

qcomlnxci · 2026-09-17T20:29:22Z

Test Coral run workflow

Test jobs for commit `c025f94`

qcomdistro: multimedia image-prop
Pass: 26 | Fail: 0 | Total: 26
qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9

Add the qcom-rtss-mailbox-dlkm recipe to build the RTSS mailbox kernel driver (DLKM), exposing the IPC path between APSS and RTSS via /dev/rtssmb with DAC support using rtssmb group. Also add qcom-rtss-mailbox-uapi-headers to package the ioctl/struct UAPI (rtss_mailbox_uapi.h) standalone, so userspace can build against it without depending on the kernel module recipe. Both recipes share SRC_URI/SRCREV/LICENSE via qcom-rtss-mailbox-module-common.inc, since they come from the same upstream tree (rtss-mailbox-kmd). NOTICE: this driver is still being upstreamed and its uAPI (rtss_mailbox_uapi.h) is not yet frozen and may change before upstream acceptance -- see rtss-mailbox-kmd's README for details. The "rtssmb" DAC group name is likewise not guaranteed stable long term -- it may be renamed or split per-pipe if/when this driver moves to per-use-case device nodes. Signed-off-by: Ram Sargar <rsargar@qti.qualcomm.com>

Add the qcom-rtss-mailbox-umd recipe, which builds the userspace middleware and tools for RTSS mailbox IPC communication between APSS and RTSS. This produces the shared libraries that mediate access to the qcom-rtss-mailbox-dlkm kernel driver, along with command-line utilities packaged separately in qcom-rtss-mailbox-umd-utils. It depends on qcom-rtss-mailbox-uapi-headers for the shared ioctl/struct definitions and recommends kernel-module-rtss-mailbox at runtime. Signed-off-by: Ram Sargar <rsargar@qti.qualcomm.com>

…RRECOMMENDS Add qcom-rtss-mailbox-dlkm and qcom-rtss-mailbox-umd-utils via MACHINE_EXTRA_RRECOMMENDS in qcom-qcs8300.inc, qcom-qcs9100.inc, and qcom-armv8a.conf instead, alongside the existing packagegroup-qcom-boot-additional entry. This mechanism feeds packagegroup-machine-base, which sets PACKAGE_ARCH = "${MACHINE_ARCH}" and is machine-specific, so it carries no allarch signature. Signed-off-by: Ram Sargar <rsargar@qti.qualcomm.com>

qcomlnxci · 2026-09-18T18:32:52Z

Test Coral run workflow

Test jobs for commit `e77b5d6`

qcomdistro: multimedia image-prop
Pass: 41 | Fail: 0 | Total: 41
qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9

qcomlnxci · 2026-09-19T07:47:25Z

Test Coral run workflow

Test jobs for commit `62a4c9b`

qcomdistro: multimedia image
Pass: 9 | Fail: 0 | Total: 9
qcomdistro: multimedia image-prop
Pass: 38 | Fail: 3 | Total: 41

sargarram7 · 2026-09-28T11:28:28Z

Hi Ricardo Salveti (@ricardosalveti), Jose Quaresma (@quaresmajose) ,

Could you please approve this PR? additional approval required to complete review.

Thank you,

Jose Quaresma (quaresmajose)

LGTM
The PR is still in drat; please mark it as ready for review.

Ricardo Salveti (ricardosalveti) · 2026-09-28T20:49:43Z

Please rebase in order to run over another testing round.

sargarram7 requested review from Anuj Mittal (anujm1), Koen Kooi (koenkooi), Dmitry Baryshkov (lumag), Nicolas Dechesne (ndechesne), Ricardo Salveti (ricardosalveti) and Viswanath Kraleti (vkraleti) as code owners September 6, 2026 20:42

Jose Quaresma (quaresmajose) reviewed Sep 7, 2026

View reviewed changes

Comment thread recipes-support/qcom-rtss-mailbox-umd/qcom-rtss-mailbox-umd_1.0.0.bb Outdated

Dmitry Baryshkov (lumag) requested changes Sep 7, 2026

View reviewed changes

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from 7b0844d to 09b4afd Compare September 9, 2026 09:52

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from 09b4afd to 92922bc Compare September 10, 2026 10:30

Dmitry Baryshkov (lumag) requested changes Sep 10, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-uapi-headers_1.0.0.bb

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-dlkm_1.0.0.bb

Comment thread recipes-support/qcom-rtss-mailbox-umd/qcom-rtss-mailbox-umd_1.0.0.bb Outdated

q-AnupKulkarni mentioned this pull request Sep 10, 2026

CAN user space application for RTSS CAN #3123

Open

2 of 3 tasks

Ricardo Salveti (ricardosalveti) mentioned this pull request Sep 11, 2026

qcom-rtss-can: add recipe for RTSS CAN userspace deamon #3104

Open

Ricardo Salveti (ricardosalveti) marked this pull request as draft September 11, 2026 01:32

Ricardo Salveti (ricardosalveti) reviewed Sep 11, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-uapi-headers_1.0.0.bb

Ricardo Salveti (ricardosalveti) reviewed Sep 11, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-uapi-headers_1.0.0.bb Outdated

Ricardo Salveti (ricardosalveti) reviewed Sep 11, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-uapi-headers_1.0.0.bb Outdated

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from 1c46326 to 452a6f1 Compare September 15, 2026 19:48

Ricardo Salveti (ricardosalveti) reviewed Sep 15, 2026

View reviewed changes

Comment thread recipes-bsp/packagegroups/packagegroup-machine-essential.bb Outdated

Ricardo Salveti (ricardosalveti) reviewed Sep 15, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-module-common.inc Outdated

Ricardo Salveti (ricardosalveti) reviewed Sep 15, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-uapi-headers_1.0.0.bb

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from 452a6f1 to f77a92b Compare September 15, 2026 23:39

Dmitry Baryshkov (lumag) requested changes Sep 16, 2026

View reviewed changes

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch 2 times, most recently from cdb12bf to e797282 Compare September 16, 2026 19:19

Ricardo Salveti (ricardosalveti) reviewed Sep 16, 2026

View reviewed changes

Comment thread recipes-support/qcom-rtss-mailbox-umd/qcom-rtss-mailbox-umd_1.0.0.bb

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from e797282 to c025f94 Compare September 16, 2026 19:45

Jose Quaresma (quaresmajose) reviewed Sep 16, 2026

View reviewed changes

Comment thread conf/machine/include/qcom-qcs8300.inc

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from c025f94 to e77b5d6 Compare September 18, 2026 04:36

sargarram7 added 3 commits September 18, 2026 20:51

sargarram7 force-pushed the rtss-mailbox-recipe-pin branch from e77b5d6 to 62a4c9b Compare September 18, 2026 15:22

Dmitry Baryshkov (lumag) reviewed Sep 20, 2026

View reviewed changes

Comment thread recipes-kernel/qcom-rtss-mailbox-module/qcom-rtss-mailbox-dlkm_1.0.0.bb

Dmitry Baryshkov (lumag) approved these changes Sep 26, 2026

View reviewed changes

Jose Quaresma (quaresmajose) approved these changes Sep 28, 2026

View reviewed changes

Ricardo Salveti (ricardosalveti) marked this pull request as ready for review September 28, 2026 19:42

Ricardo Salveti (ricardosalveti) added the backport wrynose label Sep 28, 2026

Ricardo Salveti (ricardosalveti) approved these changes Sep 28, 2026

View reviewed changes

Koen Kooi (koenkooi) approved these changes Sep 29, 2026

View reviewed changes


		RRECOMMENDS:${PN} += "kernel-module-rtss-mailbox"

		FILES:${PN} = "${libdir}/librtss_mailbox.so.* ${libdir}/librtss_safemlib.so.* ${libdir}/librtss_update.so.* ${libdir}/librtss_gpt.so.*"

Conversation

sargarram7 commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Target milestone: QLI-2.1

Background

Tracking issue:

This PR dependency

Related PRs

Testing

Uh oh!

Uh oh!

qcomlnxci commented Sep 7, 2026

Test Coral run workflow

Test jobs for commit 723a98c

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Ricardo Salveti (ricardosalveti) commented Sep 8, 2026

Uh oh!

Ricardo Salveti (ricardosalveti) commented Sep 9, 2026

Uh oh!

qcomlnxci commented Sep 9, 2026

Test Coral run workflow

Test jobs for commit 09b4afd

Uh oh!

sargarram7 commented Sep 10, 2026

Uh oh!

Dmitry Baryshkov (lumag) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Sep 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test run workflow

Test jobs for commit 62a4c9b

Uh oh!

test-reporting-app Bot commented Sep 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

Ricardo Salveti (ricardosalveti) commented Sep 11, 2026

Uh oh!

Ricardo Salveti (ricardosalveti) Sep 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

qcomlnxci commented Sep 16, 2026

Test Coral run workflow

Test jobs for commit 452a6f1

Uh oh!

Dmitry Baryshkov (lumag) Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

sargarram7 Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

Dmitry Baryshkov (lumag) Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

sargarram7 Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

Dmitry Baryshkov (lumag) Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

sargarram7 Sep 16, 2026

Choose a reason for hiding this comment

Uh oh!

sargarram7 commented Sep 6, 2026 •

edited

Loading

Test jobs for commit `723a98c`

Test jobs for commit `09b4afd`

github-actions Bot commented Sep 10, 2026 •

edited

Loading

Test jobs for commit `62a4c9b`

test-reporting-app Bot commented Sep 10, 2026 •

edited

Loading

Test jobs for commit `452a6f1`

Test jobs for commit `f77a92b`

Test jobs for commit `c025f94`

Test jobs for commit `e77b5d6`

Test jobs for commit `62a4c9b`