Skip to content

qcom-rtss-mailbox: add KMD and UMD recipes for RTSS mailbox IPC#2528

Open
snegi-qti wants to merge 2 commits into
qualcomm-linux:masterfrom
snegi-qti:rtss_kmd
Open

qcom-rtss-mailbox: add KMD and UMD recipes for RTSS mailbox IPC#2528
snegi-qti wants to merge 2 commits into
qualcomm-linux:masterfrom
snegi-qti:rtss_kmd

Conversation

@snegi-qti

@snegi-qti snegi-qti commented Jun 18, 2026

Copy link
Copy Markdown

The RTSS (Real Time Subsystem) currently has no IPC path to the application processor, and userspace applications have no stable API to communicate with it. These two recipes together establish the full mailbox IPC stack.

  • qcom-rtss-mailbox-kmd: Adds the DLKM recipe for the rtss_mailbox kernel module, which is the prerequisite IPC driver without which no communication between RTSS and the APSS is possible. .
  • qcom-rtss-mailbox-umd: Adds the middleware recipe that gives userspace applications a stable API over the mailbox channel — isolating the kernel UAPI from application code and enabling independent versioning of the mailbox and OTA SDK components. Builds librtss_mailbox, librtss_safemlib, and librtss_ota (shared + static), plus rtssdbg, rtss_console, and rtss_ota debug/utility binaries. Output is split into runtime, dev, staticdev, and utils subpackages for fine-grained install control.

@ricardosalveti

Ricardo Salveti (ricardosalveti) commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Repo is not even public: https://github.com/qualcomm-linux/rtss-mailbox-kmd

@ricardosalveti Ricardo Salveti (ricardosalveti) marked this pull request as draft June 18, 2026 16:23
@snegi-qti snegi-qti force-pushed the rtss_kmd branch 2 times, most recently from be5f40d to 90ca377 Compare June 18, 2026 16:26
@snegi-qti

Copy link
Copy Markdown
Author

Sure, we are very close on making the repo public - awaiting some approvals, meanwhile, we can keep this as draft.

@github-actions

Copy link
Copy Markdown

Test run workflow

Test jobs for commit 58a5593

nodistro
Pass: 9 | Fail: 0 | Total: 9
qcom-distro_linux-qcom-6.18
Pass: 206 | Fail: 1 | Total: 245
qcom-distro
Pass: 228 | Fail: 0 | Total: 274

@test-reporting-app

test-reporting-app Bot commented Jun 19, 2026

Copy link
Copy Markdown

Test Results

  105 files  +   79    634 suites  +608   5h 16m 59s ⏱️ + 4h 21m 49s
  125 tests +  112    125 ✅ +  116   0 💤 ± 0  0 ❌  - 4 
6 037 runs  +5 842  5 953 ✅ +5 762  84 💤 +84  0 ❌  - 4 

Results for commit ebfa959. ± Comparison against base commit f3eeb8b.

This pull request removes 2 and adds 114 tests. Note that renamed tests count towards both.
lava ‑ auto-login-action
lava ‑ minimal-boot
0_AudioRecord_Config01 ‑ AudioRecord_Config01
0_BT_FW_KMD_Service ‑ BT_FW_KMD_Service
0_GStreamer_Video_Encode_h264_480p ‑ GStreamer_Video_Encode_h264_480p
0_Libcamera_cam ‑ Libcamera_cam
0_Weston_Runtime_Preflight ‑ Weston_Runtime_Preflight
0_hotplug ‑ hotplug
10_AudioRecord ‑ AudioRecord
10_Kubernetes_Kernel_Config ‑ Kubernetes_Kernel_Config
11_DSP_AudioPD ‑ DSP_AudioPD
11_Ethernet ‑ Ethernet
…

♻️ This comment has been updated with latest results.

@github-actions

Copy link
Copy Markdown

Test run workflow

Test jobs for commit ebfa959

nodistro
Pass: 9 | Fail: 0 | Total: 9
qcom-distro_linux-qcom-6.18
Pass: 188 | Fail: 0 | Total: 222
qcom-distro
Pass: 234 | Fail: 0 | Total: 277

@snegi-qti

Copy link
Copy Markdown
Author

qli-2.0 GA Critical Fix

@lumag

Copy link
Copy Markdown
Contributor

qli-2.0 GA Critical Fix

It's not a Fix. It's a new features, submitted past the cut-off date.

Comment thread recipes-kernel/qcom-rtss-mailbox-kmd/qcom-rtss-mailbox-kmd_git.bb Outdated
Comment thread recipes-kernel/qcom-rtss-mailbox-kmd/qcom-rtss-mailbox-kmd_git.bb Outdated
Comment thread recipes-kernel/qcom-rtss-mailbox-kmd/qcom-rtss-mailbox-kmd_git.bb Outdated
Comment thread recipes-kernel/qcom-rtss-mailbox-kmd/qcom-rtss-mailbox-kmd_git.bb Outdated
Comment thread recipes-kernel/qcom-rtss-mailbox-kmd/qcom-rtss-mailbox-kmd_git.bb Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please improve your commit message, explain why this module is needed in first place, how it is going to be used, by which components, etc.

@github-actions

Copy link
Copy Markdown

Test run workflow

Test jobs for commit ebfa959

nodistro
Pass: 9 | Fail: 0 | Total: 9
qcom-distro_linux-qcom-6.18
Pass: 211 | Fail: 0 | Total: 250
qcom-distro
Pass: 252 | Fail: 0 | Total: 297

@snegi-qti snegi-qti changed the title qcom-rtss-mailbox-kmd: add recipe for RTSS mailbox kernel driver Add recipes for RTSS mailbox kernel driver and usermode driver Jun 23, 2026
@snegi-qti snegi-qti changed the title Add recipes for RTSS mailbox kernel driver and usermode driver qcom-rtss-mailbox: add KMD and UMD recipes for RTSS mailbox IPC Jun 23, 2026
The RTSS subsystem requires a kernel-side IPC driver to establish the
mailbox communication channel between RTSS and the application processor.
Without this driver, no IPC path exists between the two subsystems.

Add a DLKM recipe that builds and installs the rtss_mailbox kernel module.
Configure the module to autoload on boot with a soft dependency on
qcom_ipcc to guarantee correct initialization order. Export
rtss_mailbox_uapi.h to sysroot so the userspace middleware recipe can
consume it at build time.

Signed-off-by: Sankalp Negi <snegi@qti.qualcomm.com>
Userspace applications need a stable, versioned API to communicate with
the RTSS subsystem over the mailbox IPC channel. Providing a dedicated
middleware recipe isolates the kernel UAPI from application code and
enables independent versioning of the mailbox and OTA SDK components.

Add a CMake-based recipe that builds and packages:
- librtss_mailbox and librtss_safemlib (shared and static) as the core
  mailbox middleware
- librtss_ota (shared and static) as the OTA SDK library
- rtssdbg, rtss_console, and rtss_ota debug/utility binaries

Split the output into runtime, dev, staticdev, and utils subpackages to
give consumers fine-grained install control. Depend on
qcom-rtss-mailbox-kmd to consume the exported rtss_mailbox_uapi.h
header during the build.

Signed-off-by: Sankalp Negi <snegi@qti.qualcomm.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants