Re: [PATCH] usb: host: ehci-tegra: fix Kconfig depencies

[Alan Stern <stern@rowland.harvard.edu>]

On Mon, Jan 25, 2021 at 12:32:30PM +0100, Arnd Bergmann wrote:
> From: Arnd Bergmann <arnd@arndb.de>
> 
> Selecting the chipidea driver from the old Kconfig symbol
> can lead to a missing dependency:

Arnd:

I found this whole patch a little confusing.  For example, in the 
sentence above, what does "the old Kconfig symbol" refer to?

Comparing the various Kconfig files, I see what the problem is.  The 
commit which this one fixes made CONFIG_EHCI_TEGRA select 
CONFIG_USB_CHIPIDEA, but it didn't make EHCI_TEGRA depend on the things 
that USB_CHIPIDEA depends on.  Can you please state this more explicitly 
in the patch description?

> WARNING: unmet direct dependencies detected for USB_CHIPIDEA
>   Depends on [m]: USB_SUPPORT [=y] && (USB_EHCI_HCD [=y] && USB_GADGET [=m] || USB_EHCI_HCD [=y] && !USB_GADGET [=m] || !USB_EHCI_HCD [=y] && USB_GADGET [=m]) && HAS_DMA [=y]
>   Selected by [y]:
>   - USB_EHCI_TEGRA [=y] && USB_SUPPORT [=y] && USB [=y] && USB_EHCI_HCD [=y] && ARCH_TEGRA [=y]
> aarch64-linux-ld: drivers/usb/chipidea/otg.o: in function `ci_handle_vbus_change':
> otg.c:(.text+0x3c8): undefined reference to `usb_gadget_vbus_connect'
> aarch64-linux-ld: otg.c:(.text+0x42c): undefined reference to `usb_gadget_vbus_disconnect'
> aarch64-linux-ld: drivers/usb/chipidea/otg.o: in function `ci_otg_work':
> otg.c:(.text+0x5d4): undefined reference to `usb_gadget_vbus_disconnect'
> ...
> 
> Duplicate the dependency to ensure that this driver can
> only be a loadable module if one of its dependencies is.
> 
> Fixes: c3590c7656fb ("usb: host: ehci-tegra: Remove the driver")
> Signed-off-by: Arnd Bergmann <arnd@arndb.de>
> ---
>  drivers/usb/host/Kconfig | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/drivers/usb/host/Kconfig b/drivers/usb/host/Kconfig
> index 160e5d3927e2..66b01b619ecd 100644
> --- a/drivers/usb/host/Kconfig
> +++ b/drivers/usb/host/Kconfig
> @@ -269,6 +269,7 @@ config USB_EHCI_HCD_AT91
>  config USB_EHCI_TEGRA
>  	tristate "NVIDIA Tegra HCD support"
>  	depends on ARCH_TEGRA
> +	depends on ((USB_EHCI_HCD && USB_GADGET) || (USB_EHCI_HCD && !USB_GADGET) || (!USB_EHCI_HCD && USB_GADGET)) && HAS_DMA
>  	select USB_CHIPIDEA
>  	select USB_CHIPIDEA_HOST
>  	select USB_CHIPIDEA_TEGRA

Isn't there at least one other missing dependency?  This entry selects 
USB_CHIPIDEA_TEGRA, which depends on OF.  So shouldn't this entry also 
depend on OF?  Or does the Kconfig system detect that for us?

Also, while I'm no expert on the Kconfig language, it seems that the new 
"depends" line could be a lot easier to understand if it was refactored 
with some comments added.  Yes, I realize you just copied the existing 
dependency from the USB_CHIPIDEA entry -- that one could stand to be 
cleaned up as well.

For instance, how about putting the HAS_DMA part into a separate line, 
since it's unrelated to the other stuff?  And the rest looks like it 
could be changed to:

	depends on USB_EHCI_HCD || USB_GADGET

although that probably isn't quite valid.  Still, can't it be changed to 
something simpler than

	(USB_EHCI_HCD && USB_GADGET) || (USB_EHCI_HCD && !USB_GADGET) ||
			(!USB_EHCI_HCD && USB_GADGET)

?

Alan Stern