Hi--
On 3/22/22 07:30, Jules Maselbas wrote:
> Add documentation on phy function usage: init function must be
> called before power_on; power_off must be called before exit.
>
> Signed-off-by: Jules Maselbas <jmaselbas@xxxxxxxxx>
> CC: Ahmad Fatoum <a.fatoum@xxxxxxxxxxxxxx>
> CC: Amelie DELAUNAY <amelie.delaunay@xxxxxxxxxxx>
> ---
> drivers/phy/phy-core.c | 35 +++++++++++++++++++++++++++++++++++
> 1 file changed, 35 insertions(+)
>
> diff --git a/drivers/phy/phy-core.c b/drivers/phy/phy-core.c
> index 91e28d6ce450..ed10cbb24b08 100644
> --- a/drivers/phy/phy-core.c
> +++ b/drivers/phy/phy-core.c
> @@ -229,6 +229,17 @@ void phy_pm_runtime_forbid(struct phy *phy)
> }
> EXPORT_SYMBOL_GPL(phy_pm_runtime_forbid);
>
> +/**
> + * phy_init - phy internal initialization before phy operation
> + * @phy: the phy returned by phy_get()
> + *
> + * Used to allow phy's driver to perform phy internal initialization,
> + * such as PLL block powering, clock initialization or anything that's
> + * is required by the phy to perform the start of operation.
> + * Must be called before phy_power_on().
> + *
> + * Returns: 0 if successful, an negative error code otherwise
* Return: %0 if successful, a negative error code otherwise
(in all 4 functions)
> + */
> int phy_init(struct phy *phy)
--
~Randy
