Skip to content

Comments

README: rework intro, add hardware list#252

Open
gagath wants to merge 5 commits intoqualcomm-linux:mainfrom
gagath:readme-intro-hardware-list
Open

README: rework intro, add hardware list#252
gagath wants to merge 5 commits intoqualcomm-linux:mainfrom
gagath:readme-intro-hardware-list

Conversation

@gagath
Copy link
Contributor

@gagath gagath commented Feb 19, 2026

Make the introduction more friendly to new users by reducing paragraph length and introduce a non-exhaustive list of supported hardware instead of only mentioning the RB3 Gen 2.

Preview can be seen here:
https://github.com/gagath/qcom-deb-images/tree/readme-intro-hardware-list/README.md

Signed-off-by: Agathe Porte <agathe.porte@oss.qualcomm.com>
Signed-off-by: Agathe Porte <agathe.porte@oss.qualcomm.com>
Users might think this repository only supports the RB3 by reading the
introduction, while the goal is to support a lot of QC-enabled hardware.

Create a non-exhaustive list that can be extended to reflect this.

Signed-off-by: Agathe Porte <agathe.porte@oss.qualcomm.com>
Signed-off-by: Agathe Porte <agathe.porte@oss.qualcomm.com>
Signed-off-by: Agathe Porte <agathe.porte@oss.qualcomm.com>
@gagath gagath added the documentation Improvements or additions to documentation label Feb 19, 2026
@gagath gagath mentioned this pull request Feb 19, 2026
@github-actions
Copy link

Test Results

 2 files  ±0   6 suites  ±0   2m 59s ⏱️ ±0s
20 tests ±0  18 ✅ ±0  0 💤 ±0  2 ❌ ±0 
64 runs  ±0  62 ✅ ±0  0 💤 ±0  2 ❌ ±0 

For more details on these failures, see this check.

Results for commit 143ced9. ± Comparison against base commit aa30037.

@github-actions
Copy link

Test jobs for commit 143ced9

Copy link
Contributor

@lool lool left a comment

Choose a reason for hiding this comment

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

Thanks for your work on these; this is trickier as in some cases it's more wordsmithing and subtle positions, I'm attached to some of the wording there, I hope I can convey why :)

recipes based on Debian trixie for boards such as the Qualcomm RB3 Gen 2.
recipes based on Debian trixie for boards such as:

- [Qualcomm RB1](https://docs.qualcomm.com/doc/87-61720-1/87-61720-1_REV_A_QUALCOMM_ROBOTICS_RB1_PLATFORM__QUALCOMM_QRB2210__PRODUCT_BRIEF.pdf) (QRB2210)
Copy link
Contributor

Choose a reason for hiding this comment

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

We could relate more broadly to Qualcomm IoT boards supported in Qualcomm Linux, or Qualcomm boards supported in mainline Linux

The actual list of boards we support is listed in the flash recipe if you want to build a proper list :)


- [Qualcomm RB1](https://docs.qualcomm.com/doc/87-61720-1/87-61720-1_REV_A_QUALCOMM_ROBOTICS_RB1_PLATFORM__QUALCOMM_QRB2210__PRODUCT_BRIEF.pdf) (QRB2210)
- [Qualcomm RB3 Gen 2](https://docs.qualcomm.com/doc/87-74789-1/87-74789-1_REV_A_Qualcomm_RB3_Gen_2_Development_Kit_Product_Brief.pdf) (QCS6490)
- [Lenovo T14s Gen 6](https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpadt/lenovo-thinkpad-t14s-gen-6-14-inch-snapdragon/len101t0099) (Snapdragon X)
Copy link
Contributor

Choose a reason for hiding this comment

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

Let's list laptops once we land the boot architecture changes (stubble integration)

Qualcomm® IoT platforms as to demonstrate the state of upstream open source
software, help developers getting started, and support continuous development
and continuous testing efforts.
Goal of this project is to provide mainline-centric images for Qualcomm® IoT
Copy link
Contributor

Choose a reason for hiding this comment

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

I preferred "current focus" as it didn't exclude other things; I'd be ok with "The main goal of"

README.md Outdated
[![weekly mainline build status](https://img.shields.io/github/actions/workflow/status/qualcomm-linux/qcom-deb-images/linux-weekly-mainline.yml?label=weekly%20mainline%20build)](https://github.com/qualcomm-linux/qcom-deb-images/actions/workflows/linux-weekly-mainline.yml)

A collection of recipes to build Qualcomm Linux images for deb based operating
A collection of recipes to build Qualcomm Linux images for Debian-based operating
Copy link
Contributor

Choose a reason for hiding this comment

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

I had picked this wording to stay as neutral as possible on Debian vs Ubuntu. Ubuntu is a Debian derivative under some angles, and sometimes it's seen as a technical detail. I picked the original wording to allow for Ubuntu, while I find that forcing Ubuntu as a "Debian-based OS" is not obvious.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants