From nobody Thu Sep 19 23:17:16 2024 Received: from mail-pg1-f177.google.com (mail-pg1-f177.google.com [209.85.215.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 468591CFEAF for ; Wed, 4 Sep 2024 09:01:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.177 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1725440461; cv=none; b=Y9OhY+yZu7pfTPBt5C8HfuxQFojYH6c/BaID889HieU+G2+jFjvBJXdagc733roQhM+8DDz/gsaQIXOmZ+bBVc8oS7AwYWjhCiMHWjIcirre6r2yzcwC1Zxai4jV9U77qiIx/zdkS9IkjnWZj0B1WCV+hJeAFelb4CTMzudEkw4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1725440461; c=relaxed/simple; bh=4K305JIRgo5Lt75f2UfKKVi9Egt/vEF85rIFriq9DXc=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=CFgIj80acGmhX9Jezbo7zaBf+B0KDP7qpzODEx4A3zRpP+/8WRPg/+9L9PbiBnL9HsFh2JHueS6InWusW3UZNtBzfKjrK5q/OL56f9rkwlVx2DcuDlFsjXO7kCSeSldhhX1LuiCn3QhDtxBHelhaq+q2LN1evuy5ElkV8phQf5g= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org; spf=pass smtp.mailfrom=chromium.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b=LeEDUwzC; arc=none smtp.client-ip=209.85.215.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=chromium.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b="LeEDUwzC" Received: by mail-pg1-f177.google.com with SMTP id 41be03b00d2f7-7cd967d8234so3823959a12.2 for ; Wed, 04 Sep 2024 02:01:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1725440459; x=1726045259; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=DwAJluv0Exq9EadYfBSyNeJ8D4Ka/sU/iYmJbm5J4eo=; b=LeEDUwzCaIOKV3GR1pJDR0BbLlVGzv7YEmM20hEe87dm7fwZitVx8VO56BZiS8gXEq dYeNRAvK33FGpvS/8ev3GUC/ShayTJJVhqggfnZOVGlmQiHLYpCMC+T3j8+Y1TQxGN2A vou+TtuI0Ru7HKUV+LaWXlWC3czAMQ8f5umBU= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725440459; x=1726045259; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=DwAJluv0Exq9EadYfBSyNeJ8D4Ka/sU/iYmJbm5J4eo=; b=fq9GC337iXQEkrtOA+WONJ2xrmd4zEQpifug/lLS3r2aZ8tv/f2QIMfjXYJf0g/U+h oNJz42SQBNTidHGPBwfMYUJBWgx1BRBtlNQSHtWIaWtGDZrngODcQi8p81RYchFGLRD9 J8bhqcDKDQPf7YvMZSihVUZdCqLRXM6sJs8WvIPmGQxMKIVh9nf8Xj+QnqDd7lDkCLYC Q6LE/XrMORQjPxyWFpfsndFMfNhVW7d/wH6O7/pJiFNYhc6qGEyJHmYVadNG4pk8KFpx 7fNwb2sVYwRjSiax+9EiwpCmbdClOIcgcSSI8TlGVanvCbvBROibbI4zP+R2p1/AsjpZ rfig== X-Forwarded-Encrypted: i=1; AJvYcCWxXYT3rc8mOs6MBAJBOrzyaiJARygLYeyjHlG4VaGvW+cYqUnZk2oJEpbS98Z+PVzPyqhv2o+uPqfenbQ=@vger.kernel.org X-Gm-Message-State: AOJu0Yx5tC1tfGbawmk6OjLwgpUh5d4u2qanNMXOjTIyXm44p4BvuIkv BbCvG7Q2gmsKakH34TGjptwPCAi58ULV39DRxsXahgnfsswk+5/AzStV+fyxRA== X-Google-Smtp-Source: AGHT+IFFqCnmeBWZ9aXSqOpUywkoxinPfwTNU43tOQwWBlrfj1Rm3kLKZ4eIZFoE+WAsIUVUCM7mHQ== X-Received: by 2002:a05:6a21:1813:b0:1cd:f065:4ef7 with SMTP id adf61e73a8af0-1ced0469052mr12363435637.19.1725440459454; Wed, 04 Sep 2024 02:00:59 -0700 (PDT) Received: from wenstp920.tpe.corp.google.com ([2401:fa00:1:10:83fc:5c8e:13bd:d165]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-717785b5183sm1153279b3a.197.2024.09.04.02.00.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 02:00:59 -0700 (PDT) From: Chen-Yu Tsai To: Rob Herring , Saravana Kannan , Matthias Brugger , AngeloGioacchino Del Regno , Wolfram Sang , Benson Leung , Tzung-Bi Shih , Mark Brown , Liam Girdwood Cc: Chen-Yu Tsai , chrome-platform@lists.linux.dev, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, linux-kernel@vger.kernel.org, Douglas Anderson , Johan Hovold , Jiri Kosina , Andy Shevchenko , linux-i2c@vger.kernel.org Subject: [PATCH v6 10/12] i2c: of-prober: Add GPIO support Date: Wed, 4 Sep 2024 17:00:12 +0800 Message-ID: <20240904090016.2841572-11-wenst@chromium.org> X-Mailer: git-send-email 2.46.0.469.g59c65b2a67-goog In-Reply-To: <20240904090016.2841572-1-wenst@chromium.org> References: <20240904090016.2841572-1-wenst@chromium.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This adds GPIO management to the I2C OF component prober. Components that the prober intends to probe likely require their regulator supplies be enabled, and GPIOs be toggled to enable them or bring them out of reset before they will respond to probe attempts. regulator support was added in the previous patch. Without specific knowledge of each component's resource names or power sequencing requirements, the prober can only enable the regulator supplies all at once, and toggle the GPIOs all at once. Luckily, reset pins tend to be active low, while enable pins tend to be active high, so setting the raw status of all GPIO pins to high should work. The wait time before and after resources are enabled are collected from existing drivers and device trees. The prober collects resources from all possible components and enables them together, instead of enabling resources and probing each component one by one. The latter approach does not provide any boot time benefits over simply enabling each component and letting each driver probe sequentially. The prober will also deduplicate the resources, since on a component swap out or co-layout design, the resources are always the same. While duplicate regulator supplies won't cause much issue, shared GPIOs don't work reliably, especially with other drivers. For the same reason, the prober will release the GPIOs before the successfully probed component is actually enabled. Signed-off-by: Chen-Yu Tsai --- Changes since v5: - Renamed "con" to "propname" in i2c_of_probe_get_gpiod() - Copy string first and check return value of strscpy() for overflow in i2c_of_probe_get_gpiod() - Add parenthesis around "enable" and "reset" GPIO names in comments - Split resource count debug message into two separate lines - Split out GPIO helper from i2c_of_probe_enable_res() to keep code cleaner following the previous patch - Adopted options for customizing power sequencing delay following previous patch Changes since v4: - Split out from previous patch - Moved GPIO property name check to common function in gpiolib.c in new patch - Moved i2c_of_probe_free_gpios() into for_each_child_of_node_scoped() - Rewrote in gpiod_*_array-esque fashion --- drivers/i2c/i2c-core-of-prober.c | 143 ++++++++++++++++++++++++++++++- include/linux/i2c.h | 2 + 2 files changed, 144 insertions(+), 1 deletion(-) diff --git a/drivers/i2c/i2c-core-of-prober.c b/drivers/i2c/i2c-core-of-pro= ber.c index 56b06ad7aa64..04242ff86e69 100644 --- a/drivers/i2c/i2c-core-of-prober.c +++ b/drivers/i2c/i2c-core-of-prober.c @@ -5,16 +5,19 @@ * Copyright (C) 2024 Google LLC */ =20 +#include #include #include #include #include #include +#include #include #include #include #include #include +#include =20 /* * Some devices, such as Google Hana Chromebooks, are produced by multiple @@ -29,12 +32,14 @@ * address responds. * * TODO: - * - Support handling common GPIOs. + * - Support inverted polarity GPIOs, such as electrical high to "disable". + * Seen on some OmniVision camera sensors. * - Support I2C muxes */ =20 struct i2c_of_probe_data { const struct i2c_of_probe_opts *opts; + struct gpio_descs *gpiods; struct regulator_bulk_data *regulators; unsigned int regulators_num; }; @@ -85,10 +90,90 @@ static void i2c_of_probe_free_regulators(struct i2c_of_= probe_data *data) regulator_bulk_free(data->regulators_num, data->regulators); data->regulators_num =3D 0; data->regulators =3D NULL; +}; + +/* + * Returns 1 if property is GPIO and GPIO successfully requested, + * 0 if not a GPIO property, or error if request for GPIO failed. + */ +static int i2c_of_probe_get_gpiod(struct device_node *node, struct propert= y *prop, + struct i2c_of_probe_data *data) +{ + struct fwnode_handle *fwnode =3D of_fwnode_handle(node); + struct gpio_descs *gpiods; + struct gpio_desc *gpiod; + char propname[32]; /* 32 is max size of property name */ + char *con_id =3D NULL; + size_t new_size; + int len, ret; + + len =3D gpio_get_property_name_length(prop->name); + if (len < 0) + return 0; + + ret =3D strscpy(propname, prop->name); + if (ret < 0) { + pr_err("%pOF: length of GPIO name \"%s\" exceeds current limit\n", + node, prop->name); + return -EINVAL; + } + + if (len > 0) { + /* "len < ARRAY_SIZE(propname)" guaranteed by strscpy() above */ + propname[len] =3D '\0'; + con_id =3D propname; + } + + /* + * GPIO descriptors are not reference counted. GPIOD_FLAGS_BIT_NONEXCLUSI= VE + * can't differentiate between GPIOs shared between devices to be probed = and + * other devices (which is incorrect). If the initial request fails with + * -EBUSY, retry with GPIOD_FLAGS_BIT_NONEXCLUSIVE and see if it matches + * any existing ones. + */ + gpiod =3D fwnode_gpiod_get_index(fwnode, con_id, 0, GPIOD_ASIS, "i2c-of-p= rober"); + if (IS_ERR(gpiod)) { + if (PTR_ERR(gpiod) !=3D -EBUSY || !data->gpiods) + return PTR_ERR(gpiod); + + gpiod =3D fwnode_gpiod_get_index(fwnode, con_id, 0, + GPIOD_ASIS | GPIOD_FLAGS_BIT_NONEXCLUSIVE, + "i2c-of-prober"); + for (unsigned int i =3D 0; i < data->gpiods->ndescs; i++) + if (gpiod =3D=3D data->gpiods->desc[i]) + return 1; + + return -EBUSY; + } + + new_size =3D struct_size(gpiods, desc, data->gpiods ? data->gpiods->ndesc= s + 1 : 1); + gpiods =3D krealloc(data->gpiods, new_size, GFP_KERNEL); + if (!gpiods) { + gpiod_put(gpiod); + return -ENOMEM; + } + + data->gpiods =3D gpiods; + data->gpiods->desc[data->gpiods->ndescs++] =3D gpiod; + + return 1; +} + +/* + * This is split into two functions because in the normal flow the GPIOs + * have to be released before the actual driver probes so that the latter + * can acquire them. + */ +static void i2c_of_probe_free_gpios(struct i2c_of_probe_data *data) +{ + if (data->gpiods) + gpiod_put_array(data->gpiods); + data->gpiods =3D NULL; } =20 static void i2c_of_probe_free_res(struct i2c_of_probe_data *data) { + i2c_of_probe_free_gpios(data); i2c_of_probe_free_regulators(data); } =20 @@ -104,6 +189,18 @@ static int i2c_of_probe_get_res(struct device *dev, st= ruct device_node *node, goto err_cleanup; } =20 + for_each_property_of_node(node, prop) { + dev_dbg(dev, "Trying property %pOF/%s\n", node, prop->name); + + /* GPIOs */ + ret =3D i2c_of_probe_get_gpiod(node, prop, data); + if (ret < 0) { + dev_err_probe(dev, ret, "Failed to get GPIO from %pOF/%s\n", + node, prop->name); + goto err_cleanup; + } + } + return 0; =20 err_cleanup: @@ -131,6 +228,37 @@ static void i2c_of_probe_disable_regulators(struct i2c= _of_probe_data *data) regulator_bulk_disable(data->regulators_num, data->regulators); } =20 +static int i2c_of_probe_set_gpios(struct device *dev, struct i2c_of_probe_= data *data) +{ + int ret; + int gpio_i; + + if (!data->gpiods) + return 0; + + for (gpio_i =3D 0; gpio_i < data->gpiods->ndescs; gpio_i++) { + /* + * "reset" GPIOs normally have opposite polarity compared to + * "enable" GPIOs. Instead of parsing the flags again, simply + * set the raw value to high. + */ + dev_dbg(dev, "Setting GPIO %d\n", gpio_i); + ret =3D gpiod_direction_output_raw(data->gpiods->desc[gpio_i], 1); + if (ret) + goto disable_gpios; + } + + msleep(data->opts->post_reset_deassert_delay_ms); + + return 0; + +disable_gpios: + for (gpio_i--; gpio_i >=3D 0; gpio_i--) + gpiod_set_raw_value_cansleep(data->gpiods->desc[gpio_i], 0); + + return ret; +} + static int i2c_of_probe_enable_res(struct device *dev, struct i2c_of_probe= _data *data) { int ret; @@ -139,7 +267,15 @@ static int i2c_of_probe_enable_res(struct device *dev,= struct i2c_of_probe_data if (ret) return ret; =20 + ret =3D i2c_of_probe_set_gpios(dev, data); + if (ret) + goto err_disable_regulators; + return 0; + +err_disable_regulators: + i2c_of_probe_disable_regulators(data); + return ret; } =20 static struct device_node *i2c_of_probe_get_i2c_node(struct device *dev, c= onst char *type) @@ -191,6 +327,8 @@ static int i2c_of_probe_enable_node(struct device *dev,= struct device_node *node static const struct i2c_of_probe_opts i2c_of_probe_opts_default =3D { /* largest post-power-on pre-reset-deassert delay seen among drivers */ .post_power_on_delay_ms =3D 500, + /* largest post-reset-deassert delay seen in tree for Elan I2C HID */ + .post_reset_deassert_delay_ms =3D 300, }; =20 /** @@ -264,6 +402,8 @@ int i2c_of_probe_component(struct device *dev, const ch= ar *type, const struct i2 } =20 dev_dbg(dev, "Resources: # of regulator supplies =3D %d\n", probe_data.re= gulators_num); + dev_dbg(dev, "Resources: # of GPIOs =3D %d\n", + probe_data.gpiods ? probe_data.gpiods->ndescs : 0); =20 /* Enable resources */ ret =3D i2c_of_probe_enable_res(dev, &probe_data); @@ -283,6 +423,7 @@ int i2c_of_probe_component(struct device *dev, const ch= ar *type, const struct i2 continue; =20 /* Found a device that is responding */ + i2c_of_probe_free_gpios(&probe_data); ret =3D i2c_of_probe_enable_node(dev, node); break; } diff --git a/include/linux/i2c.h b/include/linux/i2c.h index dbcdb8edbf6f..0da1edddb5a2 100644 --- a/include/linux/i2c.h +++ b/include/linux/i2c.h @@ -1037,9 +1037,11 @@ int of_i2c_get_board_info(struct device *dev, struct= device_node *node, /** * i2c_of_probe_opts - I2C OF component prober customization options * @post_power_on_delay_us: Delay in ms after regulators are powered on. P= assed to msleep(). + * @post_reset_deassert_delay_ms: Delay in ms after GPIOs are set. Passed = to msleep(). */ struct i2c_of_probe_opts { unsigned int post_power_on_delay_ms; + unsigned int post_reset_deassert_delay_ms; }; =20 int i2c_of_probe_component(struct device *dev, const char *type, const str= uct i2c_of_probe_opts *opts); --=20 2.46.0.469.g59c65b2a67-goog