Hi!

[ Thanks a lot for upstreaming this.. ]

On Tue, Sep 11, 2018 at 02:34:57PM -0700, Jolly Shah wrote:
> From: Rajan Vaja <[email protected]>
>
> Add ZynqMP PM driver. PM driver provides power management
> support for ZynqMP.
>
> Signed-off-by: Rajan Vaja <[email protected]>
> Signed-off-by: Jolly Shah <[email protected]>
> ---

[...]

> +static irqreturn_t zynqmp_pm_isr(int irq, void *data)
> +{
> +     u32 payload[CB_PAYLOAD_SIZE];
> +
> +     zynqmp_pm_get_callback_data(payload);
> +
> +     /* First element is callback API ID, others are callback arguments */
> +     if (payload[0] == PM_INIT_SUSPEND_CB) {
> +             if (work_pending(&zynqmp_pm_init_suspend_work->callback_work))
> +                     goto done;
> +
> +             /* Copy callback arguments into work's structure */
> +             memcpy(zynqmp_pm_init_suspend_work->args, &payload[1],
> +                    sizeof(zynqmp_pm_init_suspend_work->args));
> +
> +             queue_work(system_unbound_wq,
> +                        &zynqmp_pm_init_suspend_work->callback_work);

We already have devm_request_threaded_irq() which can does this
automatically for us.

Use that method to register the ISR instead, then if there's more
work to do, just do the memcpy and return IRQ_WAKE_THREAD.

> +     }
> +
> +done:
> +     return IRQ_HANDLED;
> +}
> +
> +/**
> + * zynqmp_pm_init_suspend_work_fn() - Initialize suspend
> + * @work:    Pointer to work_struct
> + *
> + * Bottom-half of PM callback IRQ handler.
> + */
> +static void zynqmp_pm_init_suspend_work_fn(struct work_struct *work)
> +{
> +     struct zynqmp_pm_work_struct *pm_work =
> +             container_of(work, struct zynqmp_pm_work_struct, callback_work);
> +
> +     if (pm_work->args[0] == ZYNQMP_PM_SUSPEND_REASON_SYSTEM_SHUTDOWN) {

we_really_seem_to_love_long_40_col_names_for_some_reason

> +             orderly_poweroff(true);
> +     } else if (pm_work->args[0] ==
> +                ZYNQMP_PM_SUSPEND_REASON_POWER_UNIT_REQUEST) {

Ditto

[...]

> +/**
> + * zynqmp_pm_sysfs_init() - Initialize PM driver sysfs interface
> + * @dev:     Pointer to device structure
> + *
> + * Return: 0 on success, negative error code otherwise
> + */
> +static int zynqmp_pm_sysfs_init(struct device *dev)
> +{
> +     return sysfs_create_file(&dev->kobj, &dev_attr_suspend_mode.attr);
> +}
> +

Sysfs file is created in platform driver's probe(), but is not
removed anywhere in the code.

What happens if this is built as a module? Am I missing something
obvious?

Moreover, what's the wisdom of creating a one-liner function with
a huge six-line comment that:

    a) _purely_ wraps sysfs_create_file(); no extra logic
    b) is called only once
    c) and not passed as a function pointer anywhere

IMO Such one-liner translators obfuscate the code and review
process with no apparent gain..

> +/**
> + * zynqmp_pm_probe() - Probe existence of the PMU Firmware
> + *                  and initialize debugfs interface
> + *
> + * @pdev:    Pointer to the platform_device structure
> + *
> + * Return: Returns 0 on success, negative error code otherwise
> + */

Again, huge 8-line comment that provide no value.

If anyone wants to know what a platform driver probe() does, he
or she better check the primary references at:

    - Documentation/driver-model/platform.txt
    - include/linux/platform_device.h

and not the comment above..

> +static int zynqmp_pm_probe(struct platform_device *pdev)
> +{
> +     int ret, irq;
> +     u32 pm_api_version;
> +
> +     const struct zynqmp_eemi_ops *eemi_ops = zynqmp_pm_get_eemi_ops();
> +
> +     if (!eemi_ops || !eemi_ops->get_api_version || !eemi_ops->init_finalize)
> +             return -ENXIO;
> +
> +     eemi_ops->init_finalize();
> +     eemi_ops->get_api_version(&pm_api_version);
> +
> +     /* Check PM API version number */
> +     if (pm_api_version < ZYNQMP_PM_VERSION)
> +             return -ENODEV;
> +
> +     irq = platform_get_irq(pdev, 0);
> +     if (irq <= 0)
> +             return -ENXIO;
> +
> +     ret = devm_request_irq(&pdev->dev, irq, zynqmp_pm_isr, IRQF_SHARED,
> +                            dev_name(&pdev->dev), pdev);
> +     if (ret) {
> +             dev_err(&pdev->dev, "request_irq '%d' failed with %d\n",
> +                     irq, ret);
> +             return ret;
> +     }
> +
> +     zynqmp_pm_init_suspend_work =
> +             devm_kzalloc(&pdev->dev, sizeof(struct zynqmp_pm_work_struct),
> +                          GFP_KERNEL);
> +     if (!zynqmp_pm_init_suspend_work)
> +             return -ENOMEM;
> +
> +     INIT_WORK(&zynqmp_pm_init_suspend_work->callback_work,
> +               zynqmp_pm_init_suspend_work_fn);
> +

Let's use devm_request_threaded_irq(). Then we can completely
remove the work_struct, INIT_WORK(), and queuue_work() bits.

> +     ret = zynqmp_pm_sysfs_init(&pdev->dev);
> +     if (ret) {
> +             dev_err(&pdev->dev, "unable to initialize sysfs interface\n");
> +             return ret;
> +     }
> +
> +     return ret;

Just return 0 please. BTW ret was declared without initialization.

> +}
> +
> +static const struct of_device_id pm_of_match[] = {
> +     { .compatible = "xlnx,zynqmp-power", },
> +     { /* end of table */ },
> +};
> +MODULE_DEVICE_TABLE(of, pm_of_match);
> +
> +static struct platform_driver zynqmp_pm_platform_driver = {
> +     .probe = zynqmp_pm_probe,
> +     .driver = {
> +             .name = "zynqmp_power",
> +             .of_match_table = pm_of_match,
> +     },
> +};

.remove with a basic sysfs_remove_file() is needed.

Thanks,

--
Darwi
http://darwish.chasingpointers.com

Reply via email to