Skip to contentSkip to conversation

Add bridged amplifiers to cs42l43

PATCH New Charles Keepax 2 participants 14 messages Mar 29, 2024 – Apr 9, 2024

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

cover Add bridged amplifiers to cs42l43

On some cs42l43 systems a couple of cs35l56 amplifiers are attached to the cs42l43's SPI and I2S. On Windows the cs42l43 is controlled by a SDCA class driver and these two amplifiers are controlled by firmware running on the cs42l43. However, under Linux the decision was made to interact with the cs42l43 directly, affording the user greater control over the audio system. However, this has resulted in an issue where these two bridged cs35l56 amplifiers are not populated in ACPI and must be added manually. There is at least an SDCA extension unit DT entry we can key off.

The process of adding this is handled using a software node, firstly the ability to add native chip selects to software nodes must be added. Secondly, an additional flag for naming the SPI devices is added this allows the machine driver to key to the correct amplifier. Then finally, the cs42l43 SPI driver adds the two amplifiers directly onto its SPI bus.

An additional series will follow soon to add the audio machine driver parts (in the sof-sdw driver), however that is fairly orthogonal to this part of the process, getting the actual amplifiers registered.

Thanks,
Charles

Series changes since v2:
- Add missing fwnode_handle_puts in driver/spi/spi-cs423l43.c

Series changes since v1:
- Add missing statics in driver/spi/spi-cs42l43.c

Charles Keepax (2):
gpio: swnode: Add ability to specify native chip selects for SPI
spi: Add a mechanism to use the fwnode name for the SPI device

Maciej Strozek (1):
spi: cs42l43: Add bridged cs35l56 amplifiers

 drivers/gpio/gpiolib-swnode.c |   8 ++
 drivers/gpio/gpiolib.c        |   9 ++
 drivers/spi/spi-cs42l43.c     | 155 +++++++++++++++++++++++++++++++++-
 drivers/spi/spi.c             |   7 ++
 include/linux/gpio/consumer.h |   4 +
 include/linux/spi/spi.h       |   2 +
 6 files changed, 184 insertions(+), 1 deletion(-)
Signature · 1 line
2.39.2
#1 lore raw

PATCH v3 1/3 gpio: swnode: Add ability to specify native chip selects for SPI

SPI devices can specify a cs-gpios property to enumerate their chip selects. Under device tree, a zero entry in this property can be used to specify that a particular chip select is using the SPI controllers native chip select, for example:

        cs-gpios = <&gpio1 0 0>, <0>;

Here the second chip select is native. However, when using swnodes there is currently no way to specify a native chip select. The proposal here is to register a swnode_gpio_undefined software node, that can be specified to allow the indication of a native chip select. For example:

static const struct software_node_ref_args device_cs_refs[] = {
	{
		.node  = &device_gpiochip_swnode,
		.nargs = 2,
		.args  = { 0, GPIO_ACTIVE_LOW },
	},
	{
		.node  = &swnode_gpio_undefined,
		.nargs = 0,
	},
};

Register the swnode as the gpiolib is initialised and check in swnode_get_gpio_device if the returned node matches swnode_gpio_undefined and return -ENOENT, which matches the behaviour of the device tree system when it encounters a 0 phandle.

---

No changes since v2.

Thanks,
Charles

 drivers/gpio/gpiolib-swnode.c | 8 ++++++++
 drivers/gpio/gpiolib.c        | 9 +++++++++
 include/linux/gpio/consumer.h | 4 ++++
 3 files changed, 21 insertions(+)
drivers/gpio/gpiolib-swnode.c +8 -0
index fa52bdb1a29a3..801b5a660307f 100644
@@ -17,6 +17,11 @@
 #include "gpiolib.h"
 #include "gpiolib-swnode.h"
 
+const struct software_node swnode_gpio_undefined = {
+	.name = "gpio-internal-undefined",
+};
+EXPORT_SYMBOL_GPL(swnode_gpio_undefined);
+
 static void swnode_format_propname(const char *con_id, char *propname,
 				   size_t max_size)
 {
@@ -40,6 +45,9 @@ static struct gpio_device *swnode_get_gpio_device(struct fwnode_handle *fwnode)
 	if (!gdev_node || !gdev_node->name)
 		return ERR_PTR(-EINVAL);
 
+	if (!strcmp(gdev_node->name, "gpio-internal-undefined"))
+		return ERR_PTR(-ENOENT);
+
 	gdev = gpio_device_find_by_label(gdev_node->name);
 	return gdev ?: ERR_PTR(-EPROBE_DEFER);
 }
drivers/gpio/gpiolib.c +9 -0
index ce94e37bcbee7..e3a7e2a3a323e 100644
@@ -4892,8 +4892,17 @@ DEFINE_SEQ_ATTRIBUTE(gpiolib);
 
 static int __init gpiolib_debugfs_init(void)
 {
+	int ret;
+
+	ret = software_node_register(&swnode_gpio_undefined);
+	if (ret < 0) {
+		pr_err("gpiolib: failed to register swnode: %d\n", ret);
+		return ret;
+	}
+
 	/* /sys/kernel/debug/gpio */
 	debugfs_create_file("gpio", 0444, NULL, NULL, &gpiolib_fops);
+
 	return 0;
 }
 subsys_initcall(gpiolib_debugfs_init);
include/linux/gpio/consumer.h +4 -0
index db2dfbae8edbd..e685fac43398d 100644
@@ -12,6 +12,8 @@ struct fwnode_handle;
 struct gpio_array;
 struct gpio_desc;
 
