RE: [PATCH v5 2/4] drivers: firmware: xilinx: Add ZynqMP firmware driver

[Jolly Shah <JOLLYS@xilinx.com>]

Hi Sudeep,

> -----Original Message-----
> From: Sudeep Holla [mailto:sudeep.holla@arm.com]
> Sent: Thursday, March 08, 2018 4:19 AM
> To: Jolly Shah <JOLLYS@xilinx.com>; michal.simek@xilinx.com
> Cc: Sudeep Holla <sudeep.holla@arm.com>; ard.biesheuvel@linaro.org;
> mingo@kernel.org; gregkh@linuxfoundation.org; matt@codeblueprint.co.uk;
> hkallweit1@gmail.com; keescook@chromium.org;
> dmitry.torokhov@gmail.com; robh+dt@kernel.org; mark.rutland@arm.com;
> Rajan Vaja <RAJANV@xilinx.com>; linux-arm-kernel@lists.infradead.org; linux-
> kernel@vger.kernel.org; devicetree@vger.kernel.org
> Subject: Re: [PATCH v5 2/4] drivers: firmware: xilinx: Add ZynqMP firmware
> driver
> 
> 
> 
> On 07/03/18 00:44, Jolly Shah wrote:
> > Hi Sudeep,
> >
> > Thanks for the review,
> >
> >> -----Original Message-----
> >> From: Sudeep Holla [mailto:sudeep.holla@arm.com]
> >> Sent: Thursday, March 01, 2018 6:28 AM
> >> To: Jolly Shah <JOLLYS@xilinx.com>; michal.simek@xilinx.com
> >> Cc: ard.biesheuvel@linaro.org; mingo@kernel.org;
> >> gregkh@linuxfoundation.org; matt@codeblueprint.co.uk;
> >> hkallweit1@gmail.com; keescook@chromium.org;
> >> dmitry.torokhov@gmail.com; robh+dt@kernel.org; mark.rutland@arm.com;
> >> Sudeep Holla <sudeep.holla@arm.com>; Rajan Vaja <RAJANV@xilinx.com>;
> >> linux-arm-kernel@lists.infradead.org; linux-kernel@vger.kernel.org;
> >> devicetree@vger.kernel.org; Jolly Shah <JOLLYS@xilinx.com>
> >> Subject: Re: [PATCH v5 2/4] drivers: firmware: xilinx: Add ZynqMP
> >> firmware driver
> >>
> >>
> >>
> >> On 20/02/18 19:21, Jolly Shah wrote:
> >>> This patch is adding communication layer with firmware.
> >>> Firmware driver provides an interface to firmware APIs.
> >>> Interface APIs can be used by any driver to communicate to
> >>> PMUFW(Platform Management Unit). All requests go through ATF.
> >>>
> >>> Signed-off-by: Jolly Shah <jollys@xilinx.com>
> >>> Signed-off-by: Rajan Vaja <rajanv@xilinx.com>
> >>> ---
> >>>  arch/arm64/Kconfig.platforms                    |    1 +
> >>>  drivers/firmware/Kconfig                        |    1 +
> >>>  drivers/firmware/Makefile                       |    1 +
> >>>  drivers/firmware/xilinx/Kconfig                 |    4 +
> >>>  drivers/firmware/xilinx/Makefile                |    4 +
> >>>  drivers/firmware/xilinx/zynqmp/Kconfig          |   16 +
> >>>  drivers/firmware/xilinx/zynqmp/Makefile         |    4 +
> >>>  drivers/firmware/xilinx/zynqmp/firmware.c       | 1051
> >> +++++++++++++++++++++++
> >>>  include/linux/firmware/xilinx/zynqmp/firmware.h |  590
> >>> +++++++++++++
> >>>  9 files changed, 1672 insertions(+)  create mode 100644
> >>> drivers/firmware/xilinx/Kconfig  create mode
> >>> 100644 drivers/firmware/xilinx/Makefile  create mode 100644
> >>> drivers/firmware/xilinx/zynqmp/Kconfig
> >>>  create mode 100644 drivers/firmware/xilinx/zynqmp/Makefile
> >>>  create mode 100644 drivers/firmware/xilinx/zynqmp/firmware.c
> >>>  create mode 100644 include/linux/firmware/xilinx/zynqmp/firmware.h
> >>>
> >>> +
> >>> +/**
> >>> + * zynqmp_pm_force_powerdown - PM call to request for another PU or
> >> subsystem to
> >>> + *				be powered down forcefully
> >>> + * @target:	Node ID of the targeted PU or subsystem
> >>> + * @ack:	Flag to specify whether acknowledge is requested
> >>> + *
> >>> + * Return:	Returns status, either success or error+reason
> >>> + */
> >>> +static int zynqmp_pm_force_powerdown(const u32 target,
> >>> +				     const enum zynqmp_pm_request_ack ack) {
> >>> +	return zynqmp_pm_invoke_fn(PM_FORCE_POWERDOWN, target, ack,
> >> 0, 0,
> >>> +NULL); }
> >>> +
> >>
> >> [...]
> >>
> >>> +/**
> >>> + * zynqmp_pm_system_shutdown - PM call to request a system shutdown
> >>> +or
> >> restart
> >>> + * @type:	Shutdown or restart? 0 for shutdown, 1 for restart
> >>> + * @subtype:	Specifies which system should be restarted or shut
> down
> >>> + *
> >>> + * Return:	Returns status, either success or error+reason
> >>> + */
> >>> +static int zynqmp_pm_system_shutdown(const u32 type, const u32
> >>> +subtype) {
> >>> +	return zynqmp_pm_invoke_fn(PM_SYSTEM_SHUTDOWN, type, subtype,
> >>> +				   0, 0, NULL);
> >>> +}
> >>> +
> >>
> >> I can't understand why you need above 2 APIs: PM_FORCE_POWERDOWN
> and
> >> PM_SYSTEM_SHUTDOWN. You should use PSCI_SYSTEM_OFF and
> >> PSCI_SYSTEM_RESET and drop these two.
> >>
> >
> > FORCE_POWERDOWN allows remote master to force power off other
> > node/domain. SYSTEM_SHUTDOWN provides interface to shutdown/restart
> > the subsystem. It supports system/subsystem restart with argument
> > value.> PSCI doesn’t
> support argument to identify between restart types.
> 
> OK, what are the types you are referring here ? or why PSCI is not sufficient ?
> How do you plan to use these APIs in Linux ?

