Message-ID: <dae761af-6db4-f611-21c9-122fda74c5b6@quicinc.com>
Date:   Mon, 23 Jan 2023 12:25:31 -0800
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101
 Thunderbird/91.9.1
Subject: Re: [PATCH v2 1/5] usb: gadget: Add remote wakeup capable flag
Content-Language: en-US
To:     Thinh Nguyen <Thinh.Nguyen@synopsys.com>,
        Alan Stern <stern@rowland.harvard.edu>
CC:     "gregkh@linuxfoundation.org" <gregkh@linuxfoundation.org>,
        "balbi@kernel.org" <balbi@kernel.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "linux-usb@vger.kernel.org" <linux-usb@vger.kernel.org>,
        "quic_wcheng@quicinc.com" <quic_wcheng@quicinc.com>,
        "quic_jackp@quicinc.com" <quic_jackp@quicinc.com>
References: <1673992507-7823-2-git-send-email-quic_eserrao@quicinc.com>
 <20230119014409.yiw6xlp5cwlmu25s@synopsys.com>
 <f49c54d9-b9fe-e629-3f94-809cd79a2211@quicinc.com>
 <20230120011513.ajwum224lfwwb6ws@synopsys.com>
 <045f9ac1-5d48-fad0-8e74-8d5144aa1431@quicinc.com>
 <20230121002059.mpiqavemelnntxd7@synopsys.com>
 <Y8tGAXbKDtzmW8+E@rowland.harvard.edu>
 <20230121020223.l2tyvyqifc7umqpy@synopsys.com>
 <Y8tIrx+F/4X9YyFT@rowland.harvard.edu>
 <20230121021219.udgpwt7tv7dfr3jk@synopsys.com>
 <20230123193320.sxywht5vr3sig2ur@synopsys.com>
From:   Elson Serrao <quic_eserrao@quicinc.com>
In-Reply-To: <20230123193320.sxywht5vr3sig2ur@synopsys.com>
Content-Type: text/plain; charset="UTF-8"; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: bulk


On 1/23/2023 11:33 AM, Thinh Nguyen wrote:
> On Sat, Jan 21, 2023, Thinh Nguyen wrote:
>> On Fri, Jan 20, 2023, Alan Stern wrote:
>>> On Sat, Jan 21, 2023 at 02:02:36AM +0000, Thinh Nguyen wrote:
>>>> On Fri, Jan 20, 2023, Alan Stern wrote:
>>>>> A UDC design might have multiple versions, some supporting remote wakeup
>>>>> and others not.  But drivers generally use a single static
>>>>> usb_gadget_ops structure, and they don't modify it at runtime to account
>>>>> for hardware differences.  So if a single driver controls those multiple
>>>>> versions, you can't rely on the presence of gadget->ops->wakeup to
>>>>> indicate whether there actually is hardware remote wakeup support.
>>>>>
>>>>> Ideally, the usb_gadget structure should have a wakeup_capable flag
>>>>> which the UDC driver would set appropriately (probably during its probe
>>>>> routine).
>>>>>
>>>>
>>>> I was thinking that it can be handled by the
>>>> usb_gadget_enable_remote_wakeup() so we can do away with the
>>>> wakeup_capable flag.
>>>
>>> usb_gadget_enable_remote_wakeup() gets called when the gadget or
>>> function is suspended, right?  But a gadget driver may want to know long
>>> before that whether the UDC supports remote wakeup, in order to set up
>>> its config descriptor correctly.
>>>
>>
>> No, this is to be called during set configuration. If the configuration
>> doesn't support remote wakeup, the device should not be able to send
>> remote wakeup.
>>
> 
> On second thought, you're right about the descriptor. It's better to
> warn and prevent the remote wakeup bit from being set in the descriptor
> if the UDC doesn't support remote wakeup. Warning the user at set
> configuration is too late.
> 
> So, we need both rw_capable flag and usb_gadget_enable_remote_wakeup().
> 
> Thanks,
> Thinh

Do we need usb_gadget_enable_remote_wakeup() gadget-op ?
As per the discussion, we can have rw_capable flag in usb_gadget struct 
and set it during gagdet init/probe if the UDC supports resume 
signalling OR wants the remote wakeup feature to be enabled.
This flag now represents UDC capability to initiate resume signalling.

During enumeration phase, when preparing the config descriptor we can 
use gadget->rw_capable flag to rightly modify the remote wakeup
bit. Based on this, host will decide whether to arm the device for 
remote wakeup or not.

For gadget->ops->wakeup callback support we already have explicit checks 
when invoking this gadget op and device wont be able to send remote 
wakeup if callback support doesn't exist.
Please let me know if I am missing something.

Thanks
Elson