Re: [PATCH v6 09/12] usb: gadget: udc: adapt to OTG core

[Peter Chen]

On Wed, May 04, 2016 at 11:40:56AM +0300, Roger Quadros wrote:
> On 04/05/16 11:03, Jun Li wrote:
> > Hi
> > 
> >> -----Original Message-----
> >> From: Roger Quadros [mailto:rogerq@xxxxxx]
> >> Sent: Wednesday, May 04, 2016 2:37 PM
> >> To: Peter Chen <hzpeterchen@xxxxxxxxx>
> >> Cc: Jun Li <jun.li@xxxxxxx>; stern@xxxxxxxxxxxxxxxxxxx; balbi@xxxxxxxxxx;
> >> gregkh@xxxxxxxxxxxxxxxxxxx; peter.chen@xxxxxxxxxxxxx;
> >> dan.j.williams@xxxxxxxxx; jun.li@xxxxxxxxxxxxx;
> >> mathias.nyman@xxxxxxxxxxxxxxx; tony@xxxxxxxxxxx; Joao.Pinto@xxxxxxxxxxxx;
> >> abrestic@xxxxxxxxxxxx; r.baldyga@xxxxxxxxxxx; linux-usb@xxxxxxxxxxxxxxx;
> >> linux-kernel@xxxxxxxxxxxxxxx; linux-omap@xxxxxxxxxxxxxxx
> >> Subject: Re: [PATCH v6 09/12] usb: gadget: udc: adapt to OTG core
> >>
> >> Peter,
> >>
> >> On 04/05/16 06:35, Peter Chen wrote:
> >>> On Tue, May 03, 2016 at 06:44:46PM +0300, Roger Quadros wrote:
> >>>> Hi,
> >>>>
> >>>> On 03/05/16 10:06, Jun Li wrote:
> >>>>> Hi
> >>>>>
> >>>>>>>>>>>>>  /**
> >>>>>>>>>>>>> + * usb_gadget_start - start the usb gadget controller and
> >>>>>>>>>>>>> +connect to bus
> >>>>>>>>>>>>> + * @gadget: the gadget device to start
> >>>>>>>>>>>>> + *
> >>>>>>>>>>>>> + * This is external API for use by OTG core.
> >>>>>>>>>>>>> + *
> >>>>>>>>>>>>> + * Start the usb device controller and connect to bus
> >>>>>>>>>>>>> +(enable
> >>>>>> pull).
> >>>>>>>>>>>>> + */
> >>>>>>>>>>>>> +static int usb_gadget_start(struct usb_gadget *gadget) {
> >>>>>>>>>>>>> +	int ret;
> >>>>>>>>>>>>> +	struct usb_udc *udc = NULL;
> >>>>>>>>>>>>> +
> >>>>>>>>>>>>> +	dev_dbg(&gadget->dev, "%s\n", __func__);
> >>>>>>>>>>>>> +	mutex_lock(&udc_lock);
> >>>>>>>>>>>>> +	list_for_each_entry(udc, &udc_list, list)
> >>>>>>>>>>>>> +		if (udc->gadget == gadget)
> >>>>>>>>>>>>> +			goto found;
> >>>>>>>>>>>>> +
> >>>>>>>>>>>>> +	dev_err(gadget->dev.parent, "%s: gadget not
> >> registered.\n",
> >>>>>>>>>>>>> +		__func__);
> >>>>>>>>>>>>> +	mutex_unlock(&udc_lock);
> >>>>>>>>>>>>> +	return -EINVAL;
> >>>>>>>>>>>>> +
> >>>>>>>>>>>>> +found:
> >>>>>>>>>>>>> +	ret = usb_gadget_udc_start(udc);
> >>>>>>>>>>>>> +	if (ret)
> >>>>>>>>>>>>> +		dev_err(&udc->dev, "USB Device Controller didn't
> >>>>>>>> start: %d\n",
> >>>>>>>>>>>>> +			ret);
> >>>>>>>>>>>>> +	else
> >>>>>>>>>>>>> +		usb_udc_connect_control(udc);
> >>>>>>>>>>>>
> >>>>>>>>>>>> For drd, it's fine, but for real otg, gadget connect should
> >>>>>>>>>>>> be done by
> >>>>>>>>>>>> loc_conn() instead of gadget start.
> >>>>>>>>>>>
> >>>>>>>>>>> It is upto the OTG state machine to call gadget_start() when
> >>>>>>>>>>> it needs to connect to the bus (i.e. loc_conn()). I see no
> >>>>>>>>>>> point in calling gadget start before.
> >>>>>>>>>>>
> >>>>>>>>>>> Do you see any issue in doing so?
> >>>>>>>>>>
> >>>>>>>>>> This is what OTG state machine does:
> >>>>>>>>>> case OTG_STATE_B_PERIPHERAL:
> >>>>>>>>>>      otg_chrg_vbus(otg, 0);
> >>>>>>>>>>      otg_loc_sof(otg, 0);
> >>>>>>>>>>      otg_set_protocol(fsm, PROTO_GADGET);
> >>>>>>>>>>      otg_loc_conn(otg, 1);
> >>>>>>>>>>      break;
> >>>>>>>>
> >>>>>>>> On second thoughts, after seen the OTG state machine.
> >>>>>>>> otg_set_protocol(fsm, PROTO_GADGET); is always followed by
> >>>>>>>> otg_loc_conn(otg, 1); And whenever protocol changes to anything
> >>>>>>>> other the PROTO_GADGET, we use otg_loc_conn(otg, 0);
> >>>>>>>>
> >>>>>>>> So otg_loc_conn seems redundant. Can we just get rid of it?
> >>>>>>>>
> >>>>>>>> usb_gadget_start() implies that gadget controller starts up and
> >>>>>>>> enables pull.
> >>>>>>>> usb_gadget_stop() implies that gadget controller disables pull
> >>>>>>>> and
> >>>>>> stops.
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> Can you please explain why just these 2 APIs are not sufficient
> >>>>>>>> for full OTG?
> >>>>>>>>
> >>>>>>>> Do we want anything to happen between gadget controller
> >>>>>>>> start/stop and pull on/off?
> >>>>>>>
> >>>>>>> "loc_conn" is a standard output parameter in OTG spec, it deserves
> >>>>>>> a separate api, yes, current implementation of OTG state machine
> >>>>>>> code seems allow you to combine the 2 things into one, but don't
> >>>>>>> do that, because they do not always happen together, e.g. for
> >>>>>>> peripheral only B device (also a part OTG spec: section 7.3), will
> >>>>>>> be fixed in gadget mode, but it will do gadget connect and
> >>>>>>> disconnect in its diff states, so, to make the framework common,
> >> let's keep them separated.
> >>>>>>
> >>>>>> I'm sorry but I didn't understand your comment about "it will do
> >>>>>> gadget connect and disconnect in its diff states"
> >>>>>
> >>>>> Gadget connect means loc_conn(1).
> >>>>>
> >>>>>>
> >>>>>> I am reading the OTG v2.0 specification and loc_conn is always true
> >>>>>> when b_peripheral or a_peripheral is true and false otherwise.
> >>>>>
> >>>>> If you only talk about these 2 states, yes, loc_conn is ture.
> >>>>>
> >>>>>>
> >>>>>> loc_conn is just an internal state variable and it corresponds to
> >>>>>> our
> >>>>>> gadget_start/stop() state.
> >>>>>
> >>>>> It's not an internal variable, there are OTG state machine
> >>>>> parameters tables(table 7-x) in OTG spec which have clear lists
> >>>>> which are "internal variable", which are "input", which are "output"...
> >>>>>
> >>>>> Those APIs are driven directly from OTG spec, easily understood so
> >>>>> code reader can know what's those APIs for. For real OTG, I don't
> >>>>> see the benefit if get rid of it.
> >>>>
> >>>> OK, no issues if we don't get rid of it. But I am still in favor of
> >>>> doing a connect in usb_gadget_start(), because
> >>>>
> >>>> 1) If we split connect/disconnect() and usb_gadget_start/stop() then
> >>>> there is additional overhead of keeping track whether connect was
> >>>> called or not during usb_gadget_stop(). Plus we need to take care
> >>>> that users don't call connect/disconnect outside of start/stop. It is
> >> just complicating things.
> >>>>
> >>>> 2) for many controllers there is no difference between run/stop and
> >>>> connect/disconnect. i.e. a single register bit controls both.
> >>>>
> >>>> 3) it fits well with the OTG specification. OTG specification says
> >>>> that loc_conn *variable* must be true *after* the device has signalled
> >> a connect.
> >>>> So OTG state machine can safely set loc_conn variable to true after
> >>>> doing otg_set_protocol(fsm, PROTO_GADGET); and set it to false
> >> otherwise.
> >>>>
> >>>> Note, OTG specification does not say to take any action based on
> >> loc_conn.
> >>>> It is just a connect indicator variable. So we might have to fix this
> >>>> in the OTG state machine.
> >>>>
> >>>> My suggestion is to keep it simple for now. Try the OTG
> >>>> implementation, and later if we find issues then extend it as required.
> >>>>
> >>>
> >>> Just talked with Jun, he is worried if loc_conn != pullup_dp at some
> >>> situations. So, how about only calling start gadget at
> >>> usb_start_gadget,
> >>
> >> Which situations?
> > 
> > When to pull-up DP is decided by application (while vbus is on),
> > not only by driver state machine.
> 
> So when OTG state is B_PERIPHERAL or A_PERIPHERAL we still want DP pull-up
> to be disabled?
> 
> > 
> >>
> >>> and pullup_dp at drd_set_state (see below).
> >>>
> >>>
> >>> static void drd_set_state(struct otg_fsm *fsm, enum usb_otg_state
> >>> new_state) {
> >>> 	struct usb_otg *otg = container_of(fsm, struct usb_otg, fsm);
> >>>
> >>> 	if (otg->state == new_state)
> >>> 		return;
> >>>
> >>> 	fsm->state_changed = 1;
> >>> 	dev_dbg(otg->dev, "otg: set state: %s\n",
> >>> 		usb_otg_state_string(new_state));
> >>> 	switch (new_state) {
> >>> 	case OTG_STATE_B_IDLE:
> >>> +		usb_udc_vbus_handler(gadget, false);
> >>
> >> This is redundant, When we switch from PROTO_GADGET to PROTO_UNDEF we do a
> >> usb_gadget_stop(), and a usb_gadget_disconnect() is done there.
> >>
> >>> 		drd_set_protocol(fsm, PROTO_UNDEF);
> >>> 		otg_drv_vbus(otg, 0);
> >>> 		break;
> >>> 	case OTG_STATE_B_PERIPHERAL:
> >>> 		drd_set_protocol(fsm, PROTO_GADGET);
> >>> +		usb_udc_vbus_handler(gadget, true);
> >>
> >> This is redundant as well since usb_gadget_start() is doing a
> >> usb_gadget_connect().
> >>
> >>> 		otg_drv_vbus(otg, 0);
> >>> 		break;
> >>> 	......
> >>> 	};
> >>>
> >>> }
> >>>
> >>> When the OTG FSM is added to this framework, it can keep
> >>> usb_fsm->ops->loc_conn, and using the current FSM.
> >>>
> >>
> >> I have no strong opinions for or against usb_fsm->ops->loc_conn.
> >> Although strictly speaking, we shouldn't take any action based on loc_conn.
> > 
> > Strictly speaking(OTG spec), all you does is for loc_conn, but you think
> > it's start_gadget.
> > 
> >> It is just a state variable indicator.
> > 
> > Nobody check this "indicator".
> > 
> > Of cos, this is not a big deal, you can define the new API as is,
> > do udc_start() + gadget_connect() in one shot, it's up to user to
> > decide if use your usb_otg_start_gadget(), in case of udc_start()
> > followed by gadget_connect() is not wanted, user can/need do udc_start()
> > and something else before do gadget_connect.
> 
> Please don't get me wrong. I want the full OTG state machine to be able
> to use usb_otg_start/stop_gadget().
> 

Sure, but you may change above APIs a little (delete
usb_gadget_connect).

-- 

Best Regards,
Peter Chen