drivers: i3c: add ibi hj reponse api

Add an api to ack or nack ibi hj requests.

Signed-off-by: Ryan McClelland <[email protected]>

Author: XenuIsWatching

include/zephyr/drivers/i3c.h

@@ -769,6 +769,19 @@ __subsystem struct i3c_driver_api {
 	struct i3c_device_desc *(*i3c_device_find)(const struct device *dev,
 						   const struct i3c_device_id *id);
 
+	/**
+	 * ACK or NACK IBI HJ Requests
+	 *
+	 * @see ibi_hj_response()
+	 *
+	 * @param dev Pointer to controller device driver instance.
+	 * @param ack True to ack, False to nack
+	 *
+	 * @return See ibi_hj_response()
+	 */
+	int (*ibi_hj_response)(const struct device *dev,
+			       bool ack);
+
 	/**
 	 * Raise In-Band Interrupt (IBI).
 	 *
@@ -1675,6 +1688,31 @@ struct i3c_device_desc *i3c_device_find(const struct device *dev,
  * @{
  */
 
+/**
+ * @brief ACK or NACK IBI HJ Requests
+ *
+ * This tells the controller to Acknowledge or Not Acknowledge
+ * In-Band Interrupt Hot-Join Requests.
+ *
+ * @param dev Pointer to controller device driver instance.
+ * @param ack True to ack, False to nack
+ *
+ * @retval 0 if operation is successful.
+ * @retval -EIO General input / output error.
+ */
+static inline int i3c_ibi_hj_response(const struct device *dev,
+				      bool ack)
+{
+	const struct i3c_driver_api *api =
+		(const struct i3c_driver_api *)dev->api;
+
+	if (api->ibi_hj_response == NULL) {
+		return -ENOSYS;
+	}
+
+	return api->ibi_hj_response(dev, ack);
+}
+
 /**
  * @brief Raise an In-Band Interrupt (IBI).
  *