Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1549545 > unrolled thread

[PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST

Started byBaolin Wang <baolin.wang@linaro.org>
First post2017-01-03 07:00 +0100
Last post2017-01-06 10:00 +0100
Articles 5 — 4 participants

Back to article view | Back to linux.kernel


Contents

  [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST Baolin Wang <baolin.wang@linaro.org> - 2017-01-03 07:00 +0100
    Re: [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST Chanwoo Choi <cwchoi00@gmail.com> - 2017-01-03 13:50 +0100
      Re: [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST NeilBrown <neilb@suse.com> - 2017-01-04 00:10 +0100
        Re: [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST Chanwoo Choi <cw00.choi@samsung.com> - 2017-01-06 10:00 +0100
    Re: [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST Chanwoo Choi <cw00.choi@samsung.com> - 2017-01-06 10:00 +0100

#1549545 — [PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST

FromBaolin Wang <baolin.wang@linaro.org>
Date2017-01-03 07:00 +0100
Subject[PATCH] extcon: Add documentation for EXTCON_CHG_USB_SLOW/FAST
Message-ID<sVqiB-1KJ-9@gated-at.bofh.it>
Currently there are no documentation for EXTCON_CHG_USB_SLOW/FAST
charger connector. These names don't mean much and no guide to tell
users how to use it, thus try to add documentation to make them clear.

Suggested-by: NeilBrown <neilb@suse.com>
Signed-off-by: Baolin Wang <baolin.wang@linaro.org>
---
 include/linux/extcon.h |    4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/linux/extcon.h b/include/linux/extcon.h
index 0020123..ceec1f0 100644
--- a/include/linux/extcon.h
+++ b/include/linux/extcon.h
@@ -53,6 +53,10 @@
  * the USB connector, which means EXTCON_CHG_USB_SDP should always
  * appear together with EXTCON_USB. The same as ACA charger connector,
  * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST.
+ *
+ * A cable of type EXTCON_CHG_USB_SLOW can provide at least 500mA of
+ * current at 5V. A cable of type EXTCON_CHG_USB_FAST can provide at
+ * least 1A of current at 5V.
  */
 #define EXTCON_CHG_USB_SDP	5	/* Standard Downstream Port */
 #define EXTCON_CHG_USB_DCP	6	/* Dedicated Charging Port */
-- 
1.7.9.5

[toc] | [next] | [standalone]


#1549759

FromChanwoo Choi <cwchoi00@gmail.com>
Date2017-01-03 13:50 +0100
Message-ID<sVwHo-6lx-13@gated-at.bofh.it>
In reply to#1549545
Hi Baolin,

2017-01-03 14:50 GMT+09:00 Baolin Wang <baolin.wang@linaro.org>:
> Currently there are no documentation for EXTCON_CHG_USB_SLOW/FAST
> charger connector. These names don't mean much and no guide to tell
> users how to use it, thus try to add documentation to make them clear.
>
> Suggested-by: NeilBrown <neilb@suse.com>
> Signed-off-by: Baolin Wang <baolin.wang@linaro.org>
> ---
>  include/linux/extcon.h |    4 ++++
>  1 file changed, 4 insertions(+)
>
> diff --git a/include/linux/extcon.h b/include/linux/extcon.h
> index 0020123..ceec1f0 100644
> --- a/include/linux/extcon.h
> +++ b/include/linux/extcon.h
> @@ -53,6 +53,10 @@
>   * the USB connector, which means EXTCON_CHG_USB_SDP should always
>   * appear together with EXTCON_USB. The same as ACA charger connector,
>   * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST.
> + *
> + * A cable of type EXTCON_CHG_USB_SLOW can provide at least 500mA of
> + * current at 5V. A cable of type EXTCON_CHG_USB_FAST can provide at
> + * least 1A of current at 5V.

I agree the at least current value(mA) for EXTCON_CHG_USB_SLOW/FAST.
But, I'm worried that  fix the 5V.

I have a plan to support the 'current' and 'voltage' property for
charger connector as following:
- EXTCON_PROP_CHG_CURRNET
- EXTCON_PROP_CHG_VOLTAGE

So, I don't like to fix the voltage for EXTCON_CHG_USB_SLOW/FAST.
How about this?


>   */
>  #define EXTCON_CHG_USB_SDP     5       /* Standard Downstream Port */
>  #define EXTCON_CHG_USB_DCP     6       /* Dedicated Charging Port */
> --
> 1.7.9.5
>
> _______________________________________________
> linaro-kernel mailing list
> linaro-kernel@lists.linaro.org
> https://lists.linaro.org/mailman/listinfo/linaro-kernel



-- 
Best Regards,
Chanwoo Choi

[toc] | [prev] | [next] | [standalone]


#1550278

FromNeilBrown <neilb@suse.com>
Date2017-01-04 00:10 +0100
Message-ID<sVGno-4J3-17@gated-at.bofh.it>
In reply to#1549759

[Multipart message — attachments visible in raw view] — view raw

On Tue, Jan 03 2017, Chanwoo Choi wrote:

> Hi Baolin,
>
> 2017-01-03 14:50 GMT+09:00 Baolin Wang <baolin.wang@linaro.org>:
>> Currently there are no documentation for EXTCON_CHG_USB_SLOW/FAST
>> charger connector. These names don't mean much and no guide to tell
>> users how to use it, thus try to add documentation to make them clear.
>>
>> Suggested-by: NeilBrown <neilb@suse.com>
>> Signed-off-by: Baolin Wang <baolin.wang@linaro.org>
>> ---
>>  include/linux/extcon.h |    4 ++++
>>  1 file changed, 4 insertions(+)
>>
>> diff --git a/include/linux/extcon.h b/include/linux/extcon.h
>> index 0020123..ceec1f0 100644
>> --- a/include/linux/extcon.h
>> +++ b/include/linux/extcon.h
>> @@ -53,6 +53,10 @@
>>   * the USB connector, which means EXTCON_CHG_USB_SDP should always
>>   * appear together with EXTCON_USB. The same as ACA charger connector,
>>   * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST.
>> + *
>> + * A cable of type EXTCON_CHG_USB_SLOW can provide at least 500mA of
>> + * current at 5V. A cable of type EXTCON_CHG_USB_FAST can provide at
>> + * least 1A of current at 5V.
>
> I agree the at least current value(mA) for EXTCON_CHG_USB_SLOW/FAST.
> But, I'm worried that  fix the 5V.
>
> I have a plan to support the 'current' and 'voltage' property for
> charger connector as following:
> - EXTCON_PROP_CHG_CURRNET
> - EXTCON_PROP_CHG_VOLTAGE
>
> So, I don't like to fix the voltage for EXTCON_CHG_USB_SLOW/FAST.
> How about this?

I think you should be very caution about pursuing this approach.  As it
stands, it implies that a given cable has a fixed voltage and a fixed
available current.  This is not true of many cables.

The USB battery charging spec defines a range of possibly current limits
that each cable type can provide.  There is a defined protocol for the
slave to detect how much current is available within that range.  So
setting a single "CHG_CURRENT" property would be incorrect.

For SDP ports, the current limit is negotiation using the USB protocol
and it is completely unknown to the cable (and so to EXTCON).  For
USB-C, there is a greater range of voltages and currents.  I don't know
the details, but I do know that a single-valued "PROP_CHG_VOLTAGE" would
not be appropriate.

I think that EXTCON should stick with identifying the type of cable, and
leave it to the client to determine what other properties are implied by
each particular cable type.

Thanks,
NeilBrown

[toc] | [prev] | [next] | [standalone]


#1552613

FromChanwoo Choi <cw00.choi@samsung.com>
Date2017-01-06 10:00 +0100
Message-ID<sWyxr-7IH-19@gated-at.bofh.it>
In reply to#1550278
Hi NeilBrown,

On 2017년 01월 04일 08:01, NeilBrown wrote:
> On Tue, Jan 03 2017, Chanwoo Choi wrote:
> 
>> Hi Baolin,
>>
>> 2017-01-03 14:50 GMT+09:00 Baolin Wang <baolin.wang@linaro.org>:
>>> Currently there are no documentation for EXTCON_CHG_USB_SLOW/FAST
>>> charger connector. These names don't mean much and no guide to tell
>>> users how to use it, thus try to add documentation to make them clear.
>>>
>>> Suggested-by: NeilBrown <neilb@suse.com>
>>> Signed-off-by: Baolin Wang <baolin.wang@linaro.org>
>>> ---
>>>  include/linux/extcon.h |    4 ++++
>>>  1 file changed, 4 insertions(+)
>>>
>>> diff --git a/include/linux/extcon.h b/include/linux/extcon.h
>>> index 0020123..ceec1f0 100644
>>> --- a/include/linux/extcon.h
>>> +++ b/include/linux/extcon.h
>>> @@ -53,6 +53,10 @@
>>>   * the USB connector, which means EXTCON_CHG_USB_SDP should always
>>>   * appear together with EXTCON_USB. The same as ACA charger connector,
>>>   * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST.
>>> + *
>>> + * A cable of type EXTCON_CHG_USB_SLOW can provide at least 500mA of
>>> + * current at 5V. A cable of type EXTCON_CHG_USB_FAST can provide at
>>> + * least 1A of current at 5V.
>>
>> I agree the at least current value(mA) for EXTCON_CHG_USB_SLOW/FAST.
>> But, I'm worried that  fix the 5V.
>>
>> I have a plan to support the 'current' and 'voltage' property for
>> charger connector as following:
>> - EXTCON_PROP_CHG_CURRNET
>> - EXTCON_PROP_CHG_VOLTAGE
>>
>> So, I don't like to fix the voltage for EXTCON_CHG_USB_SLOW/FAST.
>> How about this?
> 
> I think you should be very caution about pursuing this approach.  As it
> stands, it implies that a given cable has a fixed voltage and a fixed
> available current.  This is not true of many cables.
> 
> The USB battery charging spec defines a range of possibly current limits
> that each cable type can provide.  There is a defined protocol for the
> slave to detect how much current is available within that range.  So
> setting a single "CHG_CURRENT" property would be incorrect.
> 
> For SDP ports, the current limit is negotiation using the USB protocol
> and it is completely unknown to the cable (and so to EXTCON).  For
> USB-C, there is a greater range of voltages and currents.  I don't know
> the details, but I do know that a single-valued "PROP_CHG_VOLTAGE" would
> not be appropriate.
> 
> I think that EXTCON should stick with identifying the type of cable, and
> leave it to the client to determine what other properties are implied by
> each particular cable type.

First of all, Thanks for your detailed comment. The power-supply already
has the voltage/current property for power-supply device as following:
- POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT
- POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX
- POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE
- POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX

-- 
Best Regards,
Chanwoo Choi
S/W Center, Samsung Electronics

[toc] | [prev] | [next] | [standalone]


#1552610

FromChanwoo Choi <cw00.choi@samsung.com>
Date2017-01-06 10:00 +0100
Message-ID<sWyxr-7IH-13@gated-at.bofh.it>
In reply to#1549545
On 2017년 01월 03일 14:50, Baolin Wang wrote:
> Currently there are no documentation for EXTCON_CHG_USB_SLOW/FAST
> charger connector. These names don't mean much and no guide to tell
> users how to use it, thus try to add documentation to make them clear.
> 
> Suggested-by: NeilBrown <neilb@suse.com>
> Signed-off-by: Baolin Wang <baolin.wang@linaro.org>
> ---
>  include/linux/extcon.h |    4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/include/linux/extcon.h b/include/linux/extcon.h
> index 0020123..ceec1f0 100644
> --- a/include/linux/extcon.h
> +++ b/include/linux/extcon.h
> @@ -53,6 +53,10 @@
>   * the USB connector, which means EXTCON_CHG_USB_SDP should always
>   * appear together with EXTCON_USB. The same as ACA charger connector,
>   * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST.
> + *
> + * A cable of type EXTCON_CHG_USB_SLOW can provide at least 500mA of
> + * current at 5V. A cable of type EXTCON_CHG_USB_FAST can provide at
> + * least 1A of current at 5V.

When I applied this patch, I use the 'connector expression' instead of 'cable'.

>   */
>  #define EXTCON_CHG_USB_SDP	5	/* Standard Downstream Port */
>  #define EXTCON_CHG_USB_DCP	6	/* Dedicated Charging Port */
> 

Applied it. Thanks.

-- 
Best Regards,
Chanwoo Choi
S/W Center, Samsung Electronics

[toc] | [prev] | [standalone]


Back to top | Article view | linux.kernel


csiph-web