doc: Bluetooth qualification #9705
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
github-actions
bot
added
changelog-entry-required
|
You can find the documentation preview for this PR at this link. It will be updated about 10 minutes after the documentation build succeeds. Note: This comment is automatically posted by the Documentation Publishing GitHub Action. |
annakielar
force-pushed
the
bt_qualification
branch
from
daad174
to
c9bd5cf
Compare
Test specificationCI/Jenkins/NRF
CI/Jenkins/integration
Note: This message is automatically posted and updated by the CI |
annakielar
force-pushed
the
bt_qualification
branch
2 times, most recently
from
f488c8b
to
089920d
Compare
github-actions
bot
removed
the
changelog-entry-required
annakielar
force-pushed
the
bt_qualification
branch
from
089920d
to
610b8aa
Compare
annakielar
commented
Jan 16, 2023
annakielar
commented
Jan 16, 2023
annakielar
commented
Jan 16, 2023
grochu
reviewed
Jan 17, 2023
annakielar
force-pushed
the
bt_qualification
branch
from
610b8aa
to
9539196
Compare
annakielar
force-pushed
the
bt_qualification
branch
from
9539196
to
ed65c0f
Compare
annakielar
force-pushed
the
bt_qualification
branch
from
ed65c0f
to
023ab4f
Compare
annakielar
commented
Jan 23, 2023
annakielar
requested review from
mileslouissmith and
greg-fer
and removed request for
mileslouissmith
greg-fer
reviewed
Jan 24, 2023
annwoj
reviewed
Jan 24, 2023
annakielar
force-pushed
the
bt_qualification
branch
from
0fccd7a
to
25a82ef
Compare
annakielar
requested review from
mileslouissmith,
omkar3141,
greg-fer and
annwoj
mileslouissmith
approved these changes
Aug 17, 2023
greg-fer
requested changes
Aug 18, 2023
There was a problem hiding this comment.
Comments about text cohesion.
As a side note, I would like to see some figures that present the whole process visually. Bluetooth SIG's resources are text-heavy and I couldn't find any overview diagram under the links used on the page. It's really hard to go through wall of texts with different naming conventions for people new to the process, and the more we can do to save tech support some time, the better.
annakielar
force-pushed
the
bt_qualification
branch
2 times, most recently
from
0f899c8
to
f61f1d4
Compare
omkar3141
approved these changes
Aug 28, 2023
annakielar
force-pushed
the
bt_qualification
branch
2 times, most recently
from
73ebc2f
to
a19f96f
Compare
|
Hi All, the PR is ready for your final review. |
grochu
approved these changes
Sep 19, 2023
There was a problem hiding this comment.
I reviewed from the Bluetooth stack user perspective, I don't know much about the qualification process itself so I leave this aspect to other reviewers.
The chapter looks very good, it's well-organized and informative.
It may require a certain level of maintenance in case links, terminology or BT SIG policy changes in future.
omkar3141
approved these changes
Sep 19, 2023
annwoj
reviewed
Sep 20, 2023
|
|
||
| Any qualified design offered by Nordic Semiconductor (for example, :ref:`ug_bt_mesh` versions) can be qualified independently by the customers. | ||
| However, this process may be complex and time-consuming, thus it is recommended to inherit Nordic Semiconductor's design qualifications in your End Product's listing. | ||
| If you want to create a Profile Subsystem that is not on the `Bluetooth Qualification Listing`_ yet, run the relevant tests through the `Profile Tuning Suite (PTS)`_ tool and qualify the product. |
There was a problem hiding this comment.
Suggested change
| If you want to create a Profile Subsystem that is not on the `Bluetooth Qualification Listing`_ yet, run the relevant tests through the `Profile Tuning Suite (PTS)`_ tool and qualify the product. | |
| If you want to create a Profile Subsystem that is not on the `Bluetooth Qualification Listing`_, run the relevant tests through the `Profile Tuning Suite (PTS)`_ tool and qualify the product. |
|
|
||
| Before you start the `Bluetooth SIG's Qualification Process`_, ensure the following: | ||
|
|
||
| 1. You have access to your member company's account. |
There was a problem hiding this comment.
Suggested change
| 1. You have access to your member company's account. | |
| #. You have access to your company's member account. |
| 1. You have access to your member company's account. | ||
| To check if your company is already a SIG member, go to `Join Bluetooth SIG`_ page and search the Member Directory list. | ||
|
|
||
| 2. Get acquainted with the Program Reference Document (PRD) and Declaration Process Document (DPD), that will help you to understand the basics. |
There was a problem hiding this comment.
Suggested change
| 2. Get acquainted with the Program Reference Document (PRD) and Declaration Process Document (DPD), that will help you to understand the basics. | |
| #. Get acquainted with the Program Reference Document (PRD) and Declaration Process Document (DPD) to understand the basics of the qualification process. |
| To check if your company is already a SIG member, go to `Join Bluetooth SIG`_ page and search the Member Directory list. | ||
|
|
||
| 2. Get acquainted with the Program Reference Document (PRD) and Declaration Process Document (DPD), that will help you to understand the basics. | ||
| Log into your member company's account to review both `PRD and DPD`_ documents. |
There was a problem hiding this comment.
Suggested change
| Log into your member company's account to review both `PRD and DPD`_ documents. | |
| Log into your company's member account to review both `PRD and DPD`_ documents. |
| Qualification process | ||
| ********************* | ||
|
|
||
| Although you can use pre-qualified designs, any Bluetooth Product qualification cannot be simply inherited with no action required from your end. |
There was a problem hiding this comment.
Suggested change
| Although you can use pre-qualified designs, any Bluetooth Product qualification cannot be simply inherited with no action required from your end. | |
| Although you can use pre-qualified designs, Bluetooth Product qualification can only be inherited through action on your end. |
| * You want to switch to another major |NCS| version for an existing product. | ||
| * In some cases, if you want to switch to another minor |NCS| version for an existing product. | ||
|
|
||
| It may happen that you would need to alter the configuration of the qualified design or slightly modify small parts of the existing design to better fit your application needs. |
There was a problem hiding this comment.
Suggested change
| It may happen that you would need to alter the configuration of the qualified design or slightly modify small parts of the existing design to better fit your application needs. | |
| You might need to alter the configuration of the qualified design or slightly modify parts of the existing design to better fit your application needs. |
| * Ensure that the resulting design does not change the Implementation Conformance Statement (ICS) that has already been declared for a relevant Nordic Semiconductor's qualified design. | ||
| * Ensure that the resulting design does not break the qualification of the existing design. | ||
|
|
||
| You can do so by running relevant qualification tests using test tools indicated in the 'Launch Studio'_ tool. |
There was a problem hiding this comment.
Suggested change
| You can do so by running relevant qualification tests using test tools indicated in the 'Launch Studio'_ tool. | |
| You can complete the checks by running relevant qualification tests using test tools indicated in the 'Launch Studio'_ tool. |
|
|
||
| #. Open the Bluetooth QDIDs article and, based on the table, confirm the following information: | ||
|
|
||
| * That the version you want to use is compatible with versions of other Subsystems you want to keep for your product. |
There was a problem hiding this comment.
Suggested change
| * That the version you want to use is compatible with versions of other Subsystems you want to keep for your product. | |
| * The version you want to use must be compatible with versions of other Subsystems you want to keep for your product. |
|
|
||
| #. Navigate to the relevant Compatibility Matrix directory. | ||
|
|
||
| #. Open the Bluetooth QDIDs article and, based on the table, confirm the following information: |
There was a problem hiding this comment.
Suggested change
| #. Open the Bluetooth QDIDs article and, based on the table, confirm the following information: | |
| #. Open the Bluetooth QDIDs article and, based on the table, confirm the following: |
| #. Open the Bluetooth QDIDs article and, based on the table, confirm the following information: | ||
|
|
||
| * That the version you want to use is compatible with versions of other Subsystems you want to keep for your product. | ||
| * That relevant Host and SoftDevice Controller Subsystems implemented in the |NCS| version you want to use are pre-qualified. |
There was a problem hiding this comment.
Suggested change
| * That relevant Host and SoftDevice Controller Subsystems implemented in the |NCS| version you want to use are pre-qualified. | |
| * Relevant Host and SoftDevice Controller Subsystems implemented in the |NCS| version you want to use must be pre-qualified. |
annakielar
force-pushed
the
bt_qualification
branch
2 times, most recently
from
776fb36
to
0889264
Compare
|
Hello, I think the PR is good enough, and it will be nice to merge it as soon as possible. |
|
@annakielar, please rebase as it is having conflict. |
annakielar
force-pushed
the
bt_qualification
branch
2 times, most recently
from
b8a0d6a
to
d40e24a
Compare
Added a new article about the Bluetooth qualification process. Added a page gathering all Bluetooth-related topics in Protocols. Added a few links to links.txt. Signed-off-by: Anna Kielar <anna.kielar@nordicsemi.no>
annakielar
force-pushed
the
bt_qualification
branch
from
d40e24a
to
cc50e4e
Compare
greg-fer
approved these changes
Sep 26, 2023
|
[celebrate] Kulkarni, Omkar reacted to your message:
…________________________________
From: Jamie ***@***.***>
Sent: Tuesday, September 26, 2023 10:47:36 AM
To: nrfconnect/sdk-nrf ***@***.***>
Cc: Kulkarni, Omkar ***@***.***>; Mention ***@***.***>
Subject: Re: [nrfconnect/sdk-nrf] doc: Bluetooth qualification (PR #9705)
Merged #9705<#9705> into main.
—
Reply to this email directly, view it on GitHub<#9705 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AHTKHAC5PGVA6GG4CY3HU4DX4KXERANCNFSM6AAAAAAS7WCJNQ>.
You are receiving this because you were mentioned.Message ID: ***@***.***>
|
|
[celebrate] Kulkarni, Omkar reacted to your message:
…________________________________
From: Grzegorz Ferenc ***@***.***>
Sent: Tuesday, September 26, 2023 10:46:42 AM
To: nrfconnect/sdk-nrf ***@***.***>
Cc: Kulkarni, Omkar ***@***.***>; Mention ***@***.***>
Subject: Re: [nrfconnect/sdk-nrf] doc: Bluetooth qualification (PR #9705)
@greg-fer approved this pull request.
—
Reply to this email directly, view it on GitHub<#9705 (review)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AHTKHACKT27BOLXFHFWEB73X4KXBFANCNFSM6AAAAAAS7WCJNQ>.
You are receiving this because you were mentioned.Message ID: ***@***.***>
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Added a new article about the Bluetooth qualification process. Added a few links to links.txt.
Signed-off-by: Anna Kielar anna.kielar@nordicsemi.no