|
Zephyr API Documentation 4.4.99
A Scalable Open Source RTOS
|
Phone Book Access Profile (PBAP). More...
Data Structures | |
| struct | bt_pbap_pce_cb |
| PBAP PCE (Phone Book Client Equipment) callback operations structure. More... | |
| struct | bt_pbap_pce |
| PBAP PCE (Phone Book Client Equipment) structure. More... | |
| struct | bt_pbap_pse_cb |
| PBAP PSE (Phone Book Server Equipment) callback operations structure. More... | |
| struct | bt_pbap_pse_rfcomm |
| PBAP PSE RFCOMM server structure. More... | |
| struct | bt_pbap_pse_l2cap |
| PBAP PSE L2CAP server structure. More... | |
| struct | bt_pbap_pse |
| PBAP PSE (Phone Book Server Equipment) structure. More... | |
Macros | |
| #define | BT_PBAP_UUID |
| PBAP target UUID for service identification. | |
| #define | BT_PBAP_PULL_PHONE_BOOK_TYPE "x-bt/phonebook" |
| OBEX type header for pull phone book operation. | |
| #define | BT_PBAP_PULL_VCARD_LISTING_TYPE "x-bt/vcard-listing" |
| OBEX type header for pull vCard listing operation. | |
| #define | BT_PBAP_PULL_VCARD_ENTRY_TYPE "x-bt/vcard" |
| OBEX type header for pull vCard entry operation. | |
| #define | BT_PBAP_SET_PHONE_BOOK_FLAGS_UP (BT_OBEX_SETPATH_FLAG_BACKUP | BT_OBEX_SETPATH_FLAG_NO_CREATE) |
| Set phone book flags: Navigate up to parent directory. | |
| #define | BT_PBAP_SET_PHONE_BOOK_FLAGS_DOWN_OR_ROOT BT_OBEX_SETPATH_FLAG_NO_CREATE |
| Set phone book flags: Navigate down to child directory or to root. | |
Functions | |
| int | bt_pbap_pce_rfcomm_connect (struct bt_conn *conn, struct bt_pbap_pce *pbap_pce, struct bt_pbap_pce_cb *cb, uint8_t channel) |
| PCE Connect to PSE over RFCOMM transport. | |
| int | bt_pbap_pce_rfcomm_disconnect (struct bt_pbap_pce *pbap_pce) |
| Disconnect PBAP PCE RFCOMM transport. | |
| int | bt_pbap_pce_l2cap_connect (struct bt_conn *conn, struct bt_pbap_pce *pbap_pce, struct bt_pbap_pce_cb *cb, uint16_t psm) |
| Connect PBAP PCE client over L2CAP transport. | |
| int | bt_pbap_pce_l2cap_disconnect (struct bt_pbap_pce *pbap_pce) |
| Disconnect PBAP PCE L2CAP transport. | |
| struct net_buf * | bt_pbap_pce_create_pdu (struct bt_pbap_pce *pbap_pce, struct net_buf_pool *pool) |
| Allocate buffer from pool with reserved headroom for PBAP PCE. | |
| int | bt_pbap_pce_connect (struct bt_pbap_pce *pbap_pce, uint16_t mopl, struct net_buf *buf) |
| Establish PBAP protocol connection from PCE client to PSE server. | |
| int | bt_pbap_pce_disconnect (struct bt_pbap_pce *pbap_pce, struct net_buf *buf) |
| Disconnect PBAP connection from PBAP client PCE. | |
| int | bt_pbap_pce_pull_phone_book (struct bt_pbap_pce *pbap_pce, struct net_buf *buf) |
| Pull phone book from PBAP server PSE. | |
| int | bt_pbap_pce_pull_vcard_listing (struct bt_pbap_pce *pbap_pce, struct net_buf *buf) |
| Pull vCard listing from PBAP server PSE. | |
| int | bt_pbap_pce_pull_vcard_entry (struct bt_pbap_pce *pbap_pce, struct net_buf *buf) |
| Pull specific vCard entry from PBAP server PSE. | |
| int | bt_pbap_pce_set_phone_book (struct bt_pbap_pce *pbap_pce, uint8_t flags, struct net_buf *buf) |
| Set current phone book on PBAP server PSE. | |
| int | bt_pbap_pce_abort (struct bt_pbap_pce *pbap_pce, struct net_buf *buf) |
| Abort current operation on PBAP server PSE. | |
| struct net_buf * | bt_pbap_pse_create_pdu (struct bt_pbap_pse *pbap_pse, struct net_buf_pool *pool) |
| Allocate buffer from pool with reserved headroom for PBAP PSE. | |
| int | bt_pbap_pse_rfcomm_register (struct bt_pbap_pse_rfcomm *server) |
| Register PBAP PSE RFCOMM server. | |
| int | bt_pbap_pse_l2cap_register (struct bt_pbap_pse_l2cap *server) |
| Register PBAP PSE L2CAP server. | |
| int | bt_pbap_pse_register (struct bt_pbap_pse *pbap_pse, struct bt_pbap_pse_cb *cb) |
| Register PBAP PSE instance. | |
| int | bt_pbap_pse_connect_rsp (struct bt_pbap_pse *pbap_pse, uint16_t mopl, uint8_t rsp_code, struct net_buf *buf) |
| Send connect response from PBAP PSE. | |
| int | bt_pbap_pse_disconnect_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send disconnect response from PBAP PSE. | |
| int | bt_pbap_pse_pull_phone_book_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send pull phone book response from PBAP PSE. | |
| int | bt_pbap_pse_pull_vcard_listing_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send pull vCard listing response from PBAP PSE. | |
| int | bt_pbap_pse_pull_vcard_entry_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send pull vCard entry response from PBAP PSE. | |
| int | bt_pbap_pse_set_phone_book_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send set phone book response from PBAP PSE. | |
| int | bt_pbap_pse_abort_rsp (struct bt_pbap_pse *pbap_pse, uint8_t rsp_code, struct net_buf *buf) |
| Send abort response from PBAP PSE. | |
| int | bt_pbap_calculate_nonce (const uint8_t *pwd, uint8_t nonce[BT_OBEX_CHALLENGE_TAG_NONCE_LEN]) |
| Calculate authentication nonce for PBAP challenge. | |
| int | bt_pbap_calculate_rsp_digest (const uint8_t *pwd, const uint8_t nonce[BT_OBEX_CHALLENGE_TAG_NONCE_LEN], uint8_t rsp_digest[BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN]) |
| Calculate response digest for PBAP authentication. | |
| int | bt_pbap_verify_authentication (uint8_t nonce[BT_OBEX_CHALLENGE_TAG_NONCE_LEN], uint8_t rsp_digest[BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN], const uint8_t *pwd) |
| Verify authentication response. | |
Phone Book Access Profile (PBAP).
| #define BT_PBAP_PULL_PHONE_BOOK_TYPE "x-bt/phonebook" |
#include <zephyr/bluetooth/classic/pbap.h>
OBEX type header for pull phone book operation.
| #define BT_PBAP_PULL_VCARD_ENTRY_TYPE "x-bt/vcard" |
#include <zephyr/bluetooth/classic/pbap.h>
OBEX type header for pull vCard entry operation.
| #define BT_PBAP_PULL_VCARD_LISTING_TYPE "x-bt/vcard-listing" |
#include <zephyr/bluetooth/classic/pbap.h>
OBEX type header for pull vCard listing operation.
| #define BT_PBAP_SET_PHONE_BOOK_FLAGS_DOWN_OR_ROOT BT_OBEX_SETPATH_FLAG_NO_CREATE |
#include <zephyr/bluetooth/classic/pbap.h>
Set phone book flags: Navigate down to child directory or to root.
OBEX setpath flag used to navigate down to a child directory or to the root directory in the phone book hierarchy.
| #define BT_PBAP_SET_PHONE_BOOK_FLAGS_UP (BT_OBEX_SETPATH_FLAG_BACKUP | BT_OBEX_SETPATH_FLAG_NO_CREATE) |
#include <zephyr/bluetooth/classic/pbap.h>
Set phone book flags: Navigate up to parent directory.
Combination of OBEX setpath flags used to navigate to the parent directory in the phone book hierarchy.
| #define BT_PBAP_UUID |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP target UUID for service identification.
128-bit UUID (796135f0-f0c5-11d8-0966-0800200c9a66) used to identify the PBAP service during OBEX connection establishment.
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter Format parameter values.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_FORMAT_2_1 | vCard version 2.1. |
| BT_PBAP_APPL_PARAM_FORMAT_3_0 | vCard version 3.0. |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter Order parameter values.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_ORDER_INDEXED | Indexed order. |
| BT_PBAP_APPL_PARAM_ORDER_ALPHABETICAL | Alphabetical order. |
| BT_PBAP_APPL_PARAM_ORDER_PHONETIC | Phonetic order. |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP property bitmask.
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter reset neww missed calls parameter values.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_RESET_NEW_MISSED_CALLS | Reset. |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter Search Property parameter values.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_SEARCH_PROPERTY_NAME | Name. |
| BT_PBAP_APPL_PARAM_SEARCH_PROPERTY_NUMBER | Number. |
| BT_PBAP_APPL_PARAM_SEARCH_PROPERTY_SOUND | Sound. |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter tag IDs.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_TAG_ID_ORDER | Order bt_pbap_appl_param_order. |
| BT_PBAP_APPL_PARAM_TAG_ID_SEARCH_VALUE | Search value. |
| BT_PBAP_APPL_PARAM_TAG_ID_SEARCH_PROPERTY | Search property bt_pbap_appl_param_search_property. |
| BT_PBAP_APPL_PARAM_TAG_ID_MAX_LIST_COUNT | Max list count. |
| BT_PBAP_APPL_PARAM_TAG_ID_LIST_START_OFFSET | List start offset. |
| BT_PBAP_APPL_PARAM_TAG_ID_PROPERTY_SELECTOR | Property selector bt_pbap_appl_param_property_mask. |
| BT_PBAP_APPL_PARAM_TAG_ID_FORMAT | Format bt_pbap_appl_param_format. |
| BT_PBAP_APPL_PARAM_TAG_ID_PHONEBOOK_SIZE | Phonebook size. |
| BT_PBAP_APPL_PARAM_TAG_ID_NEW_MISSED_CALLS | New missed calls. |
| BT_PBAP_APPL_PARAM_TAG_ID_PRIMARY_FOLDER_VERSION | Primary folder version. |
| BT_PBAP_APPL_PARAM_TAG_ID_SECONDARY_FOLDER_VERSION | Secondary folder version. |
| BT_PBAP_APPL_PARAM_TAG_ID_VCARD_SELECTOR | vCard selector bt_pbap_appl_param_property_mask . |
| BT_PBAP_APPL_PARAM_TAG_ID_DATABASE_IDENTIFIER | Database identifier. |
| BT_PBAP_APPL_PARAM_TAG_ID_VCARD_SELECTOR_OPERATOR | vCard selector operator bt_pbap_appl_param_property_mask. |
| BT_PBAP_APPL_PARAM_TAG_ID_RESET_NEW_MISSED_CALLS | Reset new missed calls bt_pbap_appl_param_reset_new_missed_calls. |
| BT_PBAP_APPL_PARAM_TAG_ID_SUPPORTED_FEATURES | PBAP supported features bt_pbap_supported_feature. |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP application parameter vCard Selector Operator parameter values.
| Enumerator | |
|---|---|
| BT_PBAP_APPL_PARAM_VCARD_SELECTOR_OPERATOR_OR | OR operator. |
| BT_PBAP_APPL_PARAM_VCARD_SELECTOR_OPERATOR_AND | AND operator. |
| enum bt_pbap_rsp_code |
#include <zephyr/bluetooth/classic/pbap.h>
PBAP response codes.
Response codes used in PBAP operations, mapped from OBEX response codes. These indicate the status of PBAP requests and operations.
#include <zephyr/bluetooth/classic/pbap.h>
PBAP supported features bitmask.
#include <zephyr/bluetooth/classic/pbap.h>
PBAP supported repositories bitmask.
#include <zephyr/bluetooth/classic/pbap.h>
Calculate authentication nonce for PBAP challenge.
Generates a random nonce value used in OBEX authentication challenges. The nonce is used to prevent replay attacks during authentication.
| pwd | Password string used for authentication (null-terminated). |
| nonce | Output buffer to store the generated nonce (BT_OBEX_CHALLENGE_TAG_NONCE_LEN bytes). |
| int bt_pbap_calculate_rsp_digest | ( | const uint8_t * | pwd, |
| const uint8_t | nonce[BT_OBEX_CHALLENGE_TAG_NONCE_LEN], | ||
| uint8_t | rsp_digest[BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN] ) |
#include <zephyr/bluetooth/classic/pbap.h>
Calculate response digest for PBAP authentication.
Computes the MD5 digest for an authentication response based on the password and received nonce. This digest is sent back to prove knowledge of the password without transmitting the password itself.
| pwd | Password string used for authentication (null-terminated). |
| nonce | Nonce value received in the authentication challenge (BT_OBEX_CHALLENGE_TAG_NONCE_LEN bytes). |
| rsp_digest | Output buffer to store the calculated response digest (BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN bytes). |
| int bt_pbap_pce_abort | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Abort current operation on PBAP server PSE.
Sends an abort request to cancel the current ongoing operation.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| buf | Buffer containing optional abort headers. |
| int bt_pbap_pce_connect | ( | struct bt_pbap_pce * | pbap_pce, |
| uint16_t | mopl, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Establish PBAP protocol connection from PCE client to PSE server.
Initiates a PBAP protocol connection over an already-established transport connection. The transport (RFCOMM or L2CAP) must be connected first using bt_pbap_pce_rfcomm_connect or bt_pbap_pce_l2cap_connect.
Once the connection response is received, the connect callback in bt_pbap_pce_cb will be called. If the connection is rejected, the callback will be called with an error response code.
| pbap_pce | PBAP PCE object (transport must be connected first), bt_pbap_pce. |
| mopl | Maximum OBEX packet length for this connection. |
| buf | Buffer containing connection request headers (should include Target UUID, and optionally authentication challenge, supported features, etc.). |
| struct net_buf * bt_pbap_pce_create_pdu | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf_pool * | pool ) |
#include <zephyr/bluetooth/classic/pbap.h>
Allocate buffer from pool with reserved headroom for PBAP PCE.
Allocates a network buffer from the given pool after reserving headroom for PBAP. For PBAP connection over RFCOMM, the reserved headroom includes OBEX, RFCOMM, L2CAP and ACL headers. For PBAP connection over L2CAP, the reserved headroom includes OBEX, L2CAP and ACL headers. This ensures proper packet formatting for the underlying transport. If pool is NULL, allocates from the default pool.
| pbap_pce | PBAP PCE object that will use this buffer, bt_pbap_pce. |
| pool | Network buffer pool from which to allocate the buffer, or NULL for default pool. |
| int bt_pbap_pce_disconnect | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Disconnect PBAP connection from PBAP client PCE.
Disconnects the PBAP connection by sending an OBEX DISCONNECT request. The disconnect callback in bt_pbap_pce_cb will be called when the response is received.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| buf | Buffer containing optional disconnect headers. |
| int bt_pbap_pce_l2cap_connect | ( | struct bt_conn * | conn, |
| struct bt_pbap_pce * | pbap_pce, | ||
| struct bt_pbap_pce_cb * | cb, | ||
| uint16_t | psm ) |
#include <zephyr/bluetooth/classic/pbap.h>
Connect PBAP PCE client over L2CAP transport.
Establishes the underlying L2CAP transport connection for PBAP PCE. Once connected, the l2cap_connected callback will be called. After transport is connected, call bt_pbap_pce_connect to establish the PBAP protocol connection.
| conn | ACL connection. |
| pbap_pce | PBAP PCE instance to be connected, bt_pbap_pce. |
| cb | Callback operations structure for handling PBAP events, bt_pbap_pce_cb. |
| psm | L2CAP PSM (Protocol Service Multiplexer) to connect to. |
| int bt_pbap_pce_l2cap_disconnect | ( | struct bt_pbap_pce * | pbap_pce | ) |
#include <zephyr/bluetooth/classic/pbap.h>
Disconnect PBAP PCE L2CAP transport.
Closes the underlying L2CAP transport connection.
| pbap_pce | PBAP PCE instance to disconnect, bt_pbap_pce. |
| int bt_pbap_pce_pull_phone_book | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Pull phone book from PBAP server PSE.
Sends a pull phone book command to retrieve a complete phone book object from the PSE.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| buf | Buffer to be sent. Should contain:
|
| int bt_pbap_pce_pull_vcard_entry | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Pull specific vCard entry from PBAP server PSE.
Sends a request to retrieve a specific vCard entry.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| buf | Buffer containing:
|
| int bt_pbap_pce_pull_vcard_listing | ( | struct bt_pbap_pce * | pbap_pce, |
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Pull vCard listing from PBAP server PSE.
Sends a request to retrieve a listing of vCard entries from a specific folder.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| buf | Buffer containing:
|
| int bt_pbap_pce_rfcomm_connect | ( | struct bt_conn * | conn, |
| struct bt_pbap_pce * | pbap_pce, | ||
| struct bt_pbap_pce_cb * | cb, | ||
| uint8_t | channel ) |
#include <zephyr/bluetooth/classic/pbap.h>
PCE Connect to PSE over RFCOMM transport.
Establishes the underlying RFCOMM transport connection for PBAP PCE. Once connected, the rfcomm_connected callback will be called. After transport is connected, call bt_pbap_pce_connect to establish the PBAP protocol connection.
| conn | ACL connection. |
| pbap_pce | PBAP PCE instance to be connected, bt_pbap_pce. |
| cb | Callback operations structure for handling PBAP events, bt_pbap_pce_cb. |
| channel | RFCOMM server channel number to connect to. |
| int bt_pbap_pce_rfcomm_disconnect | ( | struct bt_pbap_pce * | pbap_pce | ) |
#include <zephyr/bluetooth/classic/pbap.h>
Disconnect PBAP PCE RFCOMM transport.
Closes the underlying RFCOMM transport connection.
| pbap_pce | PBAP PCE instance to disconnect, bt_pbap_pce. |
| int bt_pbap_pce_set_phone_book | ( | struct bt_pbap_pce * | pbap_pce, |
| uint8_t | flags, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Set current phone book on PBAP server PSE.
Sets the current phone book on the PSE.
| pbap_pce | PBAP PCE object, bt_pbap_pce. |
| flags | Navigation flags:
|
| buf | Buffer containing optional Name header with folder name. |
| int bt_pbap_pse_abort_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send abort response from PBAP PSE.
Sends a response to an abort request from a PCE client.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code (typically BT_PBAP_RSP_CODE_SUCCESS), bt_pbap_rsp_code. |
| buf | Buffer containing optional response headers. |
| int bt_pbap_pse_connect_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint16_t | mopl, | ||
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send connect response from PBAP PSE.
Sends a response to a connect request from a PCE client.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| mopl | Maximum OBEX packet length. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing response headers (should include Who header, connection ID, etc.). |
| struct net_buf * bt_pbap_pse_create_pdu | ( | struct bt_pbap_pse * | pbap_pse, |
| struct net_buf_pool * | pool ) |
#include <zephyr/bluetooth/classic/pbap.h>
Allocate buffer from pool with reserved headroom for PBAP PSE.
Allocates a network buffer from the given pool after reserving headroom for PBAP. For PBAP connection over RFCOMM, the reserved headroom includes OBEX, RFCOMM, L2CAP and ACL headers. For PBAP connection over L2CAP, the reserved headroom includes OBEX, L2CAP and ACL headers. This ensures proper packet formatting for the underlying transport. If pool is NULL, allocates from the default pool.
| pbap_pse | PBAP PSE object that will use this buffer, bt_pbap_pse. |
| pool | Network buffer pool from which to allocate the buffer, or NULL for default pool. |
| int bt_pbap_pse_disconnect_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send disconnect response from PBAP PSE.
Sends a response to a disconnect request from a PCE client.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing optional response headers. |
| int bt_pbap_pse_l2cap_register | ( | struct bt_pbap_pse_l2cap * | server | ) |
#include <zephyr/bluetooth/classic/pbap.h>
Register PBAP PSE L2CAP server.
Registers a PBAP server that listens for incoming L2CAP connections. The server will be assigned an L2CAP PSM which should be advertised via SDP.
| server | PBAP PSE L2CAP server structure, bt_pbap_pse_l2cap. |
| int bt_pbap_pse_pull_phone_book_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send pull phone book response from PBAP PSE.
Sends a response to a pull phone book request from a PCE client. For large phonebooks, multiple responses with BT_PBAP_RSP_CODE_CONTINUE can be sent, followed by a final response with BT_PBAP_RSP_CODE_SUCCESS.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing response headers. |
| int bt_pbap_pse_pull_vcard_entry_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send pull vCard entry response from PBAP PSE.
Sends a response to a pull vCard entry request from a PCE client. For large vCard entries, multiple responses with BT_PBAP_RSP_CODE_CONTINUE can be sent, followed by a final response with BT_PBAP_RSP_CODE_SUCCESS.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing response headers. |
| int bt_pbap_pse_pull_vcard_listing_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send pull vCard listing response from PBAP PSE.
Sends a response to a pull vCard listing request from a PCE client. For large listings, multiple responses with BT_PBAP_RSP_CODE_CONTINUE can be sent, followed by a final response with BT_PBAP_RSP_CODE_SUCCESS.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing response headers. |
| int bt_pbap_pse_register | ( | struct bt_pbap_pse * | pbap_pse, |
| struct bt_pbap_pse_cb * | cb ) |
#include <zephyr/bluetooth/classic/pbap.h>
Register PBAP PSE instance.
Registers a PBAP PSE instance with the PBAP subsystem. This initializes the PSE object and associates it with the provided callback structure for handling PBAP server operations.
| pbap_pse | PBAP PSE object to register, bt_pbap_pse. |
| cb | Callback operations structure for PSE events, bt_pbap_pse_cb. |
| int bt_pbap_pse_rfcomm_register | ( | struct bt_pbap_pse_rfcomm * | server | ) |
#include <zephyr/bluetooth/classic/pbap.h>
Register PBAP PSE RFCOMM server.
Registers a PBAP server that listens for incoming RFCOMM connections. The server will be assigned an RFCOMM channel which should be advertised via SDP.
| server | PBAP PSE RFCOMM server structure, bt_pbap_pse_rfcomm. |
| int bt_pbap_pse_set_phone_book_rsp | ( | struct bt_pbap_pse * | pbap_pse, |
| uint8_t | rsp_code, | ||
| struct net_buf * | buf ) |
#include <zephyr/bluetooth/classic/pbap.h>
Send set phone book response from PBAP PSE.
Sends a response to a set phone book request from a PCE client.
| pbap_pse | PBAP PSE object, bt_pbap_pse. |
| rsp_code | Response code, bt_pbap_rsp_code. |
| buf | Buffer containing optional response headers. |
| int bt_pbap_verify_authentication | ( | uint8_t | nonce[BT_OBEX_CHALLENGE_TAG_NONCE_LEN], |
| uint8_t | rsp_digest[BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN], | ||
| const uint8_t * | pwd ) |
#include <zephyr/bluetooth/classic/pbap.h>
Verify authentication response.
Verifies that the received response digest matches the expected value based on the password and nonce. Used by the authenticating party to validate the authentication response.
| nonce | Nonce value that was sent in the authentication challenge (BT_OBEX_CHALLENGE_TAG_NONCE_LEN bytes). |
| rsp_digest | Response digest received from the authenticating peer (BT_OBEX_RESPONSE_TAG_REQ_DIGEST_LEN bytes). |
| pwd | Password string used for authentication (null-terminated). |