This series introduces a level of indirection between the controller's view of
a typec_mux/switch and the implementation and then expands that to support
multiple drivers.
This is needed in order to support devices such as the Qualcomm Snapdragon 888
HDK, which does muxing and orientation handling in the QMP (USB+DP) PHY and SBU
muxing in the external FSA4480 chip.
Included in the series is a the new FSA4480 driver. This is done to deal with
the renaming of the driver-side typec_mux -> typec_mux_dev.
Changes since v1:
- Omitted QMP changes from this series, as the muxing implementation needs a
little bit more debugging.
Bjorn Andersson (6):
device property: Helper to match multiple connections
device property: Use multi-connection matchers for single case
typec: mux: Introduce indirection
typec: mux: Allow multiple mux_devs per mux
dt-bindings: usb: Add binding for fcs,fsa4480
usb: typec: mux: Add On Semi fsa4480 driver
.../devicetree/bindings/usb/fcs,fsa4480.yaml | 72 +++++
drivers/base/property.c | 85 ++++--
drivers/usb/typec/bus.c | 2 +-
drivers/usb/typec/mux.c | 261 +++++++++++++-----
drivers/usb/typec/mux.h | 12 +-
drivers/usb/typec/mux/Kconfig | 9 +
drivers/usb/typec/mux/Makefile | 1 +
drivers/usb/typec/mux/fsa4480.c | 220 +++++++++++++++
drivers/usb/typec/mux/intel_pmc_mux.c | 8 +-
drivers/usb/typec/mux/pi3usb30532.c | 8 +-
include/linux/property.h | 5 +
include/linux/usb/typec_mux.h | 22 +-
12 files changed, 595 insertions(+), 110 deletions(-)
create mode 100644 Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
create mode 100644 drivers/usb/typec/mux/fsa4480.c
--
2.33.1
In the Qualcomm platforms the USB/DP PHY handles muxing and orientation
switching of the SuperSpeed lines, but the SBU lines needs to be
connected and switched by external (to the SoC) hardware.
It's therefor necessary to be able to have the TypeC controller operate
multiple TypeC muxes and switches. Use the newly introduced indirection
object to handle this, to avoid having to taint the TypeC controllers
with knowledge about the downstream hardware configuration.
The max number of devs per indirection is set to 3, which account for
being able to mux/switch the USB HS, SS and SBU lines, as per defined
defined in the usb-c-connector binding. This number could be grown if
need arrises at a later point in time.
Signed-off-by: Bjorn Andersson <[email protected]>
---
Changes since v1:
- Improved the motivation for the 3 in the commit message.
- kfree sw and mux in error paths
drivers/usb/typec/mux.c | 128 ++++++++++++++++++++++++++++++++--------
1 file changed, 102 insertions(+), 26 deletions(-)
diff --git a/drivers/usb/typec/mux.c b/drivers/usb/typec/mux.c
index d0b42c297aca..cf2347dd1663 100644
--- a/drivers/usb/typec/mux.c
+++ b/drivers/usb/typec/mux.c
@@ -17,8 +17,11 @@
#include "class.h"
#include "mux.h"
+#define TYPEC_MUX_MAX_DEVS 3
+
struct typec_switch {
- struct typec_switch_dev *sw_dev;
+ struct typec_switch_dev *sw_devs[TYPEC_MUX_MAX_DEVS];
+ unsigned int num_sw_devs;
};
static int switch_fwnode_match(struct device *dev, const void *fwnode)
@@ -67,25 +70,50 @@ static void *typec_switch_match(struct fwnode_handle *fwnode, const char *id,
*/
struct typec_switch *fwnode_typec_switch_get(struct fwnode_handle *fwnode)
{
- struct typec_switch_dev *sw_dev;
+ struct typec_switch_dev *sw_devs[TYPEC_MUX_MAX_DEVS];
struct typec_switch *sw;
+ int count;
+ int err;
+ int i;
sw = kzalloc(sizeof(*sw), GFP_KERNEL);
if (!sw)
return ERR_PTR(-ENOMEM);
- sw_dev = fwnode_connection_find_match(fwnode, "orientation-switch", NULL,
- typec_switch_match);
- if (IS_ERR_OR_NULL(sw_dev)) {
+ count = fwnode_connection_find_matches(fwnode, "orientation-switch", NULL,
+ typec_switch_match,
+ (void **)sw_devs,
+ ARRAY_SIZE(sw_devs));
+ if (count <= 0) {
kfree(sw);
- return ERR_CAST(sw_dev);
+ return NULL;
}
- WARN_ON(!try_module_get(sw_dev->dev.parent->driver->owner));
+ for (i = 0; i < count; i++) {
+ if (IS_ERR(sw_devs[i])) {
+ err = PTR_ERR(sw_devs[i]);
+ goto put_sw_devs;
+ }
+ }
- sw->sw_dev = sw_dev;
+ for (i = 0; i < count; i++) {
+ WARN_ON(!try_module_get(sw_devs[i]->dev.parent->driver->owner));
+ sw->sw_devs[i] = sw_devs[i];
+ }
+
+ sw->num_sw_devs = count;
return sw;
+
+put_sw_devs:
+ for (i = 0; i < count; i++) {
+ if (!IS_ERR(sw_devs[i]))
+ put_device(&sw_devs[i]->dev);
+ }
+
+ kfree(sw);
+
+ return ERR_PTR(err);
}
EXPORT_SYMBOL_GPL(fwnode_typec_switch_get);
@@ -98,14 +126,17 @@ EXPORT_SYMBOL_GPL(fwnode_typec_switch_get);
void typec_switch_put(struct typec_switch *sw)
{
struct typec_switch_dev *sw_dev;
+ unsigned int i;
if (IS_ERR_OR_NULL(sw))
return;
- sw_dev = sw->sw_dev;
+ for (i = 0; i < sw->num_sw_devs; i++) {
+ sw_dev = sw->sw_devs[i];
- module_put(sw_dev->dev.parent->driver->owner);
- put_device(&sw_dev->dev);
+ module_put(sw_dev->dev.parent->driver->owner);
+ put_device(&sw_dev->dev);
+ }
kfree(sw);
}
EXPORT_SYMBOL_GPL(typec_switch_put);
@@ -170,13 +201,21 @@ int typec_switch_set(struct typec_switch *sw,
enum typec_orientation orientation)
{
struct typec_switch_dev *sw_dev;
+ unsigned int i;
+ int ret;
if (IS_ERR_OR_NULL(sw))
return 0;
- sw_dev = sw->sw_dev;
+ for (i = 0; i < sw->num_sw_devs; i++) {
+ sw_dev = sw->sw_devs[i];
+
+ ret = sw_dev->set(sw_dev, orientation);
+ if (ret)
+ return ret;
+ }
- return sw_dev->set(sw_dev, orientation);
+ return 0;
}
EXPORT_SYMBOL_GPL(typec_switch_set);
@@ -208,7 +247,8 @@ EXPORT_SYMBOL_GPL(typec_switch_get_drvdata);
/* ------------------------------------------------------------------------- */
struct typec_mux {
- struct typec_mux_dev *mux_dev;
+ struct typec_mux_dev *mux_devs[TYPEC_MUX_MAX_DEVS];
+ unsigned int num_mux_devs;
};
static int mux_fwnode_match(struct device *dev, const void *fwnode)
@@ -291,25 +331,50 @@ static void *typec_mux_match(struct fwnode_handle *fwnode, const char *id,
struct typec_mux *fwnode_typec_mux_get(struct fwnode_handle *fwnode,
const struct typec_altmode_desc *desc)
{
- struct typec_mux_dev *mux_dev;
+ struct typec_mux_dev *mux_devs[TYPEC_MUX_MAX_DEVS];
struct typec_mux *mux;
+ int count;
+ int err;
+ int i;
mux = kzalloc(sizeof(*mux), GFP_KERNEL);
if (!mux)
return ERR_PTR(-ENOMEM);
- mux_dev = fwnode_connection_find_match(fwnode, "mode-switch", (void *)desc,
- typec_mux_match);
- if (IS_ERR_OR_NULL(mux_dev)) {
+ count = fwnode_connection_find_matches(fwnode, "mode-switch",
+ (void *)desc, typec_mux_match,
+ (void **)mux_devs,
+ ARRAY_SIZE(mux_devs));
+ if (count <= 0) {
kfree(mux);
- return ERR_CAST(mux_dev);
+ return NULL;
}
- WARN_ON(!try_module_get(mux_dev->dev.parent->driver->owner));
+ for (i = 0; i < count; i++) {
+ if (IS_ERR(mux_devs[i])) {
+ err = PTR_ERR(mux_devs[i]);
+ goto put_mux_devs;
+ }
+ }
+
+ for (i = 0; i < count; i++) {
+ WARN_ON(!try_module_get(mux_devs[i]->dev.parent->driver->owner));
+ mux->mux_devs[i] = mux_devs[i];
+ }
- mux->mux_dev = mux_dev;
+ mux->num_mux_devs = count;
return mux;
+
+put_mux_devs:
+ for (i = 0; i < count; i++) {
+ if (!IS_ERR(mux_devs[i]))
+ put_device(&mux_devs[i]->dev);
+ }
+
+ kfree(mux);
+
+ return ERR_PTR(err);
}
EXPORT_SYMBOL_GPL(fwnode_typec_mux_get);
@@ -322,13 +387,16 @@ EXPORT_SYMBOL_GPL(fwnode_typec_mux_get);
void typec_mux_put(struct typec_mux *mux)
{
struct typec_mux_dev *mux_dev;
+ unsigned int i;
if (IS_ERR_OR_NULL(mux))
return;
- mux_dev = mux->mux_dev;
- module_put(mux_dev->dev.parent->driver->owner);
- put_device(&mux_dev->dev);
+ for (i = 0; i < mux->num_mux_devs; i++) {
+ mux_dev = mux->mux_devs[i];
+ module_put(mux_dev->dev.parent->driver->owner);
+ put_device(&mux_dev->dev);
+ }
kfree(mux);
}
EXPORT_SYMBOL_GPL(typec_mux_put);
@@ -336,13 +404,21 @@ EXPORT_SYMBOL_GPL(typec_mux_put);
int typec_mux_set(struct typec_mux *mux, struct typec_mux_state *state)
{
struct typec_mux_dev *mux_dev;
+ unsigned int i;
+ int ret;
if (IS_ERR_OR_NULL(mux))
return 0;
- mux_dev = mux->mux_dev;
+ for (i = 0; i < mux->num_mux_devs; i++) {
+ mux_dev = mux->mux_devs[i];
+
+ ret = mux_dev->set(mux_dev, state);
+ if (ret)
+ return ret;
+ }
- return mux_dev->set(mux_dev, state);
+ return 0;
}
EXPORT_SYMBOL_GPL(typec_mux_set);
--
2.33.1
The ON Semiconductor FSA4480 is a USB Type-C port multimedia switch with
support for analog audio headsets. It allows sharing a common USB Type-C
port to pass USB2.0 signal, analog audio, sideband use wires and analog
microphone signal.
Due to lacking upstream audio support for testing, the audio muxing is
left untouched, but implementation of muxing the SBU lines is provided
as a pair of TypeC mux and switch devices. This provides the necessary
support for enabling the DisplayPort altmode on devices with this
circuit.
Signed-off-by: Bjorn Andersson <[email protected]>
---
Changes since v1:
- None
drivers/usb/typec/mux/Kconfig | 9 ++
drivers/usb/typec/mux/Makefile | 1 +
drivers/usb/typec/mux/fsa4480.c | 220 ++++++++++++++++++++++++++++++++
3 files changed, 230 insertions(+)
create mode 100644 drivers/usb/typec/mux/fsa4480.c
diff --git a/drivers/usb/typec/mux/Kconfig b/drivers/usb/typec/mux/Kconfig
index edead555835e..5e20112c3f51 100644
--- a/drivers/usb/typec/mux/Kconfig
+++ b/drivers/usb/typec/mux/Kconfig
@@ -2,6 +2,15 @@
menu "USB Type-C Multiplexer/DeMultiplexer Switch support"
+config TYPEC_MUX_FSA4480
+ tristate "ON Semi FSA4480 Analog Audio Switch driver"
+ depends on I2C
+ select REGMAP_I2C
+ help
+ Driver for the ON Semiconductor FSA4480 Analog Audio Switch, which
+ provides support for muxing analog audio and sideband signals on a
+ common USB Type-C connector.
+
config TYPEC_MUX_PI3USB30532
tristate "Pericom PI3USB30532 Type-C cross switch driver"
depends on I2C
diff --git a/drivers/usb/typec/mux/Makefile b/drivers/usb/typec/mux/Makefile
index 280a6f553115..e52a56c16bfb 100644
--- a/drivers/usb/typec/mux/Makefile
+++ b/drivers/usb/typec/mux/Makefile
@@ -1,4 +1,5 @@
# SPDX-License-Identifier: GPL-2.0
+obj-$(CONFIG_TYPEC_MUX_FSA4480) += fsa4480.o
obj-$(CONFIG_TYPEC_MUX_PI3USB30532) += pi3usb30532.o
obj-$(CONFIG_TYPEC_MUX_INTEL_PMC) += intel_pmc_mux.o
diff --git a/drivers/usb/typec/mux/fsa4480.c b/drivers/usb/typec/mux/fsa4480.c
new file mode 100644
index 000000000000..ac2d8648db6a
--- /dev/null
+++ b/drivers/usb/typec/mux/fsa4480.c
@@ -0,0 +1,220 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (C) 2021 Linaro Ltd.
+ * Copyright (C) 2018-2020 The Linux Foundation
+ */
+
+#include <linux/i2c.h>
+#include <linux/kernel.h>
+#include <linux/module.h>
+#include <linux/mutex.h>
+#include <linux/regmap.h>
+#include <linux/usb/typec_dp.h>
+#include <linux/usb/typec_mux.h>
+
+#define FSA4480_SWITCH_ENABLE 0x04
+#define FSA4480_SWITCH_SELECT 0x05
+#define FSA4480_SWITCH_STATUS1 0x07
+#define FSA4480_SLOW_L 0x08
+#define FSA4480_SLOW_R 0x09
+#define FSA4480_SLOW_MIC 0x0a
+#define FSA4480_SLOW_SENSE 0x0b
+#define FSA4480_SLOW_GND 0x0c
+#define FSA4480_DELAY_L_R 0x0d
+#define FSA4480_DELAY_L_MIC 0x0e
+#define FSA4480_DELAY_L_SENSE 0x0f
+#define FSA4480_DELAY_L_AGND 0x10
+#define FSA4480_RESET 0x1e
+
+#define FSA4480_ENABLE_DEVICE BIT(7)
+#define FSA4480_ENABLE_SBU GENMASK(6, 5)
+#define FSA4480_ENABLE_USB GENMASK(4, 3)
+
+#define FSA4480_SEL_SBU_REVERSE GENMASK(6, 5)
+#define FSA4480_SEL_USB GENMASK(4, 3)
+
+struct fsa4480 {
+ struct i2c_client *client;
+
+ /* used to serialize concurrect change requests */
+ struct mutex lock;
+
+ struct typec_switch_dev *sw;
+ struct typec_mux_dev *mux;
+
+ struct regmap *regmap;
+
+ u8 cur_enable;
+ u8 cur_select;
+};
+
+static const struct regmap_config fsa4480_regmap_config = {
+ .reg_bits = 8,
+ .val_bits = 8,
+ .max_register = FSA4480_RESET,
+};
+
+static int fsa4480_switch_set(struct typec_switch_dev *sw,
+ enum typec_orientation orientation)
+{
+ struct fsa4480 *fsa = typec_switch_get_drvdata(sw);
+ u8 new_sel;
+
+ mutex_lock(&fsa->lock);
+ new_sel = FSA4480_SEL_USB;
+ if (orientation == TYPEC_ORIENTATION_REVERSE)
+ new_sel |= FSA4480_SEL_SBU_REVERSE;
+
+ if (new_sel == fsa->cur_select)
+ goto out_unlock;
+
+ if (fsa->cur_enable & FSA4480_ENABLE_SBU) {
+ /* Disable SBU output while re-configuring the switch */
+ regmap_write(fsa->regmap, FSA4480_SWITCH_ENABLE,
+ fsa->cur_enable & ~FSA4480_ENABLE_SBU);
+
+ /* 35us to allow the SBU switch to turn off */
+ usleep_range(35, 1000);
+ }
+
+ regmap_write(fsa->regmap, FSA4480_SWITCH_SELECT, new_sel);
+ fsa->cur_select = new_sel;
+
+ if (fsa->cur_enable & FSA4480_ENABLE_SBU) {
+ regmap_write(fsa->regmap, FSA4480_SWITCH_ENABLE, fsa->cur_enable);
+
+ /* 15us to allow the SBU switch to turn on again */
+ usleep_range(15, 1000);
+ }
+
+out_unlock:
+ mutex_unlock(&fsa->lock);
+
+ return 0;
+}
+
+static int fsa4480_mux_set(struct typec_mux_dev *mux, struct typec_mux_state *state)
+{
+ struct fsa4480 *fsa = typec_mux_get_drvdata(mux);
+ u8 new_enable;
+
+ mutex_lock(&fsa->lock);
+
+ new_enable = FSA4480_ENABLE_DEVICE | FSA4480_ENABLE_USB;
+ if (state->mode >= TYPEC_DP_STATE_A)
+ new_enable |= FSA4480_ENABLE_SBU;
+
+ if (new_enable == fsa->cur_enable)
+ goto out_unlock;
+
+ regmap_write(fsa->regmap, FSA4480_SWITCH_ENABLE, new_enable);
+ fsa->cur_enable = new_enable;
+
+ if (new_enable & FSA4480_ENABLE_SBU) {
+ /* 15us to allow the SBU switch to turn off */
+ usleep_range(15, 1000);
+ }
+
+out_unlock:
+ mutex_unlock(&fsa->lock);
+
+ return 0;
+}
+
+static int fsa4480_probe(struct i2c_client *client)
+{
+ struct device *dev = &client->dev;
+ struct typec_switch_desc sw_desc = { };
+ struct typec_mux_desc mux_desc = { };
+ struct fsa4480 *fsa;
+
+ fsa = devm_kzalloc(dev, sizeof(*fsa), GFP_KERNEL);
+ if (!fsa)
+ return -ENOMEM;
+
+ fsa->client = client;
+ mutex_init(&fsa->lock);
+
+ fsa->regmap = devm_regmap_init_i2c(client, &fsa4480_regmap_config);
+ if (IS_ERR(fsa->regmap)) {
+ dev_err(dev, "failed to initialize regmap\n");
+ return PTR_ERR(fsa->regmap);
+ }
+
+ fsa->cur_enable = FSA4480_ENABLE_DEVICE | FSA4480_ENABLE_USB;
+ fsa->cur_select = FSA4480_SEL_USB;
+
+ /* set default settings */
+ regmap_write(fsa->regmap, FSA4480_SLOW_L, 0x00);
+ regmap_write(fsa->regmap, FSA4480_SLOW_R, 0x00);
+ regmap_write(fsa->regmap, FSA4480_SLOW_MIC, 0x00);
+ regmap_write(fsa->regmap, FSA4480_SLOW_SENSE, 0x00);
+ regmap_write(fsa->regmap, FSA4480_SLOW_GND, 0x00);
+ regmap_write(fsa->regmap, FSA4480_DELAY_L_R, 0x00);
+ regmap_write(fsa->regmap, FSA4480_DELAY_L_MIC, 0x00);
+ regmap_write(fsa->regmap, FSA4480_DELAY_L_SENSE, 0x00);
+ regmap_write(fsa->regmap, FSA4480_DELAY_L_AGND, 0x09);
+ regmap_write(fsa->regmap, FSA4480_SWITCH_SELECT, fsa->cur_select);
+ regmap_write(fsa->regmap, FSA4480_SWITCH_ENABLE, fsa->cur_enable);
+
+ sw_desc.drvdata = fsa;
+ sw_desc.fwnode = dev->fwnode;
+ sw_desc.set = fsa4480_switch_set;
+
+ fsa->sw = typec_switch_register(dev, &sw_desc);
+ if (IS_ERR(fsa->sw)) {
+ dev_err(dev, "failed to register typec switch: %ld\n", PTR_ERR(fsa->sw));
+ return PTR_ERR(fsa->sw);
+ }
+
+ mux_desc.drvdata = fsa;
+ mux_desc.fwnode = dev->fwnode;
+ mux_desc.set = fsa4480_mux_set;
+
+ fsa->mux = typec_mux_register(dev, &mux_desc);
+ if (IS_ERR(fsa->mux)) {
+ typec_switch_unregister(fsa->sw);
+ dev_err(dev, "failed to register typec mux: %ld\n", PTR_ERR(fsa->mux));
+ return PTR_ERR(fsa->mux);
+ }
+
+ i2c_set_clientdata(client, fsa);
+ return 0;
+}
+
+static int fsa4480_remove(struct i2c_client *client)
+{
+ struct fsa4480 *fsa = i2c_get_clientdata(client);
+
+ typec_mux_unregister(fsa->mux);
+ typec_switch_unregister(fsa->sw);
+
+ return 0;
+}
+
+static const struct i2c_device_id fsa4480_table[] = {
+ { "fsa4480" },
+ { }
+};
+MODULE_DEVICE_TABLE(i2c, fsa4480_table);
+
+static const struct of_device_id fsa4480_of_table[] = {
+ { .compatible = "fcs,fsa4480" },
+ { }
+};
+MODULE_DEVICE_TABLE(of, fsa4480_of_table);
+
+static struct i2c_driver fsa4480_driver = {
+ .driver = {
+ .name = "fsa4480",
+ .of_match_table = fsa4480_of_table,
+ },
+ .probe_new = fsa4480_probe,
+ .remove = fsa4480_remove,
+ .id_table = fsa4480_table,
+};
+
+module_i2c_driver(fsa4480_driver);
+
+MODULE_DESCRIPTION("ON Semiconductor FSA4480 driver");
+MODULE_LICENSE("GPL v2");
--
2.33.1
The Fairchild/ON Semiconductor FSA4480 Analog Audio switch is used in
USB Type-C configurations for muxing analog audio onto the USB
connector, and as such used to control the SBU signals for altmodes such
as DisplayPort.
Add a binding for this hardware block.
Signed-off-by: Bjorn Andersson <[email protected]>
---
Changes since v1:
- None
.../devicetree/bindings/usb/fcs,fsa4480.yaml | 72 +++++++++++++++++++
1 file changed, 72 insertions(+)
create mode 100644 Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
diff --git a/Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml b/Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
new file mode 100644
index 000000000000..9473f26b0621
--- /dev/null
+++ b/Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
@@ -0,0 +1,72 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/usb/fcs,fsa4480.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: ON Semiconductor Analog Audio Switch
+
+maintainers:
+ - Bjorn Andersson <[email protected]>
+
+properties:
+ compatible:
+ enum:
+ - fcs,fsa4480
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ vcc-supply:
+ description: power supply (2.7V-5.5V)
+
+ mode-switch:
+ description: Flag the port as possible handle of altmode switching
+ type: boolean
+
+ orientation-switch:
+ description: Flag the port as possible handler of orientation switching
+ type: boolean
+
+ port:
+ $ref: /schemas/graph.yaml#/properties/port
+ description:
+ A port node to link the FSA4480 to a TypeC controller for the purpose of
+ handling altmode muxing and orientation switching.
+
+required:
+ - compatible
+ - reg
+ - port
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+ i2c13 {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ fsa4480@42 {
+ compatible = "fcs,fsa4480";
+ reg = <0x42>;
+
+ interrupts-extended = <&tlmm 2 IRQ_TYPE_LEVEL_LOW>;
+
+ vcc-supply = <&vreg_bob>;
+
+ mode-switch;
+ orientation-switch;
+
+ port {
+ fsa4480_ept: endpoint {
+ remote-endpoint = <&typec_controller>;
+ };
+ };
+ };
+ };
+...
--
2.33.1
In some cases multiple connections with the same connection id
needs to be resolved from a fwnode graph.
One such example is when separate hardware is used for performing muxing
and/or orientation switching of the SuperSpeed and SBU lines in a USB-C
connector. In this case the connector needs to belong to a graph with
multiple matching remote endpoints, and the TypeC controller needs to be
able to resolve them both.
Add a new API that allows this kind of lookup.
Given that the match() callback returns an opaque reference to something
provided by the client it's not possible for the implementation to
release the returned object and as such it's not possible to handle
errors, which in turn means that it's not possible to query the number
of elements or dynamically grow the results array. It's however expected
that the number of matches will be reasonably low and that the worst
case is known by the caller before hand.
Signed-off-by: Bjorn Andersson <[email protected]>
---
Changes since v1:
- Iterator in fwnode_devcon_matches() is now unsigned.
- fwnode_handle_put() node for unavailable nodes.
- Extended commit message on the subject of supporting dynamically sized
"matches" array.
drivers/base/property.c | 96 ++++++++++++++++++++++++++++++++++++++++
include/linux/property.h | 5 +++
2 files changed, 101 insertions(+)
diff --git a/drivers/base/property.c b/drivers/base/property.c
index e6497f6877ee..5230ff5c8d48 100644
--- a/drivers/base/property.c
+++ b/drivers/base/property.c
@@ -1189,6 +1189,38 @@ fwnode_graph_devcon_match(struct fwnode_handle *fwnode, const char *con_id,
return NULL;
}
+static unsigned int fwnode_graph_devcon_matches(struct fwnode_handle *fwnode,
+ const char *con_id, void *data,
+ devcon_match_fn_t match,
+ void **matches,
+ unsigned int matches_len)
+{
+ struct fwnode_handle *node;
+ struct fwnode_handle *ep;
+ unsigned int count = 0;
+ void *ret;
+
+ fwnode_graph_for_each_endpoint(fwnode, ep) {
+ if (count >= matches_len) {
+ fwnode_handle_put(ep);
+ return count;
+ }
+
+ node = fwnode_graph_get_remote_port_parent(ep);
+ if (!fwnode_device_is_available(node)) {
+ fwnode_handle_put(node);
+ continue;
+ }
+
+ ret = match(node, con_id, data);
+ fwnode_handle_put(node);
+
+ if (ret)
+ matches[count++] = ret;
+ }
+ return count;
+}
+
static void *
fwnode_devcon_match(struct fwnode_handle *fwnode, const char *con_id,
void *data, devcon_match_fn_t match)
@@ -1211,6 +1243,35 @@ fwnode_devcon_match(struct fwnode_handle *fwnode, const char *con_id,
return NULL;
}
+static unsigned int fwnode_devcon_matches(struct fwnode_handle *fwnode,
+ const char *con_id, void *data,
+ devcon_match_fn_t match,
+ void **matches,
+ unsigned int matches_len)
+{
+ struct fwnode_handle *node;
+ unsigned int count = 0;
+ unsigned int i;
+ void *ret;
+
+ for (i = 0; ; i++) {
+ if (count >= matches_len)
+ return count;
+
+ node = fwnode_find_reference(fwnode, con_id, i);
+ if (IS_ERR(node))
+ break;
+
+ ret = match(node, NULL, data);
+ fwnode_handle_put(node);
+
+ if (ret)
+ matches[count++] = ret;
+ }
+
+ return count;
+}
+
/**
* fwnode_connection_find_match - Find connection from a device node
* @fwnode: Device node with the connection
@@ -1238,3 +1299,38 @@ void *fwnode_connection_find_match(struct fwnode_handle *fwnode,
return fwnode_devcon_match(fwnode, con_id, data, match);
}
EXPORT_SYMBOL_GPL(fwnode_connection_find_match);
+
+/**
+ * fwnode_connection_find_matches - Find connections from a device node
+ * @fwnode: Device node with the connection
+ * @con_id: Identifier for the connection
+ * @data: Data for the match function
+ * @match: Function to check and convert the connection description
+ * @matches: Array of pointers to fill with matches
+ * @matches_len: Length of @matches
+ *
+ * Find up to @matches_len connections with unique identifier @con_id between
+ * @fwnode and other device nodes. @match will be used to convert the
+ * connection description to data the caller is expecting to be returned
+ * through the @matches array.
+ *
+ * Return: Number of matches resolved, of negative errno.
+ */
+int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
+ const char *con_id, void *data,
+ devcon_match_fn_t match,
+ void **matches, unsigned int matches_len)
+{
+ unsigned int count;
+
+ if (!fwnode || !match || !matches)
+ return -EINVAL;
+
+ count = fwnode_graph_devcon_matches(fwnode, con_id, data, match,
+ matches, matches_len);
+
+ return count + fwnode_devcon_matches(fwnode, con_id, data, match,
+ matches + count,
+ matches_len - count);
+}
+EXPORT_SYMBOL_GPL(fwnode_connection_find_matches);
diff --git a/include/linux/property.h b/include/linux/property.h
index 7399a0b45f98..aa7ef9d06ebe 100644
--- a/include/linux/property.h
+++ b/include/linux/property.h
@@ -446,6 +446,11 @@ static inline void *device_connection_find_match(struct device *dev,
return fwnode_connection_find_match(dev_fwnode(dev), con_id, data, match);
}
+int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
+ const char *con_id, void *data,
+ devcon_match_fn_t match,
+ void **matches, unsigned int matches_len);
+
/* -------------------------------------------------------------------------- */
/* Software fwnode support - when HW description is incomplete or missing */
--
2.33.1
On Tue, Feb 8, 2022 at 1:26 PM Bjorn Andersson
<[email protected]> wrote:
>
> The ON Semiconductor FSA4480 is a USB Type-C port multimedia switch with
> support for analog audio headsets. It allows sharing a common USB Type-C
> port to pass USB2.0 signal, analog audio, sideband use wires and analog
> microphone signal.
>
> Due to lacking upstream audio support for testing, the audio muxing is
> left untouched, but implementation of muxing the SBU lines is provided
> as a pair of TypeC mux and switch devices. This provides the necessary
> support for enabling the DisplayPort altmode on devices with this
> circuit.
...
> +config TYPEC_MUX_FSA4480
> + tristate "ON Semi FSA4480 Analog Audio Switch driver"
> + depends on I2C
> + select REGMAP_I2C
> + help
> + Driver for the ON Semiconductor FSA4480 Analog Audio Switch, which
> + provides support for muxing analog audio and sideband signals on a
> + common USB Type-C connector.
What would be the module name?
...
> +/*
> + * Copyright (C) 2021 Linaro Ltd.
2021-2022 ?
> + * Copyright (C) 2018-2020 The Linux Foundation
> + */
...
Missed mod_devicetable.h ?
...
> +#define FSA4480_ENABLE_DEVICE BIT(7)
> +#define FSA4480_ENABLE_SBU GENMASK(6, 5)
> +#define FSA4480_ENABLE_USB GENMASK(4, 3)
Don't forget to include bits.h
...
> + /* used to serialize concurrect change requests */
concurrent
...
> +static const struct regmap_config fsa4480_regmap_config = {
> + .reg_bits = 8,
> + .val_bits = 8,
> + .max_register = FSA4480_RESET,
I would create a specific macro, to avoid confusion in case if there
will be more hw revisions with slightly different register layouts.
> +};
...
> + fsa->regmap = devm_regmap_init_i2c(client, &fsa4480_regmap_config);
> + if (IS_ERR(fsa->regmap)) {
> + dev_err(dev, "failed to initialize regmap\n");
> + return PTR_ERR(fsa->regmap);
return dev_err_probe();
> + }
...
> + fsa->sw = typec_switch_register(dev, &sw_desc);
> + if (IS_ERR(fsa->sw)) {
> + dev_err(dev, "failed to register typec switch: %ld\n", PTR_ERR(fsa->sw));
> + return PTR_ERR(fsa->sw);
Ditto.
> + }
...
> + mux_desc.fwnode = dev->fwnode;
Please, avoid dereferencing fwnode, use dev_fwnode() instead.
...
> + fsa->mux = typec_mux_register(dev, &mux_desc);
> + if (IS_ERR(fsa->mux)) {
> + typec_switch_unregister(fsa->sw);
> + dev_err(dev, "failed to register typec mux: %ld\n", PTR_ERR(fsa->mux));
> + return PTR_ERR(fsa->mux);
return dev_err_probe();
> + }
...
> +static struct i2c_driver fsa4480_driver = {
> + .driver = {
> + .name = "fsa4480",
> + .of_match_table = fsa4480_of_table,
> + },
> + .probe_new = fsa4480_probe,
> + .remove = fsa4480_remove,
> + .id_table = fsa4480_table,
> +};
> +
Redundant blank line.
> +module_i2c_driver(fsa4480_driver);
--
With Best Regards,
Andy Shevchenko
The newly introduced helpers for searching for matches in the case of
multiple connections can be resused by the single-connection case, so do
this to save some duplication.
Signed-off-by: Bjorn Andersson <[email protected]>
---
Changes since v1:
- None
drivers/base/property.c | 55 ++++-------------------------------------
1 file changed, 5 insertions(+), 50 deletions(-)
diff --git a/drivers/base/property.c b/drivers/base/property.c
index 5230ff5c8d48..dfdf7164b6de 100644
--- a/drivers/base/property.c
+++ b/drivers/base/property.c
@@ -1164,31 +1164,6 @@ const void *device_get_match_data(struct device *dev)
}
EXPORT_SYMBOL_GPL(device_get_match_data);
-static void *
-fwnode_graph_devcon_match(struct fwnode_handle *fwnode, const char *con_id,
- void *data, devcon_match_fn_t match)
-{
- struct fwnode_handle *node;
- struct fwnode_handle *ep;
- void *ret;
-
- fwnode_graph_for_each_endpoint(fwnode, ep) {
- node = fwnode_graph_get_remote_port_parent(ep);
- if (!fwnode_device_is_available(node)) {
- fwnode_handle_put(node);
- continue;
- }
-
- ret = match(node, con_id, data);
- fwnode_handle_put(node);
- if (ret) {
- fwnode_handle_put(ep);
- return ret;
- }
- }
- return NULL;
-}
-
static unsigned int fwnode_graph_devcon_matches(struct fwnode_handle *fwnode,
const char *con_id, void *data,
devcon_match_fn_t match,
@@ -1221,28 +1196,6 @@ static unsigned int fwnode_graph_devcon_matches(struct fwnode_handle *fwnode,
return count;
}
-static void *
-fwnode_devcon_match(struct fwnode_handle *fwnode, const char *con_id,
- void *data, devcon_match_fn_t match)
-{
- struct fwnode_handle *node;
- void *ret;
- int i;
-
- for (i = 0; ; i++) {
- node = fwnode_find_reference(fwnode, con_id, i);
- if (IS_ERR(node))
- break;
-
- ret = match(node, NULL, data);
- fwnode_handle_put(node);
- if (ret)
- return ret;
- }
-
- return NULL;
-}
-
static unsigned int fwnode_devcon_matches(struct fwnode_handle *fwnode,
const char *con_id, void *data,
devcon_match_fn_t match,
@@ -1287,16 +1240,18 @@ void *fwnode_connection_find_match(struct fwnode_handle *fwnode,
const char *con_id, void *data,
devcon_match_fn_t match)
{
+ unsigned int count;
void *ret;
if (!fwnode || !match)
return NULL;
- ret = fwnode_graph_devcon_match(fwnode, con_id, data, match);
- if (ret)
+ count = fwnode_graph_devcon_matches(fwnode, con_id, data, match, &ret, 1);
+ if (count)
return ret;
- return fwnode_devcon_match(fwnode, con_id, data, match);
+ count = fwnode_devcon_matches(fwnode, con_id, data, match, &ret, 1);
+ return count ? ret : NULL;
}
EXPORT_SYMBOL_GPL(fwnode_connection_find_match);
--
2.33.1
On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
> In some cases multiple connections with the same connection id
> needs to be resolved from a fwnode graph.
>
> One such example is when separate hardware is used for performing muxing
> and/or orientation switching of the SuperSpeed and SBU lines in a USB-C
USB Type-C ?
> connector. In this case the connector needs to belong to a graph with
> multiple matching remote endpoints, and the TypeC controller needs to be
Type-C ?
> able to resolve them both.
>
> Add a new API that allows this kind of lookup.
>
> Given that the match() callback returns an opaque reference to something
> provided by the client it's not possible for the implementation to
> release the returned object and as such it's not possible to handle
> errors, which in turn means that it's not possible to query the number
> of elements or dynamically grow the results array. It's however expected
> that the number of matches will be reasonably low and that the worst
> case is known by the caller before hand.
...
> + fwnode_graph_for_each_endpoint(fwnode, ep) {
> + if (count >= matches_len) {
> + fwnode_handle_put(ep);
> + return count;
> + }
> +
> + node = fwnode_graph_get_remote_port_parent(ep);
> + if (!fwnode_device_is_available(node)) {
> + fwnode_handle_put(node);
> + continue;
> + }
> +
> + ret = match(node, con_id, data);
> + fwnode_handle_put(node);
> +
Redundant blank line (it seems the current style w/o this).
Ditto for the below function.
> + if (ret)
> + matches[count++] = ret;
> + }
...
> +/**
> + * fwnode_connection_find_matches - Find connections from a device node
> + * @fwnode: Device node with the connection
> + * @con_id: Identifier for the connection
> + * @data: Data for the match function
> + * @match: Function to check and convert the connection description
> + * @matches: Array of pointers to fill with matches
> + * @matches_len: Length of @matches
> + *
> + * Find up to @matches_len connections with unique identifier @con_id between
> + * @fwnode and other device nodes. @match will be used to convert the
> + * connection description to data the caller is expecting to be returned
> + * through the @matches array.
> + *
> + * Return: Number of matches resolved, of negative errno.
s/of/or/ ?
> + */
> +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> + const char *con_id, void *data,
> + devcon_match_fn_t match,
> + void **matches, unsigned int matches_len)
> +{
> + unsigned int count;
> +
> + if (!fwnode || !match || !matches)
!matches case may be still useful to get the count and allocate memory by
caller. Please, consider this case.
> + return -EINVAL;
> +
> + count = fwnode_graph_devcon_matches(fwnode, con_id, data, match,
> + matches, matches_len);
> +
> + return count + fwnode_devcon_matches(fwnode, con_id, data, match,
> + matches + count,
> + matches_len - count);
I haven't found any explanation what the difference between two counts. Also
can you define two count variables with distinct names and do something like
count_A = ...
matches += count;
matches_len -= count;
count_B = ...
return count_A + count_B;
?
> +}
--
With Best Regards,
Andy Shevchenko
Hi,
On 2/8/22 04:19, Bjorn Andersson wrote:
> This series introduces a level of indirection between the controller's view of
> a typec_mux/switch and the implementation and then expands that to support
> multiple drivers.
>
> This is needed in order to support devices such as the Qualcomm Snapdragon 888
> HDK, which does muxing and orientation handling in the QMP (USB+DP) PHY and SBU
> muxing in the external FSA4480 chip.
>
> Included in the series is a the new FSA4480 driver. This is done to deal with
> the renaming of the driver-side typec_mux -> typec_mux_dev.
I have tested patches 1-4 on a GPD win which uses a fusb302 TCPM with a pi3usb30532
mux and superspeed orientation switching as well as DP over Type-C still works fine
there, so you may add my:
Tested-by: Hans de Goede <[email protected]>
Regards,
Hans
>
> Changes since v1:
> - Omitted QMP changes from this series, as the muxing implementation needs a
> little bit more debugging.
>
> Bjorn Andersson (6):
> device property: Helper to match multiple connections
> device property: Use multi-connection matchers for single case
> typec: mux: Introduce indirection
> typec: mux: Allow multiple mux_devs per mux
> dt-bindings: usb: Add binding for fcs,fsa4480
> usb: typec: mux: Add On Semi fsa4480 driver
>
> .../devicetree/bindings/usb/fcs,fsa4480.yaml | 72 +++++
> drivers/base/property.c | 85 ++++--
> drivers/usb/typec/bus.c | 2 +-
> drivers/usb/typec/mux.c | 261 +++++++++++++-----
> drivers/usb/typec/mux.h | 12 +-
> drivers/usb/typec/mux/Kconfig | 9 +
> drivers/usb/typec/mux/Makefile | 1 +
> drivers/usb/typec/mux/fsa4480.c | 220 +++++++++++++++
> drivers/usb/typec/mux/intel_pmc_mux.c | 8 +-
> drivers/usb/typec/mux/pi3usb30532.c | 8 +-
> include/linux/property.h | 5 +
> include/linux/usb/typec_mux.h | 22 +-
> 12 files changed, 595 insertions(+), 110 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
> create mode 100644 drivers/usb/typec/mux/fsa4480.c
>
On Mon, 07 Feb 2022 19:19:43 -0800, Bjorn Andersson wrote:
> The Fairchild/ON Semiconductor FSA4480 Analog Audio switch is used in
> USB Type-C configurations for muxing analog audio onto the USB
> connector, and as such used to control the SBU signals for altmodes such
> as DisplayPort.
>
> Add a binding for this hardware block.
>
> Signed-off-by: Bjorn Andersson <[email protected]>
> ---
>
> Changes since v1:
> - None
>
> .../devicetree/bindings/usb/fcs,fsa4480.yaml | 72 +++++++++++++++++++
> 1 file changed, 72 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/usb/fcs,fsa4480.yaml
>
Reviewed-by: Rob Herring <[email protected]>
On Mon, Feb 07, 2022 at 07:19:42PM -0800, Bjorn Andersson wrote:
> In the Qualcomm platforms the USB/DP PHY handles muxing and orientation
> switching of the SuperSpeed lines, but the SBU lines needs to be
> connected and switched by external (to the SoC) hardware.
>
> It's therefor necessary to be able to have the TypeC controller operate
> multiple TypeC muxes and switches. Use the newly introduced indirection
> object to handle this, to avoid having to taint the TypeC controllers
> with knowledge about the downstream hardware configuration.
>
> The max number of devs per indirection is set to 3, which account for
> being able to mux/switch the USB HS, SS and SBU lines, as per defined
> defined in the usb-c-connector binding. This number could be grown if
> need arrises at a later point in time.
>
> Signed-off-by: Bjorn Andersson <[email protected]>
Acked-by: Heikki Krogerus <[email protected]>
> ---
>
> Changes since v1:
> - Improved the motivation for the 3 in the commit message.
> - kfree sw and mux in error paths
>
> drivers/usb/typec/mux.c | 128 ++++++++++++++++++++++++++++++++--------
> 1 file changed, 102 insertions(+), 26 deletions(-)
>
> diff --git a/drivers/usb/typec/mux.c b/drivers/usb/typec/mux.c
> index d0b42c297aca..cf2347dd1663 100644
> --- a/drivers/usb/typec/mux.c
> +++ b/drivers/usb/typec/mux.c
> @@ -17,8 +17,11 @@
> #include "class.h"
> #include "mux.h"
>
> +#define TYPEC_MUX_MAX_DEVS 3
> +
> struct typec_switch {
> - struct typec_switch_dev *sw_dev;
> + struct typec_switch_dev *sw_devs[TYPEC_MUX_MAX_DEVS];
> + unsigned int num_sw_devs;
> };
>
> static int switch_fwnode_match(struct device *dev, const void *fwnode)
> @@ -67,25 +70,50 @@ static void *typec_switch_match(struct fwnode_handle *fwnode, const char *id,
> */
> struct typec_switch *fwnode_typec_switch_get(struct fwnode_handle *fwnode)
> {
> - struct typec_switch_dev *sw_dev;
> + struct typec_switch_dev *sw_devs[TYPEC_MUX_MAX_DEVS];
> struct typec_switch *sw;
> + int count;
> + int err;
> + int i;
>
> sw = kzalloc(sizeof(*sw), GFP_KERNEL);
> if (!sw)
> return ERR_PTR(-ENOMEM);
>
> - sw_dev = fwnode_connection_find_match(fwnode, "orientation-switch", NULL,
> - typec_switch_match);
> - if (IS_ERR_OR_NULL(sw_dev)) {
> + count = fwnode_connection_find_matches(fwnode, "orientation-switch", NULL,
> + typec_switch_match,
> + (void **)sw_devs,
> + ARRAY_SIZE(sw_devs));
> + if (count <= 0) {
> kfree(sw);
> - return ERR_CAST(sw_dev);
> + return NULL;
> }
>
> - WARN_ON(!try_module_get(sw_dev->dev.parent->driver->owner));
> + for (i = 0; i < count; i++) {
> + if (IS_ERR(sw_devs[i])) {
> + err = PTR_ERR(sw_devs[i]);
> + goto put_sw_devs;
> + }
> + }
>
> - sw->sw_dev = sw_dev;
> + for (i = 0; i < count; i++) {
> + WARN_ON(!try_module_get(sw_devs[i]->dev.parent->driver->owner));
> + sw->sw_devs[i] = sw_devs[i];
> + }
> +
> + sw->num_sw_devs = count;
>
> return sw;
> +
> +put_sw_devs:
> + for (i = 0; i < count; i++) {
> + if (!IS_ERR(sw_devs[i]))
> + put_device(&sw_devs[i]->dev);
> + }
> +
> + kfree(sw);
> +
> + return ERR_PTR(err);
> }
> EXPORT_SYMBOL_GPL(fwnode_typec_switch_get);
>
> @@ -98,14 +126,17 @@ EXPORT_SYMBOL_GPL(fwnode_typec_switch_get);
> void typec_switch_put(struct typec_switch *sw)
> {
> struct typec_switch_dev *sw_dev;
> + unsigned int i;
>
> if (IS_ERR_OR_NULL(sw))
> return;
>
> - sw_dev = sw->sw_dev;
> + for (i = 0; i < sw->num_sw_devs; i++) {
> + sw_dev = sw->sw_devs[i];
>
> - module_put(sw_dev->dev.parent->driver->owner);
> - put_device(&sw_dev->dev);
> + module_put(sw_dev->dev.parent->driver->owner);
> + put_device(&sw_dev->dev);
> + }
> kfree(sw);
> }
> EXPORT_SYMBOL_GPL(typec_switch_put);
> @@ -170,13 +201,21 @@ int typec_switch_set(struct typec_switch *sw,
> enum typec_orientation orientation)
> {
> struct typec_switch_dev *sw_dev;
> + unsigned int i;
> + int ret;
>
> if (IS_ERR_OR_NULL(sw))
> return 0;
>
> - sw_dev = sw->sw_dev;
> + for (i = 0; i < sw->num_sw_devs; i++) {
> + sw_dev = sw->sw_devs[i];
> +
> + ret = sw_dev->set(sw_dev, orientation);
> + if (ret)
> + return ret;
> + }
>
> - return sw_dev->set(sw_dev, orientation);
> + return 0;
> }
> EXPORT_SYMBOL_GPL(typec_switch_set);
>
> @@ -208,7 +247,8 @@ EXPORT_SYMBOL_GPL(typec_switch_get_drvdata);
> /* ------------------------------------------------------------------------- */
>
> struct typec_mux {
> - struct typec_mux_dev *mux_dev;
> + struct typec_mux_dev *mux_devs[TYPEC_MUX_MAX_DEVS];
> + unsigned int num_mux_devs;
> };
>
> static int mux_fwnode_match(struct device *dev, const void *fwnode)
> @@ -291,25 +331,50 @@ static void *typec_mux_match(struct fwnode_handle *fwnode, const char *id,
> struct typec_mux *fwnode_typec_mux_get(struct fwnode_handle *fwnode,
> const struct typec_altmode_desc *desc)
> {
> - struct typec_mux_dev *mux_dev;
> + struct typec_mux_dev *mux_devs[TYPEC_MUX_MAX_DEVS];
> struct typec_mux *mux;
> + int count;
> + int err;
> + int i;
>
> mux = kzalloc(sizeof(*mux), GFP_KERNEL);
> if (!mux)
> return ERR_PTR(-ENOMEM);
>
> - mux_dev = fwnode_connection_find_match(fwnode, "mode-switch", (void *)desc,
> - typec_mux_match);
> - if (IS_ERR_OR_NULL(mux_dev)) {
> + count = fwnode_connection_find_matches(fwnode, "mode-switch",
> + (void *)desc, typec_mux_match,
> + (void **)mux_devs,
> + ARRAY_SIZE(mux_devs));
> + if (count <= 0) {
> kfree(mux);
> - return ERR_CAST(mux_dev);
> + return NULL;
> }
>
> - WARN_ON(!try_module_get(mux_dev->dev.parent->driver->owner));
> + for (i = 0; i < count; i++) {
> + if (IS_ERR(mux_devs[i])) {
> + err = PTR_ERR(mux_devs[i]);
> + goto put_mux_devs;
> + }
> + }
> +
> + for (i = 0; i < count; i++) {
> + WARN_ON(!try_module_get(mux_devs[i]->dev.parent->driver->owner));
> + mux->mux_devs[i] = mux_devs[i];
> + }
>
> - mux->mux_dev = mux_dev;
> + mux->num_mux_devs = count;
>
> return mux;
> +
> +put_mux_devs:
> + for (i = 0; i < count; i++) {
> + if (!IS_ERR(mux_devs[i]))
> + put_device(&mux_devs[i]->dev);
> + }
> +
> + kfree(mux);
> +
> + return ERR_PTR(err);
> }
> EXPORT_SYMBOL_GPL(fwnode_typec_mux_get);
>
> @@ -322,13 +387,16 @@ EXPORT_SYMBOL_GPL(fwnode_typec_mux_get);
> void typec_mux_put(struct typec_mux *mux)
> {
> struct typec_mux_dev *mux_dev;
> + unsigned int i;
>
> if (IS_ERR_OR_NULL(mux))
> return;
>
> - mux_dev = mux->mux_dev;
> - module_put(mux_dev->dev.parent->driver->owner);
> - put_device(&mux_dev->dev);
> + for (i = 0; i < mux->num_mux_devs; i++) {
> + mux_dev = mux->mux_devs[i];
> + module_put(mux_dev->dev.parent->driver->owner);
> + put_device(&mux_dev->dev);
> + }
> kfree(mux);
> }
> EXPORT_SYMBOL_GPL(typec_mux_put);
> @@ -336,13 +404,21 @@ EXPORT_SYMBOL_GPL(typec_mux_put);
> int typec_mux_set(struct typec_mux *mux, struct typec_mux_state *state)
> {
> struct typec_mux_dev *mux_dev;
> + unsigned int i;
> + int ret;
>
> if (IS_ERR_OR_NULL(mux))
> return 0;
>
> - mux_dev = mux->mux_dev;
> + for (i = 0; i < mux->num_mux_devs; i++) {
> + mux_dev = mux->mux_devs[i];
> +
> + ret = mux_dev->set(mux_dev, state);
> + if (ret)
> + return ret;
> + }
>
> - return mux_dev->set(mux_dev, state);
> + return 0;
> }
> EXPORT_SYMBOL_GPL(typec_mux_set);
>
> --
> 2.33.1
--
heikki
On Wed 09 Feb 04:30 PST 2022, Andy Shevchenko wrote:
> On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
> > In some cases multiple connections with the same connection id
> > needs to be resolved from a fwnode graph.
> >
> > One such example is when separate hardware is used for performing muxing
> > and/or orientation switching of the SuperSpeed and SBU lines in a USB-C
>
> USB Type-C ?
>
> > connector. In this case the connector needs to belong to a graph with
> > multiple matching remote endpoints, and the TypeC controller needs to be
>
> Type-C ?
>
> > able to resolve them both.
> >
> > Add a new API that allows this kind of lookup.
> >
> > Given that the match() callback returns an opaque reference to something
> > provided by the client it's not possible for the implementation to
> > release the returned object and as such it's not possible to handle
> > errors, which in turn means that it's not possible to query the number
> > of elements or dynamically grow the results array. It's however expected
> > that the number of matches will be reasonably low and that the worst
> > case is known by the caller before hand.
>
> ...
>
> > + fwnode_graph_for_each_endpoint(fwnode, ep) {
> > + if (count >= matches_len) {
> > + fwnode_handle_put(ep);
> > + return count;
> > + }
> > +
> > + node = fwnode_graph_get_remote_port_parent(ep);
> > + if (!fwnode_device_is_available(node)) {
> > + fwnode_handle_put(node);
> > + continue;
> > + }
> > +
> > + ret = match(node, con_id, data);
> > + fwnode_handle_put(node);
>
> > +
>
> Redundant blank line (it seems the current style w/o this).
> Ditto for the below function.
>
> > + if (ret)
> > + matches[count++] = ret;
> > + }
>
> ...
>
> > +/**
> > + * fwnode_connection_find_matches - Find connections from a device node
> > + * @fwnode: Device node with the connection
> > + * @con_id: Identifier for the connection
> > + * @data: Data for the match function
> > + * @match: Function to check and convert the connection description
> > + * @matches: Array of pointers to fill with matches
> > + * @matches_len: Length of @matches
> > + *
> > + * Find up to @matches_len connections with unique identifier @con_id between
> > + * @fwnode and other device nodes. @match will be used to convert the
> > + * connection description to data the caller is expecting to be returned
> > + * through the @matches array.
> > + *
> > + * Return: Number of matches resolved, of negative errno.
>
> s/of/or/ ?
>
> > + */
> > +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> > + const char *con_id, void *data,
> > + devcon_match_fn_t match,
> > + void **matches, unsigned int matches_len)
> > +{
> > + unsigned int count;
> > +
> > + if (!fwnode || !match || !matches)
>
> !matches case may be still useful to get the count and allocate memory by
> caller. Please, consider this case.
>
As discussed in previous version, and described in the commit message,
the returned value of "match" is a opaque pointer to something which
has to be passed back to the caller in order to be cleaned up.
E.g. the typec mux code returns a pointer to a typec_mux/switch object
with a refcounted struct device within, or an ERR_PTR().
So unfortunately we can must gather the results into matches and pass it
back to the caller to take consume or clean up.
Thanks for your review, I'll update the patches according to the
other feedback.
Regards,
Bjorn
> > + return -EINVAL;
> > +
> > + count = fwnode_graph_devcon_matches(fwnode, con_id, data, match,
> > + matches, matches_len);
> > +
> > + return count + fwnode_devcon_matches(fwnode, con_id, data, match,
> > + matches + count,
> > + matches_len - count);
>
> I haven't found any explanation what the difference between two counts. Also
> can you define two count variables with distinct names and do something like
>
> count_A = ...
>
> matches += count;
> matches_len -= count;
>
> count_B = ...
>
> return count_A + count_B;
>
> ?
>
> > +}
>
> --
> With Best Regards,
> Andy Shevchenko
>
>
On Sun 20 Feb 03:16 PST 2022, Andy Shevchenko wrote:
> On Fri, Feb 18, 2022 at 11:00:45AM -0800, Bjorn Andersson wrote:
> > On Wed 09 Feb 04:30 PST 2022, Andy Shevchenko wrote:
> > > On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
>
> ...
>
> > > > +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> > > > + const char *con_id, void *data,
> > > > + devcon_match_fn_t match,
> > > > + void **matches, unsigned int matches_len)
> > > > +{
> > > > + unsigned int count;
> > > > +
> > > > + if (!fwnode || !match || !matches)
> > >
> > > !matches case may be still useful to get the count and allocate memory by
> > > caller. Please, consider this case.
> > >
> >
> > As discussed in previous version, and described in the commit message,
> > the returned value of "match" is a opaque pointer to something which
> > has to be passed back to the caller in order to be cleaned up.
> >
> > E.g. the typec mux code returns a pointer to a typec_mux/switch object
> > with a refcounted struct device within, or an ERR_PTR().
> >
> > So unfortunately we can must gather the results into matches and pass it
> > back to the caller to take consume or clean up.
>
>
> It's fine. You have **matches, means pointer of an opaque pointer.
> What I'm talking about is memory allocation for and array of _pointers_.
> That's what caller very much aware of and can allocate on heap. So, please
> consider this case.
>
I'm sorry, but I'm not sure what you're looking for.
I still interpret your comment as that it would be nice to be able to do
something like:
count = fwnode_connection_find_matches(fwnode, "orientation-switch",
NULL, typec_switch_match, NULL, 0);
based on the returned value the caller could allocate an array of
"count" pointers and then call the function again to actually fill out
the count elements.
The problem with this is that, typec_switch_match() does:
void *typec_switch_match(fwnode, id, data) {
struct device *dev = find_struct_device(fwnode, id);
if (!dev)
return NULL;
get_device(dev);
return container_of(dev, struct typec_switch, dev);
}
So if we call the match function and if that finds a "dev" it will
return a struct typec_switch with a refcounted struct device within.
We can see if that's NULL or not and will be able to return a "count",
but we have no way of releasing the reference acquired - we must return
the void pointer back to the client, so that it can release it.
My claim is that this is not a problem, because this works fine with any
reasonable size of fwnode graphs we might run into - and the client will
in general have a sense of the worst case number of matches (in this
series its 3, as there's 3 types of lanes that can be switched/muxed
coming out of a USB connector).
But that's perhaps not what you're referring to? Or perhaps I'm missing
something else?
Regards,
Bjorn
On Fri, Feb 18, 2022 at 11:00:45AM -0800, Bjorn Andersson wrote:
> On Wed 09 Feb 04:30 PST 2022, Andy Shevchenko wrote:
> > On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
...
> > > +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> > > + const char *con_id, void *data,
> > > + devcon_match_fn_t match,
> > > + void **matches, unsigned int matches_len)
> > > +{
> > > + unsigned int count;
> > > +
> > > + if (!fwnode || !match || !matches)
> >
> > !matches case may be still useful to get the count and allocate memory by
> > caller. Please, consider this case.
> >
>
> As discussed in previous version, and described in the commit message,
> the returned value of "match" is a opaque pointer to something which
> has to be passed back to the caller in order to be cleaned up.
>
> E.g. the typec mux code returns a pointer to a typec_mux/switch object
> with a refcounted struct device within, or an ERR_PTR().
>
> So unfortunately we can must gather the results into matches and pass it
> back to the caller to take consume or clean up.
It's fine. You have **matches, means pointer of an opaque pointer.
What I'm talking about is memory allocation for and array of _pointers_.
That's what caller very much aware of and can allocate on heap. So, please
consider this case.
--
With Best Regards,
Andy Shevchenko
On Sun, Feb 20, 2022 at 08:55:10PM -0800, Bjorn Andersson wrote:
> On Sun 20 Feb 03:16 PST 2022, Andy Shevchenko wrote:
> > On Fri, Feb 18, 2022 at 11:00:45AM -0800, Bjorn Andersson wrote:
> > > On Wed 09 Feb 04:30 PST 2022, Andy Shevchenko wrote:
> > > > On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
...
> > > > > +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> > > > > + const char *con_id, void *data,
> > > > > + devcon_match_fn_t match,
> > > > > + void **matches, unsigned int matches_len)
> > > > > +{
> > > > > + unsigned int count;
> > > > > +
> > > > > + if (!fwnode || !match || !matches)
> > > >
> > > > !matches case may be still useful to get the count and allocate memory by
> > > > caller. Please, consider this case.
> > >
> > > As discussed in previous version, and described in the commit message,
> > > the returned value of "match" is a opaque pointer to something which
> > > has to be passed back to the caller in order to be cleaned up.
> > >
> > > E.g. the typec mux code returns a pointer to a typec_mux/switch object
> > > with a refcounted struct device within, or an ERR_PTR().
> > >
> > > So unfortunately we can must gather the results into matches and pass it
> > > back to the caller to take consume or clean up.
> >
> > It's fine. You have **matches, means pointer of an opaque pointer.
> > What I'm talking about is memory allocation for and array of _pointers_.
> > That's what caller very much aware of and can allocate on heap. So, please
> > consider this case.
>
> I'm sorry, but I'm not sure what you're looking for.
>
>
> I still interpret your comment as that it would be nice to be able to do
> something like:
>
> count = fwnode_connection_find_matches(fwnode, "orientation-switch",
> NULL, typec_switch_match, NULL, 0);
>
> based on the returned value the caller could allocate an array of
> "count" pointers and then call the function again to actually fill out
> the count elements.
Yes, that's what I want from the generic fwnode APIs.
(Keyword: generic)
> The problem with this is that, typec_switch_match() does:
As you stated, the problem is in the typec_switch_match(). So, it's not related
to the fwnode, but how you are using it.
> void *typec_switch_match(fwnode, id, data) {
> struct device *dev = find_struct_device(fwnode, id);
> if (!dev)
> return NULL;
> get_device(dev);
> return container_of(dev, struct typec_switch, dev);
> }
>
> So if we call the match function and if that finds a "dev" it will
> return a struct typec_switch with a refcounted struct device within.
fwnode (as being an abstraction on top of the others) has no knowledge
about this. And more important should not know that.
> We can see if that's NULL or not and will be able to return a "count",
> but we have no way of releasing the reference acquired - we must return
> the void pointer back to the client, so that it can release it.
The caller (if it wants to!) may create different callbacks for count and real
matching, no?
> My claim is that this is not a problem, because this works fine with any
> reasonable size of fwnode graphs we might run into - and the client will
> in general have a sense of the worst case number of matches (in this
> series its 3, as there's 3 types of lanes that can be switched/muxed
> coming out of a USB connector).
--
With Best Regards,
Andy Shevchenko
On Mon 21 Feb 09:19 PST 2022, Andy Shevchenko wrote:
> On Sun, Feb 20, 2022 at 08:55:10PM -0800, Bjorn Andersson wrote:
> > On Sun 20 Feb 03:16 PST 2022, Andy Shevchenko wrote:
> > > On Fri, Feb 18, 2022 at 11:00:45AM -0800, Bjorn Andersson wrote:
> > > > On Wed 09 Feb 04:30 PST 2022, Andy Shevchenko wrote:
> > > > > On Mon, Feb 07, 2022 at 07:19:39PM -0800, Bjorn Andersson wrote:
>
> ...
>
> > > > > > +int fwnode_connection_find_matches(struct fwnode_handle *fwnode,
> > > > > > + const char *con_id, void *data,
> > > > > > + devcon_match_fn_t match,
> > > > > > + void **matches, unsigned int matches_len)
> > > > > > +{
> > > > > > + unsigned int count;
> > > > > > +
> > > > > > + if (!fwnode || !match || !matches)
> > > > >
> > > > > !matches case may be still useful to get the count and allocate memory by
> > > > > caller. Please, consider this case.
> > > >
> > > > As discussed in previous version, and described in the commit message,
> > > > the returned value of "match" is a opaque pointer to something which
> > > > has to be passed back to the caller in order to be cleaned up.
> > > >
> > > > E.g. the typec mux code returns a pointer to a typec_mux/switch object
> > > > with a refcounted struct device within, or an ERR_PTR().
> > > >
> > > > So unfortunately we can must gather the results into matches and pass it
> > > > back to the caller to take consume or clean up.
> > >
> > > It's fine. You have **matches, means pointer of an opaque pointer.
> > > What I'm talking about is memory allocation for and array of _pointers_.
> > > That's what caller very much aware of and can allocate on heap. So, please
> > > consider this case.
> >
> > I'm sorry, but I'm not sure what you're looking for.
> >
> >
> > I still interpret your comment as that it would be nice to be able to do
> > something like:
> >
> > count = fwnode_connection_find_matches(fwnode, "orientation-switch",
> > NULL, typec_switch_match, NULL, 0);
> >
> > based on the returned value the caller could allocate an array of
> > "count" pointers and then call the function again to actually fill out
> > the count elements.
>
> Yes, that's what I want from the generic fwnode APIs.
> (Keyword: generic)
>
> > The problem with this is that, typec_switch_match() does:
>
> As you stated, the problem is in the typec_switch_match(). So, it's not related
> to the fwnode, but how you are using it.
>
> > void *typec_switch_match(fwnode, id, data) {
> > struct device *dev = find_struct_device(fwnode, id);
> > if (!dev)
> > return NULL;
> > get_device(dev);
> > return container_of(dev, struct typec_switch, dev);
> > }
> >
> > So if we call the match function and if that finds a "dev" it will
> > return a struct typec_switch with a refcounted struct device within.
>
> fwnode (as being an abstraction on top of the others) has no knowledge
> about this. And more important should not know that.
>
> > We can see if that's NULL or not and will be able to return a "count",
> > but we have no way of releasing the reference acquired - we must return
> > the void pointer back to the client, so that it can release it.
>
> The caller (if it wants to!) may create different callbacks for count and real
> matching, no?
>
Ahh, yeah you're right, we can shift this responsibility onto the caller
and thereby allow them to implement the count as well. Makes sense!
Thanks,
Bjorn
> > My claim is that this is not a problem, because this works fine with any
> > reasonable size of fwnode graphs we might run into - and the client will
> > in general have a sense of the worst case number of matches (in this
> > series its 3, as there's 3 types of lanes that can be switched/muxed
> > coming out of a USB connector).
>
> --
> With Best Regards,
> Andy Shevchenko
>
>