+struct software_node;
+
 /**
  * struct gpio_descs - Struct containing an array of descriptors that can be
  *                     obtained using gpiod_get_array()
@@ -54,6 +56,8 @@ enum gpiod_flags {
 	GPIOD_OUT_HIGH_OPEN_DRAIN = GPIOD_OUT_HIGH | GPIOD_FLAGS_BIT_OPEN_DRAIN,
 };
 
+extern const struct software_node swnode_gpio_undefined;
+
 #ifdef CONFIG_GPIOLIB
 
 /* Return the number of GPIOs associated with a device / function */
Signature · 1 line
2.39.2
#2 lore raw

Re: [PATCH v3 1/3] gpio: swnode: Add ability to specify native chip selects for SPI

Fri, Mar 29, 2024 at 11:47:28AM +0000, Charles Keepax kirjoitti:

Quoted 29 lines

SPI devices can specify a cs-gpios property to enumerate their chip selects. Under device tree, a zero entry in this property can be used to specify that a particular chip select is using the SPI controllers native chip select, for example:

        cs-gpios = <&gpio1 0 0>, <0>;

Here the second chip select is native. However, when using swnodes there is currently no way to specify a native chip select. The proposal here is to register a swnode_gpio_undefined software node, that can be specified to allow the indication of a native chip select. For example:

static const struct software_node_ref_args device_cs_refs[] = {
	{
		.node  = &device_gpiochip_swnode,
		.nargs = 2,
		.args  = { 0, GPIO_ACTIVE_LOW },
	},
	{
		.node  = &swnode_gpio_undefined,
		.nargs = 0,
	},
};

Register the swnode as the gpiolib is initialised and check in swnode_get_gpio_device if the returned node matches swnode_gpio_undefined and return -ENOENT, which matches the behaviour of the device tree system when it encounters a 0 phandle.

...

drivers/gpio/gpiolib-swnode.c line 21

Quoted 2 lines
drivers/gpio/gpiolib-swnode.c +2 -0
+const struct software_node swnode_gpio_undefined = {
+	.name = "gpio-internal-undefined",

This name is still too generic, perhaps "software-node-undefined-gpio"?

drivers/gpio/gpiolib-swnode.c line 23

Quoted 2 lines
drivers/gpio/gpiolib-swnode.c +2 -0
+};
+EXPORT_SYMBOL_GPL(swnode_gpio_undefined);

Maybe we can start using namespaces?

...

drivers/gpio/gpiolib-swnode.c static struct gpio_device *swnode_get_gpio_device(struct fwnode_handle *fwnode) · line 48

Quoted 1 line
drivers/gpio/gpiolib-swnode.c +1 -0
+	if (!strcmp(gdev_node->name, "gpio-internal-undefined"))

Probably it needs a definition to avoid typos in case somebody wants to change the name.

#define GPIOLIB_SWNODE_UNDEFINED "..."

?

Quoted 1 line
drivers/gpio/gpiolib-swnode.c +1 -0
+		return ERR_PTR(-ENOENT);

...

Quoted 6 lines

static int __init gpiolib_debugfs_init(void)
{

drivers/gpio/gpiolib.c +4 -0
+	int ret;
+
+	ret = software_node_register(&swnode_gpio_undefined);
+	if (ret < 0) {

drivers/gpio/gpiolib.c DEFINE_SEQ_ATTRIBUTE(gpiolib); · line 4908

Quoted 10 lines
drivers/gpio/gpiolib.c +5 -0
+		pr_err("gpiolib: failed to register swnode: %d\n", ret);
+		return ret;
+	}
+
 	/* /sys/kernel/debug/gpio */
 	debugfs_create_file("gpio", 0444, NULL, NULL, &gpiolib_fops);
+
 	return 0;
 }
 subsys_initcall(gpiolib_debugfs_init);

I believe now it's time to get __exitcall to be implemented. Actually the above already needs that. Besides that, what you are adding doesn't belong to debugfs AFAICS. And why it can't be done in gpiolib-swnode.c?

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#3 lore raw

PATCH v3 2/3 spi: Add a mechanism to use the fwnode name for the SPI device

In reply to Charles Keepax

Add a mechanism to force the use of the fwnode name for the name of the SPI device itself. This is useful when devices need to be manually added within the kernel.

---

No changes since v2.

Thanks,
Charles

 drivers/spi/spi.c       | 7 +++++++
 include/linux/spi/spi.h | 2 ++
 2 files changed, 9 insertions(+)
