Re: [PATCH v4 7/8] platform/x86: Add intel_skl_int3472 driver
From: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Date: 2021-05-21 12:58:08
Also in:
linux-acpi, linux-arm-kernel, linux-i2c, lkml, platform-driver-x86
On Thu, May 20, 2021 at 03:09:27PM +0100, Daniel Scally wrote:
ACPI devices with _HID INT3472 are currently matched to the tps68470 driver, however this does not cover all situations in which that _HID occurs. We've encountered three possibilities: 1. On Chrome OS devices, an ACPI device with _HID INT3472 (representing a physical TPS68470 device) that requires a GPIO and OpRegion driver 2. On devices designed for Windows, an ACPI device with _HID INT3472 (again representing a physical TPS68470 device) which requires GPIO, Clock and Regulator drivers. 3. On other devices designed for Windows, an ACPI device with _HID INT3472 which does **not** represent a physical TPS68470, and is instead used as a dummy device to group some system GPIO lines which are meant to be consumed by the sensor that is dependent on this entry. This commit adds a new module, registering a platform driver to deal with the 3rd scenario plus an i2c driver to deal with #1 and #2, by querying the CLDB buffer found against INT3472 entries to determine which is most appropriate.
...
create mode 100644 drivers/platform/x86/intel-int3472/Kconfig create mode 100644 drivers/platform/x86/intel-int3472/Makefile create mode 100644 drivers/platform/x86/intel-int3472/intel_skl_int3472_clk_and_regulator.c create mode 100644 drivers/platform/x86/intel-int3472/intel_skl_int3472_common.c create mode 100644 drivers/platform/x86/intel-int3472/intel_skl_int3472_common.h create mode 100644 drivers/platform/x86/intel-int3472/intel_skl_int3472_discrete.c create mode 100644 drivers/platform/x86/intel-int3472/intel_skl_int3472_tps68470.c
I would rather see this under .../intel/int3472/ but this we may do later on. ...
quoted hunk ↗ jump to hunk
+INTEL SKYLAKE INT3472 ACPI DEVICE DRIVER +M: Daniel Scally <djrscally@gmail.com> +S: Maintained +F: drivers/platform/x86/intel-int3472/intel_skl_int3472_*
F: drivers/platform/x86/intel-int3472/ Should be sufficient. ...
quoted hunk ↗ jump to hunk
+ help + This driver adds support for the INT3472 ACPI devices found on some + Intel SkyLake devices.
I would rephrase this "This driver adds power controller support for the Intel SkyCam devices found on the Intel SkyLake platforms." (Technically speaking this IP is in the entire CPU family, but may be switched off) It's also possible to google for better text based on what Windows says about it.
+ The INT3472 is an Intel camera power controller, a logical device + found on some Skylake-based systems that can map to different
"The INT3472 is a camera power controller, a logical device found on some Intel Skylake-based systems that can map to different..."
quoted hunk ↗ jump to hunk
+ hardware devices depending on the platform. On machines + designed for Chrome OS, it maps to a TPS68470 camera PMIC. On + machines designed for Windows, it maps to either a TP68470 + camera PMIC, a uP6641Q sensor PMIC, or a set of discrete GPIOs + and power gates. + + If your device was designed for Chrome OS, this driver will provide + an ACPI OpRegion, which must be available before any of the devices + using it are probed. For this reason, you should select Y if your + device was designed for ChromeOS. For the same reason the + I2C_DESIGNWARE_PLATFORM option must be set to Y too. + + Say Y or M here if you have a SkyLake device designed for use + with Windows or ChromeOS. Say N here if you are not sure. + + The module will be named "intel-skl-int3472"
Period missed. ...
quoted hunk ↗ jump to hunk
+/* + * The regulators have to have .ops to be valid, but the only ops we actually + * support are .enable and .disable which are handled via .ena_gpiod. Pass an + * empty struct to clear the check without lying about capabilities. + */ +static const struct regulator_ops int3472_gpio_regulator_ops;
Hmm... Can you use 'reg-fixed-voltage' platform device instead? One example, although gone from upstream, but available in the tree, I can point to is this: git log -p -- arch/x86/platform/intel-mid/device_libs/platform_bcm43xx.c It uses constant structures, but I think you may dynamically generate the necessary ones. ...
quoted hunk ↗ jump to hunk
+static int skl_int3472_clk_prepare(struct clk_hw *hw) +{ + struct int3472_gpio_clock *clk = to_int3472_clk(hw); + + gpiod_set_value(clk->ena_gpio, 1); + gpiod_set_value(clk->led_gpio, 1); + + return 0; +} + +static void skl_int3472_clk_unprepare(struct clk_hw *hw) +{ + struct int3472_gpio_clock *clk = to_int3472_clk(hw); + + gpiod_set_value(clk->ena_gpio, 0); + gpiod_set_value(clk->led_gpio, 0); +} + +static int skl_int3472_clk_enable(struct clk_hw *hw) +{ + /* + * We're just turning a GPIO on to enable the clock, which operation + * has the potential to sleep. Given .enable() cannot sleep, but + * .prepare() can, we toggle the GPIO in .prepare() instead. Thus, + * nothing to do here. + */
It's a nice comment, but you are using non-sleeping GPIO value setters. Perhaps you need to replace them with gpiod_set_value_cansleep()?
+ return 0; +}
...
quoted hunk ↗ jump to hunk
+static unsigned int skl_int3472_get_clk_frequency(struct int3472_discrete_device *int3472) +{ + union acpi_object *obj; + unsigned int freq; + + obj = skl_int3472_get_acpi_buffer(int3472->sensor, "SSDB"); + if (IS_ERR(obj)) + return 0; /* report rate as 0 on error */ + + if (obj->buffer.length < CIO2_SENSOR_SSDB_MCLKSPEED_OFFSET + sizeof(u32)) { + dev_err(int3472->dev, "The buffer is too small\n");
+ goto out_free_buff;
First of all, freq will be uninitialized here. I'm wondering if you can simple drop the goto and replace it with direct steps, i.e. kfree(obj); return 0;
quoted hunk ↗ jump to hunk
+ } + + freq = *(u32 *)(obj->buffer.pointer + CIO2_SENSOR_SSDB_MCLKSPEED_OFFSET); + +out_free_buff: + kfree(obj); + return freq; +}
...
quoted hunk ↗ jump to hunk
+int skl_int3472_register_clock(struct int3472_discrete_device *int3472) +{ + struct clk_init_data init = { + .ops = &skl_int3472_clock_ops, + .flags = CLK_GET_RATE_NOCACHE, + };
+ int ret = 0;
I would not assign it here. See below.
quoted hunk ↗ jump to hunk
+ init.name = kasprintf(GFP_KERNEL, "%s-clk", + acpi_dev_name(int3472->adev)); + if (!init.name) + return -ENOMEM; + + int3472->clock.frequency = skl_int3472_get_clk_frequency(int3472); + + int3472->clock.clk_hw.init = &init; + int3472->clock.clk = clk_register(&int3472->adev->dev, + &int3472->clock.clk_hw); + if (IS_ERR(int3472->clock.clk)) { + ret = PTR_ERR(int3472->clock.clk); + goto out_free_init_name; + } + + int3472->clock.cl = clkdev_create(int3472->clock.clk, NULL, + int3472->sensor_name); + if (!int3472->clock.cl) { + ret = -ENOMEM; + goto err_unregister_clk; + }
+ goto out_free_init_name;
Better pattern is kfree(init.name); return 0; directly here.
quoted hunk ↗ jump to hunk
+err_unregister_clk: + clk_unregister(int3472->clock.clk); +out_free_init_name: + kfree(init.name); + + return ret; +}
...
+union acpi_object *skl_int3472_get_acpi_buffer(struct acpi_device *adev, + char *id)
One line? ...
quoted hunk ↗ jump to hunk
+int skl_int3472_fill_cldb(struct acpi_device *adev, struct int3472_cldb *cldb) +{ + union acpi_object *obj;
+ int ret = 0;
I would assign it closer to the real use, see below.
quoted hunk ↗ jump to hunk
+ obj = skl_int3472_get_acpi_buffer(adev, "CLDB"); + if (IS_ERR(obj)) + return PTR_ERR(obj); + + if (obj->buffer.length > sizeof(*cldb)) { + acpi_handle_err(adev->handle, "The CLDB buffer is too large\n"); + ret = -EINVAL; + goto out_free_obj; + } + + memcpy(cldb, obj->buffer.pointer, obj->buffer.length);
ret = 0;
quoted hunk ↗ jump to hunk
+out_free_obj: + kfree(obj); + return ret; +}
...
+union acpi_object *skl_int3472_get_acpi_buffer(struct acpi_device *adev, + char *id);
One line? ...
quoted hunk ↗ jump to hunk
+static const struct int3472_sensor_config * +skl_int3472_get_sensor_module_config(struct int3472_discrete_device *int3472) +{ + const struct int3472_sensor_config *ret; + union acpi_object *obj; + unsigned int i; + + obj = acpi_evaluate_dsm_typed(int3472->sensor->handle, + &cio2_sensor_module_guid, 0x00, + 0x01, NULL, ACPI_TYPE_STRING); + + if (!obj) { + dev_err(int3472->dev, + "Failed to get sensor module string from _DSM\n"); + return ERR_PTR(-ENODEV); + } + + if (obj->string.type != ACPI_TYPE_STRING) { + dev_err(int3472->dev, + "Sensor _DSM returned a non-string value\n"); + ret = ERR_PTR(-EINVAL); + goto out_free_obj; + }
quoted hunk ↗ jump to hunk
+ ret = ERR_PTR(-EINVAL); + for (i = 0; i < ARRAY_SIZE(int3472_sensor_configs); i++) { + if (!strcmp(int3472_sensor_configs[i].sensor_module_name, + obj->string.pointer)) { + ret = &int3472_sensor_configs[i]; + break; + } + }
Can be refactored like this:
for (i = 0; i < ARRAY_SIZE(int3472_sensor_configs); i++) {
if (!strcmp(int3472_sensor_configs[i].sensor_module_name,
obj->string.pointer))
break;
}
ACPI_FREE(obj);
if (i >= ARRAY_SIZE(int3472_sensor_configs))
return ERR_PTR(-EINVAL);
return &int3472_sensor_configs[i];
quoted hunk ↗ jump to hunk
+out_free_obj: + ACPI_FREE(obj); + return ret;
And this moved to the one user above.
+}
...
+ dev_err(int3472->dev, "Invalid GPIO type 0x%02x for clock\n", + type);
One line? ...
+ * Return: + * * 0 - When all resources found are handled properly.
Positive number ... ?
quoted hunk ↗ jump to hunk
+ * * -EINVAL - If the resource is not a GPIO IO resource + * * -ENODEV - If the resource has no corresponding _DSM entry + * * -Other - Errors propagated from one of the sub-functions.
...
+ if (!acpi_gpio_get_io_resource(ares, &agpio)) + return 1; /* Deliberately positive so parsing continues */
Move it to description above? ...
quoted hunk ↗ jump to hunk
+ /* + * n_gpios + 2 because the index of this _DSM function is 1-based and + * the first function is just a count. + */ + obj = acpi_evaluate_dsm_typed(int3472->adev->handle, + &int3472_gpio_guid, 0x00, + int3472->n_gpios + 2, + NULL, ACPI_TYPE_INTEGER);
can we rename n_gpios -> ngpios? ...
quoted hunk ↗ jump to hunk
+ if (int3472->clock.ena_gpio) { + ret = skl_int3472_register_clock(int3472); + if (ret) + goto out_free_res_list; + } else {
Hmm... Have I got it correctly that we can't have ena_gpio && led_gpio together?
quoted hunk ↗ jump to hunk
+ if (int3472->clock.led_gpio) + dev_warn(int3472->dev, + "No clk GPIO. The privacy LED won't work\n"); + }
...
+ dev_err(&client->dev, "Failed to create regmap: %ld\n", + PTR_ERR(regmap));
One line? ...
quoted hunk ↗ jump to hunk
+ ret = skl_int3472_fill_cldb(adev, &cldb); + if (!ret && cldb.control_logic_type != 2) { + dev_err(&client->dev, "Unsupported control logic type %u\n", + cldb.control_logic_type); + return -EINVAL; + }
+ if (ret) + ret = devm_mfd_add_devices(&client->dev, PLATFORM_DEVID_NONE,
This I don't like. Since we get a returned variable with different meaning, can
we use a specific variable name for it? On top of that, I would rather see
something like this:
whatever = skl_...(...);
switch (whatever) {
case WHATEVER_ONE_CASE:
if (cldb.control_logic_type != 2) {
dev_err(&client->dev, "Unsupported control logic type %u\n",
cldb.control_logic_type);
return -EINVAL;
}
cells_data = tps68470_win;
cells_size = ARRAY_SIZE(tps68470_win);
break;
case WHATEVER_ANOTHER_CASE:
...
break;
default:
...Oops...
break; // or return -ERRNO
}
return devm_mfd_add_devices(&client->dev, PLATFORM_DEVID_NONE,
cells_data, cells_size, NULL, 0, NULL);
--
With Best Regards,
Andy Shevchenko