drivers: i3c: add helper for if target is controller capable

Add the function, i3c_device_is_controller_capable, to determine if
a target is controller capable.

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

Author: XenuIsWatching

drivers/i3c/i3c_common.c

@@ -670,8 +670,7 @@ bool i3c_bus_has_sec_controller(const struct device *dev)
 	SYS_SLIST_FOR_EACH_NODE(&data->attached_dev.devices.i3c, node) {
 		struct i3c_device_desc *i3c_desc = CONTAINER_OF(node, struct i3c_device_desc, node);
 
-		if (I3C_BCR_DEVICE_ROLE(i3c_desc->bcr) ==
-		    I3C_BCR_DEVICE_ROLE_I3C_CONTROLLER_CAPABLE) {
+		if (i3c_device_is_controller_capable(i3c_desc)) {
 			return true;
 		}
 	}

include/zephyr/drivers/i3c.h

@@ -1762,6 +1762,23 @@ static inline int i3c_device_is_ibi_capable(struct i3c_device_desc *target)
 		== I3C_BCR_IBI_REQUEST_CAPABLE;
 }
 
+/**
+ * @brief Check if the target is controller capable
+ *
+ * This reads the BCR from the device descriptor struct to determine
+ * whether the target is controller capable
+ *
+ * Note that BCR must have been obtained from device and
+ * i3c_device_desc::bcr must be set.
+ *
+ * @return True if target is controller capable, false otherwise.
+ */
+static inline int i3c_device_is_controller_capable(struct i3c_device_desc *target)
+{
+	return I3C_BCR_DEVICE_ROLE(target->bcr)
+		== I3C_BCR_DEVICE_ROLE_I3C_CONTROLLER_CAPABLE;
+}
+
 /** @} */
 
 /**
@@ -2089,6 +2106,8 @@ int i3c_device_basic_info_get(struct i3c_device_desc *target);
  * This reads the BCR from the device descriptor struct of all targets
  * to determine whether a device is a secondary controller.
  *
+ * @param dev Pointer to controller device driver instance.
+ *
  * @return True if the bus has a secondary controller, false otherwise.
  */
 bool i3c_bus_has_sec_controller(const struct device *dev);