Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bluetooth: Add hci_vs_sdc.h which expose wrappers VS HCI commands #15798

Merged
merged 1 commit into from
Jul 9, 2024

Conversation

rugeGerritsen
Copy link
Contributor

The SDC provides vendor specific Bluetooth functionality through vendor specific HCI commands.
The APIs added in this commit handles:

  • Building the VS HCI commands
  • Sending the VS HCI command to the controller. This works both when the controller is on the same core, or if the controller is separated from the host by another HCI layer.
  • Return parameters

This removes the need for boilerplate code in applications.

Some of the vendor specific APIs take in handles.
Those can be obtained from host types using the APIs defined in zephyr/bluetooth/hci.h.

The API documentation is referring to the HCI command documentation to avoid duplication.

@github-actions github-actions bot added the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Jun 6, 2024
@Tschet1
Copy link
Contributor

Tschet1 commented Jun 6, 2024

in a follow-up, should we update the content of host_extensions.c?

@rugeGerritsen
Copy link
Contributor Author

in a follow-up, should we update the content of host_extensions.c?

Yes, and also other places where applications and samples are now building and sending these HCI commands manually

@NordicBuilder
Copy link
Contributor

NordicBuilder commented Jun 6, 2024

Test specification

CI/Jenkins/NRF

  • Integration Platforms

CI/Jenkins/integration

Test Module File based changes Manually selected West overwrite
desktop52_verification X
test-fw-nrfconnect-apps X
test-fw-nrfconnect-ble X
test-fw-nrfconnect-ble_samples X
test-sdk-find-my X

Detailed information of selected test modules

Note: This message is automatically posted and updated by the CI

subsys/bluetooth/hci_vs_sdc.c Outdated Show resolved Hide resolved
@rugeGerritsen rugeGerritsen force-pushed the expose-hci-wrappers branch 3 times, most recently from 3b8bedd to 6f38cdc Compare June 7, 2024 10:12
@rugeGerritsen rugeGerritsen force-pushed the expose-hci-wrappers branch 2 times, most recently from 5bde48a to f2416b8 Compare June 10, 2024 10:12
@NordicBuilder
Copy link
Contributor

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.

Copy link
Contributor

@KAGA164 KAGA164 left a comment

Choose a reason for hiding this comment

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

LGTM

The SDC provides vendor specific Bluetooth functionality through
vendor specific HCI commands.
The APIs added in this commit handles:
 - Building the VS HCI commands
 - Sending the VS HCI command to the controller.
   This works both when the controller is on the same core,
   or if the controller is separated from the host by
   another HCI layer.
 - Return parameters

This removes the need for boilerplate code in applications.

Some of the vendor specific APIs take in handles.
Those can be obtained from host types using the APIs defined
in `zephyr/bluetooth/hci.h`.

The API documentation is referring to the HCI command documentation
to avoid duplication.

Signed-off-by: Rubin Gerritsen <[email protected]>
@rugeGerritsen rugeGerritsen removed the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Jul 2, 2024
@anangl anangl merged commit 635fa76 into nrfconnect:main Jul 9, 2024
19 checks passed
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.

7 participants