It supports system/subsystem restart as types. For example, only APU restart, system restart, PS restart for ZynqMP
PSCI doesn’t support any argument to identify these types.
Linux, one can set the reset scope through debug interface and execute "reboot" then. Inside ATF, PSCI_SYSTEM_RESET mapped function will call EEMI API with that scope.

> 
> >>
> >>> +static const struct zynqmp_eemi_ops eemi_ops = {
> >>> +	.get_api_version = zynqmp_pm_get_api_version,
> >>> +	.get_chipid = zynqmp_pm_get_chipid,
> >>> +	.reset_assert = zynqmp_pm_reset_assert,
> >>> +	.reset_get_status = zynqmp_pm_reset_get_status,
> >>> +	.fpga_load = zynqmp_pm_fpga_load,
> >>> +	.fpga_get_status = zynqmp_pm_fpga_get_status,
> >>> +	.sha_hash = zynqmp_pm_sha_hash,
> >>> +	.rsa = zynqmp_pm_rsa,
> >>> +	.request_suspend = zynqmp_pm_request_suspend,
> >>> +	.force_powerdown = zynqmp_pm_force_powerdown,
> >>> +	.request_wakeup = zynqmp_pm_request_wakeup,
> >>> +	.set_wakeup_source = zynqmp_pm_set_wakeup_source,
> >>> +	.system_shutdown = zynqmp_pm_system_shutdown,
> >>> +	.request_node = zynqmp_pm_request_node,
> >>> +	.release_node = zynqmp_pm_release_node,
> >>> +	.set_requirement = zynqmp_pm_set_requirement,
> >>> +	.set_max_latency = zynqmp_pm_set_max_latency,
> >>> +	.set_configuration = zynqmp_pm_set_configuration,
> >>> +	.get_node_status = zynqmp_pm_get_node_status,
> >>> +	.get_operating_characteristic =
> >> zynqmp_pm_get_operating_characteristic,
> >>> +	.init_finalize = zynqmp_pm_init_finalize,
> >>> +	.set_suspend_mode = zynqmp_pm_set_suspend_mode,
> >>> +	.ioctl = zynqmp_pm_ioctl,
> >>> +	.query_data = zynqmp_pm_query_data,
> >>> +	.pinctrl_request = zynqmp_pm_pinctrl_request,
> >>> +	.pinctrl_release = zynqmp_pm_pinctrl_release,
> >>> +	.pinctrl_get_function = zynqmp_pm_pinctrl_get_function,
> >>> +	.pinctrl_set_function = zynqmp_pm_pinctrl_set_function,
> >>> +	.pinctrl_get_config = zynqmp_pm_pinctrl_get_config,
> >>> +	.pinctrl_set_config = zynqmp_pm_pinctrl_set_config,
> >>> +	.clock_enable = zynqmp_pm_clock_enable,
> >>> +	.clock_disable = zynqmp_pm_clock_disable,
> >>> +	.clock_getstate = zynqmp_pm_clock_getstate,
> >>> +	.clock_setdivider = zynqmp_pm_clock_setdivider,
> >>> +	.clock_getdivider = zynqmp_pm_clock_getdivider,
> >>> +	.clock_setrate = zynqmp_pm_clock_setrate,
> >>> +	.clock_getrate = zynqmp_pm_clock_getrate,
> >>> +	.clock_setparent = zynqmp_pm_clock_setparent,
> >>> +	.clock_getparent = zynqmp_pm_clock_getparent, };
> >>> +
> >> Instead of introducing all these in oneshot, add them as you have users of it.
> >> IOW, show the users of these functions in the series. Also I asked to
> >> split this into functional changes like clock, pinctrl, power, etc.
> >
> > It can be split into functional changes in same series but it will be
> > difficult to split between users as there are more than 10 driver
> > users for different EEMI APIs and also multiple driver users using
> > specifc EEMI APIs. They all can't be submitted as single series.
> >
> 
> Why ? Start with basic EEMI and one functionality with it's user/client driver in
> one series. Then you can top up with EEMI changes for other functionality with
> it's user. If you introduce API's without the users in a series it's hard to review
> and if there are more such unused APIs I will object it in future versions.
> 
> To start with add only clock or power APIs and functionality in this series, add
> drivers using then. Drop other functionalities like pinctrl, fpga control and other
> functionalities. IOW start something basic and simple.
> 

I am ok to break it for clock/pinctrl with users but there are multiple users for some APIs. In that case, it will create dependency issues when different owners are involved.
Also, it will hard to visualize a whole EEMI interface if its broken into such pieces. 

> --
> Regards,
> Sudeep