Bluetooth: HFP_AG: Send subscriber number info

Handle AT command `AT+CNUM`.

Add a callback function `subscriber_number` to notify the upper layer
that the HF needs to get subscriber number information from the AG.

If there is subscriber number information needs to be sent, the passed
function `bt_hfp_ag_query_subscriber_func_t func` can be called for
this purpose.

Signed-off-by: Lyle Zhu <[email protected]>

Author: lylezhu2012

include/zephyr/bluetooth/classic/hfp_ag.h

@@ -44,6 +44,33 @@ enum bt_hfp_ag_indicator {
 struct bt_hfp_ag;
 struct bt_hfp_ag_call;
 
+/** @typedef bt_hfp_ag_query_subscriber_func_t
+ *  @brief Query subscriber number callback function
+ *
+ *  When AG wants to send subscriber number information, all information
+ *  will be passed through the callback. And the subscriber number
+ *  information will be sent out in this function.
+ *
+ *  @param ag HFP AG object.
+ *  @param number Subscriber number.
+ *  @param type Type of subscriber number specifies the format of the phone number provided,
+ *              and can be one of the following values:
+ *              - values 128-143: The phone number format may be a national or international
+ *                format, and may contain prefix and/or escape digits. No changes on the number
+ *                presentation are required.
+ *              - values 144-159: The phone number format is an international number, including
+ *                the country code prefix. If the plus sign ("+") is not included as part of the
+ *                number and shall be added by the AG as needed.
+ *              - values 160-175: National number. No prefix nor escape digits included.
+ *  @param service Service of subscriber number indicates which service this phone number relates
+ *                 to. Shall be either 4 (voice) or 5 (fax).
+ *
+ *  @return 0 if should continue to the next subscriber number information.
+ *  @return negative value to stop.
+ */
+typedef int (*bt_hfp_ag_query_subscriber_func_t)(struct bt_hfp_ag *ag, char *number, uint8_t type,
+						 uint8_t service);
+
 /** @brief HFP profile AG application callback */
 struct bt_hfp_ag_cb {
 	/** HF AG connected callback to application
@@ -349,6 +376,18 @@ struct bt_hfp_ag_cb {
 	 *  @param code A specific DTMF code.
 	 */
 	void (*transmit_dtmf_code)(struct bt_hfp_ag *ag, char code);
+
+	/** Get subscriber number callback
+	 *
+	 *  If this callback is provided it will be called whenever the
+	 *  AT command `AT+CNUM` is received.
+	 *
+	 *  @param ag HFP AG object.
+	 *  @param func Query subscriber number callback.
+	 *
+	 *  @return 0 in case of success or negative value in case of error.
+	 */
+	int (*subscriber_number)(struct bt_hfp_ag *ag, bt_hfp_ag_query_subscriber_func_t func);
 };
 
 /** @brief Register HFP AG profile

subsys/bluetooth/host/classic/hfp_ag.c

@@ -3046,6 +3046,35 @@ static int bt_hfp_ag_vts_handler(struct bt_hfp_ag *ag, struct net_buf *buf)
 	return 0;
 }
 
+static int send_subscriber_number(struct bt_hfp_ag *ag, char *number,
+		uint8_t type, uint8_t service)
+{
+	int err;
+
+	err = hfp_ag_send_data(ag, NULL, NULL, "\r\n+CNUM:,\"%s\",%d,,%d\r\n",
+		number, type, service);
+	if (err) {
+		LOG_ERR("Fail to send subscriber number :(%d)", err);
+	}
+	return err;
+}
+
+static int bt_hfp_ag_cnum_handler(struct bt_hfp_ag *ag, struct net_buf *buf)
+{
+	int err;
+
+	if (!is_char(buf, '\r')) {
+		return -ENOTSUP;
+	}
+
+	if (bt_ag && bt_ag->subscriber_number) {
+		err = bt_ag->subscriber_number(ag, send_subscriber_number);
+		return err;
+	}
+
+	return 0;
+}
+
 static struct bt_hfp_ag_at_cmd_handler cmd_handlers[] = {
 	{"AT+BRSF", bt_hfp_ag_brsf_handler}, {"AT+BAC", bt_hfp_ag_bac_handler},
 	{"AT+CIND", bt_hfp_ag_cind_handler}, {"AT+CMER", bt_hfp_ag_cmer_handler},
@@ -3059,7 +3088,7 @@ static struct bt_hfp_ag_at_cmd_handler cmd_handlers[] = {
 	{"AT+VGS", bt_hfp_ag_vgs_handler},   {"AT+NREC", bt_hfp_ag_nrec_handler},
 	{"AT+BTRH", bt_hfp_ag_btrh_handler}, {"AT+CCWA", bt_hfp_ag_ccwa_handler},
 	{"AT+BVRA", bt_hfp_ag_bvra_handler}, {"AT+BINP", bt_hfp_ag_binp_handler},
-	{"AT+VTS", bt_hfp_ag_vts_handler},
+	{"AT+VTS", bt_hfp_ag_vts_handler},   {"AT+CNUM", bt_hfp_ag_cnum_handler},
 };
 
 static void hfp_ag_connected(struct bt_rfcomm_dlc *dlc)