[nrf fromtree] Bluetooth: AVRCP: implementation for passthrough commands

This patch alllows to send passthough command from CT to TG.

Signed-off-by: Zihao Gao <[email protected]>
(cherry picked from commit 53bba45)

Author: gzh-terry

include/zephyr/bluetooth/classic/avrcp.h

@@ -16,6 +16,99 @@
 extern "C" {
 #endif
 
+/** @brief AV/C command types */
+typedef enum __packed {
+	BT_AVRCP_CTYPE_CONTROL = 0x0,
+	BT_AVRCP_CTYPE_STATUS = 0x1,
+	BT_AVRCP_CTYPE_SPECIFIC_INQUIRY = 0x2,
+	BT_AVRCP_CTYPE_NOTIFY = 0x3,
+	BT_AVRCP_CTYPE_GENERAL_INQUIRY = 0x4,
+} bt_avrcp_ctype_t;
+
+/** @brief AV/C response codes */
+typedef enum __packed {
+	BT_AVRCP_RSP_NOT_IMPLEMENTED = 0x8,
+	BT_AVRCP_RSP_ACCEPTED = 0x9,
+	BT_AVRCP_RSP_REJECTED = 0xa,
+	BT_AVRCP_RSP_IN_TRANSITION = 0xb,
+	BT_AVRCP_RSP_IMPLEMENTED = 0xc, /**< For SPECIFIC_INQUIRY and GENERAL_INQUIRY commands */
+	BT_AVRCP_RSP_STABLE = 0xc,      /**< For STATUS commands */
+	BT_AVRCP_RSP_CHANGED = 0xd,
+	BT_AVRCP_RSP_INTERIM = 0xf,
+} bt_avrcp_rsp_t;
+
+/** @brief AV/C operation ids used in AVRCP passthrough commands */
+typedef enum __packed {
+	BT_AVRCP_OPID_SELECT = 0x00,
+	BT_AVRCP_OPID_UP = 0x01,
+	BT_AVRCP_OPID_DOWN = 0x02,
+	BT_AVRCP_OPID_LEFT = 0x03,
+	BT_AVRCP_OPID_RIGHT = 0x04,
+	BT_AVRCP_OPID_RIGHT_UP = 0x05,
+	BT_AVRCP_OPID_RIGHT_DOWN = 0x06,
+	BT_AVRCP_OPID_LEFT_UP = 0x07,
+	BT_AVRCP_OPID_LEFT_DOWN = 0x08,
+	BT_AVRCP_OPID_ROOT_MENU = 0x09,
+	BT_AVRCP_OPID_SETUP_MENU = 0x0a,
+	BT_AVRCP_OPID_CONTENTS_MENU = 0x0b,
+	BT_AVRCP_OPID_FAVORITE_MENU = 0x0c,
+	BT_AVRCP_OPID_EXIT = 0x0d,
+
+	BT_AVRCP_OPID_0 = 0x20,
+	BT_AVRCP_OPID_1 = 0x21,
+	BT_AVRCP_OPID_2 = 0x22,
+	BT_AVRCP_OPID_3 = 0x23,
+	BT_AVRCP_OPID_4 = 0x24,
+	BT_AVRCP_OPID_5 = 0x25,
+	BT_AVRCP_OPID_6 = 0x26,
+	BT_AVRCP_OPID_7 = 0x27,
+	BT_AVRCP_OPID_8 = 0x28,
+	BT_AVRCP_OPID_9 = 0x29,
+	BT_AVRCP_OPID_DOT = 0x2a,
+	BT_AVRCP_OPID_ENTER = 0x2b,
+	BT_AVRCP_OPID_CLEAR = 0x2c,
+
+	BT_AVRCP_OPID_CHANNEL_UP = 0x30,
+	BT_AVRCP_OPID_CHANNEL_DOWN = 0x31,
+	BT_AVRCP_OPID_PREVIOUS_CHANNEL = 0x32,
+	BT_AVRCP_OPID_SOUND_SELECT = 0x33,
+	BT_AVRCP_OPID_INPUT_SELECT = 0x34,
+	BT_AVRCP_OPID_DISPLAY_INFORMATION = 0x35,
+	BT_AVRCP_OPID_HELP = 0x36,
+	BT_AVRCP_OPID_PAGE_UP = 0x37,
+	BT_AVRCP_OPID_PAGE_DOWN = 0x38,
+
+	BT_AVRCP_OPID_POWER = 0x40,
+	BT_AVRCP_OPID_VOLUME_UP = 0x41,
+	BT_AVRCP_OPID_VOLUME_DOWN = 0x42,
+	BT_AVRCP_OPID_MUTE = 0x43,
+	BT_AVRCP_OPID_PLAY = 0x44,
+	BT_AVRCP_OPID_STOP = 0x45,
+	BT_AVRCP_OPID_PAUSE = 0x46,
+	BT_AVRCP_OPID_RECORD = 0x47,
+	BT_AVRCP_OPID_REWIND = 0x48,
+	BT_AVRCP_OPID_FAST_FORWARD = 0x49,
+	BT_AVRCP_OPID_EJECT = 0x4a,
+	BT_AVRCP_OPID_FORWARD = 0x4b,
+	BT_AVRCP_OPID_BACKWARD = 0x4c,
+
+	BT_AVRCP_OPID_ANGLE = 0x50,
+	BT_AVRCP_OPID_SUBPICTURE = 0x51,
+
+	BT_AVRCP_OPID_F1 = 0x71,
+	BT_AVRCP_OPID_F2 = 0x72,
+	BT_AVRCP_OPID_F3 = 0x73,
+	BT_AVRCP_OPID_F4 = 0x74,
+	BT_AVRCP_OPID_F5 = 0x75,
+	BT_AVRCP_OPID_VENDOR_UNIQUE = 0x7e,
+} bt_avrcp_opid_t;
+
+/** @brief AVRCP button state flag */
+typedef enum __packed {
+	BT_AVRCP_BUTTON_PRESSED = 0,
+	BT_AVRCP_BUTTON_RELEASED = 1,
+} bt_avrcp_button_state_t;
+
 /** @brief AVRCP structure */
 struct bt_avrcp;
 
@@ -28,7 +121,15 @@ struct bt_avrcp_subunit_info_rsp {
 	uint8_t subunit_type;
 	uint8_t max_subunit_id;
 	const uint8_t *extended_subunit_type; /**< contains max_subunit_id items */
-	const uint8_t *extended_subunit_id; /**< contains max_subunit_id items */
+	const uint8_t *extended_subunit_id;   /**< contains max_subunit_id items */
+};
+
+struct bt_avrcp_passthrough_rsp {
+	uint8_t response;     /**< bt_avrcp_rsp_t */
+	uint8_t operation_id; /**< bt_avrcp_opid_t */
+	uint8_t state;        /**< bt_avrcp_button_state_t */
+	uint8_t len;
+	const uint8_t *payload;
 };
 
 struct bt_avrcp_cb {
@@ -40,6 +141,7 @@ struct bt_avrcp_cb {
 	 *  @param avrcp AVRCP connection object.
 	 */
 	void (*connected)(struct bt_avrcp *avrcp);
+
 	/** @brief An AVRCP connection has been disconnected.
 	 *
 	 *  This callback notifies the application that an avrcp connection
@@ -48,6 +150,7 @@ struct bt_avrcp_cb {
 	 *  @param avrcp AVRCP connection object.
 	 */
 	void (*disconnected)(struct bt_avrcp *avrcp);
+
 	/** @brief Callback function for bt_avrcp_get_unit_info().
 	 *
 	 *  Called when the get unit info process is completed.
@@ -56,6 +159,7 @@ struct bt_avrcp_cb {
 	 *  @param rsp The response for UNIT INFO command.
 	 */
 	void (*unit_info_rsp)(struct bt_avrcp *avrcp, struct bt_avrcp_unit_info_rsp *rsp);
+
 	/** @brief Callback function for bt_avrcp_get_subunit_info().
 	 *
 	 *  Called when the get subunit info process is completed.
@@ -64,6 +168,15 @@ struct bt_avrcp_cb {
 	 *  @param rsp The response for SUBUNIT INFO command.
 	 */
 	void (*subunit_info_rsp)(struct bt_avrcp *avrcp, struct bt_avrcp_subunit_info_rsp *rsp);
+
+	/** @brief Callback function for bt_avrcp_passthrough().
+	 *
+	 *  Called when a passthrough response is received.
+	 *
+	 *  @param avrcp AVRCP connection object.
+	 *  @param rsp The response for PASS THROUGH command.
+	 */
+	void (*passthrough_rsp)(struct bt_avrcp *avrcp, struct bt_avrcp_passthrough_rsp *rsp);
 };
 
 /** @brief Connect AVRCP.
@@ -120,6 +233,22 @@ int bt_avrcp_get_unit_info(struct bt_avrcp *avrcp);
  */
 int bt_avrcp_get_subunit_info(struct bt_avrcp *avrcp);
 
+/** @brief Send AVRCP Pass Through command.
+ *
+ *  This function send a pass through command to the remote device. Passsthhrough command is used
+ *  to transfer user operation information from a CT to Panel subunit of TG.
+ *
+ *  @param avrcp The AVRCP instance.
+ *  @param operation_id The user operation id.
+ *  @param state The button state.
+ *  @param payload The payload of the pass through command. Should not be NULL if len is not zero.
+ *  @param len The length of the payload.
+ *
+ *  @return 0 in case of success or error code in case of error.
+ */
+int bt_avrcp_passthrough(struct bt_avrcp *avrcp, bt_avrcp_opid_t operation_id,
+			 bt_avrcp_button_state_t state, const uint8_t *payload, uint8_t len);
+
 #ifdef __cplusplus
 }
 #endif

subsys/bluetooth/host/classic/avctp.c

@@ -82,6 +82,7 @@ static int avctp_l2cap_recv(struct bt_l2cap_chan *chan, struct net_buf *buf)
 	uint8_t tid;
 	bt_avctp_pkt_type_t pkt_type;
 	bt_avctp_cr_t cr;
+	int err;
 
 	if (buf->len < sizeof(*hdr)) {
 		LOG_ERR("invalid AVCTP header received");
@@ -117,7 +118,13 @@ static int avctp_l2cap_recv(struct bt_l2cap_chan *chan, struct net_buf *buf)
 			if (!rsp) {
 				return -ENOMEM;
 			}
-			return bt_avctp_send(session, rsp);
+
+			err = bt_avctp_send(session, rsp);
+			if (err < 0) {
+				net_buf_unref(rsp);
+				LOG_ERR("AVCTP send fail, err = %d", err);
+				return err;
+			}
 		}
 		return 0; /* No need to report to the upper layer */
 	}
@@ -189,16 +196,7 @@ struct net_buf *bt_avctp_create_pdu(struct bt_avctp *session, bt_avctp_cr_t cr,
 
 int bt_avctp_send(struct bt_avctp *session, struct net_buf *buf)
 {
-	int err;
-
-	err = bt_l2cap_chan_send(&session->br_chan.chan, buf);
-	if (err < 0) {
-		net_buf_unref(buf);
-		LOG_ERR("L2CAP send fail err = %d", err);
-		return err;
-	}
-
-	return err;
+	return bt_l2cap_chan_send(&session->br_chan.chan, buf);
 }
 
 int bt_avctp_register(const struct bt_avctp_event_cb *cb)