drivers/spi/spi.c +7 -0
index a2f01116ba092..a38a4960032b8 100644
@@ -598,6 +598,12 @@ EXPORT_SYMBOL_GPL(spi_alloc_device);
 static void spi_dev_set_name(struct spi_device *spi)
 {
 	struct acpi_device *adev = ACPI_COMPANION(&spi->dev);
+	struct fwnode_handle *fwnode = dev_fwnode(&spi->dev);
+
+	if (spi->use_fwnode_name && fwnode) {
+		dev_set_name(&spi->dev, "spi-%s", fwnode_get_name(fwnode));
+		return;
+	}
 
 	if (adev) {
 		dev_set_name(&spi->dev, "spi-%s", acpi_dev_name(adev));
@@ -830,6 +836,7 @@ struct spi_device *spi_new_device(struct spi_controller *ctlr,
 	 * spi->cs_index_mask as 0x01.
 	 */
 	proxy->cs_index_mask = 0x01;
+	proxy->use_fwnode_name = chip->use_fwnode_name;
 
 	if (chip->swnode) {
 		status = device_add_software_node(&proxy->dev, chip->swnode);
include/linux/spi/spi.h +2 -0
index b589e25474393..265f5d0c15304 100644
@@ -222,6 +222,7 @@ struct spi_device {
 	struct spi_delay	cs_setup;
 	struct spi_delay	cs_hold;
 	struct spi_delay	cs_inactive;
+	bool			use_fwnode_name;
 
 	/* The statistics */
 	struct spi_statistics __percpu	*pcpu_statistics;
@@ -1603,6 +1604,7 @@ struct spi_board_info {
 	char		modalias[SPI_NAME_SIZE];
 	const void	*platform_data;
 	const struct software_node *swnode;
+	bool		use_fwnode_name;
 	void		*controller_data;
 	int		irq;
 
Signature · 1 line
2.39.2
#4 lore raw

Re: [PATCH v3 2/3] spi: Add a mechanism to use the fwnode name for the SPI device

Fri, Mar 29, 2024 at 11:47:29AM +0000, Charles Keepax kirjoitti:

Quoted 3 lines

Add a mechanism to force the use of the fwnode name for the name of the SPI device itself. This is useful when devices need to be manually added within the kernel.

...

drivers/spi/spi.c EXPORT_SYMBOL_GPL(spi_alloc_device); · line 609

Quoted 12 lines

static void spi_dev_set_name(struct spi_device *spi) {

drivers/spi/spi.c +6 -0
 	struct acpi_device *adev = ACPI_COMPANION(&spi->dev);
+	struct fwnode_handle *fwnode = dev_fwnode(&spi->dev);
+
+	if (spi->use_fwnode_name && fwnode) {
+		dev_set_name(&spi->dev, "spi-%s", fwnode_get_name(fwnode));
+		return;
+	}
 
 	if (adev) {
 		dev_set_name(&spi->dev, "spi-%s", acpi_dev_name(adev));

This should be something like this

	struct device *dev = &spi->dev;
	struct fwnode_handle *fwnode = dev_fwnode(dev);

	if (is_acpi_device_node(fwnode)) {
		dev_set_name(dev, "spi-%s", acpi_dev_name(to_acpi_device_node(fwnode)));
		return;
	}

	if (is_software_node(fwnode)) {
		dev_set_name(dev, "spi-%s", fwnode_get_name(fwnode));
		return;
	}

i.o.w. we don't need to have two ways of checking fwnode type and you may get rid of unneeded variable, and always use fwnode name for swnode.

...

drivers/spi/spi.c struct spi_device *spi_new_device(struct spi_controller *ctlr, · line 839

Quoted 1 line
drivers/spi/spi.c +1 -0
+	proxy->use_fwnode_name = chip->use_fwnode_name;

Unneeded variable. See above.

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#5 lore raw

Re: [PATCH v3 2/3] spi: Add a mechanism to use the fwnode name for the SPI device

Quoted 27 lines · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:29AM +0000, Charles Keepax kirjoitti:

drivers/spi/spi.c EXPORT_SYMBOL_GPL(spi_alloc_device); · line 609

Quoted 10 lines
drivers/spi/spi.c +6 -0
 	struct acpi_device *adev = ACPI_COMPANION(&spi->dev);
+	struct fwnode_handle *fwnode = dev_fwnode(&spi->dev);
+
+	if (spi->use_fwnode_name && fwnode) {
+		dev_set_name(&spi->dev, "spi-%s", fwnode_get_name(fwnode));
+		return;
+	}
 
 	if (adev) {
 		dev_set_name(&spi->dev, "spi-%s", acpi_dev_name(adev));

This should be something like this

	struct device *dev = &spi->dev;
	struct fwnode_handle *fwnode = dev_fwnode(dev);

	if (is_acpi_device_node(fwnode)) {
		dev_set_name(dev, "spi-%s", acpi_dev_name(to_acpi_device_node(fwnode)));
		return;
	}

	if (is_software_node(fwnode)) {
		dev_set_name(dev, "spi-%s", fwnode_get_name(fwnode));
		return;
	}
Quoted 9 lines

i.o.w. we don't need to have two ways of checking fwnode type and you may get rid of unneeded variable, and always use fwnode name for swnode.

...

drivers/spi/spi.c struct spi_device *spi_new_device(struct spi_controller *ctlr, · line 839

Quoted 1 line
drivers/spi/spi.c +1 -0
+	proxy->use_fwnode_name = chip->use_fwnode_name;

Unneeded variable. See above.

Hmm... I guess I was viewing this feature more as something that users would opt into. So other firmware mechanisms could use it if required, and so most swnode based controllers would still get caught by the standard naming at the bottom of the function.

From my perspective it will do what I need either way, so happy to update it to always use this for software nodes if consensus goes that way.

Thanks,
Charles

#6 lore raw

Re: [PATCH v3 2/3] spi: Add a mechanism to use the fwnode name for the SPI device

Quoted 2 lines · Charles Keepax
Quoted 1 line · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:29AM +0000, Charles Keepax kirjoitti:

...

Quoted 31 lines
Quoted 31 lines

drivers/spi/spi.c EXPORT_SYMBOL_GPL(spi_alloc_device); · line 609

Quoted 10 lines
    struct acpi_device *adev = ACPI_COMPANION(&spi->dev);
drivers/spi/spi.c +6 -0
+   struct fwnode_handle *fwnode = dev_fwnode(&spi->dev);
+
+   if (spi->use_fwnode_name && fwnode) {
+           dev_set_name(&spi->dev, "spi-%s", fwnode_get_name(fwnode));
+           return;
+   }
 
    if (adev) {
            dev_set_name(&spi->dev, "spi-%s", acpi_dev_name(adev));

This should be something like this

      struct device *dev = &spi->dev;
      struct fwnode_handle *fwnode = dev_fwnode(dev);

      if (is_acpi_device_node(fwnode)) {
              dev_set_name(dev, "spi-%s", acpi_dev_name(to_acpi_device_node(fwnode)));
              return;
      }

      if (is_software_node(fwnode)) {
              dev_set_name(dev, "spi-%s", fwnode_get_name(fwnode));
              return;
      }

i.o.w. we don't need to have two ways of checking fwnode type and you may get rid of unneeded variable, and always use fwnode name for swnode.

...

Quoted 8 lines
Quoted 3 lines
Quoted 1 line

+ proxy->use_fwnode_name = chip->use_fwnode_name;

Unneeded variable. See above.

Hmm... I guess I was viewing this feature more as something that users would opt into. So other firmware mechanisms could use it if required, and so most swnode based controllers would still get caught by the standard naming at the bottom of the function.

software nodes can be used as a trampoline for old board files (in order to make the driver cleaner and prepared for DT conversion of the board file in question) or for quirks. In either case when we use them we really want to have their data to be propagated unconditionally (just based on the type), the (per-subsystem) gate is a carefully placed mine on the minefield.

Quoted 3 lines

From my perspective it will do what I need either way, so happy to update it to always use this for software nodes if consensus goes that way.

Not a maintainer here, ask Mark.

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#7 lore raw

PATCH v3 3/3 spi: cs42l43: Add bridged cs35l56 amplifiers

In reply to Charles Keepax

From: Maciej Strozek <[email protected]>

On some cs42l43 systems a couple of cs35l56 amplifiers are attached to the cs42l43's SPI and I2S. On Windows the cs42l43 is controlled by a SDCA class driver and these two amplifiers are controlled by firmware running on the cs42l43. However, under Linux the decision was made to interact with the cs42l43 directly, affording the user greater control over the audio system. However, this has resulted in an issue where these two bridged cs35l56 amplifiers are not populated in ACPI and must be added manually.

Check for the presence of the "01fa-cirrus-sidecar-instances" property in the SDCA extension unit's ACPI properties to confirm the presence of these two amplifiers and if they exist add them manually onto the SPI bus.

---

Changes since v2:
- Add missing fwnode_handle_puts in cs42l43_has_sidecar

Thanks,
Charles

 drivers/spi/spi-cs42l43.c | 155 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 154 insertions(+), 1 deletion(-)
drivers/spi/spi-cs42l43.c +154 -1
index aabef9fc84bdf..15e93ef7b74d0 100644
@@ -5,6 +5,8 @@
 // Copyright (C) 2022-2023 Cirrus Logic, Inc. and
 //                         Cirrus Logic International Semiconductor Ltd.
 
+#include <dt-bindings/gpio/gpio.h>
+#include <linux/acpi.h>
 #include <linux/bits.h>
 #include <linux/bitfield.h>
 #include <linux/device.h>
@@ -39,6 +41,59 @@ static const unsigned int cs42l43_clock_divs[] = {
 	2, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30
 };
 
+static const struct software_node ampl = {
+	.name			= "cs35l56-left",
+};
+
+static const struct software_node ampr = {
+	.name			= "cs35l56-right",
+};
+
+static struct spi_board_info ampl_info = {
+	.modalias		= "cs35l56",
+	.max_speed_hz		= 2000000,
+	.chip_select		= 0,
+	.mode			= SPI_MODE_0,
+	.swnode			= &ampl,
+	.use_fwnode_name	= true,
+};
+
+static struct spi_board_info ampr_info = {
+	.modalias		= "cs35l56",
+	.max_speed_hz		= 2000000,
+	.chip_select		= 1,
+	.mode			= SPI_MODE_0,
+	.swnode			= &ampr,
+	.use_fwnode_name	= true,
+};
+
+static const struct software_node cs42l43_gpiochip_swnode = {
+	.name			= "cs42l43-pinctrl",
+};
+
+static const struct software_node_ref_args cs42l43_cs_refs[] = {
+	{
+		.node		= &cs42l43_gpiochip_swnode,
+		.nargs		= 2,
+		.args		= { 0, GPIO_ACTIVE_LOW },
+	},
+	{
+		.node		= &swnode_gpio_undefined,
+		.nargs		= 0,
+	},
+};
+
+static const struct property_entry cs42l43_cs_props[] = {
+	{
+		.name		= "cs-gpios",
+		.length		= ARRAY_SIZE(cs42l43_cs_refs) *
+				  sizeof(struct software_node_ref_args),
+		.type		= DEV_PROP_REF,
+		.pointer	= cs42l43_cs_refs,
+	},
+	{}
+};
+
 static int cs42l43_spi_tx(struct regmap *regmap, const u8 *buf, unsigned int len)
 {
 	const u8 *end = buf + len;
@@ -203,6 +258,54 @@ static size_t cs42l43_spi_max_length(struct spi_device *spi)
 	return CS42L43_SPI_MAX_LENGTH;
 }
 
+#if IS_ENABLED(CONFIG_ACPI)
+static bool cs42l43_has_sidecar(struct fwnode_handle *fwnode)
+{
+	static const int func_smart_amp = 0x1;
+	struct fwnode_handle *child_fwnode, *ext_fwnode;
+	unsigned long long function;
+	unsigned int val;
+	int ret;
+
+	if (!is_acpi_node(fwnode))
+		return false;
+
+	fwnode_for_each_child_node(fwnode, child_fwnode) {
+		struct acpi_device *adev = to_acpi_device_node(child_fwnode);
+
+		ret = acpi_evaluate_integer(adev->handle, "_ADR", NULL, &function);
+		if (ACPI_FAILURE(ret) || function != func_smart_amp) {
+			fwnode_handle_put(fwnode);
+			continue;
+		}
+
+		ext_fwnode = fwnode_get_named_child_node(child_fwnode,
+				"mipi-sdca-function-expansion-subproperties");
+		if (!ext_fwnode) {
+			fwnode_handle_put(fwnode);
+			continue;
+		}
+
+		ret = fwnode_property_read_u32(ext_fwnode,
+					       "01fa-cirrus-sidecar-instances",
+					       &val);
+
+		fwnode_handle_put(ext_fwnode);
+		fwnode_handle_put(fwnode);
+
+		if (!ret)
+			return !!val;
+	}
+
+	return false;
+}
+#else
+static bool cs42l43_has_sidecar(struct fwnode_handle *fwnode)
+{
+	return false;
+}
+#endif
+
 static void cs42l43_release_of_node(void *data)
 {
 	fwnode_handle_put(data);
@@ -213,6 +316,7 @@ static int cs42l43_spi_probe(struct platform_device *pdev)
 	struct cs42l43 *cs42l43 = dev_get_drvdata(pdev->dev.parent);
 	struct cs42l43_spi *priv;
 	struct fwnode_handle *fwnode = dev_fwnode(cs42l43->dev);
+	bool has_sidecar = cs42l43_has_sidecar(fwnode);
 	int ret;
 
 	priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
@@ -266,16 +370,64 @@ static int cs42l43_spi_probe(struct platform_device *pdev)
 		}
 	}
 
-	device_set_node(&priv->ctlr->dev, fwnode);
+	if (has_sidecar) {
+		ret = software_node_register(&cs42l43_gpiochip_swnode);
+		if (ret) {
+			dev_err(priv->dev, "Failed to register gpio swnode: %d\n", ret);
+			return ret;
+		}
+
+		ret = device_create_managed_software_node(&priv->ctlr->dev, cs42l43_cs_props, NULL);
+		if (ret) {
+			dev_err(priv->dev, "Failed to add swnode: %d\n", ret);
+			goto err;
+		}
+
+	} else {
+		device_set_node(&priv->ctlr->dev, fwnode);
+	}
 
 	ret = devm_spi_register_controller(priv->dev, priv->ctlr);
 	if (ret) {
 		dev_err(priv->dev, "Failed to register SPI controller: %d\n", ret);
+		goto err;
+	}
+
+	if (has_sidecar) {
+		if (!spi_new_device(priv->ctlr, &ampl_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create left amp slave\n");
+			goto err;
+		}
+
+		if (!spi_new_device(priv->ctlr, &ampr_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create right amp slave\n");
+			goto err;
+		}
 	}
 
+	return 0;
+
+err:
+	if (has_sidecar)
+		software_node_unregister(&cs42l43_gpiochip_swnode);
+
 	return ret;
 }
 
+static int cs42l43_spi_remove(struct platform_device *pdev)
+{
+	struct cs42l43 *cs42l43 = dev_get_drvdata(pdev->dev.parent);
+	struct fwnode_handle *fwnode = dev_fwnode(cs42l43->dev);
+	bool has_sidecar = cs42l43_has_sidecar(fwnode);
+
+	if (has_sidecar)
+		software_node_unregister(&cs42l43_gpiochip_swnode);
+
+	return 0;
+};
+
 static const struct platform_device_id cs42l43_spi_id_table[] = {
 	{ "cs42l43-spi", },
 	{}
@@ -288,6 +440,7 @@ static struct platform_driver cs42l43_spi_driver = {
 	},
 	.probe		= cs42l43_spi_probe,
 	.id_table	= cs42l43_spi_id_table,
+	.remove		= cs42l43_spi_remove,
 };
 module_platform_driver(cs42l43_spi_driver);
 
Signature · 1 line
2.39.2
#8 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

Quoted 15 lines

From: Maciej Strozek <[email protected]>

On some cs42l43 systems a couple of cs35l56 amplifiers are attached to the cs42l43's SPI and I2S. On Windows the cs42l43 is controlled by a SDCA class driver and these two amplifiers are controlled by firmware running on the cs42l43. However, under Linux the decision was made to interact with the cs42l43 directly, affording the user greater control over the audio system. However, this has resulted in an issue where these two bridged cs35l56 amplifiers are not populated in ACPI and must be added manually.

Check for the presence of the "01fa-cirrus-sidecar-instances" property in the SDCA extension unit's ACPI properties to confirm the presence of these two amplifiers and if they exist add them manually onto the SPI bus.

...

Quoted 1 line

+#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

Quoted 1 line

+#include <linux/acpi.h>

You need array_size.h (and perhaps overflow.h) and property.h.

...

drivers/spi/spi-cs42l43.c static const unsigned int cs42l43_clock_divs[] = { · line 54

Quoted 3 lines
drivers/spi/spi-cs42l43.c +3 -0
+static struct spi_board_info ampl_info = {
+	.modalias		= "cs35l56",
+	.max_speed_hz		= 2000000,

Maybe HZ_PER_MHZ from units.h?

drivers/spi/spi-cs42l43.c static const unsigned int cs42l43_clock_divs[] = { · line 63

Quoted 9 lines
drivers/spi/spi-cs42l43.c +9 -0
+	.chip_select		= 0,
+	.mode			= SPI_MODE_0,
+	.swnode			= &ampl,
+	.use_fwnode_name	= true,
+};
+
+static struct spi_board_info ampr_info = {
+	.modalias		= "cs35l56",
+	.max_speed_hz		= 2000000,

Ditto.

Quoted 5 lines
drivers/spi/spi-cs42l43.c +5 -0
+	.chip_select		= 1,
+	.mode			= SPI_MODE_0,
+	.swnode			= &ampr,
+	.use_fwnode_name	= true,
+};

...

Quoted 1 line

+static const struct software_node_ref_args cs42l43_cs_refs[] = {

Please, use SOFTWARE_NODE_REFERENCE().

Quoted 9 lines
drivers/spi/spi-cs42l43.c +9 -0
+	{
+		.node		= &cs42l43_gpiochip_swnode,
+		.nargs		= 2,
+		.args		= { 0, GPIO_ACTIVE_LOW },
+	},
+	{
+		.node		= &swnode_gpio_undefined,
+		.nargs		= 0,
+	},

drivers/spi/spi-cs42l43.c static const unsigned int cs42l43_clock_divs[] = { · line 93

Quoted 10 lines
drivers/spi/spi-cs42l43.c +10 -0
+};
+
+static const struct property_entry cs42l43_cs_props[] = {
+	{
+		.name		= "cs-gpios",
+		.length		= ARRAY_SIZE(cs42l43_cs_refs) *
+				  sizeof(struct software_node_ref_args),
+		.type		= DEV_PROP_REF,
+		.pointer	= cs42l43_cs_refs,
+	},

You want PROPERTY_ENTRY_REF_ARRAY()..

Quoted 2 lines
drivers/spi/spi-cs42l43.c +2 -0
+	{}
+};

...

Quoted 1 line

+#if IS_ENABLED(CONFIG_ACPI)

No need (see below)?

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 271

Quoted 10 lines
drivers/spi/spi-cs42l43.c +9 -0
+static bool cs42l43_has_sidecar(struct fwnode_handle *fwnode)
+{
+	static const int func_smart_amp = 0x1;
+	struct fwnode_handle *child_fwnode, *ext_fwnode;
+	unsigned long long function;
+	unsigned int val;
+	int ret;
 
+	if (!is_acpi_node(fwnode))
+		return false;

Dup, your loop will perform the same effectivelly.

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 280

Quoted 9 lines
drivers/spi/spi-cs42l43.c +8 -0
+	fwnode_for_each_child_node(fwnode, child_fwnode) {
 
+		struct acpi_device *adev = to_acpi_device_node(child_fwnode);
+
+		ret = acpi_evaluate_integer(adev->handle, "_ADR", NULL, &function);
+		if (ACPI_FAILURE(ret) || function != func_smart_amp) {
+			fwnode_handle_put(fwnode);
+			continue;
+		}

acpi_get_local_address() (it has a stub for CONFIG_ACPI=n).

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 285

Quoted 5 lines
drivers/spi/spi-cs42l43.c +4 -0
+		ext_fwnode = fwnode_get_named_child_node(child_fwnode,
+				"mipi-sdca-function-expansion-subproperties");
+		if (!ext_fwnode) {
 
+			fwnode_handle_put(fwnode);

Are you sure?

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 294

Quoted 11 lines
drivers/spi/spi-cs42l43.c +9 -0
+			continue;
+		}
+
+		ret = fwnode_property_read_u32(ext_fwnode,
+					       "01fa-cirrus-sidecar-instances",
+					       &val);
 
+
+		fwnode_handle_put(ext_fwnode);
 
+		fwnode_handle_put(fwnode);

Are you sure?

Quoted 6 lines
drivers/spi/spi-cs42l43.c +6 -0
+		if (!ret)
+			return !!val;
+	}
+
+	return false;
+}

...

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev)

Quoted 9 lines
drivers/spi/spi-cs42l43.c +7 -1
-	device_set_node(&priv->ctlr->dev, fwnode);
+	if (has_sidecar) {
+		ret = software_node_register(&cs42l43_gpiochip_swnode);
+		if (ret) {
+			dev_err(priv->dev, "Failed to register gpio swnode: %d\n", ret);
+			return ret;
+		}
 
+		ret = device_create_managed_software_node(&priv->ctlr->dev, cs42l43_cs_props, NULL);

No, this must not be used (I'm talking about _managed variant), this is a hack for backward compatibility.

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 395

Quoted 6 lines
drivers/spi/spi-cs42l43.c +5 -0
+		if (ret) {
+			dev_err(priv->dev, "Failed to add swnode: %d\n", ret);
+			goto err;
+		}
 
+

Redundant blank line.

Quoted 22 lines
drivers/spi/spi-cs42l43.c +18 -0
+	} else {
+		device_set_node(&priv->ctlr->dev, fwnode);
+	}
 
 	ret = devm_spi_register_controller(priv->dev, priv->ctlr);
 	if (ret) {
 		dev_err(priv->dev, "Failed to register SPI controller: %d\n", ret);
+		goto err;
+	}
+
+	if (has_sidecar) {
+		if (!spi_new_device(priv->ctlr, &ampl_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create left amp slave\n");
+			goto err;
+		}
+
+		if (!spi_new_device(priv->ctlr, &ampr_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create right amp slave\n");
+			goto err;
+		}

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 417

Quoted 10 lines
drivers/spi/spi-cs42l43.c +6 -0
 	}
 
+	return 0;
+
+err:
+	if (has_sidecar)
+		software_node_unregister(&cs42l43_gpiochip_swnode);
+
 	return ret;
 }

Wondering why don't you use return dev_err_probe() / ret = dev_err_probe() / dev_err_probe(ret)?

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 421

Quoted 3 lines
drivers/spi/spi-cs42l43.c +3 -0
+static int cs42l43_spi_remove(struct platform_device *pdev)
+{
+	struct cs42l43 *cs42l43 = dev_get_drvdata(pdev->dev.parent);

platform_get_drvdata()

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 422

Quoted 1 line
drivers/spi/spi-cs42l43.c +1 -0
+	struct fwnode_handle *fwnode = dev_fwnode(cs42l43->dev);

Is this dev the same as &pdev->dev?

Quoted 7 lines
drivers/spi/spi-cs42l43.c +7 -0
+	bool has_sidecar = cs42l43_has_sidecar(fwnode);
+
+	if (has_sidecar)
+		software_node_unregister(&cs42l43_gpiochip_swnode);
+
+	return 0;
+};
Signature · 2 lines
With Best Regards,
Andy Shevchenko
#9 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Quoted 6 lines · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

Quoted 2 lines

From: Maciej Strozek <[email protected]> +#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

It's required for the GPIO_ACTIVE_LOW used in the swnode stuff.

Quoted 3 lines
Quoted 1 line

+#include <linux/acpi.h>

You need array_size.h (and perhaps overflow.h) and property.h.

Good spot will add those.

Quoted 5 lines

drivers/spi/spi-cs42l43.c static const unsigned int cs42l43_clock_divs[] = { · line 54

Quoted 3 lines
drivers/spi/spi-cs42l43.c +3 -0
+static struct spi_board_info ampl_info = {
+	.modalias		= "cs35l56",
+	.max_speed_hz		= 2000000,

Maybe HZ_PER_MHZ from units.h?

Can do.

Quoted 5 lines
Quoted 1 line

+static const struct software_node_ref_args cs42l43_cs_refs[] = {

Please, use SOFTWARE_NODE_REFERENCE().

Quoted 1 line

+static const struct property_entry cs42l43_cs_props[] = {

You want PROPERTY_ENTRY_REF_ARRAY()..

Can do.

Quoted 8 lines
Quoted 7 lines
drivers/spi/spi-cs42l43.c +7 -0
+static bool cs42l43_has_sidecar(struct fwnode_handle *fwnode)
+{
+	static const int func_smart_amp = 0x1;
+	struct fwnode_handle *child_fwnode, *ext_fwnode;
+	unsigned long long function;
+	unsigned int val;
+	int ret;
Quoted 4 lines

Review

Quoted 2 lines
(quoted diff) +2 -0
+	if (!is_acpi_node(fwnode))
+		return false;

Dup, your loop will perform the same effectivelly.

Are you sure? Won't adev end up being NULL and the adev->handle will dereference it?

Quoted 11 lines

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 280

Quoted 9 lines
drivers/spi/spi-cs42l43.c +8 -0
+	fwnode_for_each_child_node(fwnode, child_fwnode) {
 
+		struct acpi_device *adev = to_acpi_device_node(child_fwnode);
+
+		ret = acpi_evaluate_integer(adev->handle, "_ADR", NULL, &function);
+		if (ACPI_FAILURE(ret) || function != func_smart_amp) {
+			fwnode_handle_put(fwnode);
+			continue;
+		}

acpi_get_local_address() (it has a stub for CONFIG_ACPI=n).

Thanks was looking for something like that not sure how I missed that.

Quoted 7 lines

drivers/spi/spi-cs42l43.c static size_t cs42l43_spi_max_length(struct spi_device *spi) · line 285

Quoted 5 lines
drivers/spi/spi-cs42l43.c +4 -0
+		ext_fwnode = fwnode_get_named_child_node(child_fwnode,
+				"mipi-sdca-function-expansion-subproperties");
+		if (!ext_fwnode) {
 
+			fwnode_handle_put(fwnode);

Are you sure?

oops, yeah those should all be child_fwnode.

Quoted 11 lines

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev)

Quoted 8 lines
drivers/spi/spi-cs42l43.c +7 -0
+	if (has_sidecar) {
+		ret = software_node_register(&cs42l43_gpiochip_swnode);
+		if (ret) {
+			dev_err(priv->dev, "Failed to register gpio swnode: %d\n", ret);
+			return ret;
+		}
 
+		ret = device_create_managed_software_node(&priv->ctlr->dev, cs42l43_cs_props, NULL);

No, this must not be used (I'm talking about _managed variant), this is a hack for backward compatibility.

Hm... odd, feels like the function could use a comment or something to say don't use me. But we can go back to managing it manually no problems.

Quoted 8 lines

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 395

Quoted 6 lines
drivers/spi/spi-cs42l43.c +5 -0
+		if (ret) {
+			dev_err(priv->dev, "Failed to add swnode: %d\n", ret);
+			goto err;
+		}
 
+

Redundant blank line.

yup.

Quoted 24 lines
Quoted 24 lines
drivers/spi/spi-cs42l43.c +18 -0
+	} else {
+		device_set_node(&priv->ctlr->dev, fwnode);
+	}
 
 	ret = devm_spi_register_controller(priv->dev, priv->ctlr);
 	if (ret) {
 		dev_err(priv->dev, "Failed to register SPI controller: %d\n", ret);
+		goto err;
+	}
+
+	if (has_sidecar) {
+		if (!spi_new_device(priv->ctlr, &ampl_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create left amp slave\n");
+			goto err;
+		}
+
+		if (!spi_new_device(priv->ctlr, &ampr_info)) {
+			ret = -ENODEV;
+			dev_err(priv->dev, "Failed to create right amp slave\n");
+			goto err;
+		}
 	}
Quoted 11 lines

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 417

Quoted 8 lines
drivers/spi/spi-cs42l43.c +6 -0
+	return 0;
+
+err:
+	if (has_sidecar)
+		software_node_unregister(&cs42l43_gpiochip_swnode);
+
 	return ret;
 }

Wondering why don't you use return dev_err_probe() / ret = dev_err_probe() / dev_err_probe(ret)?

Yeah some of those should be, will update.

Quoted 9 lines

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 421

Quoted 3 lines
drivers/spi/spi-cs42l43.c +3 -0
+static int cs42l43_spi_remove(struct platform_device *pdev)
+{
+	struct cs42l43 *cs42l43 = dev_get_drvdata(pdev->dev.parent);

platform_get_drvdata()

drivers/spi/spi-cs42l43.c static int cs42l43_spi_probe(struct platform_device *pdev) · line 422

Quoted 1 line
drivers/spi/spi-cs42l43.c +1 -0
+	struct fwnode_handle *fwnode = dev_fwnode(cs42l43->dev);

Is this dev the same as &pdev->dev?

No, this is MFD parent device, to be fair could probably use parent directly here. Will have a think about that.

Thanks,
Charles

#10 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Quoted 2 lines · Charles Keepax
Quoted 1 line · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

...

Quoted 6 lines
Quoted 4 lines
Quoted 1 line

+#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

It's required for the GPIO_ACTIVE_LOW used in the swnode stuff.

Seems to me like you are mistaken.
https://elixir.bootlin.com/linux/latest/source/drivers/gpio/gpiolib-swnode.c#L85

...

Quoted 7 lines
Quoted 4 lines

Review

Quoted 2 lines
(quoted diff) +2 -0
+   if (!is_acpi_node(fwnode))
+           return false;

Dup, your loop will perform the same effectivelly.

Are you sure? Won't adev end up being NULL and the adev->handle will dereference it?

Yes, you need to check the ACPI dev to be not NULL there. Also note, that is_acpi_node() is not the same as is_acpi_device_node().

Quoted 3 lines
Quoted 3 lines
Quoted 3 lines
drivers/spi/spi-cs42l43.c +2 -0
+   fwnode_for_each_child_node(fwnode, child_fwnode) {
 
+           struct acpi_device *adev = to_acpi_device_node(child_fwnode);

...

Quoted 8 lines
Quoted 4 lines
Quoted 1 line

+ ret = device_create_managed_software_node(&priv->ctlr->dev, cs42l43_cs_props, NULL);

No, this must not be used (I'm talking about _managed variant), this is a hack for backward compatibility.

Hm... odd, feels like the function could use a comment or something to say don't use me. But we can go back to managing it manually no problems.

Ah, I was thinking that it inherited that from device_add_property() (see 2338e7bcef44 ("device property: Remove device_add_properties() API") for the details), but no, it seems okay to use. but then we really need to be careful about lifetime of it wrt. other parts in this code.

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#11 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Quoted 4 lines · Andy Shevchenko
Quoted 2 lines · Charles Keepax
Quoted 1 line · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

...

Quoted 9 lines
Quoted 6 lines
Quoted 4 lines
Quoted 1 line

+#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

It's required for the GPIO_ACTIVE_LOW used in the swnode stuff.

Seems to me like you are mistaken.
https://elixir.bootlin.com/linux/latest/source/drivers/gpio/gpiolib-swnode.c#L85

Okay, I stand corrected, under "native" the GPIO_* are assumed.

But what you need is to include gpio/property.h for that, and not directly the DT header.

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#12 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Quoted 5 lines · Andy Shevchenko
Quoted 4 lines · Andy Shevchenko
Quoted 2 lines · Charles Keepax
Quoted 1 line · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

...

Quoted 7 lines
Quoted 7 lines
Quoted 6 lines
Quoted 4 lines
Quoted 1 line

+#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

It's required for the GPIO_ACTIVE_LOW used in the swnode stuff.

Quoted 7 lines
Quoted 2 lines

Seems to me like you are mistaken.
https://elixir.bootlin.com/linux/latest/source/drivers/gpio/gpiolib-swnode.c#L85

Okay, I stand corrected, under "native" the GPIO_* are assumed.

But what you need is to include gpio/property.h for that, and not directly the DT header.

Oh, my, we have two _almost_ identical definitions in machine.h and under DT. So, I believe we are using ones from machine.h.

Signature · 2 lines
With Best Regards,
Andy Shevchenko
#13 lore raw

Re: [PATCH v3 3/3] spi: cs42l43: Add bridged cs35l56 amplifiers

Quoted 19 lines · Andy Shevchenko
Quoted 5 lines · Andy Shevchenko
Quoted 4 lines · Andy Shevchenko
Quoted 2 lines · Charles Keepax
Quoted 1 line · Andy Shevchenko

Fri, Mar 29, 2024 at 11:47:30AM +0000, Charles Keepax kirjoitti:

...

Quoted 10 lines
Quoted 9 lines
Quoted 6 lines
Quoted 4 lines
Quoted 1 line

+#include <dt-bindings/gpio/gpio.h>

Hmm... Is it requirement by gpiolib-swnode? (I haven't looked at the use cases, I'm not the author of this idea, hence the Q).

It's required for the GPIO_ACTIVE_LOW used in the swnode stuff.

Seems to me like you are mistaken.
https://elixir.bootlin.com/linux/latest/source/drivers/gpio/gpiolib-swnode.c#L85

Quoted 8 lines
Quoted 4 lines

Okay, I stand corrected, under "native" the GPIO_* are assumed.

But what you need is to include gpio/property.h for that, and not directly the DT header.

Oh, my, we have two _almost_ identical definitions in machine.h and under DT. So, I believe we are using ones from machine.h.

Yeah that is my bad I should be using those instead.

Thanks,
Charles