Hands Free Profile (HFP)¶
API Reference¶
- group bt_hfp
Hands Free Profile (HFP)
Functions
-
int bt_hfp_hf_register(struct bt_hfp_hf_cb *cb)¶
Register HFP HF profile.
Register Handsfree profile callbacks to monitor the state and get the required HFP details to display.
- Return
0 in case of success or negative value in case of error.
- Parameters
cb
: callback structure.
-
int bt_hfp_hf_send_cmd(struct bt_conn *conn, enum bt_hfp_hf_at_cmd cmd)¶
Handsfree client Send AT.
Send specific AT commands to handsfree client profile.
- Return
0 in case of success or negative value in case of error.
- Parameters
conn
: Connection object.cmd
: AT command to be sent.
-
struct bt_hfp_hf_cmd_complete¶
- #include <hfp_hf.h>
HFP HF Command completion field.
-
struct bt_hfp_hf_cb¶
- #include <hfp_hf.h>
HFP profile application callback.
Public Members
-
void (*connected)(struct bt_conn *conn)¶
HF connected callback to application
If this callback is provided it will be called whenever the connection completes.
- Parameters
conn
: Connection object.
-
void (*disconnected)(struct bt_conn *conn)¶
HF disconnected callback to application
If this callback is provided it will be called whenever the connection gets disconnected, including when a connection gets rejected or cancelled or any error in SLC establisment.
- Parameters
conn
: Connection object.
-
void (*service)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides service indicator value to the application
- Parameters
conn
: Connection object.value
: service indicator value received from the AG.
-
void (*call)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides call indicator value to the application
- Parameters
conn
: Connection object.value
: call indicator value received from the AG.
-
void (*call_setup)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides call setup indicator value to the application
- Parameters
conn
: Connection object.value
: call setup indicator value received from the AG.
-
void (*call_held)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides call held indicator value to the application
- Parameters
conn
: Connection object.value
: call held indicator value received from the AG.
-
void (*signal)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides signal indicator value to the application
- Parameters
conn
: Connection object.value
: signal indicator value received from the AG.
-
void (*roam)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback provides roaming indicator value to the application
- Parameters
conn
: Connection object.value
: roaming indicator value received from the AG.
-
void (*battery)(struct bt_conn *conn, uint32_t value)¶
HF indicator Callback
This callback battery service indicator value to the application
- Parameters
conn
: Connection object.value
: battery indicator value received from the AG.
-
void (*ring_indication)(struct bt_conn *conn)¶
HF incoming call Ring indication callback to application
If this callback is provided it will be called whenever there is an incoming call.
- Parameters
conn
: Connection object.
-
void (*cmd_complete_cb)(struct bt_conn *conn, struct bt_hfp_hf_cmd_complete *cmd)¶
HF notify command completed callback to application
The command sent from the application is notified about its status
- Parameters
conn
: Connection object.cmd
: structure contains status of the command including cme.
-
void (*connected)(struct bt_conn *conn)¶
-
int bt_hfp_hf_register(struct bt_hfp_hf_cb *cb)¶